Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/binex.refentry @ 2187:dc01b8d40ee0
created new dw3.bl bootlist file, renamed mb to mb.floppy and created mb.dw3
| author | boisy |
|---|---|
| date | Wed, 11 Mar 2009 02:07:19 +0000 |
| parents | b00cf13c9f61 |
| children |
| rev | line source |
|---|---|
| 134 | 1 <refentry id="binex"> |
| 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 | 5 </refnamediv> |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 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 | 12 </cmdsynopsis> |
| 13 </refsynopsisdiv> | |
| 14 | |
| 15 <refsect1><title>Description</title> | |
| 16 <para> | |
| 17 S-Record files are a type of text file that contains records that | |
| 18 represent binary data in hexadecimal character form. This | |
| 19 Motorola-standard format is often directly accepted by commercial PROM | |
| 20 programmers, emulators, logic analyzers and similar devices that are | |
| 21 interfaced RS-232 interfaces. It can also be useful for | |
| 22 transmitting files over data links that can only handle character-type | |
| 1500 | 23 data; or to convert NitrOS-9 assembler or compiler-generated |
| 24 programs to load on non-NitrOS-9 systems. | |
| 134 | 25 </para> |
| 26 <para> | |
| 1500 | 27 <command>Binex</command> converts "path1", a NitrOS-9 binary format file, to a new file |
| 134 | 28 named "path2" in S-Record format. If invoked on a non-binary load |
| 29 module file, a warning message is printed and the user is asked if | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1014
diff
changeset
|
30 <command>binex</command> should proceed anyway. A "Y" response means yes; any other |
| 134 | 31 answer will terminate the program. S-Records have a header record |
| 32 to store the program name for informational purposes and each data | |
| 1500 | 33 record has an absolute memory address which is not meaningful to NitrOS-9 |
| 134 | 34 since it uses position-independent-code. However, the S-Record |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1014
diff
changeset
|
35 format requires them so <command>binex</command> will prompt the user for a program |
| 134 | 36 name and starting load address. For example: |
| 37 </para> | |
| 38 <screen> | |
| 39 binex /d0/cmds/scanner scanner.S1 | |
| 40 Enter starting address for file: <emphasis>$100</emphasis> | |
| 41 Enter name for header record: <emphasis>scanner</emphasis> | |
| 42 </screen> | |
| 43 <para> | |
| 44 To download the program to a device such as a PROM programmer | |
| 45 (for example using serial port T1) type: | |
| 46 </para> | |
| 47 <screen> | |
| 48 list scanner.S1 >/T1 | |
| 49 </screen> | |
| 50 </refsect1> | |
| 51 </refentry> | |
| 52 |