Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/binex.refentry @ 1014:d9ed9d44b70c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Some character entities had missing semicolons. It's &CPU; The os9l1guide and os9l2guide are now much more modular simply because the sections that are not to be included in one of them is defined as the empty string in the <!ENTITY declaration Split exbin and binex pages so the occur at the right place in the manual. Got the content for wcreate from the Internet.
author roug
date Tue, 04 Mar 2003 20:05:50 +0000
parents c565a4700689
children b5ff125a1d60
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="binex">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
1014
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents: 975
diff changeset
3 <refname id="binexname">BINEX</refname>
d9ed9d44b70c Some character entities had missing semicolons. It's &CPU;
roug
parents: 975
diff changeset
4 <refpurpose>Convert Binary To S-Record File</refpurpose>
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
6
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
9 <command>BINEX</command>
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 134
diff changeset
10 <arg choice="plain"><replaceable>path1</replaceable></arg>
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 134
diff changeset
11 <arg choice="plain"><replaceable>path2</replaceable></arg>
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
12 </cmdsynopsis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
13 </refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
14
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
15 <refsect1><title>Description</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
16 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
17 S-Record files are a type of text file that contains records that
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
18 represent binary data in hexadecimal character form. This
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
19 Motorola-standard format is often directly accepted by commercial PROM
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
20 programmers, emulators, logic analyzers and similar devices that are
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
21 interfaced RS-232 interfaces. It can also be useful for
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
22 transmitting files over data links that can only handle character-type
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
23 data; or to convert OS-9 assembler or compiler-generated
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
24 programs to load on non-OS-9 systems.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
25 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
26 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
27 BINEX converts &quot;path1&quot;, an OS-9 binary format file, to a new file
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
28 named &quot;path2&quot; in S-Record format. If invoked on a non-binary load
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
29 module file, a warning message is printed and the user is asked if
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
30 BINEX should proceed anyway. A &quot;Y&quot; response means yes; any other
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
31 answer will terminate the program. S-Records have a header record
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
32 to store the program name for informational purposes and each data
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
33 record has an absolute memory address which is not meaningful to OS-9
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
34 since it uses position-independent-code. However, the S-Record
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
35 format requires them so BINEX will prompt the user for a program
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
36 name and starting load address. For example:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
37 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
38 <screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
39 binex /d0/cmds/scanner scanner.S1
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
40 Enter starting address for file: <emphasis>$100</emphasis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
41 Enter name for header record: <emphasis>scanner</emphasis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
42 </screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
43 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
44 To download the program to a device such as a PROM programmer
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
45 (for example using serial port T1) type:
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
46 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
47 <screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
48 list scanner.S1 &gt;/T1
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
49 </screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
50 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
51 </refentry>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
52