网络¶

FreeRTOS 应用以 lwIP 2.1.2 作为 TCP/IP 协议栈，由 mbedTLS 2.28.2 提供 TLS。IPRO7 联网有两种方式：以 IPRO6S 作为无线端、经 SDIO 连接的 Wi-Fi，或 IPRO7 的 Ethernet MAC（EMAC，RMII）外接 PHY。在 IPRO7AI Reef EVK 上，IPRO6S 就是插在 microSD 卡槽中的 FIN 卡。两种连接共用同一个 lwIP，socket 代码无需因接口不同而改写。

网络架构¶

网络配置¶

构建时 .config 会原样转换为 autoconf.h，Kconfig 的 select／depends on 不会被应用，连接所需的配置都要写出来。

CONFIG_IPRO7AI_REEF=y
CONFIG_USE_PSRAM=y
CONFIG_IPRO7_WIFI_HOST_HOTCODE=y
CONFIG_WIFI_USE_IPRO6S=y
CONFIG_COMPONENTS_LWIP_ENABLE=y
CONFIG_COMPONENTS_LWIP_APP_ENABLE=y
CONFIG_ETHERNET=y
CONFIG_COMPONENTS_IPRONET_HOST_ENABLE=y
CONFIG_RTSP_SERVER=y
CONFIG_RTSP_LISTEN_PORT=8554
CONFIG_RTSP_DEFAULT_VIDEO_FPS=15
CONFIG_RTSP_SHELL=y

CONFIG_COMPONENTS_LWIP_ENABLE=y
CONFIG_COMPONENTS_LWIP_APP_ENABLE=y
CONFIG_ETHERNET=y
CONFIG_COMPONENTS_MBEDTLS_ENABLE=y
CONFIG_MBEDTLS_BIGNUM_USE_HW=y

应用可在自己的目录中放置 lwipopts_app.h 覆盖 lwIP 配置，lwipopts.h 找到它就会加载。使用 ipronet_host 时，请复制 apps/platform/ipro7ai_reef_demo/lwipopts_app.h（与 ipro7_sdio_wifi 中的是同一份）：它把 lwIP 缓冲区放到 PSRAM 中并加大 TCP 窗口。组件 README 指出，缺少它时 TCP 上行速率会降到约四分之一。

lwIP 集成¶

lwIP 提供 BSD 风格的 socket API（lwip/sockets.h、lwip/netdb.h）。DHCP 客户端、DNS、SNTP、IPv6、lwiperf 与 lwIP 的 HTTP 客户端都已编入；DHCP 服务器、mDNS、MQTT 与 altcp TLS 按上表的配置加入。

下面的 TCP 客户端与 apps/platform/common/ipronet_ota_cli/ota_http_fetch.c 的步骤相同（ipro7ai_reef_demo 为 ipro6s_ota 编入了这个文件）：解析主机名、创建 socket、建立连接。网络接口获取到地址后才使用 socket（使用 ipronet_host 时，就是在 on_got_ip 回调之后）。

#include <string.h>
#include "lwip/sockets.h"
#include "lwip/netdb.h"

int tcp_send(const char *host, uint16_t port, const void *data, size_t len)
{
    struct hostent *hp = gethostbyname(host);
    if (hp == NULL) {
        return -1;
    }

    struct sockaddr_in sa;
    memset(&sa, 0, sizeof(sa));
    sa.sin_family = AF_INET;
    sa.sin_port = htons(port);
    memcpy(&sa.sin_addr, hp->h_addr, hp->h_length);

    int s = socket(AF_INET, SOCK_STREAM, 0);
    if (s < 0) {
        return -1;
    }
    if (connect(s, (struct sockaddr *)&sa, sizeof(sa)) < 0 ||
        send(s, data, len, 0) < 0) {
        close(s);
        return -1;
    }
    close(s);
    return 0;
}

以太网¶

IPRO7 的 EMAC 通过 RMII（10/100 Mbps）外接 PHY，HAL 附带 RTL8201F PHY 驱动。Reef 板上没有 PHY，这条路径用于自行设计的电路板。lwIP 对接位于 bsp/hal/src/hal_ethernetif.c：连接建立后由它的 DHCP 任务获取地址，DHCP 超时则改用该文件中定义的静态地址。EMAC 引脚见 bsp/hal/src/hal_emac.c 与引脚与外设对照。

添加 netif、启动 lwIP 的方式与 apps/platform/ipro7_demo/demo/soc/peripheral/emac_demo.c 相同：

static struct netif emac_netif;

static void regist_netif(void *arg)
{
    struct netif *netif = (struct netif *)arg;
    ip4_addr_t ipaddr, netmask, gw;

    ip_addr_set_zero(&ipaddr);
    ip_addr_set_zero(&netmask);
    ip_addr_set_zero(&gw);
    netif_add(netif, &ipaddr, &netmask, &gw, NULL, ethernetif_init, tcpip_input);
    netif_set_default(netif);
    ethernet_link_status_updated(netif);
#if LWIP_NETIF_LINK_CALLBACK
    netif_set_link_callback(netif, ethernet_link_status_updated);
#endif
}

int cmd_emac_lwip(int argc, char **argv)
{
    tcpip_init(regist_netif, (void *)&emac_netif);
    return 0;
}

ipro7_demo 面向 IPRO7 EVB，且只有在 CONFIG_DEMO_EMAC=y 时才编入 emac_demo.c；随附的 .config 中没有这一行。

TLS／DTLS（mbedTLS）¶

