以太網（Ethernet）外設驅動涉及硬件與軟件的深度交互，其核心在于通過特定接口連接主處理器與以太網控制器，實現數據的發送、接收以及數據鏈路層處理等功能，部分控制器還集成了TCP/IP協議棧以簡化網絡應用開發，從而支持多通道通信和高效的網絡數據傳輸。

最新開發資料詳見：
www.air8101.cn

一、主要硬件準備

1.1 主要硬件

Air8101開發板套件；

支持數據傳輸的USB數據線；

Win10及其以上PC電腦。

1.2 接線示意

配套以太網小板，可以直插到Air8101開發板上，對應端口如下圖示：

需要注意的是：

因前期B10版本的開發板設計原因，測試以太網功能時，需要把SNeT的3.3V單獨接到板子右側SWD的3.3V。

實物連線如下圖示：

二、最新源碼及實操教程

Air8101應用示例持續更新中，當前以太網示例demo及實操教程，將教你使用LuatOS開發，實現Air8101通過以太網小板LAN8720連接網絡。

最新源碼及實操教程詳見：

https://docs.openluat.com/air8101/luatos/app/driver/eth/

1）示例代碼：

2）運行示意：

三、核心腳本代碼詳解

netdrv接口提供了一系列函數，用于實現相關網絡配置與管理功能。

3.1 初始化指定netdrv設備

netdrv.setup(id, tp, opts)

1）參數：

id：int型（網絡適配器編號，例如socket.LWIP_ETH）；

tp：int型（實現方式，如果是設備自帶的硬件，那就不需要傳，外掛設備需要傳，當前支持CH390H/D）；

opts：int型（外掛方式，需要額外的參數，參考示例）。

2）返回值：

返回值類型：boolean；

說明：初始化成功與否。

3）例子：

3.2 開啟或關閉DHCP

netdrv.dhcp(id, enable)

1）參數：

id：int型（網絡適配器編號，例如socket.LWIP_ETH）；

enable：boolean型（開啟或者關閉）。

2）返回值：

返回值類型：boolean；

說明：成功與否。

3）例子：

3.3 設置或獲取設備MAC

netdrv.mac(id, new_mac, raw_string)。

1）參數：

id：int型（網絡適配器編號，例如socket.LWIP_ETH）；

new_mac：string型（新的MAC地址，可選，必須是6個字節）；

raw_string：boolean型（是否返回6字節原始數據，默認是否，返回HEX字符串）。

2）返回值：

返回值類型：boolean；

說明：成功與否。

3）例子：

3.4 設置或讀取ipv4地址

netdrv.ipv4(id, addr, mark, gw)

1）參數：

id：int型（網絡適配器編號，例如socket.LWIP_ETH）；

addr：string型（ipv4地址，如果是讀取就不需要傳）；

mark：string型（掩碼）；

gw：string型（網關）。

2）返回值：

addr：string型（ipv4地址）；

mark：string型（掩碼）；

gw：string型（網關）。

3）例子：

3.5 開啟或關閉NAPT

netdrv.napt(id)

1）參數：

id：int型（網關適配器的id）。

2）返回值：

返回值類型：bool；

說明：合法值就返回true，否則返回nil。

3）例子：

3.6 獲取netdrv的物理連接狀態

netdrv.link(id)

1）參數：

id：int型（netdrv的id，例如socket.LWIP_ETH）。

2）返回值：

返回值類型：bool；

說明：已連接返回true，否則返回false；如果id對應的netdrv不存在，返回nil。

3）例子：

3.7 獲取netdrv的網絡狀態

netdrv.ready(id)

1）參數：

id：int型（netdrv的id，例如socket.LWIP_ETH）；

2）返回值：

返回值類型：bool；

說明：已連接返回true，否則返回false；如果id對應的netdrv不存在，返回nil。

3）例子：

今天的內容就分享到這里了~

審核編輯 黃宇