AOVIS ODM 出厂命名规范 v0.1
用途：供 ODM / 工厂准备样机与后续量产设备资料时统一命名使用
目标：所有设备标识从样机阶段开始即保持一致，后续不再二次改名
数据管理说明：
aovis_device_id、serial_number、activation_code的原始明文主表由 AOVIS 内部长期保存，ODM / 工厂仅按执行副本进行烧录、贴标与回填，不得自行修改主数据规则。
1. 总体原则
- 所有命名统一使用英文小写 + 数字 + 连字符
- - 不使用空格、不使用中文、不使用特殊符号
- 不在正式命名中加入
sample、test、demo等阶段性字样 - 一台设备一套固定标识，样机与量产沿用同一规则
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. 序列号要求
字段名统一为：
serial_number
建议规则：
- 每台设备唯一
- 建议固定长度
- 建议使用：型号短码 + 连字符 + 编号
- 不使用空格
- 不使用中文
- 不建议额外添加无明确意义的前缀（例如仅为装饰用途的
SN-）
推荐格式
<model-short>-<number>
示例
N4K-000001
N4K-000002
5. 激活码要求
字段名统一为：
activation_code
要求：
- 每台设备唯一
- 不可重复
- 建议固定 12 位
- 建议使用大写字母 + 数字
- 建议避免易混字符：
O、0、I、1 - 工厂需保留设备与激活码的对应关系表
推荐格式示例
7U246958GVR3
6. SIM 信息要求
如设备带蜂窝通信能力，建议交付：
iccidimei
要求：
- 一台设备对应一条准确记录
- 不允许错配
- 工厂需保留设备、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: N4K-000001
model: NEXA Prime 4K
activation_code: 7U246958GVR3
iccid: 8910300000050270479
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 / 工厂在准备第一台样机时，请先确定：
aovis_device_idserial_numberactivation_codeiccid（如有）imei（如有）
准备好以上信息后，即可进入第一台设备联调。
10. 当前已分配的编号规则（2026-05-13）
为避免样机联调、代码测试、ODM 出厂编号混用，当前先约定如下：
AOVIS 内部代码测试预留号段
aovis-n4k-000001 ~ aovis-n4k-000099
用途：
- AOVIS 内部代码测试
- 云端资源映射测试
- 第一批样机联调预留
其中，第一台测试设备先使用：
aovis-n4k-000001
其当前对应示例为：
serial_number: N4K-000001
activation_code: 7U246958GVR3
iccid: 8910300000050270479
ODM / 工厂正式编号起始
ODM / 工厂请从以下编号开始：
aovis-n4k-000100
后续顺延：
aovis-n4k-000101
aovis-n4k-000102
...
说明
000001 ~ 000099不分配给工厂正式出厂编号- ODM 交付的第一台正式编号设备，应从
aovis-n4k-000100开始 - 后续如型号短码变更，应保持同一规则，不改变编号逻辑
11. 主数据回填与返回要求
ODM / 工厂收到 AOVIS 提供的主数据清单后，应按清单执行并回填实际结果。
AOVIS 提供给 ODM / 工厂的字段
aovis_device_idserial_numberactivation_code
ODM / 工厂应回填返回的字段
iccidimei（如有）firmware_version（如有）- 其他实际装配/烧录结果（如适用）
原则
- ODM / 工厂不得自行生成或修改
activation_code - ODM / 工厂不得自行修改
aovis_device_id iccid应按实际装配的 EIOTCLUB 贴片卡信息回填- 如有不一致，应先返回给 AOVIS 确认，不得自行替换主数据
附录 A：50 台样机主数据清单
说明：
- 第 1 台设备使用已确认的测试卡 ICCID。
- 第 2 台至第 50 台设备的
iccid由 ODM / 工厂在实际装配 EIOTCLUB 贴片卡后回填。aovis_device_id、serial_number、activation_code由 AOVIS 预先分配，不得擅自更改。
| sample_no | aovis_device_id | serial_number | activation_code | iccid | remark |
|---|---|---|---|---|---|
| 01 | aovis-n4k-000001 | N4K-000001 | 7U246958GVR3 | 8910300000050270479 | 首台测试设备，ICCID 已确认 |
| 02 | aovis-n4k-000002 | N4K-000002 | WWHETGUX4AXN | ICCID 由 ODM 按实际贴片卡回填 | |
| 03 | aovis-n4k-000003 | N4K-000003 | SDVU7UTL5RAP | ICCID 由 ODM 按实际贴片卡回填 | |
| 04 | aovis-n4k-000004 | N4K-000004 | PXDKSQE7MA5Z | ICCID 由 ODM 按实际贴片卡回填 | |
| 05 | aovis-n4k-000005 | N4K-000005 | 85DT888LL73V | ICCID 由 ODM 按实际贴片卡回填 | |
| 06 | aovis-n4k-000006 | N4K-000006 | U5XKRKP6NCRR | ICCID 由 ODM 按实际贴片卡回填 | |
| 07 | aovis-n4k-000007 | N4K-000007 | T3SFAWU8XWWE | ICCID 由 ODM 按实际贴片卡回填 | |
| 08 | aovis-n4k-000008 | N4K-000008 | ZKPXN2W8W2YN | ICCID 由 ODM 按实际贴片卡回填 | |
| 09 | aovis-n4k-000009 | N4K-000009 | VZJPK2V52UTP | ICCID 由 ODM 按实际贴片卡回填 | |
| 10 | aovis-n4k-000010 | N4K-000010 | 79WH8AYNJL3V | ICCID 由 ODM 按实际贴片卡回填 | |
| 11 | aovis-n4k-000011 | N4K-000011 | J4C9TW8HUNTR | ICCID 由 ODM 按实际贴片卡回填 | |
| 12 | aovis-n4k-000012 | N4K-000012 | RUX2HWWJC47J | ICCID 由 ODM 按实际贴片卡回填 | |
| 13 | aovis-n4k-000013 | N4K-000013 | RSJQJ8WYNLP5 | ICCID 由 ODM 按实际贴片卡回填 | |
| 14 | aovis-n4k-000014 | N4K-000014 | HU45U4TN63TK | ICCID 由 ODM 按实际贴片卡回填 | |
| 15 | aovis-n4k-000015 | N4K-000015 | 94N2PM88MS7T | ICCID 由 ODM 按实际贴片卡回填 | |
| 16 | aovis-n4k-000016 | N4K-000016 | EJDEL6ZFSN4M | ICCID 由 ODM 按实际贴片卡回填 | |
| 17 | aovis-n4k-000017 | N4K-000017 | WY85NGH4N62U | ICCID 由 ODM 按实际贴片卡回填 | |
| 18 | aovis-n4k-000018 | N4K-000018 | NJJ28V37TTYK | ICCID 由 ODM 按实际贴片卡回填 | |
| 19 | aovis-n4k-000019 | N4K-000019 | 7QDGXXYTLKW8 | ICCID 由 ODM 按实际贴片卡回填 | |
| 20 | aovis-n4k-000020 | N4K-000020 | BZXFW9LPHQCZ | ICCID 由 ODM 按实际贴片卡回填 | |
| 21 | aovis-n4k-000021 | N4K-000021 | 5PW4WHBQEFJE | ICCID 由 ODM 按实际贴片卡回填 | |
| 22 | aovis-n4k-000022 | N4K-000022 | N3B68ZN76HP8 | ICCID 由 ODM 按实际贴片卡回填 | |
| 23 | aovis-n4k-000023 | N4K-000023 | V3KEX7NWKMLW | ICCID 由 ODM 按实际贴片卡回填 | |
| 24 | aovis-n4k-000024 | N4K-000024 | 3G6MDGSSCXD3 | ICCID 由 ODM 按实际贴片卡回填 | |
| 25 | aovis-n4k-000025 | N4K-000025 | BYGTY64EP27M | ICCID 由 ODM 按实际贴片卡回填 | |
| 26 | aovis-n4k-000026 | N4K-000026 | SNYZJYD7SUUX | ICCID 由 ODM 按实际贴片卡回填 | |
| 27 | aovis-n4k-000027 | N4K-000027 | U3FYLZVD2HK4 | ICCID 由 ODM 按实际贴片卡回填 | |
| 28 | aovis-n4k-000028 | N4K-000028 | YXM458CU328V | ICCID 由 ODM 按实际贴片卡回填 | |
| 29 | aovis-n4k-000029 | N4K-000029 | 2RJ298VDMS76 | ICCID 由 ODM 按实际贴片卡回填 | |
| 30 | aovis-n4k-000030 | N4K-000030 | NA5CAW5KTJGB | ICCID 由 ODM 按实际贴片卡回填 | |
| 31 | aovis-n4k-000031 | N4K-000031 | CZZQCS5J5N4D | ICCID 由 ODM 按实际贴片卡回填 | |
| 32 | aovis-n4k-000032 | N4K-000032 | T5RT7BM7X8NK | ICCID 由 ODM 按实际贴片卡回填 | |
| 33 | aovis-n4k-000033 | N4K-000033 | ZN7HLGF554SF | ICCID 由 ODM 按实际贴片卡回填 | |
| 34 | aovis-n4k-000034 | N4K-000034 | NCGAWYMXHKFR | ICCID 由 ODM 按实际贴片卡回填 | |
| 35 | aovis-n4k-000035 | N4K-000035 | ZLPKKM8YEPCD | ICCID 由 ODM 按实际贴片卡回填 | |
| 36 | aovis-n4k-000036 | N4K-000036 | LGF75ZV5ZF2J | ICCID 由 ODM 按实际贴片卡回填 | |
| 37 | aovis-n4k-000037 | N4K-000037 | 2S5DJ8Z6Z8QS | ICCID 由 ODM 按实际贴片卡回填 | |
| 38 | aovis-n4k-000038 | N4K-000038 | YK43VGBJ6H7Z | ICCID 由 ODM 按实际贴片卡回填 | |
| 39 | aovis-n4k-000039 | N4K-000039 | 3RSBRYMZRW3Z | ICCID 由 ODM 按实际贴片卡回填 | |
| 40 | aovis-n4k-000040 | N4K-000040 | MMPESG54RZKJ | ICCID 由 ODM 按实际贴片卡回填 | |
| 41 | aovis-n4k-000041 | N4K-000041 | GSKL6B2D99DH | ICCID 由 ODM 按实际贴片卡回填 | |
| 42 | aovis-n4k-000042 | N4K-000042 | DEEJ8KR5WE7Q | ICCID 由 ODM 按实际贴片卡回填 | |
| 43 | aovis-n4k-000043 | N4K-000043 | FBZBF8PL6NUA | ICCID 由 ODM 按实际贴片卡回填 | |
| 44 | aovis-n4k-000044 | N4K-000044 | E6JQ3UGEF252 | ICCID 由 ODM 按实际贴片卡回填 | |
| 45 | aovis-n4k-000045 | N4K-000045 | YUPNG3GGCD97 | ICCID 由 ODM 按实际贴片卡回填 | |
| 46 | aovis-n4k-000046 | N4K-000046 | CWTQSE3ZMLRH | ICCID 由 ODM 按实际贴片卡回填 | |
| 47 | aovis-n4k-000047 | N4K-000047 | XY2NFMZSLKCH | ICCID 由 ODM 按实际贴片卡回填 | |
| 48 | aovis-n4k-000048 | N4K-000048 | DDU2NDLN8S8H | ICCID 由 ODM 按实际贴片卡回填 | |
| 49 | aovis-n4k-000049 | N4K-000049 | HCEJCDCFNCFU | ICCID 由 ODM 按实际贴片卡回填 | |
| 50 | aovis-n4k-000050 | N4K-000050 | JUWNKNAEF9R6 | ICCID 由 ODM 按实际贴片卡回填 |