Trailing-Edge
-
PDP-10 Archives
-
klad_sources
-
klad.sources/convrt.txt
There are no other files named convrt.txt in the archive.
;DDQDG
IDENTIFICATION
--------------
PRODUCT CODE: AH-E282N-DD
DIAGNOSTIC CODE: DDQDG
PRODUCT NAME: DDQDGN0 DECSYSTEM DIAGNOSTIC
ASCIIZER CONVERSION PROGRAM
VERSION: 0.14
DATE RELEASED: MAY 1978
MAINTAINED BY: DIAGNOSTIC ENGINEERING
AUTHOR: JOHN R. KIRCHOFF
COPYRIGHT (C) 1978
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
THIS SOFTWARE IS FURNISHED UNDER A LICENSE FOR USE ONLY ON A
SINGLE COMPUTER SYSTEM AND MAY BE COPIED ONLY WITH THE INCLUSION
OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE, OR ANY OTHER
COPIES THEREOF, MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE
TO ANY OTHER PERSON EXCEPT FOR USE ON SUCH SYSTEM AND TO ONE WHO
AGREES TO THESE LICENSE TERMS. TITLE TO AND OWNERSHIP OF THE
SOFTWARE SHALL AT ALL TIMES REMAIN IN DIGITAL EQUIPMENT
CORPORATION.
THE INFORMATION IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL
EQUIPMENT CORPORATION.
DIGITAL EQUIPMENT CORPORATION ASSUMES NO RESPONSIBILITY FOR THE
USE OR RELIABILITY OF ITS SOFTWARE IN EQUIPMENT WHICH IS NOT
SUPPLIED BY DIGITAL EQUIPMENT CORPORATION.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
TABLE OF CONTENTS
-----------------
1.0 ABSTRACT
2.0 OPERATING PROCEDURE
3.0 FILE FORMATS
4.0 PDP-11 FILE FORMATS
5.0 PDP-10 FILE FORMATS
6.0 KL10 MICRO CODE FILE FORMATS
7.0 PDP-8 FILE FORMATS
8.0 DX20 FILE FORMATS
9.0 KS-10 MICRO-CODE FILE FORMATS
10.0 KMC11 MICRO-CODE FORMATS
11.0 OCTAL FILE FORMATS
12.0 SPECIFIED FILE EXTENSIONS
13.0 FILE IDENTIFICATION
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
1.0 ABSTRACT
ALL OF THE DIAGNOSTIC AND PROGRAM FILES FOR THE DECSYSTEM10/20
ARE CONVERTED INTO A COMPATIBLE FILE FORMAT WHICH ALLOWS
FOR A COMMON HANDLING PROCEDURE.
THIS FILE FORMAT IS LOADABLE FROM ANY STORAGE MEDIUM BOTH
BY THE PDP-10 AND BY THE PDP-11.
"CONVRT" IS THE DIAGNOSTIC UTILITY PROGRAM WHICH PERFORMS
THIS FUNCTION.
2.0 OPERATING PROCEDURE
COMMAND IS "FILE.EXT/SWITCH"
PDP-10 'EXT' DEFAULT IS 'SAV'
PDP-11 'EXT' DEFAULT IS 'BIN'
PDP-8 'EXT' DEFAULT IS 'BIN'
DX20 'EXT' DEFAULT IS 'BIN'
MICRO 'EXT' DEFAULT IS 'MCR'
KMC11 'EXT' DEFAULT IS 'BIN'
COMMAND FUNCTION
------- --------
FILE PDP-10 SAVE FILE TO '.A10'
FILE/T " DEFAULT
FILE/A PDP-10 SAVE FILE TO "SUPER" '.A10'
FILE/S PDP-10 '.A10' FILE BACK TO '.SAV'
FILE/E PDP-11 BINARY FILE TO '.A11'
FILE/8 PDP-8 BINARY FILE TO '.A8'
FILE/X DX20 BINARY FILE TO '.ADX'
FILE/K KS-10 MICRO-CODE LISTING TO '.RAM'
FILE/M MICRO-CODE LISTING TO '.RAM'
FILE/R MICRO RAM FILE ONLY, NO LISTING
FILE/C KMC11 MICROCODE TO '.KMC'
/N DON'T PRINT MICRO CODE ERRORS
/H HELP MESSAGE
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
3.0 FILE FORMATS
THE PROGRAM FILES CONSIST OF BINARY DATA WHICH HAS BEEN
"ASCIIZED", THAT IS, MANIPULATED SUCH THAT 6 OR LESS BITS
OF THE BINARY DATA ARE REPRESENTED BY A 7-BIT CHARACTER
WHOSE VALUE RANGES FROM OCTAL 075 TO OCTAL 174. THIS
PROCESS IS EMPLOYED TO AVOID THE PROBLEMS WHICH WOULD BE
ENCOUNTERED IF CERTIAN 7-BIT COMBINATIONS WERE ALLOWED
(E.G., OCTAL 003 WOULD BE INTERPRETED AS "CONTROL C").
"ASCIIZED" DATA IS PRODUCED FROM THE SOURCE BINARY DATA AS
FOLLOWS:
1. DIVIDE THE BINARY DATA INTO 6-BIT FIELDS, STARTING WITH
THE LEAST SIGNIFICANT 6 BITS. DEPENDING ON THE NUMBER
OF BITS IN THE SOURCE DATA, THE MOST SIGNIFICANT FIELD
MAY BE COMPOSED OF FROM 1 TO 6 BITS.
2. CONVERT EACH FIELD INTO A 7-BIT CHARACTER USING THE
FOLLOWING PROCEDURE:
2A. IF THE FIELD HAS A VALUE LESS THAN OCTAL 75, ADD
OCTAL 100 (PRODUCING 7-BIT VALUES RANGING FROM
OCTAL 100 TO OCTAL 174).
2B. IF THE FIELD HAS VALUES OCTAL 75, 76, OR 77 USE
THE FIELD DIRECTLY (PRODUCING 7-BIT VALUES 075,
076, OR 077).
EXAMPLE:
A 16 BIT WORD CONTAINING OCTAL 176076 IS DIVIDED INTO 3 FIELDS
(ONE 4-BIT AND TWO 6-BIT):
17, 60, 76
THE FIELDS ARE CONVERTED INTO 7-BIT CHARACTERS:
117, 160, 076
WHICH ARE THE ASCII CODES FOR THE GRAPHICS:
O, LOWER CASE P, >
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
4.0 PDP-11 FILE FORMATS
PDP-11 PROGRAMS ARE ASSEMBLED WITH MACY11 ON A DECSYSTEM10
WHICH PRODUCES A PDP-11 BINARY FILE ON THE PDP-10 DISK OF
THE FOLLOWING FORMAT:
PDP-11 BINARY FILE FORMAT
-------------------------
11 BINARY ON 10 DISK - 36 BIT WORDS
BYTE 2/BYTE 1,,BYTE 4/BYTE 3
6 5,, 8 7
10 9,, 12 11
ETC.
ACTUAL FORMAT
FRAME 0 001 ;START FRAME
1 000 ;NULL
2 XXX ;BYTE COUNT LOW 8 BITS
3 XXX ;BYTE COUNT HIGH 8 BITS
4 YYY ;LOAD ADDRESS LOW 8 BITS
5 YYY ;LOAD ADDRESS HIGH 8 BITS
6 NNN
.
. ;DATA BYTES
.
NNN
ZZZ ;BLOCK CHECKSUM
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
4.0 PDP-11 FILE FORMATS (CON'T)
PDP-11 ASCIIZED FILE FORMAT
---------------------------
E WC,ADR,123,123,123, . . . . . .123,CKS
E WC,ADR,123,123,123, . . . . . .123,CKS
E 0,ADR,CKS
E ;PDP-11 FILE IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
WC ;WORD COUNT
ADR ;LOAD ADDRESS
123 ;UP TO 3 CHARS FOR EACH 16-BIT DATA WORD
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE PDP-11
FILE, DEPENDS ON SIZE OF FILE.
E ;PDP-11 IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
0 ;WORD COUNT, WC OF ZERO SIGNIFIES TRANSFER BLOCK
ADR ;PDP-11 STARTING ADDRESS
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
THERE IS A MAXIMUM OF 30 16 BIT DATA WORDS PER FILE LINE
WHICH PRODUCES A MAXIMUM OF 131 CHARACTERS PER LINE COUNTING
THE FILE IDENTIFIER, THE WORD COUNT, THE LOAD ADDRESS, THE
DATA, THE LINE CHECKSUM AND THE FORMAT CHARACTERS.
THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM THAT
WHEN THE WORD COUNT, THE LOAD ADDRESS, THE DATA AND THE
CHECKSUM ARE ADDED TOGETHER PRODUCES A 16 BIT ZERO SUM.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
5.0 PDP-10 FILE FORMATS
PDP-10 PROGRAMS ARE ASSEMBLED, LOADED AND SAVED WHICH THEN
CREATES A PDP-10 FILE IMAGE AS GIVEN IN THE FOLLOWING
DESCRIPTION:
PDP-10 SAVE FILE FORMAT
-----------------------
-WC,,ADR ;-WC = NEGATIVE WORD COUNT OF THE DATA
DATA ; WORDS FOLLOWING
DATA
DATA ;ADR = LOAD ADDRESS -1 FOR THE DATA
DATA
-WC,,ADR
DATA
.
.
JRST,,ADR ;START TRANSFER ADDRESS
PDP-10 ASCIIZED FILE FORMAT
---------------------------
PDP-10 ASCIIZED FILES ARE COMPOSED OF THREE TYPES OF
FILE LOAD LINES. THEY ARE:
A. CORE ZERO LINE
THIS LOAD FILE LINE SPECIFIES WHERE AND HOW MUCH PDP-10 CORE
TO BE ZEROED. THIS IS NECESSARY AS THE PDP-10 FILES ARE
ZERO COMPRESSED WHICH MEANS THAT ZERO WORDS ARE NOT INCLUDED
IN THE LOAD FILE TO CONSERVE FILE SPACE.
CORE ZERO LINE
Z WC,ADR,COUNT,...,CKSUM
Z = PDP-10 CORE ZERO
WORD COUNT = 1 TO 4
ADR = ZERO START ADDRESS
DERIVED FROM C(JOBSA)
COUNT = ZERO COUNT, 64K MAX
DERIVED FROM C(JOBFF)
IF THE ADDRESSES ARE GREATER THAN 64K THE HI 2-BITS OF
THE 18 BIT PDP-10 ADDRESS ARE INCLUDED AS THE HI-BYTE OF
THE WORD COUNT.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
5.0 PDP-10 FILE FORMATS (CON'T)
B. LOAD FILE LINES
AS MANY OF THESE TYPES OF LOAD FILE LINES ARE REQUIRED AS ARE
NECESSARY TO REPRESENT THE BINARY SAVE FILE.
LOAD FILE LINE
T WC,ADR,DATA 20-35,DATA 4-19,DATA 0-3, - - - ,CKSUM
T = PDP-10 TYPE FILE
WC = PDP-10 DATA WORD COUNT TIMES 3, 3 PDP-11 WORDS
PER PDP-10 WORD.
ADR = PDP-10 ADDRESS FOR THIS LOAD FILE LINE
LOW 16 BITS OF THE PDP-10 18 BIT ADDRESS, IF
THE ADDRESS IS GREATER THAN 64K, THE HI 2-BITS
OF THE ADDRESS ARE INCLUDED AS THE HI-BYTE OF
THE WORD COUNT.
UP TO 8 PDP-10 WORDS, OR UP TO 24 PDP-11 WORDS
DATA 20-35
DATA 4-19 ;PDP-10 EQUIV DATA WORD BITS
DATA 0-3
CKSUM = 16 BIT NEGATED CHECKSUM OF WC, ADR & DATA
C. TRANSFER LINE
THIS LOAD FILE LINE CONTAINS THE FILE STARTING ADDRESS.
TRANSFER LINE
T 0,ADR,CKSUM
0 = WC = SIGNIFIES TRANSFER, EOF
ADR = PROGRAM START ADDRESS
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
D. SUPER '.A10' LOAD FILE LINES
THESE LOAD FILE LINES PROVIDE A MORE COMPRESSED ASCIIZED
REPRESENTATION OF THE BINARY SAVE FILE.
DATA IS REPRESENTED AS 36 BIT WORDS WITH LEADING ZERO 6 BIT
OITS SUPPRESSED, INTERMEDIATE ZERO 6 BIT OITS SUPPRESSED AND
AN ALTERNATE CHARACTER SUBSTITUTED TO REPRESENT THE AMOUNT OF
ZERO 6 BIT OITS SUPPRESSED, AND 77 6 BIT OITS SUPPRESSED AND
AN ALTERNATE CHARACTER SUBSTITUTED TO REPRESENT THE AMOUNT OF
77 6 BIT OITS SUPPRESSED.
INTERMEDIATE ZERO 6 BIT OITS REPRESENTATIONS:
"0" = 00 ;6 BITS OF ZEROS
"1" = 0000 ;12 BITS OF ZEROS
"2" = 000000 ;18 BITS OF ZEROS
"3" = 00000000 ;24 BITS OF ZEROS
"4" = 0000000000 ;30 BITS OF ZEROS
77 6 BIT OITS REPRESENTATIONS:
"5" = 77 ;6 BITS OF ONES
"6" = 7777 ;12 BITS OF ONES
"7" = 777777 ;18 BITS OF ONES
"8" = 77777777 ;24 BITS OF ONES
"9" = 7777777777 ;30 BITS OF ONES
":" = 777777777777 ;36 BITS OF ONES
LOAD FILE LINE
A WC,ADR,DATA 0-35, - - - ,CKSUM
A = PDP-10 TYPE FILE
WC = PDP-10 DATA WORD COUNT
ADR = PDP-10 ADDRESS FOR THIS LOAD FILE LINE
LOW 16 BITS OF THE PDP-10 18 BIT ADDRESS, IF
THE ADDRESS IS GREATER THAN 64K, THE HI 2-BITS
OF THE ADDRESS ARE INCLUDED AS THE HI-BYTE OF
THE WORD COUNT.
UP TO 10 PDP-10 WORDS
CKSUM = 16 BIT NEGATED CHECKSUM OF WC, ADR & DATA
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
6.0 KL10 MICRO CODE FILE FORMATS
THE KL10 MICRO CODE FILE CONSISTS OF TWO DIFFERENT TYPES
OF DATA.
THE CONTROL RAM CONSISTS OF 80 BITS PLUS A 5 BIT SPECIAL
FIELD PER CONTROL RAM LOCATION. THIS THEN REQUIRES SIX
16 BIT WORDS TO REPRESENT THE CONTROL RAM DATA. THE LOAD
FILE IS ARRANGED SO AS FACILITATE LOADING OF THE C-RAM WITH
THE "WCRAM" ROUTINE.
THE DISPATCH RAM CONSISTS OF PAIRS OF LOCATIONS. THIS
THEN REQUIRES THREE 16 BIT WORDS PER PAIR OF D-RAM LOCATIONS.
THIS FILE IS ARRANGED TO FACILITATE LOADING OF THE D-RAM
WITH THE "WDRAM" ROUTINE.
BOTH THE C-RAM AND D-RAM DATA ARE COMBINED INTO A SINGLE
LOAD FILE TO FACILITATE HANDLING AND TO KEEP THE ASSOCIATED
VERSIONS TOGETHER.
THE MICRO CODE LOAD FILE ALSO CONTAINS A C-RAM ZERO LINE
USED TO ZERO THE CONTROL RAM BEFORE LOADING ANY DATA INTO
IT. THE C-RAM IS ZEROED FROM LOCATION ZERO UP TO THE HIGHEST
USED C-RAM LOCATION.
IF THE MICRO-CODE DOES NOT CONTAIN ANY DATA IN C-RAM LOCATION
0, THE "Z" BLOCK IS NOT DONE WHICH PREVENTS C-RAM ZEROING AND
ALLOWS FOR MICRO-CODE OVERLAYS TO BE GENERATED.
EXAMPLE FILE:
Z WC,ADR,CKS
C WC,ADR,DATA,DATA,...,CKSUM
C "
C "
C ,,
D WC,ADR,DATA,DATA,...,CKSUM
D "
D "
D ,,
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
6.0 KL10 MICRO CODE FILE FORMATS (CON'T)
CONTROL RAM FORMAT
------------------
Z WC,ADR,COUNT,CKSUM
Z ;C-RAM ZERO
;SPACE, ASCIIZED FORMAT
WC ;WORD COUNT = 1
ADR ;ZERO START ADDRESS = 0
COUNT ;ZERO COUNT, DERIVED FROM HIGHEST USED ADDRESS
C WC,ADR,64-79,48-63,32-47,16-31,00-15,0-4,.....,CKSUM
C ;C-RAM FILE IDENTIFIER
;SPACE, ASCIIZED FILE TYPE
WC ;WORD COUNT, C-RAM WORD COUNT TIMES 6, 6 PDP-11
; WORDS PER C-RAM WORD
ADR ;C-RAM ADDRESS FOR THIS LOAD FILE LINE
64-79 ;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
48-63 ;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
32-47 ;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
16-31 ;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
00-15 ;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
0-4 ;C-RAM BITS AS SPECIFIED UNDER "WCRAM"
CKSUM ;16 BIT NEGATED CHECKSUM OF WC, ADR & DATA
C ,,
C ;C-RAM FILE IDENTIFIER
;SPACE, ASCIIZED FILE FORMAT
, ;WC = 0, END OF FILE
, ;ADR = 0, NO START ADDRESS
A C-RAM LOAD FILE LINE MAY CONTAIN UP TO 5 C-RAM LOCATIONS.
THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM OF
THE WORD COUNT, THE LOAD ADDRESS AND THE C-RAM DATA
REPRESENTED IN 16 BIT FORMAT.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
6.0 KL10 MICRO CODE FILE FORMATS (CON'T)
D-RAM FORMAT
------------
D WC,ADR,EVEN,ODD,COMMON,.......,CKSUM
D ;D-RAM FILE IDENTIFIER
;SPACE, ASCIIZED FILE TYPE
WC ;WORD COUNT, D-RAM LOCATION PAIRS TIMES 3, 3 PDP-11
; 16 BIT WORDS PER PAIR OF LOCATIONS.
EVEN ;D-RAM EVEN BITS AS SPECIFIES UNDER "WDRAM"
ODD ;D-RAM ODD BITS AS SPECIFIED UNDER "WDRAM"
COMMON ;D-RAM COMMON BITS AS SPECIFIED UNDER "WDRAM"
CKSUM ;16 BIT NEGATED CHECKSUM OF WC, ADR & DATA
D ,,
D ;D-RAM FILE IDENTIFIER
;SPACE, ASCIIZED FILE FORMAT
, ;WC = 0, END OF FILE
, ;ADR = 0, NO START ADDRESS
A D-RAM LOAD FILE LINE MAY CONSIST OF UP TO 10
PAIRS OF D-RAM LOCATIONS.
THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM OF
THE WORD COUNT, THE LOAD ADDRESS AND THE D-RAM DATA
REPRESENTED IN 16 BIT FORMAT.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
7.0 PDP-8 FILE FORMATS
PDP-8 PROGRAMS ARE ASSEMBLED WITH PAL10 ON A DECSYSTEM10
WHICH PRODUCES A PDP-8 BINARY FILE ON THE PDP-10 DISK OF
THE FOLLOWING FORMAT:
PDP-8 BINARY FILE FORMAT
------------------------
DATA IS REPRESENTED AS IF IT WAS AN EIGHT CHANNEL PAPER
TAPE.
A. THE LEADER/TRAILER IS CHANNEL 8 ONLY.
B. AN ADDRESS IS DESIGNATED BY A CHANNEL 7 PUNCH
C. DATA FOLLOWS THE ADDRESS IN SEQUENTIAL ORDER
PDP-8 ASCIIZED FILE FORMAT
--------------------------
8 WC,ADR,12,12,12, . . . . . .12,CKS
8 WC,ADR,12,12,12, . . . . . .12,CKS
8 0,ADR,CKS
8 ;PDP-8 FILE IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
WC ;WORD COUNT
ADR ;LOAD ADDRESS
12 ;UP TO 2 CHARS FOR EACH 12-BIT DATA WORD
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE PDP-8
FILE, DEPENDS ON SIZE OF FILE.
8 ;PDP-8 IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
0 ;WORD COUNT, WC OF ZERO SIGNIFIES TRANSFER BLOCK
ADR ;PDP-8 STARTING ADDRESS
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
THERE IS A MAXIMUM OF 32 12 BIT DATA WORDS PER FILE LINE
WHICH PRODUCES A MAXIMUM OF 123 CHARACTERS PER LINE COUNTING
THE FILE IDENTIFIER, THE WORD COUNT, THE LOAD ADDRESS, THE
DATA, THE LINE CHECKSUM AND THE FORMAT CHARACTERS.
THE FILE LINE CHECKSUM IS THE 12 BIT NEGATED CHECKSUM THAT
WHEN THE WORD COUNT, THE LOAD ADDRESS, THE DATA AND THE
CHECKSUM ARE ADDED TOGETHER PRODUCES A 12 BIT ZERO SUM.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
8.0 DX20 FILE FORMATS
THE DX20 MICRO-PROCESSOR PROGRAMS ARE ASSEMBLED WITH MACRO-10
ON A DECSYSTEM10 WHICH PRODUCES A PDP-10 BINARY FILE ON THE
PDP-10 DISK OF THE FOLLOWING FORMAT:
DX20 BINARY FILE FORMAT
-----------------------
----
16-BIT DATA FOR CRAM LOC 0
16-BIT DATA FOR CRAM LOC 1
16-BIT DATA FOR CRAM LOC 2
I
I
V
16-BIT DATA FOR CRAM LOC M - IF NO WRAM DATA, FILE WILL END HERE
-1 (36-BITS) - SIGNIFIES WRAM DATA
8-BIT DATA FOR WRAM LOC 0
8-BIT DATA FOR WRAM LOC 1
8-BIT DATA FOR WRAM LOC 2
I
I
V
8-BIT DATA FOR WRAM LOC N
----
MAXIMUM M = 3777(8)
MAXIMUM N = 1777(8)
ALL FILES WILL HAVE A VERSION NUMBER IN CRAM LOCATION 0 WITH
THE 6-BIT VERSION NUMBER IN BITS 20 TO 25 OF THE 36-BIT WORD
AND A 10-BIT EDIT NUMBER IN BITS 26-35.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
8.0 DX20 FILE FORMATS (CON'T)
DX20 ASCIIZED FILE FORMAT
-------------------------
C WC,ADR,123,123,123, . . . . . .123,CKS
C WC,ADR,123,123,123, . . . . . .123,CKS
W WC,ADR,12,12,12,12, . . . . .12,CKS
W WC,ADR,12,12,12,12, . . . . .12,CKS
W 0,ADR,CKS
C ;CRAM FILE IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
WC ;WORD COUNT
ADR ;LOAD ADDRESS
123 ;UP TO 3 CHARS FOR EACH 16-BIT DATA WORD
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE DX20 CRAM
FILE, DEPENDS ON SIZE OF FILE.
W ;WRAM FILE IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
WC ;WORD COUNT
ADR ;LOAD ADDRESS
12 ;UP TO 2 CHARS FOR EACH 8-BIT DATA WORD
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE DX20 WRAM
FILE, DEPENDS ON SIZE OF FILE.
W ;DX20 IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
0 ;WORD COUNT, WC OF ZERO SIGNIFIES TRANSFER BLOCK
ADR ;DX20 STARTING ADDRESS
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
THERE IS A MAXIMUM OF 30 16 BIT DATA WORDS PER FILE LINE
WHICH PRODUCES A MAXIMUM OF 131 CHARACTERS PER LINE COUNTING
THE FILE IDENTIFIER, THE WORD COUNT, THE LOAD ADDRESS, THE
DATA, THE LINE CHECKSUM AND THE FORMAT CHARACTERS.
THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM THAT
WHEN THE WORD COUNT, THE LOAD ADDRESS, THE DATA AND THE
CHECKSUM ARE ADDED TOGETHER PRODUCES A 16 BIT ZERO SUM.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
9.0 KS-10 MICRO-CODE FILE FORMATS
THE KS-10 MICRO-CODE FILE CONSISTS OF A SPECIAL 36-BIT BINARY
FILE WITH THE DATA ARRANGED SO THAT IT CAN BE USED DIRECTLY
BY THE KS-10 8080 CONSOLE PROCESSOR.
THE FILE CONSISTS OF 2048 WORD TRIPLETS TO REPRESENT THE 2K
BY 96 BIT KS-10 CRAM. THE DATA IS ARRANGED IN THE FOLLOWING
FORMAT:
1ST WORD [BITS 60 - 95]
2ND WORD [BITS 24 - 59]
3RD WORD [BITS 0 - 23]
THE 96 BITS CONTAINED IN THE MICRO-WORD ARE ARRANGED AS FOLLOWS:
00 - J00 24 - PB.CRA 48 - FM WR 72 - DBUS SEL 2
01 - J01 25 - CARRY IN 49 - MULTI SHFT 73 - DBUS SEL 1
02 - J02 26 - MEM FUNC 50 - PAR EN L 74 - DPA ADR 10
03 - J03 27 - DISP SEL 4 51 - PAR EN R 75 - DPA ADR 4
04 - J04 28 - DISP SEL 2 52 - DIVIDE 76 - DPA ADR 2
05 - J05 29 - DISP SEL 1 53 - MULTI PREC 77 - DPA ADR 1
06 - J06 30 - SPEC SEL 4 54 - #00 78 - DP HOLD L
07 - J07 31 - SPEC SEL 2 55 - #01 79 - DP HOLD R
08 - J08 32 - SPEC SEL 1 56 - #02 80 - DPB ADR 10
09 - J09 33 - SKIP SEL 4 57 - #03 81 - DPB ADR 4
10 - J10 34 - SKIP SEL 2 58 - #04 82 - PDB ADR 2
11 - J11 35 - SKIP SEL 1 59 - #05 83 - DPB ADR 1
12 - T00 36 - #06 60 - FUNC 04 84 - RAM ADR 4
13 - T01 37 - #07 61 - FUNC 02 85 - RAM ADR 2
14 - CALL 38 - #08 62 - FUNC 01 86 - RAM ADR 1
15 - SKIP EN 40 39 - #09 63 - SRC L 04 87 - DEST 4
16 - SKIP EN 20 40 - #10 64 - SRC L 02 88 - DEST 2
17 - SKIP EN 10 41 - #11 65 - SRC L 01 89 - DEST 1
18 - SPEC EN 40 42 - #12 66 - SRC R 04 90 - SC EN
19 - SPEC EN 20 43 - #13 67 - SRC R 02 91 - FE EN
20 - SPEC EN 10 44 - #14 68 - SRC R 01 92 - PAR CHK L
21 - DISP EN 40 45 - #15 69 - DBM SEL 4 93 - PAR CHK R
22 - DISP EN 20 46 - #16 70 - DBM SEL 2 94 - PB.CRM
23 - DISP EN 10 47 - #17 71 - DBM SEL 1 95 - MARK
ALSO PRODUCED IS A ".RSQ" FILE CONTAINING THE SEQUENCE NUMBERS
FROM THE MICROCODE LISTING. THIS FILE IS USED BY "CSL" TO
PROVIDE CROSS REFERENCE TO THE MICROCODE LISTING.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
10.0 KMC11 FILE FORMATS
KMC11 MICROCODE IS ASSEMBLED WITH MACY11 ON A DECSYSTEM10
WHICH PRODUCES A KMC11 BINARY FILE ON THE PDP-10 DISK OF
THE FOLLOWING FORMAT:
KMC11 BINARY FILE FORMAT
-------------------------
KMC11 BINARY ON 10 DISK - 36 BIT WORDS
BYTE 2/BYTE 1,,BYTE 4/BYTE 3
6 5,, 8 7
10 9,, 12 11
ETC.
ACTUAL FORMAT
FRAME 0 001 ;START FRAME
1 000 ;NULL
2 XXX ;BYTE COUNT LOW 8 BITS
3 XXX ;BYTE COUNT HIGH 8 BITS
4 YYY ;LOAD ADDRESS LOW 8 BITS
5 YYY ;LOAD ADDRESS HIGH 8 BITS
6 NNN
.
. ;DATA BYTES
.
NNN
ZZZ ;BLOCK CHECKSUM
ADDRESSES LESS THAN 100000 ARE DIVIDED BY 2 TO GIVE THE KMC11
C-RAM ADDRESS. ADDRESSES EQUAL TO OR GREATER THAN 100000
SIGNIFY KMC11 D-RAM ADDRESSES AND HAVE 100000 SUBTRACTED FROM
THEM TO GIVE THE D-RAM ADDRESS.
KMC11 C-RAM DATA IS 16 BITS AND KMC11 D-RAM DATA IS 8 BITS.
THE BINARY TRANSFER BLOCK SIGNIFIES THE KMC11 C-RAM START
ADDRESS.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
10.0 KMC11 FILE FORMATS (CON'T)
KMC11 ASCIIZED FILE FORMAT
---------------------------
C WC,ADR,123,123,123, . . . . . .123,CKS
C WC,ADR,123,123,123, . . . . . .123,CKS
D WC,ADR,12,12,12, . . . . . . . 12,CKS
D WC,ADR,12,12,12, . . . . . . . 12,CKS
C 0,ADR,CKS
C ;KMC11 C-RAM FILE IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
WC ;WORD COUNT
ADR ;LOAD ADDRESS
123 ;UP TO 3 CHARS FOR EACH 16-BIT DATA WORD
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
D ;KMC11 D-RAM FILE IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
WC ;WORD COUNT
ADR ;LOAD ADDRESS
12 ;UP TO 2 CHARS FOR EACH 8-BIT DATA WORD
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
AS MANY LINES OF THIS TYPE AS REQUIRED TO LOAD THE KMC11
FILE, DEPENDS ON SIZE OF FILE.
C ;KMC11 IDENTIFIER
;SPACE, SIGNIFIES ASCIIZED FILE
0 ;WORD COUNT, WC OF ZERO SIGNIFIES TRANSFER BLOCK
ADR ;KMC11 C-RAM STARTING ADDRESS
CKS ;FILE LINE CHECKSUM
CR/LF ;END OF LINE
THERE IS A MAXIMUM OF 30 16/8 BIT DATA WORDS PER FILE LINE
WHICH PRODUCES A MAXIMUM OF 131/101 CHARACTERS PER LINE
COUNTING THE FILE IDENTIFIER, THE WORD COUNT, THE LOAD
ADDRESS, THE DATA, THE LINE CHECKSUM AND THE FORMAT
CHARACTERS.
THE FILE LINE CHECKSUM IS THE 16 BIT NEGATED CHECKSUM THAT
WHEN THE WORD COUNT, THE LOAD ADDRESS, THE DATA AND THE
CHECKSUM ARE ADDED TOGETHER PRODUCES A 16 BIT ZERO SUM.
DECSYSTEM DIAGNOSTICS ASCIIZER CONVERSION PROGRAM
-------------------------------------------------
11.0 OCTAL FILE FORMATS
ANY OF THE PREVIOUSLY DESCRIBED FILE FORMATS MAY BE
PATCHED, CREATED OR UPDATED BY USING THE OCTAL FILE FORMAT
CAPABILITY. IN THE ASCIIZED FILE FORMAT THE SECOND CHARACTER
ON A LINE (THE SPACE) SIGNIFIES THAT THIS LINE IS IN ASCIIZED
FORMAT. TO CREATE A FILE LINE IN THE OCTAL FORMAT THE
SECOND CHARACTER IS AN "O" AND THE DATA IS INSERTED IN OCTAL,
THAT IS USING THE OCTAL CHARACTERS 0 THRU 7, THE FILE WHEN
LOADED THEN USES ONLY THE THREE LEAST SIGNIFICANT BITS OF THE
CORESPONDING CHARACTER. ALSO AN OCTAL FILE LINE DOES NOT
INCLUDE THE CHECKSUM SO THAT ONE DOES NOT HAVE TO COMPUTE
THIS WHEN CREATING THE FILE.
ONE SHOULD LIMIT THE LINE LENGTH OF THE OCTAL FILE LINE TO
132 CHARACTERS.
12.0 SPECIFIED FILE EXTENSIONS
THE DECSYTEM 10/20 FILES HAVE THE FOLLOWING SPECIFIED
FILE EXTENSIONS TO DESTINGUISH THE FILE TYPES.
A. .BIN ;PDP-11 BINARY LOAD FILE
B. .A11 ;PDP-11 ASCIIZED LOAD FILE
C. .RAM ;KL10 MICRO CODE LOAD FILE
D. .A10 ;PDP-10 ASCIIZED LOAD FILE
E. .A8 ;PDP-8 ASCIIZED LOAD FILE
F. .ADX ;DX20 ASCIIZED LOAD FILE
G. .KMC ;KMC11 ASCIIZED LOAD FILE
13.0 FILE IDENTIFICATION
ALL FILES (EXCEPT FOR PDP-11 .BIN) HAVE AS THE FIRST LINE
ENTRY IN THE FILE A FILE IDENTIFICATION ENTRY WHICH PROVIDES
INTERNAL FILE IDENTIFICATION INFORMATION.
FORMAT: (ALL BUT .RAM)
;FILE.EXT VER #.# DD-MMM-YY
FORMAT: (.RAM)
;FILE.EXT VER #.# "MICRO-CODE .TITLE INFORMATION"