用 CONFIG_COMPONENTS_MBEDTLS_ENABLE=y 加入 mbedTLS 2.28.2。默认配置以 mbedTLS 自带的 config.h 为基础，包含 TLS 1.2 客户端与 X.509。应用如果提供自己的 mbedtls_app_config.h，会替换整份默认配置（mbedTLS 组件必须能在 include 路径中找到它）。熵源是硬件随机数发生器（port/entropy_poll_alt.c）。

在 IPRO7 上，CONFIG_MBEDTLS_ECC_USE_HW 会回退到软件实现，构建时会打印警告。

TLS 客户端可以从 components/crypto/mbedtls/mbedtls/programs/ssl/ssl_client1.c 开始。移植时：

• 检查每个初始化与连接调用的返回值。
• 用 mbedtls_ssl_conf_ca_chain() 加载服务所信任的 CA 证书，使用 MBEDTLS_SSL_VERIFY_REQUIRED，并用 mbedtls_ssl_set_hostname() 设置主机名。校验证书有效期需要正确的系统时间。
• 处理 MBEDTLS_ERR_SSL_WANT_READ／MBEDTLS_ERR_SSL_WANT_WRITE、部分传输与超时，并在每条错误路径上释放 TLS context 与 socket。
• 把示例中的测试证书与主机换成产品自己的。

HTTP、MQTT 与 RTSP¶

HTTPS 与 MQTT over TLS 需要自行用 mbedTLS（或 altcp TLS）建立安全连接，并处理状态码、分块传输、长度限制与超时。

通过 IPRO6S 连接 Wi-Fi¶

flowchart LR
  A["IPRO7<br/>应用＋ipronet_host＋lwIP"] -->|"SDIO 4-bit<br/>GPIO28–33"| B["IPRO6S<br/>ipro6_if_wifi"]
  B -->|Wi-Fi| C["无线接入点"]

IPRO7 是 SDIO host。IPRO6S 运行 ipro6_if_wifi，在以太网数据包与 Wi-Fi 之间桥接；DHCP 在 IPRO6S 上运行，IP 协议栈与应用的 socket 在 IPRO7 上。SDIO 总线固定在 GPIO28–33，由组件配置引脚。在 Reef 上这就是 microSD 卡槽的信号线，FIN 卡插在原本放 SD 卡的位置。

ipronet_host.h 摘要：

• 回调（on_connected、on_disconnected、on_got_ip、on_scan_result）在组件的 RX 任务中执行：不可阻塞，也不可调用 ipronet_connect／disconnect／scan／stop。需要执行操作时交给自己的任务。
• auto_reconnect = 1（默认）时，断开后由组件重新连接 AP；设为 0 时由应用在 on_disconnected 中再调用 ipronet_connect()。
• 所有返回码列在 ipronet_host.h（IPRONET_OK 为 0）与 components/network/ipronet_host/README.md 中。

在 Reef 上动手实践¶

用出厂固件的 shell 命令让 Reef 连接 Wi-Fi，并通过 RTSP 推送摄像头视频流。配合电脑端播放器的完整步骤见 Wi-Fi 与 RTSP 教程。

需要：运行 ipro6_if_wifi（defconfig_ipro6_sdio）的 IPRO6S FIN 卡、接在摄像头连接器上的 OV5640 或 OV2640 摄像头模组，以及一台 Wi-Fi 无线接入点。

下一步：以这份配置为起点，按照创建第一个自己的应用动手实践，再按照测试你的应用验证。

其他 Wi-Fi 模组¶

Reef 只通过 IPRO6S FIN 卡连接 Wi-Fi。SDK 包中其他 SDIO Wi-Fi 模组的驱动与探测程序面向 IPRO7 EVB，不是 Reef 支持的路径，见示例。

IPRO6S 作为 Wi-Fi 设备端¶

连接的 IPRO6S 端是同一套 SDK 中的 IPRO6S FreeRTOS 应用，输出文件名以 _IPRO6.bin 结尾。它的预编译 Wi-Fi 库只针对随附的配置文件提供，请保留其中一份的 Wi-Fi 配置与 CONFIG_WIRELESS_LIB_VARIANT。

芯片、开发板与烧录见 IPRO6S。

本版本的限制¶

• 只有 FreeRTOS 应用能联网。Zephyr 下没有以太网驱动，也没有 ipronet_host；zephyr/drivers/wifi 是 IPRO6S 芯片本身的驱动，而本版本的 Zephyr 不支持 IPRO6S。见 Zephyr RTOS。
• ipronet_host 只支持 station 模式与单个 netif，也不会检测传输中断：卡断电后用 ipronet_stop()、ipronet_start() 重新建立。
• 没有高层 HTTP 客户端组件，也没有 4G／LTE 移动网络模组的组件。
• ipro7_sdio_wifi 的 README 提到 iperf，但它依赖的组件不在 SDK 包中。
• ipro_agora_sentino 的 MQTT 使用明文 TCP 连接；量产产品请改用 MQTT over TLS 并校验证书。

参考应用¶

其他开发板：ipro7_sdio_wifi 是独立的 ipronet_host 参考应用，每个启动阶段都有对应的 shell 命令；ipro7_demo 含 EMAC 演示。两者都面向 IPRO7 EVB。

• Wi-Fi 与 RTSP 教程：配合电脑端播放器的 Reef 完整步骤。
• IPRO7AI Reef EVK：microSD 卡槽、JP3 与 FIN 卡。
• OTA 更新：用 ipro6s_ota 更新 FIN 卡。
• Thread 与 Matter：Zephyr 下的 IEEE 802.15.4 与 OpenThread。