¶ CSK离线license授权操作指导
¶ 概述
算法与芯片相结合，构成聆思的核心竞争力。为了有效管控离线AI及其他算法能力，聆思提供了离线算法能力的license授权方案，该方案通过授权工具对CSK设备烧写授权信息，只有在CSK设备端成功验证授权信息后，设备方可正常使用对应AI算法能力。本文旨在提供聆思芯片离线license授权的操作指南，以供客户开发或产线实施离线license烧录时参考。
¶ 离线license授权流程
离线license授权链路由三个部分组成：
- 聆思云端
授权管理平台负责用户权限管理，项目授权管理，项目授权查询，提供授权接口等管理能力，由聆思维护和管理。 - 授权工具
主要负责连接设备与云端授权服务，考虑到产线存在网络、环境、产测主机等方面的差异性，本方案我们采用的 安卓手机来作为产线授权工具的载体，开发对应的 Android 应用，来实现产线上的授权。 - 搭载CSK芯片的设备
搭载聆思离线AI能力或SDK的CSK芯片，都需要完成授权操作后才能正常使用。
¶ 手机端APP离线license授权方案流程图：
¶ 手机端APP操作流程：
sequenceDiagram
autonumber
participant csk
participant app
participant cloud
app->>app: 设置项目信息
Note over app: 1. 项目ID、Key<br>2. 授权信息的烧录地址<br>3. 服务地址(可选)
app->>app: 启动设备监听
loop 监听设备，自动烧录
csk->>csk: 放置到治具，进入烧录模式
csk->>app: 启动烧录通信
activate app
app->>app: 发现设备
app->>csk: 获取 chip ID
csk->>app: 返回 chip ID
app->>cloud: 获取授权信息<br>(项目ID、key、chip ID)
cloud->>app: 返回授权信息
app->>csk: 烧录[授权信息]
app->>csk: 校验烧录数据
app->>app: 烧录成功，继续监听新设备
deactivate app
csk->>csk: 从治具取出
end
¶ 离线license授权操作
¶ 离线license授权操作示例
该示例为开发阶段CSK设备离线license授权信息烧录示例，产线烧录是一样的原理，治具和接线方式有所不同，请根据实际情况进行设计和操作实施。
¶ 烧录工具硬件环境搭建
¶ 安卓手机
- type-c 接口
- Android8.0以上版本
¶ Type-C接口的USB HUB
- 使用Type-C接口的USB HUB，可以支持多个CSK硬件设备的烧录
¶ USB串口小板
- 带DRT和RTS引脚
¶ 接线示意图
¶ 安卓手机端APP安装
- Android手机授权APK下载
- 完成apk的安装，并确保手机可以访问网络。
¶ 获取APP登录授权码
在安装完APK后，您需向聆思申请APP登录授权码。该授权码由聆思提供，聆思云端根据设备所需的离线AI能力及其他算法能力组合生成，每个项目仅存在一个有效授权码，请妥善保管。
请联系聆思首席FAE(xqqin@listenai.com)，并提供以下信息申请开通授权码
客户名称：(已签NDA客户)
离线能力：(例如XTTS V1.0)
¶ 授权操作步骤
¶ 步骤一：搭建环境
按照烧录工具硬件环境搭建和安卓手机端APP安装指导完成环境搭建。
¶ 步骤二：输入授权码
¶ 步骤三：识别串口
¶ 步骤三：点击烧录
¶ 步骤四：完成烧录
离线license授权信息烧录完成后，设备端可测试对应AI能力是否可用。
¶ 常见问题及解决办法
¶ 手机端无法识别串口设备
解决建议：
- 检查串口是否已经插入USB HUB
- 检查串口小板与CSK的接线是否正确
- CSK硬件设备是否已经供电
- CSK硬件设备是否能正常进入烧录模式
¶ 完成授权后本地AI能力仍然不可用
解决建议：
- 提供本地AI能力组合给聆思确认与云端开放的能力是否匹配
- CSK固件端flash分区是否有修改，授权信息读取分区是否被修改
如遇到问题通过自查方法无法解决问题，请联系聆思首席FAE(xqqin@listenai.com)
¶ 授权工具请求接口
在离线license授权方案中，聆思提供了手机端烧录APP作为授权信息的烧录工具，针对部分客户通过网页端或者其他方式完成CSK芯片授权信息写入的需求，我们提供了聆思云端授权请求的接口，客户可根据实际场景调用
¶ SERVER URL
HOST:
https://api.iflyos.cn
¶ 请求headers
请求headers
Authorization: Bearer {key}
Content-Type: application/json
参数解释
| 参数名 | 说明 | 必填 | 示例 |
|---|---|---|---|
| key | 用户密码，对应客户名和能力组合列表 | 是 | "xxxxxxxx" |
注意：key请厂商注意保密保存，如泄漏或者需找回，请联系聆思首席FAE(xqqin@listenai.com)
¶ chip授权
POST /external/ls_license/app/authorization
请求参数
| 参数名 | 说明 | 必填 | 示例 |
|---|---|---|---|
| chip_id | 芯片ID | 是 | "xxxxxxxx" |
响应示例
{
"data": "OCR4;>>oD3vHS1kG0Con....qtJ+f/TIhA==\r\n\u0000",
"feature_list": "OCR4;",
"signature": "oD3vHS.....WLNTUxqUhEcb6XAqeiATzi+xTN6/VK7ow0MTdTXNSd++y+MapjV5ezHw9e3gY9MNgPfqtJ+f/TIhA=="
}
| 参数名 | 说明 |
|---|---|
| data | 需要经过utf-8编码后烧录到nor flash最后4k地址的数据 |
| feature_list | 授权能力列表 |
¶ 校验chip是否授权
POST /external/ls_license/app/check
请求参数
| 参数名 | 说明 | 必填 | 示例 |
|---|---|---|---|
| chip_id | 芯片ID | 是 | "xxxxxxxx" |
{
"auth": true,
"inserted_at": "2023-05-26T10:08:35Z"
}