Enviorment Application Functions

APP_ENV API Brief

Application	Brief
`app_env_get_ptr()`	application: get app_env variable address
`app_env_get_pin_num()`	application: get GPIO pin number member from app_env variable
`app_env_get_pin_enable()`	application : get GPIO pin enable member from app_env variable
`app_env_get_pin_valid_level()`	application: get GPIO pin valid_level member from app_env variable
`app_env_check_bt_mode()`	application: check toolkit bt mode feature setting
`app_env_check_feature_flag()`	application: Check the features set by toolkit.
`app_env_check_bat_display()`	application: Check the battery level display setting of bt_flag set by toolkit.
`app_env_get_dev_bt_name()`	application: get bluetooth device name from app_env variable
`app_env_get_dev_bt_addr()`	application: get bluetooth address from app_env variable
`app_env_get_tws_addr()`	application: get tws bluetooth address from env_data
`app_env_get_dev_ble_addr()`	application: get tws bluetooth address from env_data
`app_env_get_tx_pwr_lvl()`	application: get RF tx power level from app_env variable of Toolkit setting
`app_env_get_connect_profile()`	application: get support profile info from app_env variable of Toolkit setting
`app_env_get_mos_soft_power_flag()`	application: get power key type from app_env variable of Toolkit setting
`app_env_get_sw_pwr_on_key_time()`	application: get software power on key time length from app_env variable of Toolkit setting
`app_env_get_enter_pairing_key_time()`	application: get enter pairing key time length from app_env variable of Toolkit setting
`app_env_data_find_bt_dev_record()`	application: get bluetooth data record include bluetooth addrss,link key …,@btif_bt_dev_info_t
`app_env_data_print_bt_record()`	application: output bluetooth data record data to uart,@btif_bt_dev_info_t
`app_env_data_get_bt_conn_lk()`	application: get link key by bluetooth address
`app_env_data_add_bt_conn_lk()`	application: add link key by bluetooth address to bt record
`app_env_data_get_bt_last_two_record()`	application: get bluetooth data record[0] and recode[1] include bluetooth addrss,link key …,@btif_bt_dev_info_t
`app_env_data_find_ble_dev_record()`	app_env_data_find_ble_dev_record brief description
`app_env_data_add_or_update_ble_record()`	app_env_data_add_or_update_ble_record brief description
`app_env_data_flush()`	app_env_data_flush brief description
`app_env_init()`	app_env_init brief description
`app_env_deinit()`	app_env_deinit brief description
`app_env_register_lk_handle()`	app_env_register_lk_handle brief description
`app_env_register_le_lk_handle()`	app_env_register_le_lk_handle brief description
`app_env_save_charger_info()`	app_env_save_charger_info brief description
`app_env_reset_charger_info()`	app_env_reset_charger_info brief description
`app_get_ble_flag()`	app_get_ble_flag brief description
`app_env_ble_init()`	app_env_ble_init brief description
`app_get_ble_adv_interval()`	app_get_ble_adv_interval brief description
`app_get_ble_conn_update_delay_time()`	app_get_ble_conn_update_delay_time brief description
`app_env_get_dev_ble_name()`	app_env_get_dev_ble_name brief description
`app_env_get_dev_ble_name_len()`	app_env_get_dev_ble_name_len brief description
`app_get_ble_conn_interval_min()`	app_get_ble_conn_interval_min brief description
`app_get_ble_conn_interval_max()`	app_get_ble_conn_interval_max brief description
`app_env_get_dev_csip_sirk()`	app_env_get_dev_csip_sirk brief description
`get_pref_max_transport_latency()`	get_pref_max_transport_latency brief description
`get_pref_presentation_delay_min()`	get_pref_presentation_delay_min brief description
`get_pref_presentation_delay_max()`	get_pref_presentation_delay_max brief description
`get_supp_presentation_delay_max()`	get_supp_presentation_delay_max brief description
`get_supp_presentation_delay_min()`	get_supp_presentation_delay_min brief description
`app_env_data_reset()`	app_env_data_reset brief description
`app_env_cfg_is_tws_left()`	app_env_cfg_is_tws_left brief description
`app_env_cfg_is_tws_right_en()`	app_env_cfg_is_tws_right_en brief description
`app_env_get_sleep_en()`	app_env_get_sleep_en brief description
`app_env_save_assert_info()`	app_env_save_assert_info brief description
`app_env_reset_assert_info()`	app_env_reset_assert_info brief description
`app_env_get_log_level()`	app_env_get_log_level brief description
`app_env_set_tws_addr()`	app_env_set_tws_addr brief description
`app_env_set_dev_bt_name()`	app_env_set_dev_bt_name brief description
`app_env_set_bt_calib_result()`	app_env_set_bt_calib_result brief description
`app_env_get_bt_calib_result()`	app_env_get_bt_calib_result brief description
`app_env_data_get_bt_record_ptr()`	app_env_data_get_bt_record_ptr brief description
`app_env_cfg_is_free_pairing_enable()`	app_env_cfg_is_free_pairing_enable brief description
`app_env_cfg_is_power_on_reconnect_en()`	app_env_cfg_is_power_on_reconnect_en brief description
`app_env_cfg_get_le_addr_type()`	app_env_cfg_get_le_addr_type brief description

APP_ENV API Reference

Header File

common/app_env/app_env.h

Functions

app_env_t *app_env_get_ptr(void)

application: get app_env variable address

返回:: app_env_t* app_env_t type pointer

uint32_t app_env_get_pin_num(uint32_t pin_type)

application: get GPIO pin number member from app_env variable

参数:: pin_type – [in] type of pin(example PIN_pwrBtn power button),gpio special usage
返回:: pin number

uint32_t app_env_get_pin_enable(uint32_t pin_type)

application : get GPIO pin enable member from app_env variable

参数:

pin_type – [in] type of pin(example PIN_pwrBtn power button),gpio special usage

返回值:

true – enable
false – disable

返回:

pin enable or not

uint32_t app_env_get_pin_valid_level(uint32_t pin_type)

application: get GPIO pin valid_level member from app_env variable

