第五步介绍AG SDK结构和如何开发自有应用程序。

1. 概述

AG SDK介绍请查阅相关页面。本文主要指导在从芯片原厂授权服务商和阿里获取到代码后，如何创建代码工程。

代码主要托管到 阿里云云效代码管理 Codeup , 以下是一些您可能感兴趣的链接：

代码托管官网：https://codeup.aliyun.com 快速开始：https://help.aliyun.com/document_detail/153705.html 快速开始-创建第一个代码库：https://help.aliyun.com/document_detail/153707.html 快速开始-提交第一行代码：https://help.aliyun.com/document_detail/153708.html 操作指南：https://help.aliyun.com/document_detail/153718.html 操作指南-邀请成员协作：https://help.aliyun.com/document_detail/153719.html 操作指南-代码组：https://help.aliyun.com/document_detail/153720.html 操作指南-代码评审-合并请求：https://help.aliyun.com/document_detail/153872.html Git教学：https://help.aliyun.com/document_detail/153799.html

2. 代码结构

整个工程代码分为三部分，BSP + 阿里仓库 + 您的代码。BSP 的代码由芯片原厂授权服务商提供，最新版本的阿里核心能力库从阿里获取。

2.1 目录说明

本方案的代码工程目前是放在同一个代码仓库里的，不同模块的代码通过目录来区分。以下表格描述了涉及的仓库、主要功能模块以及技术支持方等信息。

仓库名 clone 目标路径 技术支持 补充信息
bsp ${TOP}/bsp 阿里 BSP+工程文件+阿里核心库+三方二开代码等

主要功能模块

路径 技术支持 补充信息
bsp/solutions/bl606p_e907_demo 阿里+博流 工程文件
bsp/components 博流 BSP（组件）
bsp/components/aligenieSDK_e907
bsp/components/aligenieSDK_c906		 阿里 核心库（c906为算法核应用，不开放二开定制）
bsp/toolchain 博流 BSP(工具链)
bsp/components/thirdparty_app ISV/TSP开发商 三方二次开发代码
bsp/flash_tool 博流 BSP（烧录工具）
bsp/tools 博流 BSP（配套工具）
bsp/其它 博流 BSP

2.2 Demo试跑

本AG SDK提供了demo演示，代码位于bsp/solutions/bl606p_e907_demo/app/app_main.c，通过ag_open_api_demo_init启动相关demo。

  1. static int ag_open_api_demo_init()
  2. {
  3.     ag_play_cmd_init();
  4.     ag_event_cmd_init();
  5.     ag_input_cmd_init();
  6.     ag_os_cmd_init();
  7.     ag_talk_cmd_init();
  8.     ag_gatts_cmd_init();
  9.     ag_bt_cmd_init();
  10.     ag_clock_cmd_init();
  11.     httpclient_cli_register();
  12.     return 0;
  13. }
  15. int main(int argc, char *argv[])
  16. {
  17.     。。。
  19.     //AligenieSDK初始化
  20.     ag_open_api_init();
  22.     //demo初始化
  23.     ag_open_api_demo_init();
  25.     。。。
  26. }

3 添加自定义应用

3.1 应用入口

bsp/solutions/bl606p_e907_demo/目录下为产品应用代码入口，BSP初始化完成后会运行到bsp/solutions/bl606p_e907_demo/app/app_main.c，调用main函数。main函数会依次调用系统相关初始化接口，然后调用AligenieSDK初始化接口，再初始化AligenieSDK Demo，最后拉起二次开发应用逻辑。

  1. static int ag_open_api_demo_init()
  2. {
  3.     ag_play_cmd_init();
  4.     ag_event_cmd_init();
  5.     ag_input_cmd_init();
  6.     ag_os_cmd_init();
  7.     ag_talk_cmd_init();
  8.     ag_gatts_cmd_init();
  9.     ag_bt_cmd_init();
  10.     ag_clock_cmd_init();
  11.     httpclient_cli_register();
  12.     return 0;
  13. }
  15. int main(int argc, char *argv[])
  16. {
  17.     //AligenieSDK初始化
  18.     ag_open_api_init();
  20.     //demo初始化
  21.     ag_open_api_demo_init();
  23.     //二次开发应用入口
  24.     third_party_init();
  26.     aos_loop_run();
  27. }

