Подключение и первый вход

Урок 2 · Основы умного дома · 30 мин · theory

Физическое подключение контроллера

Первый практический этап внедрения любой системы автоматизации — это корректное физическое подключение основного управляющего устройства. От правильности выполнения этих шагов зависит не только работоспособность, но и безопасность, и долговечность оборудования. В этом уроке мы выполним первоначальное подключение контроллера к источнику питания и локальной сети.

> ⚠️ Внимание: Используйте только рекомендованный производителем блок питания. Подача некорректного напряжения или несоблюдение полярности может привести к необратимому повреждению контроллера.

Подключение питания

Основной контроллер является низковольтным устройством и требует для работы внешний источник питания постоянного тока (DC).

Определите требования к питанию: Как мы рассматривали в уроке COURSE-01-M01-L02 "Аппаратный тур по контроллеру", на корпусе устройства и в технической документации указан диапазон допустимого напряжения (например, 9–36V DC) и рекомендуемая мощность. Убедитесь, что ваш блок питания соответствует этим параметрам.

Подготовьте кабель питания: Используйте двухжильный кабель достаточного сечения (рекомендуется не менее 0.5 мм²). Зачистите концы кабеля примерно на 5-7 мм.

Соблюдайте полярность: На клеммной колодке контроллера, предназначенной для питания, есть маркировка: Vin (или `+`) и GND (или `-`).

* Подключите положительный (`+`) провод от блока питания к клемме Vin.

* Подключите отрицательный (`-` или земля) провод от блока питания к клемме GND.

Зафиксируйте провода: После вставки проводов в клеммы, надежно затяните винты. Слегка потяните за каждый провод, чтобы убедиться в прочности соединения. Плохой контакт может привести к перезагрузкам контроллера под нагрузкой.

Подайте питание: Включите блок питания в сеть 220В.

Подключение к локальной сети

Для доступа к веб-интерфейсу, Node-RED и подключения по SSH контроллер должен быть соединен с вашей локальной вычислительной сетью (ЛВС).

Найдите Ethernet-порт: На корпусе контроллера расположен стандартный порт RJ-45.

Используйте патч-корд: Возьмите стандартный Ethernet-кабель (патч-корд) Cat5e или выше.

Выполните подключение: Один конец кабеля подключите к Ethernet-порту контроллера, а другой — к свободному порту вашего сетевого роутера или коммутатора. Вы должны услышать характерный щелчок, свидетельствующий о фиксации коннектора.

Индикация первой загрузки

После подачи питания контроллер начинает процесс загрузки операционной системы Linux. Этот процесс сопровождается светодиодной индикацией, которая служит основным инструментом первичной диагностики.

| :-------- | :----- | :-------------------------------------- | :--------------------------------------------------------------------------------------------------- |

Если после 2-3 минут после включения индикатор Status не начал мигать, а горит постоянно или не горит вовсе, это может свидетельствовать о проблеме с загрузкой ОС или неисправности. В этом случае обратитесь к разделу "Если что-то пошло не так" в конце модуля.

---

Поиск контроллера в локальной сети

После успешной загрузки контроллер готов к работе в сети. По умолчанию он настроен на автоматическое получение сетевых настроек от вашего роутера с помощью протокола DHCP (Dynamic Host Configuration Protocol). Наша задача — узнать, какой именно IP-адрес был ему назначен.

> 💡 Подсказка: Для работы с адресами *.local на Windows может потребоваться установка службы Apple Bonjour Print Services. На macOS и большинстве современных дистрибутивов Linux поддержка mDNS встроена по умолчанию.

Метод 1: Список DHCP-клиентов на роутере (Рекомендуемый)

Это самый надежный способ узнать IP-адрес устройства.

Откройте веб-интерфейс вашего роутера. Для этого введите его IP-адрес (часто это `192.168.1.1` или `192.168.0.1`) в адресную строку браузера и авторизуйтесь.

Найдите раздел управления сетью. Он может называться "Локальная сеть", "DHCP-сервер", "Список клиентов", "Подключенные устройства".

