CI130X SDK API手册  2.2.0
本手册用于描述CI130X SDK各个组件和驱动API
结构体 | 枚举 | 函数

es8388的驱动 更多...

结构体

struct  es8388_input_cha_t
 8388 ADC input channal选择的结构体 更多...
 
struct  es8388_alc_config_t
 8388 ALC配置 更多...
 

枚举

enum  es8388_cha_sel_t {
  ES8388_CHA_RIGHT = 0,
  ES8388_CHA_LEFT = 1,
  ES8388_CHA_STEREO = 2
}
 8388通道选择 更多...
 
enum  es8388_mode_sel_t {
  ES8388_MODE_SLAVE = 0,
  ES8388_MODE_MASTER = 1
}
 8388主从模式设置 更多...
 
enum  es8388_adc_data_len_t {
  ES8388_ADC_DATA_LEN_24BIT =(0x0<<2),
  ES8388_ADC_DATA_LEN_20BIT =(0x1<<2),
  ES8388_ADC_DATA_LEN_18BIT =(0x2<<2),
  ES8388_ADC_DATA_LEN_16BIT =(0x3<<2),
  ES8388_ADC_DATA_LEN_32BIT =(0x4<<2)
}
 8388数据宽度设置 更多...
 
enum  es8388_adc_data_format_t {
  ES8388_ADC_DATA_FORMAT_I2S =(0x0<<0),
  ES8388_ADC_DATA_FORMAT_LEFT_JUSTIFY =(0x1<<0),
  ES8388_ADC_DATA_FORMAT_RIGHT_JUSTIFY =(0x2<<0),
  ES8388_ADC_DATA_FORMAT_PCM_JUSTIFY =(0x3<<0)
}
 8388数据格式设置 更多...
 
enum  es8388_alc_maxgain_t {
  ES8388_ALC_MAXGAIN__6_5dB = (0<<3),
  ES8388_ALC_MAXGAIN__0_5dB = (1<<3),
  ES8388_ALC_MAXGAIN_5_5dB = (2<<3),
  ES8388_ALC_MAXGAIN_11_5dB = (3<<3),
  ES8388_ALC_MAXGAIN_17_5dB = (4<<3),
  ES8388_ALC_MAXGAIN_23_5dB = (5<<3),
  ES8388_ALC_MAXGAIN_29_5dB = (6<<3),
  ES8388_ALC_MAXGAIN_35_5dB = (7<<3)
}
 8388 ALC调节上限 更多...
 
enum  es8388_alc_mingain_t {
  ES8388_ALC_MINGAIN__12dB = (0<<0),
  ES8388_ALC_MINGAIN__6dB = (1<<0),
  ES8388_ALC_MINGAIN_0dB = (2<<0),
  ES8388_ALC_MINGAIN_6dB = (3<<0),
  ES8388_ALC_MINGAIN_12dB = (4<<0),
  ES8388_ALC_MINGAIN_18dB = (5<<0),
  ES8388_ALC_MINGAIN_24dB = (6<<0),
  ES8388_ALC_MINGAIN_30dB = (7<<0)
}
 8388 ALC调节下限 更多...
 
enum  es8388_alc_level_t {
  ES8388_ALC_LEVEL__16_5dB = (0<<4),
  ES8388_ALC_LEVEL__15dB = (1<<4),
  ES8388_ALC_LEVEL__13_5dB = (2<<4),
  ES8388_ALC_LEVEL__12dB = (3<<4),
  ES8388_ALC_LEVEL__10_5dB = (4<<4),
  ES8388_ALC_LEVEL__9dB = (5<<4),
  ES8388_ALC_LEVEL__7_5dB = (6<<4),
  ES8388_ALC_LEVEL__6dB = (7<<4),
  ES8388_ALC_LEVEL__4_5dB = (8<<4),
  ES8388_ALC_LEVEL__3dB = (9<<4),
  ES8388_ALC_LEVEL__1_5dB = (10<<4)
}
 8388 ALC目标幅值(dB为单位) 更多...
 