3.2 二次开发接口约定

为了更方便的构建固件，二次开发的代码逻辑统一使用third_party_init()拉起，所有二次开发逻辑都隐藏到这个api里。third_party_init()参考示例代码位于bsp/components/thirdparty_app/thirdparty_entry.c。

  1. void third_party_init(void);

3.3 thirdparty_app工程约定

目前，该实例工程包含package.yaml test.c test.h thirdparty_entry.c ProdConfInfo.cpp ProdConfInfo.h等主要文件，其中test.为二次开发的示例码，ProdConfInfo.为产品平台配置信息，package.yaml为编译配置脚本，内容如下所示：

  1. name: thirdparty_app
  2. version: v1.0.0
  3. description:  thirdparty app demo
  4. type: common
  6. depends:
  7.   - sdk_chip_bl606p_e907: develop
  8.   - aligenieSDK_e907: v1.0.0
  9.   - ulog: develop
  11. source_file:
  12.   - ./*.c
  13.   - ./*.cpp

其中，
1、name、version、description、type：均保持默认值不要修改。
2、depends：组件依赖关系。依赖的组件加进来之后，代码里即可直接include被依赖组件的头文件了，比如这里依赖了aligenieSDK_e907组件，在bsp/components/thirdparty_app/thirdparty_entry.c里就可以直接#include “ag_open_api.h”，然后调用AligenieSDK的开放API了。
3、source_file：用来配置二次开发涉及的源文件，按需增删即可。

4. 修改产品配置信息

从上一章我们已经知道，thirdparty_app中的ProdConfInfo.为平台上的产品配置信息。如下所示，*我们默认提供的是木星标准模组Pro2（混天绫模组）的产品信息，因此本地默认构建出来的固件，是需要使用木星标准模组Pro2以及基于木星标准模组Pro2创建产品的一机一密才能正常配网的。

  1. #ifndef __PRODCONF_INFO_H__
  2. #define __PRODCONF_INFO_H__
  4. #ifdef __cplusplus
  5. extern "C" {
  6.     #endif
  8.     #define PROD_FIRMWARE_VERSION   "1.0.0-D-00000000.0000"
  9.     #define PROD_BIZ_TYPE       "AILABS"
  10.     #define PROD_BIZ_GROUP      "S710"
  11.     #define PROD_NET_CONFIG_ID  "9Oup"
  12.     #define PROD_DEF_VOLUME     "60"
  13.     #define PROD_MAX_VOLUME     "100"
  14.     #define PROD_MIN_VOLUME     "20"
  16.     /*
  17.     * To make genie be independent static library(.a),
  18.     * move all product information out by calling function outside.
  19.     */
  20.     const char *getProdBizType(void);
  21.     const char *getProdBizGroup(void);
  22.     const char *getProdNetConfigID(void);
  23.     const char *getProdDefVolume(void);
  24.     const char *getProdMaxVolume(void);
  25.     const char *getProdMinVolume(void);
  26.     const char *tg_ota_get_version(void);
  27.     #ifdef PROD_AES1_SECRET
  28.     const char *getProdAes1Secret(void);
  29.     #endif
  30.     #ifdef PROD_AES1_IV
  31.     const char *getProdAes1Iv(void);
  32.     #endif
  33.     #ifdef PROD_AES2_SECRET
  34.     const char *getProdAes2Secret(void);
  35.     #endif
  36.     #ifdef PROD_AES2_IV
  37.     const char *getProdAes2Iv(void);
  38.     #endif
  40.     #ifdef PROD_PUB_KEY
  41.     char *tg_ota_get_pubkey(void);
  42.     #endif
  44.     #ifdef __cplusplus
  45. }
  46. #endif
  48. #endif

从天猫精灵AI平台 的平台构建入口打包固件时，平台会自动将ProdConfInfo.h中默认的木星标准模组Pro2配置信息替换为对应产品的真正配置信息（如BizType、BizGroup、NetConfigId等）。如果需要使用基于语音芯片TG6210A(SDK版)方案创建产品之后生成的三元组配网，本地需要配置ProdConfInfo.h重新编译打包固件才能正常配网。修改方法如下：

4.1 配置版本号

编译脚本会自动基于当前时间生成版本号，并自动更新PROD_FIRMWARE_VERSION的值，无需手动修改（即使修改也会被编译脚本自动覆盖）

