本文作者:少川
本文轉自:
晶片開放社群(OCC)一、前言
本例程基于YoC軟體平台av元件采用http協定播放一首網絡mp3歌曲。當開發闆成功通過sal(底層通過at指令連接配接内置的網卡晶片)連接配接網絡後,可輸入相應序列槽指令行從web伺服器上拉取mp3歌曲實作邊拉取音頻源資料邊播放的功能。開發者可基于該例程實作更為豐富的網絡播放功能。 本例程名為ch2601_webplayer_demo,可以通過CDK直接從OCC拉取。
二、如何使用
1.下載下傳代碼并編譯運作
- 通過cdk搜尋
并下載下傳工程代碼打開後,會有如下界面。其中框1為解決方案元件,框2中是該解決方案依賴的子功能元件。ch2601_webplayer_demo
- 在本例程中,主要依賴av(音視訊軟體架構)、pvmp3dec(mp3解碼器)、drv_wifi_at_w800(wifi驅動)等元件。
- 在IDE上編譯通過後,點選下載下傳進行燒錄。燒錄成功後,複位運作。成功運作後,序列槽會有如何列印輸出:
2.網絡連接配接
通過ifconfig指令可配置需要連接配接的熱點。具體指令為:
ifconfig ap wifi_ssid wifi_psk
熱點配置成功後,會有下圖如下列印:
3.指令行播放控制
可通過在序列槽下輸入如下指令來控制歌曲的播放
# player help
player play welcom/url[http://] #播放内置開機音頻或網絡歌曲
player pause #暫停播放
player resume #恢複播放
player stop #停止播放
player help #播放器幫助指令
播放http歌曲
player play
http://yocbook.oss-cn-hangzhou.aliyuncs.com/av_repo/alibaba.mp3
,示例如下:
ayer play http://yocbook.oss-cn-hangzhou.aliyuncs.com/av_repo/alibaba.mp3
# [ 13.620]<E>w800_api domain to ip: 47.110.23.146
[ 13.630]<D>sals remote_port -- : 80
[ 13.710]<D>WEB http request:
GET /av_repo/alibaba.mp3 HTTP/1.0
Host: yocbook.oss-cn-hangzhou.aliyuncs.com
User-Agent: CSKY/YOC
[ 15.000]<D>stream upto cache threshold2, pos = 553, cache_pos = 809, diff = 256
[ 15.420]<D>avparser find a parser, name = mp3, id = 1
[ 15.440]<D>ad find a decode, name = pvmp3dec, id = 1
[ 15.450]<D>filter_swr open a avfilter, name = swr
[ 15.470]<D>filter_vol open a avfilter, name = vol
[ 15.470]<D>ao_alsa ao open
[ 15.490]<D>ao ao ref: openref = 1, startref = 0, fun = __ao_open
[ 15.510]<D>ao ori sf ==> sf = 90317074, rate = 44100, ch = 2, bits = 16, siged = 1, float = 0, endian = 0
[ 15.540]<D>ao ao sf ==> sf = 90316946, rate = 44100, ch = 1, bits = 16, siged = 1, float = 0, endian = 0
[ 15.810]<D>ao ao ref: openref = 1, startref = 1, fun = __ao_start
[ 15.820]<D>player_demo =====_player_event, 24, type = 2
[ 15.820]<D>player player_get_media_info, 809 enter. player = 20009E00
[ 15.830]<D>player player_get_media_info, 821 leave. player = 20009E00
[ 15.830]<D>player_demo =====rc = 0, duration = 415807ms, bps = 64000, size = 3326462
三、例程開發
1.主要代碼解析
1.1 主函數流程
主函數位于ch2601_webplayer_demo/app/src/app_main.c中。詳細的解釋如下:
static void network_event(uint32_t event_id, const void *param, void *context)
{
switch(event_id) {
case EVENT_NETMGR_GOT_IP:
LOGD(TAG, "net got ip");
break;
case EVENT_NETMGR_NET_DISCON:
LOGD(TAG, "net disconnect");
break;
}
/*do exception process */
app_exception_event(event_id);
}
int main(void)
{
board_yoc_init(); // 闆級配置、kv檔案系統、聲霸卡驅動、網卡驅動等初始化
player_init(); // 播放器子產品初始化
cli_reg_cmd_player(); // 播放器指令行注冊
/* Subscribe */
event_subscribe(EVENT_NETMGR_GOT_IP, network_event, NULL); // 訂閱網絡連接配接事件
event_subscribe(EVENT_NETMGR_NET_DISCON, network_event, NULL); // 訂閱網絡斷開事件
}
1.2 聲霸卡、網卡驅動注冊等
代碼位于ch2601_webplayer_demo/app/src/init.c中。
static void network_init()
{
w800_wifi_param_t w800_param;
/* init wifi driver and network */
w800_param.reset_pin = PA21;
w800_param.baud = 1*1000000;
w800_param.cs_pin = PA15;
w800_param.wakeup_pin = PA25;
w800_param.int_pin = PA22;
w800_param.channel_id = 0;
w800_param.buffer_size = 4*1024;
wifi_w800_register(NULL, &w800_param);
app_netmgr_hdl = netmgr_dev_wifi_init();
if (app_netmgr_hdl) {
utask_t *task = utask_new("netmgr", 2 * 1024, QUEUE_MSG_COUNT, AOS_DEFAULT_APP_PRI);
netmgr_service_init(task);
netmgr_start(app_netmgr_hdl);
}
}
void board_yoc_init(void)
{
board_init(); // 闆級初始化
event_service_init(NULL); // 釋出訂閱服務初始化
console_init(CONSOLE_UART_IDX, 115200, 512); // 序列槽初始化
ulog_init(); // 日志初始化
aos_set_log_level(AOS_LL_DEBUG); // 配置預設日志列印級别
int ret = partition_init(); // 分區初始化
if (ret <= 0) {
LOGE(TAG, "partition init failed");
} else {
LOGI(TAG, "find %d partitions", ret);
}
aos_kv_init("kv"); // kv檔案系統初始化,可用于儲存網絡ssid&psk
snd_card_alkaid_register(NULL); // 聲霸卡初始化,可用于播放&采集
network_init(); // 網絡初始化
board_cli_init(); // 指令行初始化并注冊預設的指令
}
1.3 網絡底層通信
2601主晶片是通過spi與無線網卡晶片w800通信的。w800中運作有完整的lwip網絡協定棧。 drv_wifi_at_w800元件将底層spi收到的網絡資料(采用at協定封裝)處理後遞交到sal(socket abstract layer)元件中。2601通過sal來屏蔽底層網卡驅動的差異,向上提供标準的BSD網絡套接字接口。 此部分代碼位于components/drv_wifi_at_w800/w800_at_port.c中。
static int spi_resp_len(void)
{
uint16_t temp = 0;
uint8_t a,b;
uint8_t cmd = SPI_REG_INT_STTS;
int recv_len = 0;
while (1) {
CS_LOW;
csi_spi_send(&spi_handle, &cmd, 1, AOS_WAIT_FOREVER); // 檢查是否存在有效資料
csi_spi_receive(&spi_handle, &a, 1, AOS_WAIT_FOREVER);
csi_spi_receive(&spi_handle, &b, 1, AOS_WAIT_FOREVER);
CS_HIGH;
temp = a | (b << 8);
if((temp != 0xffff) && (temp & 0x01)) {
cmd = SPI_REG_RX_DAT_LEN;
CS_LOW;
csi_spi_send(&spi_handle, &cmd, 1, AOS_WAIT_FOREVER); // 擷取接收資料長度
csi_spi_receive(&spi_handle, &a, 1, AOS_WAIT_FOREVER);
csi_spi_receive(&spi_handle, &b, 1, AOS_WAIT_FOREVER);
CS_HIGH;
recv_len = a | (b << 8);
// printf("recv len:%d\r\n", recv_len);
break;
}
aos_msleep(100);
}
return recv_len;
}
static void at_spi_recv_task(void *priv)
{
int len = 0;
uint8_t *recv = NULL;
while(1) {
aos_sem_wait(&spi_recv_sem, AOS_WAIT_FOREVER); // 是否有中斷過來,通過GIIO來觸發中斷
len = spi_resp_len(); // 擷取對端發送過來的資料長度
if (len)
recv = aos_malloc_check(len);
else
continue;
spi_recv(recv, len); // 擷取實際有效資料
while (ringbuffer_available_write_space(&spi_ringbuffer) < (len -1)) {
aos_msleep(100);
}
int w_len = ringbuffer_write(&spi_ringbuffer, recv, len-1); // 寫入到環形緩沖中
if (w_len != (len-1)) {
LOGD(TAG, "spi buffer is full\r\n");
} else {
spi_channel_cb(AT_CHANNEL_EVENT_READ, spi_channel_priv);
}
if (recv) {
aos_free(recv);
recv = NULL;
}
}
}
static void *at_spi_init(const char *name, void *config)
{
int ret = 0;
csi_pin_set_mux(PA16, PA16_SPI0_SCK); // 配置管腳複用
csi_pin_set_mux(PA17, PA17_SPI0_MOSI);
csi_pin_set_mux(PA18, PA18_SPI0_MISO);
// csi_pin_set_mux(PA15, PA15_SPI0_CS); // CS
csi_pin_set_mux(PA15, PIN_FUNC_GPIO); // CS
csi_pin_set_mux(PA22, PIN_FUNC_GPIO); // INT
csi_gpio_pin_init(&spi_int_pin, PA22); // gpio配置
csi_gpio_pin_dir(&spi_int_pin,GPIO_DIRECTION_INPUT);
csi_gpio_pin_mode(&spi_int_pin,GPIO_MODE_PULLNONE);
csi_gpio_pin_debounce(&spi_int_pin, true);
csi_gpio_pin_attach_callback(&spi_int_pin, spi_in_int_cb, NULL); // 根據gpio來通知是否存在網絡資料
csi_gpio_pin_irq_mode(&spi_int_pin,GPIO_IRQ_MODE_FALLING_EDGE);
csi_gpio_pin_irq_enable(&spi_int_pin, 1);
csi_gpio_pin_init(&spi_cs_pin, PA15);
csi_gpio_pin_mode(&spi_cs_pin,GPIO_MODE_PULLUP);
csi_gpio_pin_dir(&spi_cs_pin,GPIO_DIRECTION_OUTPUT);
CS_HIGH;
csi_gpio_pin_init(&spi_wakeup_pin, PA25);
csi_gpio_pin_mode(&spi_wakeup_pin,GPIO_MODE_PULLUP);
csi_gpio_pin_dir(&spi_wakeup_pin,GPIO_DIRECTION_OUTPUT);
csi_gpio_pin_write(&spi_wakeup_pin, GPIO_PIN_HIGH);
ret = csi_spi_init(&spi_handle, 0);
if (ret < 0) {
printf("csi spi init failed\r\n");
return NULL;
}
csi_spi_mode(&spi_handle, SPI_MASTER); // 2601側作為master
ret = csi_spi_baud(&spi_handle, 1*1000000); // 波特率配置預設1M
LOGD(TAG, "#######################spi speed:%d\r\n", ret);
csi_spi_cp_format(&spi_handle, SPI_FORMAT_CPOL0_CPHA0);
csi_spi_frame_len(&spi_handle, SPI_FRAME_LEN_8);
csi_spi_select_slave(&spi_handle, 0); // 建立與w800間的spi通信,w800網卡作為slave 0
aos_task_t task;
ret = aos_sem_new(&spi_recv_sem, 0); // 用于gpio中斷通知
// aos_check(ret, NULL);
ret = aos_task_new_ext(&task, "spi_recv", at_spi_recv_task, NULL, 1536, 9);
// aos_check(ret, NULL);
spi_recv_buffer = (char *)aos_malloc_check(SPI_RX_BUFFER_LEN); // 建立環形buffer,用于接收網絡資料
ringbuffer_create(&spi_ringbuffer, spi_recv_buffer, SPI_RX_BUFFER_LEN);
return (void*)1;
}
at_channel_t spi_channel = {
.init = at_spi_init,
.set_event = at_spi_set_event,
.send = at_spi_send,
.recv = at_spi_recv,
};
2.網絡播放器使用及配置
YoC平台中的播放器可以支援wav、mp3、m4a、amrnb、amrwb、flac、adts等多種音頻格式的播放。同時也支援sd卡、http(s)、fifo、mem等多種取流方式。url格式的詳細定義如下:
流類型 | URL字首 | URL格式 |
網絡流 | http(s):// | http(s)://ip:port/xx.mp3 |
檔案流(SD卡) | file:// | file:///fatfs0/xx.mp3?avformat=%s&avcodec=%s&channel=%u&rate=%u |
記憶體流 | mem:// | mem://addr=%u&size=%u&avformat=%s&avcodec=%s&channel=%u&rate=%u |
fifo流 | fifo:// | fifo://tts/1?avformat=%s&avcodec=%s&channel=%u&rate=%u |
加密流 | crypto:// | http://ip:port/xx.mp3?key=%s&iv=%s |
hls流 | http(s)://ip:port/xx.m3u8 |
播放器相關元件詳細的設計和使用方法請通路以下連結:
https://yoc.docs.t-head.cn/yocbook/Chapter5-%E7%BB%84%E4%BB%B6/%E5%A4%9A%E5%AA%92%E4%BD%93%E6%92%AD%E6%94%BE%E5%99%A8/av.html2.1 網絡播放器在2601晶片上的應用
網絡播放器典型代碼解析如下:
static player_t *g_player;
static void _player_event(player_t *player, uint8_t type, const void *data, uint32_t len)
{
int rc;
UNUSED(len);
UNUSED(data);
UNUSED(handle);
LOGD(TAG, "=====%s, %d, type = %d", __FUNCTION__, __LINE__, type);
switch (type) {
case PLAYER_EVENT_ERROR: // 播放出錯事件
rc = player_stop(player);
break;
case PLAYER_EVENT_START: { // 開始播放事件
media_info_t minfo;
memset(&minfo, 0, sizeof(media_info_t));
rc = player_get_media_info(player, &minfo); // 擷取媒體時長、大小等資訊
LOGD(TAG, "=====rc = %d, duration = %llums, bps = %llu, size = %u", rc, minfo.duration, minfo.bps, minfo.size);
break;
}
case PLAYER_EVENT_FINISH: // 播放結束事件
player_stop(player); // 停止播放
break;
default:
break;
}
}
player_t *get_player_demo()
{
if (!g_player) {
ply_conf_t ply_cnf;
player_conf_init(&ply_cnf); // 初始化播放器預設配置
ply_cnf.vol_en = 1; // 使能數字音量功能
ply_cnf.vol_index = 160; // 0~255
ply_cnf.event_cb = _player_event; // 播放事件回調函數
ply_cnf.period_num = 12; // 底層音頻輸出緩沖周期,用于控制音頻輸出緩沖大小
ply_cnf.cache_size = 32 * 1024; // 網絡時的播放緩沖大小
g_player = player_new(&ply_cnf); // 建立播放器
}
return g_player;
}
2.2 網絡播放器相關宏配置
鑒于2601的硬體資源比較受限,而網絡播放器又提供了很多的功能。是以不太可能将播放器提供的所有功能都能夠包含進去。此時就需要開發根據具體産品需要開啟或配置相關功能。 例程中典型宏定義配置如下:
CONFIG_AEFXER_IPC=0 #音效處理,2601不涉及
CONFIG_AEFXER_SONA=0 #音效處理,2601不涉及
CONFIG_AO_MIXER_SUPPORT=0 #混音播放,預設關閉
CONFIG_ATEMPOER_IPC=0 #核間變速播放,2601不涉及
CONFIG_ATEMPOER_SONIC=1 #變速播放
CONFIG_AV_AO_CHANNEL_NUM=1 #單聲道音頻輸出
CONFIG_AV_PROBE_SIZE_MAX=1024 #音頻格式探測最大長度
CONFIG_AV_SAMPLE_NUM_PER_FRAME_MAX=80 #控制wav音頻幀的最大采樣數
CONFIG_AV_STREAM_INNER_BUF_SIZE=256 #stream内部buf大小,用于性能優化
CONFIG_DECODER_ADPCM_MS=0 #adpcm_ms解碼
CONFIG_DECODER_ALAW=0 #alaw解碼
CONFIG_DECODER_AMRNB=0 #amrnb解碼
CONFIG_DECODER_AMRWB=0 #amrwb解碼
CONFIG_DECODER_FLAC=0 #flac解碼
CONFIG_DECODER_IPC=0 #核間解碼,2601不涉及
CONFIG_DECODER_MULAW=0 #ulaw解碼
CONFIG_DECODER_OPUS=0 #opus解碼
CONFIG_DECODER_PCM=1 #pcm裸流解碼
CONFIG_DECODER_PVMP3=1 #mp3解碼
CONFIG_DECODER_SPEEX=0 #speex解碼
CONFIG_DEMUXER_ADTS=0 #adts解複用
CONFIG_DEMUXER_AMR=0 #amr解複用
CONFIG_DEMUXER_ASF=0 #asf解複用
CONFIG_DEMUXER_FLAC=0 #flac解複用
CONFIG_DEMUXER_MP3=1 #mp3解複用
CONFIG_DEMUXER_MP4=0 #mp4解複用
CONFIG_DEMUXER_OGG=0 #ogg解複用
CONFIG_DEMUXER_RAWAUDIO=0 #rawaudio解複用
CONFIG_DEMUXER_TS=0 #ts解複用
CONFIG_DEMUXER_WAV=0 #wav解複用
CONFIG_EQXER_IPC=0 #量化器,2601不涉及
CONFIG_EQXER_SILAN=0 #量化器,2601不涉及
CONFIG_FFTXER_IPC=0 #fft變換,2601不涉及
CONFIG_FFTXER_SPEEX=0 #fft變換,2601不涉及
CONFIG_PLAYER_TASK_STACK_SIZE=2048 #播放器任務棧大小
CONFIG_RESAMPLER_IPC=0 #核間音頻重采樣
CONFIG_RESAMPLER_SPEEX=0 #speex重采樣
CONFIG_STREAMER_CRYPTO=0 #加密流
CONFIG_STREAMER_FIFO=0 #隊列流
CONFIG_STREAMER_FILE=0 #檔案流
CONFIG_STREAMER_HLS=0 #http live stream
CONFIG_STREAMER_HTTP=1 #http網絡流
CONFIG_STREAMER_MEM=1 #記憶體流
CONFIG_WEB_CACHE_TASK_STACK_SIZE=2048 #網絡流緩沖任務棧大小
AV元件中宏配置的具體說明請參考
此連結中的功能配置與裁剪小節。該連結中同時會介紹典型音頻播放場景的相關配置。
2.3 在CDK中如何配置宏
- 在解決方案名稱上右擊,選擇彈出框中第一項,如下圖所示:
- 在彈出框中選中Compile頁籤,單擊下圖中的紅色框可配置相關宏
- 在彈出框中,根據功能需要配置對應的宏,儲存後重新編譯
注意事項:
- Package中的子功能元件在Options選項中會有預設的配置項(如果存在)
- 解決方案在依賴子功能元件時,可通過Options選項自行重新配置相關的宏。其在編譯時會覆寫子功能元件的預設配置
四、參考資料
- YoC軟體平台: https://yoc.docs.t-head.cn/yocbook/