参数:

pin_type – [in] type of pin(example PIN_pwrBtn power button),gpio special usage

返回值:

high – active
low – active

返回:

pin valid level

uint32_t app_env_check_bt_mode(bt_mode_t bt_mode)

application: check toolkit bt mode feature setting

参数:

bt_mode – [in] bluetooth link mode example(BT_MODE_1V2(one_bring_two),BT_MODE_1V1(one_bring_one))

返回值:

true – is match input parameter
false – is not match input parameter

返回:

true or false

uint32_t app_env_check_feature_flag(app_env_feat_flag_t flag)

application: Check the features set by toolkit.

参数:

flag – [in] is bit define variable detail,app_env_feat_flag_t

返回值:

true – is match input parameter
false – is not match input parameter

返回:

true or false

uint32_t app_env_check_bat_display(void)

application: Check the battery level display setting of bt_flag set by toolkit.

返回值:

true – enable battery display
false – disable battery display

返回:

true or false

char *app_env_get_dev_bt_name(void)

application: get bluetooth device name from app_env variable

返回:: bluetooth device name character pointer variable

btif_bd_addr_t app_env_get_dev_bt_addr(void)

application: get bluetooth address from app_env variable

返回:: bluetooth address(six bytes array)

btif_bd_addr_t app_env_get_tws_addr(void)

application: get tws bluetooth address from env_data

返回:: bluetooth address(six bytes array)

btif_bd_addr_t app_env_get_dev_ble_addr(void)

application: get tws bluetooth address from env_data

返回:: bluetooth address(six bytes array)

uint16_t app_env_get_tx_pwr_lvl(void)

application: get RF tx power level from app_env variable of Toolkit setting

返回:: bluetooth address(six bytes array)

uint32_t app_env_get_connect_profile(void)

application: get support profile info from app_env variable of Toolkit setting

返回:: connect_profile btif_profile_bitmap_t

uint32_t app_env_get_mos_soft_power_flag(void)

application: get power key type from app_env variable of Toolkit setting

返回:: poweron_mode power_key_type_t

uint32_t app_env_get_sw_pwr_on_key_time(void)

application: get software power on key time length from app_env variable of Toolkit setting

返回:: software power on key time unit(10ms)

uint32_t app_env_get_enter_pairing_key_time(void)

application: get enter pairing key time length from app_env variable of Toolkit setting

返回:: software enter pairing key time unit(10ms)

int32_t app_env_data_find_bt_dev_record(const btif_bd_addr_t *p_bd_addr, btif_bt_dev_info_t **p_bt_record)

application: get bluetooth data record include bluetooth addrss,link key …,@btif_bt_dev_info_t

参数:: p_bd_addr – [in] input bluetooth address(like mobile bluetooth address)
Param :

void app_env_data_print_bt_record(void)

application: output bluetooth data record data to uart,@btif_bt_dev_info_t

返回:: N/A

int32_t app_env_data_get_bt_conn_lk(btif_bd_addr_t *p_addr, btif_lk_t *p_lk)

application: get link key by bluetooth address

参数:

*p_addr – [in] bluetooth address(Normally, the input address is the Bluetooth address of the mobile phone.),btif_bd_addr_t
*p_lk – [out] bluetooth link key,@btif_lk_t

返回值:

BK_RET_OK – found bluetooth link key from record
BK_RET_FAIL – found bluetooth link key from record

返回:

status

int32_t app_env_data_add_bt_conn_lk(btif_bd_addr_t *p_addr, btif_lk_t *p_lk, if_link_key_type_t lk_type)

application: add link key by bluetooth address to bt record

参数:

*p_addr – [in] bluetooth address(Normally, the input address is the Bluetooth address of the mobile phone.),btif_bd_addr_t
*p_lk – [in] bluetooth link key,@btif_lk_t
lk_type – [in] bluetooth link key type,@if_link_key_type_t

返回值:

BK_RET_OK – add bluetooth link key to record
BK_RET_FAIL – add bluetooth link key to record

返回:

status

uint8_t app_env_data_get_bt_last_two_record(btif_bt_dev_info_t *p_bt_record1, btif_bt_dev_info_t *p_bt_record2)

application: get bluetooth data record[0] and recode[1] include bluetooth addrss,link key …,@btif_bt_dev_info_t

参数:

*p_addr – [out] bluetooth address(Normally, the input address is the Bluetooth address of the mobile phone.),btif_bd_addr_t
*p_lk – [out] bluetooth link key,@btif_lk_t
lk_type – [in] bluetooth link key type,@if_link_key_type_t

返回值:

0 – no record
1 – 1 record
2 – 2 records

返回:

number of record

int32_t app_env_data_find_ble_dev_record(const btif_bd_addr_t *p_bd_addr, btif_ble_dev_info_t **p_ble_record)

app_env_data_find_ble_dev_record brief description

find BLE device information by specified MAC address

参数:

p_bd_addr – [in] MAC address
p_ble_record – [out] BLE device information

返回值:

0 – success
other – fail

返回:

result

int32_t app_env_data_add_or_update_ble_record(const btif_ble_dev_info_t *p_ble_record)

app_env_data_add_or_update_ble_record brief description

add or update BLE device information

参数:

p_ble_record –

返回值:

0 – success
other – fail

返回:

result

void app_env_data_flush(void)

app_env_data_flush brief description

store system environment information to flash if needed

返回:: N/A

void app_env_init(void)

app_env_init brief description

load system environment information and configre data from flash

返回:: N/A

void app_env_deinit(void)

app_env_deinit brief description

store load system environment information and configre data to flash if needed and release allocated data buffer for them

返回:: N/A

void app_env_register_lk_handle(void)

app_env_register_lk_handle brief description

register BT link key relevant operation callback function to HCI

返回:: N/A

void app_env_register_le_lk_handle(void)

app_env_register_le_lk_handle brief description

register BLE link key relevant operation callback function to HCI

返回:: N/A

void app_env_save_charger_info(charger_info_t *p_change_info)

app_env_save_charger_info brief description

save charger information to system environment information

