led.c File Reference

AT32UC3L-EK board LEDs support package. More...

#include <avr32/io.h>
#include "preprocessor.h"
#include "compiler.h"
#include "uc3l_ek.h"
#include "led.h"

Go to the source code of this file.

Data Structures

struct  tLED_DESCRIPTOR
 Structure describing LED hardware connections. More...

Defines

#define INSERT_LED_DESCRIPTOR(LED_NO, unused)

Functions

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

Variables

static tLED_DESCRIPTOR LED_DESCRIPTOR [LED_COUNT]
 Hardware descriptors of all LEDs.
static volatile U32 LED_State = (1 << LED_COUNT) - 1
 Saved state of all LEDs.

Detailed Description

AT32UC3L-EK board LEDs support package.

This file contains definitions and services related to the LED features of the AT32UC3L-EK board.

Author:
Atmel Corporation: http://www.atmel.com
Support and FAQ: http://support.atmel.no/

Definition in file led.c.

Define Documentation

#define INSERT_LED_DESCRIPTOR ( LED_NO,
unused   ) 
Value:
{                                                           \
    {LED##LED_NO##_GPIO / 32, 1 << (LED##LED_NO##_GPIO % 32)},\
    {LED##LED_NO##_PWM,       LED##LED_NO##_PWM_FUNCTION    } \
  },

Function Documentation

void LED_Display ( U32  leds  ) 

Sets the state of all LEDs.

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

Definition at line 95 of file led.c.

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

00096 {
00097   // Use the LED descriptors to get the connections of a given LED to the MCU.
00098   tLED_DESCRIPTOR *led_descriptor;
00099   volatile avr32_gpio_port_t *led_gpio_port;
00100 
00101   // Make sure only existing LEDs are specified.
00102   leds &= (1 << LED_COUNT) - 1;
00103 
00104   // Update the saved state of all LEDs with the requested changes.
00105   LED_State = leds;
00106 
00107   // For all LEDs...
00108   for (led_descriptor = &LED_DESCRIPTOR[0];
00109        led_descriptor < LED_DESCRIPTOR + LED_COUNT;
00110        led_descriptor++)
00111   {
00112     // Set the LED to the requested state.
00113     led_gpio_port = &AVR32_GPIO.port[led_descriptor->GPIO.PORT];
00114     if (leds & 1)
00115     {
00116       led_gpio_port->ovrc  = led_descriptor->GPIO.PIN_MASK;
00117     }
00118     else
00119     {
00120       led_gpio_port->ovrs  = led_descriptor->GPIO.PIN_MASK;
00121     }
00122     led_gpio_port->oders = led_descriptor->GPIO.PIN_MASK;
00123     led_gpio_port->gpers = led_descriptor->GPIO.PIN_MASK;
00124     leds >>= 1;
00125   }
00126 }

void LED_Display_Field ( U32  field,
U32  leds 
)

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

Parameters:
field LEDs of which to set the state (1 bit per LED).
leds New 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.

Definition at line 268 of file led.c.

References ctz, and LED_Display_Mask().

00269 {
00270   // Move the bit-field to the appropriate position for the bit-mask.
00271   LED_Display_Mask(field, leds << ctz(field));
00272 }

void LED_Display_Mask ( U32  mask,
U32  leds 
)

Sets the state of the specified LEDs.

Parameters:
mask LEDs of which to set the state (1 bit per LED).
leds New state of the specified LEDs (1 bit per LED).
Note:
The pins of the specified LEDs are set to GPIO output mode.

Definition at line 135 of file led.c.

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

Referenced by LED_Display_Field().

00136 {
00137   // Use the LED descriptors to get the connections of a given LED to the MCU.
00138   tLED_DESCRIPTOR *led_descriptor = &LED_DESCRIPTOR[0] - 1;
00139   volatile avr32_gpio_port_t *led_gpio_port;
00140   U8 led_shift;
00141 
00142   // Make sure only existing LEDs are specified.
00143   mask &= (1 << LED_COUNT) - 1;
00144 
00145   // Update the saved state of all LEDs with the requested changes.
00146   Wr_bits(LED_State, mask, leds);
00147 
00148   // While there are specified LEDs left to manage...
00149   while (mask)
00150   {
00151     // Select the next specified LED and set it to the requested state.
00152     led_shift = 1 + ctz(mask);
00153     led_descriptor += led_shift;
00154     led_gpio_port = &AVR32_GPIO.port[led_descriptor->GPIO.PORT];
00155     leds >>= led_shift - 1;
00156     if (leds & 1)
00157     {
00158       led_gpio_port->ovrc  = led_descriptor->GPIO.PIN_MASK;
00159     }
00160     else
00161     {
00162       led_gpio_port->ovrs  = led_descriptor->GPIO.PIN_MASK;
00163     }
00164     led_gpio_port->oders = led_descriptor->GPIO.PIN_MASK;
00165     led_gpio_port->gpers = led_descriptor->GPIO.PIN_MASK;
00166     leds >>= 1;
00167     mask >>= led_shift;
00168   }
00169 }

U8 LED_Get_Intensity ( U32  led  ) 

Gets the intensity of the specified LED.

Parameters:
led LED of which to get the intensity (1 bit per LED; only the least significant set bit is used).
Returns:
Intensity of the specified LED (0x00 to 0xFF).
Warning:
The PWM channel of the specified LED is supposed to be used only by this module.
Note:
The GPIO pin configuration of all LEDs is left unchanged.

Definition at line 275 of file led.c.

References tLED_DESCRIPTOR::CHANNEL, ctz, LED_COUNT, and tLED_DESCRIPTOR::PWM.

00276 {
00277 #if 0 // TODO
00278   tLED_DESCRIPTOR *led_descriptor;
00279 
00280   // Check that the argument value is valid.
00281   led = ctz(led);
00282   led_descriptor = &LED_DESCRIPTOR[led];
00283   if (led >= LED_COUNT || led_descriptor->PWM.CHANNEL < 0) return 0;
00284 
00285   // Return the duty cycle value if the LED PWM channel is enabled, else 0.
00286   return (AVR32_PWM.sr & (1 << led_descriptor->PWM.CHANNEL)) ?
00287            AVR32_PWM.channel[led_descriptor->PWM.CHANNEL].cdty : 0;
00288 #else
00289   return 0;
00290 #endif
00291 }

void LED_Off ( U32  leds  ) 

Turns off the specified LEDs.

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

Definition at line 178 of file led.c.

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

00179 {
00180   // Use the LED descriptors to get the connections of a given LED to the MCU.
00181   tLED_DESCRIPTOR *led_descriptor = &LED_DESCRIPTOR[0] - 1;
00182   volatile avr32_gpio_port_t *led_gpio_port;
00183   U8 led_shift;
00184 
00185   // Make sure only existing LEDs are specified.
00186   leds &= (1 << LED_COUNT) - 1;
00187 
00188   // Update the saved state of all LEDs with the requested changes.
00189   Clr_bits(LED_State, leds);
00190 
00191   // While there are specified LEDs left to manage...
00192   while (leds)
00193   {
00194     // Select the next specified LED and turn it off.
00195     led_shift = 1 + ctz(leds);
00196     led_descriptor += led_shift;
00197     led_gpio_port = &AVR32_GPIO.port[led_descriptor->GPIO.PORT];
00198     led_gpio_port->ovrs  = led_descriptor->GPIO.PIN_MASK;
00199     led_gpio_port->oders = led_descriptor->GPIO.PIN_MASK;
00200     led_gpio_port->gpers = led_descriptor->GPIO.PIN_MASK;
00201     leds >>= led_shift;
00202   }
00203 }

void LED_On ( U32  leds  ) 

Turns on the specified LEDs.

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

Definition at line 206 of file led.c.

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

00207 {
00208   // Use the LED descriptors to get the connections of a given LED to the MCU.
00209   tLED_DESCRIPTOR *led_descriptor = &LED_DESCRIPTOR[0] - 1;
00210   volatile avr32_gpio_port_t *led_gpio_port;
00211   U8 led_shift;
00212 
00213   // Make sure only existing LEDs are specified.
00214   leds &= (1 << LED_COUNT) - 1;
00215 
00216   // Update the saved state of all LEDs with the requested changes.
00217   Set_bits(LED_State, leds);
00218 
00219   // While there are specified LEDs left to manage...
00220   while (leds)
00221   {
00222     // Select the next specified LED and turn it on.
00223     led_shift = 1 + ctz(leds);
00224     led_descriptor += led_shift;
00225     led_gpio_port = &AVR32_GPIO.port[led_descriptor->GPIO.PORT];
00226     led_gpio_port->ovrc  = led_descriptor->GPIO.PIN_MASK;
00227     led_gpio_port->oders = led_descriptor->GPIO.PIN_MASK;
00228     led_gpio_port->gpers = led_descriptor->GPIO.PIN_MASK;
00229     leds >>= led_shift;
00230   }
00231 }

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.

Definition at line 89 of file led.c.

References LED_State.

00090 {
00091   return LED_State;
00092 }

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:
field LEDs 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.

Definition at line 262 of file led.c.

References LED_State, and Rd_bitfield.

00263 {
00264   return Rd_bitfield(LED_State, field);
00265 }

U32 LED_Read_Display_Mask ( U32  mask  ) 

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

Parameters:
mask LEDs 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.

Definition at line 129 of file led.c.

References LED_State, and Rd_bits.

00130 {
00131   return Rd_bits(LED_State, mask);
00132 }

void LED_Set_Intensity ( U32  leds,
U8  intensity 
)

Sets the intensity of the specified LEDs.

Parameters:
leds LEDs of which to set the intensity (1 bit per LED).
intensity New intensity of the specified LEDs (0x00 to 0xFF).
Warning:
The PWM channels of the specified LEDs are supposed to be used only by this module.
Note:
The pins of the specified LEDs are set to PWM output mode.

Definition at line 294 of file led.c.

References tLED_DESCRIPTOR::CHANNEL, ctz, tLED_DESCRIPTOR::FUNCTION, tLED_DESCRIPTOR::GPIO, LED_COUNT, tLED_DESCRIPTOR::PIN_MASK, tLED_DESCRIPTOR::PORT, and tLED_DESCRIPTOR::PWM.

00295 {
00296 #if 0 // TODO
00297   tLED_DESCRIPTOR *led_descriptor = &LED_DESCRIPTOR[0] - 1;
00298   volatile avr32_pwm_channel_t *led_pwm_channel;
00299   volatile avr32_gpio_port_t *led_gpio_port;
00300   U8 led_shift;
00301 
00302   // For each specified LED...
00303   for (leds &= (1 << LED_COUNT) - 1; leds; leds >>= led_shift)
00304   {
00305     // Select the next specified LED and check that it has a PWM channel.
00306     led_shift = 1 + ctz(leds);
00307     led_descriptor += led_shift;
00308     if (led_descriptor->PWM.CHANNEL < 0) continue;
00309 
00310     // Initialize or update the LED PWM channel.
00311     led_pwm_channel = &AVR32_PWM.channel[led_descriptor->PWM.CHANNEL];
00312     if (!(AVR32_PWM.sr & (1 << led_descriptor->PWM.CHANNEL)))
00313     {
00314       led_pwm_channel->cmr = (AVR32_PWM_CPRE_MCK << AVR32_PWM_CPRE_OFFSET) &
00315                              ~(AVR32_PWM_CALG_MASK |
00316                                AVR32_PWM_CPOL_MASK |
00317                                AVR32_PWM_CPD_MASK);
00318       led_pwm_channel->cprd = 0x000000FF;
00319       led_pwm_channel->cdty = intensity;
00320       AVR32_PWM.ena = 1 << led_descriptor->PWM.CHANNEL;
00321     }
00322     else
00323     {
00324       AVR32_PWM.isr;
00325       while (!(AVR32_PWM.isr & (1 << led_descriptor->PWM.CHANNEL)));
00326       led_pwm_channel->cupd = intensity;
00327     }
00328 
00329     // Switch the LED pin to its PWM function.
00330     led_gpio_port = &AVR32_GPIO.port[led_descriptor->GPIO.PORT];
00331     if (led_descriptor->PWM.FUNCTION & 0x1)
00332     {
00333       led_gpio_port->pmr0s = led_descriptor->GPIO.PIN_MASK;
00334     }
00335     else
00336     {
00337       led_gpio_port->pmr0c = led_descriptor->GPIO.PIN_MASK;
00338     }
00339     if (led_descriptor->PWM.FUNCTION & 0x2)
00340     {
00341       led_gpio_port->pmr1s = led_descriptor->GPIO.PIN_MASK;
00342     }
00343     else
00344     {
00345       led_gpio_port->pmr1c = led_descriptor->GPIO.PIN_MASK;
00346     }
00347     led_gpio_port->gperc = led_descriptor->GPIO.PIN_MASK;
00348   }
00349 #else
00350   return;
00351 #endif
00352 }

Bool LED_Test ( U32  leds  ) 

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

Parameters:
leds LEDs 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.

Definition at line 172 of file led.c.

References LED_State, and Tst_bits.

00173 {
00174   return Tst_bits(LED_State, leds);
00175 }

void LED_Toggle ( U32  leds  ) 

Toggles the specified LEDs.

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

Definition at line 234 of file led.c.

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

00235 {
00236   // Use the LED descriptors to get the connections of a given LED to the MCU.
00237   tLED_DESCRIPTOR *led_descriptor = &LED_DESCRIPTOR[0] - 1;
00238   volatile avr32_gpio_port_t *led_gpio_port;
00239   U8 led_shift;
00240 
00241   // Make sure only existing LEDs are specified.
00242   leds &= (1 << LED_COUNT) - 1;
00243 
00244   // Update the saved state of all LEDs with the requested changes.
00245   Tgl_bits(LED_State, leds);
00246 
00247   // While there are specified LEDs left to manage...
00248   while (leds)
00249   {
00250     // Select the next specified LED and toggle it.
00251     led_shift = 1 + ctz(leds);
00252     led_descriptor += led_shift;
00253     led_gpio_port = &AVR32_GPIO.port[led_descriptor->GPIO.PORT];
00254     led_gpio_port->ovrt  = led_descriptor->GPIO.PIN_MASK;
00255     led_gpio_port->oders = led_descriptor->GPIO.PIN_MASK;
00256     led_gpio_port->gpers = led_descriptor->GPIO.PIN_MASK;
00257     leds >>= led_shift;
00258   }
00259 }

Variable Documentation

tLED_DESCRIPTOR LED_DESCRIPTOR[LED_COUNT] [static]
Initial value:
{
#define INSERT_LED_DESCRIPTOR(LED_NO, unused)                 






}

Hardware descriptors of all LEDs.

Definition at line 73 of file led.c.

volatile U32 LED_State = (1 << LED_COUNT) - 1 [static]

Saved state of all LEDs.

Definition at line 86 of file led.c.

Referenced by LED_Display(), LED_Display_Mask(), LED_Off(), LED_On(), LED_Read_Display(), LED_Read_Display_Field(), LED_Read_Display_Mask(), LED_Test(), and LED_Toggle().

Generated on Tue Dec 15 08:37:05 2009 for AVR32 UC3064 - Pioc power Test by  doxygen 1.6.1