HFP AG
HFP（Hands-Free Profile）AG（Audio Gateway）端 API。WS63 作为音频网关连接蓝牙耳机/车载系统——管理通话状态控制（来电/接听/挂断/拒接）、音频连接建立和释放、AT 命令交互。
适用车载蓝牙、蓝牙通话适配器等场景。
头文件清单
接口清单
接口名称 功能简述 hfp_ag_connect 建立与HF的SLC(service level connection) hfp_ag_disconnect 释放与HF的SLC(service level connection) hfp_ag_audio_connect 建立与HF的音频连接 hfp_ag_audio_disconnect 断开与HF的音频连接 hfp_ag_get_device_connect_state 通过设备地址查询设备HFP连接状态 hfp_ag_get_sco_connect_state 通过设备地址查询设备HFP SCO连接状态 hfp_ag_send_answer_call_event 接听呼入电话 hfp_ag_send_finish_call_event 结束通话 hfp_ag_send_originate_call_event 呼出电话 hfp_ag_send_network_incoming_event AG端发送来电事件 hfp_ag_send_network_event AG端发送其他网络事件 hfp_ag_set_volume HF端发起音量调整 hfp_ag_send_current_calls 发送通话列表 hfp_ag_send_subscriber_number 发送订阅号码信息 hfp_ag_send_battery_charge AG端发送电量信息 hfp_ag_send_cmee_error AG端发送扩展错误码 hfp_ag_send_network_operator AG端发送运营商信息 hfp_ag_send_indicator_val AG端发送指示器信息 hfp_ag_register_callbacks 注册上层应用的回调函数
Functions
hfp_ag_connect
头文件清单
功能说明
- 建立与对端HF设备的SLC(service level connection)服务层连接
- 调用后，BTS发起HFP AG与HF的连接流程，连接结果通过hfp_ag_conn_state_changed_callback回调通知上层
- 需在蓝牙协议栈已初始化且BR/EDR链路已建立后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立BR/EDR ACL链路
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 连接请求成功发起 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_disconnect
头文件清单
功能说明
- 释放与对端HF设备的SLC(service level connection)服务层连接
- 调用后，BTS发起HFP AG与HF的断连流程，断连结果通过hfp_ag_conn_state_changed_callback回调通知上层
- 需在HFP AG已与HF建立SLC连接后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 断连请求成功发起 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_audio_connect
头文件清单
功能说明
- 建立与对端HF设备的SCO音频连接
- 调用后，BTS发起SCO音频链路建立流程，连接结果通过hfp_ag_sco_conn_state_changed_callback回调通知上层
- 需在HFP AG已与HF建立SLC连接后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 音频连接请求成功发起 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_audio_disconnect
头文件清单
功能说明
- 断开与对端HF设备的SCO音频连接
- 调用后，BTS发起SCO音频链路断连流程，断连结果通过hfp_ag_sco_conn_state_changed_callback回调通知上层
- 需在HFP AG已与HF建立SCO音频连接后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立SCO音频连接
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 音频断连请求成功发起 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_get_device_connect_state
头文件清单
功能说明
- 通过对端蓝牙设备地址查询该设备的HFP AG连接状态
- 返回值为profile_connect_state_t枚举，包含正在连接、已连接、正在断连、已断连四种状态
- 调用该接口不会触发连接状态变更，仅做查询操作
前置条件
- 蓝牙协议栈已初始化完成
- 入参bd_addr不为NULL，且指向有效的蓝牙设备地址
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 PROFILE_STATE_CONNECTING(0x01) 正在连接 正在建立HFP连接 PROFILE_STATE_CONNECTED(0x02) 已连接 HFP连接已建立 PROFILE_STATE_DISCONNECTING(0x03) 正在断连 正在断开HFP连接 PROFILE_STATE_DISCONNECTED(0x04) 已断连 HFP连接已断开
hfp_ag_get_sco_connect_state
头文件清单
功能说明
- 通过对端蓝牙设备地址查询该设备的HFP SCO音频连接状态
- 返回值为profile_connect_state_t枚举，包含正在连接、已连接、正在断连、已断连四种状态
- 调用该接口不会触发连接状态变更，仅做查询操作
前置条件
- 蓝牙协议栈已初始化完成
- 入参bd_addr不为NULL，且指向有效的蓝牙设备地址
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 PROFILE_STATE_CONNECTING(0x01) 正在连接 正在建立SCO连接 PROFILE_STATE_CONNECTED(0x02) 已连接 SCO连接已建立 PROFILE_STATE_DISCONNECTING(0x03) 正在断连 正在断开SCO连接 PROFILE_STATE_DISCONNECTED(0x04) 已断连 SCO连接已断开
hfp_ag_send_answer_call_event
头文件清单
功能说明
- AG端接听呼入电话
- 调用后，AG端向HF端发送接听通话事件通知
- 需在有呼入电话时调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
- 当前存在呼入电话
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 接听事件成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_finish_call_event
头文件清单
功能说明
- AG端结束通话
- 调用后，AG端根据挂断类型向HF端发送结束通话事件通知
- 支持释放所有通话、释放来电或呼出通话、释放最后一次通话、释放保持通话等挂断类型
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
- 当前存在活跃通话
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL type hfp_ag_action_t 挂断类型 HFP_AG_CANCELED_ALLCALL(0x01): 释放所有通话或GSM服务不可用
HFP_AG_CANCELED_CALLSETUP(0x02): 释放来电或呼出通话
HFP_AG_CANCELED_LASTCALL(0x03): 释放最后一次通话
HFP_AG_CANCELED_CALLHELD(0x04): 释放保持中的通话
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 结束通话事件成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_originate_call_event
头文件清单
功能说明
- AG端发起呼出电话
- 调用后，AG端向HF端发送呼出通话事件通知
- 需在HFP SLC连接已建立后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 呼出事件成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_network_incoming_event
头文件清单
功能说明
- AG端发送来电事件通知
- 调用后，AG端向HF端发送来电信息，包含来电号码、号码类型、服务类型等
- 需在HFP SLC连接已建立后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
- 入参phone_info不为NULL，且指向有效的来电信息
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL phone_info hfp_phone_info_t * 来电信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 来电事件成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_network_event
int hfp_ag_send_network_event(const bd_addr_t *bd_addr, hfp_ag_network_event_t event, uint8_t param)
头文件清单
功能说明
- AG端发送其他网络事件通知
- 调用后，AG端向HF端发送网络事件，包含远端忙、响铃远端、来电、远端接听、服务不可用、服务可用、信号强度、漫游重置、漫游活跃等事件类型
- 需在HFP SLC连接已建立后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL event hfp_ag_network_event_t 网络事件类型 HFP_AG_NETWORK_EVENT_RMT_IS_BUSY(0x01): 远端忙
HFP_AG_NETWORK_EVENT_ALERTING_RM(0x02): 响铃远端
HFP_AG_NETWORK_EVENT_INCOMING_CALL(0x03): 来电
HFP_AG_NETWORK_EVENT_RMT_ANSWER_CALL(0x04): 远端接听
HFP_AG_NETWORK_EVENT_SVC_UNAVAILABLE(0x05): 服务不可用
HFP_AG_NETWORK_EVENT_SVC_AVAILABLE(0x06): 服务可用
HFP_AG_NETWORK_EVENT_SIGNAL_STRENGTH(0x07): 信号强度
HFP_AG_NETWORK_EVENT_ROAMING_RESET(0x08): 漫游重置
HFP_AG_NETWORK_EVENT_ROAMING_ACTIVE(0x09): 漫游活跃param uint8_t 事件参数 根据事件类型不同，参数含义不同
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 网络事件成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_set_volume
头文件清单
功能说明
- AG端发起HF端音量调整
- 调用后，AG端向HF端发送音量增益设置，支持麦克风和扬声器两种音量类型
- 音量增益范围为0-15
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL type hfp_volume_type_t 调整HF音量类型 HFP_VOLUME_MIC(0x00): 麦克风增益
HFP_VOLUME_SPEAKER(0x01): 扬声器增益volume unsigned char 音量增益值 0-15
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 音量设置成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_current_calls
int hfp_ag_send_current_calls(const bd_addr_t *bd_addr, hfp_clcc_info_t *info, hfp_ag_last_t complete)
头文件清单
功能说明
- AG端发送当前通话列表信息
- 调用后，AG端向HF端发送当前通话列表，每条通话记录包含通话索引、方向、状态、模式、多方通话标记、号码类型、号码长度和号码
- 通过complete参数标识是否为最后一条通话记录
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
- 入参info不为NULL，且指向有效的通话信息
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL info hfp_clcc_info_t * 通话信息指针 不为NULL complete hfp_ag_last_t 是否最后一条通话记录 HFP_AG_LAST_NO(0): 不是最后一条
HFP_AG_LAST_YES(1): 是最后一条
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 通话列表成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_subscriber_number
int hfp_ag_send_subscriber_number(const bd_addr_t *bd_addr, hfp_phone_info_t *info, hfp_ag_last_t complete)
头文件清单
功能说明
- AG端发送订阅号码信息
- 调用后，AG端向HF端发送本机订阅号码信息，包含号码类型、服务类型、号码长度和号码
- 通过complete参数标识是否为最后一条订阅号码信息
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
- 入参info不为NULL，且指向有效的订阅号码信息
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL info hfp_phone_info_t * 订阅号码信息指针 不为NULL complete hfp_ag_last_t 是否最后一条订阅号码 HFP_AG_LAST_NO(0): 不是最后一条
HFP_AG_LAST_YES(1): 是最后一条
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 订阅号码信息成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_battery_charge
头文件清单
功能说明
- AG端发送电量信息
- 调用后，AG端向HF端发送当前电量值
- 电量值范围为0-5
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL value uint8_t 电量值 0-5
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 电量信息成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_cmee_error
头文件清单
功能说明
- AG端发送扩展音频网关错误码(CMEE Error)
- 调用后，AG端向HF端发送扩展错误码，包含AG失败、无连接、操作不允许、操作不支持、SIM卡异常等错误类型
- 需在HFP SLC连接已建立后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL error_code hfp_ag_cmee_error_t 扩展的音频网关错误码 HFP_CMEERR_AGFAILURE(0): AG失败
HFP_CMEERR_NOCONN2PHONE(1): 无手机连接
HFP_CMEERR_OPERATION_NOTALLOWED(3): 操作不允许
HFP_CMEERR_OPERATION_NOTSUPPORTED(4): 操作不支持
HFP_CMEERR_PHSIMPIN_REQUIRED(5): 需要PH-SIM卡PIN码
HFP_CMEERR_SIMNOT_INSERTED(10): 没有插入SIM卡
HFP_CMEERR_SIMPIN_REQUIRED(11): 需要SIM卡PIN码
HFP_CMEERR_SIMPUK_REQUIRED(12): 需要SIM卡PUK码
HFP_CMEERR_SIM_FAILURE(13): SIM卡失败
HFP_CMEERR_SIM_BUSY(14): SIM卡忙
HFP_CMEERR_INCORRECT_PASSWORD(16): 不正确的密码
HFP_CMEERR_SIMPIN2_REQUIRED(17): 需要SIM卡PIN2码
HFP_CMEERR_SIMPUK2_REQUIRED(18): 需要SIM卡PUK2码
HFP_CMEERR_MEMORY_FULL(20): 内存满
HFP_CMEERR_INVALID_INDEX(21): 无效索引
HFP_CMEERR_MEMORY_FAILURE(23): 内存申请失败
HFP_CMEERR_TEXTSTRING_TOOLONG(24): 文本字符串过长
HFP_CMEERR_INVALID_CHAR_INTEXTSTRING(25): 文本字符串中的无效字符
HFP_CMEERR_DIAL_STRING_TOOLONG(26): 拨号过长
HFP_CMEERR_INVALID_CHAR_INDIALSTRING(27): 拨号中的无效字符
HFP_CMEERR_NETWORK_NOSERVICE(30): 没有网络服务
HFP_CMEERR_NETWORK_TIMEOUT(31): 网络超时
HFP_CMEERR_EMERGENCYCALL_ONLY(32): 仅支持紧急呼叫
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 扩展错误码成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_network_operator
头文件清单
功能说明
- AG端发送网络运营商信息
- 调用后，AG端向HF端发送当前网络运营商信息，包含运营商模式、格式和运营商名称
- 需在HFP SLC连接已建立后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
- 入参info不为NULL，且指向有效的运营商信息
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL info hfp_cops_info_t * 网络运营商信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 运营商信息成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_send_indicator_val
头文件清单
功能说明
- AG端发送指示器值信息
- 调用后，AG端向HF端发送当前指示器值，包含服务、呼叫、呼叫建立、呼叫保持、信号强度、漫游、电量等指示器
- 需在HFP SLC连接已建立后调用
前置条件
- 蓝牙协议栈已初始化完成
- 对端设备已建立HFP SLC连接
- 入参info不为NULL，且指向有效的指示器值信息
入参
名称 参数类型 详细说明 约束取值范围 bd_addr const bd_addr_t * 对端蓝牙设备的地址信息指针 不为NULL info hfp_cind_info_t * 指示器值信息指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 指示器信息成功发送 Other 其他错误码，参考errcode_bt_t 执行失败
hfp_ag_register_callbacks
头文件清单
功能说明
- 注册HFP AG上层应用的回调函数
- 注册后，BTS通过回调函数向上层反馈HFP AG连接状态、SCO连接状态、编码格式变化、音量变化、拨号请求、接听请求、挂断请求、DTMF请求、用户编号请求、通话列表请求、指示器请求、运营商请求等事件
- 需在使用其他HFP AG接口之前调用
前置条件
- 蓝牙协议栈已初始化完成
- 入参func不为NULL，且指向有效的回调函数定义
入参
名称 参数类型 详细说明 约束取值范围 func hfp_ag_callbacks_t * 指向回调函数接口定义的指针 不为NULL
返回值
- 返回类型：int
返回值 文字含义 触发场景 ERRCODE_BT_SUCCESS(0x00) 执行成功 回调注册成功 Other 其他错误码，参考errcode_bt_t 执行失败
Type definitions
hfp_ag_conn_state_changed_callback
typedef void (*hfp_ag_conn_state_changed_callback)(const bd_addr_t *bd_addr, profile_connect_state_t state);
使用说明：HFP AG连接状态变更回调函数类型，在hfp_ag_callbacks_t中作为conn_state_changed_cb成员使用
hfp_ag_sco_conn_state_changed_callback
typedef void (*hfp_ag_sco_conn_state_changed_callback)(const bd_addr_t *bd_addr, hfp_sco_connect_state_t state);
使用说明：SCO音频连接状态变更回调函数类型，在hfp_ag_callbacks_t中作为sco_conn_state_changed_cb成员使用
hfp_ag_codec_changed_callback
使用说明：编码格式变化回调函数类型，在hfp_ag_callbacks_t中作为codec_changed_cb成员使用
hfp_ag_volume_changed_callback
typedef void (*hfp_ag_volume_changed_callback)(const bd_addr_t *bd_addr, hfp_volume_type_t type, unsigned char volume);
使用说明：HF端音量变化回调函数类型，在hfp_ag_callbacks_t中作为volume_changed_cb成员使用
hfp_ag_dial_req_callback
typedef void (*hfp_ag_dial_req_callback)(const bd_addr_t *bd_addr, unsigned char *number, unsigned int len);
使用说明：HF端拨号请求回调函数类型，在hfp_ag_callbacks_t中作为dial_req_cb成员使用
hfp_ag_mem_dial_req_callback
使用说明：HF端记忆拨号请求回调函数类型，在hfp_ag_callbacks_t中作为mem_dial_req_cb成员使用
hfp_ag_lastnum_dial_req_callback
使用说明：HF端最后一次通话拨号请求回调函数类型，在hfp_ag_callbacks_t中作为lastnum_dial_req_cb成员使用
hfp_ag_answer_call_req_callback
使用说明：HF端接听请求回调函数类型，在hfp_ag_callbacks_t中作为answer_call_req_cb成员使用
hfp_ag_cancel_call_req_callback
使用说明：HF端挂断请求回调函数类型，在hfp_ag_callbacks_t中作为cancel_call_req_cb成员使用
hfp_ag_dtmf_req_callback
使用说明：HF端DTMF请求回调函数类型，在hfp_ag_callbacks_t中作为dtmf_req_cb成员使用
hfp_ag_subscriber_number_req_callback
使用说明：HF端用户编号信息请求回调函数类型，在hfp_ag_callbacks_t中作为subscriber_number_req_callback成员使用
hfp_ag_current_calls_req_callback
使用说明：HF端通话列表请求回调函数类型，在hfp_ag_callbacks_t中作为current_calls_req_callback成员使用
hfp_ag_current_indicator_req_callback
使用说明：HF端当前指示器值请求回调函数类型，在hfp_ag_callbacks_t中作为current_indicator_req_callback成员使用
hfp_ag_network_operator_format_req_callback
使用说明：HF端网络运营商格式请求回调函数类型，在hfp_ag_callbacks_t中作为network_operator_format_req_callback成员使用
hfp_ag_network_operator_req_callback
使用说明：HF端网络运营商请求回调函数类型，在hfp_ag_callbacks_t中作为network_operator_req_callback成员使用
Enumerations
hfp_ag_codec_id_t
枚举成员 取值 描述 HFP_AG_CODEC_ID_CVSD 0x01 HFP AG编码格式为CVSD HFP_AG_CODEC_ID_MSBC 0x02 HFP AG编码格式为MSBC
hfp_ag_service_indi_t
typedef enum {
HFP_AG_SERVICE_UNAVAILABLE = 0,
HFP_AG_SERVICE_AVAILABLE = 1,
} hfp_ag_service_indi_t;
枚举成员 取值 描述 HFP_AG_SERVICE_UNAVAILABLE 0 服务不可用 HFP_AG_SERVICE_AVAILABLE 1 服务可用
hfp_ag_call_indi_t
枚举成员 取值 描述 HFP_AG_CALL_NO_ACTIVE 0 无活跃通话 HFP_AG_CALL_ACTIVE 1 有活跃通话
hfp_ag_callsetup_indi_t
typedef enum {
HFP_AG_CALLSETUP_NO = 0,
HFP_AG_CALLSETUP_INCOMING = 1,
HFP_AG_CALLSETUP_OUTGOING = 2,
HFP_AG_CALLSETUP_OUTALERT = 3,
} hfp_ag_callsetup_indi_t;
枚举成员 取值 描述 HFP_AG_CALLSETUP_NO 0 无呼叫建立 HFP_AG_CALLSETUP_INCOMING 1 来电呼叫建立 HFP_AG_CALLSETUP_OUTGOING 2 呼出呼叫建立 HFP_AG_CALLSETUP_OUTALERT 3 呼出响铃
hfp_ag_callheld_indi_t
typedef enum {
HFP_AG_CALLHELD_NO = 0,
HFP_AG_CALLHELD_ACTIVE_HOLD = 1,
HFP_AG_CALLHELD_ONHOLD = 2,
} hfp_ag_callheld_indi_t;
枚举成员 取值 描述 HFP_AG_CALLHELD_NO 0 无呼叫保持 HFP_AG_CALLHELD_ACTIVE_HOLD 1 活跃通话保持 HFP_AG_CALLHELD_ONHOLD 2 通话被保持
hfp_ag_roam_indi_t
枚举成员 取值 描述 HFP_AG_ROAM_NO_ACTIVE 0 漫游未激活 HFP_AG_ROAM_ACTIVE 1 漫游已激活
hfp_ag_call_state_t
typedef enum {
HFP_AG_CALL_STATE_ACTIVE = 0,
HFP_AG_CALL_STATE_HELD,
HFP_AG_CALL_STATE_DIALING,
HFP_AG_CALL_STATE_ALERTING,
HFP_AG_CALL_STATE_INCOMING,
HFP_AG_CALL_STATE_WAITING,
} hfp_ag_call_state_t;
枚举成员 取值 描述 HFP_AG_CALL_STATE_ACTIVE 0 正在通话 HFP_AG_CALL_STATE_HELD 1 保持通话 HFP_AG_CALL_STATE_DIALING 2 正在拨号 HFP_AG_CALL_STATE_ALERTING 3 正在响铃 HFP_AG_CALL_STATE_INCOMING 4 呼叫接入 HFP_AG_CALL_STATE_WAITING 5 呼叫等待
hfp_ag_network_event_t
typedef enum {
HFP_AG_NETWORK_EVENT_RMT_IS_BUSY = 0x01,
HFP_AG_NETWORK_EVENT_ALERTING_RM = 0x02,
HFP_AG_NETWORK_EVENT_INCOMING_CALL = 0x03,
HFP_AG_NETWORK_EVENT_RMT_ANSWER_CALL = 0x04,
HFP_AG_NETWORK_EVENT_SVC_UNAVAILABLE = 0x05,
HFP_AG_NETWORK_EVENT_SVC_AVAILABLE = 0x06,
HFP_AG_NETWORK_EVENT_SIGNAL_STRENGTH = 0x07,
HFP_AG_NETWORK_EVENT_ROAMING_RESET = 0x08,
HFP_AG_NETWORK_EVENT_ROAMING_ACTIVE = 0x09,
} hfp_ag_network_event_t;
枚举成员 取值 描述 HFP_AG_NETWORK_EVENT_RMT_IS_BUSY 0x01 远端忙事件 HFP_AG_NETWORK_EVENT_ALERTING_RM 0x02 响铃远端事件 HFP_AG_NETWORK_EVENT_INCOMING_CALL 0x03 来电事件 HFP_AG_NETWORK_EVENT_RMT_ANSWER_CALL 0x04 远端接听事件 HFP_AG_NETWORK_EVENT_SVC_UNAVAILABLE 0x05 服务不可用事件 HFP_AG_NETWORK_EVENT_SVC_AVAILABLE 0x06 服务可用事件 HFP_AG_NETWORK_EVENT_SIGNAL_STRENGTH 0x07 信号强度事件 HFP_AG_NETWORK_EVENT_ROAMING_RESET 0x08 漫游重置事件 HFP_AG_NETWORK_EVENT_ROAMING_ACTIVE 0x09 漫游活跃事件
hfp_ag_type_t
typedef enum {
HFP_AG_TYPE_ALL_CALLS = 0x01,
HFP_AG_TYPE_INCOMING_CALL = 0x02,
HFP_AG_TYPE_HELDINCOMING_CALL = 0x03,
HFP_AG_TYPE_OUTGOING_CALL = 0x04,
HFP_AG_TYPE_ONGOING_CALL = 0x05,
} hfp_ag_type_t;
枚举成员 取值 描述 HFP_AG_TYPE_ALL_CALLS 0x01 所有存在的通话 HFP_AG_TYPE_INCOMING_CALL 0x02 来电 HFP_AG_TYPE_HELDINCOMING_CALL 0x03 保持状态的来电 HFP_AG_TYPE_OUTGOING_CALL 0x04 呼叫中的通话 HFP_AG_TYPE_ONGOING_CALL 0x05 进行中的通话
hfp_ag_action_t
typedef enum {
HFP_AG_CANCELED_ALLCALL = 0x01,
HFP_AG_CANCELED_CALLSETUP = 0x02,
HFP_AG_CANCELED_LASTCALL = 0x03,
HFP_AG_CANCELED_CALLHELD = 0x04,
} hfp_ag_action_t;
枚举成员 取值 描述 HFP_AG_CANCELED_ALLCALL 0x01 AG释放所有通话或者GSM服务不可用 HFP_AG_CANCELED_CALLSETUP 0x02 AG或者GSM释放来电中的通话或者呼叫中的通话 HFP_AG_CANCELED_LASTCALL 0x03 AG或者GSM释放最后一次通话 HFP_AG_CANCELED_CALLHELD 0x04 GSM释放保持中的通话
hfp_ag_last_t
枚举成员 取值 描述 HFP_AG_LAST_NO 0 不是最后一条 HFP_AG_LAST_YES 1 是最后一条
hfp_ag_cmee_error_t
typedef enum {
HFP_CMEERR_AGFAILURE = 0,
HFP_CMEERR_NOCONN2PHONE = 1,
HFP_CMEERR_OPERATION_NOTALLOWED = 3,
HFP_CMEERR_OPERATION_NOTSUPPORTED = 4,
HFP_CMEERR_PHSIMPIN_REQUIRED = 5,
HFP_CMEERR_SIMNOT_INSERTED = 10,
HFP_CMEERR_SIMPIN_REQUIRED = 11,
HFP_CMEERR_SIMPUK_REQUIRED = 12,
HFP_CMEERR_SIM_FAILURE = 13,
HFP_CMEERR_SIM_BUSY = 14,
HFP_CMEERR_INCORRECT_PASSWORD = 16,
HFP_CMEERR_SIMPIN2_REQUIRED = 17,
HFP_CMEERR_SIMPUK2_REQUIRED = 18,
HFP_CMEERR_MEMORY_FULL = 20,
HFP_CMEERR_INVALID_INDEX = 21,
HFP_CMEERR_MEMORY_FAILURE = 23,
HFP_CMEERR_TEXTSTRING_TOOLONG = 24,
HFP_CMEERR_INVALID_CHAR_INTEXTSTRING = 25,
HFP_CMEERR_DIAL_STRING_TOOLONG = 26,
HFP_CMEERR_INVALID_CHAR_INDIALSTRING = 27,
HFP_CMEERR_NETWORK_NOSERVICE = 30,
HFP_CMEERR_NETWORK_TIMEOUT = 31,
HFP_CMEERR_EMERGENCYCALL_ONLY = 32,
} hfp_ag_cmee_error_t;
枚举成员 取值 描述 HFP_CMEERR_AGFAILURE 0 AG失败 HFP_CMEERR_NOCONN2PHONE 1 没有连接到手机 HFP_CMEERR_OPERATION_NOTALLOWED 3 操作不允许 HFP_CMEERR_OPERATION_NOTSUPPORTED 4 操作不支持 HFP_CMEERR_PHSIMPIN_REQUIRED 5 需要PH-SIM卡PIN码 HFP_CMEERR_SIMNOT_INSERTED 10 没有插入SIM卡 HFP_CMEERR_SIMPIN_REQUIRED 11 需要SIM卡PIN码 HFP_CMEERR_SIMPUK_REQUIRED 12 需要SIM卡PUK码 HFP_CMEERR_SIM_FAILURE 13 SIM卡失败 HFP_CMEERR_SIM_BUSY 14 SIM卡忙 HFP_CMEERR_INCORRECT_PASSWORD 16 不正确的密码 HFP_CMEERR_SIMPIN2_REQUIRED 17 需要SIM卡PIN2码 HFP_CMEERR_SIMPUK2_REQUIRED 18 需要SIM卡PUK2码 HFP_CMEERR_MEMORY_FULL 20 内存满 HFP_CMEERR_INVALID_INDEX 21 无效索引 HFP_CMEERR_MEMORY_FAILURE 23 内存申请失败 HFP_CMEERR_TEXTSTRING_TOOLONG 24 文本字符串过长 HFP_CMEERR_INVALID_CHAR_INTEXTSTRING 25 文本字符串中的无效字符 HFP_CMEERR_DIAL_STRING_TOOLONG 26 拨号过长 HFP_CMEERR_INVALID_CHAR_INDIALSTRING 27 拨号中的无效字符 HFP_CMEERR_NETWORK_NOSERVICE 30 没有网络服务 HFP_CMEERR_NETWORK_TIMEOUT 31 网络超时 HFP_CMEERR_EMERGENCYCALL_ONLY 32 网络不允许，仅支持紧急呼叫
hfp_ag_clcc_mode_t
typedef enum {
HFP_AG_CLCC_VOICE = 0,
HFP_AG_CLCC_DATA = 1,
HFP_AG_CLCC_FAX = 2,
} hfp_ag_clcc_mode_t;
枚举成员 取值 描述 HFP_AG_CLCC_VOICE 0 语音模式 HFP_AG_CLCC_DATA 1 数据模式 HFP_AG_CLCC_FAX 2 传真模式
hfp_ag_clcc_mpty_t
枚举成员 取值 描述 HFP_AG_CLCC_NOT_MULTI 0 非多方通话 HFP_AG_CLCC_MULTI 1 多方通话
hfp_ag_clcc_dir_t
枚举成员 取值 描述 HFP_AG_CLCC_OUTGOING 0 呼出方向 HFP_AG_CLCC_INCOMING 1 呼入方向
hfp_ag_cnum_service_t
typedef enum {
HFP_AG_CNUM_ASYNC = 0,
HFP_AG_CNUM_SYNC = 1,
HFP_AG_CNUM_PAD = 2,
HFP_AG_CNUM_PACKET = 3,
HFP_AG_CNUM_VOICE = 4,
HFP_AG_CNUM_FAX = 5,
} hfp_ag_cnum_service_t;
枚举成员 取值 描述 HFP_AG_CNUM_ASYNC 0 异步服务 HFP_AG_CNUM_SYNC 1 同步服务 HFP_AG_CNUM_PAD 2 PAD服务 HFP_AG_CNUM_PACKET 3 分组服务 HFP_AG_CNUM_VOICE 4 语音服务 HFP_AG_CNUM_FAX 5 传真服务
hfp_ag_cops_format_t
typedef enum {
HFP_AG_COPS_LONG_ALPHANUM = 0,
HFP_AG_COPS_SHORT_ALPHANUM = 1,
HFP_AG_COPS_NUM = 2,
} hfp_ag_cops_format_t;
枚举成员 取值 描述 HFP_AG_COPS_LONG_ALPHANUM 0 长格式的字符串数值，最大长度为16 HFP_AG_COPS_SHORT_ALPHANUM 1 短格式的字符串数值，最大长度为8 HFP_AG_COPS_NUM 2 数值格式
hfp_ag_cops_mode_t
typedef enum {
HFP_AG_COPS_AUTO = 0,
HFP_AG_COPS_MANU = 1,
HFP_AG_COPS_OFF = 2,
HFP_AG_COPS_DISABLE = 3,
HFP_AG_COPS_MANU_AUTO = 4,
} hfp_ag_cops_mode_t;
枚举成员 取值 描述 HFP_AG_COPS_AUTO 0 自动 HFP_AG_COPS_MANU 1 手动 HFP_AG_COPS_OFF 2 断开网络 HFP_AG_COPS_DISABLE 3 仅在读命令中配置 HFP_AG_COPS_MANU_AUTO 4 自动/手动自动切换
hfp_sco_connect_state_t
typedef enum {
HFP_SCO_STATE_CONNECTING = 0x01,
HFP_SCO_STATE_CONNECTED = 0x02,
HFP_SCO_STATE_DISCONNECTING = 0x03,
HFP_SCO_STATE_DISCONNECTED = 0x04
} hfp_sco_connect_state_t;
枚举成员 取值 描述 HFP_SCO_STATE_CONNECTING 0x01 sco正在连接 HFP_SCO_STATE_CONNECTED 0x02 sco已连接 HFP_SCO_STATE_DISCONNECTING 0x03 sco正在断连 HFP_SCO_STATE_DISCONNECTED 0x04 sco已断连
hfp_volume_type_t
枚举成员 取值 描述 HFP_VOLUME_MIC 0x00 调整microphone增益 HFP_VOLUME_SPEAKER 0x01 调整speaker增益
profile_connect_state_t
typedef enum {
PROFILE_STATE_CONNECTING = 0x01,
PROFILE_STATE_CONNECTED = 0x02,
PROFILE_STATE_DISCONNECTING = 0x03,
PROFILE_STATE_DISCONNECTED = 0x04
} profile_connect_state_t;
枚举成员 取值 描述 PROFILE_STATE_CONNECTING 0x01 正在连接 PROFILE_STATE_CONNECTED 0x02 已连接 PROFILE_STATE_DISCONNECTING 0x03 正在断连 PROFILE_STATE_DISCONNECTED 0x04 已断连
errcode_bt_t
typedef enum {
ERRCODE_BT_SUCCESS = 0x00,
ERRCODE_BT_FAIL = ERRCODE_BT_COMMON_BASE,
ERRCODE_BT_NOT_READY,
ERRCODE_BT_MALLOC_FAIL,
ERRCODE_BT_MEMCPY_FAIL,
ERRCODE_BT_BUSY,
ERRCODE_BT_DONE,
ERRCODE_BT_UNSUPPORTED,
ERRCODE_BT_PARAM_ERR,
ERRCODE_BT_STATE_ERR,
ERRCODE_BT_UNHANDLED,
ERRCODE_BT_AUTH_FAIL,
ERRCODE_BT_RMT_DEV_DOWN,
ERRCODE_BT_AUTH_REJECTED,
ERRCODE_BT_MAX = ERRCODE_BT_COMMON_END
} errcode_bt_t;
枚举成员 取值 描述 ERRCODE_BT_SUCCESS 0x00 执行成功 ERRCODE_BT_FAIL 0x80006000 执行失败 ERRCODE_BT_NOT_READY 0x80006001 执行状态未就绪 ERRCODE_BT_MALLOC_FAIL 0x80006002 内存不足 ERRCODE_BT_MEMCPY_FAIL 0x80006003 内存拷贝失败 ERRCODE_BT_BUSY 0x80006004 繁忙无法响应 ERRCODE_BT_DONE 0x80006005 执行完成 ERRCODE_BT_UNSUPPORTED 0x80006006 不支持 ERRCODE_BT_PARAM_ERR 0x80006007 无效参数 ERRCODE_BT_STATE_ERR 0x80006008 状态错误 ERRCODE_BT_UNHANDLED 0x80006009 未处理 ERRCODE_BT_AUTH_FAIL 0x8000600A 鉴权失败 ERRCODE_BT_RMT_DEV_DOWN 0x8000600B 远端设备关闭 ERRCODE_BT_AUTH_REJECTED 0x8000600C 鉴权被拒 ERRCODE_BT_MAX 0x800067FF 蓝牙错误码最大值
Structures
hfp_phone_info_t
typedef struct {
uint8_t type;
uint8_t service;
uint8_t num_len;
int8_t number[HFP_AG_PHONENUM_MAX_DIGITS];
uint8_t name_len;
int8_t alpha_str[1];
} hfp_phone_info_t;
成员说明：
成员名称 数据类型 描述 type uint8_t 电话号码类型，值范围是128-175 service uint8_t 服务类型，协议支持4或5，见 hfp_ag_cnum_service_t num_len uint8_t 电话号码长度 number int8_t[32] 订阅号码，最大长度是32 name_len uint8_t 子地址长度 alpha_str int8_t[1] 子地址，协议默认是0
hfp_clcc_info_t
typedef struct {
uint8_t idx;
uint8_t dir;
uint8_t status;
uint8_t mode;
uint8_t mpty;
uint8_t type;
uint8_t num_len;
int8_t number[1];
} hfp_clcc_info_t;
成员说明：
成员名称 数据类型 描述 idx uint8_t 通话记录索引，从1开始 dir uint8_t 方向，见 hfp_ag_clcc_dir_t status uint8_t 状态，见 hfp_ag_call_state_t mode uint8_t 模式，见 hfp_ag_clcc_mode_t mpty uint8_t 多方通话标记，见 hfp_ag_clcc_mpty_t type uint8_t 电话号码类型，值范围是128-175 num_len uint8_t 电话号码长度 number int8_t[1] 电话号码
hfp_cops_info_t
typedef struct {
uint8_t mode;
uint8_t format;
uint8_t operator_len;
int8_t operator_name[1];
} hfp_cops_info_t;
成员说明：
成员名称 数据类型 描述 mode uint8_t 当前模式，见 hfp_ag_cops_mode_t format uint8_t 字符串格式，协议仅支持长格式，见 hfp_ag_cops_format_t operator_len uint8_t 运营商名字长度 operator_name int8_t[1] 运营商名字
hfp_cind_info_t
typedef struct {
uint8_t service;
uint8_t call;
uint8_t callsetup;
uint8_t callheld;
uint8_t signal;
uint8_t roam;
uint8_t battchg;
} hfp_cind_info_t;
成员说明：
成员名称 数据类型 描述 service uint8_t 服务，见 hfp_ag_service_indi_t call uint8_t 呼叫，见 hfp_ag_call_indi_t callsetup uint8_t 呼叫建立，见 hfp_ag_callsetup_indi_t callheld uint8_t 呼叫保持，见 hfp_ag_callheld_indi_t signal uint8_t 信号强度，值范围0-5 roam uint8_t 漫游，见 hfp_ag_roam_indi_t battchg uint8_t 电量，值范围0-5
hfp_ag_callbacks_t
typedef struct {
hfp_ag_conn_state_changed_callback conn_state_changed_cb;
hfp_ag_sco_conn_state_changed_callback sco_conn_state_changed_cb;
hfp_ag_codec_changed_callback codec_changed_cb;
hfp_ag_volume_changed_callback volume_changed_cb;
hfp_ag_dial_req_callback dial_req_cb;
hfp_ag_mem_dial_req_callback mem_dial_req_cb;
hfp_ag_lastnum_dial_req_callback lastnum_dial_req_cb;
hfp_ag_answer_call_req_callback answer_call_req_cb;
hfp_ag_cancel_call_req_callback cancel_call_req_cb;
hfp_ag_dtmf_req_callback dtmf_req_cb;
hfp_ag_subscriber_number_req_callback subscriber_number_req_callback;
hfp_ag_current_calls_req_callback current_calls_req_callback;
hfp_ag_current_indicator_req_callback current_indicator_req_callback;
hfp_ag_network_operator_format_req_callback network_operator_format_req_callback;
hfp_ag_network_operator_req_callback network_operator_req_callback;
} hfp_ag_callbacks_t;
成员说明：
成员名称 数据类型 描述 conn_state_changed_cb hfp_ag_conn_state_changed_callback HFP AG连接状态变更回调 sco_conn_state_changed_cb hfp_ag_sco_conn_state_changed_callback SCO音频连接状态变更回调 codec_changed_cb hfp_ag_codec_changed_callback 编码格式变化回调 volume_changed_cb hfp_ag_volume_changed_callback HF端音量变化回调 dial_req_cb hfp_ag_dial_req_callback HF端拨号请求回调 mem_dial_req_cb hfp_ag_mem_dial_req_callback HF端记忆拨号请求回调 lastnum_dial_req_cb hfp_ag_lastnum_dial_req_callback HF端最后一次通话拨号请求回调 answer_call_req_cb hfp_ag_answer_call_req_callback HF端接听请求回调 cancel_call_req_cb hfp_ag_cancel_call_req_callback HF端挂断请求回调 dtmf_req_cb hfp_ag_dtmf_req_callback HF端DTMF请求回调 subscriber_number_req_callback hfp_ag_subscriber_number_req_callback HF端用户编号信息请求回调 current_calls_req_callback hfp_ag_current_calls_req_callback HF端通话列表请求回调 current_indicator_req_callback hfp_ag_current_indicator_req_callback HF端当前指示器值请求回调 network_operator_format_req_callback hfp_ag_network_operator_format_req_callback HF端网络运营商格式请求回调 network_operator_req_callback hfp_ag_network_operator_req_callback HF端网络运营商请求回调
bd_addr_t
成员说明：
成员名称 数据类型 描述 addr uint8_t[6] 蓝牙地址 type uint8_t 蓝牙地址类型，见 bt_addr_type