AI语音智能体开发日记（一）如何为“小智”服务器启用并调试 License 功能

开发笔记：如何为“小智”服务器启用并调试 License 功能

在嵌入式开发中，集成第三方服务（如“小智”语音助手）时，License 授权验证是绕不开的一环。最近在处理 某芯片AI语音智能体项目时，我整理了一下的 License 功能开启、调试及恢复流程。

这篇博客将详细记录从修改 CMake 配置、编写代码逻辑，到通过串口工具获取和写入密钥的全过程，希望能帮助遇到同样问题的开发者。

1. 项目配置：指定服务器与开启宏定义

首先，我们需要在编译配置中明确指定服务器实现为“小智”，并打开 License 相关的功能开关。

第一步：修改 CMakeLists.txt
打开项目根目录下的 CMakeLists.txt 文件，找到服务器实现的配置部分。我们需要将 SERVER_IMPL 设置为 xiaozhi。

1# 选择服务器实现
2set(SERVER_IMPL xiaozhi)

注意：确保注释掉其他服务器（如 qiniu）的配置，以免冲突。

第二步：开启 License 宏
在 project/ln_model_public/app/common.h 文件中，我们需要定义 License 相关的宏。将 CONFIG_LICENSE_ENABLE 的值设为 1。

1// common.h
2#define CONFIG_LICENSE_ENABLE (1)
3#define CONFIG_LICENSE_ERASE  (0)
4#define CONFIG_OTA_ENABLE     (0)

2. 代码逻辑：植入检查与条件编译

配置修改完成后，我们需要在应用代码中植入检查逻辑，并确保“小智”特有的接口被正确调用。

在 usr_app.c 中启动检查
在用户应用任务创建函数 creat_usr_app_task 中，加入 License 检查代码。如果检查失败，程序应直接返回，阻止后续运行。

1// usr_app.c
2void creat_usr_app_task(void)
3{
4    // ... 其他初始化代码 ...
5
6    #if defined(CONFIG_LICENSE_ENABLE) && CONFIG_LICENSE_ENABLE
7    // 启动 License 检查，如果返回 false 则终止
8    if (!cli_license_check()) return;
9    #endif
10
11    // ... 后续业务逻辑 ...
12}

在 server_interface.h 中适配接口
为了让编译器识别 cli_license_check 函数，我们需要在 server_interface.h 中添加条件编译。只有当定义了 CONFIG_SERVER_IMPL_XIAOZHI 时，才声明该函数，否则提供一个空的 inline 实现以避免编译错误。

3. 调试阶段：绕过验证进入写入模式

这是最关键的一步。为了能够向设备写入新的序列号（Serial Num）和密钥（License Key），我们需要暂时“欺骗”系统，让它认为当前的 License 是无效的，从而进入激活/写入模式。

修改 cli_license.c
打开 project/ln_model_public/app/servers/xiaozhi/cli_license.c。找到 cli_license_check 函数，注释掉 is_license_key_valid() 的判断逻辑。

将这句license_key判断注释掉，否则无法进入小智的串码写入模式

4. 硬件调试：读取 MAC 与 写入密钥

代码编译下载后，我们需要通过串口调试助手（如 SSCOM）与设备交互。

步骤 A：确认进入激活模式
使用 921600 波特率打开串口。如果看到如下日志，说明我们成功绕过了验证，进入了激活等待状态：

[cli_license_check:441] license key is invalid, start to activate
[ate_cli_thr_entry:373] start

步骤 B：获取设备信息
将波特率切换为 1000000（下载口波特率），发送查询指令：

• 查询 MAC 地址：发送 AT+MAC=?
  • 返回示例：+MAC:00:50:19:81:c9:bb
• 查询当前密钥状态：发送 AT+SER_KEY=?
  • 此时会返回设备当前的 SER_NUM 和 LIC_KEY（如果是新设备可能是默认值或空）。

步骤 C：生成并写入新的 License
如果你还没有对接官方的商务流程，可以使用官方提供的测试链接生成临时密钥：

• 测试生成地址：https://xiaozhi.me/api/developers/generate-license... (需替换 token)

• 写入指令格式：

  AT+SER_KEY="设备序列号","授权密钥"

• 实际示例：

  举例：00:50:3b:66:d4:aA：

  AT+SER_KEY="LN882H_AI_BOX_1_03522700A30980BF","7PMBsN2WugX6QdHfUhWKWaykEoQgUQ3W"

发送指令后，若返回 OK，则说明写入成功。

5. 最终发布：恢复代码保护

调试完成后，千万不要直接发布当前的代码！必须回到 cli_license.c，将第 3 步中注释掉的 is_license_key_valid() 判断恢复。

1// 恢复后的代码
2if (is_license_key_valid()) return -1;

这样，设备在下次启动时就会严格执行 License 校验，确保产品的安全性。