Arduino:Библиотеки/Ethernet/Класс Ethernet/begin(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
Строка 8: | Строка 8: | ||
Инициализирует библиотеку Ethernet и заданные сетевые настройки. | Инициализирует библиотеку Ethernet и заданные сетевые настройки. | ||
Начиная с | Начиная с версии 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 | <syntaxhighlight lang="c"> | ||
Ethernet.begin(mac); | Ethernet.begin(mac); | ||
Ethernet.begin(mac, ip); | Ethernet.begin(mac, ip); | ||
Строка 22: | Строка 22: | ||
==Параметры== | ==Параметры== | ||
<syntaxhighlight lang="c | <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 | <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 | <syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS"> | ||
#include <SPI.h> | #include <SPI.h> | ||
#include <Ethernet.h> | #include <Ethernet.h> |
Версия от 21:38, 17 февраля 2023
Содержание | Знакомство с Arduino | Продукты | Основы | Справочник языка Arduino | Примеры | Библиотеки | Хакинг | Изменения | Сравнение языков Arduino и Processing |
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Функция 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 () {}
См.также
Внешние ссылки
Категории:
- Страницы, использующие повторяющиеся аргументы в вызовах шаблонов
- Справочник языка Arduino
- Arduino
- Перевод от Сubewriter
- Проверка:myagkij
- Оформление:myagkij
- Редактирование:myagkij
- Стандартные библиотеки
- Стандартная библиотека
- Стандартная библиотека Arduino
- Стандартные библиотеки Arduino
- Библиотека Ethernet
- Стандартная библиотека Ethernet
- Ethernet
- Функция