enum  es8388_alc_cha_gate_t {
  ES8388_ALC_OFF = (0<<6),
  ES8388_ALC_R_ONLY = (1<<6),
  ES8388_ALC_L_ONLY = (2<<6),
  ES8388_ALC_STEREO = (3<<6)
}
 8388 ALC通道选择 更多...
 
enum  es8388_num_sel_t {
  ES8388_NUM1 = 1,
  ES8388_NUM2 = 2,
  ES8388_NUM3 = 3
}
 
enum  es8388_mic_amp_t {
  ES8388_MICAMP_0dB = 0,
  ES8388_MICAMP_3dB,
  ES8388_MICAMP_6dB,
  ES8388_MICAMP_9dB,
  ES8388_MICAMP_12dB,
  ES8388_MICAMP_15dB,
  ES8388_MICAMP_18dB,
  ES8388_MICAMP_21dB,
  ES8388_MICAMP_24dB,
  ES8388_MICAMP_27dB,
  ES8388_MICAMP_30dB,
  ES8388_MICAMP_33dB
}
 8388 MIC增益 更多...
 
enum  es8388_adc_inv_sel_t {
  ES8388_ADC_INV_DISABLE = 0,
  ES8388_ADC_INV_ENABLE = 1
}
 8388 ADC数据极性选择,ENABLE和DISABLE的数据的相位有180度的差距 更多...
 
enum  es8388_dac_data_len_t {
  ES8388_DAC_DATA_LEN_24BIT = (0x0<<3),
  ES8388_DAC_DATA_LEN_20BIT = (0x1<<3),
  ES8388_DAC_DATA_LEN_18BIT = (0x2<<3),
  ES8388_DAC_DATA_LEN_16BIT = (0x3<<3),
  ES8388_DAC_DATA_LEN_32BIT = (0x4<<3)
}
 8388 DAC数据宽度 更多...
 
enum  es8388_dac_data_format_t {
  ES8388_DAC_DATA_FORMAT_I2S =(0x0<<1),
  ES8388_DAC_DATA_FORMAT_LEFT_JUSTIFY =(0x1<<1),
  ES8388_DAC_DATA_FORMAT_RIGHT_JUSTIFY =(0x2<<1),
  ES8388_DAC_DATA_FORMAT_PCM_JUSTIFY =(0x3<<1)
}
 8388 DAC数据格式 更多...
 

函数

int32_t ES8388_ADC_data_format_set (es8388_num_sel_t num_8388, es8388_adc_data_len_t data_length, es8388_adc_data_format_t data_format)
 ADC的数据格式设置 更多...
 
int32_t ES8388_ADC_mic_amplify_set (es8388_num_sel_t num_8388, es8388_mic_amp_t l_amp, es8388_mic_amp_t r_amp)
 设置8388 MIC增益的设置 更多...
 
int32_t ES8388_ALC_config (es8388_num_sel_t num_8388, es8388_alc_config_t *ALC_Type, es8388_alc_cha_gate_t ALC_gate)
 配置8388的ALC 更多...
 
int32_t ES8388_ADC_invl_config (es8388_num_sel_t num_8388, es8388_adc_inv_sel_t gate_l, es8388_adc_inv_sel_t gate_r)
 设置8388 ADC 数据极性反转 更多...
 
void ES8388_aec_setting (es8388_num_sel_t num_8388)
 在AEC的情况下8388的配置(参照一代工程) 更多...
 
void ES8388_alc_gate (es8388_num_sel_t num_8388, es8388_alc_cha_gate_t ALC_gate)
 
void ES8388_alc_max_gain_set (es8388_num_sel_t num_8388, es8388_alc_maxgain_t max_gain)
 
int32_t ES8388_DAC_data_format_set (es8388_num_sel_t num_8388, es8388_dac_data_len_t data_length, es8388_dac_data_format_t data_format)
 设置8388 DAC数据格式设置 更多...
 
int32_t ES8388_dac_vol_set (es8388_num_sel_t num_8388, int32_t l1vol, int32_t r1vol, int32_t l2vol, int32_t r2vol)
 DAC四个通道的声音大小的设置 更多...
 
void ES8388_DAC_mute (es8388_num_sel_t num_8388, FunctionalState cmd)
 DAC mute开关 更多...
 
