TESLiOT BLE Sensors: различия между версиями

Материал из Wiren Board
(Исправлено с учетом установки из репозитория)
(не показано 18 промежуточных версий 2 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Использование BLE-датчиков TESLiOT с контроллером Wiren Board}}
{{DISPLAYTITLE: Использование BLE-датчиков TESLiOT с контроллером Wiren Board}}
== Общая информация ==
== Общая информация ==
[[Image: Tesliot sensor.jpg |300px|thumb|right| Пример представления устройства TESLiOT в интерфейсе]]
Беспроводные датчики TESLiOT имеют на борту разнообразные датчики состояния среды и имеют заявленный батарейное питание со сроком работы от батареи от 6 месяцев до трёх лет в зависимости от типа.  
Беспроводные датчики [https://tesla-smart.ru/ TESLiOT] имеют на борту разнообразные сенсоры состояния среды и имеют батарейное питание с заявленным сроком работы от батареи от шести месяцев до пяти лет в зависимости от типа и ёмкости элементов питания в датчиках.


Протокол поддерживает следующие типы данных:
Протокол подразумевает возможность получать такие данные как:
* напряжение питания датчика;
* Напряжение питания датчика
* факт удара;
* Факт удара
* ускорения по осям X, Y и Z;
* Ускорения по осям X, Y и Z
* интенсивность магнитного поля;
* Интенсивность магнитного поля
* освещённость;
* Освещённость
* влажность;
* Влажность
* температура;
* Температура
* метка времени в момент передачи данных.
* Метка времени в момент передачи данных


== Подключение к контроллеру Wiren Board ==
== Подключение к контроллеру Wiren Board ==
Датчики TESLiOT отправляют в эфир широковещательные сообщения по каналу BLE, которые контроллер [[Wiren Board]] может получать и обрабатывать. Делает он это с помощью драйвера [https://github.com/wirenboard/wb-ble-tesliot wb-ble-tesliot], который периодически запускает скрипт сканирования сети и получает свежие данные с датчиков.
Датчики TESLiOT подключаются к контроллерам Wirenboard по каналу BLE посредством широковещания параметров GAP Advertising.
Со стороны контроллера движок правил [wb-rules] периодически запускает скрипт сканирования сети, от которого получает свежие данные с датчиков.


== Установка и настройка ==
== Установка и настройка ==
{{SupportedSinceRelease
Для работы с TESLiOT нужно установить из репозитория драйвер <code>wb-ble-tesliot</code>.
| release = wb-2304
<syntaxhighlight lang="bash">
|content=
apt update
Для работы с TESLiOT нужно установить и настроить драйвер:
apt install wb-ble-tesliot
# Подключитесь к контроллеру по [[SSH]].
# Установите драйвер <code>wb-ble-tesliot</code>:
#:<syntaxhighlight lang="bash">
apt update && apt install wb-ble-tesliot
</syntaxhighlight>
</syntaxhighlight>
# Заполните массив датчиков в файле <code>/etc/wb-ble-tesliot.conf</code>:
 
#*Откройте файл для редактирования:
 
#*:<syntaxhighlight lang="bash">
Далее нужно в конфигурационном файле <code>/etc/wb-ble-tesliot.conf</code> заполнить массив датчиков, указав их mac-адреса (mac), желаемые названия mqtt-топиков (dev_id) и заголовки виртуальных устройств (title), например:
nano /etc/wb-ble-tesliot.conf
 
</syntaxhighlight>
<syntaxhighlight lang="json">
#*Впишите mac-адрес датчиков, а также идентификатор и имя создаваемого устройства <syntaxhighlight lang="json">
{"config":
{"config":
   [
   [
Строка 39: Строка 34:
         "title":"TESLiOT Test Sensor 1", // видимое имя устройства
         "title":"TESLiOT Test Sensor 1", // видимое имя устройства
         "mac":"FF:FF:FF:FF:FF:FF" // mac-адрес устройства
         "mac":"FF:FF:FF:FF:FF:FF" // mac-адрес устройства
       },
       };
       {
       {
         "dev_id":"tesliot_2",
         "dev_id":"tesliot_2",
Строка 47: Строка 42:
   ]
   ]
}
}
</syntaxhighlight>
#* Сохраните изменения и закройте редактор клавишами <kbd>Ctrl</kbd>+<kbd>O</kbd> и <kbd>Ctrl</kbd>+<kbd>X</kbd>.
# Чтобы изменения вступили в силу, перезапустите wb-rules:
#:<syntaxhighlight lang="bash">
systemctl restart wb-rules
</syntaxhighlight>
</syntaxhighlight>


Теперь датчики должны появиться в веб-интерфейсе контроллера на вкладке '''Устройства'''. Дальше вы можете использовать их в скриптах автоматизации, при создании дашбордов или отправлять данные в систему верхнего уровня.
После изменения конфигурации нужно перезапустить wb-rules:
 
}}
 
== Удаление драйвера ==
Чтобы удалить драйвер, выполните команды:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
apt purge wb-ble-tesliot && systemctl restart wb-rules
systemctl restart wb-rules
</syntaxhighlight>
</syntaxhighlight>
Карточки датчиков на вкладке '''Устройства''' должны удалиться автоматически.


== Полезные ссылки ==
Результат должен выглядеть так:
* [https://github.com/wirenboard/wb-ble-tesliot Исходные коды драйвера wb-ble-tesliot]
[[Image: Tesliot sensor.jpg |300px|thumb|left| Пример представления устройства TESLiOT в интерфейсе]]
* [https://tesla-smart.ru/ Сайт компании TESLiOT]

Версия 17:58, 1 декабря 2022

Общая информация

Беспроводные датчики TESLiOT имеют на борту разнообразные датчики состояния среды и имеют заявленный батарейное питание со сроком работы от батареи от 6 месяцев до трёх лет в зависимости от типа.

Протокол подразумевает возможность получать такие данные как:

  • Напряжение питания датчика
  • Факт удара
  • Ускорения по осям X, Y и Z
  • Интенсивность магнитного поля
  • Освещённость
  • Влажность
  • Температура
  • Метка времени в момент передачи данных

Подключение к контроллеру Wiren Board

Датчики TESLiOT подключаются к контроллерам Wirenboard по каналу BLE посредством широковещания параметров GAP Advertising. Со стороны контроллера движок правил [wb-rules] периодически запускает скрипт сканирования сети, от которого получает свежие данные с датчиков.

Установка и настройка

Для работы с TESLiOT нужно установить из репозитория драйвер wb-ble-tesliot.

apt update
apt install wb-ble-tesliot


Далее нужно в конфигурационном файле /etc/wb-ble-tesliot.conf заполнить массив датчиков, указав их mac-адреса (mac), желаемые названия mqtt-топиков (dev_id) и заголовки виртуальных устройств (title), например:

{"config":
   [
      {
         "dev_id":"tesliot_1", // устройство будет доступно по топику /devices/tesliot_1
         "title":"TESLiOT Test Sensor 1", // видимое имя устройства
         "mac":"FF:FF:FF:FF:FF:FF" // mac-адрес устройства
      };
      {
         "dev_id":"tesliot_2",
         "title":"TESLiOT Test Sensor 2",
         "mac":"FE:FE:FE:FE:FE:FE"
      }
   ]
}

После изменения конфигурации нужно перезапустить wb-rules:

systemctl restart wb-rules

Результат должен выглядеть так:

Пример представления устройства TESLiOT в интерфейсе