canlib function reference

struct can_msg_t

Public Members

can_sid_t sid

uint8_t data_len

uint8_t data[8]

struct can_timing_t

Public Members

uint8_t brp

uint8_t sjw

uint8_t sam

uint8_t seg1ph

uint8_t seg2ph

uint8_t prseg

bool btlmode

struct srb_ctx_t

Public Members

void *memory_pool

size_t element_size

size_t max_elements

size_t rd_idx

size_t wr_idx

file can.h

Defines

CANLIB_BIT_TIME_US

Typedefs

typedef uint32_t can_sid_t

file msg_actuator.h

Functions

void build_actuator_cmd_msg(can_msg_prio_t prio, uint16_t timestamp, can_actuator_id_t actuator_id, can_actuator_state_t actuator_cmd, can_msg_t *output)

void build_actuator_status_msg(can_msg_prio_t prio, uint16_t timestamp, can_actuator_id_t actuator_id, can_actuator_state_t actuator_curr_state, can_actuator_state_t actuator_cmd_state, can_msg_t *output)

int get_actuator_id(const can_msg_t *msg)

int get_curr_actuator_state(const can_msg_t *msg)

int get_cmd_actuator_state(const can_msg_t *msg)

file msg_common.h

Defines

BOARD_TYPE_UNIQUE_ID

BOARD_INST_UNIQUE_ID

Functions

static inline uint32_t build_sid(can_msg_prio_t prio, can_msg_type_t msg_type, uint8_t metadata)

static inline can_msg_type_t get_message_type(const can_msg_t *msg)

static inline uint8_t get_board_type_unique_id(const can_msg_t *msg)

static inline uint8_t get_board_inst_unique_id(const can_msg_t *msg)

static inline uint8_t get_message_metadata(const can_msg_t *msg)

static inline void write_timestamp(uint16_t timestamp, can_msg_t *output)

static inline uint16_t get_timestamp(const can_msg_t *msg)

file msg_general.h

Functions

void build_general_board_status_msg(can_msg_prio_t prio, uint16_t timestamp, uint32_t general_error_bitfield, uint16_t board_specific_error_bitfield, can_msg_t *output)

void build_reset_msg(can_msg_prio_t prio, uint16_t timestamp, uint8_t board_type_id, uint8_t board_inst_id, can_msg_t *output)

void build_debug_raw_msg(can_msg_prio_t prio, uint16_t timestamp, const uint8_t *data, can_msg_t *output)

void build_config_set_msg(can_msg_prio_t prio, uint16_t timestamp, uint8_t board_type_id, uint8_t board_inst_id, uint16_t config_id, uint16_t config_value, can_msg_t *output)

void build_config_status_msg(can_msg_prio_t prio, uint16_t timestamp, uint16_t config_id, uint16_t config_value, can_msg_t *output)

bool get_general_board_status(const can_msg_t *msg, uint32_t *general_error_bitfield, uint16_t *board_specific_error_bitfield)

bool get_reset_board_id(const can_msg_t *msg, uint8_t *board_type_id, uint8_t *board_inst_id)

bool check_board_need_reset(const can_msg_t *msg)

bool get_debug_raw_data(const can_msg_t *msg, uint8_t *data)

bool get_config_set_target_board(const can_msg_t *msg, uint8_t *board_type_id, uint8_t *board_inst_id)

bool get_config_id_value(const can_msg_t *msg, uint16_t *config_id, uint16_t *config_value)

file msg_gps.h

Functions

bool build_gps_time_msg(can_msg_prio_t prio, uint16_t timestamp, uint8_t utc_hours, uint8_t utc_mins, uint8_t utc_secs, uint8_t utc_dsecs, can_msg_t *output)

bool build_gps_lat_msg(can_msg_prio_t prio, uint16_t timestamp, uint8_t degrees, uint8_t minutes, uint16_t dminutes, uint8_t direction, can_msg_t *output)

bool build_gps_lon_msg(can_msg_prio_t prio, uint16_t timestamp, uint8_t degrees, uint8_t minutes, uint16_t dminutes, uint8_t direction, can_msg_t *output)

bool build_gps_alt_msg(can_msg_prio_t prio, uint16_t timestamp, uint16_t altitude, uint8_t daltitude, uint8_t units, can_msg_t *output)

