This article provides guidance to setup UAVCAN protocol on ArduPilot.
The physical CAN port and its driver selected as UAVCAN protocol should be enabled first. Please refer to the CAN Bus Setup
UAVCAN is a lightweight protocol designed for reliable communication in aerospace and robotic applications via CAN bus. The UAVCAN network is a decentralized peer network, where each peer (node) has a unique numeric identifier - node ID and that is only one parameter needs to be set for basic setup.
Detailed description of protocol can be found at https://uavcan.org/
UAVCAN Peripheral Types Supported¶
Ardupilot currently supports the following types of UAVCAN peripherals:
|Rangefinder||ADSB Receiver||Power Module|
|UAVCAN Adapter Node|
UAVCAN device type is selected by:
- GPS,Compass, Barometer, ADSB Receiver, LED, Buzzer, Safety Switch/LED, and Airspeed devices are automatically identified in the UAVCAN protocol
- Power Module: BATT_MONITOR or
UAVCAN Adapter Node¶
These devices are general purpose UAVCAN nodes with I/O ports that allow the attachment of non-UAVCAN ArduPilot peripherals to the UAVCAN bus via UART ports, I2C, SPI, and/or GPIOs. See UAVCAN Adapter Nodes .
UAVCAN ESC and Servo Configuration settings¶
See UAVCAN ESCs for information on UAVCAN ESCs.
Each UAVCAN ESC or Servo will have an programmed ID or channel address corresponding to the autopilot’s servo/motor output channel. These are set by switches on the ESC or via a setup/configuration program, depending on the ESC.
There are three parameters that determine which autopilot servo/motor channels are sent to the CAN ESC and/or Servos: For the examples below, the values are shown for CAN driver #1.
- CAN_D1_UC_NODE - which is the node ID of the autopilot sending the commands to the ESCs so that there can be differentiation between multiple sources on the CAN bus
- CAN_D1_UC_ESC_BM - bitmask that determines which autopilot servo/motor output signals are sent to the UAVCAN ESCs
- CAN_D1_UC_ESC_SRV - bitmask that determines which autopilot servo/motor output signals are sent to the Servos on UAVCAN Servos
In the bitmap mask, each bit position represents an ESC or servo ID number that the corresponding autopilot servo/motor channel command will be directed to. For example, 00001111 (15 decimal) would send commands to ESC or SERVO ID 0 through 3.
GPS configuration settings¶
If there is a UAVCAN GPS device, it has to be enabled in
subgroup of parameters.
TYPE parameter should be set to 9 for corresponding GPS receiver in autopilot.
UAVCAN Rangefinder configuration¶
RNGFNDx_TYPE = 24 to enable UAVCAN rangefinder type. Rangefinder data received over UAVCAN will only be used if the received sensor_id matches the parameter
RNGFNDx_ADDR. For AP_Periph firmware based adaptor nodes, this value is 0, so
RNGFNDx_ADDR must be set to 0. Other UAVCAN rangefinders may differ. See also UAVCAN Adaptor Node instructions.
Ardupilot and UAVCAN provides a means to directly communicate with UAVCAN devices on the CAN BUS attached to the autopilot: SLCAN. Enabling SLCAN and communicating with the UAVCAN devices is dependent on the autopilot’s processor. F7/H7 processors use one method and F4, a different method.