AOVIS ODM 出厂命名规范 v0.1

用途：供 ODM / 工厂准备样机与后续量产设备资料时统一命名使用
目标：所有设备标识从样机阶段开始即保持一致，后续不再二次改名

---

1. 总体原则

1. 所有命名统一使用英文小写 + 数字 + 连字符 -
2. 不使用空格、不使用中文、不使用特殊符号
3. 不在正式命名中加入 sample、test、demo 等阶段性字样
4. 一台设备一套固定标识，样机与量产沿用同一规则

---

2. 设备主标识

设备主标识字段名统一为：

aovis_device_id

这是设备在 AOVIS 系统中的主 ID，后续其他云端资源名称都由它派生。

推荐格式

aovis-<model>-<number>

示例

aovis-n4k-000001
aovis-n4k-000002
aovis-n4k-000003

说明

• aovis：品牌前缀
• n4k：型号短码（示例，可按最终型号确认）
• 000001：设备编号，建议固定长度，便于管理

---

3. 云端资源命名规则

ODM 只需要知道：以下云端资源名称都由 aovis_device_id 自动生成。

3.1 IoT Thing Name

aovis-dev-<aovis_device_id>

示例：

aovis-dev-aovis-n4k-000001

3.2 Video Stream Name

aovis-stream-<aovis_device_id>

示例：

aovis-stream-aovis-n4k-000001

3.3 WebRTC Channel Name

aovis-webrtc-<aovis_device_id>

示例：

aovis-webrtc-aovis-n4k-000001

---

4. 工厂需交付的设备字段

每台设备建议至少交付以下信息：

字段名	是否必需	说明
aovis_device_id	必需	AOVIS 主设备 ID
serial_number	必需	工厂序列号
model	必需	设备型号
activation_code	必需	设备激活码
iccid	强烈建议	SIM / eSIM ICCID
imei	建议	蜂窝模块 IMEI
firmware_version	建议	出厂固件版本
hw_revision	建议	硬件版本
manufacture_date	建议	出厂日期

---

5. 激活码要求

字段名统一为：

activation_code

要求：

• 每台设备唯一
• 不可重复
• 建议使用固定长度英文数字组合
• 工厂需保留设备与激活码的对应关系表

---

6. SIM 信息要求

如设备带蜂窝通信能力，建议交付：

• iccid
• imei

要求：

• 一台设备对应一条准确记录
• 不允许错配
• 工厂需保留设备、SIM、模组信息的对应关系表

---

7. 不建议的命名方式

以下方式不要使用：

不建议 1

sample-device-001
test-camera-01
demo-unit-01

原因：后续正式使用时还要再次改名，容易出错。

不建议 2

aovis_n4k_001

原因：不要使用下划线，统一使用连字符 -。

不建议 3

AOVIS-N4K-1

原因：不要混用大写和不固定编号长度。

---

8. 推荐第一台设备示例

建议第一台设备直接使用正式风格命名，例如：

aovis_device_id: aovis-n4k-000001
serial_number: SN-N4K-000001
model: NEXA Prime 4K
activation_code: <factory-generated>
iccid: <carrier-provided>
imei: <module-provided>

对应的云端派生名称将为：

Thing Name:      aovis-dev-aovis-n4k-000001
Stream Name:     aovis-stream-aovis-n4k-000001
WebRTC Channel:  aovis-webrtc-aovis-n4k-000001

---

9. 当前建议

ODM / 工厂在准备第一台样机时，请先确定：

1. aovis_device_id
2. serial_number
3. activation_code
4. iccid（如有）
5. imei（如有）

准备好以上信息后，即可进入第一台设备联调。

---

10. 当前已分配的编号规则（2026-05-13）

为避免样机联调、代码测试、ODM 出厂编号混用，当前先约定如下：

AOVIS 内部代码测试预留号段

aovis-n4k-000001 ~ aovis-n4k-000099

用途：

• AOVIS 内部代码测试
• 云端资源映射测试
• 第一批样机联调预留

其中，第一台测试设备先使用：

aovis-n4k-000001

ODM / 工厂正式编号起始

ODM / 工厂请从以下编号开始：

aovis-n4k-000100

后续顺延：

aovis-n4k-000101
aovis-n4k-000102
...

说明

• 000001 ~ 000099 不分配给工厂正式出厂编号
• ODM 交付的第一台正式编号设备，应从 aovis-n4k-000100 开始
• 后续如型号短码变更，应保持同一规则，不改变编号逻辑