ftyyda/phaten-audio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update

Browse Source
This commit is contained in:
PhatenIoT-yan
2025-12-25 14:21:26 +08:00
parent ed34548c71
commit 00f42eab80
72 changed files with 2193 additions and 471 deletions
Download Patch File Download Diff File Expand all files Collapse all files

140
zh/docs/dev_doc/evb/wifi_8711_speaker/RTL8711dev_board.md Normal file
View File

@@ -0,0 +1,140 @@
---
title: WiFi-Audio-TRX-V1 开发评估板规格书
description: WiFi-Audio-TRX-V1 开发评估板外观尺寸、特性参数、应用方向、管脚定义与原理图说明，统一图片样式提升可读性。
keywords: WiFi-Audio-TRX-V1, RTL8711, 开发评估板, 外观尺寸, 特性, 管脚定义, 原理图
---
# WiFi-Audio-TRX-V1 开发评估板规格书
## 产品概述
WiFi-Audio-TRX-V1 具有丰富的功能和出色的性能，适用于多种物联网应用场景。该模组集成了高性能的 MCU、双频 WiFi 和蓝牙功能，可满足不同设备的通信需求。其内部结构设计合理，通过嵌入式调节器为各模块提供稳定的电源供应，同时具备多种电源管理模式以降低功耗。丰富的接口资源使其能够方便地与外部设备进行连接和通信，如传感器、显示屏等。在射频性能方面，无论是 WiFi 还是蓝牙，都能提供可靠的无线连接，确保数据传输的稳定性和高效性。该模组在智能家居、工业物联网、智能穿戴设备等领域具有广泛的应用前景，能够为各类智能设备提供强大的无线通信能力和数据处理能力，助力实现智能化控制和数据交互。
## 外观尺寸
### 产品图片
**正面**
![开发板正面](/assets/images/speaker/11-08/dome/PCB-EV721D00-2v0_Top.png){ width="60%" }
**背面**
![开发板背面](/assets/images/speaker/11-08/dome/PCB-EV721D00-2v0_Bottom.png){ width="60%" }
### 产品尺寸
**_长：65mm ；宽：30mm_**
## 特性
- **支持双频 WiFi 和蓝牙**：支持 WLAN 双频（2.4GHz 和 5GHz）以及低功耗蓝牙 5.0，集成了 Real - M300 高性能 MCU、WLAN MAC、基带、射频和蓝牙等功能，可实现完整的 Wi - Fi 和 BLE 5.0 协议功能。
- **多种工作模式与节能机制**：工作电压范围为 3.0V - 3.6V，支持多种低功耗模式，如睡眠模式和深度睡眠模式，在不同模式下各功能模块可灵活配置电源和时钟以降低功耗。例如，在睡眠模式下，多数功能模块可进行电源门控或时钟门控；在深度睡眠模式下，除 AON 功能外所有功能关闭，以实现超低功耗。
- **丰富的接口资源**：提供可配置的 GPIO 口，便于控制外围设备；集成内部存储器，支持简单应用程序开发；具备多种通信接口，如 UART、SPI、QSPI/OSPI、I2C 等，还提供高速连接接口 SDIO 和 USB，以及音频功能（包括数字麦克风接口和 I2S）。
- **高性能处理器**：内置低功耗 KM4 MCU（基于 Armv8.1 - M 架构，兼容 Cortex - M55 指令集），主频最高可达 345MHz，具有增强的调试功能、浮点计算、数字信号处理扩展指令等特性；同时还有低功耗 KM0 MCU（基于 Armv8 - M 基线架构，兼容 Cortex - M23 指令集），主频最高可达 115MHz，指令集简单、代码尺寸小，与 KM4 处理器代码和工具兼容，适用于对功耗敏感的快速响应操作，如电源管理和网络协议处理。
- **可靠的射频性能**
- **WiFi 射频特性**：在 2.4GHz 频段，遵循 IEEE 802.11b/g/n 标准，支持多种调制方式和传输速率，发射功率和接收灵敏度表现良好；在 5GHz 频段，遵循 IEEE 802.11a/n 标准，同样具备出色的发射和接收性能，且天线具备多样性功能，可通过外部 RF 开关选择最佳天线以减少信道衰落影响，同时采用实时校准机制确保无线电系统稳定运行。
- **蓝牙射频特性**：符合蓝牙 5.0 规格，在 2.4GHz 频段工作，发射功率和接收灵敏度满足相关标准，支持多种蓝牙功能，如快速 AGC 控制、多种功率等级、增强型功率控制以及低功耗模式（如 BLE）。
## 应用方向
* 智能家居（照明控制、开关和插头、家电等）
* 工业 4.0
* 低功耗物联网设备（低功耗 Wi-Fi 摄像头、智能门锁等）
* 智能穿戴设备
* 便携式设备
* 游戏配件
* 无线音频设备
* 智能交互玩具等
## 主要参数
**电气参数**
* 工作电压：3.0V - 3.6V。
* 工作温度：-30℃ to 85℃。
* 存储温度：-40℃ to 125℃。
**射频参数**
WiFi（2.4GHz）
* 发射功率：802.11b@11Mbps 可达 18dBm；802.11g@54Mbps 可达 17dBm；802.11n@N20 MCS7 可达 16dBm；802.11n@N40_MCS7 可达 16dBm。
* 接收灵敏度：802.11b@11Mbps 可达 - 85dBm；802.11g@54Mbps 可达 - 73dBm；802.11n@N20 MCS7 可达 - 68dBm；802.11n@N40 MCS7 可达 - 65dBm。
WiFi（5GHz）
* 发射功率：802.11a@54Mbps 可达 13dBm；802.11n@N20_MCS7 可达 12dBm；802.11n@N40_MCS7 可达 12dBm。
* 接收灵敏度：802.11a@54Mbps、802.11n@N20 MCS7、802.11n@N40 MCS7 相关参数未详细给出（参考文档后续部分或实际产品详细规格）。
*
**蓝牙**
* 发射功率：0 - 10dBm（BLE，GPSK/1Mbps 和 GPSK/2Mbps）。
* 接收灵敏度：≤ - 95dB（灵敏度 LE1M@PER<30.8%）；≤ - 93dB（灵敏度 LE2M@PER<30.8%）。
## 管脚定义
| 引脚编号 | 名称 | 功能描述 |
|------|-------|-------------------------------------------------------------------------------|
| 1 | VD33 | 3.3v供电 |
| 2 | VD5V | 5v供电 |
| 3 | PB30 | 唤醒引脚。此引脚在复位期间应保持上拉。默认功能为通用输入/输出，并且可以配置为其他功能 |
| 4 | VD5V | 5v供电 |
| 5 | PB31 | 唤醒引脚。IC的工作模式由电源开启过程中陷阱引脚PB31/TM_DIS的电平决定。1：正常模式0：测试模式默认功能为通用输入/输出，并且可以配置为其他功能 |
| 6 | PB_2 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 7 | PA12 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 8 | PB_2 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 9 | PA_28 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 10 | PB_3 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 11 | PA_28 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 12 | PB_15 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 13 | PB7 | 功率输入到数字I/O电源域 |
| 14 | PB_15 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 15 | PB9 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 16 | PB8 | 功率输入到数字I/O电源域 |
| 17 | VD33 | 3.3v供电 |
| 18 | PB13 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 19 | PA23 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 20 | PB14 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 21 | PA_20 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 22 | PB14 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 23 | PA_30 | 默认功能为SWD CLK，在IC启动后可以配置为其他功能 |
| 24 | PA_21 | 功率输入到数字I/O电源域。默认功能为通用输入/输出，并且可以配置为其他功能 |
| 25 | PB_0 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 26 | PA22 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 27 | PB0 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 28 | PB_15 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 29 | PA_29 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 30 | PB_21 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 31 | PB_18 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 32 | PB_21 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 33 | PB_19 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 34 | PB_22 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 35 | PB20 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 36 | PB_22 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 37 | PB6 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 38 | PB_22 | 默认功能为通用输入/输出，并且可以配置为其他功能 |
| 39 | GND | 接地 |
| 40 | GND | 接地 |
## 原理图
![开发板原理图](/assets/images/speaker/11-08/dome/8711开发板原理图.png){ width="80%" }
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

