创建设备

设备要先在平台"建档"，才能接入并上报数据。本章介绍如何新建设备、填写哪些信息，以及创建完成后需要做什么。

操作角色：租户管理员。客户用户只能查看已分配给自己的设备，没有新建入口。

一、操作入口

登录平台后，在左侧菜单进入 设备运维 → 设备台账，点击页面右上角的 新建设备，右侧会滑出新建表单。

如果要给某个网关挂子设备，也可以在该网关的设备详情页直接点"新增子设备"，此时"所属网关"已自动固定为该网关。

二、填写设备信息

字段	是否必填	说明
设备名称	必填	便于识别的名字，如"1 号车间温控器"。用于列表展示和后续查找
设备类型	必填	二选一：普通设备（直接接入或作为网关的子设备）；网关设备（可挂载多台子设备）
所属网关	选填	仅普通设备可见。不选＝设备自行直连平台；选了＝本设备成为该网关的子设备，通过网关上报数据
外部 ID	子设备必填	设备在边缘侧上报时使用的 ID。子设备必须填写，且同一网关下不可重复；直连设备可留空

填写要点：

• 设备类型选错影响接入方式：网关负责汇聚数据，其下的子设备不需要自己连平台；普通设备若挂了网关，就不能再自行直连。
• 外部 ID 要与设备端一致：它是平台识别子设备的依据，写错会导致数据对不上。若只能选填（直连设备），留空后由平台用设备令牌识别设备。

填好后点 确定，设备即创建完成。

三、创建完成后：保存好 Access Token

创建成功后会弹出提示框，显示设备的 Access Token（访问令牌）。这是设备接入平台的唯一凭证——部署设备时，需要把该令牌配置到设备端，设备凭它连上平台并上报数据。

注意事项：

1. 令牌等同设备身份：拿到令牌就等于拿到该设备的身份，请勿外传、不要写在公开的代码或文档里。
2. 令牌可以稍后查看：关闭弹窗没关系，在设备详情页 → 设备信息里可以随时再次查看。
3. 一台设备一个令牌：不要多台设备共用同一令牌，否则数据会混在一起。

四、设备已创建，但为什么显示离线？

新建设备只是完成建档，设备端还没连上来，因此刚创建时状态为离线，属于正常现象。等设备端配置好令牌并成功接入后：

• 列表的 状态 列变为在线；
• 最后活跃 列会显示设备最近一次上报数据的时间。

状态为在线、最后活跃时间持续更新，说明设备接入和数据上报都正常。若长时间未见变化，请检查设备端令牌是否填写正确、网络是否可达。

五、创建设备后还能做什么

在设备台账的操作列，租户管理员还可以：

• 查看详情：设备信息、令牌、实时数据与历史数据
• 编辑设备：修改名称、外部 ID、网关归属等
• 分配客户：把设备分配给某个客户，客户用户登录后即可看到该设备
• 下发指令：向在线设备下发指令，用于远程控制或参数设置
• 删除设备：删除后该设备的连接会随之断开，请谨慎操作

---

下一步：把令牌配置到设备端并开始上报数据，请参考《直连设备上报数据》。