使用NetBIOS名称ping W6300

本篇总结

本例程在 W6300 上实现 NetBIOS 名称解析功能，使 PC 端可直接通过 NetBIOS 名称 ping 设备。

硬件平台：本例程基于 W6300-EVB-M4 开发板运行。

采购推荐：点击前往 WIZnet 官方淘宝店铺 选购 W6300-EVB-M4 开发板

|报文解析|
NetBIOS Name Service
  Transaction ID: 0xa754        (唯一标识此查询，用于匹配请求与响应)
  Flags: 0x0110, Opcode: Name query, Recursion desired, Broadcast    (表示这是一个广播查询请求)
  Questions: 1                 (字段说明仅查询一个设备名称)
  Answer RRs: 0                (在响应报文中，该字段会显示解析到的记录数)
  Authority RRs: 0             (在响应报文中，用于指示哪些服务器可以授权回答该查询)
  Additional RRs: 0            (在某些NetBIOS响应中可能用于携带更多解析信息)

|报文原文|
a7 54 01 10 00 01 00 00 00 00 00 00

NetBIOS 的优势

在实际应用中，设备通常使用 DHCP 方式配置网络地址，IP 地址会动态变化。NetBIOS 协议将固定的名称映射到动态 IP，用户只需记住设备名称即可访问，无需每次查看 IP 地址。W6300 SDK 内置了完整的 NetBIOS 名称服务库（netbios.c/h），名称解码、报文组包、UDP 状态机全部由库函数处理。

while (1)
{
    do_netbios(SOCKET_ID);
}

void do_netbios(uint8_t socket_id)
{
    static uint8_t initialized = 0U;
    static netbios_config_t config;

    if (initialized == 0U)
    {
        config.socket = socket_id;
        config.port = 137U;
        config.hostname = "WIZNET";
        config.name_suffix = 0x00U;
        config.ttl_seconds = 300U;

        if (netbios_init(&config) != 0)
        {
            return;
        }
        initialized = 1U;
    }

    netbios_run();
}

配置说明

hostname 为设备 NetBIOS 名称（示例为 WIZNET），port 为 NetBIOS 名称服务端口（137），ttl_seconds 为名称记录的有效期。PC 端 ping 的名称必须与此处配置的 hostname 一致（不区分大小写）。

static int process_query(void)
{
    netbios_question_t question;
    int32_t result;
    uint16_t available;
    uint16_t response_length = 0U;
    uint16_t remote_port = 0U;
    uint8_t remote_ip[4] = {0U, 0U, 0U, 0U};
    uint8_t address_length = 4U;
    bool matches;

    available = getSn_RX_RSR(APP_NETBIOS_SOCKET);
    if (available == 0U) return 0;

    if (available > sizeof(s_netbios_rx_buffer))
        available = (uint16_t)sizeof(s_netbios_rx_buffer);

    result = recvfrom(APP_NETBIOS_SOCKET,
                      s_netbios_rx_buffer,
                      available,
                      remote_ip,
                      &remote_port,
                      &address_length);
    if (result == SOCK_BUSY) return 0;
    if (result < 0) return -1;

    if ((address_length != 4U) || (remote_port == 0U)) return 0;

    memset(&question, 0, sizeof(question));
    if (!parse_question(s_netbios_rx_buffer, (uint16_t)result, &question))
        return 0;

    if (question.class_code != NBNS_CLASS_IN) return 0;

    matches = name_matches_configured(question.raw_name);
    if ((question.type == NBNS_TYPE_NB) && matches)
        response_length = build_name_response(s_netbios_rx_buffer, &question);
    else if ((question.type == NBNS_TYPE_NBSTAT) &&
             (matches || question.is_wildcard))
        response_length = build_node_status_response(s_netbios_rx_buffer, &question);
    else
        return 0;

    if (response_length == 0U) return -1;

    memcpy(s_netbios_context.remote_ip, remote_ip, sizeof(remote_ip));
    s_netbios_context.remote_port = remote_port;
    s_netbios_context.tx_length = response_length;
    s_netbios_context.tx_tick = wiz_get_tick_ms();
    s_netbios_context.tx_pending = true;
    return 0;
}

for (index = 0U; index < NBNS_RAW_NAME_SIZE; ++index)
{
    uint8_t high = query[offset++];
    uint8_t low = query[offset++];

    if ((high < (uint8_t)'A') || (high > (uint8_t)'P') ||
        (low < (uint8_t)'A') || (low > (uint8_t)'P'))
    {
        return false;
    }

    question->raw_name[index] =
        (uint8_t)(((high - (uint8_t)'A') << 4U) |
                  (low - (uint8_t)'A'));
}

请注意

测试实例需要 PC 端和 W6300 处于同一网段。在 PC 端打开 CMD，使用 ping WIZNET 即可通过名称访问设备，无需关心设备的 IP 地址。