QDK PIC24/dsPIC-XC16 - Quantum Leaps

QDK
PIC24/dsPIC-XC16
www.state-machine.com/pic
The PIC24-dsPIC CPU supports several power-saving levels (consult the data sheets of particular
PIC24/dsPIC devices for details). The following piece of code shows the QF_onIdle() callback that puts
Pic24-dspic DSP into the IDLE power-saving mode. Please note that Pic24-dspic architecture allows for
an atomic setting the low-power mode and enabling interrupts at the same time.
Listing 6: QF_onIdle() for the non-preemptive (“vanilla”) QP port to PIC24/dsPIC
(1) void QF_onIdle(void) { /* entered with int disabled, NOTE01 */
(2) //LED_ON (IDLE_LED); /* blink the IDLE LED, see NOTE02 */
(3) //LED_OFF(IDLE_LED);
(4) #ifdef Q_SPY
. . . /* output Q-SPY trace data to the UART (see Section 7) */
(5) #elif defined NDEBUG
(6) __asm__ volatile("disi #0x0001");
(7) Idle(); /* transition to Idle mode, see NOTE03 */
#else
(8) QF_INT_ENABLE(); /* enable interrupts, see NOTE01 */
#endif
}
(1) The QF_onIdle() callback is always called with interrupts disabled to prevent any race condition
between posting events from ISRs and transitioning to the sleep mode.
(2-3) Typically, the DPP application uses one LED to visualize the idle loop activity. Usually, the LED is
toggled on and off, which causes the LED to “glow” at the intensity proportional to the rate of
invocations of the idle callback. However, the Microstick II has only one user LED, which cannot be
spared for the idle loop, because it is needed to show the DPP status.
(4) If QSPY software tracing is enabled, the QF_onIdle() callback tries to output one byte from the
trace buffer to the SCI. See Section 7 for more information about QSPY software tracing.
(5) The low-power mode stops the CPU clock, so it can interfere with the debugger. Here, the lowpower
mode is activated only in the Release build configuration when the macro NDEBUG is
defined.
(6) Interrupts are locked for just one following machine instruction, which ensures that interrupts will
unlock after the IDLE mode.
(7) The IDLE mode is activated by executing the IDLE instruction.
NOTE: The PIC24-dsPIC allows for atomic transition to the Idle or Sleep modes with interrupts
locked, as it should be done for a deterministic transition to the low-power mode (see [Samek 07a]).
(8) When the idle/sleep mode is not used, interrupts are simply enabled.
Copyright © Quantum Leaps, LLC. All Rights Reserved.
16 of 35