ASURO Library: leds.c-Dateireferenz

gehe zum Quellcode dieser Datei


Funktionen
void	StatusLED (unsigned char color)
	Steuert die (lustige) mehrfarbige Status-LED.
void	FrontLED (unsigned char status)
	Steuert die vorne, nach unten zeigende, Front-LED.
void	BackLED (unsigned char left, unsigned char right)
	Steuert die beiden hinteren Back-LED's Wenn diese Funktion aufgerufen wird, funktioniert die Odometriemessung nicht mehr, da die gleichen Port-Pins (Port C:Pin 0 und 1) des Prozessors hierfuer verwendet werden.

Ausführliche Beschreibung

Die Port-Pin's zu den LED's werden so manipuliert, dass sie die daran
angeschlossenen LED's mit Strom versorgen oder eben nicht. Dazu muessen die
entsprechenden Ports als Ausgang konfiguriert sein. Dies erfolgt entweder
schon in der Init()-Funktion, oder wird im Falle der BackLED()-Funktion
dort vorgenommen.

Dokumentation der Funktionen

void BackLED	(	unsigned char	left,
		unsigned char	right
	)

Steuert die beiden hinteren Back-LED's
Wenn diese Funktion aufgerufen wird, funktioniert die Odometriemessung
nicht mehr, da die gleichen Port-Pins (Port C:Pin 0 und 1) des Prozessors
hierfuer verwendet werden.

Parameter:

`[in]`	left	Schaltet die linke LED an bzw. aus. [ ON \| OFF ]
`[in]`	right	Schaltet die rechte LED an bzw. aus. [ ON \| OFF ]

Rückgabe:: nichts

Hinweis:: Obwohl die uebergebenen Parameter nicht geprueft werden, treten hier keine
unerwarteten Reaktionen am Port C auf.

Beispiel:

(Nur zur Demonstration der Parameter/Returnwerte)

  // Linke LED aus; Rechte LED an
  BackLED (OFF, ON);

Definiert in Zeile 155 der Datei leds.c.

00158 {
00159   if (left || right)
00160   {
00161     PORTD &= ~(1 << PD7);               // Rad-LED's OFF
00162     DDRC |= (1 << PC0) | (1 << PC1);    // Port als Output => KEINE Odometrie
00163     PORTC |= (1 << PC0) | (1 << PC1);
00164   }
00165   if (!left)
00166     PORTC &= ~(1 << PC1);
00167   if (!right)
00168     PORTC &= ~(1 << PC0);
00169 }

void FrontLED ( unsigned char status ) [inline]

Steuert die vorne, nach unten zeigende, Front-LED.

Parameter:

[in] status Schaltet die LED an bzw. aus. [ ON | OFF ]

Rückgabe:: nichts

Hinweis:: Diese Funktion ist als 'inline'-Funktion definiert.

Achtung:: Der uebergeben Parameter wird nicht geprueft, und kann evl. zu unerwarteten
Reaktionen fuehren, da der Port D anhand dieses Wertes manipuliert wird.

Beispiel:

(Nur zur Demonstration der Parameter/Returnwerte)

  // schalte die Front-LED an.
  FrontLED (ON);

Definiert in Zeile 120 der Datei leds.c.

00122 {
00123   PORTD = (PORTD &~(1 << PD6)) | (status << PD6);
00124 }

void StatusLED ( unsigned char color ) [inline]

Steuert die (lustige) mehrfarbige Status-LED.

Parameter:

[in] color Zu setzende Farbe. [ OFF | GREEN | RED | YELLOW ] Bei einem nicht definierten Wert von 'color' aendert sich nichts an der LED.

Rückgabe:: nichts

Hinweis:: Diese Funktion ist als 'inline'-Funktion definiert.

Beispiel:

(Nur zur Demonstration der Parameter/Returnwerte)

  // Schaltet die Status-LED abwechselnd auf gruen und rot. 
  while (1)
  { 
    StatusLED (GREEN);
    Msleep (500);
    StatusLED (RED);
    MSleep (500);
  }

Definiert in Zeile 68 der Datei leds.c.

00070 {
00071   if (color == OFF)
00072   {
00073     GREEN_LED_OFF;
00074     RED_LED_OFF;
00075   }
00076   if (color == GREEN)
00077   {
00078     GREEN_LED_ON;
00079     RED_LED_OFF;
00080   }
00081   if (color == YELLOW)
00082   {
00083     GREEN_LED_ON;
00084     RED_LED_ON;
00085   }
00086   if (color == RED)
00087   {
00088     GREEN_LED_OFF;
00089     RED_LED_ON;
00090   }
00091 }