#include <nitro/spi.h>
u32 PM_GetLEDPattern( PMLEDPattern* patternBuf );
u32 PM_GetLEDPatternAsync( PMLEDStatus* patternBuf, PMCallback callback, void* arg );
This function gets the LED state of the console.
patternBuf is a buffer that stores the PMLEDPattern list type values. It takes a value that indicates the state of the LED when it is not NULL. It will take one of the following values:
PM_LED_PATTERN_ON |
The LED is illuminated. |
PM_LED_PATTERN_BLINK_LOW |
The LED is blinking at a high speed. |
PM_LED_PATTERN_BLINK_HIGH |
The LED is blinking at a low speed. |
PM_LED_PATTERN_BLINK1 |
The LED is repeating a lit/unlit pattern every 1 frame. |
PM_LED_PATTERN_BLINK2 |
The LED is repeating a lit/unlit pattern every 2 frames. |
PM_LED_PATTERN_BLINK3 |
The LED is repeating a lit/unlit pattern every 3 frames. |
PM_LED_PATTERN_BLINK4 |
The LED is repeating a lit/unlit pattern every 4 frames. |
PM_LED_PATTERN_BLINK5 |
The LED is repeating a lit/unlit pattern every 5 frames. |
PM_LED_PATTERN_BLINK6 |
The LED is repeating a lit/unlit pattern every 6 frames. |
PM_LED_PATTERN_BLINK8 |
The LED is repeating a lit/unlit pattern every 8 frames. |
PM_LED_PATTERN_BLINK10 |
The LED is repeating a lit/unlit pattern every 10 frames. |
PM_LED_PATTERN_PATTERN1 |
The LED is blinking in a predetermined pattern. |
PM_LED_PATTERN_PATTERN2 |
The LED is blinking in a predetermined pattern. |
PM_LED_PATTERN_PATTERN3 |
The LED is blinking in a predetermined pattern. |
The "high speed blink" and "low speed blink" are blink features that are implemented on the hardware. Although the term "high speed" is used, the blinking speed is actually slower than the blinking speed that is caused by the software that repeats the lit/unlit pattern in a fixed number of frames.
This function uses PXI to sends the commands that perform the operations pertaining to ARM7. The ARM7 side that takes in those commands is executed by using PMIC. Therefore, the function is not called and immediately put to use. Synchronous type functions that wait until the operations have finished and asynchronous type functions that only send commands to ARM7 have been prepared, so please use them according to their purpose. (Function names that have Async attached are asynchronous functions.)
When an asynchronous function is called, the designated callback callback is called when the processing finishes on the ARM7 side. The callback type PMCallback is defined by
typedef void ( *PMCallback )( u32 result, void* arg );
For the callback arguments, the first argument results indicate the command results. This will be either PM_RESULT_SUCCESS or PM_RESULT_ERROR.The second argument returns arg.
When using this function, be sure to initialize the PM library with PM_Init(). (Calling it once is enough. Also, when calling OS_Init(), it is not necessary to perform initialization since it is called from inside the PM library.)
patternBuf |
The buffer that stores the value of the LED pattern to be obtained. |
callback |
The callback called when the command finishes. |
arg |
The arguments when the callback is called. |
A return value of PM_RESULT_SUCCESS indicates that the execution of the command was a success (for synchronous functions). This return value also indicates that the command was successfully sent to the ARM7 processor (for asynchronous functions).
A return value of PM_INVALID_COMMAND indicates that the given arguments cannot be designated.
A return value of PM_RESULT_ERROR indicates that some sort of error has occurred on the ARM7 side.
08/26/2004 Initial version