First launch and configuration of the controller: различия между версиями

Материал из Wiren Board
(Перенаправление изменено с WB FAQ на Wiren Board 6)
Метка: изменение цели перенаправления
(не показано 38 промежуточных версий этого же участника)
Строка 1: Строка 1:
#REDIRECT [[Wiren Board 6]]
{{DISPLAYTITLE:Первый запуск и настройка}}
 
== Монтаж и установка SIM-карты ==
 
Установите контроллер на дин-рейку и прикрутите антенны к разъемам SMA.
 
Если в вашем контроллере установлен модуль связи для обмена SMS-сообщениями и подключения к интернету — установите SIM-карту:
* Если на контроллер подано питание — отключите его.
* Откройте верхнюю крышку контроллера: для этого отщелкните четыре защелки, которые удерживают крышку.
* Найдите разъем SIM1 и установите nano-SIM карту срезанным углом вниз, контактами к стенке контроллера. Ориентируйтесь по подсказке на крышке.
* Закройте крышку контроллера.
 
Подробнее об установке SIM-карты читайте в статье «[[SIM_card_installation|Установка SIM-карты]]».
 
<gallery mode="packed" heights="250px">
File:WB6.7+GSM-WiFi-Ant.jpg|Контроллер Wiren Board 6.7 с установленными антеннами WiFi и GSM
File:WB6.7_Insert_SIM_Card.jpg|Установка SIM-карты в контроллер Wiren Board 6.7
</gallery>
 
== Подключение питания и запуск ==
[[File:WB6.7 + HDR.png|thumb|350px|Питание контроллера Wiren Board 6.7 от блока питания HDR]]
 
На контроллере есть несколько внешних входов для подключения питания: два входа '''V+''' с общей землей '''GND''' и питание по кабелю через порт '''Ethernet 1''', по стандарту [[Power_over_Ethernet|Passive PoE]].
 
Возможно одновременное подключение источников к разным входам, в том числе с разным напряжением. Питание будет идти от источника с большим напряжением.
 
Параметры питания:
* Диапазон напряжения питания: 9–48 В.
* Пиковая потребляемая мощность: 2 Вт.
* Пиковая потребляемая мощность с GSM модулем: 10 Вт.
 
После установки контроллера на DIN-рейку и подачи питания, переведите переключатель на верхней крышке контроллера в положение ON. Начнется загрузка операционной системы контроллера. По окончании загрузки индикатор контроллера замигает зеленым.
 