26
zh/docs/dev_doc/evb/wifi_8711_speaker/design_docs.md Normal file
View File

@@ -0,0 +1,26 @@
---
title: WiFi-Audio-TRX-V1 Wi‑Fi 音频评估板设计文档
hide:
- toc
login: true
description: Phaten Audio WiFi-Audio-TRX-V1 基于 Realtek RTL8711 的 Wi‑Fi 音频评估板设计资料入口，包含原理图、BOM 与元器件规格说明。
keywords: Phaten Audio, WiFi-Audio-TRX-V1, RTL8711, Wi‑Fi 音频, 评估板, 设计文档, 原理图, BOM
---
# WiFi-Audio-TRX-V1 Wi‑Fi 音频评估板设计文档
--8<-- "common/phaten_xmos_support_img.md"
--8<-- "common/checklogin_form.md"
| 类型 | 标题 | 下载 |
| :----------------: | :------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 评估板的模组规格书 | :material-file-document-outline: WiFi-Audio-TRX-V1 评估板模组规格书 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/factory_img/wifi_audio_trx/WB30D-1711DCMV1 模组规格书(1).pdf')"> :material-download: </a> |
| 评估板原理图 | :material-file-document-outline: WiFi-Audio-TRX-V1 评估板原理图 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/factory_img/wifi_audio_trx/8711evb原理图.pdf')"> :material-download: </a> |
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

