#include "sgl.h"
Bool slSoundOn (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Turn on the sound.
If another process is locked and the semaphore cannot be acquired, or if the command cache for SMPC overflows, the result code NG is returned and the command is not issued. If the command registration is successful, Returns OK.
This macro activates the sound block.
Be sure to adhere to the following restrictions when stopping and starting the sound block.
-Restrictions on stopping and starting the sound block The sound block must not be stopped and there must be no non-access period of 0.5 seconds or more from the main system (SH2 side) to the sound RAM.
If you want to stop the sound block, load the sound driver, etc.
Stop it for the minimum required period and restart it immediately.
If you do not need to use the sound CPU (MC68EC000), you need to take measures such as executing a dummy program.
Executing this macro will reset the sound chip (SCSP). Access is prohibited for 30 μs after resetting the SCSP because the SCSP initializes the internal registers. Since the macro does not perform any weight processing, please control the application side so that SCSP is not accessed during this period.
slSoundOff | slSoundOnWait | slSoundOffWait |
#include "sgl.h"
Bool slSoundOff (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Turn off the sound.
If another process is locked and the semaphore cannot be acquired, or if the command cache for SMPC overflows, the result code NG is returned and the command is not issued. If the command registration is successful, Returns OK.
This macro will stop the sound block.
Be sure to adhere to the following restrictions when stopping and starting the sound block.
-Restrictions on stopping and starting the sound block The sound block must not be stopped and there must be no non-access period of 0.5 seconds or more from the main system (SH2 side) to the sound RAM.
If you want to stop the sound block, load the sound driver, etc.
Stop it for the minimum required period and restart it immediately.
If you do not need to use the sound CPU (MC68EC000), you need to take measures such as executing a dummy program.
slSoundOn | slSoundOnWait | slSoundOffWait |
#include "sgl.h"
Bool slNMIRequest (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Request NMI for master SH2.
If another process is locked and the semaphore cannot be acquired, or if the command cache for SMPC overflows, the result code NG is returned and the command is not issued. If the command registration is successful, Returns OK.
Use this function only when you want to perform the reset operation with the reset button disabled. (When using a modem, etc.)
Do not use it in other applications.
slNMIRequestWait |
#include "sgl.h"
Bool slResetEnable (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Enables reset.
If another process is locked and the semaphore cannot be acquired, or if the command cache for SMPC overflows, the result code NG is returned and the command is not issued. If the command registration is successful, Returns OK.
slResetDisable | slResetEnableWait | slResetDisableWait |
#include "sgl.h"
Bool slResetDisable (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Disables reset.
If another process is locked and the semaphore cannot be acquired, or if the command cache for SMPC overflows, the result code NG is returned and the command is not issued. If the command registration is successful, Returns OK.
This command cannot be issued from the slave CPU. When this command is issued from the slave CPU, NG is returned in the result code and the command cannot be issued.
Be sure to disable the reset button when accessing the backup memory.
Please re-enable it as soon as the access to the backup memory is completed.
However, if you are using a modem, always disable the reset button.
slResetEnable | slResetEnableWait | slResetDisableWait |
#include "sgl.h"
Bool slSetSmpcMemory (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Requests settings for SMPC memory.
If another process is locked and the semaphore cannot be acquired, or if the command cache for SMPC overflows, the result code NG is returned and the command is not issued. If the command registration is successful, Returns OK.
slSetSmpcMemoryWait | slSetLanguage | slSetSoundEffect | slSetSoundOutput |
slSetHelpWindow |
#include "sgl.h"
Bool slSetDateTime (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Set the real-time clock of SMPC.
If another process is locked and the semaphore cannot be acquired, or if the command cache for SMPC overflows, the result code NG is returned and the command is not issued. If the command registration is successful, Returns OK.
When using this function, be careful to follow the contents of the creation criteria.
slSetDateTimeWait |
#include "sgl.h"
Bool slSoundOnWait (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Turn on the sound and wait for the command to finish executing.
If another process is locked and the semaphore cannot be acquired, the command cache for SMPC overflows, or an interrupt back is issued, the result code NG is returned and the command is not issued.
If the command registration is successful, OK is returned.
This macro activates the sound block.
Be sure to adhere to the following restrictions when stopping and starting the sound block.
-Restrictions on stopping and starting the sound block The sound block must not be stopped and there must be no non-access period of 0.5 seconds or more from the main system (SH2 side) to the sound RAM.
If you want to stop the sound block, load the sound driver, etc.
Stop it for the minimum required period and restart it immediately.
If you do not need to use the sound CPU (MC68EC000), you need to take measures such as executing a dummy program.
Executing this macro will reset the sound chip (SCSP). Access is prohibited for 30 μs after resetting the SCSP because the SCSP initializes the internal registers. Since the macro does not perform any weight processing, please control the application side so that SCSP is not accessed during this period.
slSoundOffWait | slSoundOn | slSoundOff |
#include "sgl.h"
Bool slSoundOffWait (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Turn off the sound and wait for the command to finish executing.
If another process is locked and the semaphore cannot be acquired, the command cache for SMPC overflows, or an interrupt back is issued, the result code NG is returned and the command is not issued.
If the command registration is successful, OK is returned.
This macro will stop the sound block.
Be sure to adhere to the following restrictions when stopping and starting the sound block.
-Restrictions on stopping and starting the sound block The sound block must not be stopped and there must be no non-access period of 0.5 seconds or more from the main system (SH2 side) to the sound RAM.
If you want to stop the sound block, load the sound driver, etc.
Stop it for the minimum required period and restart it immediately.
If you do not need to use the sound CPU (MC68EC000), you need to take measures such as executing a dummy program.
slSoundOnWait | slSoundOn | slSoundOff |
#include "sgl.h"
Bool slNMIRequestWait (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Request NMI from master SH2 and wait for command execution to finish.
If another process is locked and the semaphore cannot be acquired, the command cache for SMPC overflows, or an interrupt back is issued, the result code NG is returned and the command is not issued.
Returns OK if the command registration is successful.
Use this function only when you want to perform the reset operation with the reset button disabled. (When using a modem, etc.)
Do not use it in other applications.
slNMIRequest |
#include "sgl.h"
Bool slResetEnableWait (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Enable reset and wait for the command to finish executing.
If another process is locked and the semaphore cannot be acquired, the command cache for SMPC overflows, or an interrupt back is issued, the result code NG is returned and the command is not issued.
If the command registration is successful, OK is returned.
slResetEnableWait | slResetEnable | slResetDisable |
#include "sgl.h"
Bool slResetDisableWait (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Disables reset and waits for the command to finish executing.
If another process is locked and the semaphore cannot be acquired, the command cache for SMPC overflows, or an interrupt back is issued, the result code NG is returned and the command is not issued.
If the command registration is successful, OK is returned.
This command cannot be issued from the slave CPU. When this command is issued from the slave CPU, NG is returned in the result code and the command cannot be issued.
Be sure to disable the reset button when accessing the backup memory.
Please re-enable it as soon as the access to the backup memory is completed.
However, if you are using a modem, always disable the reset button.
slResetDisableWait | slResetEnable | slResetDisable |
#include "sgl.h"
Bool slSetSmpcMemoryWait (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Requests the SMPC memory setting and waits for the command to finish executing.
If another process is locked and the semaphore cannot be acquired, the command cache for SMPC overflows, or an interrupt back is issued, the result code NG is returned and the command is not issued.
Returns OK if the command registration is successful.
slSetSmpcMemory | slSetLanguage | slSetSoundEffect | slSetSoundOutput |
slSetHelpWindow |
#include "sgl.h"
Bool slSetDateTimeWait (void);
void --Do not give anything.
Bool --A flag that indicates whether the process ended normally (described later).
Requests the SMPC real-time clock to be set and waits for the command to finish executing.
If another process is locked and the semaphore cannot be acquired, the command cache for SMPC overflows, or an interrupt back is issued, the result code NG is returned and the command is not issued.
If the command registration is successful, OK is returned.
When using this function, be careful to follow the contents of the creation criteria.
slSetDateTime |