通过NetBIOS名称访问W55MH32的HTTP服务器

本示例演示如何在 W55MH32 上将 HTTP Server 与 NetBIOS 功能相结合，通过 NetBIOS 名称解析动态 IP，再用该 IP 发起 HTTP 请求，解决 IP 地址变动带来的访问难题。在 HTTP Server 章节中，我们实现了通过 IP 地址访问 W55MH32 的 web 服务器，然而当启用 DHCP 时 IP 地址会动态变化，无法总是通过固定 IP 访问。

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

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

本例程将 HTTP Server 和 NetBIOS 两个应用层协议结合使用。HTTP Server 基于 TCP 80 端口提供 Web 内容服务，NetBIOS 基于 UDP 137 端口提供局域网名称解析服务。两者并行运行在主循环中：NetBIOS 负责将设备名称解析为动态 IP 地址，HTTP Server 负责处理浏览器的 Web 请求。PC 端只需在浏览器中输入 NetBIOS 名称即可访问设备网页，无需关心 IP 地址变化。

两个协议的对比：

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

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

6.NetBIOS_HTTP/
├── Project/
│   └── Project.uvprojx       ← Keil 工程文件
└── USER/
    ├── main.c                ← 硬件初始化 + 网络配置 + HTTP+NetBIOS 主循环
    ├── wiz_interface/
    │   ├── wiz_interface.c   ← PHY 检测 / 网络信息打印
    │   └── wiz_interface.h
    ├── httpServer/
    │   ├── httpServer.c      ← HTTP 服务器核心 (TCP 80)
    │   ├── httpServer.h
    │   ├── httpParser.c      ← HTTP 请求解析
    │   └── httpParser.h
    ├── netbios/
    │   ├── netbios.c         ← NetBIOS 名称服务 (UDP 137)
    │   └── netbios.h
    ├── dhcp/
    │   ├── dhcp.c            ← DHCP 客户端状态机 (DORA)
    │   └── dhcp.h
    ├── uart/
    │   ├── bsp_uart.c        ← 调试串口 + printf 重定向
    │   └── bsp_uart.h
    └── tim/
        └── bsp_tim.c/h       ← TIM3 1ms 定时器

本例程在 HTTP Server 基础上新增 NetBIOS 名称服务，主循环中并行运行 HTTP 服务器和 NetBIOS 解析器。

文件：USER/main.c — 首先将网络信息（MAC、IP、子网掩码、网关、DNS）格式化为字符串并填充到网页模板中，然后注册网页内容并初始化 HTTP 服务器。

sprintf(mac, "%02X:%02X:%02X:%02X:%02X:%02X", net_info.mac[0], net_info.mac[1], net_info.mac[2], net_info.mac[3], net_info.mac[4], net_info.mac[5]);
sprintf(ip, "%d.%d.%d.%d", net_info.ip[0], net_info.ip[1], net_info.ip[2], net_info.ip[3]);
sprintf(sn, "%d.%d.%d.%d", net_info.sn[0], net_info.sn[1], net_info.sn[2], net_info.sn[3]);
sprintf(gw, "%d.%d.%d.%d", net_info.gw[0], net_info.gw[1], net_info.gw[2], net_info.gw[3]);
sprintf(dns, "%d.%d.%d.%d", net_info.dns[0], net_info.dns[1], net_info.dns[2], net_info.dns[3]);
sprintf(page, (char *)index_page, mac, ip, sn, gw, dns);

reg_httpServer_webContent((uint8_t *)"index.html", (uint8_t *)page);         // 注册HTTP服务器网页内容
httpServer_init(http_tx_ethernet_buf, http_rx_ethernet_buf, 1, socknumlist); // 初始化HTTP服务器

reg_httpServer_webContent() 将格式化后的网页内容注册到 HTTP 服务器，httpServer_init() 初始化 HTTP 服务器所需的 socket 和缓冲区。网页模板 index_page 中包含 MAC、IP 等占位符，由 sprintf 填充实际值。

文件：USER/main.c — 在主循环中并行调用 httpServer_run() 和 do_netbios()，同时处理 HTTP 请求和 NetBIOS 名称查询。

while (1)
{
    httpServer_run(SOCK_HTTPS);   // 运行HTTP服务器
    do_netbios(SOCK_NETBIOS);     // 处理NetBIOS名称解析
}

当 PC 端使用 NetBIOS 名称访问时，首先发送广播请求，W55MH32 在 do_netbios() 中解析并比对名称，匹配后返回 IP 地址。PC 端将名称替换为 IP 发起 HTTP 请求，W55MH32 在 httpServer_run() 中处理请求并返回网页内容。两个函数在主循环中交替执行，实现并行处理。

烧录例程运行后，首先进行 PHY 链路检测，然后通过 DHCP 获取网络地址并打印，接着程序开始持续接收和响应 NetBIOS 请求与 HTTP 请求。打开 WIZ UartTool V1.0，连接对应 COM 口（115200 / 8N1），预期串口输出如下：

W55MH32 HTTP Server example
PHY link
The current Mbtis speed : 100Mbps
The current Duplex Mode : Full-Duplex
====================================================================================================
 W55MH32 network configuration : static

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

Please enter W55MH32/ in your browser to access the W55MH32 HTTP server
> HTTPSocket[0] : CLOSED
> HTTPSocket[0] : OPEN

串口显示 DHCP 成功获取 IP 后，当 PC 浏览器访问 http://W55MH32/ 时，W55MH32 先响应 NetBIOS 名称查询（name is W55MH32 → send response），PC 端获取 IP 后发起 HTTP 请求，浏览器显示设备网页信息。

• 方案定位：将 HTTP Server 与 NetBIOS 结合，解决 DHCP 动态 IP 导致的访问难题
• 协议分工：NetBIOS（UDP 137）负责名称解析，HTTP Server（TCP 80）负责 Web 内容服务
• 工作流程：PC 广播名称查询 → W55MH32 匹配名称回复 IP → PC 建立 IP 映射 → 浏览器发起 HTTP 请求
• 实现要点：主循环并行调用 httpServer_run 和 do_netbios，两者使用不同 socket 互不干扰
• 使用方法：PC 浏览器输入 http://W55MH32/ 即可访问设备网页，无需关心 IP 地址