Изучите список. В таблице подключенных устройств найдите запись, соответствующую вашему контроллеру. Как правило, в поле "Имя хоста" (Hostname) будет указано `wirenboard` или `wirenboard-XXXXXXXX`, где `XXXXXXXX` — уникальный идентификатор, совпадающий с частью MAC-адреса, указанного на наклейке на корпусе контроллера.

Запишите IP-адрес, указанный в этой строке. Например, `192.168.1.115`. Этот адрес понадобится нам для дальнейшей работы.

> ℹ️ Информация: Рекомендуется в настройках DHCP-сервера вашего роутера зарезервировать (привязать) выданный IP-адрес к MAC-адресу контроллера. Это гарантирует, что контроллер всегда будет получать один и тот же IP-адрес даже после перезагрузки, что упрощает администрирование.

Метод 2: Использование mDNS (Bonjour)

Протокол mDNS (Multicast DNS) позволяет устройствам в локальной сети обращаться друг к другу по именам, без необходимости знать их IP-адреса. Контроллер по умолчанию анонсирует себя в сети под специальным именем.

Формат имени: `wirenboard-XXXXXXXX.local`

Здесь `XXXXXXXX` — последние 6 символов MAC-адреса контроллера без двоеточий. MAC-адрес указан на наклейке на корпусе устройства.

Например, если MAC-адрес `AC:1D:DF:81:23:45`, то mDNS-имя будет `wirenboard-812345.local`.

Просто введите это имя в адресную строку вашего браузера. Если ваша операционная система поддерживает mDNS, вы должны попасть на веб-интерфейс контроллера.

Метод 3: Сканеры IP-сетей

Если первые два способа по какой-то причине не сработали, можно прибегнуть к сканированию всей локальной подсети.

Установите программу-сканер. Популярным бесплатным решением для Windows является Advanced IP Scanner. Для macOS и Linux можно использовать `nmap`.

Запустите сканирование. Укажите диапазон IP-адресов вашей сети (например, `192.168.1.1-254`) и запустите процесс.

Проанализируйте результаты. Программа отобразит список всех активных устройств в сети. Ищите устройство с именем производителя "Wiren Board" или именем хоста `wirenboard`.

Этот метод менее предпочтителен, так как требует установки дополнительного ПО и занимает больше времени, но является эффективным запасным вариантом.

---

Первый вход в веб-интерфейс и основы безопасности

Веб-интерфейс является основным инструментом для настройки, мониторинга и управления контроллером на начальном и среднем уровне. Он не требует специальных знаний в программировании и предоставляет наглядное представление о состоянии всех подключенных устройств.

Процедура входа

Откройте браузер (рекомендуются Google Chrome, Mozilla Firefox или другие современные браузеры).

Введите адрес контроллера в адресную строку. Используйте IP-адрес (например, `192.168.1.115`), который вы определили на предыдущем шаге, или его mDNS-имя (`wirenboard-XXXXXXXX.local`).

Вы увидите страницу входа с запросом логина и пароля.

Введите учетные данные по умолчанию:

* Логин: `root`

* Пароль: `wirenboard`

После успешного ввода вы попадете на главный экран веб-интерфейса — дашборд.

Важнейший шаг: Смена пароля

Оставлять стандартный пароль — это грубейшее нарушение базовых правил кибербезопасности. Любой, кто получит доступ к вашей локальной сети, сможет получить полный контроль над вашим умным домом. Смена пароля — это обязательное действие, которое нужно выполнить немедленно после первого входа.

В левом навигационном меню перейдите в раздел "Настройки" (иконка шестеренки).

Выберите подраздел "Пользователи".

В списке вы увидите пользователя `root`. Нажмите на него.

В открывшемся окне вы увидите поля для смены пароля. Введите новый, сложный пароль в поля "Пароль" и "Подтверждение пароля".