59
zh/docs/dev_doc/evb/wifi_8711_speaker/firmware_flashing.md Normal file
View File

@@ -0,0 +1,59 @@
---
login: true
description: RTL8711/RTL8730 烧录工具与评估板烧录流程，含进入烧录与打印模式步骤与注意事项。
keywords: RTL8711, RTL8730, 烧录工具, WiFi-Audio-TRX-V1, 评估板, 下载, 固件
---
--8<-- "common/checklogin_form.md"
# WiFi-Audio-TRX-V1系列烧录说明
该工具是RTL8711Dx的烧录工具，支持8711和8730。
## 准备工作
烧录工具下载：<a href="javascript:void(0);" onclick="checkLogin('/assets/download/a316-8711-5.1make/ImageTool-调试烧录8711-8730工具.zip')">:material-download:</a>
### 模组进入烧录模式
![8711 模组烧录接线示意](/assets/images/speaker/11-08/model/8711模组烧录方式.jpg){width="48%"} ![8711 模组外观](/assets/images/speaker/11-08/model/8711%20模组图片.png){width="48%"}
### 评估板进入烧录模式
先按住 download 按键，再按住 chip 按键。串口打印\0。然后一起放手
### 打印模式
按一下 chip 按键 可以复位
![评估板按键与接口示意](/assets/images/speaker/shaolu-1.png){width="65%"}
!!! note
**图中download按键右边是只供电的type-c接口，最右边的type-c接口可用于供电和串口打印**
## 操作步骤
### 步骤一：下载好工具并双击打开
![工具所在目录示意](/assets/images/speaker/shaolu-2.png){width="70%"}
### 步骤二：打开软件，点击“File”→“Open”选取文件
![软件主界面与打开文件](/assets/images/speaker/shaolu-3.png){width="70%"}
### 步骤三：选择配置文件
选择 "AmebaDplus FreeRTOS NOR.rdev"（第 3 个）用于 8711；第 6 个为 8730，按需选用。
![选择 rdev 配置文件](/assets/images/speaker/shaolu-4.png){width="70%"}
### 步骤四：选择需要烧录的固件
确保固件名称与配置一致。
![选择固件文件](/assets/images/speaker/shaolu-5.png){width="70%"}
### 步骤五：按需添加 VFS 文件
如需添加额外 VFS，请自定义文件名，例如 "vfs.bin"。
![添加 VFS 文件示意](/assets/images/speaker/addVFS.png){width="60%"}
### 步骤六：选择串口与波特率并开始烧录
按图选择串口、波特率（通常自动选择），核对无误后点击下方 "Download" 开始烧录。
![开始烧录流程与设置](/assets/images/speaker/shaolu-6.png){width="70%"}
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

31
zh/docs/dev_doc/evb/wifi_8711_speaker/index-chanpliebiao.md Normal file
View File

@@ -0,0 +1,31 @@
---
title: Wi‑Fi 无线音响系列核心固件
hide:
- toc
---
--8<-- "common/phaten_xmos_support_img.md"
# Wi‑Fi 无线音响
!!! info "产品列表"
<div class="sticky-column" markdown>
| **产品(功能:material-arrow-down:)(型号:material-arrow-right:)** | [WB8711_ZW](./wb8711_zw.md) |
|---------------------|---------------------|
| **无线规格** | 2.4 / 5GHz Wi‑Fi，BLE 5.0 |
| **配置与部署** | ZeroConfig + Web 配置中心 |
| **应用方向** | 家庭影院无线音频/智能音箱 |
| **参考规格** | [WB8711-ZW 模组规格](../../dev_doc/wifi_speaker/wb8711_zw.md) |
| **Status** | Active |
</div>
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

136
zh/docs/dev_doc/evb/wifi_8711_speaker/index.md Normal file
View File

