Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/exbin.refentry @ 2772:0a3f4d8ea6d5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Found ENDC in wrong location in dwread.asm and dwwrite.asm. Corrected. Moved the native 6309 code in dwread.asm and dwwrite.asm into the H6309 labeled area and changed IFEQ H6309 to IFNE H6309. Also moved the 57600bps 6809 code to the default location. This change had been done in the old dwread.asm and dwwrite.asm files to make it easier to follow. Though these two files were overwritten from the HDBDOS project dwread.asm and dwwrite.asm files. So this conversion needed to be done again so it made the source easier to follow.
author drencor-xeen
date Wed, 23 Jan 2013 12:36:55 -0600
parents b00cf13c9f61
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1014
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
1 <refentry id="exbin">
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
2 <refnamediv>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
3 <refname id="exbinname">EXBIN</refname>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
4 <refpurpose>Convert S-Record To Binary File</refpurpose>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
5 </refnamediv>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
6
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
7 <refsynopsisdiv>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>exbin</command>
1014
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
10 <arg choice="plain"><replaceable>path2</replaceable></arg>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
11 <arg choice="plain"><replaceable>path1</replaceable></arg>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
12 </cmdsynopsis>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
13 </refsynopsisdiv>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
14
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
15 <refsect1><title>Description</title>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
16 <para>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
17 S-Record files are a type of text file that contains records that
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
18 represent binary data in hexadecimal character form. This
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
19 Motorola-standard format is often directly accepted by commercial PROM
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
20 programmers, emulators, logic analyzers and similar devices that are
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
21 interfaced RS-232 interfaces. It can also be useful for
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
22 transmitting files over data links that can only handle character-type
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
23 data; or to convert NitrOS-9 assembler or compiler-generated
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
24 programs to load on non-NitrOS-9 systems.
1014
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
25 </para>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
26 <para>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
27 &quot;Path1&quot; is assumed to be an
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 1014
diff changeset
28 S-Record format text file which <command>exbin</command> converts to pure binary form on
1014
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
29 a new file called &quot;path2&quot;. The load addresses of each data record
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
30 must describe continguous data in ascending order.
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
31 </para>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
32 <para>
1500
b00cf13c9f61 Major changes for new NitrOS-9 manual
boisy
parents: 1093
diff changeset
33 <command>Exbin</command> does not generate or check for the proper NitrOS-9 module
1014
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
34 headers or CRC check value required to actually load the binary
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
35 file. The IDENT or VERIFY commands can be used to check the
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
36 validity of the modules if they are to be loaded or run.
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
37 Example:
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
38 </para>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
39 <screen>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
40 exbin program.S1 cmds/program
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
41 </screen>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
42 </refsect1>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
43 </refentry>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents:
diff changeset
44