File: srec_formatted_binary.5

package info (click to toggle)
srecord 1.58-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 5,144 kB
  • sloc: cpp: 26,774; sh: 7,053; makefile: 2,889; awk: 187; vhdl: 15
file content (77 lines) | stat: -rw-r--r-- 2,499 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
'\" t
.\"     srecord - manipulate eprom load files
.\"     Copyright (C) 2003, 2006-2009, 2011 Peter Miller
.\"
.\"     This program is free software; you can redistribute it and/or modify
.\"     it under the terms of the GNU General Public License as published by
.\"     the Free Software Foundation; either version 3 of the License, or
.\"     (at your option) any later version.
.\"
.\"     This program is distributed in the hope that it will be useful,
.\"     but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"     GNU General Public License for more details.
.\"
.\"     You should have received a copy of the GNU General Public License
.\"     along with this program. If not, see
.\"     <http://www.gnu.org/licenses/>.
.\"
.ds n) srec_formatted_binary
.TH \*(n) 5 SRecord "Reference Manual"
.SH NAME
srec_formatted_binary \- Formatted Binary file format
.if require_index \{
.XX "srec_formatted_binary(5)" "Formatted Binary file format"
.\}
.SH DESCRIPTION
.\" ftp://ftp.dataio.com/main/Manuals/UniFam/Translation%20Formats.pdf
This is the PDP\[hy]11 paper tape format, described in the
DEC\[hy]11\[hy]GGPC\[hy]D PDP\[hy]11 "Paper Tape Software Programming
Handbook" 1972.
.PP
The file starts with a character sequence which appears as an arrow when
punched on 8\[hy]hole paper tape.
.RS
0x08, 0x1C, 0x2A, 0x49, 0x08, 0x00
.RE
.PP
Then follows a byte count, encoded big\[hy]endian in the low 4 bits of the
next 4 bytes.  The high bits should be zero.
.PP
Then follows a 0xFF byte.
.PP
The data follows, as many bytes as specified in the header.
.PP
The trailer consists of the following bytes:
.RS
0x00, 0x00,
.RE
and then a 2\[hy]byte checksum (big\[hy]endian).
.PP
The alternate header sequence
.RS
0x08, 0x1C, 0x3E, 0x6B, 0x08, 0x00
.RE
is followed by an 8\[hy]nibble big\[hy]endian byte count.
.SS Size Multiplier
In general, binary data will expand in sized very little
when represented with this format.
.\" ------------------------------------------------------------------------
.br
.ne 2i
.SH EXAMPLE
Here is a hex dump of a formatted binary file containing the
data "Hello, World!".
.RS
.nf
.ft CW
0000: 08 1C 2A 49 08 00 00 00  ..*I....
0008: 00 0E FF 48 65 6C 6C 6F  ...Hello
0010: 2C 20 57 6F 72 6C 64 21  , World!
0018: 0A 00 00 04 73           ....s
.ft P
.fi
.RE
.\" ------------------------------------------------------------------------
.ds n) srec_cat
.so man/man1/z_copyright.so