Friedrich-Alexander-Universität UnivisSuche FAU-Logo
Techn. Fakultät Willkommen am Department Informatik FAU-Logo
Logo I4
Lehrstuhl für Informatik 4
GSPiC
 
  Übungen
  Dokumentation
  HowTos
  Evaluation
  Prüfungsinformationen
  protected area Intern
Übungen
  Anmeldung
  Folien
  Aufgaben
Department Informatik  >  Informatik 4  >  Lehre  >  WS 2010/11  >  GSPiC  >  Übung  >  Doku  >  libspicboard: LED access

SPiCboard library (libspicboard, revision 3032) API documentation

Found a bug or something ambiguous? Mail us to get it fixed!

LED access


Files

file  led.h
 Interface to the board's 8 LEDs.

Enumerations

enum  LED {
  RED0 = 0, YELLOW0 = 1, GREEN0 = 2, BLUE0 = 3,
  RED1 = 4, YELLOW1 = 5, GREEN1 = 6, BLUE1 = 7
}
 LED identifiers.

Functions

int8_t sb_led_on (LED led)
 Activates a specific LED.
int8_t sb_led_off (LED led)
 Deactivates a specific LED.
int8_t sb_led_toggle (LED led)
 Toggles a specific LED.
int8_t sb_led_show_level (uint8_t level, uint8_t max)
 Uses the LED array as a level indicator.
void sb_led_set_all_leds (uint8_t setting)
 Sets all LEDs according to a bitfield.

Function Documentation

int8_t sb_led_off ( LED  led  ) 

Deactivates a specific LED.

Parameters:
led LED ID
Returns:
0 on success, negative value on error
Return values:
0 success
-1 invalid LED ID

int8_t sb_led_on ( LED  led  ) 

Activates a specific LED.

Parameters:
led LED ID
Returns:
0 on success, negative value on error
Return values:
0 success
-1 invalid LED ID

void sb_led_set_all_leds ( uint8_t  setting  ) 

Sets all LEDs according to a bitfield.

The bitfield contains one bit for each LED. A set bit enables and a cleared bit disables the corresponding LED.

Parameters:
setting 8-bit bitfield describing the desired LED states

int8_t sb_led_show_level ( uint8_t  level,
uint8_t  max 
)

Uses the LED array as a level indicator.

Allows the array of LEDs to be used as a (fill) level, progress or similar indicator. The 8 LEDs are used to display a ratio of a max-value<=255 in 9 steps.

Parameters:
level level value
max maximum possible value
Returns:
the number of LEDs turned on on success, negative value on error
Return values:
>=0 success
-1 level exceeds max
-2 max is 0

int8_t sb_led_toggle ( LED  led  ) 

Toggles a specific LED.

Parameters:
led LED ID
Returns:
0 on success, negative value on error
Return values:
0 success
-1 invalid LED ID

  Impressum Stand: 2010-07-02 13:45   MS