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

本示例演示如何在 W6300 上将 HTTP Server 与 NetBIOS 功能相结合，通过 NetBIOS 名称解析动态 IP，再用该 IP 发起 HTTP 请求，解决 IP 地址变动带来的访问难题。在 HTTP Server 章节中，我们实现了通过 IP 地址访问 W6300 的 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 口

工程核心文件如下：

NetBIOS_HTTP/
├── main.c                    ← 系统入口：串口、GPIO、QSPI 初始化 + user_run()
├── Internet/                 ← 协议库（与 USER 同级）
│   ├── httpServer.c/h        ← HTTP 服务器核心 (TCP 80)
│   ├── httpParser.c/h        ← HTTP 请求解析
│   ├── netbios.c/h           ← NetBIOS 名称服务 (UDP 137)
│   └── httpUtil.c/h          ← HTTP CGI 处理工具
└── USER/
    ├── user_main.c           ← 网络地址定义 + HTTP+NetBIOS 主循环
    ├── wiz_platform.c/h      ← 平台适配：debug_usart_init、wizchip_gpio_init、hspi_init
    └── wiz_interface.c/h     ← W6300 驱动接口：wizchip_initialize、network_init、PHY 检测、软件定时器

文件：USER/user_main.c — 首先初始化网络，然后将网页内容注册到 HTTP 服务器，最后初始化 HTTP 服务器。

wizchip_initialize();
network_init(ethernet_buf, &default_net_info);

reg_httpServer_webContent((uint8_t *)"index.html", (uint8_t *)index_page);
httpServer_init(http_tx_ethernet_buf,
                http_rx_ethernet_buf,
                _WIZCHIP_SOCK_NUM_ - 1,
                socknumlist);

/* W6300 HTTP backend uses this 1 s tick for its TX-buffer timeout path. */
wiz_add_timer(httpServer_time_handler, 1000);

printf("Please enter /WIZNET in your browser to access the HTTP server\r\n");

reg_httpServer_webContent() 将网页内容注册到 HTTP 服务器，httpServer_init() 初始化 HTTP 服务器所需的 socket 和缓冲区。wiz_add_timer(httpServer_time_handler, 1000) 注册 1 秒软件定时器，用于 HTTP 服务器 TX 缓冲超时判断。

文件：USER/user_main.c — 在主循环中遍历 HTTP 服务器 socket 调用 httpServer_run()，并调用 do_netbios()，同时处理 HTTP 请求和 NetBIOS 名称查询。

while (1)
{
    for (i = 0; i < _WIZCHIP_SOCK_NUM_ - 1; i++)
    {
        httpServer_run((uint8_t)i);
    }

    do_netbios(SOCK_NETBIOS);
}

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

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

MH2457 W6300 QSPI example start
W6300 HTTP Server and NetBIOS example
PHY link
The current Mbtis speed : 100Mbps
The current Duplex Mode : Full-Duplex
DHCP running
DHCP success!
====================================================================================================
 W6300 network configuration : DHCP

 MAC         : 00:08:DC:12:34:56
 IP          : 192.168.2.24
 Subnet Mask : 255.255.255.0
 Gateway     : 192.168.2.1
 DNS         : 192.168.2.1
====================================================================================================

Please enter /WIZNET in your browser to access the HTTP server
rem_ip_addr=192.168.2.20:137
netbios name query question
name is WIZNET
send response

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

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