LED API: Difference between revisions

Latest revision as of 09:34, 11 March 2019

API Overview

The calling sequence is open>turn_on/turn_off/get_status>close

open

int led_open()

Open the LED device, which contains all the LED service. This operation should be used before other operations.

Returns
int	The result code, >= 0, success; <0 error code.

close

int led_close()

Close the LED device, which contains all the LEDs’ service. The open and close API are pair operations. If you don’t want to use this device, you should call the close API to release this device.

Returns
int	The result code, >= 0, success; <0 error code.

turn_on

int led_on(unsigned int nLedIndex)

Turn on the specified LED.

Parameters
nLedIndex	unsigned int: Index of led, >= 0 && < MAX_LED_COUNT

Returns
int	The result code, >= 0, success; <0 error code.

turn_off

int led_off(unsigned int nLedIndex)

Turn off the specified LED.

Parameters
nLedIndex	unsigned int: Index of led, >= 0 && < MAX_LED_COUNT

Returns
int	The result code, >= 0, success; <0 error code.

get_status

int led_get_status(unsigned int nLedIndex)

Get the status of the specified LED.

Parameters
nLedIndex	unsigned int: Index of led, >= 0 && < MAX_LED_COUNT

Returns
int	The result code, > 0, LED on; =0, LED off; <0 error code.

@@ Line 3: / Line 3: @@
 === <big>open</big> ===
   <syntaxhighlight lang="c">int led_open()</syntaxhighlight >
-Open the LED device, which contains all the LEDs’ service.
+Open the LED device, which contains all the LED service.
 This operation should be used before other operations.
@@ Line 17: / Line 17: @@
    <syntaxhighlight lang="c">int led_close()</syntaxhighlight >
 Close the LED device, which contains all the LEDs’ service.
-The open and close apis are pair operations. If you don’t want to use this device, you should call the close api to release this device.
+The open and close API are pair operations. If you don’t want to use this device, you should call the close API to release this device.
 {|class="wizarpostable"