参数:: p_change_info – [in] change information for charger relevant data
返回:: N/A

void app_env_reset_charger_info(void)

app_env_reset_charger_info brief description

reset charger information

返回:: N/A

uint16_t app_get_ble_flag(void)

app_get_ble_flag brief description

return BLE environment setting

返回:: BLE environment setting @app_env_le_flag_t

void app_env_ble_init(void)

app_env_ble_init brief description

initialize BLE relevant setting and send to HCI

返回:: N/A

uint16_t app_get_ble_adv_interval(void)

app_get_ble_adv_interval brief description

return BLE advertising interval

返回值:

DEFAULT_ADV_INT – default interval
other – setting interval

返回:

interval

uint16_t app_get_ble_conn_update_delay_time(void)

app_get_ble_conn_update_delay_time brief description

return connection update delay time

返回值:

DEFAULT_CON_UPDATE_DELAY – default value
other – setting value

返回:

delay time

char *app_env_get_dev_ble_name(void)

app_env_get_dev_ble_name brief description

return BLE local name

返回:: pointer for BLE name data buffer

uint8_t app_env_get_dev_ble_name_len(void)

app_env_get_dev_ble_name_len brief description

return BLE local name length

返回:: length value

uint16_t app_get_ble_conn_interval_min(void)

app_get_ble_conn_interval_min brief description

return min value of BLE connection interval

返回值:

DEFAULT_CON_UPDATE_INTV – default value
other – setting value

返回:

interval value

uint16_t app_get_ble_conn_interval_max(void)

app_get_ble_conn_interval_max brief description

return max value of BLE connection interval

返回值:

DEFAULT_CON_UPDATE_INTV – default value
other – setting value

返回:

interval value

uint8_t *app_env_get_dev_csip_sirk(void)

app_env_get_dev_csip_sirk brief description

return csip sirk data

返回值:

NULL – no enable LE audio
other – csip sirk data buffer

返回:

address

uint16_t get_pref_max_transport_latency(void)

get_pref_max_transport_latency brief description

return max value of transport latency

返回值:

APPL_GA_PREF_MAX_TRANS_LATENCY – defalut value
other – setting value

返回:

latency value

uint32_t get_pref_presentation_delay_min(void)

get_pref_presentation_delay_min brief description

return min value of presentation delay

返回值:

APPL_GA_PREF_PRESENTATION_DELAY_MIN – default value
other – setting value

返回:

delay value

uint32_t get_pref_presentation_delay_max(void)

get_pref_presentation_delay_max brief description

return max value of presentation delay

返回值:

APPL_GA_PREF_PRESENTATION_DELAY_MAX – default value
other – setting value

返回:

delay value

uint32_t get_supp_presentation_delay_max(void)

get_supp_presentation_delay_max brief description

return max value of supported delay

返回值:

APPL_GA_PREF_PRESENTATION_DELAY_MAX – default value
other – setting value

返回:

delay value

uint32_t get_supp_presentation_delay_min(void)

get_supp_presentation_delay_min brief description

return min value of supported delay

返回值:

APPL_GA_PREF_PRESENTATION_DELAY_MIN – default value
other – setting value

返回:

delay value

void app_env_data_reset(void)

app_env_data_reset brief description

reset system environment information, will call function app_env_data_flush to write back to flash.

返回:: N/A

bool app_env_cfg_is_tws_left(void)

app_env_cfg_is_tws_left brief description

return TWS position set by toolkit @APP_ENV_FEATURE_FLAG_TWS_L

返回值:

true – left
false – right

返回:

bool

bool app_env_cfg_is_tws_right_en(void)

app_env_cfg_is_tws_right_en brief description

return enble or not function which distinguish TWS right size or left size setting by toolkit @APP_ENV_FEATURE_FLAG_TWS_L_R_DIF_EN

返回值:: true – enable
返回:: bool
返回:: false disalbe

bool app_env_get_sleep_en(void)

app_env_get_sleep_en brief description

return sleep enable or not setting by toolkit @APP_ENV_FEATURE_FLAG_SLEEP_ENABLE

返回值:

true – enable
false – disable

返回:

bool

void app_env_save_assert_info(const char *p_func, uint16_t line, uint32_t para_0, uint32_t para_1, uint32_t lr, asssert_ctx_t *p_ctx)

app_env_save_assert_info brief description

save assert dump information

参数:

p_func – [in] function name data buffer
line – [in] line number
para_0 – [in] parameter 1
para_1 – [in] parameter 2
lr – [in] link register
p_ctx – [in] MCU register data struct

返回:

N/A

void app_env_reset_assert_info(void)

app_env_reset_assert_info brief description

reset assert dump information

返回:: N/A

uint8_t app_env_get_log_level(void)

app_env_get_log_level brief description

return log level setting from environment

返回:: log level

void app_env_set_tws_addr(uint8_t *p_bd_addr)

app_env_set_tws_addr brief description

update tws addr

返回:: none

void app_env_set_dev_bt_name(uint8_t *p_name, uint8_t name_len)

app_env_set_dev_bt_name brief description

update bt name

返回:: none

void app_env_set_bt_calib_result(uint8_t calib_result)

app_env_set_bt_calib_result brief description

update bt calib result

返回:: none

uint8_t app_env_get_bt_calib_result(void)

app_env_get_bt_calib_result brief description

update bt calib result

返回:: return bt calib result

btif_ret_t app_env_data_get_bt_record_ptr(btif_bd_addr_t *p_bd_addr, btif_bt_dev_info_t **p_dev_record)

app_env_data_get_bt_record_ptr brief description

get dev info

返回:: return get record dev info

bool app_env_cfg_is_free_pairing_enable(void)

app_env_cfg_is_free_pairing_enable brief description

return is free pairing enable

返回:: return get record dev info

bool app_env_cfg_is_power_on_reconnect_en(void)

app_env_cfg_is_power_on_reconnect_en brief description

return true is power on reconnect enable

返回:: return get record dev info

uint8_t app_env_cfg_get_le_addr_type(void)

app_env_cfg_get_le_addr_type brief description