bool build_gps_info_msg(can_msg_prio_t prio, uint16_t timestamp, uint8_t num_sat, uint8_t quality, can_msg_t *output)

bool get_gps_time(const can_msg_t *msg, uint8_t *utc_hours, uint8_t *utc_mins, uint8_t *utc_secs, uint8_t *utc_dsecs)

bool get_gps_lat(const can_msg_t *msg, uint8_t *degrees, uint8_t *minutes, uint16_t *dminutes, uint8_t *direction)

bool get_gps_lon(const can_msg_t *msg, uint8_t *degrees, uint8_t *minutes, uint16_t *dminutes, uint8_t *direction)

bool get_gps_alt(const can_msg_t *msg, uint16_t *altitude, uint8_t *daltitude, uint8_t *units)

bool get_gps_info(const can_msg_t *msg, uint8_t *num_sat, uint8_t *quality)

file msg_recovery.h

Functions

bool build_alt_arm_cmd_msg(can_msg_prio_t prio, uint16_t timestamp, can_altimeter_id_t alt_id, can_alt_arm_state_t arm_cmd, can_msg_t *output)

bool build_alt_arm_status_msg(can_msg_prio_t prio, uint16_t timestamp, can_altimeter_id_t alt_id, can_alt_arm_state_t arm_state, uint16_t v_drogue, uint16_t v_main, can_msg_t *output)

bool get_alt_arm_state(const can_msg_t *msg, can_altimeter_id_t *alt_id, can_alt_arm_state_t *arm_state)

bool get_pyro_voltage_data(const can_msg_t *msg, uint16_t *v_drogue, uint16_t *v_main)

file msg_sensor.h

Functions

void build_analog_data_16bit_msg(can_msg_prio_t prio, uint16_t timestamp, can_analog_sensor_id_t sensor_id, uint16_t sensor_data, can_msg_t *output)

void build_analog_data_32bit_msg(can_msg_prio_t prio, uint16_t timestamp, can_analog_sensor_id_t sensor_id, uint32_t sensor_data, can_msg_t *output)

void build_dem_analog_data_16bit_msg(can_msg_prio_t prio, uint16_t timestamp, can_dem_sensor_id_t dem_sensor_id, uint16_t sensor_data_x, uint16_t sensor_data_y, uint16_t sensor_data_z, can_msg_t *output)

bool msg_is_sensor_data(const can_msg_t *msg)

bool get_analog_data_16bit(const can_msg_t *msg, can_analog_sensor_id_t *sensor_id, uint16_t *output_data)

bool get_analog_data_32bit(const can_msg_t *msg, can_analog_sensor_id_t *sensor_id, uint32_t *output_data)

bool get_dem_analog_data_16bit(const can_msg_t *msg, can_dem_sensor_id_t *dem_sensor_id, uint16_t *output_data_x, uint16_t *output_data_y, uint16_t *output_data_z)

file msg_stream.h

Defines

STREAM_DATA_MAX_PAYLOAD_LEN

Functions

bool build_stream_status_msg(can_msg_prio_t prio, uint16_t timestamp, uint32_t total_size, uint32_t tx_size, can_msg_t *output)

bool build_stream_data_msg(can_msg_prio_t prio, uint16_t timestamp, uint8_t seq_id, const uint8_t *payload, uint8_t payload_len, can_msg_t *output)

bool build_stream_retry_msg(can_msg_prio_t prio, uint16_t timestamp, uint8_t seq_id, can_msg_t *output)

bool get_stream_status(const can_msg_t *msg, uint32_t *total_size, uint32_t *tx_size)

bool get_stream_data(const can_msg_t *msg, uint8_t *seq_id, uint8_t *payload, uint8_t *payload_len)

bool get_stream_retry_seq_id(const can_msg_t *msg, uint8_t *seq_id)

file message_types.h

Enums

enum can_msg_prio_t

Values:

enumerator PRIO_HIGHEST

enumerator PRIO_HIGH

enumerator PRIO_MEDIUM

enumerator PRIO_LOW

enum can_msg_type_t

Values:

enumerator MSG_UNDEFINED

enumerator MSG_GENERAL_BOARD_STATUS

enumerator MSG_RESET_CMD

