发射器接口设计说明文档

📎 原始文档：https://www.kdocs.cn/l/clKJanYiWceQ

蓝牙发射器接口设计说明书

珠海市杰理科技股份有限公司

Zhuhai Jieli Technologyco.,LTD

版权所有，未经许可，禁止外传

版权所有，侵权必究 1
地址：珠海市吉大石花西路 107号9栋综合楼 邮编：519015
电话：0756-6313088 传真：0756-6313081
网站：www.zh-jieli.com

修改记录

版本更新日期描述
V1.02020/11/17初稿

版权所有，侵权必究 2
1.文档介绍................................................................................................................................................4
1.1.文档目的.....................................................................................................................................4
1.2.参考文献.....................................................................................................................................4
1.3.术语与缩写词.............................................................................................................................4
2.功能概述..............................................................................................................................................4
3.其他系统/模块的调用关系................................................................................................................ 4
4.性能要求..............................................................................................................................................4
5.接口模块功能介绍................................................................................................................................5
5.1.板级选择.....................................................................................................................................5
5.2.板级相关配置.............................................................................................................................5
5.3.初始化和角色设置.....................................................................................................................6
5.3.1.功能介绍..........................................................................................................................6
5.3.2接口介绍..........................................................................................................................6
5.4.设备搜索.....................................................................................................................................7
5.4.1.功能介绍..........................................................................................................................7
5.4.2.接口介绍..........................................................................................................................7
5.5.搜索过滤和搜索结果.................................................................................................................7
5.5.1功能介绍..........................................................................................................................7
5.5.2接口介绍..........................................................................................................................7
5.6.播放与暂停.................................................................................................................................9
5.6.1.功能介绍..........................................................................................................................9
5.6.2.接口介绍..........................................................................................................................9
5.7.DAC数据静音........................................................................................................................... 9
5.7.1.功能介绍..........................................................................................................................9
5.7.2.接口介绍..........................................................................................................................9
5.8.AG功能.................................................................................................................................... 10
5.8.1.功能介绍........................................................................................................................10
5.8.2.接口介绍........................................................................................................................10
版权所有，侵权必究 3

1.文档介绍

1 . 1 .文档目的

该文档基于AC695N soundbox平台来实现蓝牙发射器相关功能开发，方便用户在对应的工程上自行开发使用，也为相关SDK 的蓝牙发射器开发提供借鉴思路。

1 .2 .参考文献

[ 1] .

1 .3 .术语与缩写词

缩写、术语解释
APApplication，应用程序

2.功能概述

蓝牙发射器接口 模块主要提供包含设备搜索连接，播放暂停，a2dp断开与连接，hfp断开与连接，发射和接收切换等接口给AP调用。

3.其他系统/模块的调用关系

蓝牙发射器接口只供蓝牙做source时使用。

4.性能要求

接口函数尽量在蓝牙模式下调用。
版权所有，侵权必究 4
地址：珠海市吉大石花西路 107号9栋综合楼 邮编：519015
电话：0756-6313088 传真：0756-6313081
网站：www.zh-jieli.com

5.接口模块功能介绍

5 . 1 .板级选择

image

5 .2 .板级相关配置

image 版权所有，侵权必究 5

5 .3 .初始化和角色设置

5.3. 1.功能介绍

初始化链表和SBC编码器，设置为发射或接收状态。

5.3.2接口介绍
函数原型void bt_emitter_init()
功能描述初始化链表和SBC编码器
参数说明
输出void
例子bt_emitter_init()
关联模块bt_event_fun.c
补充说明
函数原型void emitter_or_receiver_switch(u8 flag);
功能描述初始化链表和SBC编码器
参数说明BT_EMITTER_EN //发射器 BT_RECEIVER_EN //接收器
输出void
例子emitter_or_receiver_switch(BT_EMITTER_EN);
关联模块bt_event_fun.c，bt_emitter.c
补充说明

版权所有，侵权必究 6

5 .4 .设备搜索

5.4. 1.功能介绍

搜索蓝牙设备。

