# Application-level conventions

## ID distribution

### Message type ID

The valid range for *message type ID* is from 0 to 65535, inclusive (see CAN bus transport layer specification).
The range is segmented as follows:

ID range | Purpose |
---|---|

[0, 20000) | Standard message types |

[20000, 21000) | Vendor-specific message types |

[21000, 65536) | Reserved for future use |

### Service type ID

The valid range for *service type ID* is from 0 to 255, inclusive (see CAN bus transport layer specification).
The range is segmented as follows:

ID range | Purpose |
---|---|

[0, 100) | Standard service types |

[100, 200) | Reserved for future use |

[200, 256) | Vendor-specific service types |

### Node ID

The valid range for *node ID* is from 1 to 127, inclusive (see CAN bus transport layer specification).

The values 126 and 127 are reserved for debugging tools and should not be used for real nodes.

## Coordinate frames and rotation representation

UAVCAN follows the conventions that are widely accepted in various aerospace applications.

All systems are right handed. In relation to a body, the standard is as follows:

- X forward
- Y right
- Z down

In the case of cameras, the following convention should be preferred:

- Z forward
- X right
- Y down

For world frames, the North-East-Down (NED) notation should be preferred.

The default rotation representation is quaternion. The coefficients are ordered as follows: X, Y, Z, W.

Angular velocities should be represented in fixed axis roll (about X), pitch (about Y), and yaw (about Z).

## Matrix representation

Matrices should be represented as flat arrays in row-major order. There are some standard ways to represent an N-by-N square matrix in a one-dimensional array:

- An empty array represents a zero matrix.
- An array of one element represents a scalar matrix.
- An array of N elements represents a diagonal matrix,
where each array member A
_{i}equals the matrix element M_{i,i}. - An array of ((1+N)*N)/2 elements represents a symmetric matrix,
where array members represent elements of the upper-right triangle arranged in row-major order.
For example, a 3-by-3 symmetric matrix can be represented as a flat array containing 6 matrix elements
in the following order:
[M
_{1,1}, M_{1,2}, M_{1,3}, M_{2,2}, M_{2,3}, M_{3,3}]. - An array of size N
^{2}elements represents a full square matrix.

### Covariance matrix

A zero covariance matrix represents an unknown covariance.

Positive infinity in variance means that the associated value is undefined. Alternatively, in some cases, the value itself can be set to NAN (not-a-number float constant) to indicate that the parameter value is not defined. Note though that it is recommended to avoid NAN and infinities whenever possible for portability reasons.

## Engineering units

All units are SI units, unless explicitly noted otherwise.

The following field naming convention is used:

- Fields that contain values not in SI units must be suffixed with the unit name, e.g.,
`battery_capacity_wh`

(“wh” is for “Watt-hours” in this example). - Fields that contain values in SI units are not suffixed, e.g.,
`voltage`

(implying that the units are Volts).

If an application designer chooses to deviate, such decision should be properly documented.