> 💡 Подсказка: Хороший пароль должен содержать не менее 12 символов, включать в себя заглавные и строчные буквы, цифры и специальные символы (`!`, `@`, `#`, `$` и т.д.). Не используйте очевидные комбинации вроде "qwerty12345" или "password123". Сохраните новый пароль в надежном месте (менеджере паролей).

Нажмите кнопку "Сохранить". Система немедленно применит новый пароль. Вас может "выбросить" на страницу входа — это нормально. Войдите снова, уже используя новый пароль.

Краткий обзор разделов веб-интерфейса

После входа вы увидите несколько основных разделов в левом меню:

Дашборды: Главная страница для визуализации. Здесь располагаются виджеты (кнопки, переключатели, графики, индикаторы), позволяющие в реальном времени отслеживать состояние датчиков и управлять нагрузками. Вы можете создавать и настраивать свои дашборды.
Устройства: Сердце системы. В этом разделе отображаются все аппаратные и виртуальные устройства, которые "видит" контроллер: его собственные входы/выходы, подключенные по Modbus или CAN модули, устройства MQTT и т.д. Именно здесь вы видите "каналы" (controls), представляющие конкретные функции, например, "Реле 1", "Температура датчика 3".
Правила (Node-RED): Раздел для создания сценариев автоматизации. При переходе в этот раздел открывается встроенный редактор Node-RED, где вы будете создавать логические цепочки (flows) для управления системой.
Настройки: Раздел для системного администрирования. Здесь вы настраиваете сетевые подключения, обновляете ПО, управляете пользователями, просматриваете системные логи и конфигурируете аппаратные модули.

---

Подключение через SSH: введение в командную строку Linux

Если веб-интерфейс — это приборная панель автомобиля, то SSH (Secure Shell) — это доступ в его моторный отсек. SSH представляет собой защищенный сетевой протокол, позволяющий получить полный доступ к командной строке операционной системы Linux, работающей на контроллере. Это основной инструмент для "глубокой" настройки, диагностики, установки дополнительного ПО и выполнения задач, недоступных через веб-интерфейс.

📋 Ключевые понятия:

SSH (Secure Shell): Протокол для безопасного удаленного управления компьютером через текстовый интерфейс (командную строку). Весь трафик между вашим компьютером и контроллером шифруется.
Командная строка (CLI - Command Line Interface): Текстовый интерфейс для взаимодействия с операционной системой путем ввода команд.
root-доступ: Права суперпользователя в Linux, позволяющие выполнять любые действия в системе без ограничений.

Необходимые инструменты

Для Windows: Наиболее популярным SSH-клиентом является PuTTY. Это бесплатная, небольшая утилита, которую можно скачать с официального сайта.
Для macOS и Linux: SSH-клиент встроен в систему. Вам понадобится только стандартное приложение "Терминал".

Практика подключения по SSH

Запустите SSH-клиент.

* На Windows: Запустите PuTTY.

* На macOS/Linux: Откройте Терминал.

Укажите параметры подключения.

* PuTTY (Windows):

1. В поле "Host Name (or IP address)" введите IP-адрес вашего контроллера (например, `192.168.1.115`).

2. Убедитесь, что "Port" установлен в `22`, а "Connection type" — `SSH`.

3. Нажмите кнопку "Open".

* Терминал (macOS/Linux):

Введите в командную строку следующую команду, заменив `` на реальный адрес вашего контроллера, и нажмите Enter:

ssh root@

Например:

ssh root@192.168.1.115

Подтверждение ключа хоста. При первом подключении к любому SSH-серверу вы увидите предупреждение безопасности, подобное этому:

The authenticity of host '192.168.1.115 (192.168.1.115)' can't be established. ECDSA key fingerprint is SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Are you sure you want to continue connecting (yes/no/[fingerprint])?

Это стандартная процедура. Система сообщает, что подключается к этому устройству впервые и не знает его. Введите `yes` и нажмите Enter. Ключ хоста будет сохранен на вашем компьютере, и в следующий раз это сообщение не появится.

