5.31 SN序列号设备

📚 本节导读

学习时长: 约 20 分钟
难度级别: ⭐⭐☆☆☆
前置知识: C 语言基础、5.1 设备驱动框架、5.17 FAL

🎯 学习目标

• 理解 SN 序列号设备的存储与读取机制
• 掌握通过 FAL 分区管理序列号的方法
• 掌握 Shell 命令 sn 的使用

一、概述

SN（Serial Number，序列号）设备是 OneOS 提供的设备序列号管理工具，通过 FAL 分区将序列号存储在 Flash 中，支持读取、写入、擦除操作。驱动源码位于 drivers/sn/sn_cfg.c。

SN 设备的特点：

• FAL 分区存储：序列号存储在名为 "cfg" 的 FAL 分区中
• Shell 命令：提供 sn read/write/erase Shell 命令
• 设备信息展示：提供 get_device_info 命令显示板卡信息

二、核心配置

#define SN_PARTITION_NAME "cfg"    /* 序列号存储分区名 */
#define SN_ADDR_OFFSET    0        /* 分区内偏移地址 */
#define SN_LENGTH         20       /* 序列号长度 */

三、Shell 命令

3.1 sn 命令

sn read                    # 读取序列号
sn write <20位序列号>       # 写入序列号
sn erase                   # 擦除序列号

3.2 get_device_info 命令

get_device_info            # 显示设备信息（型号、版本、板卡号等）

四、使用示例

/* 在 Shell 中执行:
 * sn write 12345678901234567890    # 写入序列号
 * sn read                          # 读取序列号
 * get_device_info                  # 显示设备信息
 */

📝 本节小结

本节介绍了 SN 序列号设备，包括 FAL 分区存储、Shell 命令交互、设备信息展示等。

🔗 相关链接

• 5.17 FAL Flash抽象层