ena_dsp

Outline

Enable dispatching.

C format

 ER      ena_dsp (void);

Parameter(s)

None.

Explanation

This service call changes the system status to the dispatch enabled state.

As a result, dispatch processing (task scheduling) that has been disabled by issuing dis_dsp is enabled.

If a service call (chg_pri, sig_sem, etc.) accompanying dispatch processing is issued during the interval from when dis_dsp is issued until this service call is issued, the RI850V4 executes only processing such as queue manipulation, counter manipulation, etc., and the actual dispatch processing is delayed until this service call is issued, upon which the actual dispatch processing is performed in batch.

Note 1 This service call does not perform queuing of enable requests. If the system is in the dispatch enabled state, therefore, no processing is performed but it is not handled as an error.

Note 2 If a service call (such as wai_sem, wai_flg) that may move the status of an invoking task is issued from when dis_dsp is issued until this service call is issued, the RI850V4 returns E_CTX regardless of whether the required condition is immediately satisfied.

Return value

Macro	Value	Description
E_OK	0	Normal completion.
E_CTX	-25	Context error. - This service call was issued from a non-task. - This service call was issued in the CPU locked state.