Аутентификация. Система запросит пароль для пользователя `root`. Введите пароль, который вы установили на предыдущем шаге (или пароль по умолчанию `wirenboard`, если вы его еще не сменили).

> ⚠️ Внимание: При вводе пароля в командной строке Linux символы не отображаются на экране (даже в виде звездочек). Это сделано в целях безопасности. Просто вводите пароль и нажмите Enter.

После успешного ввода пароля вы увидите приветственное сообщение и командную строку, ожидающую ваших команд. Она выглядит примерно так:

`root@wirenboard-XXXXXXXX:~#`

Ваши первые команды в Linux

Давайте выполним несколько базовых команд, чтобы осмотреться в системе.

`uname -a`: Показывает подробную информацию о ядре Linux и архитектуре системы.

root@wirenboard-812345:~# uname -a Linux wirenboard-812345 5.10.35-wb130 #1 SMP PREEMPT Tue Jan 24 16:51:30 UTC 2023 armv7l GNU/Linux

Из вывода мы видим версию ядра (`5.10.35`), дату сборки и архитектуру процессора (`armv7l`).

`df -h`: Отображает информацию об использовании дискового пространства. Флаг `-h` (`human-readable`) делает вывод более читаемым (в мегабайтах и гигабайтах).

root@wirenboard-812345:~# df -h Filesystem Size Used Avail Use% Mounted on /dev/root 14G 2.1G 11G 17% / devtmpfs 1.9G 0 1.9G 0% /dev tmpfs 2.0G 0 2.0G 0% /dev/shm

Эта команда критически важна для мониторинга: она показывает, сколько свободного места осталось в основном разделе (`/dev/root`), где хранятся ОС, логи и ваши сценарии Node-RED.

`ls -la`: Выводит список файлов и директорий в текущем каталоге с подробной информацией.

root@wirenboard-812345:~# ls -la total 24 drwx------ 4 root root 4096 Feb 28 15:10 . drwxr-xr-x 18 root root 4096 Feb 28 14:55 .. -rw------- 1 root root 234 Feb 28 15:10 .bash_history -rw-r--r-- 1 root root 570 Jan 31 2018 .bashrc drwxr-xr-x 3 root root 4096 Feb 28 14:58 .node-red

Здесь вы видите права доступа, владельца, размер, дату изменения и имя файла/директории. Например, каталог `.node-red` — это место, где хранятся ваши потоки (flows) и настройки Node-RED.

Знакомство с командной строкой открывает перед вами безграничные возможности по тонкой настройке и расширению функционала контроллера, которые мы будем активно использовать на более продвинутых курсах.

---

Резюме и следующие шаги

В этом насыщенном практикой уроке мы выполнили ключевые первые шаги для ввода контроллера в эксплуатацию. Пройденный материал является фундаментом для всей дальнейшей работы с платформой.

По итогам этого занятия вы научились:

Физически подключать контроллер к источнику питания и локальной сети, контролируя процесс по светодиодным индикаторам.
Находить контроллер в сети тремя различными способами: через интерфейс роутера, по mDNS-имени и с помощью сетевого сканера.
Выполнять первый вход в веб-интерфейс, и, что самое важное, производить немедленную смену пароля `root` для обеспечения базовой сетевой безопасности.
Подключаться к контроллеру по протоколу SSH для доступа к командной строке Linux, освоив базовые команды для получения информации о системе.

Вы закрепили понимание таких ключевых концепций, как DHCP, IP-адрес, root-доступ и разницу между управлением через веб-интерфейс и командную строку. Теперь контроллер полностью готов к настройке и созданию первых сценариев автоматизации.

Что дальше

В следующем уроке, COURSE-01-M01-L04 "Обзор веб-интерфейса: устройства и MQTT-каналы", мы глубже погрузимся в структуру веб-интерфейса. Мы детально разберем раздел "Устройства", научимся различать драйверы и каналы (controls), а также поймем, как аппаратные входы/выходы контроллера и внешние модули представляются в системе через протокол MQTT. Это позволит нам подготовиться к созданию нашего первого простого сценария.