enumerator MSG_DEBUG_RAW

enumerator MSG_CONFIG_SET

enumerator MSG_CONFIG_STATUS

enumerator MSG_ACTUATOR_CMD

enumerator MSG_ACTUATOR_STATUS

enumerator MSG_ALT_ARM_CMD

enumerator MSG_ALT_ARM_STATUS

enumerator MSG_SENSOR_ANALOG16

enumerator MSG_SENSOR_ANALOG32

enumerator MSG_SENSOR_DEM_ANALOG16

enumerator MSG_GPS_TIMESTAMP

enumerator MSG_GPS_LATITUDE

enumerator MSG_GPS_LONGITUDE

enumerator MSG_GPS_ALTITUDE

enumerator MSG_GPS_INFO

enumerator MSG_STREAM_STATUS

enumerator MSG_STREAM_DATA

enumerator MSG_STREAM_RETRY

enumerator MSG_LEDS_ON

enumerator MSG_LEDS_OFF

enumerator MSG_ID_ENUM_MAX

enum can_board_type_id_t

Values:

enumerator BOARD_TYPE_ID_ANY

enumerator BOARD_TYPE_ID_INJECTOR

enumerator BOARD_TYPE_ID_CAMERA

enumerator BOARD_TYPE_ID_POWER

enumerator BOARD_TYPE_ID_LOGGER

enumerator BOARD_TYPE_ID_CANARD

enumerator BOARD_TYPE_ID_TELEMETRY

enumerator BOARD_TYPE_ID_GPS

enumerator BOARD_TYPE_ID_ALTIMETER

enumerator BOARD_TYPE_ID_ARMING

enumerator BOARD_TYPE_ID_PAYLOAD

enumerator BOARD_TYPE_ID_RLCS_GLS

enumerator BOARD_TYPE_ID_RLCS_RELAY

enumerator BOARD_TYPE_ID_DAQ

enumerator BOARD_TYPE_ID_ENUM_MAX

enum can_board_inst_id_t

Values:

enumerator BOARD_INST_ID_ANY

enumerator BOARD_INST_ID_GROUND

enumerator BOARD_INST_ID_ROCKET

enumerator BOARD_INST_ID_PAYLOAD

enum can_board_inst_id_camera_t

Values:

enumerator BOARD_INST_ID_CAMERA_SIDE_LOOKING

enumerator BOARD_INST_ID_CAMERA_DOWN_LOOKING

enumerator BOARD_INST_ID_CAMERA_RECOVERY

enumerator BOARD_INST_ID_CAMERA_ENUM_MAX

enum can_board_inst_id_arming_t

Values:

enumerator BOARD_INST_ID_ARMING_RA_RAVEN

enumerator BOARD_INST_ID_ARMING_RA_STRATOLOGGER

enumerator BOARD_INST_ID_ARMING_ENUM_MAX

enum can_actuator_id_t

Values:

enumerator ACTUATOR_OX_INJECTOR_VALVE

enumerator ACTUATOR_FUEL_INJECTOR_VALVE

enumerator ACTUATOR_ROCKET_CHARGE_ENABLE

enumerator ACTUATOR_PAYLOAD_CHARGE_ENABLE

enumerator ACTUATOR_5V_RAIL_ROCKET

enumerator ACTUATOR_5V_RAIL_PAYLOAD

enumerator ACTUATOR_12V_RAIL_ROCKET

enumerator ACTUATOR_TELEMETRY

enumerator ACTUATOR_CAMERA_SIDE_LOOKING

enumerator ACTUATOR_CAMERA_DOWN_LOOKING

enumerator ACTUATOR_CAMERA_RECOVERY

enumerator ACTUATOR_CANARD_PAD_FILTER

enumerator ACTUATOR_CANARD_LOW_POWER_MODE

enumerator ACTUATOR_SRAD_ALT_ESTIMATOR_INIT

enumerator ACTUATOR_SRAD_ALT_GPS_RESET

enumerator ACTUATOR_CAMERA_CAPTURE

enumerator ACTUATOR_PAYLOAD_LOGGING_ENABLE

enumerator ACTUATOR_THESEUS_ACTUATOR_1

enumerator ACTUATOR_THESEUS_ACTUATOR_2

