|
11 | 11 | </head> |
12 | 12 | <body> |
13 | 13 | <div id="header"> |
14 | | - <h1 class="title"><div id="pgname">PICOCOM(1)</div><div id="version">v3.0a / 2017-12-23</div></h1> |
| 14 | + <h1 class="title"><div id="pgname">PICOCOM(1)</div><div id="version">v3.0 / 2017-12-25</div></h1> |
15 | 15 | </div> |
16 | 16 | <h1 id="name">NAME</h1> |
17 | 17 | <p>picocom - minimal dumb-terminal emulation program</p> |
@@ -73,7 +73,7 @@ <h1 id="commands">COMMANDS</h1> |
73 | 73 | <dd><p>Write hex. Picococm prompts the user for a string of hexadecimal values. Values can be entered with or without delimeters (separators). The hexadecimal values are translated to binary and sent to the port, exactly as if input at the terminal (i.e. the <strong>--omap</strong>, <strong>--echo</strong> and <strong>--emap</strong> options are observed). Example: The following sends the characters "ABCD" to the port.</p> |
74 | 74 | <pre><code>C-a C-w |
75 | 75 | *** hex: 41 4243:44 |
76 | | -*** wrote 4 byes ***</code></pre> |
| 76 | +*** wrote 4 bytes ***</code></pre> |
77 | 77 | </dd> |
78 | 78 | <dt><strong>C-s</strong></dt> |
79 | 79 | <dd><p>Send (upload) a file. See <strong><a href="#sending-and-receiving-files">SENDING AND RECEIVING FILES</a></strong> below.</p> |
@@ -125,7 +125,7 @@ <h1 id="options">OPTIONS</h1> |
125 | 125 | </dd> |
126 | 126 | <dt><strong>--noreset</strong> | <strong>-r</strong></dt> |
127 | 127 | <dd><p>If given, picocom will not reset the serial port when exiting. It will just close the respective file descriptor and do nothing more. The serial port settings will <em>not</em> be restored to their original values and, unless the <strong>--hangup</strong> option is also given, the modem-control lines will <em>not</em> be affected. This is useful, for example, for leaving modems connected when exiting picocom. Regardless whether the <strong>--noreset</strong> option is given, the user can exit picocom using the "Quit" command (instead of "Exit"), which makes picocom behave <em>exactly</em> as if <strong>--noreset</strong> was given. See also the <strong>--hangup</strong> option. (Default: Disabled)</p> |
128 | | -<p>NOTICE: Picocom will always set the HUPCL control bit of the serial port, according to the <strong>--noreset</strong> and <strong>--hangup</strong> options. If <strong>--noreset</strong> is given and <strong>--hangup</strong> is not, then HUPCL for the port is cleared and will remain so after exiting picocom. If <strong>--noreset</strong> is <em>not</em> given, or if both <strong>--noreset</strong> and <strong>--hangup</strong> are given, then HUPCL is set for the port and will remain so after exiting picocom. This is true, regardless of the way picocom terminates (command, read zero-bytes from standard input, killed by signal, fatal error, etc), and regardless of the <strong>--noinit</strong> option.</p> |
| 128 | +<p>NOTICE: Picocom clears the modem control lines on exit by setting the <em>HUPCL</em> control bit of the respective port. Picocom always sets HUPCL according to the <strong>--noreset</strong> and <strong>--hangup</strong> options. If <strong>--noreset</strong> is given and <strong>--hangup</strong> is not, then HUPCL for the port is cleared and will remain so after exiting picocom. If <strong>--noreset</strong> is <em>not</em> given, or if both <strong>--noreset</strong> and <strong>--hangup</strong> are given, then HUPCL is set for the port and will remain so after exiting picocom. This is true, regardless of the way picocom terminates (command, read zero-bytes from standard input, killed by signal, fatal error, etc), and regardless of the <strong>--noinit</strong> option.</p> |
129 | 129 | </dd> |
130 | 130 | <dt><strong>--hangup</strong> | <strong>-u</strong></dt> |
131 | 131 | <dd><p>If given together with <strong>--noreset</strong>, picocom will not reset the serial port to it's original settings on exit, but it <em>will</em> clear the modem control lines (typically DTR and RTS) to signal a modem hangup. Without the <strong>--noreset</strong> option (explicitly given, or implied by extiting with the "Quit" command) <strong>--hangup</strong> has no effect (without <strong>--noreset</strong> picocom always clears the modem control lines on exit, anyway).</p> |
@@ -210,7 +210,16 @@ <h1 id="input-output-and-echo-mapping">INPUT, OUTPUT, AND ECHO MAPPING</h1> |
210 | 210 | <li><strong>ignlf</strong> (ignore LF),</li> |
211 | 211 | <li><strong>bsdel</strong> (map BS to DEL),</li> |
212 | 212 | <li><strong>delbs</strong> (map DEL to BS)</li> |
| 213 | +<li><strong>spchex</strong> (map special chars (< 0x20 || 0x7f), excl. CR, LF, and TAB to hex)</li> |
| 214 | +<li><strong>tabhex</strong> (map TAB to hex)</li> |
| 215 | +<li><strong>crhex</strong> (map CR to hex)</li> |
| 216 | +<li><strong>lfhex</strong> (map LF to hex)</li> |
| 217 | +<li><strong>8bithex</strong> (map chars with 8th-bit set to hex)</li> |
| 218 | +<li><strong>nrmhex</strong> (map normal ascii chars (0x20 <= c < 0x7f) to hex)</li> |
213 | 219 | </ul> |
| 220 | +<p>The "to hex" mappings (<strong>???hex</strong>) replace the respective characters with their hexadecimal representation (in square brackets), like this:</p> |
| 221 | +<pre><code>CR --> [0d]</code></pre> |
| 222 | +<p>If more than one mappings are provided that apply to the same character, then only the first mapping, in the order listed above, is applied.</p> |
214 | 223 | <p>For example the command:</p> |
215 | 224 | <pre><code>picocom --omap crlf,delbs --imap ignlf,bsdel --emap crcrlf ...</code></pre> |
216 | 225 | <p>will:</p> |
|
0 commit comments