4.2 配置BizType、BizGroup

image.png
BizGroup和BizType指的是设备机型，相关信息可以在天猫精灵AI平台的对应产品的开发页面找到，对应修改PROD_BIZ_GROUP和PROD_BIZ_TYPE的值。

4.3 配置蓝牙广播ID

image.png
蓝牙广播ID用于设备配网时APP发现设备，相关信息可以在天猫精灵AI平台的对应产品的开发 - APP配置 - 激活联网信息页面找到，对应修改PROD_NET_CONFIG_ID的值即可。

4.4 配置音量

image.png
目前支持配置默认音量、最大音量、最小音量，相关信息可以在天猫精灵AI平台的对应产品的开发 - 产品信息 - 开发方案页面找到，对应修改PROD_DEF_VOLUME、PROD_MAX_VOLUME、PROD_MIN_VOLUME的值即可。

4.5 配置加解密秘钥

image.png
解密秘钥用于从三元组Secret Key中解析出设备UUID，加密秘钥用于设备鉴权激活时的签名计算，相关信息可以在天猫精灵AI平台的对应产品的开发 - 产品信息 - 基本信息页面找到，然后在ProdConfInfo.h中新增如下四行：

  1. #define PROD_AES1_SECRET "三元组解密秘钥的密钥"
  2. #define PROD_AES1_IV "三元组解密秘钥的偏移量"
  3. #define PROD_AES2_SECRET "签名加密密钥的秘钥"
  4. #define PROD_AES2_IV "签名加密密钥的偏移量"

:::warning 自行替换为平台上的对应值，加解密秘钥，请注意保密，请勿泄漏！！！ :::

4.6 最终示例

按上述步骤修改完产品配置信息之后，会得到类似如下所示的一个文件，然后本地重新编译固件之后，即可使用新开发方案的三元组进行配网了。

  1. #ifndef __PRODCONF_INFO_H__
  2. #define __PRODCONF_INFO_H__
  4. #ifdef __cplusplus
  5. extern "C" {
  6. #endif
  8. #define PROD_FIRMWARE_VERSION    "1.0.0-D-00000000.0000"
  9. #define PROD_AES1_SECRET "bcb68d82XXXXXXXX"
  10. #define PROD_AES1_IV "2df26bb6XXXXXXXX"
  11. #define PROD_AES2_SECRET "eee0eef4XXXXXXXX"
  12. #define PROD_AES2_IV "ef086606XXXXXXXX"
  13. #define PROD_BIZ_TYPE    "AILABS"
  14. #define PROD_BIZ_GROUP    "TGChip6000A"
  15. #define PROD_NET_CONFIG_ID    "gWHQ"
  16. #define PROD_DEF_VOLUME    "60"
  17. #define PROD_MAX_VOLUME    "100"
  18. #define PROD_MIN_VOLUME    "0"
  20. /*
  21.  * To make genie be independent static library(.a),
  22.  * move all product information out by calling function outside.
  23.  */
  24. const char *getProdBizType(void);
  25. const char *getProdBizGroup(void);
  26. const char *getProdNetConfigID(void);
  27. const char *getProdDefVolume(void);
  28. const char *getProdMaxVolume(void);
  29. const char *getProdMinVolume(void);
  30. const char *tg_ota_get_version(void);
  31. #ifdef PROD_AES1_SECRET
  32. const char *getProdAes1Secret(void);
  33. #endif
  34. #ifdef PROD_AES1_IV
  35. const char *getProdAes1Iv(void);
  36. #endif
  37. #ifdef PROD_AES2_SECRET
  38. const char *getProdAes2Secret(void);
  39. #endif
  40. #ifdef PROD_AES2_IV
  41. const char *getProdAes2Iv(void);
  42. #endif
  44. #ifdef PROD_PUB_KEY
  45. char *tg_ota_get_pubkey(void);
  46. #endif
  48. #ifdef __cplusplus
  49. }
  50. #endif
  52. #endif

4.7 注意事项（必读！！！）

不同开发方案的三元组不通用。所以如果平台上创品时，最开始使用的不是语音芯片TG6210A(SDK版)方案，后来修改为了语音芯片TG6210A(SDK版)方案，那么需要重新生成三元组，设备写入新的一机一密，设备重新配网。