docs/Serial.md

   1 # Serial
   2
   3 INAV has enhanced serial port flexibility but configuration is slightly more complex as a result.
   4
   5 INAV has the concept of a function (MSP, GPS, Serial RX, etc) and a port (VCP, UARTx, SoftSerial x).
   6 Not all functions can be used on all ports due to hardware pin mapping, conflicting features, hardware, and software
   7 constraints.
   8
   9 ## Serial port types
  10
  11 * USB Virtual Com Port (VCP) - USB pins on a USB port connected directly to the processor without requiring
  12 a dedicated USB to UART adapter.  VCP does not 'use' a physical UART port.
  13 * UART - A pair of dedicated hardware transmit and receive pins with signal detection and generation done in hardware.
  14 * SoftSerial - A pair of hardware transmit and receive pins with signal detection and generation done in software.
  15
  16 UART is the most efficient in terms of CPU usage.
  17 SoftSerial is the least efficient and slowest, SoftSerial should only be used for low-bandwidth usages, such as telemetry transmission.
  18
  19 UART ports are sometimes exposed via on-board USB to UART converters, such as the CP2102.
  20 If the flight controller does not have an on-board USB to UART converter and doesn't support VCP then an external USB to UART board is required.
  21 These are sometimes referred to as FTDI boards.  FTDI is just a common manufacturer of a chip (the FT232RL) used on USB to UART boards.
  22
  23 When selecting a USB to UART converter choose one that has DTR exposed as well as a selector for 3.3v and 5v since they are more useful.
  24
  25 Examples:
  26
  27  * [FT232RL FTDI USB To TTL Serial Converter Adapter](https://inavflight.com/shop/s/bg/917226)
  28  * [USB To TTL / COM Converter Module buildin-in CP2102](https://inavflight.com/shop/s/bg/27989)
  29
  30 Both SoftSerial and UART ports can be connected to your computer via USB to UART converter boards.
  31
  32 ## Serial Configuration
  33
  34 Serial port configuration is best done via the configurator.
  35
  36 Configure serial ports first, then enable/disable features that use the ports.  To configure SoftSerial ports the SOFTSERIAL feature must be also be enabled.
  37
  38 ### Constraints
  39
  40 If the configuration is invalid the serial port configuration will reset to its defaults and features may be disabled.
  41
  42 * There must always be a port available to use for MSP/CLI.
  43 * There is a maximum of 3 MSP ports.
  44 * To use a port for a function, the function's corresponding feature must be also be enabled.
  45 e.g. after configuring a port for GPS enable the GPS feature.
  46 * If SoftSerial is used, then all SoftSerial ports must use the same baudrate.
  47 * Softserial is limited to 19200 buad.
  48 * All telemetry systems except MSP will ignore any attempts to override the baudrate.
  49 * MSP/CLI can be shared with EITHER Blackbox OR telemetry.  In shared mode blackbox or telemetry will be output only when armed.
  50 * Smartport telemetry cannot be shared with MSP.
  51 * No other serial port sharing combinations are valid.
  52 * You can use as many different telemetry systems as you like at the same time.
  53 * You can only use each telemetry system once.  e.g.  FrSky telemetry cannot be used on two port, but MSP Telemetry + FrSky on different ports is fine.
  54
  55 ### Configuration via CLI
  56
  57 You can use the CLI for configuration but the commands are reserved for developers and advanced users.
  58
  59 The `serial` CLI command takes 6 arguments.
  60
  61 1. Identifier
  62 2. Function bitmask (see serialPortFunction_e in the source)
  63 3. MSP baud rate
  64 4. GPS baud rate
  65 5. Telemetry baud rate (auto baud allowed)
  66 6. Blackbox baud rate
  67
  68
  69 ### Baud Rates
  70
  71 The allowable baud rates are as follows:
  72
  73 | Identifier | Baud rate |
  74 | ---------- | --------- |
  75 |  0         |    Auto   |
  76 |  1         |    1200   |
  77 |  2         |    2400   |
  78 |  3         |    4800   |
  79 |  4         |    9600   |
  80 |  5         |   19200   |
  81 |  6         |   38400   |
  82 |  7         |   57600   |
  83 |  8         |  115200   |
  84 |  9         |  230400   |
  85 | 10         |  250000   |
  86 | 11         |  460800   |
  87 | 12         |  921600   |
  88 | 13         | 1000000   |
  89 | 14         | 1500000   |
  90 | 15         | 2000000   |
  91 | 16         | 2470000   |
  92