return le addr type

返回:: return get record dev info

Structures

struct app_env_pin_set_t

GPIO special useage setting struct definition.

Public Members

uint8_t gpio_idx: GPIO index

uint8_t valid_level: low active or high active

uint8_t pin_enable: pin enable or not

struct app_sys_para_t

system parameter setting data struct definition

Public Members

uint8_t mos_soft_power_flag: toolkit - sys param - power on/off setting(see @power_key_type_t)

uint8_t charger_current: toolkit - feature - value setting - charging current(see@app_env_charging_current_t)

uint8_t pop_icon_index: toolkit - feature - value setting - Pop-Up prompt icon

app_env_sys_flag_t system_flag: system environment setting

app_env_pin_set_t pins[PIN_MAX]: GPIO special usage setting

uint8_t vol_a2dp: toolkit - audio base setting - A2DP default volume

uint8_t vol_hfp: toolkit - audio base setting - HFP default volume

uint8_t vol_wave: toolkit - audio base setting - hint default volume

app_env_mic_ana_gain_t vol_mic: toolkit - audio base setting - MIC analog gain

uint32_t lp_interval: toolkit - sys param - low battery setting - detect interval

uint16_t lp_threshold: toolkit - sys param - low battery setting - warning threshold = (2600 + lp_threshold)/100

uint16_t lp_pd_threshold: toolkit - sys param - low battery setting - power down threshold = (2600 + lp_pd_threshold)/100

uint8_t lp_channel: toolkit - sys param - low battery setting - channel see@ SADC_CHANNEL

uint8_t frq_offset: toolkit - feature - rf function/freq offset - trimmer capacitor

uint16_t sleep_timeout: toolkit - sys param - timeout setting - Sleep timeout = sleep_timeout * 10 ms

int32_t non_conn_pd_timeout: toolkit - sys param - timeout setting - Non-connect timeoutt enter power down = non_conn_pd_timeout * 10 ms

int32_t pause_pd_timeout: toolkit - sys param - timeout setting - Power down when pause timeout = pause_pd_timeout * 10 ms

uint8_t hfp_mic_chan: toolkit - audio base setting - HFP MIC channel

uint8_t tt_mic_chan: toolkit - audio base setting - TT MIC channel

uint8_t anc_mic_chan: toolkit - audio base setting - ANC MIC channel

uint8_t charger_vol_offset: toolkit - feature - value setting - charging voltage compensation

uint8_t touch_crg[4]: toolkit - button - touch configure setting

uint8_t log_level: toolkit - log level

uint8_t vdda_clib: toolkit - feature - value setting - VDDA calibration value

uint8_t reserved2[10]: not used

struct app_bt_para_t

BT parameter data struct definition.

Public Members

app_env_bt_flag_t bt_flag: BT environment setting

uint8_t dev_name[APP_ENV_CFG_NAME_LEN_MAX]: toolkit - sys param - basic param - BT name

uint8_t dev_pin[16]: toolkit - sys param - basic param - default PIN

btif_bd_addr_t dev_addr: toolkit - sys param - basic param - BT address

app_env_dev_cod_t dev_cod: toolkit - sys param - basic param - device type

app_env_reconn_action_t reconn_action: toolkit - sys param - reconnect - connect action

int32_t reconn_start: toolkit - sys param - reconnect - start time

int32_t reconn_retry_interval: toolkit - sys param - reconnect - reconnect interval(val >= 4s unit:ms)

int8_t reconn_retry_count: toolkit - sys param - reconnect - reconnect count

int8_t poweron_reconn_count: toolkit - sys param - poweron reconnect - reconnect count

uint16_t poweron_reconn_interval: toolkit - sys param - poweron reconnect - reconnect interval(val >= 4s unit:ms)

int16_t pair_timeout: toolkit - sys param - paring timeout(unit:s)

app_env_auto_pd_cond_t auto_pd_cond: toolkit - sys param - other -auto power off condition

uint8_t disconn_action: toolkit - sys param - other -disconnect action

struct app_ble_para_t

BLE parameter data struct definition.

Public Members

app_env_le_flag_t ble_flag: BLE environment setting

btif_bd_addr_t public_addr: toolkit - sys param - BLE setting - ble public address

btif_bd_addr_t static_addr: toolkit - sys param - BLE setting - ble static address

char dev_name[APP_ENV_CFG_NAME_LEN_MAX]: toolkit - sys param - BLE setting - ble name

uint16_t adv_interval: toolkit - sys param - BLE setting - adv interval(adv_interval * 1.25ms)

uint16_t conn_update_delay_time: toolkit - sys param - BLE setting - connection update delay time (unit:s)

uint16_t conn_interval_min: toolkit - sys param - BLE setting - MIN connect interval(conn_interval_min * 1.25ms)

uint16_t conn_interval_max: toolkit - sys param - BLE setting - MAX connect interval(conn_interval_max * 1.25ms)

uint8_t csip_pt_sirk[16]: toolkit - sys param - BLE setting - CSIP SIRK

uint16_t pref_max_transport_latency: toolkit - sys param - BLE setting - max tranport lantency

uint32_t pref_presentation_delay_min: toolkit - sys param - BLE setting - pref pd min

uint32_t pref_presentation_delay_max: toolkit - sys param - BLE setting - pref pd max

uint32_t supp_presentation_delay_min: toolkit - sys param - BLE setting - support pd min

uint32_t supp_presentation_delay_max: toolkit - sys param - BLE setting - support pd max

uint8_t reserved[19]: not used

struct app_eq_para_t: EQ parameter data strcut definition.

struct app_aud_eq_t

EQ setting data struct definition.

Public Members

uint16_t eq_enable: toolkit - audio eq - 16 order(bitmap), bit0->eq_para[0]

int16_t eq_gain: toolkit - audio eq - total gain

struct app_hfp_cfg_t

Public Members

uint8_t paraset: toolkit - call setting - aec/ns enable - use default(0 or 1)

uint8_t ns_level: toolkit - call setting - aec/ns enable - noise reduction lecel (0~3)