@@ -0,0 +1,136 @@
---
title: WiFi-Audio-TRX-V1 Wi‑Fi 音频评估板
description: 基于 Realtek RTL8711 平台的 Wi‑Fi 无线音响评估板/固件参考页面，支持 ZeroConfig 与 Web 配置，适配 2.4/5.8GHz 与 BLE 5.0。
keywords: Wi‑Fi 无线音响, RTL8711, ZeroConfig, Web 配置, BLE 5.0, 评估板
hide:
- toc
login: true
---
<!-- 结构化数据标记（SEO） -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "WiFi-Audio-TRX-V1 Wi‑Fi 音频评估板",
"description": "基于 Realtek RTL8711 平台的 Wi‑Fi 无线音响评估板/固件参考，支持 ZeroConfig 与 Web 配置，适配 2.4/5GHz 与 BLE 5.0。",
"brand": {
"@type": "Brand",
"name": "Phaten Audio"
}
}
</script>
--8<-- "common/checklogin_form.md"
--8<-- "common/phaten_xmos_support_img.md"
<div class="grid" markdown>
<div class="card-wide" markdown>
# WiFi-Audio-TRX-V1
__免开发 ZeroConfig + Web 配置的 Wi‑Fi 无线音响固件（Realtek RTL8711Dx 平台）__
</div>
</div>
<div class="result" markdown>
![WiFi-Audio-TRX-V1示意图](/assets/images/evb/8711_wifi_speaker/8711kf.png){align=right width=400}
WiFi-Audio-TRX-V1 面向 Wi‑Fi 无线音响、智能音箱等场景的用户自定义固件，支持开箱即用的 ZeroConfig 流程与 Web 配置界面；基于 Realtek `RTL8711Dx` 系列模组，支持 2.4 / 5.8GHz 双频 Wi‑Fi 与 BLE 5.0，满足高可靠连接与便捷部署需求。
- ZeroConfig 首次上电引导，热点快速配置音响通道
- 内置 Web 配置中心
- 支持配置导入/导出，适配批量交付
[:shopping_cart: 样品购买](){.md-button }
</div>
## 特性与文档
=== "关键特性"
- Wi‑Fi 5.8G 无线音频链路，低延迟、强抗干扰、稳定可靠（可支持最高10声道传输，取决于项目配置）。
- ZeroConfig 首次上电引导与 Web 可视化配置，支持自动重连。
- 场景化声道配置：标准5.1、紧凑3.1、简约2.1，可扩展至7.1.2；灵活的通道映射与设备分组。
=== "无线音频传输"
- 5.8GHz Wi‑Fi 无线传输，最远可达20米，优化音频链路的延迟与抖动，支持主机（Soundbar）与后置环绕/低音炮的多点连接。
- 多链路协同与抗干扰策略：自动信道选择、回连与容错，适配复杂环境。
- 基于BLE用于快速配对/辅助配置（具体取决于硬件平台能力）。
=== "音频规格与同步"
- 支持多种高解析度音频：PCM 默认最高192kHz/48bit。
- 动态范围优化与缓冲同步策略，保障高保真与稳定播放，降低卡顿与失步。
- 支持主从转换，播放延迟20ms。
=== "声道与角色"
- 角色定义：主机（Soundbar/Master）、后置环绕（Rear L/R）、低音炮（Sub），支持自定义扩展。
- 通道映射：支持在 Web 配置中直观分配声道至设备，适配不同房间布局。
- 设备分组与组网：支持组ID与自动发现，便于多套系统并行部署。
=== "Web 配置"
- 配置中心：网络（AP/STA）、设备配对、声道映射、声道试听。
> 以上硬件参数与能力参考自 Realtek `RTL8711Dx` 系列模组规格，具体以实际选型与规格书为准。
=== "技术文档"
| 类型 | 标题 | 链接 |
| :----------: | :------------------------------------------------ | :-------------------------- |
| 使用说明 | [:material-file-document-outline: 使用说明] | [:material-open-in-new:](./user_guide.md) |
| Web 配置指南 | [:material-file-document-outline: Web 配置使用说明] | [:material-open-in-new:](./web_config_guide.md) |
| 固件烧录说明 | [:material-file-document-outline: 固件烧录步骤] | [:material-open-in-new:](./firmware_flashing.md) |
| 硬件规格书 | [:material-file-document-outline: 硬件规格书] | [:material-open-in-new:](./RTL8711dev_board.md) |
| 设计资料 | [:material-file-document-outline: 设计资料] | [:material-open-in-new:](./design_docs.md) |
=== "固件列表"
| 文件名称 | 固件版本 | 发布日期 | 固件说明 | 下载 |
|:--------------------|:---------|:--------|:--------------------|:--------------------|
| WiFi-Audio-TRX-V1 Factory Image | v1.0 | | 评估板出厂镜像，基础固件 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/factory_img/wifi_audio_trx/WiFi-Audio-TRX-V1.zip')">:material-download:</a> |
| WiFi-Audio-TRX-V1 VFS Config Firmware | v1.0 | | 配置固件，需要与基础固件一起烧录使用 | <a href="javascript:void(0);" onclick="checkLogin('/assets/download/factory_img/wifi_audio_trx/VFS-config.zip')">:material-download:</a> |
=== "工具和软件"
| 类型 | 描述 | 下载 |
| :----------: | :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- |
| 调试工具 | 调试工具合集 | [:material-toolbox: 工具与软件](../../../services_support/tools_software/index.md) |
| 驱动程序 | USB 驱动 | [:material-usb-flash-drive-outline: USB驱动](../../../services_support/driver/index.md) |
## 应用场景
- 多声道家庭影院无线应用
- 标准5.1、紧凑3.1、简约2.1声道配置，可扩展至7.1.2
- 支持主机（Soundbar/Master）与后置环绕/低音炮的多点连接
- 可扩展场景与部署
- 酒店、公寓、商超等公共空间的批量快速部署
- 家庭与工作室的网络化音频播放系统，多套系统并行组网
- 支持设备分组、自动发现与声道映射，适配不同房间布局
## 订购信息
| 产品名称 | 产品型号 | 产品图片 |
| :----------------- | :-------- | :-------------------------------------------------------------------------------------------: |
| Wi‑Fi 无线免开发音响评估板 | WiFi-Audio-TRX-V1 | ![WiFi-Audio-TRX-V1](/assets/images/evb/8711_wifi_speaker/8711kf.png "Wi-Fi Audio TRX V1评估板"){align=center width=120} |
> 可根据实际模组/机型提供定制化固件（主题、功能裁剪、出厂参数）。
<!-- ## 支持的产品
<div class="grid cards" markdown>
- :material-developer-board: __RTL8711 系列 Wi‑Fi 音频评估板与固件__
---
提供网络配置与音频路由评估，便于快速验证固件能力（示例）。
[:octicons-arrow-right-24: 查看产品页](../../../products/wifi_speaker/WiFi-Audio-TRX-V1.md)
</div> -->
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

