u-boot/board/lwmon/README.keybd

Tastaturabfrage:

Die Implementierung / Decodierung beruht auf den Angaben aus dem  Do-
kument  "PIC LWE-Tastatur" in der Fassung vom 9. 3. 2001, insbesonde-
re Tabelle 3 im Kapitel 4.3 Tastencodes. In  U-Boot  werden  die  vom
Keyboard-Controller  gelesenen Daten hexadezimal codiert in der auto-
matisch angelegten Environment-Variablen "keybd" <EFBFBD>bergeben. Ist  kei-
ne Taste gedr<EFBFBD>ckt worden, steht dort:

	keybd=000000000000000000

Der decodierte Tastencode ("keybd") kann mit den  "bootargs"  an  den
Linux-Kernel  <EFBFBD>bergeben  und  dort z. B. in einem Device-Treiber oder
einer Applikation ausgewertet werden.



Sonderfunktionen beim Booten:

Es lassen sich eine oder mehrere (beliebig viele) Tasten oder Tasten-
kombinationen definieren, die Sonderfunktionen ausl<EFBFBD>sen,  wenn  diese
Tasten beim Booten (Reset) gedr<EFBFBD>ckt sind.

Wird eine eingestellte Taste bzw. Tastenkombination erkannt, so  wird
in  U-Boot noch vor dem Start des "Countdown" und somit vor jedem an-
deren Kommando der Inhalt einer dieser Taste  bzw.  Tastenkombination
zugeordneten Environment-Variablen ausf<EFBFBD>hren.


Die Environment-Variable "magic_keys" wird als Liste von Zeichen ver-
standen, die als Suffix an den Namen "key_magic" angef<EFBFBD>gt werden  und
so  die  Namen  der  Environment-Variablen  definieren, mit denen die
Tasten (-kombinationen) festgelegt werden:

Ist "magic_keys" NICHT definiert, so wird nur die in der Environment-
Variablen "key_magic" codierte  Tasten  (-kombination)  gepr<EFBFBD>ft,  und
ggf.  der  Inhalt der Environment-Variablen "key_cmd" ausgef<EFBFBD>hrt (ge-
nauer: der Inhalt von "key_cmd" wird der Variablen "preboot" zugewie-
sen, die ausgef<EFBFBD>hrt wird, unmittelbar bevor die interaktive Kommando-
interpretation beginnt).

Enth<EFBFBD>lt "magic_keys" z. B.  die  Zeichenkette  "0123CB*",  so  werden
nacheinander folgende Aktionen ausgef<EFBFBD>hrt:

	pr<EFBFBD>fe Tastencode	ggf. f<EFBFBD>hre aus Kommando
	in Variable		in Variable
	-----------------------------------
	key_magic0	==>	key_cmd0
	key_magic1	==>	key_cmd1
	key_magic2	==>	key_cmd2
	key_magic3	==>	key_cmd3
	key_magicC	==>	key_cmdC
	key_magicB	==>	key_cmdB
	key_magicA	==>	key_cmdA
	key_magic*	==>	key_cmd*

Hinweis: sobald ein aktivierter Tastencode erkannt  wurde,  wird  die
Bearbeitung  abgebrochen; es wird daher h<EFBFBD>chstens eines der definier-
ten Kommandos ausgef<EFBFBD>hrt, wobei die Priorit<EFBFBD>t durch  die  Suchreihen-
folge  festgelegt wird, also durch die Reihenfolge der Zeichen in der
Varuiablen "magic_keys".


Die Codierung der Tasten, die beim Booten gedr<EFBFBD>ckt werden m<EFBFBD>ssen, um
eine Funktion auszul<EFBFBD>sen, erfolgt nach der Tastaturtabelle.

Die Definitionen

	=> setenv key_magic0 3a+3b
	=> setenv key_cmd0 setenv bootdelay 30