uint8_t out_gain: toolkit - call setting - aec/ns enable - output gain (0 ~ 30)

uint8_t ec_level: toolkit - call setting - aec/ns enable - aec level (0 ~ 30)

uint8_t d2a_loop: toolkit - call setting - boolean for enale DAC ADC loop

uint8_t minG: toolkit - call setting - MIC gain

uint8_t dist: toolkit - call setting - distance between two MIC

uint8_t dualmic: toolkit - call setting - boolean for enale daul MIC setting

uint8_t mainmic: toolkit - call setting - main MIC index

uint8_t eq_enable: toolkit - call setting - EQ enable or not

uint32_t tlv_eq_add: toolkit - call setting - flash address for calling EQ setting

uint8_t reserved[158]: not used

struct app_drc_para_t: DRC parameter setting definition LCI.

struct app_vol_info_t

volume gain setting data struct definition

Public Members

uint32_t dig_gain: digital gian

uint32_t ana_gain: analog gain

struct app_volume_t

volume level setting data struct definition

Public Members

app_vol_info_t vol[APP_ENV_VOL_LEVEL_CNT_MAX]: gain setting array for volume level

struct app_rfpwr_t

RF power adjust data strcut definition.

Public Members

uint8_t big_adj: xvr_0x24{bit10:bit7}

struct app_bat_display_t

battery level data struct definition

Public Members

uint16_t bat_level[10]: battery voltage

struct app_saradc_vol_t: SAR ADC setting data struct definition.

struct app_sw_feature_t

software features data struct definition

Public Members

app_env_feat_flag_t feature_flag: features setting

int32_t charge_timeout: Not used

bt_mode_t bt_mode: toolkit - feature - 1V2(default 1V1, tws isnot config in the toolkit)

app_volume_t a2dp_vol_gain_cfg: toolkit - audio base setting - a2dp vol gain config table

app_volume_t hfp_vol_gain_cfg: toolkit - audio base setting - hfp vol gain config table

app_volume_t linein_vol_gain_cfg: toolkit - audio base setting - linein vol gain config table

uint8_t vol_mic_dig: toolkit - audio HFP - MIC digital gain

app_env_mic_ana_gain_t vol_mic_ana: toolkit - audio HFP - MIC analog gain

uint8_t vol_linein_dig: toolkit - audio base setting - Linein digital gain

uint8_t vol_linein_ana: toolkit - audio base setting - Linein analog gain

uint8_t pa_mute_delay_time: toolkit - feature - PA Mute setting - delay

uint8_t pa_unmute_delay_time: toolkit - feature - PA Mute setting - UN-delay

uint16_t sw_pwr_on_key_time: toolkit - sys pram- power on/off setting - soft-poweron time

uint16_t sw_pwr_off_key_time: Not used

uint16_t enter_pairing_key_time: toolkit - sys pram- power on/off setting - enter paring time(unit:10ms)

app_rfpwr_t a2dp_rf_pwr: toolkit - feature - rf function/freq offset - a2dp mode

app_rfpwr_t hfp_rf_pwr: toolkit - feature - rf function/freq offset - hfp mode

app_bat_display_t bat_display_level: toolkit - feature - battery level display setting - battery percent-value pair table

btif_bd_addr_t tester_bt_addr: Not used

app_env_dig_vol_t dig_vol: toolkit - feature - value setting - digital voltage

app_env_ana_vol_t ana_vol: toolkit - feature - value setting - analog voltage

uint8_t tws_eir: toolkit - feature - value setting - tws earphone icon

app_saradc_vol_t saradc_vol: toolkit - button train

uint8_t audio_eq_index: toolkit - audio eq - EQ enable - index

struct _app_hints_info_s

hints information data struct definition

Public Members

uint16_t page_index: page index for hints data in flash

struct app_env_cfg_t

system environment configure data struct definition

Public Members

int8_t valid_flag: flag for valid or not

app_sys_para_t system_para: system parameter settings

app_bt_para_t bt_para: BT parameter settings

app_ble_para_t ble_para: BLE parameter settings

uint8_t wave_lang_sel: using language for hints

uint8_t led_map[LED_NUM]: GPIO index for LED

app_led_info_t led_info[LED_EVENT_NUM]: LED event behavior setting

app_button_para_t button_para: button trigger threshold setting

uint64_t button_code[BUTTON_BT_END]: button trigger condition setting

app_aud_eq_t aud_eq[APP_ENV_AUDIOEQ_DEF_CNT]: EQ settings

app_hfp_cfg_t hfp_cfg: call relevant configure setting

app_drc_para_t drc: DRC relevant configure setting

app_sw_feature_t feature: software features setting

app_hints_info_t hints_info[APP_HINTS_LANGS_CNT_MAX][WAVE_END - 1]: hints information

struct app_env_data_hdr_t

environment header data struct definition

Public Members

uint32_t magic: magic words

uint32_t crc32: CRC value

uint32_t version: version value

uint32_t data_len: data length

struct app_env_data_sys_info_t

sysyem environment information data struct definition

Public Members

uint8_t lang_sel: using language

uint8_t eq_lang_sel: EQ using language

uint8_t reserved[15]: not used

struct app_env_data_tws_info_t

TWS environment information data struct definition.

Public Members

btif_bd_addr_t tws_addr: TWS MAC address

uint8_t lk_vaild: flag for link key valid or not

btif_lk_t lk: data buffer for link key value

uint8_t reserved[16]: not used

uint8_t ear_pos: TWS right size or left size @left_right_t

struct app_env_data_bt_record_t

BT record informaiton data struct definition.

Public Members

uint32_t record_count: reoced count

btif_bt_dev_info_t record[APP_ENV_DATA_BT_RECORD_COUNT_MAX]: remote BT device information data

struct app_env_data_ble_record_t

BLE record informaiton data struct definition.

Public Members

uint32_t record_count: reoced count

btif_ble_dev_info_t record[APP_ENV_DATA_BLE_RECORD_COUNT_MAX]: remote BT device information data

struct assert_info_t

assert information data struct

Public Members

