一码搞定设备绑定！ThingsCloud 设备二维码使用全攻略

在物联网设备管理中，如何让用户快速、便捷地将设备添加到自己的账号下，是每个设备厂商必须面对的挑战。如果每次都要用户手动输入复杂的设备信息，不仅用户体验差，还容易出错。设备码正是解决这一痛点的关键利器！

今天，我们就来全面解析 ThingsCloud 平台的设备码功能，帮助您轻松实现设备快速绑定。

📱 什么是设备码和设备二维码？

设备码是 ThingsCloud 平台为每个设备自动生成的唯一8位数字标识，例如：12345678。而设备二维码则是将设备码进行编码后生成的二维码图片。

为什么需要设备码？

• 用户自助添加：用户无需依赖厂商或管理员，可自行将设备添加到自己的 App 账号中。
• 操作简单便捷：扫码即可添加，无需记住复杂的设备信息。
• 防止误绑定：唯一标识确保设备准确绑定到用户账号。
• 适用于各种场景：从消费级智能家电到工业设备管理。

重要说明

• 设备码和设备二维码在设备创建时由平台自动生成，无需手动配置。
• 每个设备的设备码唯一，不会重复。
• 设备码仅在当前项目下有效，其他项目的用户无法通过该设备码添加设备。
• 只有已接入平台的设备才能被用户通过设备码或设备二维码添加。

🔍 如何获取设备码和设备二维码？

1️⃣ 单个设备查看

在控制台中获取设备码非常简单：

1. 进入设备列表，点击要查看的设备。
2. 在设备详情页顶部的设备名称右侧，点击二维码图标。
3. 在弹出的对话框中查看设备码和设备二维码。

您可以下载或截图保存设备二维码，打印后粘贴在物理设备上，方便用户扫码添加。

2️⃣ 批量导出设备码

当您有大量设备需要管理时，ThingsCloud 提供了便捷的批量导出功能：

1. 在控制台的设备列表页面中，点击"导出"按钮。
2. 在导出字段选项中，勾选"设备码"。
3. 点击导出，系统将导出项目中所有设备包含设备码的 Excel 或 CSV 文件。

3️⃣ API 工具集批量生成设备码和二维码

以上方法仅导出数字格式的设备码，如需批量生成设备二维码图片，您可以使用 ThingsCloud API Python 工具集：

# 导出所有设备并生成设备二维码
python main.py export_devices --qrcode

# 导出指定设备类型下的所有设备
python main.py export_devices --type_id=your_type_id

# 导出指定设备组下的所有设备
python main.py export_devices --group_id=your_group_id

工具运行后，会显示导出进度，并在本地生成二维码图片文件。

详细使用方法请参考 ThingsCloud API Python 工具集 文档。

📦 设备码交付方案（量产场景必备）

面对大量设备的量产交付，您需要将设备码或设备二维码以最佳方式提供给用户。以下是四种灵活的交付方案：

方案一：控制台获取并打印二维码

适用场景：工业传感器、控制器等无显示屏设备；网络继电器、RTU、智能插座等小型设备。

优势：

• 适合所有类型的设备，无硬件要求。
• 二维码可以提前准备，生产流程简单。
• 用户扫码即可添加，体验便捷。

实施方法：

1. 设备在量产后上电，在平台完成自动创建。
2. 在控制台批量获取设备二维码。
3. 打印在设备手册或贴在设备外壳上。

方案二：设备带显示屏动态显示设备二维码

适用场景：智能设备（如智能水肥机、智能储物柜等带显示屏的设备）；工业设备（如工业网关、PLC 控制器等带 HMI 屏幕的设备）。

优势：

• 设备出厂时无需预先在平台创建，降低生产环节的复杂度。
• 设备码动态生成，安全性更高。
• 适合设备数量大、批次多的量产场景。

实施步骤：

1. 设备上电后，使用设备的唯一 ID 调用动态获取证书 API，完成设备自动创建。
2. 设备上报属性或事件，触发平台的消息规则。
3. 在消息规则的云函数中读取设备码，通过属性下发给设备端。
4. 设备接收到设备码后，在屏幕上显示数字或生成二维码。
5. 用户扫码或输入设备码添加设备。

方案三：使用设备自定义设备码

适用场景：4G/5G DTU、通信模组（机身标注IMEI）；工业传感器（无显示屏，机身印有SN编号）；GPS定位追踪器；NB-IoT设备。

优势：

• 设备出厂时无需提前在平台创建，无需接入测试。
• 用户可以直接使用设备机身上印刷的 IMEI、SN 等标识添加设备。
• 简化生产流程，降低生产成本。

注意：该方案仅适用于企业版项目，需要设备自行确保 ID 不重复。

方案四：WiFi设备使用热点配网方式

适用场景：使用 ESP32/ESP8266 芯片的智能设备（例如：智能插座、智能灯、智能开关等）。

优势：

• 用户体验佳，一键配网即可完成设备添加。
• 无需在设备上印刷二维码或设备码，降低生产成本。
• 适合智能家居等面向消费者的场景。

👩‍💻 用户如何添加设备？

方式一：扫描设备二维码（最快捷）

仅支持：ThingsX 的 iOS App、Android App、微信小程序。

操作步骤：

1. 进入 ThingsX，在设备列表页点击右上角的"+"按钮。
2. 选择"扫一扫"。
3. 将手机摄像头对准设备二维码进行扫描。
4. 扫描成功后，应用会自动识别设备并提示添加，点击"确认"完成添加。

方式二：输入设备码（通用方式）

支持：ThingsX 和 ThingsXS

操作步骤：

1. 在 ThingsX 或 ThingsXS 应用中，进入设备添加功能。
2. 选择"输入设备码"。
3. 在输入框中输入 8 位设备码（纯数字）。
4. 点击"确认"，验证设备码有效性。
5. 验证通过后，点击"添加"完成设备添加。

❓ 常见问题解答

Q1：设备二维码丢失或损坏怎么办？

A：可以通过以下方式获取：

• 在控制台设备详情页重新查看并下载设备二维码
• 使用设备码手动添加设备（无需二维码）

Q2：设备码可以修改吗？

A：设备码由平台自动生成，无法手动修改。但企业版用户可以配置使用设备唯一ID（如IMEI）作为设备码。

Q3：提示"设备不存在"怎么办？

A：请检查：

• 设备是否已在平台上创建
• 输入的设备码是否正确（不包含空格、字母等无关字符）

Q4：我可以在其他项目中使用同一个设备码吗？

A：不可以。设备码与项目绑定，仅在所属项目内有效。如果需要在其他项目中使用设备，需要在该项目中重新创建设备，会生成新的设备码。

💡 结语

设备码是连接用户与设备的桥梁，是提升用户体验的关键环节。通过 ThingsCloud 平台的设备码功能，您可以：

✅ 简化设备绑定流程 - 用户扫码即可完成设备添加 ✅ 降低生产成本 - 无需复杂的手动配置和测试 ✅ 提升用户体验 - 无需繁琐的设备信息输入 ✅ 适应多种场景 - 从工业设备到消费级产品全覆盖

无论您是小型创业公司还是大型设备厂商，都可以利用ThingsCloud的设备码功能，让您的产品更加智能、易用。让用户自助添加设备，解放您的售后人力，提升用户满意度！

想了解更多？立即访问 ThingsCloud官网 或阅读 设备接入指南，开启您的物联网设备管理之旅！