Описание

Метод инициализирует библиотеку Ethernet и устанавливает сетевые параметры.

Начиная с версии 1.0, в библиотеке реализована поддержка DHCP. Для автоматического получения IP-адреса платой расширения Ethernet, достаточно просто вызвать метод Ethernet.begin(mac), что позволяет значительно сократить объем скетча.

Синтаксис

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-адрес (Media Access Control) устройства (массив из 6 байт). Это адрес вашей Ethernet-платы расширения (задан аппаратно). В последних платах расширения Arduino Ethernet MAC-адрес устройства указан на наклейке. На более старых версиях плат MAC-адрес можно выбрать самостоятельно (условием правильной работы устройств на MAC-адресе является их уникальность в пределах одного коммутатора) .

ip - IP-адрес устройства (массив из 4 байт)

dns - IP-адрес DNS-сервера (массив из 4 байт). Необязательный параметр: по умолчанию за адрес DNS-сервера принимается IP-адрес устройства, в котором последний октет заменен на 1.

gateway - IP-адрес сетевого шлюза (массив из 4 байт). Необязательный параметр: по умолчанию за адрес шлюза принимается IP-адрес устройства, в котором последний октет заменен на 1.

subnet - маска подсети (массив из 4 байт). Необязательный параметр: значение по умолчанию - 255.255.255.0

Возвращаемые значения

DHCP-версия функции Ethernet.begin(mac) возвращает целое значение: 1 при успешном DHCP-соединении, 0 - при неудачном. Остальные версии этой функции никаких значений не возвращают.

Пример

#include <SPI.h>
#include <Ethernet.h>
 
// сетевой MAC-адрес платы расширения (заданный аппаратно):
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED }; 
//IP-адрес платы расширения:
byte ip[] = { 10, 0, 0, 177 }; 
 
void setup()
{
 Ethernet.begin(mac, ip);
}
 
void loop () {}

Библиотека Ethernet

Справочник

Материалы взяты с официального сайта проекта Arduino и представлены по лицензии Creative Commons Attribution-ShareAlike 3.0 License.