Ethernet.begin()

Описание

Инициализирует библиотеку 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-адрес можно выбрать самостоятельно.

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 () {}