5.4.2.接口介绍
函数原型void bt_emitter_start_search_device()
功能描述搜索蓝牙设备
参数说明
输出void
例子bt_emitter_start_search_device()
关联模块bt_emitter.c，ui_bt_scan.c
补充说明
函数原型void bt_emitter_stop_search_device()
功能描述停止搜索蓝牙设备
参数说明
输出void
例子bt_emitter_stop_search_device()
关联模块bt_emitter.c，ui_bt_scan.c
补充说明

5 .5 .搜索过滤和搜索结果

5.5. 1功能介绍

通过配置可根据名字或地址来过滤指定设备。

5.5.2接口介绍
函数原型u8 search_bd_name_filt(char *data, u8 len, u32 dev_class, char rssi)
功能描述通过名字来筛选设备
参数说明*data //设备名字

版权所有，侵权必究 7

len //名字长度
dev_class //设备类型
rssi //设备型号强度
输出True //设备匹配
False //设备过滤
例子search_bd_name_filt(name, name_len, dev_class, rssi)
关联模块bt_emitter.c
补充说明
函数原型u8 search_bd_addr_filt(u8 *addr)
功能描述通过地址来筛选设备
参数说明*addr //设备地址
输出True //设备匹配
False //设备过滤
例子search_bd_addr_filt(addr)
关联模块bt_emitter.c
补充说明
函数原型u8 emitter_search_result(char *name, u8 name_len, u8 *addr, u32 dev_class, char rssi)
功能描述蓝牙设备搜索结果，可以做名字/地址过滤，也可以保存搜到的所有设备，在选择一个进行连接，获取其他想要的操作。
参数说明*name //设备名字
name_len //名字长度
*addr //设备地址
dev_class //设备类型
rssi //设备型号强度
输出True //表示搜到指定的想要的设备，搜索结束，直接连接当前设备
False //继续搜索，直到搜索完成或者超时
例子search_bd_addr_filt(addr)
关联模块bt_emitter.c，蓝牙底层回调
补充说明

版权所有，侵权必究 8

5 .6 .播放与暂停

5.6. 1.功能介绍

控制蓝牙发射器开始和停止音频发射。

5.6.2.接口介绍
函数原型u8 bt_emitter_pp(u8 pp)
功能描述控制蓝牙发射器开始和停止音频发射
参数说明pp //0:暂停 1:播放
输出0 //停止发射
1 //发射
例子bt_emitter_pp(1)
关联模块bt_emitter.c，music.c， app_common.c
补充说明

5 .7 . DAC数据静音

5.7. 1.功能介绍

通过变量可以控制蓝牙在做发射器的时候， 自身DAC是否同时出声音。

5.7.2.接口介绍
函数原型int audio_data_set_zero(struct audio_stream_entry *entry, struct
audio_data_frame *data_buf)
功能描述蓝牙发射开关a2dp链路
参数说明
输出0
例子dac_channel0 .entry.prob_handler = audio_data_set_zero;
关联模块audio_dec.c
补充说明解码初始化时会把该函数注册进回调， 无需另外调用。 当 emitter_dac_mute_en非0时，数据静音；否则非静音.

版权所有，侵权必究 9

5 .8 .AG功能

5.8. 1.功能介绍

用于做对讲机。

5.8.2.接口介绍

使 用 该 功 能 前 需 先 打 开 USER_SUPPORT_PROFILE_HFP_AG。 然 后 使 用 user_emitter_cmd_prepare(USER_CTRL_HFP_CALL_LAST_NO, 0, NULL)打开对讲功能。
imageimage

函数原型void bredr_ag_a2dp_open_and_close()
功能描述蓝牙发射开关a2dp链路
参数说明
输出void
例子bredr_ag_a2dp_open_and_close()
关联模块
补充说明该接口尽量在蓝牙模式下并且没有播歌情况下调用
函数原型void bredr_ag_hfp_open_and_close()
功能描述蓝牙发射开关hfp链路
参数说明
输出void
例子bredr_ag_hfp_open_and_close()
关联模块
补充说明该接口尽量在蓝牙模式下并且没有通话对讲情况下调用

版权所有，侵权必究 10
版权所有，侵权必究 11