Steven/3d_audio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update hid commands

Browse Source
This commit is contained in:
Steven Dan
2026-03-28 12:27:05 +08:00
parent d5338de59b
commit a15bfeb615
5 changed files with 385 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

118
sw_usb_audio/app_usb_aud_phaten_golden_6ch/src/extensions/audiohw.xc
View File

@@ -88,6 +88,8 @@ unsigned g_last_mic_volume_level = 0xFF; // 上次已上报的麦克风增益
unsigned g_dnr_strength = 100; // AI降噪强度HID值（0=关，2-100=开，步进2；100→-200dB最强）
unsigned g_last_dnr_strength = 0xFF; // 上次已上报的降噪强度，0xFF表示首次未上报（触发开机上报）
unsigned g_request_dnr_strength_set = 0; // HID 0x85 SET_AI_NOISE_STRENGTH待处理标志
unsigned g_monitor_switch = 0; // 耳返开关（0=关闭，1=开启），默认关闭
unsigned g_request_monitor_switch_set = 0; // HID 0x87 SET_MONITOR_SWITCH待处理标志
unsigned g_dac_m_gain = 0;
unsigned g_unmute_delay_time = 0;
unsigned g_format_delay_time = 0;
@@ -421,6 +423,9 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
unsigned char path[] = "game_mode";
unsigned char mic_vol_path[] = "mic_vol";
unsigned char dac_vol_path[] = "dac_vol";
unsigned char mic_mute_path[] = "mic_mute";
unsigned char hp_mute_path[] = "hp_mute";
unsigned char monitor_sw_path[] = "monitor_sw";
unsigned host_os;
delay_milliseconds(10);
@@ -555,6 +560,41 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
dac_level = saved_dac;
else
save_value(dac_vol_path, (unsigned char)dac_level); // 出厂默认15(-14dB)
// 从Flash恢复耳返开关（默认关闭）
unsigned char saved_monitor_sw = load_value(monitor_sw_path);
if(saved_monitor_sw == 1)
g_monitor_switch = 1;
else if(saved_monitor_sw == 255) {
// 未初始化：出厂默认关闭
g_monitor_switch = 0;
save_value(monitor_sw_path, (unsigned char)0);
} else {
g_monitor_switch = 0;
}
debug_printf("Loaded monitor_switch from flash: %d\n", g_monitor_switch);
// 从Flash恢复mic_mute状态（默认关闭=未静音）
unsigned char saved_mic_mute = load_value(mic_mute_path);
if(saved_mic_mute == 1)
flag_mic_mute = 1;
else {
flag_mic_mute = 0;
if(saved_mic_mute == 255)
save_value(mic_mute_path, (unsigned char)0);
}
debug_printf("Loaded mic_mute from flash: %d\n", flag_mic_mute);
// 从Flash恢复hp_mute状态（默认关闭=未静音）
unsigned char saved_hp_mute = load_value(hp_mute_path);
if(saved_hp_mute == 1)
flag_hp_mute = 1;
else {
flag_hp_mute = 0;
if(saved_hp_mute == 255)
save_value(hp_mute_path, (unsigned char)0);
}
debug_printf("Loaded hp_mute from flash: %d\n", flag_hp_mute);
}
codec_init();
@@ -563,10 +603,11 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
// 麦克风HID范围上限37 (register=38的+1.5dB仅firmware内部使用)
g_mic_volume_level = (codec_adc_pga_gain_reg_value <= 37) ? codec_adc_pga_gain_reg_value : 37;
// ADCL PGA default setting
mic_volume(codec_adc_pga_gain_reg_value); // make sure to write adc reg after initialize the codec, otherwise it does not take effect because of the hardware reset in the initial code
// ADCL PGA default setting（mic_volume内部已根据g_monitor_switch决定是否启用耳返通路）
// 若mic_mute已从flash恢复为1，则此处先以正常gain调用，再用mute覆盖
mic_volume(codec_adc_pga_gain_reg_value);
{
int mic_led_count = mic_gain_to_led[codec_adc_pga_gain_reg_value];
int mic_led_count = flag_mic_mute ? 0 : mic_gain_to_led[codec_adc_pga_gain_reg_value];
for(int i = 0; i < 15; i++)
{
if (i < mic_led_count)
@@ -575,6 +616,11 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
led_off(&led_ctx, led_l_physical_map[i]);
}
}
// 应用从flash恢复的mic_mute状态
if(flag_mic_mute) {
mic_volume(0);
g_mic_volume_level = 0;
}
// DAC 默认音量（mute 时写 0x0000）
if(dac_level == DAC_LEVEL_MIN)
@@ -582,7 +628,7 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
else
dac_volume(dac_level - DAC_LEVEL_MAX);
{
int dac_led_count = dac_gain_to_led[dac_level];
int dac_led_count = flag_hp_mute ? 0 : dac_gain_to_led[dac_level];
for(int i = 0; i < 15; i++)
{
if (i < dac_led_count)
@@ -591,6 +637,11 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
led_off(&led_ctx, led_d_physical_map[i]);
}
}
// 应用从flash恢复的hp_mute状态
if(flag_hp_mute) {
unsafe { NAU88C22_REGWRITE(0x0034, 0x0000, (client interface i2c_master_if)i_i2c_client); }
g_volume_level = 0;
}
// Initialize mode button LEDs: at most one may be lit at a time
led_off(&led_ctx, LED_MUSIC);
led_off(&led_ctx, LED_GAME_MODE);
@@ -976,6 +1027,9 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
lfs_remove_file("mic_vol");
lfs_remove_file("dac_vol");
lfs_remove_file("footstep");
lfs_remove_file("monitor_sw");
lfs_remove_file("mic_mute");
lfs_remove_file("hp_mute");
}
led_on(&led_ctx, LED_MUSIC);
@@ -1305,6 +1359,11 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
}
}
push_button_mic_mute_state_old = button_mic_mute;
if(mode_change)
{
save_value(mic_mute_path, (unsigned char)flag_mic_mute);
debug_printf("mic_mute changed: %d, saved to flash\n", flag_mic_mute);
}
if(mode_change)
if(flag_mic_mute)
{
@@ -1328,34 +1387,6 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
led_on(&led_ctx, led_l_physical_map[i]);
}
}
// mic_gain = 0;
// if((mic_encoder1 & 0b0100) != 0) mic_gain |= 0b0010;
// if((mic_encoder2 & 0b0100) != 0) mic_gain |= 0b1000;
//mic_gain >>= 4;
// if((mic_gain & 0b0100) == 0)
// {
// if(mute_down)
// {
// SET_SHARED_GLOBAL(g_reduct_dep, ++mic_mute % 4);
// }
// // if ((mic_mute % 4) == 0)
// // set_gpio(P_GPIO_LED, 0);
// // else
// // set_gpio(P_GPIO_LED, 1);
// mute_down = 0;
// }
// else
// {
// mute_down = 1;
// }
uint8_t rotating = (mic_encoder2 & 0b0100) == 0; // 4E2
uint8_t encode_input1 = ((mic_encoder1 & 0b0100) != 0); // 4F2
@@ -1566,6 +1597,11 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
}
}
push_button_hp_mute_state_old = button_hp_mute;
if(mode_change)
{
save_value(hp_mute_path, (unsigned char)flag_hp_mute);
debug_printf("hp_mute changed: %d, saved to flash\n", flag_hp_mute);
}
if(mode_change)
if(flag_hp_mute)
{
@@ -1659,8 +1695,21 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
}
}
// 处理HID SET_MONITOR_SWITCH (0x87) 请求：设置耳返开关
if (g_request_monitor_switch_set) {
g_request_monitor_switch_set = 0;
unsigned new_mon = g_monitor_switch;
// 根据当前mic状态和新的耳返开关值更新reg 0x30
if (new_mon && !flag_mic_mute && codec_adc_pga_gain_reg_value >= 2) {
unsafe { NAU88C22_REGWRITE(0x0030, 0xff00, (client interface i2c_master_if)i_i2c_client); }
} else {
unsafe { NAU88C22_REGWRITE(0x0030, 0x0000, (client interface i2c_master_if)i_i2c_client); }
}
save_value(monitor_sw_path, (unsigned char)new_mon);
debug_printf("HID SET_MONITOR_SWITCH: %d\n", new_mon);
}
// 处理HID SET_AI_NOISE_STRENGTH (0x85) 请求
#if DNR_ENABLE == 1
{
unsigned dnr_req;
GET_SHARED_GLOBAL(dnr_req, g_request_dnr_strength_set);
@@ -1668,7 +1717,9 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
SET_SHARED_GLOBAL(g_request_dnr_strength_set, 0);
unsigned new_strength;
GET_SHARED_GLOBAL(new_strength, g_dnr_strength);
#if DNR_ENABLE == 1
dnr_set_strength_level((unsigned char)new_strength);
#endif
if (new_strength == 0) {
flag_aidenoise_onoff = 0;
led_off(&led_ctx, LED_ANC);
@@ -1681,7 +1732,6 @@ void button_task(chanend c_hidSendData, chanend cc_mic_level, chanend c_uac_vol,
debug_printf("HID SET_AI_NOISE_STRENGTH: strength=%d\n", new_strength);
}
}
#endif
#if HID_CONTROLS == 1
// HID监听音量变化主动上报（编码器旋转或HID命令导致的音量变化）

37
sw_usb_audio/app_usb_aud_phaten_golden_6ch/src/extensions/eq.c
View File

@@ -638,6 +638,7 @@ unsigned char process_send_params(uint8_t data[], uint16_t len) {
extern unsigned g_request_mic_volume_set;
g_mic_volume_level = mic_level;
g_request_mic_volume_set = 1;
read_request.pending_cmd = 0x83; // 设置后用0x83格式回报当前增益
return true;
}
@@ -669,6 +670,27 @@ unsigned char process_send_params(uint8_t data[], uint16_t len) {
return true;
}
// 处理设置耳返开关命令 (0x87) - SET_MONITOR_SWITCH
// 0=关闭耳返（ADC不路由到耳机输出），1=开启耳返
if (data[1] == 0x87) {
uint8_t mon_sw = data[2];
if (mon_sw > 1) {
return false;
}
extern unsigned g_monitor_switch;
extern unsigned g_request_monitor_switch_set;
g_monitor_switch = mon_sw;
g_request_monitor_switch_set = 1;
read_request.pending_cmd = 0x88; // 设置后用0x88格式回报当前状态
return true;
}
// 处理读取耳返开关命令 (0x88) - GET_MONITOR_SWITCH
if (data[1] == 0x88) {
read_request.pending_cmd = 0x88;
return true;
}
// 处理设置音量命令 (0x93) - SET_VOLUME
// 范围: 0-15 (0=静音, 1-15=-28dB~0dB, 2dB/步)
if (data[1] == 0x93) {
@@ -758,6 +780,9 @@ unsigned char process_send_params(uint8_t data[], uint16_t len) {
lfs_remove_file("mic_vol");
lfs_remove_file("dac_vol");
lfs_remove_file("footstep");
lfs_remove_file("monitor_sw");
lfs_remove_file("mic_mute");
lfs_remove_file("hp_mute");
// 删除EQ flash数据
eq_flash_clear_all();
// 通知button_task在合适时机重启（避免在USB上下文中直接reboot）
@@ -1061,6 +1086,18 @@ unsigned char process_read_params(uint8_t response[]) {
read_request.pending_cmd = 0;
return true;
}
// 处理耳返开关请求/响应 (0x88) - GET_MONITOR_SWITCH
if (read_request.pending_cmd == 0x88) {
RSP_HDR(response, 0x88);
extern unsigned g_monitor_switch;
response[2] = (uint8_t)g_monitor_switch;
read_request.pending_cmd = 0;
return true;
}
// 处理读取音量请求 (0x94) - GET_VOLUME
if (read_request.pending_cmd == 0x94) {
RSP_HDR(response, 0x94);

115
sw_usb_audio/app_usb_aud_phaten_golden_6ch/src/extensions/eq_designer_new.py
View File

@@ -674,6 +674,25 @@ class EQDesigner(QMainWindow):
noise_btn_layout.addWidget(self.get_noise_strength_btn)
volume_layout.addRow(noise_btn_layout)
# 耳返开关控制
monitor_switch_layout = QHBoxLayout()
self.monitor_switch_label = QLabel("耳返开关 (0x87/0x88):")
self.monitor_switch_combo = QComboBox()
self.monitor_switch_combo.addItems(["关闭 (0)", "开启 (1)"])
self.monitor_switch_combo.setCurrentIndex(0) # 默认关闭
monitor_switch_layout.addWidget(self.monitor_switch_label)
monitor_switch_layout.addWidget(self.monitor_switch_combo)
volume_layout.addRow(monitor_switch_layout)
monitor_btn_layout = QHBoxLayout()
self.set_monitor_switch_btn = QPushButton("设置耳返开关")
self.set_monitor_switch_btn.clicked.connect(self.on_set_monitor_switch)
self.get_monitor_switch_btn = QPushButton("读取耳返开关")
self.get_monitor_switch_btn.clicked.connect(self.on_get_monitor_switch)
monitor_btn_layout.addWidget(self.set_monitor_switch_btn)
monitor_btn_layout.addWidget(self.get_monitor_switch_btn)
volume_layout.addRow(monitor_btn_layout)
# 读取采样率和格式按钮
self.get_sample_format_btn = QPushButton("读取采样率和格式")
self.get_sample_format_btn.clicked.connect(self.on_get_sample_format)
@@ -2511,6 +2530,102 @@ eq_mode_data_t sEQ_data_{int(fs)}HZ[NUM_EQ_MODES][NUM_EQ_CHANS] = {{
except Exception as e:
log_message(LOG_LEVEL_ERROR, f"读取AI降噪强度时出错: {str(e)}", self.log_level)
def on_set_monitor_switch(self):
"""设置耳返开关（发送0x87命令，0=关闭，1=开启）"""
if self.device_combo.currentData() is None:
log_message(LOG_LEVEL_ERROR, "请先选择设备", self.log_level)
return
mon_sw = self.monitor_switch_combo.currentIndex() # 0=关闭, 1=开启
desc = "关闭耳返" if mon_sw == 0 else "开启耳返（ADC路由到耳机输出）"
reply = QMessageBox.question(
self,
"确认设置耳返开关",
f"将要设置耳返开关为: {'开启' if mon_sw else '关闭'}\n{desc}\n\n是否继续？",
QMessageBox.Yes | QMessageBox.No,
QMessageBox.No
)
if reply == QMessageBox.Yes:
try:
device_info = self.device_combo.currentData()
h = hid.device()
h.open(device_info['vendor_id'], device_info['product_id'])
h.set_nonblocking(1)
data = bytearray(63)
data[0] = 0x77
data[1] = 0x87 # SET_MONITOR_SWITCH
data[2] = mon_sw
log_message(LOG_LEVEL_INFO, f"正在设置耳返开关为 {'开启' if mon_sw else '关闭'}...", self.log_level)
h.write([0x01] + list(data))
import time
time.sleep(0.05)
reply_data = h.get_input_report(0x1, 64)
if reply_data and len(reply_data) == 64:
if reply_data[0] == 0x01 and reply_data[1] == 0x77 and reply_data[2] == 0x88:
cur_val = reply_data[3]
self.monitor_switch_combo.setCurrentIndex(cur_val)
log_message(LOG_LEVEL_INFO, f"耳返开关已设置为: {'开启' if cur_val else '关闭'}", self.log_level)
QMessageBox.information(self, "成功", f"耳返开关已设置为: {'开启' if cur_val else '关闭'}")
else:
log_message(LOG_LEVEL_INFO, f"耳返开关设置成功（无响应确认）", self.log_level)
QMessageBox.information(self, "成功", f"耳返开关已设置为: {'开启' if mon_sw else '关闭'}")
else:
log_message(LOG_LEVEL_INFO, f"耳返开关设置命令已发送", self.log_level)
QMessageBox.information(self, "成功", f"耳返开关已设置为: {'开启' if mon_sw else '关闭'}")
h.close()
except Exception as e:
log_message(LOG_LEVEL_ERROR, f"设置耳返开关时出错: {str(e)}", self.log_level)
def on_get_monitor_switch(self):
"""读取耳返开关状态（发送0x88命令）"""
if self.device_combo.currentData() is None:
log_message(LOG_LEVEL_ERROR, "请先选择设备", self.log_level)
return
try:
device_info = self.device_combo.currentData()
h = hid.device()
h.open(device_info['vendor_id'], device_info['product_id'])
h.set_nonblocking(1)
data = bytearray(63)
data[0] = 0x77
data[1] = 0x88 # GET_MONITOR_SWITCH
log_message(LOG_LEVEL_INFO, "正在读取耳返开关状态...", self.log_level)
h.write([0x01] + list(data))
import time
time.sleep(0.05)
reply = h.get_input_report(0x1, 64)
if reply and len(reply) == 64:
if reply[0] == 0x01 and reply[1] == 0x77 and reply[2] == 0x88:
mon_sw = reply[3]
# 更新UI下拉框（index直接等于值：0=关闭, 1=开启）
if mon_sw <= 1:
self.monitor_switch_combo.setCurrentIndex(mon_sw)
log_message(LOG_LEVEL_INFO, f"当前耳返开关状态: {'开启' if mon_sw else '关闭'}", self.log_level)
QMessageBox.information(
self, "耳返开关状态",
f"当前耳返开关: {'开启 (1)' if mon_sw else '关闭 (0)'}\n\n"
f"说明: 开启时ADC数据实时路由到耳机输出（需麦克风未静音）"
)
else:
log_message(LOG_LEVEL_ERROR, f"无效的0x88响应同步头: 0x{reply[1]:02x} 0x{reply[2]:02x}", self.log_level)
else:
log_message(LOG_LEVEL_ERROR, "未收到0x88响应数据", self.log_level)
h.close()
except Exception as e:
log_message(LOG_LEVEL_ERROR, f"读取耳返开关状态时出错: {str(e)}", self.log_level)
def on_get_sample_format(self):
"""读取采样率和格式信息（发送0x9F命令）"""
if self.device_combo.currentData() is None:

70
sw_usb_audio/app_usb_aud_phaten_golden_6ch/src/extensions/eq_hid_protocol.md
View File

@@ -13,6 +13,8 @@
| 0x84 | FACTORY_RESET | 恢复出厂默认设置 | 主机→设备 | 删除Flash中所有已保存参数，设备重启后自动恢复出厂默认值 |
| 0x85 | SET_AI_NOISE_STRENGTH | 设置AI降噪强度 | 主机→设备 | 设置AI降噪强度（0=关闭，2-100偶数=强度级别，步进2；100对应最强-200dB） |
| 0x86 | GET_AI_NOISE_STRENGTH | 获取AI降噪强度 | 主机→设备 | 读取当前AI降噪强度；强度变化（含按键切换、开机初始值）时设备主动上报 |
| 0x87 | SET_MONITOR_SWITCH | 设置耳返开关 | 主机→设备 | 设置耳返（ADC→耳机监听）开关（0=关闭，1=开启），保存到Flash |
| 0x88 | GET_MONITOR_SWITCH | 获取耳返开关状态 | 主机→设备 | 读取当前耳返开关状态（0=关闭，1=开启） |
| 0x8A | SET_EQ_MODE | 切换EQ模式 | 主机→设备 | 切换EQ模式 |
| 0x8B | GET_EQ_MODE | 获取当前EQ模式信息 | 主机→设备 | 读取设备当前EQ模式和名称 |
| 0x8C | SET_MODE_GAIN_AND_NAME | 设置模式整体增益和名称 | 主机→设备 | 设置模式整体增益和名称 |
@@ -122,6 +124,9 @@
| 监听音量 | 15 (-14dB) | DAC level 15 = 0dB - 14 = -14dB |
| EQ参数 | 头文件预设 | 删除所有用户EQ参数，恢复固件内置预设 |
| AI降噪 | 开启 | 每次上电默认开启（不保存到Flash） |
| 耳返开关 | 0 (关闭) | ADC→耳机监听通路默认关闭 |
| 麦克风静音 | 0 (未静音) | 麦克风静音状态默认关闭 |
| 监听静音 | 0 (未静音) | 耳机输出静音状态默认关闭 |
**设备端处理**:
1. 删除Flash中保存的以下参数文件：
@@ -129,6 +134,9 @@
- `mic_vol`（麦克风音量）
- `dac_vol`（监听音量）
- `footstep`（脚步增强状态）
- `monitor_sw`（耳返开关）
- `mic_mute`（麦克风静音状态）
- `hp_mute`（耳机静音状态）
- 所有EQ参数文件（调用eq_flash_clear_all）
2. 设置重启标志，约500ms后设备自动重启
3. 重启后自动加载出厂默认参数
@@ -208,6 +216,68 @@
- **按键切换**：用户按下AI降噪按键时，设备主动上报新强度（关闭时上报0，开启时上报恢复的强度）
- **HID SET_AI_NOISE_STRENGTH（0x85）命令成功执行后**，设备主动上报新强度
### 2.0f 0x87 - SET_MONITOR_SWITCH (设置耳返开关)
**功能**: 设置耳返（ADC→耳机监听）开关，控制是否将麦克风输入实时路由到耳机输出
**方向**: 主机→设备
**数据包格式**:
```
字节位置 | 长度 | 内容 | 描述
---------|------|------|------
0 | 1 | 0x77 | 同步头1
1 | 1 | 0x87 | 命令码
2 | 1 | uint8 | 开关值 (0=关闭, 1=开启)
3-62 | 60 | 0x00 | 保留字节
```
**参数说明**:
- **0**: 关闭耳返，ADC数据不路由到耳机输出（NAU88L21 reg 0x0035 = 0x0000）
- **1**: 开启耳返，ADC数据路由到耳机输出（NAU88L21 reg 0x0035 = 0xCFCF，0dB监听音量）
- **注意**: 耳返路由需要麦克风未静音（mic_mute=0）且麦克风增益有效（level≥2）方才生效
**设备端处理**:
- 立即更新 NAU88L21 reg 0x0035（耳返音量寄存器）
- 若麦克风当前处于静音状态，则无论耳返开关为何值，reg 0x0035保持0x0000
- 保存到Flash（`monitor_sw`路径），断电重启后自动恢复
- 设置成功后用0x88格式响应当前状态
- 出厂默认：关闭（0）
**返回值**:
设置成功后设备回复0x88格式响应。
**响应数据包格式**:
```
字节位置 | 长度 | 内容 | 描述
---------|------|------|------
0 | 1 | 0x01 | Report ID
1 | 1 | 0x77 | 同步头1
2 | 1 | 0x88 | 同步头2
3 | 1 | uint8 | 当前耳返开关状态 (0=关闭, 1=开启)
4-62 | 59 | 0x00 | 保留字节
```
### 2.0g 0x88 - GET_MONITOR_SWITCH (获取耳返开关状态)
**功能**: 读取当前耳返开关状态
**方向**: 主机→设备（请求），设备→主机（响应）
**请求数据包格式**:
```
字节位置 | 长度 | 内容 | 描述
---------|------|------|------
0 | 1 | 0x77 | 同步头1
1 | 1 | 0x88 | 命令码
2-62 | 61 | 0x00 | 保留字节
```
**响应数据包格式**:
```
字节位置 | 长度 | 内容 | 描述
---------|------|------|------
0 | 1 | 0x01 | Report ID
1 | 1 | 0x77 | 同步头1
2 | 1 | 0x88 | 同步头2
3 | 1 | uint8 | 当前耳返开关状态 (0=关闭, 1=开启)
4-62 | 59 | 0x00 | 保留字节
```
### 2.1 0x8A - SET_EQ_MODE (切换EQ模式)
**功能**: 切换当前EQ模式
**方向**: 主机→设备

79
sw_usb_audio/app_usb_aud_phaten_golden_6ch/src/extensions/sy102_hid_protocol.md
View File

@@ -11,6 +11,8 @@
| 0x82 | SET_MIC_VOLUME | 设置麦克风增益级别 | 主机→设备 | 设置麦克风PGA增益（0=静音, 1-37=0dB~36dB, 1dB/步） |
| 0x83 | GET_MIC_VOLUME | 获取麦克风增益级别 | 主机→设备 | 读取当前麦克风PGA增益级别（0=静音, 1-37=0dB~36dB） |
| 0x84 | FACTORY_RESET | 恢复出厂默认设置 | 主机→设备 | 删除Flash中所有已保存参数，设备重启后自动恢复出厂默认值 |
| 0x87 | SET_MONITOR_SWITCH | 设置耳返开关 | 主机→设备 | 设置耳返（ADC→耳机监听）开关（0=关闭，1=开启），保存到Flash |
| 0x88 | GET_MONITOR_SWITCH | 获取耳返开关状态 | 主机→设备 | 读取当前耳返开关状态（0=关闭，1=开启） |
| 0x8A | SET_EQ_MODE | 切换EQ模式 | 主机→设备 | 切换EQ模式 |
| 0x8B | GET_EQ_MODE | 获取当前EQ模式信息 | 主机→设备 | 读取设备当前EQ模式和名称 |
| 0x8C | SET_MODE_GAIN_AND_NAME | 设置模式整体增益和名称 | 主机→设备 | 设置模式整体增益和名称 |
@@ -114,6 +116,22 @@
| 监听音量 | 15 (-14dB) | DAC level 15 = 0dB - 14 = -14dB |
| EQ参数 | 头文件预设 | 删除所有用户EQ参数，恢复固件内置预设 |
| AI降噪 | 开启 | 每次上电默认开启（不保存到Flash） |
| 耳返开关 | 0 (关闭) | ADC→耳机监听通路默认关闭 |
| 麦克风静音 | 0 (未静音) | 麦克风静音状态默认关闭 |
| 监听静音 | 0 (未静音) | 耳机输出静音状态默认关闭 |
**设备端处理**:
1. 删除Flash中保存的以下参数文件：
- `game_mode`（音效模式）
- `mic_vol`（麦克风音量）
- `dac_vol`（监听音量）
- `footstep`（脚步增强状态）
- `monitor_sw`（耳返开关）
- `mic_mute`（麦克风静音状态）
- `hp_mute`（耳机静音状态）
- 所有EQ参数文件（调用eq_flash_clear_all）
2. 设置重启标志，约500ms后设备自动重启
3. 重启后自动加载出厂默认参数
**响应数据包格式**:
```
@@ -131,6 +149,67 @@
- 重启后所有参数将恢复为出厂默认值
- 此操作不可撤销
### 2.0d 0x87 - SET_MONITOR_SWITCH (设置耳返开关)
**功能**: 设置耳返（ADC→耳机监听）开关，控制是否将麦克风输入实时路由到耳机输出
**方向**: 主机→设备
**数据包格式**:
```
字节位置 | 长度 | 内容 | 描述
---------|------|------|------
0 | 1 | 0x77 | 同步头1
1 | 1 | 0x87 | 命令码
2 | 1 | uint8 | 开关值 (0=关闭, 1=开启)
3-62 | 60 | 0x00 | 保留字节
```
**参数说明**:
- **0**: 关闭耳返，ADC数据不路由到耳机输出（NAU88L21 reg 0x0035 = 0x0000）
- **1**: 开启耳返，ADC数据路由到耳机输出（NAU88L21 reg 0x0035 = 0xCFCF，0dB监听音量）
- **注意**: 耳返路由需要麦克风未静音（mic_mute=0）且麦克风增益有效（level≥2）方才生效
**设备端处理**:
- 立即更新 NAU88L21 reg 0x0035（耳返音量寄存器）
- 若麦克风当前处于静音状态，则无论耳返开关为何值，reg 0x0035保持0x0000
- 保存到Flash（`monitor_sw`路径），断电重启后自动恢复
- 设置成功后用0x88格式响应当前状态
**返回值**:
设置成功后设备回复0x88格式响应。
**响应数据包格式**:
```
字节位置 | 长度 | 内容 | 描述
---------|------|------|------
0 | 1 | 0x01 | Report ID
1 | 1 | 0x77 | 同步头1
2 | 1 | 0x88 | 同步头2
3 | 1 | uint8 | 当前耳返开关状态 (0=关闭, 1=开启)
4-62 | 59 | 0x00 | 保留字节
```
### 2.0e 0x88 - GET_MONITOR_SWITCH (获取耳返开关状态)
**功能**: 读取当前耳返开关状态
**方向**: 主机→设备（请求），设备→主机（响应）
**请求数据包格式**:
```
字节位置 | 长度 | 内容 | 描述
---------|------|------|------
0 | 1 | 0x77 | 同步头1
1 | 1 | 0x88 | 命令码
2-62 | 61 | 0x00 | 保留字节
```
**响应数据包格式**:
```
字节位置 | 长度 | 内容 | 描述
---------|------|------|------
0 | 1 | 0x01 | Report ID
1 | 1 | 0x77 | 同步头1
2 | 1 | 0x88 | 同步头2
3 | 1 | uint8 | 当前耳返开关状态 (0=关闭, 1=开启)
4-62 | 59 | 0x00 | 保留字节
```
### 2.1 0x8A - SET_EQ_MODE (切换EQ模式)
**功能**: 切换当前EQ模式
**方向**: 主机→设备