Register-Monitor
================

1. Ziel
-------
Es soll möglich sein, unter Linux auf sämtliche Peripherie-Register eines 
Prozessors zugreifen zu können, ohne dass ein besonderer Treiber benötigt 
wird. Damit kann z.B. nachgesehen werden, wie ein existierender Treiber eine 
Hardware einstellt usw.

Als Identifikation der Register soll die phsikalische (also ungemappte) 
Adresse verwendet werden. Es werden _keine_ Sicherungsmassnahmen getroffen, 
die die Zugriffe behindern könnten. 
Die Benutzung erfolgt auf eigene Gefahr!!!
(Nicht dass einer weint, wenn er sich die Maschine abgeschossen hat...)

2. Funktion
-----------
Mit Hilfe der Funktion mmap() wird /dev/mem auf virtuelle Adressen gemappt 
über die dann der eigentlich Zugriff erfolgt. Damit keine Probleme beim 
Verlassen des gemappten Speicherbereichs auftreten können, wird das mapping 
für jeden Zugriff neu gemacht. Da meistens nur einzelne Register bearbeitet 
werden, sollte sich der Aufwand nicht negativ bemerkbar machen 

3. Benutzung
------------
Der Aufruf erfolgt ohne Kommandozeilenparameter. Evtl muss das Programm mit 
root-Rechten gestartet werden um Zugriff auf /dev/mem zu erhalten. 
Die Eingabe von "?" zeigt eine kurze Zusammenfassung der Kommandos.
Sämtliche numerischen Parameter werden ausschliesslich im Hex-Format 
angegeben (wahlweise mit/ohne "0x"-Prefix).

3.1 Lesen
Der Lesezugriff erfolgt mit dem Kommando "md" (Memory Dump) gefolgt von einer 
physikalischen Adresse und der Angabe der Anzahl der auszugeben Elemente. 

Beispiel (Ausgabe von 4 Registern):

=>md 0x12345678 4
12345678: 31745363
1234567C: 61686331
12345680: 72745F72
12345684: 73746961

3.2 Schreiben
Schreibzugriffe erfolgen mit "mm" (Memory Modify) und sind immer 32 Bit breit.
Das Kommando benötigt als Kommando nur einen Parameter und zwar die Angabe der 
physikalischen Adresse. Neben der Adresse wird in eckigen Klammern der 
aktuelle Wert des Registers angezeigt. Es erfolgt nur eine rudimentäre Prüfung 
des eingegebenen neuen Wertes. Fehleingaben werden also _nicht_ abgefangen.
Wenn eine leere Eingabe mit Return abgeschlossen wird, wird die aktuelle 
Adresse übersprungen. Eingaben unter 8 Zeichen Länge werden mit 
vorangestellten Nullen aufgefüllt Eingaben, die absolut nicht als Zahl 
interpretiert werden können führen zum Verlassen der Funktion.

3.3 Sonstiges
Mit den Kommandos "b", "w" und "d" kann die Darstellung in Bytes, Words und 
Dwords erreicht werden. Default ist "d".

Das Kommando "c" dient zur Einstellung der Anzahl der Spalten:
=>c 4
Columns set to 4
=>md 12345678 10
12345678: 31745363 61686331 72745F72 73746961
12345688: 45456349 455F3353 4E5A5F00 73726953
12345698: 52465045 69387453 625F736F 53657361
123456A8: 00455F30 4B4E5A5F 67366953 6E756F63

Default ist eine einspaltige Anzeige.

Mit den Kommandos "be" und "le" kann zwischen Little- und Big-Endian 
umgeschaltet werden. 

Mit der Eingabe-Umleitung kann man kleine "Skripts" ablaufen lassen, die 
bestimmte Zugriffe automatisch durchführen:
regmon < init.reg

Das Kommado "q" beendet das Programm.

4. Übersetzen
-------------
Mit "gcc -o regmon regmon.c" kann das Source-File auf Platformen übersetzt 
werden, für die ein Native-Compiler vorliegt. 
Getestet wurden bisher x86-linux, sowie arm-linux (S3C6400).


AND 06.08.2008