如何更新 NuMaker IoT 板上的 Wi-Fi 模块固件？

答案对人有帮助，有参考价值 0

更新 NuMaker IoT 板上的 Wi-Fi 模块固件取决于具体的 Wi-Fi 模块型号和开发板版本。Nuvoton 的 NuMaker IoT 板通常使用联发科的 MediaTek MT7697 (或 MT7697D) 或 Realtek 的 RTL8711系列 作为其 Wi-Fi/BLE 模组。

以下是通用的步骤指南和要点（以 MediaTek MT7697 为例，这是非常常见的配置）。请务必在操作前查阅您特定型号开发板的官方文档！

核心步骤：

1. 
   

   确定 Wi-Fi 模块型号和固件：

   
   
   
   
   • 查阅您所持 NuMaker IoT 开发板的用户手册或技术规格书。通常在 Board Features 或 Introduction 部分会明确说明使用的 Wi-Fi/BLE 模组型号 (例如 MT7697)。
   
   
   • 关键： 确定您需要下载哪个特定版本的固件文件（通常是以 .bin 结尾的文件）。这通常在 Nuvoton 或联发科（需要授权）的官网上提供，有时会随 SDK 一起发布。不要下载错误的固件文件！
   
   
   
   


2. 
   

   选择更新方法：

   
   
   
   
   • 推荐方法：通过 USB 虚拟串口 (VCOM) / MTK Flasher： 这是最常用也相对方便的方式。
   
   
   • 备选方法：通过 UART： 有时也可以通过开发板上的主控 MCU 的 UART 接口间接连接到 Wi-Fi 模块的 UART 进行更新，但这通常需要额外的接线和配置，不如 USB VCOM 直接。
   
   
   
   

（以 MT7697 通过 USB VCOM 更新为例）详细步骤：

先决条件：

• 一块 NuMaker IoT 开发板（例如 NuMaker-IoT-M467， NuMaker-IoT-N9H30）。


• USB Type-C/Micro USB 线缆（连接开发板的 USB Debug/Update 接口）。


• 下载正确的 Wi-Fi 模块固件文件 (XXXX.bin) 。


• 安装 MTK Flasher 工具。这个工具通常包含在 Nuvoton 提供的针对该 IoT 板的 SDK 或 BSP 包中。找到名为类似 mt7697_flash_tool 的目录。它是一个用 Python 或可执行文件实现的工具。


• Windows 用户： 确保安装了 USB VCOM (Virtual COM Port) 驱动程序。这个驱动通常也包含在 SDK/BSP 包中，或需要在下载页面单独下载。安装后，连接开发板时才能在设备管理器中看到一个额外的 COM 端口（这就是 MT7697 的 UART 接口）。
  
  
  
  • Linux/macOS 用户： 通常不需要额外驱动，连接后会产生一个 /dev/ttyACMx 或 /dev/ttyUSBx 设备。
  
  

操作流程：

1. 
   

   连接开发板：

   
   
   
   
   • 仅通过 USB 线将开发板的 USB Debug/Update 接口连接到电脑。此时无需连接串口调试 UART。确保开发板由 USB 供电。
   
   
   • 如果是第一次使用或驱动未装好，检查设备管理器 (Windows) 或 ls /dev/tty* (Linux/macOS) 确认是否识别到了新的串口设备（如 COM7， /dev/ttyACM0）。
   
   
   
   


2. 
   

   准备 MTK Flasher 工具：

   
   
   
   
   • 导航到 SDK/BSP 包中的 mt7697_flash_tool 或类似目录。
   
   
   • 关键设置 (config.ini 或命令行参数)：
     
     
     
     • com_port: 指定你在第一步中识别到的 MT7697 VCOM 端口号（如 COM7 或 /dev/ttyACM0）。
     
     
     • baudrate: 通常需要设置为 921600 或文档指定值。115200 可能太慢。
     
     
     • firmware_path: 指定你下载好的 Wi-Fi 固件 .bin 文件的完整路径。
     
     
     • 可能还有其他参数如 board_name (如果是 MT7697D，可能需要设置为 linkit7697_hdk)，严格参照 SDK 内的说明或 README 文件。
     
     
   
   
   • 确保你的系统安装了该工具所需的运行环境（通常是 Python 和可能需要的包如 pyserial）。
   
   
   
   


3. 
   

   进入 Bootloader (下载) 模式：

   
   
   
   
   • 这是最关键的一步！ 不同板子略有差异：
     
     
     
     • 常见方法 A (复位按钮组合)：
       
       
       
       1. 找到开发板上的 Wi-Fi 模块复位按钮 (通常标记为 WIFI_RST 或 SW1) 和主控 MCU 复位按钮 (标记为 MCU_RST 或 SW2)。
       
       
       2. 先按下并按住 WIFI_RST 按钮。
       
       
       3. 保持按住 WIFI_RST 的同时，再按下并按住 MCU_RST 按钮大约 1 秒。
       
       
       4. 先释放 MCU_RST 按钮。
       
       
       5. 等待 1-2 秒后，再释放 WIFI_RST 按钮。
          
          
          
          • 此时 Wi-Fi 模块应该进入了 bootloader 模式，准备接收新固件。
          
          
       
       
     
     
     • 常见方法 B (通过命令)： 如果主控 MCU 的程序（例如运行在 Cortex-M4F 或 ARM9 上的 NuMicro/N9Hxx 固件）支持，可以通过串口调试终端发送特定命令（如 AT+UPDATE 或 SDK 提供的命令行工具）让 Wi-Fi 模块进入下载模式。这需要参考特定 SDK 的文档。
     
     
   
   
   • 观察 VCOM 端口： 有时在成功进入 bootloader 模式后，通过串口终端软件打开该 VCOM 端口（波特率通常也是 921600 8N1），能看到类似 Bootloader Ready 或乱码提示（表明 UART 已激活）。
   
   
   
   


