之前的文章已經介紹了VC系列出廠固件的一些基本用法，本期就主要介紹VC系列云知聲SDK 的二次開發環境搭建。

正式搭建開發環境之前，請確認：

有一個Linux 系統，虛擬機或者真機,推薦使用ubuntu
熟悉Linux 系統的基礎指令，“ls”,"cd"之類的
具備Makefile

一、SDK生成

因為產品的語音詞條是要通過平臺訓練生成語音模型和回復語，因此每個產品對應一個SDK，當然，如果是指令一致的產品可以共用一個SDK。為此，我們給各位同學開放了定制SDK的平臺，主要提供：

· 喚醒詞及指令詞定制功能
· GPIO控制功能
· 回復語定制功能

其他功能就需要通過二次開發來實現了，比如指令碼的串口輸出和輸入。這部分的內容會在《安信可語音開放平臺》的使用介紹會做講解。

二、編譯工具鏈下載

1. 依賴工具安裝

如果你使用的Ubuntu 16.04 / centos7以上版本作為開發環境,請使用以下指令：

sudo apt-get install python
sudo apt-get install lame
sudo apt-get install lib32stdc++6 lib32z1 lib32ncurses5 lib32bz2-1.0

對于ubuntu20.04的話，安裝32位兼容庫使用:

sudo apt-get install lib32stdc++6 lib32z1 lib32ncurses5 libbz2-1.0:i386

安裝完成依賴之后，拉取編譯工具鏈：

sudo git clone https://github.com/Ai-Thinker-Open/Andestech.git /opt/Andestech

如果github 太慢了。也可以使用：

sudo git clone https://gitee.com/Ai-Thinker-Open/Andestech.git /opt/Andestech

注意：/opt/Andestech 一定要帶，不然就需要修改SDK中編譯工具的實際路徑

三、SDK下載編譯測試

在云平臺上下載好SDK 之后，將其復制到Linux 當中的某一個文件夾

1.下載解壓

使用以下命令進行解壓：

tar -zxvf uni_hb_m_solution-xxxxx.tar.gz

解壓過程：

SDK 文檔架構：