bool assert_valid: flag for assert dump data valid or not

char assert_func[APP_ENV_ASSERT_FILE_LEN_MAX]: function name

uint16_t assert_line: line number

uint32_t param_1: parameter 1

uint32_t param_2: parameter 2

uint32_t assert_lr: link register

asssert_ctx_t ctx: register data struct

struct charger_info_t

charger relevant information data struct definition

Public Members

bool charger_info_valid: flag for information valid or not

uint8_t usb_level_state: usb level @drv_pmu_usb_voltage_e

uint8_t pd_type: power down type index

uint16_t current_voltage: current voltage

struct app_env_data_t

system environment information data struct definition

Public Members

app_env_data_hdr_t data_hdr: environment header data

app_env_data_sys_info_t sys_info: sysyem environment information

app_env_data_tws_info_t tws_info: TWS environment information

app_env_data_bt_record_t bt_record: BT record informaiton

app_env_data_ble_record_t ble_record: BLE record informaiton

assert_info_t assert_info: assert information

charger_info_t charger_info: charger information

struct app_env_t

system environment information and configre data struct definition

Public Members

app_env_data_t env_data: system environment information data

app_env_cfg_t env_cfg: system environment configure data

Macros

APP_ENV_ASSERT_FILE_LEN_MAX

APP_ENV_DATA_BT_RECORD_COUNT_MAX

APP_ENV_DATA_BLE_RECORD_COUNT_MAX

APP_ENV_CFG_NAME_LEN_MAX

APP_ENV_VOL_LEVEL_CNT_MAX

APP_HINTS_LANGS_CNT_MAX

APP_ENV_AUDIOEQ_DEF_CNT

APP_ENV_CFG_AT_FLASH_ADDR

APP_ENV_DATA_AT_FLASH_ADDR

APP_ENV_CALI_AT_FLASH_ADDR

APP_ENV_END_AT_FLASH_ADDR

BT_MODE_1V1

BT_MODE_1V2

BT_MODE_TWS

BT_MODE

APP_ENV_SYS_FLAG_UARTDBG: toolkit - feature - debug setting

APP_ENV_SYS_FLAG_IIC

APP_ENV_SYS_FLAG_A2DP_SRC: toolkit - feature - A2DP SRC

APP_ENV_SYS_FLAG_AGHFP: toolkit - feature - HFP AG

APP_ENV_SYS_FLAG_DAC_DIFFER: toolkit - audio base setting - audio output(0: Single-Ended 1:Differential)

APP_ENV_SYS_FLAG_L_is_LplusR: toolkit - feature - Audio=L+R

APP_ENV_SYS_FLAG_LED_REVERSE: toolkit - LED - output reverse

APP_ENV_SYS_FLAG_SD_DETECT_ENA: toolkit - feature - SD card detect enable

APP_ENV_SYS_FLAG_AD_LINEIN_ENA: toolkit - feature - line in detect enable

APP_ENV_SYS_FLAG_USB_ENA: toolkit - feature - USB enable

APP_ENV_SYS_FLAG_MIC_BIAS: toolket - audio base setting - Mic bias vol 0:1.8V 1:2.1V 2:2.4V 3:2.6V

APP_ENV_SYS_FLAG_DEFAULT

APP_ENV_BT_FLAG_A2DP: toolkit - feature - enable - A2DP enable

APP_ENV_BT_FLAG_HFP: toolkit - feature - enable - HFP enable

APP_ENV_BT_FLAG_PBAP: toolkit - feature - enable - PBAP enable

APP_ENV_BT_FLAG_AUTO_CONN: toolkit - sys param - power on reconnect - enable

APP_ENV_BT_FLAG_RECOV: toolkit - sys param - reconnect - enable

APP_ENV_BT_FLAG_ADDR_POLL: toolkit - sys param - power on reconnect - reconnect addr poll

APP_ENV_BT_FLAG_ADDR_AUDIO_DIAL: toolkit - feature - enable - dial audio report

APP_ENV_BT_FLAG_AUTO_CONN_PERIOD: toolkit - sys param - power on reconnect - Periodic reconnect

APP_ENV_BT_FLAG_APP_BAT_DISPLAY: toolkit - feature - battery level display setting

APP_ENV_BT_FLAG_DEFAULT

APP_ENV_FEATURE_FLAG_INQUIRY_ALWAYS: toolkit - feature - enable - power on start both-scan

APP_ENV_FEATURE_FLAG_DIG_BUCK_ENABLE: toolkit - feature - value setting - digital buck val enable

APP_ENV_FEATURE_FLAG_ANA_BUCK_ENABLE: toolkit - feature - value setting - analog buck val enable

APP_ENV_FEATURE_FLAG_CHARGEING_LOW_I_Vusb: toolkit - feature - enable - charging enter deep sleep

APP_ENV_FEATURE_FLAG_FREE_CONN: toolkit - feature - enable - free paring

APP_ENV_FEATURE_FLAG_CHARGE_MODE_PWR_DOWN: toolkit - feature - enable - power off when charging

APP_ENV_FEATURE_FLAG_MIC_SINGLE_ENABLE: toolket - audio base setting - mic input(1: Single-Ended 0:Differential)

APP_ENV_FEATURE_FLAG_DAC_DC_COMPENSATION: toolket - audio base setting - mic input

APP_ENV_FEATURE_FLAG_KEY_LOW_ACTIVE

APP_ENV_FEATURE_FLAG_DISABLE_IOS_INCOMING_RING: toolkit - feature - enable - disable in-band ring

APP_ENV_FEATURE_FLAG_VOLUME_RESTORE: Not used

APP_ENV_FEATURE_FLAG_VOLUME_SYNC: toolkit - feature - enable - volume sync

APP_ENV_FEATURE_FLAG_PAIRING_AFTER_PWR_ON: toolkit - sys param - power on/off setting - Long press enter paring mode

APP_ENV_FEATURE_FLAG_SPP_PROFILE: toolkit - feature - enable - SPP

APP_ENV_FEATURE_FLAG_HID_PROFILE: toolkit - feature - enable - HID

