docs: 新增 XMOS EQ HID 协议文档并完善免开发固件页说明
- 修正文件名 XMOS_EQ_HID_Protoco.md -> XMOS_EQ_HID_Protocol.md - 新增 XMOS EQ HID 协议文档(中/英) - 精简免开发固件页「待发布」占位说明措辞 - mkdocs 预留(注释)数字调音台导航项 - gitignore 忽略未纳入版本库的 digital_mixer 目录 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
3
.gitignore
vendored
3
.gitignore
vendored
@@ -10,3 +10,6 @@ assets/.DS_Store
|
||||
/assets
|
||||
.DS_Store
|
||||
**/.DS_Store
|
||||
|
||||
# 数字调音台资料暂不纳入版本库
|
||||
zh/docs/dev_doc/datasheet/std_product/digital_mixer/
|
||||
|
||||
@@ -113,6 +113,8 @@ search:
|
||||
| 0xB4 | GET_EQ_BAND_COUNT | Get EQ band count | PC ↔ Device |
|
||||
| 0x80 | SET_UPSAMPLE | Set sampling rate upsampling | PC → Device |
|
||||
| 0x81 | GET_UPSAMPLE | Get sampling rate upsampling status | PC ↔ Device |
|
||||
| 0xB0 | SET_EX3D_CMD | Send EX3D setting command | PC → Device |
|
||||
| 0xB1 | GET_EX3D_CMD | Read EX3D command | PC ↔ Device |
|
||||
|
||||
### 2.2 Detailed Command Formats
|
||||
|
||||
@@ -1130,6 +1132,333 @@ No direct return value. To confirm upsampling status, use GET_UPSAMPLE (0x81).
|
||||
| 3 | 1 | upsample | Current upsample status (0=Disabled, 1=Enabled) |
|
||||
| 4-63 | 60 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
#### 2.2.41 Send EX3D Setting Command (0xB0)
|
||||
|
||||
**Function**: Send EX3D setting command, encapsulating all EX3D SET commands for spatial audio parameter configuration
|
||||
|
||||
**Applicable Device**: VID 0x20B1, PID 0x80D3 (V7.1 spatial audio dedicated device)
|
||||
|
||||
**Request Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (SET format) |
|
||||
| 7-10 | 4 | param1 | int32 parameter 1 (varies by command) |
|
||||
| 11-14 | 4 | param2 | int32 parameter 2 (varies by command) |
|
||||
| 15-18 | 4 | param3 | int32 parameter 3 (varies by command) |
|
||||
| 19-63 | 45 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**Supported EX3D SET Commands**:
|
||||
|
||||
| Command Code | Command Name | Description |
|
||||
|:-----------:|:--------:|:--------:|
|
||||
| 0x83 | CMD_ANGLE | Set spatial audio angle parameters |
|
||||
| 0x84 | CMD_SOUND_FIELD | Set sound field mode |
|
||||
| 0x87 | CMD_LMT_THRESHOLD | Set gunshot threshold |
|
||||
| 0x93 | CMD_EXPAND_GAIN | Set footstep gain |
|
||||
|
||||
**Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 (echo) |
|
||||
| 3 | 1 | status | Status code (0x00=Success, 0x01=Failure) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D command code (echo) |
|
||||
| 8-11 | 4 | retval | Return value (0xFFFFFFFF indicates parameter error) |
|
||||
| 12-63 | 52 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
#### 2.2.42 Read EX3D Command (0xB1)
|
||||
|
||||
**Function**: Read EX3D parameters, encapsulating all EX3D GET commands for spatial audio parameter reading
|
||||
|
||||
**Applicable Device**: VID 0x20B1, PID 0x80D3 (V7.1 spatial audio dedicated device)
|
||||
|
||||
**Request Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (GET format) |
|
||||
| 7-10 | 4 | param1 | uint32 parameter 1 (channel number, index, etc.) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**Supported EX3D GET Commands**:
|
||||
|
||||
| Command Code | Command Name | Description |
|
||||
|:-----------:|:--------:|:--------:|
|
||||
| 0x183 | CMD_ANGLE | Get spatial audio angle parameters |
|
||||
| 0x184 | CMD_SOUND_FIELD | Get sound field mode |
|
||||
| 0x187 | CMD_LMT_THRESHOLD | Get gunshot threshold |
|
||||
| 0x18D | CMD_LEVEL | Get level |
|
||||
| 0x193 | CMD_EXPAND_GAIN | Get footstep gain |
|
||||
|
||||
**Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 (echo) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (echo) |
|
||||
| 7-10 | 4 | retval1 | uint32 return value 1 |
|
||||
| 11-14 | 4 | retval2 | uint32 return value 2 |
|
||||
| 15-18 | 4 | retval3 | uint32 return value 3 |
|
||||
| 19-63 | 45 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
### 2.3 EX3D Subcommand Details
|
||||
|
||||
!!! note "EX3D Protocol Notes"
|
||||
The following commands are sent encapsulated via 0xB0/0xB1 and apply only to V7.1 spatial audio devices with VID 0x20B1, PID 0x80D3.
|
||||
|
||||
#### 2.3.1 EX3D Command Code Format
|
||||
|
||||
- **SET command format**: `base command code & ~0x0100` (clear bit 9)
|
||||
- Example: Set gunshot threshold = 0x87 & ~0x0100 = 0x87
|
||||
- Example: Set footstep gain = 0x93 & ~0x0100 = 0x93
|
||||
|
||||
- **GET command format**: `base command code | 0x0100` (set bit 9)
|
||||
- Example: Get gunshot threshold = 0x87 | 0x0100 = 0x187
|
||||
- Example: Get footstep gain = 0x93 | 0x0100 = 0x193
|
||||
|
||||
#### 2.3.2 Sound Field Mode Control (CMD_SOUND_FIELD = 0x84)
|
||||
|
||||
**Function**: Set or get the current sound field mode
|
||||
**Application Scenario**: Switch between FPS Game/RPG Game/3A Game sound field effects
|
||||
|
||||
**SET Request Format (64 bytes)** (0xB0 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x84 = CMD_SET(CMD_SOUND_FIELD)) |
|
||||
| 7-10 | 4 | mode | uint32 user mode value: 1=FPS Game, 2=RPG Game, 3=3A Game |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**User Mode → Internal IR Algorithm Mapping**:
|
||||
|
||||
| User Value | Meaning | `STEREO_EN=1` (IR) | `V71_AUDIO_MODE=1` (IR) |
|
||||
|:------:|:----:|:------------------:|:-----------------------:|
|
||||
| 1 | FPS Game | IR_GAME (1) | IR_7_1_GAME (4) |
|
||||
| 2 | RPG Game | IR_MUSIC (2) | IR_7_1_MUSIC (5) |
|
||||
| 3 | 3A Game | IR_MOVIE (3) | IR_7_1_MOVIE (6) |
|
||||
|
||||
**SET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 (echo) |
|
||||
| 3 | 1 | status | Status code (0x00=Success, 0x01=Failure) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D command code (0x84, echo) |
|
||||
| 8-11 | 4 | retval | Return value (0xFFFFFFFF=invalid index, other=success) |
|
||||
| 12-63 | 52 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Request Format (64 bytes)** (0xB1 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x184 = CMD_GET(CMD_SOUND_FIELD)) |
|
||||
| 7-63 | 57 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 (echo) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x184, echo) |
|
||||
| 7-10 | 4 | mode | uint32 current user mode value (1=FPS Game, 2=RPG Game, 3=3A Game) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
#### 2.3.3 Gunshot Threshold Control (CMD_LMT_THRESHOLD = 0x87)
|
||||
|
||||
**Function**: Set/get gunshot sound effect trigger threshold
|
||||
**Application Scenario**: Detect gunshot sounds and trigger corresponding audio processing in FPS Game/3A Game modes
|
||||
|
||||
**SET Request Format (64 bytes)** (0xB0 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x87 = CMD_SET(CMD_LMT_THRESHOLD)) |
|
||||
| 7-10 | 4 | threshold | int32 threshold value (range: -96 ~ 0 dB) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**SET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 (echo) |
|
||||
| 3 | 1 | status | Status code (0x00=Success, 0x01=Failure) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D command code (0x87, echo) |
|
||||
| 8-11 | 4 | retval | Return value (0xFFFFFFFF=invalid index, other=success) |
|
||||
| 12-63 | 52 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Request Format (64 bytes)** (0xB1 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x187 = CMD_GET(CMD_LMT_THRESHOLD)) |
|
||||
| 7-63 | 57 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 (echo) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x187, echo) |
|
||||
| 7-10 | 4 | threshold | int32 current threshold value (range: -96 ~ 0 dB) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
#### 2.3.4 Footstep Gain Control (CMD_EXPAND_GAIN = 0x93)
|
||||
|
||||
**Function**: Set/get footstep sound effect gain
|
||||
**Application Scenario**: Enhance footstep sound effects in FPS Game/3A Game modes
|
||||
|
||||
**SET Request Format (64 bytes)** (0xB0 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x93 = CMD_SET(CMD_EXPAND_GAIN)) |
|
||||
| 7-10 | 4 | gain | int32 gain value (range: 0 ~ 24 dB) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**SET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 (echo) |
|
||||
| 3 | 1 | status | Status code (0x00=Success, 0x01=Failure) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D command code (0x93, echo) |
|
||||
| 8-11 | 4 | retval | Return value (0xFFFFFFFF=invalid index, other=success) |
|
||||
| 12-63 | 52 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Request Format (64 bytes)** (0xB1 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x193 = CMD_GET(CMD_EXPAND_GAIN)) |
|
||||
| 7-63 | 57 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 (echo) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x193, echo) |
|
||||
| 7-10 | 4 | gain | int32 current gain value (range: 0 ~ 24 dB) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
#### 2.3.5 Angle Control (CMD_ANGLE = 0x83)
|
||||
|
||||
**Function**: Set/get spatial audio angle parameters
|
||||
**Application Scenario**: Adjust the spatial positioning of virtual surround sound
|
||||
|
||||
**SET Request Format (64 bytes)** (0xB0 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x83 = CMD_SET(CMD_ANGLE)) |
|
||||
| 7-10 | 4 | angle | uint32 packed angle value (lower 16 bits=horizontal angle, upper 16 bits=vertical angle) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**SET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB0 (echo) |
|
||||
| 3 | 1 | status | Status code (0x00=Success, 0x01=Failure) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D command code (0x83, echo) |
|
||||
| 8-11 | 4 | retval | Return value (0xFFFFFFFF=invalid index, other=success) |
|
||||
| 12-63 | 52 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Request Format (64 bytes)** (0xB1 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x183 = CMD_GET(CMD_ANGLE)) |
|
||||
| 7-10 | 4 | channel | uint32 channel number (0-7) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 (echo) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x183, echo) |
|
||||
| 7-10 | 4 | angle | uint32 packed angle value (lower 16 bits=horizontal angle, upper 16 bits=vertical angle) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
#### 2.3.6 Level Reading (CMD_LEVEL = 0x8D)
|
||||
|
||||
**Function**: Get level data for each channel
|
||||
**Application Scenario**: Real-time audio level meter display
|
||||
|
||||
**GET Request Format (64 bytes)** (0xB1 encapsulated):
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x18D = CMD_GET(CMD_LEVEL)) |
|
||||
| 7-10 | 4 | count | uint32 channel count (1-16) |
|
||||
| 11-63 | 53 | reserved | Reserved fields (fill with 0) |
|
||||
|
||||
**GET Response Format (64 bytes)**:
|
||||
|
||||
| Offset | Length | Field Name | Description |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | Fixed value: 0x01 |
|
||||
| 1 | 1 | sync_header | Sync header: 0x77 |
|
||||
| 2 | 1 | cmd_header | Command header: 0xB1 (echo) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D command code (0x18D, echo) |
|
||||
| from 7 | N | levels | float32[] array of per-channel level values |
|
||||
| ... | ... | ... | Reserved fields (fill with 0) |
|
||||
|
||||
## 3. Data Flow and Timing :material-timeline-clock:
|
||||
|
||||
### 3.1 Typical Operation Flows
|
||||
@@ -1159,6 +1488,27 @@ No direct return value. To confirm upsampling status, use GET_UPSAMPLE (0x81).
|
||||
4. After transfer completes, GUI sends FIRMWARE_UPGRADE_END command (0xA9)
|
||||
5. Device verifies image integrity and returns status
|
||||
|
||||
#### 3.1.5 EX3D Sound Field Mode Reading Flow
|
||||
**Applicable Device**: VID 0x20B1, PID 0x80D3 (V7.1 spatial audio dedicated device)
|
||||
|
||||
1. GUI sends GET_EX3D_CMD command (0xB1), encapsulating CMD_SOUND_FIELD (0x184)
|
||||
2. Device returns the current sound field mode (1=FPS Game, 2=RPG Game, 3=3A Game)
|
||||
3. GUI updates the interface status according to the sound field mode
|
||||
|
||||
#### 3.1.6 EX3D Sound Field Mode Setting Flow
|
||||
**Applicable Device**: VID 0x20B1, PID 0x80D3 (V7.1 spatial audio dedicated device)
|
||||
|
||||
1. GUI sends SET_EX3D_CMD command (0xB0), encapsulating CMD_SOUND_FIELD (0x84) and the target mode value
|
||||
2. Device updates the internal sound field mode state and returns a response
|
||||
3. When switching from RPG Game to FPS Game/3A Game, the GUI must re-read the FPS control parameters
|
||||
|
||||
#### 3.1.7 EX3D FPS Control Parameter Reading Flow
|
||||
**Applicable Device**: VID 0x20B1, PID 0x80D3 (V7.1 spatial audio dedicated device)
|
||||
|
||||
1. GUI sends GET_EX3D_CMD command (0xB1), encapsulating CMD_LMT_THRESHOLD (0x187) to read the gunshot threshold
|
||||
2. GUI sends GET_EX3D_CMD command (0xB1), encapsulating CMD_EXPAND_GAIN (0x193) to read the footstep gain
|
||||
3. Device returns the current threshold and gain values respectively
|
||||
|
||||
### 3.2 Timing Requirements and Constraints
|
||||
|
||||
!!! warning "Timing Requirements"
|
||||
|
||||
@@ -113,6 +113,8 @@ search:
|
||||
| 0xB4 | GET_EQ_BAND_COUNT | 获取 EQ 段数 | PC ↔ 设备 |
|
||||
| 0x80 | SET_UPSAMPLE | 设置采样率升频开关 | PC → 设备 |
|
||||
| 0x81 | GET_UPSAMPLE | 获取采样率升频状态 | PC ↔ 设备 |
|
||||
| 0xB0 | SET_EX3D_CMD | 发送 EX3D 设置命令 | PC → 设备 |
|
||||
| 0xB1 | GET_EX3D_CMD | 读取 EX3D 命令 | PC ↔ 设备 |
|
||||
|
||||
### 2.2 详细命令格式
|
||||
|
||||
@@ -1113,6 +1115,333 @@ search:
|
||||
| 3 | 1 | upsample | 当前升频状态(0=禁用, 1=使能) |
|
||||
| 4-63 | 60 | reserved | 保留字段(填充0) |
|
||||
|
||||
#### 2.2.41 发送 EX3D 设置命令(0xB0)
|
||||
|
||||
**功能说明**: 发送 EX3D 设置命令,封装所有 EX3D SET 命令,用于空间音频参数设置
|
||||
|
||||
**适用设备**: VID 0x20B1, PID 0x80D3(V7.1空间音频专用设备)
|
||||
|
||||
**请求格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码(SET 格式) |
|
||||
| 7-10 | 4 | param1 | int32 参数1(根据命令不同) |
|
||||
| 11-14 | 4 | param2 | int32 参数2(根据命令不同) |
|
||||
| 15-18 | 4 | param3 | int32 参数3(根据命令不同) |
|
||||
| 19-63 | 45 | reserved | 保留字段(填充0) |
|
||||
|
||||
**支持的 EX3D SET 命令**:
|
||||
|
||||
| EX3D 命令码 | 命令名称 | 功能描述 |
|
||||
|:-----------:|:--------:|:--------:|
|
||||
| 0x83 | CMD_ANGLE | 设置空间音频角度参数 |
|
||||
| 0x84 | CMD_SOUND_FIELD | 设置声场模式 |
|
||||
| 0x87 | CMD_LMT_THRESHOLD | 设置枪声阈值 |
|
||||
| 0x93 | CMD_EXPAND_GAIN | 设置脚步声增益 |
|
||||
|
||||
**响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0(回显) |
|
||||
| 3 | 1 | status | 状态码 (0x00=成功, 0x01=失败) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D 命令码(回显) |
|
||||
| 8-11 | 4 | retval | 返回值(0xFFFFFFFF 表示参数错误) |
|
||||
| 12-63 | 52 | reserved | 保留字段(填充0) |
|
||||
|
||||
#### 2.2.42 读取 EX3D 命令(0xB1)
|
||||
|
||||
**功能说明**: 读取 EX3D 参数,封装所有 EX3D GET 命令,用于空间音频参数读取
|
||||
|
||||
**适用设备**: VID 0x20B1, PID 0x80D3(V7.1空间音频专用设备)
|
||||
|
||||
**请求格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码(GET 格式) |
|
||||
| 7-10 | 4 | param1 | uint32 参数1(通道号、索引等) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
**支持的 EX3D GET 命令**:
|
||||
|
||||
| EX3D 命令码 | 命令名称 | 功能描述 |
|
||||
|:-----------:|:--------:|:--------:|
|
||||
| 0x183 | CMD_ANGLE | 获取空间音频角度参数 |
|
||||
| 0x184 | CMD_SOUND_FIELD | 获取声场模式 |
|
||||
| 0x187 | CMD_LMT_THRESHOLD | 获取枪声阈值 |
|
||||
| 0x18D | CMD_LEVEL | 获取电平 |
|
||||
| 0x193 | CMD_EXPAND_GAIN | 获取脚步声增益 |
|
||||
|
||||
**响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1(回显) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码(回显) |
|
||||
| 7-10 | 4 | retval1 | uint32 返回值1 |
|
||||
| 11-14 | 4 | retval2 | uint32 返回值2 |
|
||||
| 15-18 | 4 | retval3 | uint32 返回值3 |
|
||||
| 19-63 | 45 | reserved | 保留字段(填充0) |
|
||||
|
||||
### 2.3 EX3D 子命令详细说明
|
||||
|
||||
!!! note "EX3D 协议说明"
|
||||
以下命令通过 0xB0/0xB1 封装发送,仅适用于 VID 0x20B1, PID 0x80D3 的 V7.1 空间音频设备。
|
||||
|
||||
#### 2.3.1 EX3D 命令码格式说明
|
||||
|
||||
- **SET 命令格式**: `基础命令码 & ~0x0100`(清除第9位)
|
||||
- 例: 设置枪声阈值 = 0x87 & ~0x0100 = 0x87
|
||||
- 例: 设置脚步声增益 = 0x93 & ~0x0100 = 0x93
|
||||
|
||||
- **GET 命令格式**: `基础命令码 | 0x0100`(设置第9位)
|
||||
- 例: 获取枪声阈值 = 0x87 | 0x0100 = 0x187
|
||||
- 例: 获取脚步声增益 = 0x93 | 0x0100 = 0x193
|
||||
|
||||
#### 2.3.2 声场模式控制(CMD_SOUND_FIELD = 0x84)
|
||||
|
||||
**功能说明**: 设置或获取当前声场模式
|
||||
**应用场景**: 切换 FPS Game/RPG Game/3A Game 三种声场效果
|
||||
|
||||
**SET 请求格式(64 字节)**(0xB0 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x84 = CMD_SET(CMD_SOUND_FIELD)) |
|
||||
| 7-10 | 4 | mode | uint32 用户模式值: 1=FPS Game, 2=RPG Game, 3=3A Game |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
**用户模式 → 内部 IR 算法映射**:
|
||||
|
||||
| 用户值 | 含义 | `STEREO_EN=1` (IR) | `V71_AUDIO_MODE=1` (IR) |
|
||||
|:------:|:----:|:------------------:|:-----------------------:|
|
||||
| 1 | FPS Game | IR_GAME (1) | IR_7_1_GAME (4) |
|
||||
| 2 | RPG Game | IR_MUSIC (2) | IR_7_1_MUSIC (5) |
|
||||
| 3 | 3A Game | IR_MOVIE (3) | IR_7_1_MOVIE (6) |
|
||||
|
||||
**SET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0(回显) |
|
||||
| 3 | 1 | status | 状态码 (0x00=成功, 0x01=失败) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D 命令码 (0x84,回显) |
|
||||
| 8-11 | 4 | retval | 返回值(0xFFFFFFFF=索引无效, 其他=成功) |
|
||||
| 12-63 | 52 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 请求格式(64 字节)**(0xB1 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x184 = CMD_GET(CMD_SOUND_FIELD)) |
|
||||
| 7-63 | 57 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1(回显) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x184,回显) |
|
||||
| 7-10 | 4 | mode | uint32 当前用户模式值 (1=FPS Game, 2=RPG Game, 3=3A Game) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
#### 2.3.3 枪声阈值控制(CMD_LMT_THRESHOLD = 0x87)
|
||||
|
||||
**功能说明**: 设置/获取枪声音效触发阈值
|
||||
**应用场景**: FPS Game/3A Game 模式下检测枪声并触发相应音效处理
|
||||
|
||||
**SET 请求格式(64 字节)**(0xB0 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x87 = CMD_SET(CMD_LMT_THRESHOLD)) |
|
||||
| 7-10 | 4 | threshold | int32 阈值值 (范围: -96 ~ 0 dB) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
**SET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0(回显) |
|
||||
| 3 | 1 | status | 状态码 (0x00=成功, 0x01=失败) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D 命令码 (0x87,回显) |
|
||||
| 8-11 | 4 | retval | 返回值(0xFFFFFFFF=索引无效, 其他=成功) |
|
||||
| 12-63 | 52 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 请求格式(64 字节)**(0xB1 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x187 = CMD_GET(CMD_LMT_THRESHOLD)) |
|
||||
| 7-63 | 57 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1(回显) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x187,回显) |
|
||||
| 7-10 | 4 | threshold | int32 当前阈值值 (范围: -96 ~ 0 dB) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
#### 2.3.4 脚步声增益控制(CMD_EXPAND_GAIN = 0x93)
|
||||
|
||||
**功能说明**: 设置/获取脚步声音效增益
|
||||
**应用场景**: FPS Game/3A Game 模式下增强脚步声效果
|
||||
|
||||
**SET 请求格式(64 字节)**(0xB0 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x93 = CMD_SET(CMD_EXPAND_GAIN)) |
|
||||
| 7-10 | 4 | gain | int32 增益值 (范围: 0 ~ 24 dB) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
**SET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0(回显) |
|
||||
| 3 | 1 | status | 状态码 (0x00=成功, 0x01=失败) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D 命令码 (0x93,回显) |
|
||||
| 8-11 | 4 | retval | 返回值(0xFFFFFFFF=索引无效, 其他=成功) |
|
||||
| 12-63 | 52 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 请求格式(64 字节)**(0xB1 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x193 = CMD_GET(CMD_EXPAND_GAIN)) |
|
||||
| 7-63 | 57 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1(回显) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x193,回显) |
|
||||
| 7-10 | 4 | gain | int32 当前增益值 (范围: 0 ~ 24 dB) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
#### 2.3.5 角度控制(CMD_ANGLE = 0x83)
|
||||
|
||||
**功能说明**: 设置/获取空间音频角度参数
|
||||
**应用场景**: 调整虚拟环绕声的空间定位
|
||||
|
||||
**SET 请求格式(64 字节)**(0xB0 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x83 = CMD_SET(CMD_ANGLE)) |
|
||||
| 7-10 | 4 | angle | uint32 打包角度值 (低16位=水平角度, 高16位=垂直角度) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
**SET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB0(回显) |
|
||||
| 3 | 1 | status | 状态码 (0x00=成功, 0x01=失败) |
|
||||
| 4-7 | 4 | ex3d_cmd | EX3D 命令码 (0x83,回显) |
|
||||
| 8-11 | 4 | retval | 返回值(0xFFFFFFFF=索引无效, 其他=成功) |
|
||||
| 12-63 | 52 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 请求格式(64 字节)**(0xB1 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x183 = CMD_GET(CMD_ANGLE)) |
|
||||
| 7-10 | 4 | channel | uint32 通道号 (0-7) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1(回显) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x183,回显) |
|
||||
| 7-10 | 4 | angle | uint32 打包角度值 (低16位=水平角度, 高16位=垂直角度) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
#### 2.3.6 电平获取(CMD_LEVEL = 0x8D)
|
||||
|
||||
**功能说明**: 获取各通道电平数据
|
||||
**应用场景**: 实时显示音频电平表
|
||||
|
||||
**GET 请求格式(64 字节)**(0xB1 封装):
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1 |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x18D = CMD_GET(CMD_LEVEL)) |
|
||||
| 7-10 | 4 | count | uint32 通道数量 (1-16) |
|
||||
| 11-63 | 53 | reserved | 保留字段(填充0) |
|
||||
|
||||
**GET 响应格式(64 字节)**:
|
||||
|
||||
| 偏移 | 长度 | 字段名 | 描述 |
|
||||
|:----:|:----:|:------:|:----:|
|
||||
| 0 | 1 | report_id | 固定为 0x01 |
|
||||
| 1 | 1 | sync_header | 同步头: 0x77 |
|
||||
| 2 | 1 | cmd_header | 命令头: 0xB1(回显) |
|
||||
| 3-6 | 4 | ex3d_cmd | EX3D 命令码 (0x18D,回显) |
|
||||
| 7开始 | N | levels | float32[] 各通道电平值数组 |
|
||||
| ... | ... | ... | 保留字段(填充0) |
|
||||
|
||||
## 三、数据流程和时序 :material-timeline-clock:
|
||||
|
||||
### 3.1 典型操作流程
|
||||
@@ -1142,6 +1471,27 @@ search:
|
||||
4. 传输完成后发送 FIRMWARE_UPGRADE_END 命令 (0xA9) 结束升级
|
||||
5. 设备验证镜像完整性并返回状态
|
||||
|
||||
#### 3.1.5 EX3D 声场模式读取流程
|
||||
**适用设备**: VID 0x20B1, PID 0x80D3(V7.1 空间音频专用设备)
|
||||
|
||||
1. GUI发送 GET_EX3D_CMD 命令 (0xB1),封装 CMD_SOUND_FIELD (0x184)
|
||||
2. 设备返回当前声场模式 (1=FPS Game, 2=RPG Game, 3=3A Game)
|
||||
3. GUI根据声场模式更新界面状态
|
||||
|
||||
#### 3.1.6 EX3D 声场模式设置流程
|
||||
**适用设备**: VID 0x20B1, PID 0x80D3(V7.1 空间音频专用设备)
|
||||
|
||||
1. GUI发送 SET_EX3D_CMD 命令 (0xB0),封装 CMD_SOUND_FIELD (0x84) 和目标模式值
|
||||
2. 设备更新内部声场模式状态并返回响应
|
||||
3. 如从 RPG Game 切换到 FPS Game/3A Game,GUI需重新读取 FPS 控制参数
|
||||
|
||||
#### 3.1.7 EX3D FPS 控制参数读取流程
|
||||
**适用设备**: VID 0x20B1, PID 0x80D3(V7.1 空间音频专用设备)
|
||||
|
||||
1. GUI发送 GET_EX3D_CMD 命令 (0xB1),封装 CMD_LMT_THRESHOLD (0x187) 读取枪声阈值
|
||||
2. GUI发送 GET_EX3D_CMD 命令 (0xB1),封装 CMD_EXPAND_GAIN (0x193) 读取脚步声增益
|
||||
3. 设备分别返回当前阈值和增益值
|
||||
|
||||
### 3.2 时序要求与约束
|
||||
|
||||
!!! warning "时序要求"
|
||||
@@ -10,7 +10,7 @@ login: true
|
||||
--8<-- "common/phaten_xmos_support_img.md"
|
||||
--8<-- "common/checklogin_form.md"
|
||||
|
||||
本页面提供飞腾云**免开发(ZeroCode)系列核心模组**的固件下载。免开发固件支持通过 ZeroConfig / Web 配置或串口(UART/HID)协议进行个性化配置,帮助客户无需二次开发即可快速实现产品落地。固件按产品系列分类如下,已发布固件可直接下载,尚未发布的以「待发布」占位预留。
|
||||
本页面提供飞腾云**免开发(ZeroCode)系列核心模组**的固件下载。免开发固件支持通过 ZeroConfig / Web 配置或串口(UART/HID)协议进行个性化配置,帮助客户无需二次开发即可快速实现产品落地。固件按产品系列分类如下。已发布的固件可直接下载;尚未发布的标记为「待发布」,将在正式发布后提供下载。
|
||||
|
||||
> 📶 WiFi 音箱评估板(RTL8711 平台)固件另见 [WiFi音箱EVB板](./wifi_speaker_evb.md)。
|
||||
|
||||
@@ -29,58 +29,58 @@ login: true
|
||||
| 产品名称 | 固件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|
||||
| :------------|:--------------------|:------------------------------------|:----------------|:--------------------|:--------------------|
|
||||
| HF87611 | update_gen_0.0.5.bin | 0.0.5 | 2025年3月29日 | 旧版本,不支持新功能。如需更新请先联系我们 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/firmware/hf87611/update_gen_0.0.5_8938ca4d9315319a0fb4466b700faca5.bin')">:material-download:</a> |
|
||||
| HF87621 | 待发布 | - | 待定 | USB HiFi解码器核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| HF86611 | 待发布 | - | 待定 | USB HiFi解码器核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| HF83311 | 待发布 | - | 待定 | USB HiFi解码器核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| HF87621 | 待发布 | - | 待定 | USB HiFi解码器核心模组,免开发固件 | 待发布 |
|
||||
| HF86611 | 待发布 | - | 待定 | USB HiFi解码器核心模组,免开发固件 | 待发布 |
|
||||
| HF83311 | 待发布 | - | 待定 | USB HiFi解码器核心模组,免开发固件 | 待发布 |
|
||||
|
||||
# USB低功耗HiFi解码器核心模组
|
||||
|
||||
| 产品名称 | 固件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|
||||
| :------------|:--------------------|:------------------------------------|:----------------|:--------------------|:--------------------|
|
||||
| PH83311L | 待发布 | - | 待定 | USB低功耗HiFi解码器核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| PH83211L | 待发布 | - | 待定 | USB低功耗HiFi解码器核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| PH73311L | 待发布 | - | 待定 | USB低功耗HiFi解码器核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| PH73211L | 待发布 | - | 待定 | USB低功耗HiFi解码器核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| PH83311L | 待发布 | - | 待定 | USB低功耗HiFi解码器核心模组,免开发固件 | 待发布 |
|
||||
| PH83211L | 待发布 | - | 待定 | USB低功耗HiFi解码器核心模组,免开发固件 | 待发布 |
|
||||
| PH73311L | 待发布 | - | 待定 | USB低功耗HiFi解码器核心模组,免开发固件 | 待发布 |
|
||||
| PH73211L | 待发布 | - | 待定 | USB低功耗HiFi解码器核心模组,免开发固件 | 待发布 |
|
||||
|
||||
# 虚拟7.1游戏声卡核心模组
|
||||
|
||||
| 产品名称 | 固件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|
||||
| :------------|:--------------------|:------------------------------------|:----------------|:--------------------|:--------------------|
|
||||
| GM68311 | 待发布 | - | 待定 | 虚拟7.1游戏声卡核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| GM67211 | 待发布 | - | 待定 | 虚拟7.1游戏声卡核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| GM68311 | 待发布 | - | 待定 | 虚拟7.1游戏声卡核心模组,免开发固件 | 待发布 |
|
||||
| GM67211 | 待发布 | - | 待定 | 虚拟7.1游戏声卡核心模组,免开发固件 | 待发布 |
|
||||
|
||||
# Ai DNR深度降噪核心模组
|
||||
|
||||
| 产品名称 | 固件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|
||||
| :------------|:--------------------|:------------------------------------|:----------------|:--------------------|:--------------------|
|
||||
| DNR65211 | 待发布 | - | 待定 | Ai DNR深度降噪核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| DNR65221 | 待发布 | - | 待定 | Ai DNR深度降噪核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| DNR65231 | 待发布 | - | 待定 | Ai DNR深度降噪核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| DNR65211 | 待发布 | - | 待定 | Ai DNR深度降噪核心模组,免开发固件 | 待发布 |
|
||||
| DNR65221 | 待发布 | - | 待定 | Ai DNR深度降噪核心模组,免开发固件 | 待发布 |
|
||||
| DNR65231 | 待发布 | - | 待定 | Ai DNR深度降噪核心模组,免开发固件 | 待发布 |
|
||||
|
||||
# USB OTG集成ASRC核心模组
|
||||
|
||||
| 产品名称 | 固件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|
||||
| :------------|:--------------------|:------------------------------------|:----------------|:--------------------|:--------------------|
|
||||
| OT82111 | 待发布 | - | 待定 | USB OTG集成ASRC核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| OT83211 | 待发布 | - | 待定 | USB OTG集成ASRC核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| OT82111 | 待发布 | - | 待定 | USB OTG集成ASRC核心模组,免开发固件 | 待发布 |
|
||||
| OT83211 | 待发布 | - | 待定 | USB OTG集成ASRC核心模组,免开发固件 | 待发布 |
|
||||
|
||||
# 音频采样率转换SRC核心模组
|
||||
|
||||
| 产品名称 | 固件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|
||||
| :------------|:--------------------|:------------------------------------|:----------------|:--------------------|:--------------------|
|
||||
| XMSRC4392 | 待发布 | - | 待定 | 音频采样率转换SRC核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| XMSRC4194 | 待发布 | - | 待定 | 音频采样率转换SRC核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| XMSRC4192 | 待发布 | - | 待定 | 音频采样率转换SRC核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| XMSRC4392 | 待发布 | - | 待定 | 音频采样率转换SRC核心模组,免开发固件 | 待发布 |
|
||||
| XMSRC4194 | 待发布 | - | 待定 | 音频采样率转换SRC核心模组,免开发固件 | 待发布 |
|
||||
| XMSRC4192 | 待发布 | - | 待定 | 音频采样率转换SRC核心模组,免开发固件 | 待发布 |
|
||||
|
||||
# PDM到I2S/TDM转换核心模组
|
||||
|
||||
| 产品名称 | 固件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|
||||
| :------------|:--------------------|:------------------------------------|:----------------|:--------------------|:--------------------|
|
||||
| XMAU7118 | 待发布 | - | 待定 | PDM到I2S/TDM转换核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| XMAU7118 | 待发布 | - | 待定 | PDM到I2S/TDM转换核心模组,免开发固件 | 待发布 |
|
||||
|
||||
# USB直播麦克风核心模组
|
||||
|
||||
| 产品名称 | 固件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|
||||
| :------------|:--------------------|:------------------------------------|:----------------|:--------------------|:--------------------|
|
||||
| (型号待发布) | 待发布 | - | 待定 | USB直播麦克风核心模组,免开发固件(占位,待发布) | 待发布 |
|
||||
| (型号待发布) | 待发布 | - | 待定 | USB直播麦克风核心模组,免开发固件 | 待发布 |
|
||||
|
||||
|
||||
@@ -262,6 +262,8 @@ nav:
|
||||
- XMSRC4192-VC1: dev_doc/datasheet/std_product/src/xmsrc4192_vc1.md
|
||||
- PDM到I2S/TDM转换核心模组:
|
||||
- XMAU7118-VC1: dev_doc/datasheet/std_product/pdm_2_i2s/xmau7118_vc1.md
|
||||
# - 数字调音台核心模组:
|
||||
# - 数字调音台: dev_doc/datasheet/std_product/digital_mixer/digital_mixer.md
|
||||
|
||||
- 开发评估板资源:
|
||||
- dev_doc/evb/index.md
|
||||
|
||||
Reference in New Issue
Block a user