diff --git a/WEGA/src/cmd/pburn/pburn.1 b/WEGA/src/cmd/pburn/pburn.1 new file mode 100644 index 0000000..df5a610 --- /dev/null +++ b/WEGA/src/cmd/pburn/pburn.1 @@ -0,0 +1,176 @@ +NAME + pburn - prom programmer + +SYNTAX + pburn + +BESCHREIBUNG + Pburn ist ein universeller EPROM-Programmer. Das Programm arbeitet + menuegesteuert. + + Das Kommando kann nur von der Systemkonsole ausgefuehrt werden. Das + Betriebssystem WEGA muss dazu ueber die WEGA-Startdiskette gestar- + tet werden. + + Nach Aufruf des Kommandos erfolgt auf der Standardausgabe folgende + Dialogbereitschaft: + + pburn - prom programmer + (c) zft/keaw 31.12.1987/v ... + ============================= + menue: + p - program + l - list + t - crc + b - bytemode + f - file + c - copy + q - quit + select? + + Danach kann ein entsprechendes Kommando der gewuenschten Funktion + eingegeben werden. Das eingegebene Kommando erzeugt wiederum eine + Dialogfolge die entsprechend ueber die Standardeingabe beantwortet + werden muss. Grundsaetzlich kann jede Dialoganforderung ueber die + Eingabe 'q' abgebrochen werden. + +OPTIONEN + Optionale Angaben zur Datei: filename [ -w ] [ -D ] [ -ose hex ] + + filename a.out-Datei (S_MAGIC1, S_MAGIC3, S_MAGIC4, N_MAGIC1, + N_MAGIC3, N_MAGIC4, X_MAGIC1, X_MAGIC3, X_MAGIC4). + Siehe a.out(5). + + -w Programmierung wortorientierter Dateien in der Reihen- + folge: low Byte, high Byte (bezogen auf die Offset- + Adresse). + Erstellung wortorientierter Dateien aus mehreren + EPROM's in der Reihenfolge: low Byte, high Byte. + + -D Es wird nur die Datensektion programmiert. Diese Op- + tion ist nur sinnvoll fuer Dateien mit getrennten Co- + de- und Datenbereich (separated I&D). Normalerweise + wird die CODE-Section programmiert. + + -o Offset-Adresse (Startadresse) der a.out-Datei. + Standard ist der Beginn des Code-Offset der a.out-Datei. + + -s Selektierung der Segmentnummer der a.out-Datei. Nur + ein Segment zwischen 0 und 80 kann angegeben werden. + Standard ist 0. + + -e Entry-Adresse bei der Erzeugung von a.out-Dateien. + Standard ist 0. + + Optionale Angaben zum Epromtype: promtype [ -ol hex ] + + promtype e2708, e2716, e2732, e2732a, e2764 + + -o Offset-Adresse (Startadresse) des EPROM's. + Standard ist 0. + + -l Laenge des zu programmierenden Teils des EPROM's. + Standard entspricht der Laenge des jeweiligen EPROM- + Typs. + + + Vor jedem Programmieren, Lesen und Vergleichen von EPROM's werden + Bereitschaftsmeldungen in der Form + + ready to ... + . + . + . ?(y/r/s/ ... /q) + + auf der Standardausgabe angegeben. Diese Bereitschaftsmeldungen ent- + sprechen den Parameterangaben in den Dialoganforderungen. Sie sind + entsprechend zu beantworten. Im einzelnen haben sie folgende Bedeu- + tung: + + y yes - Ausfuehren der Funktion und gegebenfalls erhoehen des + Adressbereichs + + r repeat - Einstellen des vorangegangenen Adressbereichs bzw. + Wiederholen der vorangegangenen Funktion (Copy, Verify EPROM's). + + s skip - Erhoehen des Adressbereichs. + + m modify - spezifiziert die Moeglichkeit des Anzeigens bzw. des + Modifizieren einzelner Bytes (Datei, EPROM). Waehrend der Abar- + beitung des Kommandos erscheint auf der Standardausgabe die + Frage: + + modify ... + address to modify? + + Ist die Adresse angegeben, wird der Inhalt diese Bytes + angezeigt (Adressangaben beziehen sich grundsaetzlich + auf die entsprechenden Prom-Adressen). + Der Anwender hat jetzt folgende Moeglichkeiten der + Eingabe: + + - Eingabe eines hexadezimalen Wertes zwecks Modifikation des + angezeigten Inhalts des Bytes + + - Eingabe eines Newline zwecks Anzeige des naechsten Bytes + + - Eingabe eines 'q' zwecks Ruecksprung zur Frage 'address to + modify?' + + v verify - Vergleichen von EPROM's (Funktion c - copy) + bzw. Vergleichen des Inhalts eines EPROM's mit dem Inhalt einer + a.out-Datei (Funktion p - program) und erhoehen des Adressbe- + reichs. + + l list - Auflisten des Inhalts von a.out-Dateien bzw. von + EPROM's. + + t test - Ermittlung der Pruefsumme einer a.out-Datei. + + q quit - Funktion wird nicht ausgefuehrt, Rueckkehr in das + Anfangsmenue. + + + Die Ausfuehrung der Funktionen wird auf der Standardausgabe ange- + zeigt. Bei den Funktionen 'f - file' und 'c - copy' erfolgt die Wei- + terfuehrung der Funktion ueber eindeutige Eingabeanforderungen + (z.B. 'change to next prom?') an den Anwender. Diese sind jeweils + mit 'y' zu quittieren. Eine andere Quittierung fuehrt zum Abbruch der + Funktion. + + Die Funktion 'b - bytemode' ermoeglicht das Programmieren (Korrigie- + ren) einzelner Bytes eines EPROM's. Unmittelbar nach dem Start der + Bereitschaftsmeldung ('y') erscheint auf der Standardausgabe + + bytemode ... + address to modify? + + Wird eine Adresse eingegeben, dann wird der Inhalt diese Bytes ange- + zeigt. Der Anwender hat jetzt folgende Moeglichkeit der Eingabe: + + - Eingabe eines hexadezimalen Wertes zwecks Modifikation des ange- + zeigten Inhalts des Bytes (Beachte: der eingegebene Wert ist nicht + programmierbar, wenn bei einem oder mehreren Bits des Bytes Wertig- + keitsaenderungen nicht moeglich sind). + + - Eingabe eines Newline zwecks Anzeigen des naechsten Bytes. + + - Eingabe eines 'q' zwecks Ruecksprung zu der Frage 'address to modify' + + Sollte waehrend des Pruefens des EPROM's ein Fehler (oder mehrere) + gefunden werden, werden diese Fehler auf der Standardausgabe ange- + zeigt. Die Beantwortung von 'continue?' mit 'y' fuehrt zu einer weite- + ren Auflistung. Eine andere Quittierung fuehrt zum Abbruch der Fehler- + auflistung. + +SIEHE AUCH + load(1), a.out(5) + +DIAGNOSTIK + Bei Syntaxfehlern, nicht zugreifbaren Dateien, Funtionsfehlern usw. + werden Meldungen in Form von 'error...' bzw. 'warning...' ausgegeben. + Diese koennen bei Beantwortung einer moeglichen Eingabeanforderung + von 'continue' mit 'y' ignoriert werden unter Beachtung der jeweiligen + Einschraenkung der entsprechenden Funktion. Eine andere Beantwortung + fuehrt zum Abbruch der Funktion. +