APP_ENV_FEATURE_FLAG_AEC_ENABLE: toolkit - call setting - aec test - enable

APP_ENV_FEATURE_FLAG_TWS_L_R_PWR_DOWN: toolkit - feature - enable - power down when left & right key sync-press

APP_ENV_FEATURE_FLAG_AAC_ENABLE: toolkit - feature - enable - AAC Enable

APP_ENV_FEATURE_FLAG_SLEEP_ENABLE: toolkit - feature - enable - sleep

APP_ENV_FEATURE_FLAG_FAST_MUTE: toolkit - feature - enable - auto mute in BT_mode

APP_ENV_FEATURE_FLAG_TWS_L_R_DIF_EN: toolkit - feature - value_setting - Distinguish between left and ring earsids.

APP_ENV_FEATURE_FLAG_TWS_L: toolkit - feature - value_setting - 1: left side 0: right side

APP_ENV_FEATURE_FLAG_POP_EN: toolkit - feature - enable - Pop-up prompt

APP_ENV_FEATURE_FLAG_MAX_BITPOOL: toolkit - feature - enable - high fidelity

APP_ENV_FEATURE_FLAG_UPDATE_BT_NAME: toolkit - feature - enable - Update BT name

APP_ENV_FEATURE_FLAG_TESTER: toolkit - feature - enable - product test(5V communicat)

APP_ENV_FEATURE_FLAG_ANA_LOW_VOLT: toolkit - feature - value setting - analog buck val setting(1: 1.6V 0:1.8V)

APP_ENV_FEATURE_FLAG_CHARGER_HIGH_VOLTAGE: toolkit - feature - enable - charging to high val(4.35V)

APP_ENV_DEATURE_FLAG_DEFAULT

APP_ENV_LE_FLAG_LE_ENABLE: toolkit - sys param - BLE seting - ble enable

APP_ENV_LE_FLAG_ADDR_NAME_CONFIG_ENABLE: toolkit - sys param - BLE setting - le address & name config

APP_ENV_LE_FLAG_ADV_CONFIG_ENABLE: toolkit - sys param - BLE setting - BLE ADV setting

APP_ENV_LE_FLAG_UPDATE_CONFIG_ENABLE: toolkit - sys param - BLE setting - BLE update connect para setting

APP_ENV_LE_FLAG_LE_AUDIO_ENABLE: toolkit - sys param - BLE setting - LE Audio

APP_ENV_LE_FLAG_MAX_TRAN_LATENCY_ENABLE: toolkit - sys param - BLE setting - MaxTransLatency

APP_ENV_LE_FLAG_PREF_PRESENTATION_DELAY_ENABLE: toolkit - sys param - BLE setting - Pref Delay

APP_ENV_LE_FLAG_SUPP_PRESENTATION_DELAY_ENABLE: toolkit - sys param - BLE setting - Supp Delay

APP_ENV_MIC_ANA_GAIN_9P5_DB

APP_ENV_MIC_ANA_GAIN_11P3_DB

APP_ENV_MIC_ANA_GAIN_13P1_DB

APP_ENV_MIC_ANA_GAIN_14P9_DB

APP_ENV_MIC_ANA_GAIN_16P7_DB

APP_ENV_MIC_ANA_GAIN_18P5_DB

APP_ENV_MIC_ANA_GAIN_20P3_DB

APP_ENV_MIC_ANA_GAIN_22P2_DB

APP_ENV_MIC_ANA_GAIN_24P0_DB

APP_ENV_MIC_ANA_GAIN_25P8_DB

APP_ENV_MIC_ANA_GAIN_27P6_DB

APP_ENV_MIC_ANA_GAIN_29P4_DB

APP_ENV_MIC_ANA_GAIN_31P2_DB

APP_ENV_MIC_ANA_GAIN_33P0_DB

APP_ENV_DEV_COD_WEAR_HEADSET

APP_ENV_DEV_COD_HANDSFREE

APP_ENV_DEV_COD_LOUD_SPEAKER

APP_ENV_DEV_COD_HEAD_PHONES

APP_ENV_DEV_COD_PORT_AUDIO

APP_ENV_DEV_COD_CAR_AUDIO

APP_ENV_RECONN_ACTION_ENTER_PAIRING

APP_ENV_RECONN_ACTION_RECONN

APP_ENV_BT_AUTO_PD_COND_NOCONN

APP_ENV_BT_AUTO_PD_COND_PAUSE_TO

APP_ENV_DISCONN_ACTION_W4_PARING

APP_ENV_DISCONN_ACTION_POWERON_RECONN

APP_ENV_ANA_VOL_1P55

APP_ENV_ANA_VOL_1P50

APP_ENV_ANA_VOL_1P45

APP_ENV_ANA_VOL_1P40

APP_ENV_ANA_VOL_1P35

APP_ENV_ANA_VOL_1P30

APP_ENV_ANA_VOL_1P25

APP_ENV_ANA_VOL_1P20

APP_ENV_DIG_VOL_0P60

APP_ENV_DIG_VOL_0P65

APP_ENV_DIG_VOL_0P70

APP_ENV_DIG_VOL_0P75

APP_ENV_DIG_VOL_0P80

APP_ENV_DIG_VOL_0P85

APP_ENV_DIG_VOL_0P90

APP_ENV_DIG_VOL_0P95

APP_ENC_DRC_ENABLE_ENDRC

DEFAULT_BLE_ENABLE

DEFAULT_ADV_INT

DEFAULT_CON_UPDATE_INTV

DEFAULT_CON_UPDATE_DELAY

APPL_GA_PREF_MAX_TRANS_LATENCY

APPL_GA_PREF_PRESENTATION_DELAY_MIN

APPL_GA_PREF_PRESENTATION_DELAY_MAX

APPL_GA_SUPP_PRESENTATION_DELAY_MIN

APPL_GA_SUPP_PRESENTATION_DELAY_MAX

APP_ENV_EQ_SR_16000

APP_ENV_EQ_SR_44100

APP_ENV_EQ_SR_48000

APP_ENV_EQ_TYPE_AUDIO