void ES8388_DAC_power (es8388_num_sel_t num_8388, es8388_cha_sel_t cha, FunctionalState cmd)
 各个通道DAC电源的开关 更多...
 
int32_t ES8388_play_init (es8388_num_sel_t es8388_num)
 根据8388的编号初始化8388 更多...
 

详细描述

es8388的驱动


结构体说明

◆ es8388_input_cha_t

struct es8388_input_cha_t

8388 ADC input channal选择的结构体

成员变量
uint8_t ds_sel
uint8_t dsl
uint8_t dsr
uint8_t l_input_single_sel ADC 左通道输入模式选择
uint8_t monomix
uint8_t r_input_single_sel ADC 右通道输入模式选择
uint8_t tri

◆ es8388_alc_config_t

struct es8388_alc_config_t

8388 ALC配置

成员变量
es8388_alc_level_t alc_level 8388 ALC 目标幅值设置
es8388_alc_maxgain_t alc_maxgain 8388 ALC 最大增益设置
es8388_alc_mingain_t alc_mingain 8388 ALC 最小增益设置

枚举类型说明

◆ es8388_adc_data_format_t

8388数据格式设置

枚举值
ES8388_ADC_DATA_FORMAT_I2S 

8388 ADC数据格式为标准IIS格式

ES8388_ADC_DATA_FORMAT_LEFT_JUSTIFY 

8388 ADC数据格式为左对齐格式

ES8388_ADC_DATA_FORMAT_RIGHT_JUSTIFY 

8388 ADC数据格式为右对齐格式

ES8388_ADC_DATA_FORMAT_PCM_JUSTIFY 

8388 ADC数据格式为PCM格式

◆ es8388_adc_data_len_t

8388数据宽度设置

枚举值
ES8388_ADC_DATA_LEN_24BIT 

8388 ADC数据宽度为24bit

ES8388_ADC_DATA_LEN_20BIT 

8388 ADC数据宽度为20bit

ES8388_ADC_DATA_LEN_18BIT 

8388 ADC数据宽度为18bit

ES8388_ADC_DATA_LEN_16BIT 

8388 ADC数据宽度为16bit

ES8388_ADC_DATA_LEN_32BIT 

8388 ADC数据宽度为32bit

◆ es8388_adc_inv_sel_t

8388 ADC数据极性选择,ENABLE和DISABLE的数据的相位有180度的差距

枚举值
ES8388_ADC_INV_DISABLE 

8388 ADC采集的数据相位不变

ES8388_ADC_INV_ENABLE 

8388 ADC采集的数据相位调整180度

◆ es8388_alc_cha_gate_t

8388 ALC通道选择

枚举值
ES8388_ALC_OFF 

8388 ALC关闭

ES8388_ALC_R_ONLY 

8388 ALC 只开启右通道

ES8388_ALC_L_ONLY 

8388 ALC 只开启左通道

ES8388_ALC_STEREO 

8388 ALC开启双通道

◆ es8388_alc_level_t

8388 ALC目标幅值(dB为单位)

枚举值
ES8388_ALC_LEVEL__16_5dB 

目标幅值:-16.5dB

ES8388_ALC_LEVEL__15dB 

目标幅值:-15dB

ES8388_ALC_LEVEL__13_5dB 

目标幅值:-13.5dB

ES8388_ALC_LEVEL__12dB 

目标幅值:-12dB

ES8388_ALC_LEVEL__10_5dB 

目标幅值:-10.5dB

ES8388_ALC_LEVEL__9dB 

目标幅值:-9dB

ES8388_ALC_LEVEL__7_5dB 

目标幅值:-7.5dB

ES8388_ALC_LEVEL__6dB 

目标幅值:-6dB

ES8388_ALC_LEVEL__4_5dB 

目标幅值:-4.5dB

ES8388_ALC_LEVEL__3dB 

目标幅值:-3dB

ES8388_ALC_LEVEL__1_5dB 

目标幅值:-1.5dB

◆ es8388_alc_maxgain_t

8388 ALC调节上限

枚举值
ES8388_ALC_MAXGAIN__6_5dB 