enumerator ACTUATOR_RLCS_RELAY_POWER

enumerator ACTUATOR_RLCS_RELAY_SELECT

enumerator ACTUATOR_ENUM_MAX

enum can_actuator_state_t

Values:

enumerator ACT_STATE_ON

enumerator ACT_STATE_OFF

enumerator ACT_STATE_UNK

enumerator ACT_STATE_ILLEGAL

enumerator ACT_STATE_ENUM_MAX

enum can_altimeter_id_t

Values:

enumerator ALTIMETER_RAVEN

enumerator ALTIMETER_STRATOLOGGER

enumerator ALTIMETER_SRAD

enumerator ALTIMETER_ENUM_MAX

enum can_alt_arm_state_t

Values:

enumerator ALT_ARM_STATE_DISARMED

enumerator ALT_ARM_STATE_ARMED

enumerator ALT_ARM_STATE_ENUM_MAX

enum can_analog_sensor_id_t

Values:

enumerator SENSOR_5V_VOLT

enumerator SENSOR_5V_CURR

enumerator SENSOR_12V_VOLT

enumerator SENSOR_12V_CURR

enumerator SENSOR_CHARGE_VOLT

enumerator SENSOR_CHARGE_CURR

enumerator SENSOR_BATT_VOLT

enumerator SENSOR_BATT_CURR

enumerator SENSOR_RADIO_CURR

enumerator SENSOR_GPS_CURR

enumerator SENSOR_LOCAL_CURR

enumerator SENSOR_PT_CHANNEL_1

enumerator SENSOR_PT_CHANNEL_2

enumerator SENSOR_PT_CHANNEL_3

enumerator SENSOR_PT_CHANNEL_4

enumerator SENSOR_PT_CHANNEL_5

enumerator SENSOR_HALL_CHANNEL_1

enumerator SENSOR_HALL_CHANNEL_2

enumerator SENSOR_HALL_CHANNEL_3

enumerator SENSOR_RA_BATT_VOLT_1

enumerator SENSOR_RA_BATT_VOLT_2

enumerator SENSOR_RA_BATT_CURR_1

enumerator SENSOR_RA_BATT_CURR_2

enumerator SENSOR_RA_MAG_VOLT_1

enumerator SENSOR_RA_MAG_VOLT_2

enumerator SENSOR_FPS

enumerator SENSOR_PAYLOAD_LIM_1

enumerator SENSOR_PAYLOAD_LIM_2

enumerator SENSOR_PAYLOAD_SERVO_DIRECTION

enumerator SENSOR_PAYLOAD_INFRARED

enumerator SENSOR_THESEUS_TEMP_1

enumerator SENSOR_THESEUS_TEMP_2

enumerator SENSOR_THESEUS_TEMP_3

enumerator SENSOR_RLCS_RELAY_OUTPUT_VOLT_A

enumerator SENSOR_RLCS_RELAY_OUTPUT_VOLT_B

enumerator SENSOR_RLCS_RELAY_OUTPUT_CURR_A

enumerator SENSOR_RLCS_RELAY_OUTPUT_CURR_B

enumerator SENSOR_RLCS_RELAY_LIM_VOLT_A

enumerator SENSOR_RLCS_RELAY_LIM_VOLT_B

enumerator SENSOR_LOG_WRITTEN_SIZE

enumerator SENSOR_SD_LOG_FILE_NAME

enumerator SENSOR_SD_USED

enumerator SENSOR_SD_FREE

enumerator SENSOR_FLASH_LOG_FILE_NAME

enumerator SENSOR_FLASH_USED

enumerator SENSOR_FLASH_FREE

enumerator SENSOR_CANARD_CTRL_CMD_ANGLE

enumerator SENSOR_CANARD_CTRL_COEFF_LIFT

enumerator SENSOR_CANARD_MS5611_BARO

enumerator SENSOR_CANARD_MS5611_TEMP

enumerator SENSOR_CANARD_MTI630_BARO_0

enumerator SENSOR_CANARD_MTI630_BARO_1

enumerator SENSOR_CANARD_MTI630_EST_ALT

enumerator SENSOR_CANARD_ADXRS649_GYRO

enumerator SENSOR_CANARD_SERVO_ANGLE

enumerator SENSOR_CANARD_SERVO_CURR

