add version : 1.4

This commit is contained in:
Oliver Lehmann 1987-11-11 10:58:04 +00:00
parent 11efd5076a
commit 5f39f5afe2
1 changed files with 176 additions and 0 deletions

176
WEGA/src/cmd/pburn/pburn.1 Normal file
View File

@ -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.