Arduino:Библиотеки/Ethernet/Класс Ethernet/begin(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
 
Нет описания правки
 
(не показаны 3 промежуточные версии 1 участника)
Строка 6: Строка 6:
=Функция begin()<ref>[https://www.arduino.cc/en/Reference/EthernetBegin Arduino - Ethernet.begin()]</ref>=
=Функция begin()<ref>[https://www.arduino.cc/en/Reference/EthernetBegin Arduino - Ethernet.begin()]</ref>=


Инициализирует библиотеку Ethernet и заданные сетевые настройки.
Инициализирует [[Arduino:Библиотеки/Ethernet|библиотеку Ethernet]] и заданные сетевые настройки.


Начиная с '''версии 1.0''', библиотека поддерживает '''DHCP'''. Таким образом, чтобы модуль '''Arduino Ethernet Shield''' автоматически получил '''IP'''-адрес, достаточно функции '''Ethernet.begin(mac)''' и правильных сетевых настроек. Это существенно увеличивает размер скетча. Чтобы вовремя продлять аренду '''DHCP''' (т.е. использование выделенного '''IP'''-адреса), регулярно вызывайте функцию [[Arduino:Библиотеки/Ethernet/Класс Ethernet/maintain()|Ethernet.maintain()]].
Начиная с версии 1.0, библиотека поддерживает [[DHCP]]. Таким образом, чтобы [[Arduino:Продукты/Продукты Arduino/Arduino Ethernet Shield V1|модуль Arduino Ethernet Shield]] автоматически получил [[IP-адрес]], достаточно функции '''Ethernet.begin(mac)''' и правильных сетевых настроек. Это существенно увеличивает размер [[скетч]]а. Чтобы вовремя продлять аренду [[DHCP]] (т.е. использование выделенного [[IP-адрес]]а), регулярно вызывайте функцию [[Arduino:Библиотеки/Ethernet/Класс Ethernet/maintain()|Ethernet.maintain()]].


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
Ethernet.begin(mac);
Ethernet.begin(mac);
Ethernet.begin(mac, ip);
Ethernet.begin(mac, ip);
Строка 22: Строка 22:
==Параметры==
==Параметры==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
mac – MAC-адрес (от «media access control», что значит «управление доступом к среде») Ethernet-модуля, также известный как EHA (от «ethernet hardware address», что значит «аппаратный Ethernet-адрес»). Представляет собой массив из 6 байтов. У более новых версий Ethernet-модуля MAC-адрес написан на стикере. Для старых версий можно использовать собственный MAC-адрес.
mac – MAC-адрес (от «media access control», что значит «управление доступом к среде») Ethernet-модуля, также известный как EHA (от «ethernet hardware address», что значит «аппаратный Ethernet-адрес»). Представляет собой массив из 6 байтов. У более новых версий Ethernet-модуля MAC-адрес написан на стикере. Для старых версий можно использовать собственный MAC-адрес.
ip – IP-адрес устройства. Представляет собой массив из 4 байтов.
ip – IP-адрес устройства. Представляет собой массив из 4 байтов.
Строка 32: Строка 32:
==Что возвращает==
==Что возвращает==


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
Если DHCP-соединение установлено успешно, то DHCP-версия этой функции, т.е. Ethernet.begin(mac), вернет «1», а если нет, то «0». Другие версии не возвращают ничего.
Если DHCP-соединение установлено успешно, то DHCP-версия этой функции, т.е. Ethernet.begin(mac), вернет «1», а если нет, то «0». Другие версии не возвращают ничего.
</syntaxhighlight>
</syntaxhighlight>
Строка 38: Строка 38:
==Пример==
==Пример==


<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">
#include <SPI.h>
#include <SPI.h>
#include <Ethernet.h>
#include <Ethernet.h>
Строка 61: Строка 61:
<references />
<references />


{{Навигационная таблица/Arduino библиотеки}}
 
{{Навигационная таблица/Портал/Arduino}}
 
 
 
 


[[Категория:Стандартные библиотеки]]
[[Категория:Стандартные библиотеки]]

Текущая версия от 11:12, 8 июля 2023

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.

Функция begin()[1]

Инициализирует библиотеку Ethernet и заданные сетевые настройки.

Начиная с версии 1.0, библиотека поддерживает DHCP. Таким образом, чтобы модуль Arduino Ethernet Shield автоматически получил IP-адрес, достаточно функции Ethernet.begin(mac) и правильных сетевых настроек. Это существенно увеличивает размер скетча. Чтобы вовремя продлять аренду DHCP (т.е. использование выделенного IP-адреса), регулярно вызывайте функцию 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-адрес (от «media access control», что значит «управление доступом к среде») Ethernet-модуля, также известный как EHA (от «ethernet hardware address», что значит «аппаратный Ethernet-адрес»). Представляет собой массив из 6 байтов. У более новых версий Ethernet-модуля MAC-адрес написан на стикере. Для старых версий можно использовать собственный MAC-адрес.
ip  IP-адрес устройства. Представляет собой массив из 4 байтов.
dns  IP-адрес DNS-сервера. Представляет собой массив из 4 байтов. Опционально: по умолчанию за dns принимается IP-адрес, у которого в последнем октете указана цифра «1».
gateway  IP-адрес сетевого шлюза. Представляет собой массив из 4 байтов. Опционально: по умолчанию за gateway принимается IP-адрес, у которого в последнем октете указана цифра «1».
subnet  маска подсети. Представляет собой массив из 4 байтов. Опционально: по умолчанию  «255.255.255.0».

Что возвращает

Если DHCP-соединение установлено успешно, то DHCP-версия этой функции, т.е. Ethernet.begin(mac), вернет «1», а если нет, то «0». Другие версии не возвращают ничего.

Пример

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

// MAC-адрес для Arduino Ethernet Shield:
byte mac[] = { 0xDE, 0xAD, 0xBE, 0xEF, 0xFE, 0xED };  
// IP-адрес для Arduino Ethernet Shield:
byte ip[] = { 10, 0, 0, 177 };    

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

void loop () {}

См.также

Внешние ссылки