Artifact 8d0be3534726d0d85b2dc98bff49fce0b91f9ee3:
Wiki page
[
usbserial command] by
chw
2019-04-26 06:31:55.
0000: 44 20 32 30 31 39 2d 30 34 2d 32 36 54 30 36 3a D 2019-04-26T06:
0010: 33 31 3a 35 35 2e 39 30 31 0a 4c 20 75 73 62 73 31:55.901.L usbs
0020: 65 72 69 61 6c 5c 73 63 6f 6d 6d 61 6e 64 0a 50 erial\scommand.P
0030: 20 37 63 65 37 35 65 62 65 38 32 62 36 36 30 63 7ce75ebe82b660c
0040: 39 31 66 31 34 37 39 35 38 30 65 62 35 36 35 62 91f1479580eb565b
0050: 35 37 37 61 30 61 39 37 61 0a 55 20 63 68 77 0a 577a0a97a.U chw.
0060: 57 20 32 38 38 37 0a 3c 68 32 3e 75 73 62 73 65 W 2887.<h2>usbse
0070: 72 69 61 6c 20 63 6f 6d 6d 61 6e 64 3c 2f 68 32 rial command</h2
0080: 3e 0d 0a 0d 0a 3c 68 33 3e 4e 61 6d 65 3c 2f 68 >....<h3>Name</h
0090: 33 3e 0d 0a 0d 0a 3c 62 3e 75 73 62 73 65 72 69 3>....<b>usbseri
00a0: 61 6c 3c 2f 62 3e 20 2d 20 74 72 61 6e 73 66 65 al</b> - transfe
00b0: 72 20 64 61 74 61 20 6f 76 65 72 20 55 53 42 2d r data over USB-
00c0: 73 65 72 69 61 6c 20 63 6f 6e 76 65 72 74 65 72 serial converter
00d0: 73 0d 0a 0d 0a 3c 68 33 3e 53 79 6e 6f 70 73 69 s....<h3>Synopsi
00e0: 73 3c 2f 68 33 3e 0d 0a 0d 0a 3c 74 74 3e 70 61 s</h3>....<tt>pa
00f0: 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 55 73 ckage require Us
0100: 62 73 65 72 69 61 6c 3c 2f 74 74 3e 3c 62 72 3e bserial</tt><br>
0110: 0d 0a 3c 74 74 3e 75 73 62 73 65 72 69 61 6c 20 ..<tt>usbserial
0120: 3c 69 3e 3f 64 65 76 69 63 65 6e 61 6d 65 3f 3c <i>?devicename?<
0130: 2f 69 3e 3c 2f 74 74 3e 0d 0a 0d 0a 3c 68 33 3e /i></tt>....<h3>
0140: 44 65 73 63 72 69 70 74 69 6f 6e 3c 2f 68 33 3e Description</h3>
0150: 0d 0a 0d 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64 ....This command
0160: 20 69 73 20 75 73 65 64 20 74 6f 20 74 72 61 6e is used to tran
0170: 73 66 65 72 20 64 61 74 61 20 6f 76 65 72 20 73 sfer data over s
0180: 75 70 70 6f 72 74 65 64 20 55 53 42 2d 73 65 72 upported USB-ser
0190: 69 61 6c 20 63 6f 6e 76 65 72 74 65 72 73 20 28 ial converters (
01a0: 46 54 44 49 2c 20 43 44 43 2c 20 50 72 6f 6c 69 FTDI, CDC, Proli
01b0: 66 69 63 2c 20 65 74 63 2e 29 2c 20 73 65 65 20 fic, etc.), see
01c0: 74 68 69 73 20 3c 61 20 68 72 65 66 3d 22 68 74 this <a href="ht
01d0: 74 70 3a 2f 2f 63 6f 64 65 2e 67 6f 6f 67 6c 65 tp://code.google
01e0: 2e 63 6f 6d 2f 70 2f 75 73 62 2d 73 65 72 69 61 .com/p/usb-seria
01f0: 6c 2d 66 6f 72 2d 61 6e 64 72 6f 69 64 2f 22 3e l-for-android/">
0200: 72 65 66 65 72 65 6e 63 65 3c 2f 61 3e 2e 20 57 reference</a>. W
0210: 68 65 6e 20 6e 6f 20 66 75 72 74 68 65 72 20 61 hen no further a
0220: 72 67 75 6d 65 6e 74 20 69 73 20 67 69 76 65 6e rgument is given
0230: 20 74 6f 20 74 68 65 20 3c 74 74 3e 75 73 62 73 to the <tt>usbs
0240: 65 72 69 61 6c 3c 2f 74 74 3e 20 63 6f 6d 6d 61 erial</tt> comma
0250: 6e 64 2c 20 61 20 6c 69 73 74 20 6f 66 20 73 75 nd, a list of su
0260: 70 70 6f 72 74 65 64 20 55 53 42 20 64 65 76 69 pported USB devi
0270: 63 65 20 6e 61 6d 65 73 20 69 6e 20 74 68 65 20 ce names in the
0280: 66 6f 72 6d 20 6f 66 20 7a 65 72 6f 20 6f 72 20 form of zero or
0290: 6d 6f 72 65 20 3c 74 74 3e 2f 64 65 76 2f 62 75 more <tt>/dev/bu
02a0: 73 2f 75 73 62 2f 4d 4d 4d 2f 4e 4e 4e 3c 2f 74 s/usb/MMM/NNN</t
02b0: 74 3e 20 64 65 76 69 63 65 20 73 70 65 63 69 61 t> device specia
02c0: 6c 20 66 69 6c 65 20 6e 61 6d 65 73 20 69 73 20 l file names is
02d0: 72 65 74 75 72 6e 65 64 2e 20 57 68 65 6e 20 74 returned. When t
02e0: 68 65 20 55 53 42 20 64 65 76 69 63 65 20 6e 61 he USB device na
02f0: 6d 65 20 6f 66 20 61 20 73 75 70 70 6f 72 74 65 me of a supporte
0300: 64 20 55 53 42 2d 73 65 72 69 61 6c 20 63 6f 6e d USB-serial con
0310: 76 65 72 74 65 72 20 69 73 20 67 69 76 65 6e 20 verter is given
0320: 61 73 20 61 72 67 75 6d 65 6e 74 2c 20 3c 74 74 as argument, <tt
0330: 3e 75 73 62 73 65 72 69 61 6c 3c 2f 74 74 3e 20 >usbserial</tt>
0340: 6f 70 65 6e 73 20 74 68 61 74 20 55 53 42 20 64 opens that USB d
0350: 65 76 69 63 65 20 61 6e 64 20 72 65 74 75 72 6e evice and return
0360: 73 20 61 20 54 63 6c 20 63 68 61 6e 6e 65 6c 20 s a Tcl channel
0370: 68 61 6e 64 6c 65 20 66 6f 72 20 69 74 2e 20 54 handle for it. T
0380: 68 69 73 20 68 61 6e 64 6c 65 20 6d 61 79 20 62 his handle may b
0390: 65 20 75 73 65 64 20 77 69 74 68 20 3c 74 74 3e e used with <tt>
03a0: 66 63 6f 6e 66 69 67 75 72 65 3c 2f 74 74 3e 2c fconfigure</tt>,
03b0: 20 3c 74 74 3e 67 65 74 73 3c 2f 74 74 3e 2c 20 <tt>gets</tt>,
03c0: 3c 74 74 3e 72 65 61 64 3c 2f 74 74 3e 2c 20 3c <tt>read</tt>, <
03d0: 74 74 3e 70 75 74 73 3c 2f 74 74 3e 2c 20 61 6e tt>puts</tt>, an
03e0: 64 20 3c 74 74 3e 63 6c 6f 73 65 3c 2f 74 74 3e d <tt>close</tt>
03f0: 2e 20 54 68 65 20 6f 70 74 69 6f 6e 73 20 3c 74 . The options <t
0400: 74 3e 2d 6d 6f 64 65 3c 2f 74 74 3e 2c 20 3c 74 t>-mode</tt>, <t
0410: 74 3e 2d 74 74 79 63 6f 6e 74 72 6f 6c 3c 2f 74 t>-ttycontrol</t
0420: 74 3e 2c 20 61 6e 64 20 3c 74 74 3e 2d 74 74 79 t>, and <tt>-tty
0430: 73 74 61 74 75 73 3c 2f 74 74 3e 20 74 6f 20 3c status</tt> to <
0440: 74 74 3e 66 63 6f 6e 66 69 67 75 72 65 3c 2f 74 tt>fconfigure</t
0450: 74 3e 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 t> are supported
0460: 20 62 79 20 74 68 65 20 63 68 61 6e 6e 65 6c 2e by the channel.
0470: 20 48 6f 77 65 76 65 72 2c 20 73 75 70 70 6f 72 However, suppor
0480: 74 20 66 6f 72 20 67 65 74 74 69 6e 67 20 61 6e t for getting an
0490: 64 2f 6f 72 20 73 65 74 74 69 6e 67 20 63 6f 6e d/or setting con
04a0: 74 72 6f 6c 20 6c 69 6e 65 73 20 76 61 72 69 65 trol lines varie
04b0: 73 20 62 65 74 77 65 65 6e 20 64 69 66 66 65 72 s between differ
04c0: 65 6e 74 20 55 53 42 2d 73 65 72 69 61 6c 20 63 ent USB-serial c
04d0: 6f 6e 76 65 72 74 65 72 20 63 68 69 70 73 2e 20 onverter chips.
04e0: 4e 6f 74 65 2c 20 74 68 61 74 20 73 69 6d 69 6c Note, that simil
04f0: 61 72 20 74 6f 20 61 20 6e 6f 72 6d 61 6c 20 50 ar to a normal P
0500: 4f 53 49 58 20 74 74 79 20 64 65 76 69 63 65 20 OSIX tty device
0510: 61 6e 20 55 53 42 20 64 65 76 69 63 65 20 6e 61 an USB device na
0520: 6d 65 20 63 61 6e 20 62 65 20 6f 70 65 6e 65 64 me can be opened
0530: 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63 65 20 more than once
0540: 73 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 2e 0d simultaneously..
0550: 0a 0d 0a 3c 68 33 3e 4c 69 73 74 20 6f 66 20 73 ...<h3>List of s
0560: 75 70 70 6f 72 74 65 64 20 64 65 76 69 63 65 73 upported devices
0570: 3c 2f 68 33 3e 0d 0a 3c 6e 6f 77 69 6b 69 3e 0d </h3>..<nowiki>.
0580: 0a 3c 74 61 62 6c 65 3e 0d 0a 3c 74 68 3e 0d 0a .<table>..<th>..
0590: 20 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 3c 62 3e <tr>.. <td><b>
05a0: 56 65 6e 64 6f 72 3c 62 72 3e 49 44 3c 2f 62 3e Vendor<br>ID</b>
05b0: 3c 2f 74 64 3e 0d 0a 20 20 3c 74 64 3e 3c 62 3e </td>.. <td><b>
05c0: 50 72 6f 64 75 63 74 3c 62 72 3e 49 44 3c 2f 62 Product<br>ID</b
05d0: 3e 3c 2f 74 64 3e 0d 0a 20 20 3c 74 64 3e 3c 62 ></td>.. <td><b
05e0: 3e 52 65 6d 61 72 6b 73 3c 62 72 3e 26 6e 62 73 >Remarks<br>&nbs
05f0: 70 3b 3c 2f 62 3e 3c 2f 74 64 3e 0d 0a 20 3c 2f p;</b></td>.. </
0600: 74 72 3e 0d 0a 20 3c 74 72 3e 0d 0a 20 20 3c 74 tr>.. <tr>.. <t
0610: 64 3e 30 78 31 30 63 34 3c 2f 74 64 3e 3c 74 64 d>0x10c4</td><td
0620: 3e 30 78 65 61 36 30 3c 2f 74 64 3e 3c 74 64 3e >0xea60</td><td>
0630: 43 50 32 31 30 32 3c 2f 74 64 3e 0d 0a 20 3c 2f CP2102</td>.. </
0640: 74 72 3e 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 30 tr><tr>.. <td>0
0650: 78 31 30 63 34 3c 2f 74 64 3e 3c 74 64 3e 30 78 x10c4</td><td>0x
0660: 65 61 37 30 3c 2f 74 64 3e 3c 74 64 3e 43 50 32 ea70</td><td>CP2
0670: 31 30 35 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e 105</td>.. </tr>
0680: 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 30 78 31 30 <tr>.. <td>0x10
0690: 63 34 3c 2f 74 64 3e 3c 74 64 3e 30 78 65 61 37 c4</td><td>0xea7
06a0: 31 3c 2f 74 64 3e 3c 74 64 3e 43 50 32 31 30 38 1</td><td>CP2108
06b0: 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 72 </td>.. </tr><tr
06c0: 3e 0d 0a 20 20 3c 74 64 3e 30 78 31 30 63 34 3c >.. <td>0x10c4<
06d0: 2f 74 64 3e 3c 74 64 3e 30 78 65 61 38 30 3c 2f /td><td>0xea80</
06e0: 74 64 3e 3c 74 64 3e 43 50 32 31 31 30 3c 2f 74 td><td>CP2110</t
06f0: 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 72 3e 0d 0a d>.. </tr><tr>..
0700: 20 20 3c 74 64 3e 30 78 30 36 37 62 3c 2f 74 64 <td>0x067b</td
0710: 3e 3c 74 64 3e 30 78 32 33 30 33 3c 2f 74 64 3e ><td>0x2303</td>
0720: 3c 74 64 3e 50 72 6f 6c 69 66 69 63 20 50 4c 32 <td>Prolific PL2
0730: 33 30 33 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e 303</td>.. </tr>
0740: 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 30 78 30 34 <tr>.. <td>0x04
0750: 30 33 3c 2f 74 64 3e 3c 74 64 3e 30 78 30 36 30 03</td><td>0x060
0760: 31 3c 2f 74 64 3e 3c 74 64 3e 46 54 44 49 20 46 1</td><td>FTDI F
0770: 54 32 33 32 52 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 T232R</td>.. </t
0780: 72 3e 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 30 78 r><tr>.. <td>0x
0790: 30 34 30 33 3c 2f 74 64 3e 3c 74 64 3e 30 78 36 0403</td><td>0x6
07a0: 30 31 35 3c 2f 74 64 3e 3c 74 64 3e 46 54 44 49 015</td><td>FTDI
07b0: 20 46 54 32 33 31 58 3c 2f 74 64 3e 0d 0a 20 3c FT231X</td>.. <
07c0: 2f 74 72 3e 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e /tr><tr>.. <td>
07d0: 30 78 32 33 34 31 3c 2f 74 64 3e 3c 74 64 3e 30 0x2341</td><td>0
07e0: 78 30 30 30 31 3c 2f 74 64 3e 3c 74 64 3e 41 72 x0001</td><td>Ar
07f0: 64 75 69 6e 6f 20 55 4e 4f 3c 2f 74 64 3e 0d 0a duino UNO</td>..
0800: 20 3c 2f 74 72 3e 3c 74 72 3e 0d 0a 20 20 3c 74 </tr><tr>.. <t
0810: 64 3e 30 78 32 33 34 31 3c 2f 74 64 3e 3c 74 64 d>0x2341</td><td
0820: 3e 30 78 30 30 31 30 3c 2f 74 64 3e 3c 74 64 3e >0x0010</td><td>
0830: 41 72 64 75 69 6e 6f 20 4d 65 67 61 20 32 35 36 Arduino Mega 256
0840: 30 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 0</td>.. </tr><t
0850: 72 3e 0d 0a 20 20 3c 74 64 3e 30 78 32 33 34 31 r>.. <td>0x2341
0860: 3c 2f 74 64 3e 3c 74 64 3e 30 78 30 30 33 62 3c </td><td>0x003b<
0870: 2f 74 64 3e 3c 74 64 3e 41 72 64 75 69 6e 6f 20 /td><td>Arduino
0880: 53 65 72 69 61 6c 20 41 64 61 70 74 65 72 3c 2f Serial Adapter</
0890: 74 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 72 3e 0d td>.. </tr><tr>.
08a0: 0a 20 20 3c 74 64 3e 30 78 32 33 34 31 3c 2f 74 . <td>0x2341</t
08b0: 64 3e 3c 74 64 3e 30 78 30 30 33 66 3c 2f 74 64 d><td>0x003f</td
08c0: 3e 3c 74 64 3e 41 72 64 75 69 6e 6f 20 4d 65 67 ><td>Arduino Meg
08d0: 61 20 41 44 4b 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 a ADK</td>.. </t
08e0: 72 3e 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 30 78 r><tr>.. <td>0x
08f0: 32 33 34 31 3c 2f 74 64 3e 3c 74 64 3e 30 78 30 2341</td><td>0x0
0900: 30 34 32 3c 2f 74 64 3e 3c 74 64 3e 41 72 64 75 042</td><td>Ardu
0910: 69 6e 6f 20 4d 65 67 61 20 32 35 36 30 20 52 33 ino Mega 2560 R3
0920: 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 72 </td>.. </tr><tr
0930: 3e 0d 0a 20 20 3c 74 64 3e 30 78 32 33 34 31 3c >.. <td>0x2341<
0940: 2f 74 64 3e 3c 74 64 3e 30 78 30 30 34 33 3c 2f /td><td>0x0043</
0950: 74 64 3e 3c 74 64 3e 41 72 64 75 69 6e 6f 20 55 td><td>Arduino U
0960: 4e 4f 20 52 33 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 NO R3</td>.. </t
0970: 72 3e 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 30 78 r><tr>.. <td>0x
0980: 32 33 34 31 3c 2f 74 64 3e 3c 74 64 3e 30 78 30 2341</td><td>0x0
0990: 30 34 34 3c 2f 74 64 3e 3c 74 64 3e 41 72 64 75 044</td><td>Ardu
09a0: 69 6e 6f 20 4d 65 67 61 20 41 44 4b 20 52 33 3c ino Mega ADK R3<
09b0: 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 72 3e /td>.. </tr><tr>
09c0: 0d 0a 20 20 3c 74 64 3e 30 78 32 33 34 31 3c 2f .. <td>0x2341</
09d0: 74 64 3e 3c 74 64 3e 30 78 38 30 33 36 3c 2f 74 td><td>0x8036</t
09e0: 64 3e 3c 74 64 3e 41 72 64 75 69 6e 6f 20 4c 65 d><td>Arduino Le
09f0: 6f 6e 61 72 64 6f 3c 2f 74 64 3e 0d 0a 20 3c 2f onardo</td>.. </
0a00: 74 72 3e 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 30 tr><tr>.. <td>0
0a10: 78 31 36 63 30 3c 2f 74 64 3e 3c 74 64 3e 30 78 x16c0</td><td>0x
0a20: 30 34 38 33 3c 2f 74 64 3e 3c 74 64 3e 54 65 65 0483</td><td>Tee
0a30: 6e 73 79 44 75 69 6e 6f 3c 2f 74 64 3e 0d 0a 20 nsyDuino</td>..
0a40: 3c 2f 74 72 3e 3c 74 72 3e 0d 0a 20 20 3c 74 64 </tr><tr>.. <td
0a50: 3e 30 78 30 33 65 62 3c 2f 74 64 3e 3c 74 64 3e >0x03eb</td><td>
0a60: 30 78 32 30 34 34 3c 2f 74 64 3e 3c 74 64 3e 41 0x2044</td><td>A
0a70: 54 4d 45 4c 20 4c 55 46 41 20 43 44 43 20 44 65 TMEL LUFA CDC De
0a80: 6d 6f 20 41 70 70 6c 69 63 61 74 69 6f 6e 3c 2f mo Application</
0a90: 74 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 72 3e 0d td>.. </tr><tr>.
0aa0: 0a 20 20 3c 74 64 3e 30 78 31 65 61 66 3c 2f 74 . <td>0x1eaf</t
0ab0: 64 3e 3c 74 64 3e 30 78 30 30 30 34 3c 2f 74 64 d><td>0x0004</td
0ac0: 3e 3c 74 64 3e 4c 65 61 66 6c 61 62 73 20 4d 61 ><td>Leaflabs Ma
0ad0: 70 6c 65 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e ple</td>.. </tr>
0ae0: 3c 74 72 3e 0d 0a 20 20 3c 74 64 3e 30 78 31 61 <tr>.. <td>0x1a
0af0: 38 36 3c 2f 74 64 3e 3c 74 64 3e 30 78 37 35 32 86</td><td>0x752
0b00: 33 3c 2f 74 64 3e 3c 74 64 3e 43 48 20 33 34 78 3</td><td>CH 34x
0b10: 3c 2f 74 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 72 </td>.. </tr><tr
0b20: 3e 0d 0a 20 20 3c 74 64 3e 30 78 31 61 38 36 3c >.. <td>0x1a86<
0b30: 2f 74 64 3e 3c 74 64 3e 30 78 35 35 32 33 3c 2f /td><td>0x5523</
0b40: 74 64 3e 3c 74 64 3e 43 48 20 33 34 78 3c 2f 74 td><td>CH 34x</t
0b50: 64 3e 0d 0a 20 3c 2f 74 72 3e 3c 74 72 3e 0d 0a d>.. </tr><tr>..
0b60: 20 20 3c 74 64 3e 30 78 34 33 34 38 3c 2f 74 64 <td>0x4348</td
0b70: 3e 3c 74 64 3e 30 78 35 35 32 33 3c 2f 74 64 3e ><td>0x5523</td>
0b80: 3c 74 64 3e 43 48 20 33 34 78 3c 2f 74 64 3e 0d <td>CH 34x</td>.
0b90: 0a 20 3c 2f 74 72 3e 0d 0a 3c 2f 74 61 62 6c 65 . </tr>..</table
0ba0: 3e 0d 0a 3c 2f 6e 6f 77 69 6b 69 3e 0d 0a 0a 5a >..</nowiki>...Z
0bb0: 20 32 63 31 33 64 65 34 39 37 33 31 38 66 38 61 2c13de497318f8a
0bc0: 62 64 37 35 65 34 35 35 39 61 37 61 34 31 31 34 bd75e4559a7a4114
0bd0: 39 0a 9.