8388 ALC调节增益上限为-6.5dB

ES8388_ALC_MAXGAIN__0_5dB 

8388 ALC调节增益上限为-0.5dB

ES8388_ALC_MAXGAIN_5_5dB 

8388 ALC调节增益上限为5.5dB

ES8388_ALC_MAXGAIN_11_5dB 

8388 ALC调节增益上限为11.5dB

ES8388_ALC_MAXGAIN_17_5dB 

8388 ALC调节增益上限为17.5dB

ES8388_ALC_MAXGAIN_23_5dB 

8388 ALC调节增益上限为23.5dB

ES8388_ALC_MAXGAIN_29_5dB 

8388 ALC调节增益上限为29.5dB

ES8388_ALC_MAXGAIN_35_5dB 

8388 ALC调节增益上限为35.5dB

◆ es8388_alc_mingain_t

8388 ALC调节下限

枚举值
ES8388_ALC_MINGAIN__12dB 

8388 ALC调节增益下限为-12dB

ES8388_ALC_MINGAIN__6dB 

8388 ALC调节增益下限为-6dB

ES8388_ALC_MINGAIN_0dB 

8388 ALC调节增益下限为0dB

ES8388_ALC_MINGAIN_6dB 

8388 ALC调节增益下限为6dB

ES8388_ALC_MINGAIN_12dB 

8388 ALC调节增益下限为12dB

ES8388_ALC_MINGAIN_18dB 

8388 ALC调节增益下限为18dB

ES8388_ALC_MINGAIN_24dB 

8388 ALC调节增益下限为24dB

ES8388_ALC_MINGAIN_30dB 

8388 ALC调节增益下限为30dB

◆ es8388_cha_sel_t

8388通道选择

枚举值
ES8388_CHA_RIGHT 

右声道

ES8388_CHA_LEFT 

左声道

ES8388_CHA_STEREO 

双声道

◆ es8388_dac_data_format_t

8388 DAC数据格式

枚举值
ES8388_DAC_DATA_FORMAT_I2S 

8388 DAC数据格式为标准IIS格式

ES8388_DAC_DATA_FORMAT_LEFT_JUSTIFY 

8388 DAC数据格式为左对齐格式

ES8388_DAC_DATA_FORMAT_RIGHT_JUSTIFY 

8388 DAC数据格式为右对齐格式

ES8388_DAC_DATA_FORMAT_PCM_JUSTIFY 

8388 DAC数据格式为PCM格式

◆ es8388_dac_data_len_t

8388 DAC数据宽度

枚举值
ES8388_DAC_DATA_LEN_24BIT 

8388 DAC数据宽度24bit

ES8388_DAC_DATA_LEN_20BIT 

8388 DAC数据宽度20bit

ES8388_DAC_DATA_LEN_18BIT 

8388 DAC数据宽度18bit

ES8388_DAC_DATA_LEN_16BIT 

8388 DAC数据宽度16bit

ES8388_DAC_DATA_LEN_32BIT 

8388 DAC数据宽度32bit

◆ es8388_mic_amp_t

8388 MIC增益

枚举值
ES8388_MICAMP_0dB 

8388 MIC增益0dB

ES8388_MICAMP_3dB 

8388 MIC增益3dB

ES8388_MICAMP_6dB 

8388 MIC增益6dB

ES8388_MICAMP_9dB 

8388 MIC增益9dB

ES8388_MICAMP_12dB 

8388 MIC增益12dB

ES8388_MICAMP_15dB 

8388 MIC增益15dB

ES8388_MICAMP_18dB 

8388 MIC增益18dB

ES8388_MICAMP_21dB 

8388 MIC增益21dB

ES8388_MICAMP_24dB 

8388 MIC增益24dB

ES8388_MICAMP_27dB 

8388 MIC增益27dB

ES8388_MICAMP_30dB 

8388 MIC增益30dB

ES8388_MICAMP_33dB 

8388 MIC增益33dB

◆ es8388_mode_sel_t

8388主从模式设置

枚举值
ES8388_MODE_SLAVE 

8388做从模式

ES8388_MODE_MASTER 