46
zh/docs/dev_doc/evb/wifi_8711_speaker/user_guide.md Normal file
View File

@@ -0,0 +1,46 @@
---
title: WiFi-Audio-TRX-V1 用户使用指南
description: WiFi-Audio-TRX-V1 评估板使用指南，涵盖硬件准备、按键与指示灯焊接说明、固件烧录与 Web 配置入口。
keywords: WiFi-Audio-TRX-V1, RTL8711, 评估板, 用户指南, 固件烧录, Web配置
---
# WiFi-Audio-TRX-V1 用户使用指南
适用于 WiFi-Audio-TRX-V1 评估板的快速入门与使用说明，包含硬件准备、TX 按键与指示灯焊接、固件烧录与 Web 配置入口。
## 硬件设备准备
### 评估板
- [WiFi-Audio-TRX-V1 评估板](./index.md)
WiFi-Audio-TRX-V1 可作为发送板或接收板使用：统一命名为发送板为 TX，接收板为 RX。
!!! warning "注意"
1. TX 板 需要与RX板配套使用
2. RX 板 不包含扬声器，需要额外连接扬声器。
3. TX 板 pin28脚位连接GND，保持2秒以上(串口打印关键字：FTYWiFiSpeaker)，即可进入web配置模式。
4. TX 板 开发了额外的指示灯和按键，用于调试和配置。（详细请参考[TX 发送板的硬件调整](./user_guide.md#tx)）
### TX 发送板的硬件调整(可选)
!!! note "焊接额外的按键和指示灯"
1. `PB_17` 脚位连接指示灯 IO，灯串联 1k 电阻后接 `GND`
2. 板子上的 `GND` 连接按键一端
3. `PB_1` 连接按键的另一端（`GND`）
![TX 侧边按键焊接示意](/assets/images/evb/8711_wifi_speaker/side-key0.jpeg){width="60%"}
![TX 侧边按键与指示灯位置](/assets/images/evb/8711_wifi_speaker/side-key01.png){width="45%"} ![TX 侧边按键背面示意](/assets/images/evb/8711_wifi_speaker/side-key02.png){width="45%"}
## [烧录固件](./firmware_flashing.md)
## [web配置与验证固件功能](./web_config_guide.md)
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>

62
zh/docs/dev_doc/evb/wifi_8711_speaker/web_config_guide.md Normal file
View File

@@ -0,0 +1,62 @@
---
title: WiFi-Audio-TRX-V1 Web 配置指南
description: WiFi-Audio-TRX-V1 音响评估板 TX/RX Web 配网教程
keywords: Wi‑Fi音响,WB8711_ZW,RTL8711,WiFi-Audio-TRX-V1,Web配置,配网,评估板
hide:
- toc
---
# WiFi-Audio-TRX-V1 Web 配置指南
适用于 WiFi-Audio-TRX-V1 无线音响固件与评估板的 Web 配网和设备管理操作，帮助你快速完成 TX 与 RX 的扫描、配对与参数配置。
## 准备工作
- TX 上电后，默认按固件配置进入配网模式；需进入 Web 配置时请按住 TX 指示灯按钮（详细请参考[TX 发送板的硬件调整](user_guide.md###tx-发送板的硬件调整) 如无调试开关，可杜邦线短接 `pin28` 至 `GND`，保持 2 秒以上）。
- RX 上电待机，确保未与其他 TX 配对。
- 搜索并连接 TX 发出的 Wi‑Fi（示例：`FTYWiFiSpeaker_7BA3`），默认密码为 `12345678`，不可更改。
- 连接成功后会自动弹出浏览器进入 Web 配置页面。建议复制页面中的 IP，另开浏览器窗口访问，以提升稳定性。
- 设备建议：安卓手机、Windows 电脑、macOS。苹果手机不建议使用。
![alt text](/assets/images/evb/8711_wifi_speaker/web-config.png)
## 开启 Web 配置模式（TX）
1. TX 通电后长按指示灯按钮（或短接 `pin28` 至 `GND` 2 秒以上），进入 Web 配置模式。
2. Web 页面加载后，默认进入配网扫描模式；页面上的【Start Scanning】按钮为红色，TX 指示灯快闪表示正在扫描。
## 连接 RX 并扫描
1. RX 通电后，会自动连接到 TX，并在 Web 页面显示连接状态。
2. 如需停止扫描，点击红色【Start Scanning】按钮，按钮变为绿色表示停止扫描。
3. 新近连接成功的 RX 会显示在【Scanned Devices】区域，状态为“已连接 - 未配对”。
4. 如需添加新的 RX，可反复开启/关闭【Start Scanning】按钮（红色为开启，绿色为关闭）。
## 配置 RX 参数
1. 在中间区域【Network Control】，通过【Device-Type】选择当前 TX 的通道配置。该选项不保存记忆，离开页面后需重新选择。
2. 在下方【Device Management】区域，可查看各 RX 的连接状态，并进行如下操作：
- 选择通道：【Channel】
- 修改名称：【Device Name】
- 执行配对：【Pair】
- 测试声音：【Test】
3. 已完成配对的 RX 将锁定到当前 TX，无法再与其他 TX 配对；未配对的 RX 断电后可与其他 TX 重新连接。
## 完成配置与播放
1. 确认所有 RX 的参数与配对后，点击【Paired Complete】完成 Web 配置。
2. TX 会自动重启并退出 Web 配置模式，此时不会再出现配网 Wi‑Fi 信号。
3. 待 RX 重新回连后，TX 仅连接已配对的 RX，即可开始正常播放。
## 常见问题与排障
- RX 通电后未显示在页面上：请确认 RX 未与其他 TX 配对；重置 RX 并在 TX 页面重新开启扫描。
- Web 配置模式下无法播放电脑声音：属正常现象，配置模式仅支持测试音。请点击【Paired Complete】结束配置后再测试播放。
- 手机连接 Wi‑Fi 后页面无法正常刷新：TX 发出的 Wi‑Fi 为非路由器认证网络，部分手机/电脑会将其判定为“需验证网络”。连接后请使用浏览器按 IP 访问，稳定性更好。
- TX 页面无法刷新或连接断开：请重新上电 TX，并长按进入 Web 配置模式；重新连接配网 Wi‑Fi 并按 IP 访问。
## 咨询反馈
<details>
<summary>点击展开咨询反馈表单</summary>
--8<-- "common/customer_form.md"
</details>