Microchip® Advanced Software Framework

led.h File Reference
#include "compiler.h"

Macros

Identifiers of LEDs to Use with LED Functions
#define LED0   (1<<0)
 
#define LED1   (1<<1)
 
#define LED2   (1<<2)
 
#define LED3   (1<<3)
 
#define LED4   (1<<4)
 
#define LED_RGB_RED   LED2
 
#define LED_RGB_GREEN   LED3
 
#define LED_RGB_BLUE   LED4
 

Functions

void LED_Display (U32 leds)
 Sets the state of all LEDs. More...
 
void LED_Display_Field (U32 field, U32 leds)
 Sets as a bit-field the state of the specified LEDs. More...
 
void LED_Display_Mask (U32 mask, U32 leds)
 Sets the state of the specified LEDs. More...
 
U8 LED_Get_Intensity (U32 led)
 Gets the intensity of the specified LED. More...
 
void LED_Off (U32 leds)
 Turns off the specified LEDs. More...
 
void LED_On (U32 leds)
 Turns on the specified LEDs. More...
 
U32 LED_Read_Display (void)
 Gets the last state of all LEDs set through the LED API. More...
 
U32 LED_Read_Display_Field (U32 field)
 Gets as a bit-field the last state of the specified LEDs set through the LED API. More...
 
U32 LED_Read_Display_Mask (U32 mask)
 Gets the last state of the specified LEDs set through the LED API. More...
 
void LED_Set_Intensity (U32 leds, U8 intensity)
 Sets the intensity of the specified LEDs. More...
 
bool LED_Test (U32 leds)
 Tests the last state of the specified LEDs set through the LED API. More...
 
void LED_Toggle (U32 leds)
 Toggles the specified LEDs. More...
 

#define LED0   (1<<0)
#define LED1   (1<<1)
#define LED2   (1<<2)
#define LED3   (1<<3)
#define LED4   (1<<4)
#define LED_RGB_BLUE   LED4
#define LED_RGB_GREEN   LED3
#define LED_RGB_RED   LED2

void LED_Display ( U32  leds)

Sets the state of all LEDs.

Parameters
ledsNew state of all LEDs (1 bit per LED).
Note
The pins of all LEDs are set to GPIO output mode.

References LED_Display_Mask().

void LED_Display_Field ( U32  field,
U32  leds 
)

Sets as a bit-field the state of the specified LEDs.

Parameters
fieldLEDs of which to set the state (1 bit per LED).
ledsNew state of the specified LEDs (1 bit per LED, beginning with the first specified LED).
Note
The pins of the specified LEDs are set to GPIO output mode.

References ctz, and LED_Display_Mask().

void LED_Display_Mask ( U32  mask,
U32  leds 
)

Sets the state of the specified LEDs.

Parameters
maskLEDs of which to set the state (1 bit per LED).
ledsNew state of the specified LEDs (1 bit per LED).
Note
The pins of the specified LEDs are set to GPIO output mode.

References ctz, tLED_DESCRIPTOR::GPIO, LED_COUNT, LED_State, tLED_DESCRIPTOR::PIN_MASK, tLED_DESCRIPTOR::polarity, tLED_DESCRIPTOR::PORT, and Wr_bits.

Referenced by LED_Display(), and LED_Display_Field().

U8 LED_Get_Intensity ( U32  led)

Gets the intensity of the specified LED.

Parameters
ledLED of which to get the intensity (1 bit per LED; only the least significant set bit is used).
Returns
0, as this is not implemented.
Warning
This function is not implemented. Use the PWMA module instead.
void LED_Off ( U32  leds)

Turns off the specified LEDs.

Parameters
ledsLEDs to turn off (1 bit per LED).
Note
The pins of the specified LEDs are set to GPIO output mode.

References Clr_bits, ctz, tLED_DESCRIPTOR::GPIO, LED_COUNT, LED_State, tLED_DESCRIPTOR::PIN_MASK, tLED_DESCRIPTOR::polarity, and tLED_DESCRIPTOR::PORT.

Referenced by board_init(), and main().

void LED_On ( U32  leds)

Turns on the specified LEDs.

Parameters
ledsLEDs to turn on (1 bit per LED).
Note
The pins of the specified LEDs are set to GPIO output mode.

References ctz, tLED_DESCRIPTOR::GPIO, LED_COUNT, LED_State, tLED_DESCRIPTOR::PIN_MASK, tLED_DESCRIPTOR::polarity, tLED_DESCRIPTOR::PORT, and Set_bits.

Referenced by main().

U32 LED_Read_Display ( void  )

Gets the last state of all LEDs set through the LED API.

Returns
State of all LEDs (1 bit per LED).
Note
The GPIO pin configuration of all LEDs is left unchanged.

References LED_State.

U32 LED_Read_Display_Field ( U32  field)

Gets as a bit-field the last state of the specified LEDs set through the LED API.

Parameters
fieldLEDs of which to get the state (1 bit per LED).
Returns
State of the specified LEDs (1 bit per LED, beginning with the first specified LED).
Note
The GPIO pin configuration of all LEDs is left unchanged.

References LED_State, and Rd_bitfield.

U32 LED_Read_Display_Mask ( U32  mask)

Gets the last state of the specified LEDs set through the LED API.

Parameters
maskLEDs of which to get the state (1 bit per LED).
Returns
State of the specified LEDs (1 bit per LED).
Note
The GPIO pin configuration of all LEDs is left unchanged.

References LED_State, and Rd_bits.

void LED_Set_Intensity ( U32  leds,
U8  intensity 
)

Sets the intensity of the specified LEDs.

Parameters
ledsLEDs of which to set the intensity (1 bit per LED).
intensityNew intensity of the specified LEDs (0x00 to 0xFF).
Warning
This function is not implemented. Use the PWMA module instead.
bool LED_Test ( U32  leds)

Tests the last state of the specified LEDs set through the LED API.

Parameters
ledsLEDs of which to test the state (1 bit per LED).
Returns
true if at least one of the specified LEDs has a state on, else false.
Note
The GPIO pin configuration of all LEDs is left unchanged.

References LED_State, and Tst_bits.

void LED_Toggle ( U32  leds)

Toggles the specified LEDs.

Parameters
ledsLEDs to toggle (1 bit per LED).
Note
The pins of the specified LEDs are set to GPIO output mode.

References ctz, tLED_DESCRIPTOR::GPIO, LED_COUNT, LED_State, tLED_DESCRIPTOR::PIN_MASK, tLED_DESCRIPTOR::PORT, and Tgl_bits.

Referenced by main().