8388做主模式

◆ es8388_num_sel_t

枚举值
ES8388_NUM1 
ES8388_NUM2 
ES8388_NUM3 

函数说明

◆ ES8388_ADC_data_format_set()

int32_t ES8388_ADC_data_format_set ( es8388_num_sel_t  num_8388,
es8388_adc_data_len_t  data_length,
es8388_adc_data_format_t  data_format 
)

ADC的数据格式设置

参数
num_83888388编号
data_length数据宽度
data_format数据格式:左右对齐;标准I2S
返回
int32_t 正确

◆ ES8388_ADC_invl_config()

int32_t ES8388_ADC_invl_config ( es8388_num_sel_t  num_8388,
es8388_adc_inv_sel_t  gate_l,
es8388_adc_inv_sel_t  gate_r 
)

设置8388 ADC 数据极性反转

参数
num_83888388编号
gate_l左声道数据极性反转开关
gate_r右声道数据极性反转开关
返回
int32_t 正确

◆ ES8388_ADC_mic_amplify_set()

int32_t ES8388_ADC_mic_amplify_set ( es8388_num_sel_t  num_8388,
es8388_mic_amp_t  l_amp,
es8388_mic_amp_t  r_amp 
)

设置8388 MIC增益的设置

参数
num_83888388编号
l_amp左通道MIC的增益
r_amp右通道MIC的增益
返回
int32_t 正确

◆ ES8388_aec_setting()

void ES8388_aec_setting ( es8388_num_sel_t  num_8388)

在AEC的情况下8388的配置(参照一代工程)

参数
num_83888388编号

◆ ES8388_ALC_config()

int32_t ES8388_ALC_config ( es8388_num_sel_t  num_8388,
es8388_alc_config_t ALC_str,
es8388_alc_cha_gate_t  ALC_gate 
)

配置8388的ALC

参数
num_83888388编号
ALC_strES8388_ALC_Config_TypeDef类型结构体指针
ALC_gate左声道、右声道或者双声道的ALC开关
返回
int32_t 正确

◆ ES8388_alc_gate()

void ES8388_alc_gate ( es8388_num_sel_t  num_8388,
es8388_alc_cha_gate_t  ALC_gate 
)

◆ ES8388_alc_max_gain_set()

void ES8388_alc_max_gain_set ( es8388_num_sel_t  num_8388,
es8388_alc_maxgain_t  max_gain 
)

◆ ES8388_DAC_data_format_set()

int32_t ES8388_DAC_data_format_set ( es8388_num_sel_t  num_8388,
es8388_dac_data_len_t  data_length,
es8388_dac_data_format_t  data_format 
)

设置8388 DAC数据格式设置

参数
num_83888388编号
data_length数据的宽度
data_format数据的格式
返回
int32_t 正确

◆ ES8388_DAC_mute()

void ES8388_DAC_mute ( es8388_num_sel_t  num_8388,
FunctionalState  cmd 
)

DAC mute开关

参数
num_83888388编号
cmd开关

◆ ES8388_DAC_power()

void ES8388_DAC_power ( es8388_num_sel_t  num_8388,
es8388_cha_sel_t  cha,
FunctionalState  cmd 
)

各个通道DAC电源的开关

参数
num_83888388编号
chaDAc通道选择
cmd开关

◆ ES8388_dac_vol_set()

int32_t ES8388_dac_vol_set ( es8388_num_sel_t  num_8388,
int32_t  l1vol,
int32_t  r1vol,
int32_t  l2vol,
int32_t  r2vol 
)

DAC四个通道的声音大小的设置

参数
num_83888388编号
l1vol设置声音大小的范围为(-30dB - 3dB),需为整数
r1vol设置声音大小的范围为(-30dB - 3dB),需为整数
l2vol设置声音大小的范围为(-30dB - 3dB),需为整数
r2vol设置声音大小的范围为(-30dB - 3dB),需为整数
返回
int32_t 正确

◆ ES8388_play_init()

int32_t ES8388_play_init ( es8388_num_sel_t  num_8388)

根据8388的编号初始化8388

参数
num_83888388编号
返回
int32_t 正确