├── build --------------------------------------> Makefile系統
├── build.sh -----------------------------------> 編譯腳本
├── ci.yml -------------------------------------> 自動化平臺構建腳本，對用戶無用
├── include ------------------------------------> 語音識別引擎及其他自動化生成外部頭文件，不可修改
├── lib ----------------------------------------> 語音識別引擎及其他底層驅動庫
├── middleware ---------------------------------> RTOS系統
├── nds32-ae210p.ld ----------------------------> 鏈接信息腳本，不可修改
├── nds32-ae210p.sag ---------------------------> 內存段分布配置，不可修改
├── readme.txt ---------------------------------> 發布版本信息
├── src ----------------------------------------> 架構代碼文件夾
│ ├── app ------------------------------------> APP層代碼文件夾
│ │ ├── inc
│ │ └── src
│ │ ├── main.c -------------------------> 系統啟動主程序，main函數入口
│ │ ├── sessions -----------------------> sessions代碼文件夾
│ │ │ ├── uni_setting_session.c ------> setting類事件處理session
│ │ │ ├── uni_wakeup_session.c -------> wakeup類事件處理session
│ │ │ └── uni_watchdog_session.c -----> watchdog事件處理session
│ │ ├── uni_record_save.c --------------> 錄音保存功能實現，蜂鳥M暫不支持
│ │ ├── uni_session.c ------------------> 創建釋放session對象
│ │ ├── uni_session_manage.c -----------> 管理session注冊
│ │ └── uni_user_meeting.c -------------> APP層與USER層交互接口
│ ├── hal ------------------------------------> HAL層實現代碼
│ ├── sdk ------------------------------------> SDK層實現代碼
│ │ ├── audio ------------------------------> Audio播放器
│ │ ├── idle_detect ------------------------> 設備空閑計時管理
│ │ ├── player -----------------------------> MP3解碼器
│ │ └── vui --------------------------------> 語音識別功能
│ └── utils ----------------------------------> UTILS層實現代碼
│ ├── arpt -------------------------------> ARPT自動化測試工具
│ ├── auto_string ------------------------> 變長字符串
│ ├── bitmap -----------------------------> 二值狀態變量集合
│ ├── black_board ------------------------> 系統狀態管理
│ ├── cJSON ------------------------------> JSON格式解析
│ ├── config -----------------------------> config.bin文件內容解析
│ ├── crc16 ------------------------------> CRC16算法
│ ├── data_buf ---------------------------> 一個不用互斥鎖管理的Ring Buffer
│ ├── event ------------------------------> 創建事件對象
│ ├── event_list -------------------------> 事件隊列
│ ├── event_route ------------------------> 事件分發
│ ├── float2string -----------------------> 浮點轉字符串，用于無float類型打印能力的printf
│ ├── fsm --------------------------------> 狀態機
│ ├── hash -------------------------------> 一個簡易HASH算法
│ ├── interruptable_sleep ----------------> 非阻塞的sleep方式
│ ├── list -------------------------------> 通用鏈表
│ ├── log --------------------------------> 帶等級控制的LOG輸出接口
│ ├── string -----------------------------> 一套簡易的string操作接口
│ ├── timer ------------------------------> 基于RTOS系統的Timer
│ └── uart -------------------------------> 通用的UART接口
├── startup ------------------------------------> 芯片啟動代碼，不可修改
├── tools --------------------------------------> 自動化構建工具
│ └── scripts --------------------------------> 自動化構建腳本
│ ├── aik_debug.json ---------------------> Debug固件對應的AIK配置文件
│ ├── aik_release.json -------------------> Release固件對應的AIK配置文件
│ ├── asrfix.dat -------------------------> 聲學模型
│ ├── cmd_reply_data.json ----------------> UDP平臺用戶定制命令詞和回復語信息
│ ├── config_debug.bin -------------------> Debug固件對應的應用配置文件
│ ├── config_release.bin -----------------> Release固件對應的應用配置文件
│ ├── custom_config.json -----------------> UDP平臺用戶定制系統配置信息
│ ├── default_tones ----------------------> 默認保底音頻文件文件夾
│ ├── grammar.dat ------------------------> 語法模型
│ ├── grammar_jsgf.zip -------------------> 語法模型對應的構建腳本
│ ├── grammar.zip ------------------------> 語法模型文件壓縮包
│ ├── input.txt --------------------------> 用戶定制回復語列表
│ ├── pcm.bin ----------------------------> MP3音頻flash固件，自動生成的中間文件
│ ├── pcm_map.txt ------------------------> MP3音頻文件名及內容列表
│ ├── res_build_tool.py ------------------> 自動化構建腳本
│ ├── thresh.dat -------------------------> 喚醒詞閾值推薦表
│ ├── tones ------------------------------> MP3音頻文件夾
│ └── wav_tones --------------------------> WAV音頻文件夾，自動轉換到tones
├── uni_ci.yml ---------------------------------> 構建平臺腳本，對用戶無用
└── user ---------------------------------------> USER層實現代碼
├── inc
│ ├── unione.h ---------------------------> USER層使用的底層頭文件
│ ├── user_config.h ----------------------> USER可配置項，包括串口、音量等
└── src
├── examples ---------------------------> 包含個別USER模塊的示例代碼
├── user_asr.c -------------------------> 語音識別控制接口
├── user_event.c -----------------------> USER事件分發機制，底層調用USER注冊的事件回調函數
├── user_file.c ------------------------> SD卡文件系統操作接口，蜂鳥M暫不支持
├── user_flash.c -----------------------> Flash操作接口
├── user_gpio.c ------------------------> GPIO操作接口
├── user_main.c ------------------------> 用戶代碼入口，參考示例實現user_main()接口以增加業務邏輯
├── user_player.c ----------------------> 音頻播放控制接口
├── user_power.c -----------------------> 功耗操作接口，蜂鳥M暫不支持
├── user_pwm.c -------------------------> PWM操作接口
├── user_record.c ----------------------> 錄音控制接口，蜂鳥M暫不支持
├── user_timer.c -----------------------> Timer操作接口
├── user_uart.c ------------------------> UART操作接口
└── user_uni_ucp.c ---------------------> 通用串口協議操作接口

2. 編譯例程

編譯的例程可以在user/inc/user_config.h的USER_RUN_DEMO_SELECT配置成想要的Demo，比如配置成GPIO 操作的：

編譯指令一共有兩種：

. /build.sh: 這個指令會編譯輸出uni_app_release.bin文件，這個文件只能用JTAG調試器進行燒錄
. /build.sh update: 這個指令會編譯輸出uni_app_release_update.bin和uni_app_release.bin

uni_app_release_update.bin 是串口升級專用文件

uni_app_release.bin 是JTAG方式升級使用的文件。

備注：python 的版本是python2

四、更多資料

安信可語音開放平臺：http://voice.ai-thinker.com

官方官網：https://www.ai-thinker.com

開發DOCS：https://docs.ai-thinker.com

技術支持：support@aithinker.com

審核編輯 黃宇