433MHz: различия между версиями

Удалённая из перевода страница
(Новая страница: «File:ds18b20.jpg|400px|thumb|Самый популярный температурный датчик 1-Wire - DS18B20, установленный в герме…»)
 
(Удалённая из перевода страница)
 
(не показаны 82 промежуточные версии 7 участников)
Строка 1: Строка 1:
[[File:ds18b20.jpg|400px|thumb|Самый популярный температурный датчик 1-Wire - DS18B20, установленный в герметичном корпусе]]
=Радиоинтерфейс 433 МГц=
[https://en.wikipedia.org/wiki/1-Wire '''1-Wire'''] - шина для подключения внешних датчиков, чаще всего температурных. Датчики подключаются по двум или трём проводам. Так как это шина, на один 1-Wire порт Wiren Board можно подключить несколько датчиков при соблюдении определённых условий.
== Поддерживаемые датчики ==
Wiren Board поддерживает один тип 1-Wire датчиков: температурные датчики на основе чипов DS18B20 и подобные. Они продаются в том числе в нашем [http://contactless.ru/store/#!/%D0%A6%D0%B8%D1%84%D1%80%D0%BE%D0%B2%D0%BE%D0%B9-%D0%B4%D0%B0%D1%82%D1%87%D0%B8%D0%BA-%D1%82%D0%B5%D0%BC%D0%BF%D0%B5%D1%80%D0%B0%D1%82%D1%83%D1%80%D1%8B-1-Wire/p/49713039/category=14225168 магазине].


Диапазон измерения температуры: -55..+125 °C.


Возможна реализация поддержки других 1-Wire устройств по запросу на [mailto:support@contactless.ru].
Контролеры Wiren Board опционально комплектуются радиоинтерфейсом 433МГц на базе чипа RFM69. С его помощью можно принимать и отправлять сигналы пультов радиоуправления различныими бытовыми устройствами. В базовой комплектации поддерживаются климатические датчики Oregon Scientific (протоколы версий 2 и 3) (см. [[Поддерживаемые устройства|таблицу совместимых устройств]]), а также устройства nooLite.


== Подключение ==
В настоящее время в бета-версии находится более продвинутый драйвер радиокоммуникации rfsniffer, обеспечивающий поддержку более широкого спектра радиоуправляемых устройств.
=== Подключение одного датчика по трём проводам ===
 
Датчик имеет три вывода. Их цвета могут меняться от модели к модели, желательно найти документацию на свою модель.
 
{| class="wikitable"
== Начало работы ==
!Сигнал||К какому клеммнику <br> Wiren Board подключать||Цвет: модель 1||Цвет: модель 2||Цвет: модель 3
 
|-
[[File:RF_remore.png|250 px|thumb|right|Подключение антенны ]]
|Vdd (VCC, питание)||+5V Out||Красный||Красный||Красный
 
|-
Поддержка радиоинтерфейса 433 МГц — опция, которую вы можете выбрать при покупке контроллера Wiren Board. На плате контроллера с поддержкой радиоинтерфейса распаян материнский разъем SMA (Sub-Miniature Version A), обозначеный "RF remote", на который накручивается ответный разъем антенны 433 МГц. При монтаже контроллера в металлическом щите антенну следует располагать за его пределами для обеспечения надежной радиосвязи.
|GND (земля)||GND||Чёрный||Чёрный||Желтый
 
|-
 
|DQ (DATA, данные)||1W||Синий||Жёлтый||Зелёный
== Системный сервис ==
 
[[File:WEB_ISM_Radio.png|250 px|thumb|left|Параметры сервиса wb-homa-ism-radio]]
За поддержку радиоинтерфейса отвечает служба ''wb-homa-ism-radio''. Она обслуживает драйвер радиомодуля, создает новые устройства, обновляет их состояния и передает команды управления.
Параметр '''rx raw''' обозначает количество принятых радиопакетов от любых устройств, '''rx noo''' — пакетов от устройств Noolite, '''rx oregon''' — от датчиков Oregon Scientific. При наличии заведомо работоспособных устройств, функционирующих на частоте 433 МГц в зоне прием контроллера, эти параметры увеличиваются со временем. Например, нажатие кнопок на брелоке автосигнализации должно увеличить счетчик  '''rx raw'''. При перезагрузке значения счетчиков обнуляются. Для распознанного оборудования в веб-интерфейсе создаются виртуальные устройства.
 
 
== Устройства ==
 
Радиомодуль контроллера Wiren Board поддерживает устройства различного типа: датчики температуры и влажности, релейные модули, пульты дистанционного управления, радиовыключатели и т.п. Для каждого поддерживаемого устройства в Web-интерфейсе контроллера создается соответствующее виртуальное устройство, а в очереди сообщений mqtt публикуются его параметры.
 
 
== Представление в Web-интерфейсе ==
 
{| class="wikitable "
|-
| [[File:1d20.png|250 px|thumb|left|]]
| [[File:149f.png|250 px|thumb|right|]]
|}
 
[[File:Noolite.png|300 px|thumb|right|]]
При обнаружении нового устройства создаются новые устройств в веб-интерфейсе а также новые mqtt-топики, описывающие состояние устройства.
 
Пример использования: для привязки релейного модуля nooLite к контроллеру выполните стандартную процедуру привязки релейного модуля к пульту, но вместо кнопки пульта нажмите кнопку '''bind''' в веб-интерфейсе.
После этого вы сможете отправлять команды на включение и выключение реле.
 
 
== Обновление драйвера до wb-homa-rfsniffer ==
 
Новая версия wb-homa-rfsniffer драйвера 433 МГц охватывает более широкий спектр устройств, функционирующих на частоте 443 МГц, но находится в стадии разработки. Для установки новой версии драйвера требуется удалить wb-homa-ism-radio совместная работа этих драйверов не поддерживается. В настоящий момент rfsniffer НЕ включает в себя полный функционал ism-radio: основное его назначение — получение данных с датчиков (управления из веб-интерфейса нет).
В настоящий момент поддерживаются протоколы:
 
*Oregon (V2 + V3)
*nooLite
*Livolo
*Raex
*RST
*Rubitek
*X10
*VHome
*EV1527
{| class="wikitable "
|-
| [[File:Rubitek.png|250 px|thumb|left|]]
| [[File:EV1527.png|250 px|thumb|right|]]
|}
|}
=== Подключение одного датчика по двум проводам ===
В некоторых случаях датчик можно подключить всего двумя проводами. Для этого нужно соединить контакты питания и земли датчика, и подключить их к земле контроллера. При таком подключении датчик будет брать питание с канала данных. '''Этот способ не рекомендуется''', так как при этом замедляется опрос датчиков, особенно если их несколько на одном порту контроллера: время тратится на зарядку внутренних емкостей датчиков напряжением от линии данных. Этот способ крайне не рекомендуется при одновременном подключении нескольких датчиков, так как тока с линии данных может не хватить для зарядки нескольких датчиков
=== Подключение нескольких датчиков на одну шину ===
'''Внимание! Одновременная надёжная работа двух и более датчиков гарантируется только при соблюдении описанных ниже условий.'''


Основной документ при проектировании шины - инструкция от разработчика 1-Wire [https://www.maximintegrated.com/en/app-notes/index.mvp/id/148 TUTORIAL 148: Guidelines for Reliable Long Line 1-Wire Networks]. Основные тезисы оттуда:
* Длина шины при подключении одного датчика может составлять 200 метров
* Если вы собираетесь подключать несколько датчиков, обязательно подключайте их к питанию 5В (не используйте двухпроводную схему подключения)
* Если вы прокладываете шину на несколько метров, или короткую, но в условиях повышенных помех (например, в щитке) - используйте витую пару, например, Cat 5, желательно экранированную
* Количество датчиков, которые можно подключить к одному мастеру (например, контроллеру Wiren Board), зависит как от длины шины, так и от её топологии
* Прокладка линии одной шиной лучше, чем прокладка звездой. При прокладке линии звездой надёжная работа не гарантируется


== Поддержка в ПО ==
Удаление wb-homa-ism-radio выполняется командой <code>apt-get remove wb-homa-ism-radio</code>. Установка новой версии — командой  <code>apt-get update && apt-get install wb-homa-rfsniffer</code>. Убедитесь, что новый драйвер запущен: <code>service wb-homa-rfsniffer status</code>.
[[File:Web-devices-1-wire.png|400px|thumb|Показания датчика и его уникальный идентификатор на странице ''Devices'' веб-интерфейса]]
 
После подключения значения с датчиков сразу появятся в [[Веб-интерфейс Wiren Board|веб-интерфейсе]]. Если к контроллеру подключены несколько датчиков, они будут различаться своими идентификаторами. (Идентификаторы установлены в датчики на заводе,они содержат тип устройства, номер и контрольную сумму.)
На боковой панели Web-интерфейса в разделе Configs появится доступ (пункт '''RFM69 Driver Configuration''') к настройкам драйвера, хранящимся в файле <code>/etc/wb-homa-rfsniffer.conf</code>.
Значения датчика транслируются в очередь сообщений [[MQTT]] драйвером [https://github.com/contactless/wb-homa-w1 wb-homa-w1].
 
[[Файл:1wire_mqtt.png|900px|thumb|center|MQTT-топик и идентификатор датчика в разделе ''Settings'' веб-интерфейса]]
 
== Поддержка в устаревших устройствах (Wiren Board 2.8) ==
== Настройки параметров rfsniffer ==
[[1-Wire в Wiren Board 2.8]]
 
[[File:Radio_Settings.png|450 px|thumb|left|]]
[[File:RFM69_mqtt_brocker.png|450 px|thumb|left|]]
[[File:RFM69_Device_Policies.png|450 px|thumb|left|]]
 
 
 
===Группа параметров настройки драйвера — '''Radio settings''' ===
 
*'''lirc_device''' — специальный файл символьного устройства; создается для работы с битовым потоком данных (прием/передача) RFM69; значение по умолчанию — /dev/lirc0. Не требует изменений.
*'''rfm_irq''' — номер прерывания от чипа RFM69. Не требует изменений.
*'''rssi''' — максимальный уровень чувствительности приемника в dBi (чем больше по модулю отрицательное значение — тем выше чувствительность, максимум: -120). С помощью этого параметра можно ограничить прием удаленных слабых сигналов от ненужного радиооборудования.
*'''spi_device''' — специальный файл устройства для коммуникации по SPI-шине микропроцессора контрроллера. Зависит от аппаратной модели контроллера. В Wiren Board 5 используется /dev/spidev32766.0 — шина 32766, chipselect — 0.
 
 
===Группа параметров настройки '''MQTT settings'''===
 
 
Параметр '''host''' определяет адрес mqtt-брокера, куда драйвер будет публиковать сообщения от радиоустройств. По умолчанию — localhost. Предполагается, что брокер принимает соединения на порту 1883.
 
 
 
 
===Группа параметров настройки '''Device politics'''===
 
Параметры этой группы определяют, каким образом будут обнаруживаться и использоваться новые устройства.  
 
*Список '''Known devices''' определяет, с какими устройствами будет работать драйвер, когда параметр '''use_devices_list''' установлен в значение true. Устройство имеет имя '''name''', политику отображения '''politics''' и интервал времени '''heartbeat''', по прошествии которого устройство считается неработоспособным, если от него не поступало сигналов. При значении этого параметра равного '''''-1''''' устройство считается работоспособным всегда.
*'''unknown_devices_politics''' — отображать ли ранее неизвестные радиоустройства
*'''use_devices_list''' — отображать ли устройства только из разрешенного списка
 
 
===Группа параметров настройки '''DEBUG settings'''===
 
Данная группа отвечает за ведение логов отладочной информации.  
 
*'''сonsole_level''' — уровень отладочной информации в консоли
*'''file_level''' — уровень отладочной информации в журнальном файле
*'''file_name''' —  путь к журнальному файлу драйвера (/run/wb-homa-rfsniffer.log)
*'''log_time''' — включать ли в отладочную информацию временные метки
*'''name''' — имя журнала
 
Возможно создание нескольких журнальных файлов с разными параметрами.
 
*'''save_path''' — путь к директории, в которой сохраняются файлы дампа радиокоманд и отладочной информации
 
 
===Группа параметров настройки '''Enabled features'''===
 
Эта группа параметров используется для поддержки передачи данных на устройства NooLite. В списке '''Adresses of transfering devices''' можно указывать адреса устройств-передатчиков.
 
Список '''Enabled protocols''' позволяет выбрать протоколы тех поддерживаемых устройств, которые планируется подключать к контроллеру.