APP_ENV_EQ_TYPE_SPK

APP_ENV_EQ_TYPE_MIC

APP_ENV_EQ_EFFECT_CUSTOM

APP_ENV_EQ_EFFECT_FLAT

APP_ENV_EQ_EFFECT_BOOST

APP_ENV_EQ_EFFECT_TREBLE

APP_ENV_EQ_EFFECT_POP

APP_ENV_EQ_EFFECT_ROCK

APP_ENV_EQ_EFFECT_CLASSIC

APP_ENV_EQ_EFFECT_JAZZ

APP_ENV_EQ_EFFECT_DANCE

APP_ENV_EQ_EFFECT_RANDB

APP_ENV_EQ_FILTER_PKF

APP_ENV_EQ_FILTER_LSF

APP_ENV_EQ_FILTER_HSF

APP_ENV_EQ_FILTER_LPF

APP_ENV_EQ_FILTER_HPF

APP_ENV_EQ_FILTER_BPF

APP_ENV_EQ_FILTER_NTF

APP_ENV_EQ_FILTER_APF

APP_ENV_HINT_CODEC_INTER_FLASH_WAV

APP_ENV_HINT_CODEC_INTER_FLASH_SBC

APP_ENV_HINT_CODEC_INTER_FLASH_AMR

APP_ENV_HINT_CODEC_EXT_FLASH_WAV

APP_ENV_HINT_CODEC_EXT_FLASH_SBC

APP_ENV_HINT_CODEC_EXT_FLASH_AMR

Type Definitions

typedef uint16_t bt_mode_t: BT mode value definition.

typedef uint32_t app_env_sys_flag_t: system environment bitmap definition

typedef uint32_t app_env_bt_flag_t: bluetooth environment bitmap definition

typedef uint32_t app_env_feat_flag_t: feature environment bitmap definition

typedef uint16_t app_env_le_flag_t: BLE environment bitmap definition.

typedef uint8_t app_env_mic_ana_gain_t: MIC analog gain setting index defintion.

typedef uint8_t app_env_dev_cod_t: class of device index definition

typedef int8_t app_env_reconn_action_t: bluetooth re-connection action definition

typedef uint8_t app_env_auto_pd_cond_t: auto power down condtion setting index definition

typedef uint8_t app_env_disconn_action_t: action after disconnecting with remote device index definition

typedef uint8_t app_env_ana_vol_t: environment analog voltage index definition

typedef uint8_t app_env_dig_vol_t: environment digital voltage index definition

typedef uint8_t app_env_eq_sr_t: EQ simping rate index defintion.

typedef uint8_t app_env_eq_type_t: EQ type index definition.

typedef uint8_t app_env_eq_effect_t: EQ default effect configured index definition.

typedef uint8_t app_env_eq_filter_t: EQ filter type index definition.

typedef uint8_t app_env_hint_codec_t: hints codec type index definition

typedef struct _app_hints_info_s app_hints_info_t: hints information data struct definition

Enumerations

enum app_env_charging_current_t

charging current index defintion

Values:

enumerator CHARGING_CURR_20MA

enumerator CHARGING_CURR_30MA

enumerator CHARGING_CURR_40MA

enumerator CHARGING_CURR_50MA

enumerator CHARGING_CURR_60MA

enumerator CHARGING_CURR_70MA

enumerator CHARGING_CURR_80MA

enumerator CHARGING_CURR_90MA

enumerator CHARGING_CURR_100MA

enumerator CHARGING_CURR_110MA

enum WAVE_EVENT_LIST

hints event type index definition

Values:

enumerator WAVE_INVALID

enumerator WAVE_POWER_ON

enumerator WAVE_CONNECTED

enumerator WAVE_DISCONNECTED

enumerator WAVE_POWER_OFF

enumerator WAVE_ENTER_PAIRING

enumerator WAVE_LOW_BATTERY

enumerator WAVE_HFP_RING

enumerator WAVE_HFP_ACK

enumerator WAVE_HF_REJECT

enumerator WAVE_HF_CANCEL

enumerator WAVE_HF_VOICE_DIAL

enumerator WAVE_MUTE_MIC

enumerator WAVE_UNMUTE_MIC

enumerator WAVE_VOL_MAX

enumerator WAVE_VOL_MIN

enumerator WAVE_HF_TRANSFER_TOGGLE

enumerator WAVE_HF_REDIAL

enumerator WAVE_CLEAR_MEMORY

enumerator WAVE_VOICE_NUM0

enumerator WAVE_VOICE_NUM1

enumerator WAVE_VOICE_NUM2

enumerator WAVE_VOICE_NUM3

enumerator WAVE_VOICE_NUM4

enumerator WAVE_VOICE_NUM5

enumerator WAVE_VOICE_NUM6

enumerator WAVE_VOICE_NUM7

enumerator WAVE_VOICE_NUM8

enumerator WAVE_VOICE_NUM9

enumerator WAVE_BT_MODE

enumerator WAVE_UDISK_MODE

enumerator WAVE_FM_MODE

enumerator WAVE_LINEIN_MODE

enumerator WAVE_SDCARD_MODE

enumerator WAVE_RESERVED1

enumerator WAVE_RESERVED2

enumerator WAVE_RESERVED3

enumerator WAVE_RESERVED4

enumerator WAVE_RESERVED5

enumerator WAVE_RESERVED6

enumerator WAVE_RESERVED7

enumerator WAVE_RESERVED8

enumerator WAVE_RESERVED9

enumerator WAVE_END

enum WAVE_TYPE_LIST

hints codec type index definition

Values:

enumerator INTER_FLASH_WAV

enumerator INTER_FLASH_SBC

enumerator INTER_FLASH_AMR

enumerator EXT_FLASH_WAV

enumerator EXT_FLASH_SBC

enumerator EXT_FLASH_AMR

enumerator INTER_SOFT_WAVE

enum WAVE_BITPOOL_INDEX

hints bitpool index definition

Values:

enumerator WAVE_NONE

enumerator _80_512

enumerator _96_512

enumerator _112_512

enumerator _128_512