W55MH32网络唤醒设备

本示例演示如何在 W55MH32 上实现网络唤醒（Wake-on-LAN）功能。该例程用到的其他网络协议（例如 DHCP），请参考相关章节。有关 W55MH32 的初始化过程，请参考 Network Install 章节，这里不再赘述。

开始本例程前，请确认以下工具已安装：

• WIZ UartTool V1.0：串口调试工具：点击下载
• SocketTester：网络调试工具：点击下载

WOL 即网络唤醒（Wake-on-LAN），是一种用于通过网络远程唤醒计算机的网络标准协议。它允许通过发送特定的网络数据包（即"魔术包"，Magic Packet）来唤醒处于休眠或关机状态的设备。

WOL 的特点：

• 简单性：魔术包格式非常简单且固定，由 102 个字节组成，前 6 个字节固定为 0xFF，后续是目标设备 MAC 地址重复 16 次
• 设备待机唤醒：设备在不使用时进入低功耗状态，需要时通过接收魔术包快速恢复正常运行
• 广播机制：魔术包通常通过 UDP 广播发送，即使设备 IP 未知或存在多台设备，也能通过广播包找到目标设备
• 安全性高：WOL 基于 MAC 地址识别目标设备，只有当魔术包中的 MAC 与网卡自身 MAC 匹配时，设备才会被唤醒

1. 开启 WOL 功能：W55MH32 首先需要开启 WOL 功能并开启 WOL 唤醒中断
2. 开启 UDP Socket：W55MH32 需要开启一个 UDP Socket 监听端口，用于接收来自网络的魔术包
3. 发送魔术包：当需要唤醒设备时，通过广播发送魔术包
4. 唤醒操作：如果魔术包中的 MAC 地址与自身匹配，W55MH32 将触发魔术包中断，检测到中断后可以恢复到活动状态

1. Micro USB 线连接 DEBUG USB 口到 PC（供电 + 调试串口）
2. 网线连接开发板 RJ45 网口 到路由器 LAN 口

工程位于 SDK 内 1.SDK\ModuleDemo\WZTOE\WOL\，核心文件如下：

WOL/
├── Project/
│   └── Project.uvprojx       ← Keil 工程文件
└── USER/
    ├── main.c                ← 初始化 + WOL 主循环
    ├── wol.c/h               ← WOL 状态机核心
    ├── wiz_interface/        ← DHCP / PHY 检测 / 网络初始化
    └── uart/
        └── bsp_uart.c/h      ← 调试串口 + printf 重定向

文件：USER/main.c

uint16_t local_port = 9000;

while (1)
{
    wol_run(SOCKET_ID, ethernet_buf, local_port);
}

三个传参分别为：Socket ID、Socket 缓存数组、本地监听端口号（示例为 9000）。主循环不断调用状态机函数，等待魔术包到达。

wol_run() 函数通过不断检查 Socket 状态执行对应操作：SOCK_CLOSED 时创建 UDP Socket 并开启 WOL 功能及中断；SOCK_UDP 时监听中断寄存器，当 IR 寄存器的 MP 位（0x10）生效时判定收到魔术包。

文件：USER/wol.c | 函数：wol_run()

void wol_run(uint8_t sn, uint8_t *buf, uint16_t local_port)
{
    switch (getSn_SR(sn))
    {
    case SOCK_UDP:
        if (getSn_IR(sn) & Sn_IR_RECV)
        {
            setSn_IR(sn, Sn_IR_RECV);
        }
        if (getIR() & IR_MP) // Received WOL Magic packet based on UDP.
        {
            printf("get wake on line\r\n");
            setIR(0x10);
        }
        break;
    case SOCK_CLOSED:
        setIMR(IM_IR4); // Open WOL magic pack interrupt
        setMR(MR_WOL);  // Receive WOL packets

        socket(sn, Sn_MR_UDP, local_port, 0);
        printf("%d:Opened, UDP WOL, port [%d]\r\n", sn, local_port);
        break;
    }
}

关键点：SOCK_CLOSED 时通过 setIMR(IM_IR4) 开启 WOL 魔术包中断，通过 setMR(MR_WOL) 使能 WOL 接收模式，再以 UDP 模式打开 Socket 监听 9000 端口。SOCK_UDP 时清接收中断标志，检测 IR_MP（0x10）位——该位由硬件在收到魔术包时置位，检测到即打印 get wake on line，并通过 setIR(0x10) 清中断。

打开 WIZ UartTool V1.0，连接 DEBUG USB 对应 COM 口（115200 / 8N1）。烧录例程运行后，首先进行 PHY 链路检测和 DHCP 获取网络地址，然后打开 UDP WOL Socket 并监听 9000 端口。预期串口输出如下：

W55MH32 WOL example
PHY link
The current Mbtis speed : 100Mbps
The current Duplex Mode : Full-Duplex
DHCP running
DHCP success!
====================================================================================================
 W55MH32 network configuration : DHCP

 MAC         : 00:08:DC:00:0E:9A
 IP          : 192.168.1.6
 Subnet Mask : 255.255.255.0
 Gateway     : 192.168.1.1
 DNS         : 192.168.1.1
====================================================================================================

0:Opened, UDP WOL, port [9000]

然后在 PC 端打开 SocketTester，设置 UDP 模式，目标 IP 为 W55MH32 的 IP（192.168.1.6），目标端口为 9000，发送 HEX 格式的魔术包数据。

魔术包内容为：FF FF FF FF FF FF + 目标 MAC 地址重复 16 次。W55MH32 收到魔术包后，串口会打印 get wake on line，表示成功接收到魔术包并触发唤醒事件。

本文讲解了如何在 W55MH32 芯片上实现网络唤醒（WOL）功能：

• WOL 协议：基于 UDP 广播的远程唤醒协议，通过魔术包（102 字节）唤醒休眠或关机设备
• 魔术包结构：前 6 字节固定为 FF，之后是目标 MAC 地址重复 16 次，硬件自动解析并触发中断
• 实现流程：setMR 开启 WOL 模式 → setIMR 开启魔术包中断 → 打开 UDP Socket 监听 → 检测 IR 寄存器 MP 位
• 关键 API：setMR(MR_WOL) 使能 WOL、setIMR(IM_IR4) 开启中断、getIR() & IR_MP 检测魔术包
• 应用价值：远程设备管理、工业设备唤醒、智能家居网关控制、网络设备批量维护