JT808设备接入

页面导读

适用场景适合车载终端、定位终端、主动安全设备等按 JT/T 808 协议接入平台的场景。

前置条件已部署支持 JT808 的后端版本，已创建产品并选择对应通讯/传输协议。

验收点终端注册成功、鉴权成功、定位数据入库，平台能查看设备状态和位置数据。

二开重点关注协议编解码、终端手机号/设备编号映射、报警事件、位置数据和平台下发指令。

一、接入流程

二、产品配置

平台菜单：

设备管理 > 产品管理

建议配置：

字段	建议值	说明
设备类型	直连设备	JT808 终端通常直接连接平台
传输协议	TCP 或 JT808 对应传输协议	以实际版本下拉选项为准
通讯协议	JT808 协议	用于解析注册、鉴权、定位和报警
认证方式	按项目配置选择	可结合终端手机号、设备编号、鉴权码
定位方式	设备定位	由终端主动上报经纬度
设备授权	按项目安全要求选择	批量终端建议规划授权策略

产品保存后，进入产品详情查看产品编号、认证信息和协议配置。配置完成后发布产品。

三、设备编号规划

JT808 终端通常有终端手机号、终端 ID、车牌号、设备序列号等标识。建议在项目开始前统一映射关系。

标识	来源	建议用途
终端手机号	JT808 报文头	可作为设备编号或设备唯一标识
终端 ID	设备厂商资料	可作为扩展字段或设备编号
车牌号	车辆资料	作为设备名称或业务扩展信息
鉴权码	注册应答或平台分配	用于终端鉴权
SIM 卡 ICCID	物联网卡资料	可关联物联网卡管理

注意

设备编号一旦进入业务数据链路，不建议频繁修改。若必须修改，需要同步处理历史数据、规则、告警、工单和可视化页面的关联关系。

四、终端注册与鉴权

典型链路：

1. 终端连接平台 TCP 地址和端口。
2. 终端发送注册消息。
3. 平台根据产品、设备编号、终端手机号等信息创建或匹配设备。
4. 平台返回注册应答和鉴权码。
5. 终端发送鉴权消息。
6. 平台鉴权通过后绑定在线会话。

排查重点：

• TCP 端口是否开放。
• 终端上报的手机号或设备 ID 是否符合平台设备编号规则。
• 产品是否发布。
• 终端注册和鉴权是否使用同一设备标识。
• 平台返回的鉴权码是否被终端保存并用于后续鉴权。

五、定位与报警上报

定位数据应映射到平台设备运行状态、历史数据或位置相关字段。

数据	用途	平台侧建议
经度/纬度	地图展示、轨迹分析	作为设备定位数据入库
速度	车辆状态	建立物模型属性
方向	轨迹方向	建立物模型属性
海拔	特殊场景分析	按项目需要配置
报警标志	超速、疲劳驾驶、异常状态	建立事件或告警规则
状态位	ACC、定位、油路、电路	建立属性或事件

建议把高频定位数据和普通运行数据分开设计，避免无关字段造成存储和查询压力。

六、平台下发

常见下发能力包括：

• 参数设置。
• 文本下发。
• 终端控制。
• 位置信息查询。
• 车辆控制指令。
• 平台通用应答。

二次开发时需要明确：

1. 前端下发入口在哪里展示。
2. 后端指令如何封装为 JT808 报文。
3. 指令是否需要等待终端应答。
4. 应答结果如何回写设备日志。
5. 失败或超时如何提示用户。

七、常见问题

终端连接不上

优先检查 TCP 端口、防火墙、安全组、终端 APN、服务器地址、端口和网络制式。

注册成功但鉴权失败

检查平台返回的鉴权码是否被终端正确保存，终端鉴权报文中的设备标识是否与注册阶段一致。

设备在线但地图不显示

检查定位消息是否解析出经纬度，坐标系是否需要转换，产品定位方式是否为设备定位。

报警没有触发

检查报警位是否映射为物模型事件或告警规则，规则是否启用，设备数据是否进入平台。

八、二次开发入口

类型	路径或模块	说明
协议服务	springboot/fastbee-protocol	JT808 编解码、消息模型和协议适配
TCP 服务	springboot/fastbee-server	TCP 连接、会话、报文收发
设备接口	springboot/fastbee-open-api	设备、产品、日志、运行状态接口
前端设备页面	vue3/src/views/iot/device	设备详情和运行状态展示
前端产品页面	vue3/src/views/iot/product	产品协议和物模型配置

九、关联文档

• TCP 设备接入
• 产品到设备的完整闭环
• 产品管理
• 设备管理
• 平台主题