Полезные ссылки:
* [[Wiren_Board_6#Питание|Питание контроллера]]
* [[Wiren_Board_6#Индикация этапов загрузки|Индикация этапов загрузки]]
 
== Установка часового пояса и времени ==
=== Часовой пояс ===
 
Контроллер настроен на синхронизацию времени через интернет и для корректной работы нужно установить верный часовой пояс.
 
Установить другой часовой пояс можно командой:
<syntaxhighlight lang="bash">
timedatectl set-timezone Europe/Moscow
</syntaxhighlight>
 
Вывести список доступных часовых поясов:
<syntaxhighlight lang="bash">
~$ timedatectl list-timezones
Africa/Abtdjan
Africa/Accra
Africa/Addts Ababa
Africa/Algters
Africa/Asmara
Africa/Bamako
Africa/ Bangui
Africa/Banjul
...
</syntaxhighlight>
 
После внесения изменений перезапустите [[Движок_правил_wb-rules_2.0|wb-rules]], для этого выполните команду:
<syntaxhighlight lang="bash">
/etc/init.d/wb-rules restart
</syntaxhighlight>
 
=== Дата и время ===
 
Если контроллер не имеет доступ в интернет, то установите дату и время командой:
<syntaxhighlight lang="bash">
timedatectl set-time '2020-10-12 01:58:00'
</syntaxhighlight>
 
В примере мы установили 12 октября 2020 года, 1 час 58 минут ночи.
 
После внесения изменений перезапустите <code>wb-rules</code>.
 
=== Энергонезависимый таймер ===
После того как на контроллере будут установлены верные часовой пояс и время — синхронизируйте энергонезависимый таймер с часами контроллера:
<syntaxhighlight lang="bash">
hwclock --systohc --localtime
</syntaxhighlight>
 
Энергонезависимый таймер питается от батарейки и позволит восстановить корректное время в контроллере при отключении питания.
 
== Настройка сети ==
 
=== Протокол SSH ===
Так как контроллер Wiren Board управляется ОС Linux, то основные настройки удобно производить из командной строки. Для этого нужно подключиться к контроллеру по протоколу SSH.
 
Логин и пароль по умолчанию:
* Логин: root
* Пароль: wirenboard
 
Программы:
* Windows — используйте бесплатную программу PuTTY. Загрузить ее можно на [https://www.putty.org официальном сайте программы].
* Linux — просто в командной строке выполните команду:
*:<syntaxhighlight lang="bash">
ssh root@192.168.42.1
</syntaxhighlight>
*:где 192.168.42.1 — IP-адрес контроллера, а root — имя пользователя.
 
Если вы подключаетесь к контроллеру в первый раз, то система предложит принять сертификат — введите <code>yes</code>.
 
IP-адрес зависит от способа подключения и настроек контроллера. Подробнее читайте ниже в этом разделе.
 
=== WiFi ===
Контроллер создает WiFi точку доступа и мы можем подключиться к ней:
* Откройте на компьютере или планшете список WiFi точек доступа.
* Выберите из списка точку доступа с именем <code>WirenBoard-XXXXXXXX</code>. Где XXXXXXXX - серийный номер контроллера.
 
При подключении по WiFi контроллер будет доступен по IP-адресу <code>192.168.42.1</code>.
 
По умолчанию, для подключения к контроллеру по WiFi не требуется логин и пароль, но вы можете это изменить.
 
=== Установка пароля на WiFi ===
 
Подключитесь к контроллеру по SSH и откройте файл настроек <code>/etc/hostapd.conf</code>, для этого введите команду:
<syntaxhighlight lang="bash">
nano /etc/hostapd.conf
</syntaxhighlight>
 
Добавьте в конец файла строки:
<pre>
wpa=2
wpa_passphrase=your_password
wpa_key_mgmt=WPA-PSK
wpa_pairwise=TKIP CCMP
</pre>
 
Придумайте свой пароль и замените в файле <code>your_password</code> на него. Сохраните файл нажатием клавиш <code>Ctrl+O</code> и выйдете из редактора <code>Ctrl+X</code>.
 
После этого выполните команду:
 
<syntaxhighlight lang="bash">
/etc/init.d/hostapd restart
</syntaxhighlight>
 
Контроллер применит новые настройки и связь с ним будет потеряна. Нужно будет заново подключиться к контроллеру по WiFi с указанным паролем. Если изменения настроек вы не можете подключиться к контроллеру по WiFi — подключитесь к нему по Ethernet и проверьте настройки в файле <code>/etc/hostapd.conf</code>.
 
=== Ethernet ===
Подключите кабель к одному из Ethernet-портов.
 
'''Автоматическое получение адреса по DHCP'''
 
В заводской конфигурации в контроллере оба сетевых интерфейса не имеют фиксированного IP-адреса и получают сетевые настройки по DHCP. Самый простой способ узнать присвоенный контроллеру IP адрес — подключиться к контроллеру по WiFi, зайти в веб-интерфейс и посмотреть текущий IP адрес на вкладке '''Home''', виджет '''IP-адрес Ethernet'''.
 
Если доступ в интернет будет осуществляться через роутер — используйте автоматическое назначение IP-адреса по DHCP.
 
'''Настройка фиксированного IP-адреса'''
 
Если в вашей сети нет роутера, который может назначить контроллеру IP-адрес автоматически, то вам потребуется прописать адрес вручную.
* подключаемся к контроллеру по WiFi,
* заходим по SSH,
* выполняем команду:
*:<syntaxhighlight lang="bash">
ip a add 192.168.1.200/255.255.255.0 dev eth0
</syntaxhighlight>
*:где 192.168.1.200 — новый IP адрес для интерфейса eth0, а 255.255.255.0 — маска подсети
 
=== Настройка мобильного интернета (PPP) ===
Если в вашем контроллере установлен 4G/3G/2G модем, то после установки SIM-карты вы можете [[Wirenboard6:InstallingOnTheRemoteSite#Настройка PPP|настроить доступ в интернет]].
 
== Веб-интерфейс ==
[[Файл:Web-Home-2.0.png|thumb|600 px|Главная страница веб-интерфейса]]
Настройку контроллера и подключенных модулей удобно делать через встроенный веб-интерфейс. Для этого нужно подключиться к контроллеру по WiFi или Ethernet и ввести IP адрес контроллера в адресную строку браузера.
 
Подробнее о веб-интерфейсе читайте в статье «[[Веб-интерфейс Wiren Board|Веб-интерфейс Wiren Board]]».
 
== Обновление прошивки ==
Перед началом использования рекомендуем обновить прошивку контроллера.
 
'''ВНИМАНИЕ:''' здесь рассматривается контроллер Wiren Board ревизии 6.7. Инструкции по обновлению других версий контроллера читайте в статье «[[Обновление_прошивки|Обновление прошивки]]».
 
'''Если у контроллера есть доступ в интернет''', то проще всего это сделать из командной строки:
# Подключитесь к контроллеру по SSH.
# Выполните команду
#:<syntaxhighlight lang="bash">
apt update && apt upgrade -y
</syntaxhighlight>
# Дождитесь окончания процедуры.
 
'''Если у контроллера нет доступа в интернет''':
# Загрузите на компьютер файл прошивки из нашего репозитория — [http://fw-releases.wirenboard.com/fit_image/stable/67/latest_stretch.fit свежая версия прошивки для контроллера Wiren Board 6.7].
# Зайдите в веб-интерфейс, страница '''Settings''' → раздел '''Firmware update''' → кнопка '''Select file''' и выберите загруженный ранее файл прошивки.
# Файл с прошивкой загрузится на контроллер и начнется обновление — не переключайтесь между разделами и не выключайте контроллер. Обновление завершится в течение 10 минут.
# После обновления контроллер перезагрузится в штатный режим и на странице появится сообщение '''Firmware update complete'''.
 
== Обновление веб-интерфейса ==
Контроллеры поставляются с веб-интерфейсом версии 1.x, но мы готовим к релизу новую версию 2.0.0. Рекомендуем сразу обновить — это избавит вас от необходимости в будущем переносить конфигурацию со старой версии веб-интерфейса в новую, а нам поможет быстрее получить обратную связь и улучшить продукт.
 
Подробнее о новых возможностях можно почитать в статье «[[Веб-интерфейс Wiren Board|Веб-интерфейс Wiren Board]]». Список изменений доступен на Github — [https://github.com/wirenboard/homeui/blob/pre-release/2.0.0/debian/changelog Changelog].
 
Подключите контроллер к интернету. Теперь нам нужно добавить experimental репозиторий и установить из него новую версию. Выполните поочереди команды:
<syntaxhighlight lang="bash">
echo "deb http://releases.contactless.ru/experimental/stretch stretch main" > /etc/apt/sources.list.d/experimental.list
apt update
apt install wb-mqtt-homeui=2.0.0~rc2
</syntaxhighlight>
 
После установки зайдите через браузер в веб-интерфейс и одновременно нажмите клавиши <code>Ctrl+Shift+R</code> — это удалит страницу из кэша браузера и позволит избежать возможных проблем.
 
== Настройка уровня доступа ==
[[Файл:WebUI 2.0 — changing user rights.png|300px|thumb|right|Web UI 2.0 — смена уровня доступа текущего пользователя]]
Уровни доступа есть только в веб-интерфейсе версии 2.0. Они призваны защитить пользователя от ошибок при регулярной работе с контроллером. Важно понимать, что это не полноценное разграничение прав, а способ защитить себя от необдуманных действий. Новых пользователей создавать нельзя.
 
Доступны следующие уровни:
* User — дашборды, виджеты, история, базовые настройки.
* Operator — права уровня User и раздел Devices
* Administrator — полный доступ ко всем функциям.
 
Чтобы изменить уровень доступа к настройкам веб-интерфейса:
* Зайдите в веб-интерфейс.
* Перейдите в раздел '''Settings''' и выберите пункт '''Change access level'''. Установите нужное значение и нажмите кнопку '''Apply'''.
 
== Настройка модулей ввода-вывода ==
[[Файл:Configuring the I-O module WBIO-DI-DR-14.png|300px|thumb|right|Настройка модуля ввода-вывода WBIO-DI-DR-14 в Web UI 2.0]]
 
Мы будем рассматривать настройку модулей на примере веб-интерфейса версии 2.0. Вам нужно иметь доступ уровня Administrator. [[#Настройка уровня доступа|Как изменить уровень доступа]].
 
После подключения к контроллеру модули ввода-вывода требуется настроить. Чтобы это сделать, перейдите в веб-интерфейсе на вкладку '''Settings''' → '''Configs''' → '''Hardware Modules Configuration'''.
 
Модули подключаются путем выбора типа в разделах '''External I/O module N''', где N — это число от 1 до 8:
* Выберите один из разделов '''External I/O module'''.
* В поле '''Module Type''' выберите модуль, который вы хотите настроить.
 
После окончания настроек нажмите кнопку '''Save''' в левом верхнем углу.
 
Теперь вы можете использовать каналы ввода-вывода в создании виджетов. Подробнее о создании виджетов читайте в статье «[[Веб-интерфейс Wiren Board#Widgets (Виджеты)|Веб-интерфейс Wiren Board]]».
 
== Решение проблем ==
* [[WB6_root_password_recovery|Забыли пароль root]]
* [[Определение и изменение Modbus-адреса устройств Wirenboard|Неизвестен modbus-адрес устройства]]
* [[Обновление прошивки#Сброс Wiren Board 6 к заводским настройкам|Сброс контроллера к заводским настройкам]]

Версия 22:38, 10 декабря 2020


Монтаж и установка SIM-карты

Установите контроллер на дин-рейку и прикрутите антенны к разъемам SMA.

Если в вашем контроллере установлен модуль связи для обмена SMS-сообщениями и подключения к интернету — установите SIM-карту:

  • Если на контроллер подано питание — отключите его.
  • Откройте верхнюю крышку контроллера: для этого отщелкните четыре защелки, которые удерживают крышку.
  • Найдите разъем SIM1 и установите nano-SIM карту срезанным углом вниз, контактами к стенке контроллера. Ориентируйтесь по подсказке на крышке.
  • Закройте крышку контроллера.

Подробнее об установке SIM-карты читайте в статье «Установка SIM-карты».

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

Питание контроллера Wiren Board 6.7 от блока питания HDR

На контроллере есть несколько внешних входов для подключения питания: два входа V+ с общей землей GND и питание по кабелю через порт Ethernet 1, по стандарту Passive PoE.

Возможно одновременное подключение источников к разным входам, в том числе с разным напряжением. Питание будет идти от источника с большим напряжением.

Параметры питания:

  • Диапазон напряжения питания: 9–48 В.
  • Пиковая потребляемая мощность: 2 Вт.
  • Пиковая потребляемая мощность с GSM модулем: 10 Вт.

После установки контроллера на DIN-рейку и подачи питания, переведите переключатель на верхней крышке контроллера в положение ON. Начнется загрузка операционной системы контроллера. По окончании загрузки индикатор контроллера замигает зеленым.

Полезные ссылки:

Установка часового пояса и времени

Часовой пояс

Контроллер настроен на синхронизацию времени через интернет и для корректной работы нужно установить верный часовой пояс.

Установить другой часовой пояс можно командой:

timedatectl set-timezone Europe/Moscow

Вывести список доступных часовых поясов:

~$ timedatectl list-timezones
Africa/Abtdjan
Africa/Accra
Africa/Addts Ababa
Africa/Algters
Africa/Asmara
Africa/Bamako
Africa/ Bangui
Africa/Banjul
...

После внесения изменений перезапустите wb-rules, для этого выполните команду:

/etc/init.d/wb-rules restart

Дата и время

Если контроллер не имеет доступ в интернет, то установите дату и время командой:

timedatectl set-time '2020-10-12 01:58:00'

В примере мы установили 12 октября 2020 года, 1 час 58 минут ночи.

После внесения изменений перезапустите wb-rules.

Энергонезависимый таймер

После того как на контроллере будут установлены верные часовой пояс и время — синхронизируйте энергонезависимый таймер с часами контроллера:

hwclock --systohc --localtime

Энергонезависимый таймер питается от батарейки и позволит восстановить корректное время в контроллере при отключении питания.

Настройка сети

Протокол SSH

Так как контроллер Wiren Board управляется ОС Linux, то основные настройки удобно производить из командной строки. Для этого нужно подключиться к контроллеру по протоколу SSH.

Логин и пароль по умолчанию:

  • Логин: root
  • Пароль: wirenboard

Программы:

  • Windows — используйте бесплатную программу PuTTY. Загрузить ее можно на официальном сайте программы.
  • Linux — просто в командной строке выполните команду:
    ssh root@192.168.42.1
    
    где 192.168.42.1 — IP-адрес контроллера, а root — имя пользователя.

Если вы подключаетесь к контроллеру в первый раз, то система предложит принять сертификат — введите yes.

IP-адрес зависит от способа подключения и настроек контроллера. Подробнее читайте ниже в этом разделе.

WiFi

Контроллер создает WiFi точку доступа и мы можем подключиться к ней:

  • Откройте на компьютере или планшете список WiFi точек доступа.
  • Выберите из списка точку доступа с именем WirenBoard-XXXXXXXX. Где XXXXXXXX - серийный номер контроллера.

При подключении по WiFi контроллер будет доступен по IP-адресу 192.168.42.1.

По умолчанию, для подключения к контроллеру по WiFi не требуется логин и пароль, но вы можете это изменить.

Установка пароля на WiFi

Подключитесь к контроллеру по SSH и откройте файл настроек /etc/hostapd.conf, для этого введите команду:

nano /etc/hostapd.conf

Добавьте в конец файла строки:

wpa=2
wpa_passphrase=your_password
wpa_key_mgmt=WPA-PSK
wpa_pairwise=TKIP CCMP

Придумайте свой пароль и замените в файле your_password на него. Сохраните файл нажатием клавиш Ctrl+O и выйдете из редактора Ctrl+X.

После этого выполните команду:

/etc/init.d/hostapd restart

Контроллер применит новые настройки и связь с ним будет потеряна. Нужно будет заново подключиться к контроллеру по WiFi с указанным паролем. Если изменения настроек вы не можете подключиться к контроллеру по WiFi — подключитесь к нему по Ethernet и проверьте настройки в файле /etc/hostapd.conf.

Ethernet

Подключите кабель к одному из Ethernet-портов.

Автоматическое получение адреса по DHCP

В заводской конфигурации в контроллере оба сетевых интерфейса не имеют фиксированного IP-адреса и получают сетевые настройки по DHCP. Самый простой способ узнать присвоенный контроллеру IP адрес — подключиться к контроллеру по WiFi, зайти в веб-интерфейс и посмотреть текущий IP адрес на вкладке Home, виджет IP-адрес Ethernet.

Если доступ в интернет будет осуществляться через роутер — используйте автоматическое назначение IP-адреса по DHCP.

Настройка фиксированного IP-адреса

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

  • подключаемся к контроллеру по WiFi,
  • заходим по SSH,
  • выполняем команду:
    ip a add 192.168.1.200/255.255.255.0 dev eth0
    
    где 192.168.1.200 — новый IP адрес для интерфейса eth0, а 255.255.255.0 — маска подсети

Настройка мобильного интернета (PPP)

Если в вашем контроллере установлен 4G/3G/2G модем, то после установки SIM-карты вы можете настроить доступ в интернет.

Веб-интерфейс

Главная страница веб-интерфейса

Настройку контроллера и подключенных модулей удобно делать через встроенный веб-интерфейс. Для этого нужно подключиться к контроллеру по WiFi или Ethernet и ввести IP адрес контроллера в адресную строку браузера.

Подробнее о веб-интерфейсе читайте в статье «Веб-интерфейс Wiren Board».

Обновление прошивки

Перед началом использования рекомендуем обновить прошивку контроллера.

ВНИМАНИЕ: здесь рассматривается контроллер Wiren Board ревизии 6.7. Инструкции по обновлению других версий контроллера читайте в статье «Обновление прошивки».

Если у контроллера есть доступ в интернет, то проще всего это сделать из командной строки:

  1. Подключитесь к контроллеру по SSH.
  2. Выполните команду
    apt update && apt upgrade -y
    
  3. Дождитесь окончания процедуры.

Если у контроллера нет доступа в интернет:

  1. Загрузите на компьютер файл прошивки из нашего репозитория — свежая версия прошивки для контроллера Wiren Board 6.7.
  2. Зайдите в веб-интерфейс, страница Settings → раздел Firmware update → кнопка Select file и выберите загруженный ранее файл прошивки.
  3. Файл с прошивкой загрузится на контроллер и начнется обновление — не переключайтесь между разделами и не выключайте контроллер. Обновление завершится в течение 10 минут.
  4. После обновления контроллер перезагрузится в штатный режим и на странице появится сообщение Firmware update complete.

Обновление веб-интерфейса

Контроллеры поставляются с веб-интерфейсом версии 1.x, но мы готовим к релизу новую версию 2.0.0. Рекомендуем сразу обновить — это избавит вас от необходимости в будущем переносить конфигурацию со старой версии веб-интерфейса в новую, а нам поможет быстрее получить обратную связь и улучшить продукт.

Подробнее о новых возможностях можно почитать в статье «Веб-интерфейс Wiren Board». Список изменений доступен на Github — Changelog.

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

echo "deb http://releases.contactless.ru/experimental/stretch stretch main" > /etc/apt/sources.list.d/experimental.list
apt update
apt install wb-mqtt-homeui=2.0.0~rc2

После установки зайдите через браузер в веб-интерфейс и одновременно нажмите клавиши Ctrl+Shift+R — это удалит страницу из кэша браузера и позволит избежать возможных проблем.

Настройка уровня доступа

Web UI 2.0 — смена уровня доступа текущего пользователя

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

Доступны следующие уровни:

  • User — дашборды, виджеты, история, базовые настройки.
  • Operator — права уровня User и раздел Devices
  • Administrator — полный доступ ко всем функциям.

Чтобы изменить уровень доступа к настройкам веб-интерфейса:

  • Зайдите в веб-интерфейс.
  • Перейдите в раздел Settings и выберите пункт Change access level. Установите нужное значение и нажмите кнопку Apply.

Настройка модулей ввода-вывода

Настройка модуля ввода-вывода WBIO-DI-DR-14 в Web UI 2.0

Мы будем рассматривать настройку модулей на примере веб-интерфейса версии 2.0. Вам нужно иметь доступ уровня Administrator. Как изменить уровень доступа.

После подключения к контроллеру модули ввода-вывода требуется настроить. Чтобы это сделать, перейдите в веб-интерфейсе на вкладку SettingsConfigsHardware Modules Configuration.

Модули подключаются путем выбора типа в разделах External I/O module N, где N — это число от 1 до 8:

  • Выберите один из разделов External I/O module.
  • В поле Module Type выберите модуль, который вы хотите настроить.

После окончания настроек нажмите кнопку Save в левом верхнем углу.

Теперь вы можете использовать каналы ввода-вывода в создании виджетов. Подробнее о создании виджетов читайте в статье «Веб-интерфейс Wiren Board».

Решение проблем