4. 
   

   运行 Flash 工具：

   
   
   
   
   • 在命令行终端中，导航到 mt7697_flash_tool 目录。
   
   
   • 运行指定的命令，通常是：python flashtool.py [参数] 或直接运行提供的可执行文件（如 MT7697FlashTool.exe）。
   
   
   • 例如：python flashtool.py -p COM7 -b 921600 -f C:Downloadsmt7697_firmware_latest.bin （替换成你的实际端口和固件路径）。
   
   
   • 工具会开始连接模块并发送固件数据。保持 USB 连接稳定！ 整个过程可能需要几十秒到几分钟。
   
   
   
   


5. 
   

   观察输出和等待完成：

   
   
   
   
   • 工具会显示进度百分比和状态信息。留意是否有错误提示。
   
   
   • 如果一切顺利，工具最终会显示 Update Success 或类似信息，表示固件写入完成。
   
   
   
   


6. 
   

   退出 Bootloader 和复位：

   
   
   
   
   • 固件更新完成后：
     
     
     
     • 按一次 MCU_RST 按钮复位主控 MCU。
     
     
     • 或者直接拔掉 USB 线重新上电。
     
     
     • 或者有些工具会自动执行复位退出 bootloader 模式。
     
     
   
   
   
   


7. 
   

   验证更新：

   
   
   
   
   • 连接开发板的调试串口（通常是另一个 UART 接口，连接主控 MCU）到你的电脑串口终端（如 PuTTY, minicom, Tera Term）。
   
   
   • 设置正确的串口参数（波特率、数据位、停止位、校验位 - 通常是 115200 8N1）。
   
   
   • 给开发板上电或复位。观察启动日志输出。主控 MCU 的程序在初始化 Wi-Fi 模块时会打印其当前固件版本号。确认该版本号与你刚烧录的固件版本一致。
   
   
   • 测试功能： 运行你的应用程序（AT 命令集或 SDK WiFi API），尝试连接 Wi-Fi 网络、建立 TCP/UDP 连接等，确认 Wi-Fi 功能正常工作。
   
   
   
   

重要注意事项：

• 风险： 固件更新存在风险。如果电源中断、USB 线松动、使用了错误固件或操作失误，可能导致 Wi-Fi 模块无法启动（变砖）。请谨慎操作，并确保步骤清晰。


• 驱动程序： Windows 用户的 USB VCOM 驱动是必须且常出问题的地方。务必正确安装。如果设备管理器里带黄色感叹号，更新驱动指向 SDK 包里的驱动文件夹。


• Bootloader 进入： 步骤 3 是关键中的关键。失败率较高。多试几次组合按键的时机和时长，确认 VCOM 端口的状态（可以打开终端看看是否有反应）。


• 固件来源： 仅使用从 Nuvoton 官方网站、开发者论坛或授权渠道获取的固件。使用错误或不兼容的固件会导致模块不可用。


• 波特率： 高速率 (921600) 对避免超时错误很重要。


• 线缆与连接： 使用可靠的 USB 线缆，插在电脑主机后置的 USB 端口（避免通过扩展坞）。


• 静电防护： 操作前触摸接地金属物体释放静电，避免裸手接触电路板敏感部位。


• 阅读文档： 再次强调，仔细阅读并遵循你特定 NuMaker IoT 板和 SDK 版本的官方更新指南！ Nuvoton 的网站、Github (Nuvoton Mbed, NuMaker IoT SDK) 是重要资源。

如果使用 Realtek RTL8711 系列模块：

更新过程通常是类似的逻辑（进入特殊模式 + UART 刷写），但使用的工具不同。Nuvoton SDK 中应该包含对应的 Realtek 烧录工具（可能是 rtl8710_flash_tool 或类似）和固件文件。操作的关键同样是 正确进入 Realtek 的 Download/UART Upgrade 模式（这通常也涉及特定的按键组合或命令），然后运行 Realtek 的专用工具进行烧录。

总结：

更新 Wi-Fi 固件的主要挑战在于：1) 找到正确的固件文件；2) 正确安装 USB VCOM 驱动 (Windows)；3) 成功使模块进入 Bootloader 模式。一旦这三个点解决了，运行官方提供的烧录工具本身相对直接。务必优先查阅官方文档！ 如果你找不到针对你板子的文档，请到 Nuvoton 官方论坛搜索或提问，提供你开发板的完整型号（如 NuMaker-IoT-M467-V1.0）。