Skip to main content

Synairy 产品接入指南

先选择接口，再按对应方式收发报文；CMD 与 PAYLOAD 在所有接口上保持一致。

协议怎样分层​

产品命令经报文封装与接口分帧，通过物理接口传输

参阅产品通用协议、产品业务命令和报文字段。

接收时按相反顺序解析。

从你的接口开始​

UART / RS485 串口接入​

UART、RS485 和 BLE / Wi‑Fi TCP 透传共用字节流长度帧：

原始报文

SEQ + CMD + PAYLOAD + CRC16

字节流发送

AF FA + LEN(2字节小端) + 原始报文

LEN 是原始报文的字节数，最小 4，协议上限 1028；不包含前面的 4 字节帧头和长度。CRC-16/CCITT-FALSE 覆盖 SEQ、CMD、PAYLOAD，按小端放在原始报文末尾。接收时先查找 AF FA，读取 LEN，收齐对应长度的原始报文，再校验 CRC 和解析字段；PAYLOAD 可以包含 00、AF FA，无需转义。错误长度或 CRC 应丢弃并重新寻找帧头；半帧需继续缓存，不能把一次接收回调当成完整报文。响应 PAYLOAD 的第一个字节是 Result。本节定义单设备点对点连接；下方的 UART 多设备和 BLE / Wi‑Fi 透传也沿用此分帧。RS485 多设备共线还需要设备地址与总线收发规则，目前尚未定义。

示例：请求 0x01 Get Info，SEQ = 0x01，空 PAYLOAD

原始报文

01 01 1F 3E

字节流发送

AF FA 04 00 01 01 1F 3E

LEN=4；CRC16=0x3E1F，按小端写成 1F 3E。串口电平、波特率与 RS485 方向控制以型号资料为准。

UART 多设备接入​

适用于带 SEL 引脚的产品。每台设备使用一根独立的选择线；主机一次只选中一台。所有设备仍使用上面的长度帧，各设备的业务命令按对应产品协议执行。无需 ADDR 或切换命令。

项目说明
主机 TX连接所有设备的 RX
主机 RX连接各设备经三态输出后的 TX
主机 GPIO 1…N分别连接设备 1…N 的 SEL
GND主机与所有设备共地；接口须使用兼容的 TTL 电平

SEL 为低电平选中，设备端上拉使其默认不选中。未选中时，设备忽略串口请求，TX 在上电、复位、Boot 和应用运行期间均保持高阻。普通推挽 UART TX 不能直接并联；各设备的 TX 应通过受 SEL 控制、默认关闭的三态输出接到共用返回线。单台使用时可将 SEL 固定在选中电平。

  1. 主机先取消所有选择，再拉低目标设备的 SEL；始终只允许一台处于选中状态。
  2. 按串口帧格式发送请求，等待该设备的最终响应或超时；请求未结束前保持 SEL 有效。
  3. 事务结束后取消选择，再访问下一台。共线接口不使用主动上报或启动日志；需要状态或故障信息时，按对应产品协议主动查询。

支持升级的产品在 Boot 与应用中使用同一组串口和 SEL。升级时保持目标设备被选中：发送 Enter Boot 并收到确认，等待复位，再轮询 Get Info 确认 Mode=BOOT 后执行 OTA；完成后确认 Mode=APP。

如果产品有控制指令超时要求，主机轮流访问设备时仍须满足每台设备各自的更新时间。具体 SEL 引脚、电平和接线以产品型号资料为准。

BLE / Wi‑Fi 透传接入​

支持字节流透传的型号沿用同一套长度帧：AF FA + LEN + SEQ + CMD + PAYLOAD + CRC16。连接建立后发送完整线路帧；接收时持续缓存，先读取帧头与 LEN，再收齐 LEN 指定的原始报文。一次写入、通知或 TCP 读取不必恰好对应一条报文。

项目说明
BLE 透传主机向设备的写入特征值发送线路帧；从通知特征值接收响应。线路帧可按实际可写长度拆成多个片段，顺序发送；接收方拼接字节并按帧头与长度收齐。
Wi‑Fi TCP 透传主机与设备建立 TCP 连接，在连接上发送和接收同样的线路帧；不能把一次 TCP 发送或读取当成一条完整报文。

BLE 服务/特征值 UUID、写入方式、协商后的单次写入上限，以及 Wi‑Fi 的连接方式、地址和端口，由具体型号接口资料给出。分块边界不进入 Synairy 报文，SEQ、CRC16 和响应规则保持不变；断线后应丢弃尚未收齐的线路帧，并重新建立连接。这里的 Wi‑Fi 透传专指 TCP 字节流。

CAN / CAN FD 接入​

取得型号的总线速率和请求/响应 CAN ID，用 ISO-TP 收发原始报文；不添加 AF FA + LEN。

具体型号是否支持 CAN、CAN FD 与 CAN 升级，以及实际 ID 和速率，以对应产品接口资料为准。

查阅命令定义​

具体接口电平、波特率、接线和设备型号配置，以对应产品的接口资料为准。