enumerator SENSOR_CANARD_SERVO_TEMP

enumerator SENSOR_ENUM_MAX

enum can_dem_sensor_id_t

Values:

enumerator DEM_SENSOR_CANARD_NAV_ORIENTATION_QUAT_QX_QY_QZ

enumerator DEM_SENSOR_CANARD_NAV_ORIENTATION_QUAT_QW_ALT_VARNORM

enumerator DEM_SENSOR_CANARD_NAV_ANGLE_VEL

enumerator DEM_SENSOR_CANARD_NAV_VEL

enumerator DEM_SENSOR_CANARD_LSM6DSV32X_ACCEL

enumerator DEM_SENSOR_CANARD_LSM6DSV32X_GYRO

enumerator DEM_SENSOR_CANARD_LSM303AGR_ACCEL

enumerator DEM_SENSOR_CANARD_LSM303AGR_MAG

enumerator DEM_SENSOR_CANARD_MTI630_ACCEL

enumerator DEM_SENSOR_CANARD_MTI630_GYRO

enumerator DEM_SENSOR_CANARD_MTI630_MAG

enumerator DEM_SENSOR_CANARD_MTI630_EST_ORIENTATION

enumerator DEM_SENSOR_CANARD_MTI630_EST_ANGLE_VEL

enumerator DEM_SENSOR_CANARD_MTI630_EST_VEL

enumerator DEM_SENSOR_CANARD_ADXL380_ACCEL

enumerator DEM_SENSOR_ENUM_MAX

enum can_general_board_status_offset_t

Values:

enumerator E_5V_OVER_CURRENT_OFFSET

enumerator E_5V_OVER_VOLTAGE_OFFSET

enumerator E_5V_UNDER_VOLTAGE_OFFSET

enumerator E_12V_OVER_CURRENT_OFFSET

enumerator E_12V_OVER_VOLTAGE_OFFSET

enumerator E_12V_UNDER_VOLTAGE_OFFSET

enumerator E_BATT_OVER_CURRENT_OFFSET

enumerator E_BATT_OVER_VOLTAGE_OFFSET

enumerator E_BATT_UNDER_VOLTAGE_OFFSET

enumerator E_MOTOR_OVER_CURRENT_OFFSET

enumerator E_IO_ERROR_OFFSET

enumerator E_FS_ERROR_OFFSET

enumerator E_WATCHDOG_TIMEOUT_OFFSET

enumerator E_GENERAL_BOARD_STATUS_OFFSET_MAX

enum can_board_specific_status_offset_t

Values:

enumerator E_12V_EFUSE_FAULT_OFFSET

enumerator E_5V_EFUSE_FAULT_OFFSET

enumerator E_PT_OUT_OF_RANGE_OFFSET

enumerator E_BOARD_SPECIFIC_STATUS_OFFSET_MAX

file pic18f26k83_can.h

Functions

void pic18f26k83_can_init(const can_timing_t *timing, void (*receive_callback)(const can_msg_t *message))

Initialize PIC18F26K83 CAN Controller.

Warning

Note that this function DOES NOT setup the inputs and outputs from the CAN module to the output pins, application code must do that. In order to do that, CANRXPPS must be set to the proper pin value for the CANRX pin, and ___PPS must be set to 0x33 to mark it as outputting from the CAN module. In addition, TRIS and ANSEL registers for whatever pin is being used must be set to the right values.

Parameters:

timing – Timing parameters generated by can_generate_timing_params function
receive_callback – CAN message receive handler, the function would be called when a CAN message is received

void pic18f26k83_can_send(const can_msg_t *message)

Send a CAN message.

Parameters:: message – CAN message to be sent

bool pic18f26k83_can_send_rdy(void)

Check if CAN controller is ready to send a message.

Returns:: return true if ready to send a message

void pic18f26k83_can_handle_interrupt(void): Call this function in an interrupt context whenever PIR5 is nonzero.

Note

This function clears PIR5 interrupt flags

file can_rcv_buffer.h

A module for buffering CAN messages that are received from the CAN module. The module operates as a ring buffer, with the memory provided by the caller of the module.

The whole goal of this module is allowing you to write application code that doesn’t have to concern itself with ISR vs main thread code. If you set buffer_received_can_message as the can callback, then you can dequeue the buffered messages from the main thread without worrying about missing any messages from the bus.

