annotate docs/nitros9guide/acia51.appendix @ 3140:03b580a02945

Allow CoCo3FPGA-specific build of superdesc.asm Added new conditional CC3FPGA and code to "level1/modules/superdesc.asm" to reflect changes needed to build the new SD card descriptors for the Coco3FPGA.
author Bill Pierce <merlinious999@gmail.com>
date Sat, 04 Feb 2017 11:06:26 +0100
parents cc153d1671f7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
142
4cd37950c605 More splitups.
roug
parents:
diff changeset
1 <appendix>
4cd37950c605 More splitups.
roug
parents:
diff changeset
2 <title>Using the Serial Interface</title>
4cd37950c605 More splitups.
roug
parents:
diff changeset
3 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
4 For those who wish to use the serial port, the input or
4cd37950c605 More splitups.
roug
parents:
diff changeset
5 output path of a program may be redirected to the serial port of
1011
cc153d1671f7 Updated for new manuals
boisy
parents: 148
diff changeset
6 your &make;.
142
4cd37950c605 More splitups.
roug
parents:
diff changeset
7 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
8 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
9 This is done by including the following module in the OS-9 kernel:
4cd37950c605 More splitups.
roug
parents:
diff changeset
10 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
11 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
12 ACIA51 - Serial Device Driver
4cd37950c605 More splitups.
roug
parents:
diff changeset
13 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
14 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
15 To load this module into the kernel enter the following command line:
4cd37950c605 More splitups.
roug
parents:
diff changeset
16 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
17 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
18 LOAD /D0/CMDS/ACIA51
4cd37950c605 More splitups.
roug
parents:
diff changeset
19 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
20
4cd37950c605 More splitups.
roug
parents:
diff changeset
21 <section>
4cd37950c605 More splitups.
roug
parents:
diff changeset
22 <title>Serial Printer Implementation</title>
4cd37950c605 More splitups.
roug
parents:
diff changeset
23 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
24 For those with a serial printer, you can use the serial port
4cd37950c605 More splitups.
roug
parents:
diff changeset
25 in the redirection of a program's output path by including the
4cd37950c605 More splitups.
roug
parents:
diff changeset
26 following modifier at the end of a command line:
4cd37950c605 More splitups.
roug
parents:
diff changeset
27 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
28 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
29 &gt;/P1
4cd37950c605 More splitups.
roug
parents:
diff changeset
30 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
31 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
32 The baud rate of the serial port may be changed as follows:
4cd37950c605 More splitups.
roug
parents:
diff changeset
33 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
34 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
35 XMODE /P1 BAUD=3
4cd37950c605 More splitups.
roug
parents:
diff changeset
36 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
37 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
38 This will change the baud rate to 1200 characters per second.
4cd37950c605 More splitups.
roug
parents:
diff changeset
39 For a detailed description of the baud rate see the XMODE
4cd37950c605 More splitups.
roug
parents:
diff changeset
40 command description.
4cd37950c605 More splitups.
roug
parents:
diff changeset
41 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
42 </section>
4cd37950c605 More splitups.
roug
parents:
diff changeset
43 <section>
4cd37950c605 More splitups.
roug
parents:
diff changeset
44 <title>Serial Terminal Implementation</title>
4cd37950c605 More splitups.
roug
parents:
diff changeset
45 <para>
1011
cc153d1671f7 Updated for new manuals
boisy
parents: 148
diff changeset
46 For those who wish to connect two &make;s, running
142
4cd37950c605 More splitups.
roug
parents:
diff changeset
47 OS-9, together using the serial port, redirection of the input
4cd37950c605 More splitups.
roug
parents:
diff changeset
48 or output paths is possible using the following modifier at
4cd37950c605 More splitups.
roug
parents:
diff changeset
49 the end of a command line:
4cd37950c605 More splitups.
roug
parents:
diff changeset
50 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
51 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
52 &gt;/T1 - for an output path
4cd37950c605 More splitups.
roug
parents:
diff changeset
53 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
54 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
55 &lt;/T1 - for an input path
4cd37950c605 More splitups.
roug
parents:
diff changeset
56 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
57 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
58 To pass a file of data between the two computers, one must be
4cd37950c605 More splitups.
roug
parents:
diff changeset
59 configured for input from the serial port and the other
4cd37950c605 More splitups.
roug
parents:
diff changeset
60 configured for output:
4cd37950c605 More splitups.
roug
parents:
diff changeset
61 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
62 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
63 Computer 1, BUILD TEXT &lt;/T1 - input to port
4cd37950c605 More splitups.
roug
parents:
diff changeset
64 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
65 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
66 Computer 2, BUILD &lt;TEXT /T1 - output to port
4cd37950c605 More splitups.
roug
parents:
diff changeset
67 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
68 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
69 Using the above example, the text file on computer 2 will be
4cd37950c605 More splitups.
roug
parents:
diff changeset
70 transferred to a file called TEXT on computer 1.
4cd37950c605 More splitups.
roug
parents:
diff changeset
71 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
72 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
73 When the command line is entered on computer 1, the system will
4cd37950c605 More splitups.
roug
parents:
diff changeset
74 reply with a question mark and wait for information from the
4cd37950c605 More splitups.
roug
parents:
diff changeset
75 serial port. The command line on computer 2 will send data to
4cd37950c605 More splitups.
roug
parents:
diff changeset
76 the now waiting computer 1. A string of question marks will now
4cd37950c605 More splitups.
roug
parents:
diff changeset
77 be seen, this is the number of lines sent and recieved by the
4cd37950c605 More splitups.
roug
parents:
diff changeset
78 respective computers.
4cd37950c605 More splitups.
roug
parents:
diff changeset
79 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
80 <para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
81 To create a log-off sequence after such a transfer, use the DISPLAY
4cd37950c605 More splitups.
roug
parents:
diff changeset
82 command as follows:
4cd37950c605 More splitups.
roug
parents:
diff changeset
83 </para>
4cd37950c605 More splitups.
roug
parents:
diff changeset
84 <literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
85 Computer 1, BUILD &lt;TEXT /T1 ; DISPLAY 0A 0D &gt;/T1
4cd37950c605 More splitups.
roug
parents:
diff changeset
86 </literallayout>
4cd37950c605 More splitups.
roug
parents:
diff changeset
87 </section>
4cd37950c605 More splitups.
roug
parents:
diff changeset
88 </appendix>