概述
A2SA是Advanced AliOS Things Sound Architecture的縮寫，是AliOS Things音頻系統服務框架，包括音頻驅動層、音頻服務接口層以及音頻插件管理等。部分設計理念借鑒了Linux ALSA的設計思路，例如在設備驅動層支持VFS設備驅動掛載訪問、支持多聲卡管理、PCM/Control音頻物模型、對音頻Codec友好抽象等。在音頻服務接口層兼容Linux ALSA-Lib的API接口規范,方便基于ALSA-Lib開發的應用組件移植到AliOS Things。同時A2SA的footprint也足夠小（23KB），適合在嵌入式IoT設備上移植。 組件支持以下功能：
最大程度兼容Linux ALSA-Lib API規范，方便Linux應用生態移植到AliOS Things。
支持多聲卡模式（藍牙聲卡，I2S聲卡等）
驅動掛載VFS，支持open/ read/ write等操作接口。
精簡的Audio Codec驅動接口抽象（共11個API），可以方便的對接不同Codec HAL驅動。
兼容Linux ALSA音頻驅動的適配正在開發中。
版權信息
Apache license v2.0
目錄結構
.
│ ├── driver # 音頻驅動框架
│ │ ├── core # 音頻驅動框架Core
│ │ └── platform # 不同平臺音頻驅動硬件抽象層
│ │ ├── Linux # Linux平臺音頻驅動硬件抽象層，開發中，后續發布。
│ │ └── RTOS # RTOS平臺音頻驅動硬件抽象層，共11個API抽象，支持低功耗管理。
│ └── framework # 音頻服務接口API
│ ├── sound_mixer.c # 聲卡mixer設備驅動的實現
│ └── sound_pcm.c # 聲卡pcm設備驅動的實現
├── include
│ ├── sound_mixer.h # 聲卡mixer設備驅動，例如設置codec參數，音量等。
│ └── sound_pcm.h # 聲卡pcm設備驅動，例如錄音、播放等。
├── internal # 內部頭文件
├── package.yaml # 編譯配置文件
└── example
├── sound_example.c # a2sa示例代碼
├── sound_example_lb.c # loopback測試代碼
├── sound_example_vol.c # volume測試代碼
└── sound_example_wav.c # wav播放器測試代碼依賴組件
rhino
vfs
ulog
posix
常用配置
系統中相關配置已有默認值，如需修改配置，統一在該組件的package.yaml中 def_config 節點修改，具體如下：
最多支持的聲卡個數：默認5，如需修改，在package.yaml中修改AOS_SNDCARD_NUM_MAX配置
def_config:
AOS_SNDCARD_NUM_MAX: 5每個聲卡最多支持的音頻設備節點數，默認5，可按照實際需要修改package.yaml配置如：
def_config:
AOS_SNDCARD_DEVICE_NUM_MAX: 5API說明
使用示例
組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具，所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》，下載安裝。 待開發環境搭建完成后，可以按照以下步驟進行示例的測試。
步驟1 創建或打開工程
打開已有工程
如果用于測試的案例工程已存在，可參考《AliOS Things集成開發環境使用說明之打開工程》打開已有工程。
創建新的工程
組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例（solution）來運行，這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《AliOS Things集成開發環境使用說明之創建工程》。
步驟2 添加組件
案例下載完成后，需要在helloworld_demo組件的package.yaml中添加對組件的依賴：
depends:
- a2sa: master # helloworld_demo中引入a2sa組件
- littlefs: master # a2sa組件wav播放器示例依賴littlefs文件系統組件
def_config:
CONFIG_A7_DSP_ENABLE: 1 # 必須：使能HaaS100音頻驅動開關
CLI_IOBOX_ENABLE: 1 # 可選：使能文件系統測試命令，例如ls, ll, mkdir, touch, echo等步驟3 下載組件
在已安裝了的開發環境工具欄中，選擇Terminal -> New Terminal啟動終端，并且默認工作路徑為當前工程的workspace，此時在終端命令行中輸入：
aos install a2sa上述命令執行成功后，組件源碼則被下載到了./components/a2sa路徑中。
步驟4 添加示例
在a2sa組件的package.yaml中添加example示例代碼：
source_file:
- "src/*.c"
- example/sound_example.c
- example/sound_example_lb.c
- example/sound_example_vol.c
- example/sound_example_wav.c其中sound_example_wav.c是播放本地文件系統中/data/7.wav音頻文件的示例。如果期望演示該播放wav文件的示例，則需要按下面2個步驟打包.wav音頻文件到文件系統中。
cp ./6.wav ./hardware/chip/haas1000/prebuild/data/ # 拷貝當前目錄下的6.wav文件到文件系統打包目錄./hardware/chip/haas1000/prebuild/data/下。注意：6.wav文件需要自己準備。# 確認./hardware/chip/haas1000/package.yaml文件中第177行至179行是打開的狀態。如下，
program_data_files:
- filename: release/write_flash_tool/ota_bin/littlefs.bin
address: 0xB32000步驟5 編譯固件
在示例代碼已經添加至組件的配置文件，并且helloworld_demo已添加了對該組件的依賴后，就可以編譯helloworld_demo案例來生成固件了，具體編譯方法可參考《AliOS Things集成開發環境使用說明之編譯固件》。
步驟6 燒錄固件
helloworld_demo案例的固件生成后，可參考《AliOS Things集成開發環境使用說明之燒錄固件》來燒錄固件。
步驟7 打開串口
固件燒錄完成后，可以通過串口查看示例的運行結果，打開串口的具體方法可參考《AliOS Things集成開發環境使用說明之查看日志》。
當串口終端打開成功后，可在串口中輸入help來查看已添加的測試命令。
步驟8 測試示例
CLI命令行輸入：
sound_install_driver # 安裝默認聲卡關鍵日志：
sound install driver test begin ...
sound install driver test end !!!CLI命令行輸入：
sound_loopback start # 開始聲卡錄音播放loopback測試關鍵日志：
sound loopback test begin ...CLI命令行輸入：
sound_loopback stop # 停止聲卡錄音播放loopback測試關鍵日志：
sound loopback test end !!!CLI命令行輸入：
sound_setvol 80 # 設置播放音量為80CLI關鍵日志：
alsa_volume_set percent 80CLI命令行輸入：
sound_getvol # 設置播放音量為80關鍵日志：
get volume 80CLI命令行輸入：
sound_wav /data/7.wav 1 # 播放/data/7.wav的音頻1次（可修改），僅限于.wav格式的音頻關鍵日志：
open /data/7.wav successfullyFAQ
Q1： 必須通過sound_install_driver手動安裝聲卡嗎？
答：由于不同的硬件環境，聲卡類型不同，聲卡支持的Capture & Playback的通道數都不同，開發者可以根據實際的板子硬件在代碼合適的位置通過調用audio_native_card_register()函數來安裝聲卡，建議參考audio_install_codec_driver()的實現。