## 设备接入选择路径

<div class="doc-path">

1. 通用直连设备，优先看 [MQTT 协议设备接入](https://www.fastbee.cn/doc/business/v2/link/mqtt.html)。
2. 工业采集、传感器、仪表类设备，按现场链路选择 [Modbus RTU](https://www.fastbee.cn/doc/business/v2/link/modbus.html) 或 [Modbus TCP](https://www.fastbee.cn/doc/business/v2/link/modbus-tcp.html)。
3. 已有私有协议设备，可查看 [TCP 接入](https://www.fastbee.cn/doc/business/v2/link/tcp.html)、[HTTP 接入](https://www.fastbee.cn/doc/business/v2/link/http.html)、[CoAP 接入](https://www.fastbee.cn/doc/business/v2/link/coap.html) 或 [JT808 设备接入](https://www.fastbee.cn/doc/business/v2/link/jt808.html)。
4. 一个网关管理多个设备时，重点阅读 [网关与子设备](https://www.fastbee.cn/doc/business/v2/link/sub-device.html)。
5. 设备不上线、数据不上报、指令不下发时，按 [设备接入排错清单](https://www.fastbee.cn/doc/business/v2/link/access-troubleshooting.html) 逐项检查。

</div>

## 协议支持与版本矩阵

下表汇总 FastBee 当前 **v2 稳定版**的公开接入能力。社区版、专业版与集群版的授权和功能边界以[商用授权](https://www.fastbee.cn/doc/sponsor.md)为准；集群版与专业版功能相同，主要差异在设备容量、部署形态与高可用运维投入。

| 协议或能力 | 社区版 v2 | 专业版 v2 | 集群版 v2 | 适用场景与接入前提 |
| --- | :---: | :---: | :---: | --- |
| MQTT | 支持 | 支持 | 支持 | 设备直连、属性上报与指令下发；需核对设备认证、产品 ID、主题与 payload，详见 [MQTT 接入](https://www.fastbee.cn/doc/business/v2/link/mqtt.html) |
| GB/T 28181 | 支持视频直播 | 支持 | 支持 | 摄像头、NVR 与视频流；需验证编码、网络、带宽和播放链路，录像管理等扩展能力按版本核对 |
| TCP、UDP、CoAP、HTTP | 不包含 | 支持 | 支持 | 私有协议、低功耗或低频上报设备；需明确帧结构、心跳、应答、拆包粘包或请求响应语义 |
| Modbus RTU / TCP | 不包含 | 支持 | 支持 | PLC、仪表、传感器与工业网关；需配置串口或 TCP 链路、寄存器、数据类型、字节序和轮询任务 |
| JT808 | 不包含 | 支持 | 支持 | 车载终端注册、鉴权、定位、报警和平台下发；需按终端型号验证协议版本与报文字段 |

**协议名称出现不代表设备可以零配置接入。** 设备能否上线取决于产品版本、设备实现、网络、认证和报文映射；选购或实施前，应使用真实设备完成上下行联调与 POC，而不是只核对协议名称。

## 版本适用性与选型边界

* **v2 稳定版**：本页矩阵的适用范围。历史版本是否包含某项能力，应同时核对对应[发布说明](https://www.fastbee.cn/doc/release-notes.md)与实际代码，不把当前矩阵反向套用到旧版本。
* **v3 预览**：属于下一版本预览，内容和协议边界可能调整，不作为当前采购或长期实施承诺。
* **社区版**：采用 Apache-2.0 协议，适合学习、验证以及以 MQTT 和国标视频直播为主的商业或非商业项目；使用时需遵守协议并保留版权与许可声明。
* **专业版**：闭源软件，需获取商业授权；适合需要 TCP、UDP、CoAP、HTTP、Modbus、JT808 等更多接入方式，以及数据桥接、告警、工单和 OTA 等运营能力的商业项目。
* **集群版**：闭源软件，需获取商业授权；适合在专业版能力之上还需要横向扩容和高可用的项目，是否采用集群应由真实连接数、消息频率、存储周期和故障演练结果决定。

### 不适用场景

* 完全没有部署、联调和运维资源，希望获得全托管、按量付费且无需技术投入的服务。
* 设备协议或业务模型与现有能力差异较大，却不愿承担定制开发、适配和验收成本。
* 未核对版本和授权范围，仅依据第三方文章、历史报价或协议名称做采购决定。

## 常见任务入口

<div class="doc-link-grid">
  <a class="doc-link-card" href="./mqtt.html"><strong>MQTT 接入</strong><span>认证格式、主题定义、属性上报、功能下发和 OTA 主题。</span></a>
  <a class="doc-link-card" href="./modbus.html"><strong>Modbus RTU 接入</strong><span>串口设备采集、寄存器解析和轮询任务配置。</span></a>
  <a class="doc-link-card" href="./modbus-tcp.html"><strong>Modbus TCP 接入</strong><span>工业网关、PLC、采集器等 TCP 场景接入。</span></a>
  <a class="doc-link-card" href="./sub-device.html"><strong>网关与子设备</strong><span>配置子产品、子设备地址、网关采集和数据归属。</span></a>
  <a class="doc-link-card" href="./jt808.html"><strong>JT808 接入</strong><span>车载终端注册、鉴权、定位、报警和平台下发。</span></a>
  <a class="doc-link-card" href="./video.html"><strong>视频设备接入</strong><span>按 GB28181 接入摄像头、NVR 和视频流能力。</span></a>
  <a class="doc-link-card" href="./access-troubleshooting.html"><strong>接入排错清单</strong><span>按产品、设备、网络、认证、报文、日志顺序定位问题。</span></a>
  <a class="doc-link-card" href="../manual/product.html"><strong>配置产品模型</strong><span>设备接入前先完成产品、协议、物模型和发布状态。</span></a>
</div>