The ring buffer is designed to be pseudo-thread safe. None of the functions are rentrant, and there are no locking or atomic mechanisms, but flags are used to show whether a particular memory element contains valid data. This should allow the writer function (buffer_received_can_message) and the reader function (get_buffered_can_message) to operate from separate contexts (the former can be run in the ISR and the latter in the main thread) without any problems.

Functions

void rcvb_init(void *pool, size_t pool_size)

Initializes the reecive buffer module.

Parameters:

pool – memory buffer, which must be provided by the caller
pool_size – the size of pool, in bytes

void rcvb_push_message(const can_msg_t *msg)

Copies msg into our internal buffering system.

This function fails silently if we’re out of memory/space to hold the CAN message. This is so that you can use this buffering system as the CAN callback, whose signature is void

Parameters:: msg – message to be sent

bool rcvb_has_overflowed(void)

returns true if the CAN receive buffer has ever overflowed.

Because the push function is meant to be called from an ISR, it won’t be able to do anything if it runs out of memory, it will just drop the message. That drop shouldn’t be silent, so this function will return true if a message has ever been dropped. You can clear this flag with rcvb_reset_overflow_flag.

void rcvb_clear_overflow_flag(void): Clears the overflow flag, so that rcvb_has_overflowed will start returning false again. This function isn’t perfectly concurrency safe: If you call this function and during the call the receive buffer overflows again, you’ll miss that flag.

bool rcvb_is_full(void)

returns true if the receive buffer is full

This function exists to make up for the signature of rcvb_push_message. If this function returns true, then you know that we’re out of memory and we can’t enqueue your new message

bool rcvb_is_empty(void): returns false if there’s a CAN message that has been buffered, but has not yet been read. Returns true otherwise

bool rcvb_pop_message(can_msg_t *msg)

gets the oldest buffered CAN message and puts it into msg, then dequeues that message.

Parameters:: msg – message buffer
Returns:: true if we were successfully able to grab a CAN message.

bool rcvb_peek_message(can_msg_t *msg)

gets the oldest buffered CAN message and puts it into msg, and does not dequeue it.

Parameters:: msg – message buffer
Returns:: true if we were successfully able to grab a CAN message.

file can_tx_buffer.h

Functions

void txb_init(void *pool, size_t pool_size, void (*can_send)(const can_msg_t*), bool (*can_tx_ready)(void))

bool txb_enqueue(const can_msg_t *msg)

Buffers message.

If there is room in the can_tx buffer, this function will not send the message. The only calls to can_send() will be made during txb_heartbeat()

Parameters:: msg – message to be buffered
Returns:: true if success, false if failed(i.e. buffer is full)

void txb_heartbeat(void)

This function is called every iteration through the main application loop.

If there are any messages that are in the “to transmit” queue, and can_tx_ready() returns true, then can_send() will be called with that message

file safe_ring_buffer.h

Functions

void srb_init(srb_ctx_t *ctx, void *pool, size_t pool_size, size_t element_size)

bool srb_push(srb_ctx_t *ctx, const void *element)

bool srb_is_full(const srb_ctx_t *ctx)

bool srb_is_empty(const srb_ctx_t *ctx)

bool srb_pop(srb_ctx_t *ctx, void *element)

bool srb_peek(const srb_ctx_t *ctx, void *element)

file timing_util.h

Functions

bool can_generate_timing_params(uint32_t system_freq, can_timing_t *timing)

Generate CAN bus timing setting for PIC microcontrollers.

Parameters:

system_freq – PIC Fosc frequency in Hz
timing – buffer to write timing parameters to

Returns:

true if system_freq is valid and parameters have been written to timing

dir /home/jason/projects/rocketry/docs/firmware-library/canlib

dir /home/jason/projects/rocketry/docs/firmware-library/canlib/canlib

dir /home/jason/projects/rocketry/docs/firmware-library

dir /home/jason/projects/rocketry/docs/firmware-library/canlib/canlib/message

dir /home/jason/projects/rocketry/docs/firmware-library/canlib/canlib/pic18f26k83

dir /home/jason/projects/rocketry/docs/firmware-library/canlib/canlib/util