bedeuten dementsprechend, da<EFBFBD> die Tasten mit den  Codes  0x3A  (Taste
"F1")  und 0x3B (Taste "F2") gleichzeitig gedr<EFBFBD>ckt werden m<EFBFBD>ssen. Sie
k<EFBFBD>nnen dort eine beliebige  Tastenkombination  eintragen  (jeweils  2
Zeichen f<EFBFBD>r die Hex-Codes der Tasten, und '+' als Trennzeichen).

Wird die eingestellte Tastenkombination erkannt, so  wird  in  U-Boot
noch  vor  dem Start des "Countdown" und somit vor jedem anderen Kom-
mando das angebene Kommando ausgef<EFBFBD>hrt und  somit  ein  langes  Boot-
Delay eingetragen.

Praktisch k<EFBFBD>nnten Sie also in U-Boot "bootdelay"  auf  0  setzen  und
somit  stets  ohne  jede  User-Interaktion automatisch booten, au<EFBFBD>er,
wenn die beiden Tasten "F1" und "F2"  beim  Booten  gedr<EFBFBD>ckt  werden:
dann w<EFBFBD>rde ein Boot-Delay von 30 Sekunden eingef<EFBFBD>gt.


Hinweis: dem Zeichen '#' kommt innerhalb von "magic_keys" eine beson-
dere Bedeutung zu: die dadurch definierte  Key-Sequenz  schaltet  den
Monitor in den "Debug-Modus" - das bedeutet zun<EFBFBD>chst, da<EFBFBD> alle weite-
ren  Meldungen  von  U-Boot  <EFBFBD>ber  das LCD-Display ausgegeben werden;
au<EFBFBD>erdem kann man durch das mit dieser  Tastenkombination  verkn<EFBFBD>pfte
Kommando  z. B. die Linux-Bootmeldungen ebenfalls auf das LCD-Display
legen, so da<EFBFBD> der Boot-Vorgang direkt und  ohne  weitere  Hilfsmittel
analysiert werden kann.

Beispiel:

In U-Boot werden folgende Environment-Variablen gesetzt und abgespei-
chert:

(1)	=> setenv magic_keys 01234#X
(2)	=> setenv key_cmd# setenv addfb setenv bootargs \\$(bootargs) console=tty0 console=ttyS1,\\$(baudrate)
(3)	=> setenv nfsargs setenv bootargs root=/dev/nfs rw nfsroot=\$(serverip):\$(rootpath)
(4)	=> setenv addip setenv bootargs \$(bootargs) ip=\$(ipaddr):\$(serverip):\$(gatewayip):\$(netmask):\$(hostname)::off panic=1
(5)	=> setenv addfb setenv bootargs \$(bootargs) console=ttyS1,\$(baudrate)
(6)	=> setenv bootcmd bootp\;run nfsargs\;run addip\;run addfb\;bootm

Hierbei wird die Linux Commandline (in der Variablen  "bootargs")  im
Boot-Kommando  "bootcmd"  (6)  schrittweise zusammengesetzt: zun<EFBFBD>chst
werden die f<EFBFBD>r Root-Filesystem <EFBFBD>ber NFS erforderlichen  Optionen  ge-
setzt  ("run  nfsargs", vgl. (3)), dann die Netzwerkkonfiguration an-
gef<EFBFBD>gt ("run addip", vgl. (4)),  und  schlie<EFBFBD>lich  die  Systemconsole
definiert ("run addfb").

Dabei wird im Normalfall die Definition (5)  verwendt;  wurde  aller-
dings  beim  Reset die entsprechende Taste gedr<EFBFBD>ckt gehalten, so wird
diese Definition bei der Ausf<EFBFBD>hrung des in (2) definierten  Kommandos
<EFBFBD>berschrieben,  so  da<EFBFBD>  Linux die Bootmeldungen auch <EFBFBD>ber das Frame-
buffer-Device (=LCD-Display) ausgibt.

Beachten Sie die Verdoppelung der '\'-Escapes in der  Definition  von
"key_cmd#" - diese ist erforderlich, weil der String _zweimal_ inter-
pretiert  wird:  das  erste  Mal  bei der Eingabe von "key_cmd#", das
zweite Mal, wenn der String (als  Inhalt  von  "preboot")  ausgef<EFBFBD>hrt
wird.