以太網(wǎng)（Ethernet）外設(shè)驅(qū)動(dòng)涉及硬件與軟件的深度交互，其核心在于通過特定接口連接主處理器與以太網(wǎng)控制器，實(shí)現(xiàn)數(shù)據(jù)的發(fā)送、接收以及數(shù)據(jù)鏈路層處理等功能，部分控制器還集成了TCP/IP協(xié)議棧以簡(jiǎn)化網(wǎng)絡(luò)應(yīng)用開發(fā)，從而支持多通道通信和高效的網(wǎng)絡(luò)數(shù)據(jù)傳輸。

最新開發(fā)資料詳見：
www.air8101.cn

一、主要硬件準(zhǔn)備

1.1 主要硬件

Air8101開發(fā)板套件；

支持?jǐn)?shù)據(jù)傳輸?shù)?a target="_blank">USB數(shù)據(jù)線；

Win10及其以上PC電腦。

1.2 接線示意

配套以太網(wǎng)小板，可以直插到Air8101開發(fā)板上，對(duì)應(yīng)端口如下圖示：

需要注意的是：

因前期B10版本的開發(fā)板設(shè)計(jì)原因，測(cè)試以太網(wǎng)功能時(shí)，需要把SNeT的3.3V單獨(dú)接到板子右側(cè)SWD的3.3V。

實(shí)物連線如下圖示：

二、最新源碼及實(shí)操教程

Air8101應(yīng)用示例持續(xù)更新中，當(dāng)前以太網(wǎng)示例demo及實(shí)操教程，將教你使用LuatOS開發(fā)，實(shí)現(xiàn)Air8101通過以太網(wǎng)小板LAN8720連接網(wǎng)絡(luò)。

最新源碼及實(shí)操教程詳見：

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

1）示例代碼：

2）運(yùn)行示意：

三、核心腳本代碼詳解

netdrv接口提供了一系列函數(shù)，用于實(shí)現(xiàn)相關(guān)網(wǎng)絡(luò)配置與管理功能。

3.1 初始化指定netdrv設(shè)備

netdrv.setup(id, tp, opts)

1）參數(shù)：

id：int型（網(wǎng)絡(luò)適配器編號(hào)，例如socket.LWIP_ETH）；

tp：int型（實(shí)現(xiàn)方式，如果是設(shè)備自帶的硬件，那就不需要傳，外掛設(shè)備需要傳，當(dāng)前支持CH390H/D）；

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

2）返回值：

返回值類型：boolean；

說明：初始化成功與否。

3）例子：

3.2 開啟或關(guān)閉DHCP

netdrv.dhcp(id, enable)

1）參數(shù)：

id：int型（網(wǎng)絡(luò)適配器編號(hào)，例如socket.LWIP_ETH）；

enable：boolean型（開啟或者關(guān)閉）。

2）返回值：

返回值類型：boolean；

說明：成功與否。

3）例子：

3.3 設(shè)置或獲取設(shè)備MAC

netdrv.mac(id, new_mac, raw_string)。

1）參數(shù)：

id：int型（網(wǎng)絡(luò)適配器編號(hào)，例如socket.LWIP_ETH）；

new_mac：string型（新的MAC地址，可選，必須是6個(gè)字節(jié)）；

raw_string：boolean型（是否返回6字節(jié)原始數(shù)據(jù)，默認(rèn)是否，返回HEX字符串）。

2）返回值：

返回值類型：boolean；

說明：成功與否。

3）例子：

3.4 設(shè)置或讀取ipv4地址

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

1）參數(shù)：

id：int型（網(wǎng)絡(luò)適配器編號(hào)，例如socket.LWIP_ETH）；

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

mark：string型（掩碼）；

gw：string型（網(wǎng)關(guān)）。

2）返回值：

addr：string型（ipv4地址）；

mark：string型（掩碼）；

gw：string型（網(wǎng)關(guān)）。

3）例子：

3.5 開啟或關(guān)閉NAPT

netdrv.napt(id)

1）參數(shù)：

id：int型（網(wǎng)關(guān)適配器的id）。

2）返回值：

返回值類型：bool；

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

3）例子：

3.6 獲取netdrv的物理連接狀態(tài)

netdrv.link(id)

1）參數(shù)：

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

2）返回值：

返回值類型：bool；

說明：已連接返回true，否則返回false；如果id對(duì)應(yīng)的netdrv不存在，返回nil。

3）例子：

3.7 獲取netdrv的網(wǎng)絡(luò)狀態(tài)

netdrv.ready(id)

1）參數(shù)：

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

2）返回值：

返回值類型：bool；

說明：已連接返回true，否則返回false；如果id對(duì)應(yīng)的netdrv不存在，返回nil。

3）例子：

今天的內(nèi)容就分享到這里了~

審核編輯 黃宇