FreeCalypso > hg > freecalypso-tools

comparison doc/High-speed-serial @ 694:9edb7c07bb29

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/High-speed-serial updated for libserial rename
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 11 Mar 2020 17:28:11 +0000
parents 00805e7c4c45
children 2b4c3e0f73fc
comparison
equal deleted inserted replaced
693:4a1f0bbca58e 694:9edb7c07bb29
90 ============================== 90 ==============================
91 91
92 The serial port handling code for all of FC host tools has been factored out 92 The serial port handling code for all of FC host tools has been factored out
93 into a common library called libserial. We have two versions of libserial: 93 into a common library called libserial. We have two versions of libserial:
94 94
95 * libserial-orig uses the standard and presumably portable termios API, but 95 * libserial-posix uses the standard and presumably portable termios API, but
96 requires "magic" remapping of baud rates by some invisible genie below (like 96 requires "magic" remapping of baud rates by some invisible genie below (like
97 CP2102 EEPROM programming) in order to get 203125/406250/812500 baud. 97 CP2102 EEPROM programming) in order to get 203125/406250/812500 baud.
98 98
99 * libserial-newlnx uses Linux-specific header files and raw ioctl calls to 99 * libserial-linux uses Linux-specific header files and raw ioctl calls to
100 request the actual desired baud rates. 100 request the actual desired baud rates.
101 101
102 If you would like to run FreeCalypso host tools under FreeBSD, illumos or some 102 If you would like to run FreeCalypso host tools under FreeBSD, illumos or some
103 other alternative-to-Linux OS, you have two basic choices: 103 other alternative-to-Linux OS, you have two basic choices:
104 104
107 remapping, you will need to figure out how to request non-standard serial 107 remapping, you will need to figure out how to request non-standard serial
108 baud rates from the underlying drivers under your OS, and create your own 108 baud rates from the underlying drivers under your OS, and create your own
109 version of libserial ported to use that method. 109 version of libserial ported to use that method.
110 110
111 * If you don't need high GSM baud rates or need them only with CP2102 adapters 111 * If you don't need high GSM baud rates or need them only with CP2102 adapters
112 which "magically" remap them, you should be able to use libserial-orig. You 112 which "magically" remap them, you should be able to use libserial-posix. You
113 can also completely remove the entries for the high GSM baud rates from 113 can also completely remove the entries for the high GSM baud rates from
114 libserial-orig/baudtab.c if you don't need these high baud rates and your 114 libserial-posix/baudtab.c if you don't need these high baud rates and your
115 version of termios does not have B230400/B460800/B921600 baud rate constants. 115 version of termios does not have B230400/B460800/B921600 baud rate constants.
116 116
117 It is assumed that any system on which someone may desire to run our FC host 117 It is assumed that any system on which someone may desire to run our FC host
118 tools supports at least 115200 baud. The Mother remembers the days when this 118 tools supports at least 115200 baud. The Mother remembers the days when this
119 baud rate was considered very high and non-standard and even has some of those 119 baud rate was considered very high and non-standard and even has some of those