# Companion Computer Peripherals
This section contains information about companion computer peripherals. These include both components that might be connected to a companion computer (potentially triggered/accessed by PX4), and for connecting the computer to the flight controller.
# Companion/Pixhawk Communication
Typical companion computer work with Pixhawk requires a companion link to transmit/receive the data between the companion computer and Pixhawk hardware (e.g. Intel NUC and Pixhawk 4).
There are a few devices that allow this communication bridge such as FTDI USB breakouts and level shifters (see below).
PX4 configuration for communicating with a companion computer over MAVLink configuration is covered in MAVLink (OSD / Telemetry). Other relevant topics/sections include: Companion Computer for Pixhawk Series, Robotics and RTPS/DDS Interface: PX4-Fast RTPS(DDS) Bridge.
# FTDI Devices
The FTDI USB adapters are the most common way of communicating between companion computer and Pixhawk. They are usually plug and play as long as the IO of the adapter is set to 3.3V. In order to utilize the full capability/reliability of the serial link offered on the Pixhawk hardware, flow control is recommended.
A few "turnkey" options are listed below:
|Device||3.3v IO (Default)||Flow Control||Tx/Rx LEDs||JST-GH|
|mRo USB FTDI Serial to JST-GH (Basic) (opens new window)||Capable||Capable||No||Yes|
|SparkFun FTDI Basic Breakout (opens new window)||Yes||No||Yes||No|
You can also use an off-the-shelf FTDI cable like this one (opens new window) and connect it to flight controller using the appropriate header adaptor (JST-GH connectors are specified in the Pixhawk standard, but you should confirm the connectors for your flight controller).
# Logic Level Shifters
On occasion a companion computer may expose hardware level IO that is often run at 1.8v or 5v, while the Pixhawk hardware operates at 3.3v IO. In order to resolve this, a level shifter can be implemented to safely convert the transmitting/receiving signal voltage.
- SparkFun Logic Level Converter - Bi-Directional (opens new window)
- 4-channel I2C-safe Bi-directional Logic Level Converter - BSS138 (opens new window)
Cameras are used image and video capture, and more generally to provide data for computer vision applications (in this case the "cameras" may only provide processed data, not raw images)
# Stereo Cameras
Stereo cameras are typically used for depth perception, path planning and SLAM. They are in no way guaranteed to be plug and play with your companion computer.
Popular stereo cameras include:
- Intel® RealSense™ Depth Camera D435 (opens new window)
- Intel® RealSense™ Depth Camera D415 (opens new window)
- Ironsides (opens new window)
- DUO MLX (opens new window)
# VIO Cameras/Sensors
The following sensors can be used for Visual Inertial Odometry (VIO):
# Data Telephony (LTE)
An LTE USB module can be attached to a companion computer and used to route MAVLink traffic between the flight controller and the Internet.
There is no "standard method" for a ground station and companion to connect over the Internet. Generally you can't connect them directly because neither of them will have a public/static IP on the Internet.
Typically your router (or the mobile network) has a public IP address, and your GCS computer/vehicle are on a local network. The router uses network address translation (NAT) to map outgoing requests from your local network to the Internet, and can use the map to route the responses back to requesting system. However NAT has no way to know where to direct the traffic from an arbitrary external system, so there is no way to initiate a connection to a GCS or vehicle running in the local network.
A common approach is to set up a virtual private network between the companion and GCS computer (i.e. install a VPN system like zerotier (opens new window) on both computers). The companion then uses mavlink-router (opens new window) to route traffic between the serial interface (flight controller) and GCS computer on the VPN network.
This method has the benefit that the GCS computer address can be static within the VPN, so the configuration of the mavlink router does not need to change over time. In addition, the communication link is secure because all VPN traffic is encrypted (MAVLink 2 itself does not support encryption).
You can also choose to route to the VPN broadcast address (i.e.
x.x.x.255:14550, where 'x' depends on the VPN system).
This approach means that you do not need to know the IP address of the GCS computer, but may result in more traffic than desired (since packets are broadcast to every computer on the VPN network).
Some USB modules that are known to work include:
- Huawei E8372 (opens new window) and Huawei E3372 (opens new window)
- The E8372 includes WiFi which you can use to configure the SIM while it is plugged into the companion (making the development workflow a little easier). The E3372 lacks WiFi, so you have to configure it by plugging the stick into a laptop.