Mercurial > hg > Members > kono > nitros9-code
annotate docs/nitros9guide/exmode.refentry @ 3116:174eb9eda7b1
New port "mc09" for Multicomp09, an FPGA-based 6809 machine
Include new commands/descriptor for mc09 clock and SD controller
| author | Neal Crook <foofoobedoo@gmail.com> |
|---|---|
| date | Sat, 17 Oct 2015 21:21:11 +0100 |
| parents | 4dae346c4969 |
| children |
| rev | line source |
|---|---|
| 1012 | 1 <refentry id="exmode"> |
| 2 <refnamediv> | |
| 3 <refname>EXMODE</refname> | |
| 4 <refpurpose>Examine or Change Device Initialization Mode</refpurpose> | |
| 5 </refnamediv> | |
| 6 | |
| 7 <refsynopsisdiv> | |
| 8 <cmdsynopsis> | |
| 1093 | 9 <command>exmode</command> |
| 1012 | 10 <arg choice="plain"><replaceable>devname</replaceable></arg> |
| 11 <arg choice="opt"><replaceable>arglist</replaceable></arg> | |
| 12 </cmdsynopsis> | |
| 13 </refsynopsisdiv> | |
| 14 | |
| 15 <refsect1><title>Description</title> | |
| 16 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
17 <command>exmode</command> is an enhanced verison of the <command>xmode</command> utility, and is useful for |
| 1013 | 18 changing initialization parameters specific to CoCo 3 window descriptors |
| 19 and enhanced ACIA device descriptors. | |
| 1012 | 20 </para> |
| 21 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
22 <command>Exmode</command> is very similar to the <command>tmode</command> command. |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
23 <command>Tmode</command> only operates on |
|
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
24 open paths so its effect is temporary. <command>Exmode</command> actually updates the |
| 1012 | 25 device descriptor so the change persists as long as the computer is |
| 26 running, even if paths to the device are repetitively opened and | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
27 closed. If <command>exmode</command> is used to change parameter(s) and the COBBLER |
| 1012 | 28 program is used to make a new system disk, the changed parameter |
| 29 will be permanently reflected on the new system disk. | |
| 30 </para> | |
| 31 <para> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
32 <command>Exmode</command> requires a device name to be given. If no arguments are |
| 1012 | 33 given, the present values for each parameter are displayed, |
| 34 otherwise, the parameter(s) given in the argument list are | |
| 35 processed. Any number of parameters can be given, and are separated | |
| 36 by spaces or commas. | |
| 37 </para> | |
| 38 | |
| 39 </refsect1> | |
|
1053
b5ff125a1d60
Since this book was only typeset in fixed width, single-font, they used
roug
parents:
1013
diff
changeset
|
40 <refsect1><title><command>Exmode</command> Parameter Names</title> |
| 1012 | 41 |
| 42 <informaltable frame="none"> | |
| 43 <tgroup cols="2"> | |
| 44 <colspec colwidth="1in"/> | |
| 45 <colspec colwidth="4in"/> | |
| 46 <tbody> | |
| 47 <row> | |
| 48 <entry>upc</entry> | |
| 49 <entry>Upper case only. Lower case characters are automatically | |
| 50 converted to upper case.</entry> | |
| 51 </row> | |
| 52 <row> | |
| 53 <entry>-upc</entry> | |
| 54 <entry>Upper case and lower case characters permitted (default).</entry> | |
| 55 </row> | |
| 56 <row> | |
| 57 <entry>bsb</entry> | |
| 58 <entry>Erase on backspace: backspace characters echoed as a | |
| 59 backspace-space-backspace sequence (default).</entry> | |
| 60 </row> | |
| 61 <row> | |
| 62 <entry>-bsb</entry> | |
| 63 <entry>no erase on backspace: echoes single backspace only</entry> | |
| 64 </row> | |
| 65 <row> | |
| 66 <entry>bsl</entry> | |
| 67 <entry>Backspace over line: lines are "deleted" by sending | |
| 68 backspace-space-backspace sequences to erase the same | |
| 69 line (for video terminals) (default).</entry> | |
| 70 </row> | |
| 71 <row> | |
| 72 <entry>-bsl</entry> | |
| 73 <entry>No backspace over line: lines are "deleted" by printing | |
| 74 a new line sequence (for hard-copy terminals). | |
| 75 echo Input characters "echoed" back to terminal (default)</entry> | |
| 76 </row> | |
| 77 <row> | |
| 78 <entry>-echo</entry> | |
| 79 <entry>No echo</entry> | |
| 80 </row> | |
| 81 <row> | |
| 82 <entry>lf</entry> | |
| 83 <entry>Auto line feed on: line feeds automatically echoed to | |
| 84 terminal on input and output carriage returns (default).</entry> | |
| 85 </row> | |
| 86 <row> | |
| 87 <entry>-lf</entry> | |
| 88 <entry>Auto line feed off.</entry> | |
| 89 </row> | |
| 90 <row> | |
| 91 <entry>pause</entry> | |
| 92 <entry>Screen pause on: output suspended upon full screen. See | |
| 93 "pag" parameter for definition of screen size. Output | |
| 94 can be resumed by typing any key.</entry> | |
| 95 </row> | |
| 96 <row> | |
| 97 <entry>-pause</entry> | |
| 98 <entry>Screen pause mode off.</entry> | |
| 99 </row> | |
| 100 <row> | |
| 101 <entry>null=n</entry> | |
| 102 <entry>Set null count: number of null ($00) characters | |
| 103 transmitted after carriage returns for return delay. | |
| 104 The number is decimal, default = 0.</entry> | |
| 105 </row> | |
| 106 <row> | |
| 107 <entry>pag=n</entry> | |
| 108 <entry>Set video display page length to n (decimal) lines. | |
| 109 Used for "pause" mode, see above.</entry> | |
| 110 </row> | |
| 111 <row> | |
| 112 <entry>bsp=h</entry> | |
| 113 <entry>Set input backspace character. Numeric value of | |
| 114 character in hexadecimal. Default = 08.</entry> | |
| 115 </row> | |
| 116 <row> | |
| 117 <entry>bse=h</entry> | |
| 118 <entry>Set output backspace character. Numeric value of | |
| 119 character in hexadecimal. Default = 08.</entry> | |
| 120 </row> | |
| 121 <row> | |
| 122 <entry>del=h</entry> | |
| 123 <entry>Set input delete line character. Numeric value of | |
| 124 character in hexadecimal. Default = 18.</entry> | |
| 125 </row> | |
| 126 <row> | |
| 127 <entry>bell=h</entry> | |
| 128 <entry>Set bell (alert) output character. Numeric value of | |
| 129 character in hexadecimal. Default = 07</entry> | |
| 130 </row> | |
| 131 <row> | |
| 132 <entry>eor=h</entry> | |
| 133 <entry>Set end-of-record (carriage return) input character. | |
| 134 Numeric value of character in hexadecimal. Default = 0D</entry> | |
| 135 </row> | |
| 136 <row> | |
| 137 <entry>eof=h</entry> | |
| 138 <entry>Set end-of-file input character. Numeric value of | |
| 139 character in hexadecimal. Default 1B.</entry> | |
| 140 </row> | |
| 141 <row> | |
| 142 <entry>type=h</entry> | |
| 143 <entry>ACIA initialization value: sets parity, word size, etc. | |
| 144 Value in hexadecimal. Default 15</entry> | |
| 145 </row> | |
| 146 <row> | |
| 147 <entry>reprint=h</entry> | |
| 148 <entry>Reprint line character. Numeric value of character | |
| 149 in hexadecimal.</entry> | |
| 150 </row> | |
| 151 <row> | |
| 152 <entry>dup=h</entry> | |
| 153 <entry>Duplicate last input line character. Numeric value of | |
| 154 character in hexadecimal.</entry> | |
| 155 </row> | |
| 156 <row> | |
| 157 <entry>psc=h</entry> | |
| 158 <entry>Pause character. Numeric value of character in | |
| 159 hexadecimal.</entry> | |
| 160 </row> | |
| 161 <row> | |
| 162 <entry>abort=h</entry> | |
| 1092 | 163 <entry>Abort character (normally <keycombo action="simul"><keycap>Control</keycap> |
| 164 <keycap>C</keycap></keycombo>). Numeric value | |
| 1012 | 165 of character in hexadecimal.</entry> |
| 166 </row> | |
| 167 <row> | |
| 168 <entry>quit=h</entry> | |
| 1092 | 169 <entry>Quit character (normally <keycombo action="simul"><keycap>Control</keycap> |
| 170 <keycap>E</keycap></keycombo>). Numeric value | |
| 1012 | 171 of character in hexadecimal.</entry> |
| 172 </row> | |
| 173 <row> | |
| 174 <entry>baud=d</entry> | |
| 175 <entry>Set baud rate for software-controllable interface. Numeric | |
| 176 code for baud rate: 0=110 1=300 2=600 3=1200 4=2400 5=4800 | |
| 177 6=9600 7=19200</entry> | |
| 178 </row> | |
| 179 </tbody> | |
| 180 </tgroup> | |
| 181 </informaltable> | |
| 182 </refsect1> | |
| 183 <refsect1><title>Examples</title> | |
| 184 <screen> | |
| 185 exmode /TERM -upc lf null=4 bse=1F pause | |
| 186 | |
| 187 exmode /T1 pag=24 pause bsl -echo bsp=8 bsl=C | |
| 188 | |
| 189 exmode /P baud=3 -if | |
| 190 </screen> | |
| 191 </refsect1> | |
| 192 </refentry> |