網路¶

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。套件中其他 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，但它依賴的元件不在套件中。
• 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。