Arduino Ethernet - Ethernet.begin()用法及代码示例

说明

初始化以太网库和网络设置。

在 1.0 版中，该库支持 DHCP。使用 Ethernet.begin(mac) 和正确的网络设置，Ethernet shield 将自动获得一个 IP 地址。这会显著增加草图大小。为确保在需要时正确更新 DHCP 租约，请务必定期调用 Ethernet.maintain()。

用法

Ethernet.begin(mac);
Ethernet.begin(mac, ip);
Ethernet.begin(mac, ip, dns);
Ethernet.begin(mac, ip, dns, gateway);
Ethernet.begin(mac, ip, dns, gateway, subnet);

参数

• mac：设备的 MAC(媒体访问控制)地址(6 字节数组)。这是您的防护罩的以太网硬件地址。较新的 Arduino 以太网扩展板包含带有设备 MAC 地址的标签。对于较旧的盾牌，请选择您自己的。
• ip：设备的IP地址(4字节数组)
• dns：DNS 服务器的 IP 地址(4 字节数组)。可选：默认为最后一个八位组设置为 1 的设备 IP 地址
• gateway：网络网关的 IP 地址(4 字节数组)。可选：默认为最后一个八位组设置为 1 的设备 IP 地址
• subnet：网络的子网掩码(4 个字节的数组)。可选：默认为 255.255.255.0

返回

• 此函数的 DHCP 版本 Ethernet.begin(mac) 返回一个 int：1 表示成功的 DHCP 连接，0 表示失败。
• 其他版本不返回任何内容。

示例

#include <SPI.h>
#include <Ethernet.h>

// the media access control (ethernet hardware) address for the shield:
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };  
//the IP address for the shield:
byte ip[] = { 10, 0, 0, 177 };    

void setup()
{
  Ethernet.begin(mac, ip);
}

void loop () {}