Добавить общий API старого CAN terminal

c/set-protocol/include/balsam_can.h

@@ -0,0 +1,61 @@
+/**
+ * @file balsam_can.h
+ * @brief Legacy Balsam 167 extended-CAN register frames.
+ *
+ * The wire layout is taken from Balsam_167_periph/Source/Internal/ecan.c:
+ * one big-endian address/mask word followed by three big-endian register words.
+ */
+#ifndef BALSAM_CAN_H
+#define BALSAM_CAN_H
+
+#include <stddef.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define BALSAM_CAN_BASE_ID             0x00BA0000UL
+#define BALSAM_CAN_NODE_COUNT          13U
+#define BALSAM_CAN_DATA_OFFSET         0x10U
+#define BALSAM_CAN_DLC                 8U
+#define BALSAM_CAN_REGISTER_COUNT      3U
+
+typedef enum {
+    BALSAM_CAN_TO_NODE = 0,
+    BALSAM_CAN_FROM_NODE = 1
+} balsam_can_direction_t;
+
+typedef struct {
+    uint8_t device;
+    uint8_t direction;
+    uint8_t present_mask;
+    uint16_t start_address;
+    uint16_t values[BALSAM_CAN_REGISTER_COUNT];
+} balsam_can_frame_t;
+
+/** Return non-zero for the command/data/terminal IDs used by Balsam 167. */
+int balsam_can_is_id(uint32_t can_id);
+
+/**
+ * Decode an 8-byte Balsam frame. Returns 1 on success, 0 for another CAN ID,
+ * -1 for invalid arguments and -2 for a Balsam ID with a non-8-byte payload.
+ */
+int balsam_can_decode(uint32_t can_id, const uint8_t *data, size_t size,
+                      balsam_can_frame_t *output);
+
+/** Human-readable Russian name of a Balsam device. */
+const char *balsam_can_device_name(uint8_t device);
+
+/**
+ * Format the register name from the Balsam 167 data table into output.
+ * Returns the required length (excluding NUL); an empty string means unknown.
+ */
+size_t balsam_can_register_name(uint8_t device, uint16_t address,
+                                char *output, size_t output_size);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* BALSAM_CAN_H */

c/set-protocol/include/pcan_abi.h

@@ -45,6 +45,14 @@ typedef struct {
     uint8_t payload[PCAN_ABI_GUI_PAYLOAD_MAX];
 } pcan_abi_gui_frame_t;
 
+typedef struct {
+    uint8_t device;
+    uint8_t direction;
+    uint8_t present_mask;
+    uint16_t start_address;
+    uint16_t values[3];
+} pcan_abi_balsam_frame_t;
+
 PCAN_ABI_API uint32_t pcan_abi_version(void);
 
 PCAN_ABI_API uint32_t pcan_abi_id_pack(uint8_t priority, uint8_t route,
@@ -58,6 +66,13 @@ PCAN_ABI_API void pcan_abi_id_unpack(uint32_t raw, uint8_t *priority,
 
 PCAN_ABI_API uint16_t pcan_abi_crc16(const uint8_t *data, size_t size);
 
+PCAN_ABI_API int pcan_abi_balsam_decode(uint32_t can_id,
+                                        const uint8_t *data, size_t size,
+                                        pcan_abi_balsam_frame_t *output);
+PCAN_ABI_API const char *pcan_abi_balsam_device_name(uint8_t device);
+PCAN_ABI_API size_t pcan_abi_balsam_register_name(
+    uint8_t device, uint16_t address, char *output, size_t output_size);
+
 PCAN_ABI_API size_t pcan_abi_frame_encode(uint8_t sequence, uint8_t flags,
                                           uint32_t can_id,
                                           const uint8_t *data, uint8_t dlc,

c/set-protocol/include/setprotocol.h

@@ -5,6 +5,8 @@
 #ifndef SETPROTOCOL_H
 #define SETPROTOCOL_H
 
+#include "balsam_can.h"
+
 /* Основной SET protocol v2. */
 #include "set_protocol.h"
 #include "set_can.h"