使用 SLAAC 自动配置 IPv6 地址

本篇总结

在 W6300-EVB-M4 平台上通过 QSPI 接口驱动 W6300，运行 IPv6 地址自动配置（SLAAC 无状态自动配置 + Stateful DHCPv6 有状态配置），自动获取链路本地地址、全局地址、IPv6 网关与 IPv6 DNS，并完成重复地址检测（DAD）验证。

硬件平台：本例程基于 W6300-EVB-M4 开发板运行，主控 MCU 为 MH2457，通过 QSPI（HSPI）接口与 W6300 通信。

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

RA capture mode : W6300 MACRAW        （W6300 以 MACRAW 方式捕获 RA 报文）
type : 86                              （ICMPv6 类型 134 = Router Advertisement）
code : 0
RA_flag : c0
Router_lifetime : 1800 s
Option Type : 1, length : 8            （Source Link-layer Address）
Option Type : 5, length : 8            （MTU）
Option Type : 3, length : 32           （Prefix Information /64 PIO）
Prefix Length : 64
Prefix Information Flag : c0           （L + A：可用作链路上、可自动配置）
valid lifetime : 174438
preferred lifetime : 88038
Accepted first autonomous /64 PIO
Option Type : 25, length : 24          （Recursive DNS Server）
DNS lifetime : 1800
Option Type : 7, length : 8
MO normalized result : 3               （M + O 标志 → 请求 Stateful DHCPv6）
RA requests Stateful DHCPv6

W6300 的优势

W6300 SDK 内置了完整的 IPv6 地址自动配置库（AddressAutoConfig.c/h）与 DHCPv6 客户端库（dhcpv6.c/h）。RA 捕获解析、DAD 检测、PIO 生成全局地址、Stateful DHCPv6 状态机全部由库函数处理。你只需要：注册 1 秒 DHCPv6 定时器 → 设置 NETINFO_SLAAC_V6 模式 → 调用 ipv6_aac_configure()。W6300 硬件 TOE 引擎在 MACRAW 模式即可参与 RA 报文的收发处理。

/* AddressAutoConfig may enter DHCPv6 paths depending on RA M/O flags. */
wiz_add_timer(DHCP6_time_handler, 1000U);
result = AddressAutoConfig_Init(IPV6_AAC_SOCKET, &net_info);
wiz_delete_timer(DHCP6_time_handler);

uint32_t timer_get_ms(void)
{
    return wiz_get_tick_ms();
}

#define IPV6_AAC_SOCKET 0U

int ipv6_aac_configure(const uint8_t mac[6])
{
    wiz_NetInfo net_info;
    uint8_t result;

    if (mac == NULL)
    {
        return -1;
    }

    if (ipv6_prepare_network(&net_info, mac, NETINFO_SLAAC_V6, NETINFO_STATIC) < 0)
    {
        return -1;
    }

    /* AddressAutoConfig may enter DHCPv6 paths depending on RA M/O flags. */
    wiz_add_timer(DHCP6_time_handler, 1000U);
    result = AddressAutoConfig_Init(IPV6_AAC_SOCKET, &net_info);
    wiz_delete_timer(DHCP6_time_handler);

    if (result != 1U)
    {
        return -1;
    }

    wizchip_getnetinfo(&net_info);
    if (ipv6_address_is_zero(net_info.lla) || ipv6_address_is_zero(net_info.gua))
    {
        return -1;
    }

    ipv6_print_address("Link-local address: ", net_info.lla);
    ipv6_print_address("Global address: ", net_info.gua);

    if (!ipv6_address_is_zero(net_info.gw6))
    {
        ipv6_print_address("IPv6 gateway: ", net_info.gw6);
    }
    if (!ipv6_address_is_zero(net_info.dns6))
    {
        ipv6_print_address("IPv6 DNS: ", net_info.dns6);
    }

    return 0;
}

void user_run(void)
{
    printf("%s IPv6 address auto configuration example\r\n", _WIZCHIP_ID_);
    wizchip_initialize();
    (void)ipv6_aac_configure(app_mac);
    while (1)
    {
    }
}

请注意

进行 IPv6 地址自动配置时，需要将网络准备时的 ipmode 设为 NETINFO_SLAAC_V6；DHCPv6 是否启动由 RA 的 M/O 标志决定，无需手动强制开启。

int ipv6_prepare_network(wiz_NetInfo *net_info,
                         const uint8_t mac[6],
                         ipconf_mode ipmode,
                         dhcp_mode dhcp_mode)
{
    uint8_t tx_size[8] = {2U, 2U, 2U, 2U, 2U, 2U, 2U, 2U};
    uint8_t rx_size[8] = {2U, 2U, 2U, 2U, 2U, 2U, 2U, 2U};

    if ((net_info == NULL) || (mac == NULL))
    {
        return -1;
    }

    wizchip_getnetinfo(net_info);
    (void)wizchip_init(tx_size, rx_size);

    memcpy(net_info->mac, mac, sizeof(net_info->mac));
    net_info->ipmode = ipmode;
    net_info->dhcp = dhcp_mode;

    wizchip_setnetinfo(net_info);
    return 0;
}

int ipv6_address_is_zero(const uint8_t address[16])
{
    uint8_t index;

    if (address == NULL)
    {
        return 1;
    }
    for (index = 0U; index < 16U; ++index)
    {
        if (address[index] != 0U)
        {
            return 0;
        }
    }
    return 1;
}

void ipv6_print_address(const char *label, const uint8_t address[16])
{
    uint8_t index;

    if ((label == NULL) || (address == NULL))
    {
        return;
    }

    printf("%s", label);
    for (index = 0U; index < 16U; index += 2U)
    {
        printf("%02X%02X", address[index], address[index + 1U]);
        if (index < 14U)
        {
            printf(":");
        }
    }
    printf("\r\n");
}

static const uint8_t app_mac[6] = {0x00, 0x08, 0xDC, 0x12, 0x34, 0x56};

请注意

测试实例需要 PC 端和 W6300 处于同一 IPv6 网络（同一前缀 240e:033d:945a:a301::/64）。