Control and Telemetry

conventions percentage representations payload values in percentages are mapped to the range of int16 max to int16 max percentage representation in control and telemetry messages group cid a group cid can be used to send a message to a group of 4 sids the group cid is used in place of the device sid in broadcast messages basic can id structure for broadcast messages calculating group cid the group number, or group controller identifier (cid) for a device with a given sid (1 127) can be calculated as follows, please note the use of the floor division operator example a device with sid 8 will map to group 2 as demonstrated below group 2 will contain the following sids \[5, 6, 7, 8] or represented as the range \[5, 8] calculating index within group the index of a device with a given sid within it’s group can be calculated as follows, ‘mod 4’ indicates the use of the modulo operator (often represented by the % in many programming languages) example a device with sid 6 is in cid group 2 which contains the following range of \[5, 8] the index of sid 6 is calculated as, indexing is 1 based group cid diagram the below diagram demonstrates the group cid and group index relationship for sids 1 12, the pattern of groups and group indexes continues for higher sids arinc diagrams group cid explanaition drawio png throttle control throttle can be controlled with one of two methods, sending a throttle message to a singular esc or broadcasting throttle to groups of 4 escs at a time throttle commands should be sent to each esc at a minimum frequency of 1hz 100hz is typical, but the frequency should be adjusted according to system requirements true 111,56,100,0,103,92,92 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type direct throttle a direct throttle command sends a singular throttle value to an individual motor controller on the bus can id 0x08581400 | (sid << 2) the direct throttle message can id is 0x08581400 | (sid << 2) where sid is the target device sid for sid 1 the can id is 0x08581404 advanced true 172 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type can payload the can payload is structured as follows true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type direct throttle message payload broadcast throttle a broadcast throttle sends 4 throttle values in a singular can frame to a group of up to 4 motor controllers this can reduce bandwidth required for throttle commands compared to sending direct throttle commands to each esc can id 0x08581600 | (group cid << 2) the can id for the broadcast throttle uses the group cid instead of the sid as follows the direct throttle message can id is 0x08581600 | (group cid << 2) where group cid is the target group cid for group cid 2 the can id is 0x08581608 advanced fid cfc cid device (default 11) 11 group cid can payload the can payload is structured as follows https //app archbee com/api/optimize/mixuvgeo5ljmssoymwenk/ocxfhh 677l5vbypp5v t image 6 png 100 763 433 763 433 center mapping of broadcast throttle values to individual motor controllers left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type image png example the below diagram demonstrates how the broadcast throttle message operates with 4 escs with group cid 2 image png telemetry telemetry is broadcast over the following messages the rate at which each message type is sent is configurable in device settings true 119,57,56,80left unhandled content type unhandled content type unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type unhandled content type unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type unhandled content type unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type unhandled content type unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type esc status 1 the esc status 1 telemetry broadcast is sent by each esc at a configurable frequency, default 10hz can id 0x08586400 | (sid << 2) the esc status 1 message can id is 0x08586400 | (sid << 2) where sid is the sid of the device sending the message for sid 1 the can id is 0x08586404 advanced fid cfc cid device (default 11) 50 device sid can payload the can payload is structured as follows true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type image png esc status 2 the esc status 2 telemetry broadcast is sent by each esc at a configurable frequency, default 10hz can id 0x08586600 | (sid << 2) the esc status 2 message can id is 0x08586600 | (sid << 2) where sid is the sid of the device sending the message for sid 1 the can id is 0x08586604 advanced fid cfc cid device (default 11) 51 device sid can payload the can payload is structured as follows true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type image png status flags the status flags field of the esc status 2 message is a bitfield, where each bit corresponds to a flag indicating device state the flag mapping is below true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type esc status 3 the esc status 3 telemetry broadcast is sent by each esc at a configurable frequency, default 10hz can id 0x08586800 | (sid << 2) the esc status 3 message can id is 0x08586800 | (sid << 2) where sid is the sid of the device sending the message for sid 1 the can id is 0x08586804 advanced fid cfc cid device (default 11) 52 device sid can payload the can payload is structured as follows true left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type image png