Перейти к содержанию

Wiren-board-1-wire-sensors: различия между версиями

Материал из XIOT Wiki
Английские адреса Wiki: обновление ссылок с сохранением русских подписей
 
(не показаны 3 промежуточные версии этого же участника)
Строка 1: Строка 1:
__NOTOC__
{{DISPLAYTITLE:Подключение 1-Wire датчиков к контроллеру Wiren Board}}
Эта инструкция описывает подключение датчиков DS18B20 по шине 1-Wire к Wiren Board. Наличие штатного входа 1-Wire, обозначения клемм и поддерживаемые модули зависят от точной модели и ревизии контроллера. Перед монтажом откройте документацию именно своего устройства.


== 🧩 О шине 1-Wire ==
'''Результат:''' датчики получают отдельное питание, подключены к общей шине с подходящей топологией и стабильно отображаются в веб-интерфейсе Wiren Board.


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


Чаще всего используются температурные датчики DS18B20. Они недорогие, компактные и легко интегрируются в систему умного дома.
# Уточните модель и ревизию контроллера.
# По официальному руководству проверьте наличие штатного входа 1-Wire и расположение его клемм. Обычно используются обозначения '''1W''', '''GND''' и '''+5V''', но руководство точной модели имеет приоритет.
# Если подходящего штатного входа нет, выберите совместимый модуль или преобразователь 1-Wire по документации Wiren Board.
# Сверьте назначение проводов конкретного датчика: цветовая маркировка у разных производителей может отличаться.


== 📡 Особенности передачи сигнала ==
Не переносите схему подключения с другой модели Wiren Board без проверки: даже близкие варианты контроллеров могут иметь разный набор встроенных портов и модулей расширения.


* Работа осуществляется по двум проводам: '''DATA''' и '''GND'''.
== Подключите датчики по трёхпроводной схеме ==
* Поддерживается питание по отдельному проводу ('''VCC'''), либо паразитное питание через линию DATA.
* Встроенный подтягивающий резистор 3 кОм между DATA и +5V уже установлен в контроллерах Wiren Board.
* В ряде случаев (длинные линии, большое количество датчиков) может потребоваться замена этого резистора на внешний с номиналом 4,7 кОм.
* Шина крайне чувствительна к:
  * разветвлённой топологии (допустима только шина, без «звёзд»),
  * паразитной ёмкости кабеля,
  * длине линии (оптимально до 30 метров),
  * качеству соединений (рекомендуется пайка или клеммы, не скрутки).


== 🔌 Подключение к Wiren Board ==
Перед монтажом отключите питание контроллера и подключаемого оборудования.


Контроллеры Wiren Board (например, WB6, WB7, WB9) имеют встроенный порт 1-Wire:
# Соедините выводы '''GND''' датчиков с клеммой '''GND''' входа 1-Wire.
# Соедините выводы '''DATA''' датчиков с клеммой '''1W'''.
# Соедините выводы питания датчиков с клеммой '''+5V'''.
# Проверьте полярность и отсутствие короткого замыкания, затем подайте питание.


* '''1W-DATA''' — сигнальный провод;
Для одного или нескольких датчиков используйте трёхпроводное подключение '''+5V / GND / DATA'''. Двухпроводный режим с паразитным питанием не рекомендуется, особенно для нескольких датчиков.
* '''1W-GND''' — земля;
* '''+5V''' — питание для датчиков.


Подключение выполняется следующим образом:
На штатном входе 1-Wire контроллера Wiren Board уже установлен подтягивающий резистор 3 кОм. В обычной схеме внешний подтягивающий резистор не нужен. Не заменяйте встроенную подтяжку и не добавляйте параллельный резистор без требования руководства точной модели или расчёта специалиста.


# Все выводы '''GND''' от датчиков соединяются с 1W-GND.
== Проложите линию 1-Wire ==
# Все выводы '''DATA''' соединяются с 1W-DATA.
# Питание (VCC) подключается к +5V на контроллере, если не используется паразитный режим.


== 🧵 Правильная прокладка кабеля ==
* Используйте качественную медную витую пару, например Cat 5e.
* Ведите '''DATA''' вместе с '''GND''' в одной витой паре. Для питания используйте другую пару.
* Предпочитайте линейную магистраль с короткими ответвлениями. Топология «звезда» не рекомендуется: отражения сигнала на длинных ответвлениях снижают надёжность.
* Не прокладывайте сигнальную линию рядом с силовыми кабелями и источниками помех.
* Выполняйте соединения клеммами или пайкой и защищайте их от влаги; не оставляйте ненадёжные скрутки.


* Используйте витую пару — например, кабель UTP 5e.
У 1-Wire нет одного гарантированного предела длины для всех объектов. Работоспособность зависит от кабеля, топологии, числа датчиков и суммарной ёмкости. В официальных рекомендациях Wiren Board суммарная ёмкостная нагрузка линии ограничена значением '''5 нФ'''. Проектируйте протяжённую сеть по этому параметру и проверяйте её на объекте, а не по универсальному правилу «до 30 метров».
* Рекомендуем DATA + GND в одной паре, VCC + GND — в другой.
* Не используйте тройники, скрутки и ответвления.
* Прокладывайте кабель вдали от силовых линий.
* При монтаже более 5 датчиков на одной линии используйте пониженную скорость или внешний адаптер.


== ✅ Проверка подключения через веб-интерфейс ==
== Проверьте датчики в Wiren Board ==


После физического подключения:
# Откройте веб-интерфейс контроллера из доверенной локальной сети.
# Убедитесь, что служба и драйвер 1-Wire включены согласно руководству вашей версии ПО Wiren Board.
# Откройте раздел устройств и найдите обнаруженные датчики. DS18B20 определяется по уникальному адресу, который обычно начинается с <code>28-</code>.
# Сравните показания с ожидаемой температурой и наблюдайте за ними несколько минут.
# Поочерёдно прогрейте или охладите каждый датчик, чтобы подписать его адрес без путаницы.


# Перейдите в веб-интерфейс контроллера по IP-адресу (например, http://192.168.1.10).
Не переходите к настройке XIOT, пока все датчики не работают стабильно непосредственно в Wiren Board. Общий маршрут подготовки контроллера описан в статье [[Wiren-board-connection|Подключение Wiren Board]].
# Откройте раздел '''Devices''' (Устройства).
# Найдите блок '''1-Wire Devices'''.
# Все подключённые датчики появятся автоматически со своими уникальными идентификаторами (например, 28-00000xxxxxxx).
# Убедитесь, что отображается текущая температура.


'''Важно:''' если датчики не отображаются — проверьте надёжность соединений, целостность линии и при необходимости установите внешний резистор 4,7 кОм между DATA и +5V.
== Если датчик не обнаружен или пропадает ==


== ⚠️ Типичные ошибки ==
# Снова отключите питание и проверьте назначение '''+5V''', '''GND''' и '''DATA''' по документации датчика и контроллера.
# Проверьте напряжение питания, контакты, целостность кабеля и отсутствие короткого замыкания.
# Временно подключите один датчик коротким кабелем рядом с контроллером. Если он работает, последовательно возвращайте участки линии и остальные датчики.
# Уберите длинные ответвления и топологию «звезда», оцените суммарную ёмкость кабеля.
# Проверьте журнал драйвера 1-Wire и наличие повторяющихся ошибок чтения.
# Не устанавливайте внешний резистор наугад. Если штатная схема не работает после проверки линии, обратитесь к руководству точной модели или в [[Support|техническую поддержку]].


* '''Нет данных от датчика:'''
== Официальная документация ==
  * перепутаны провода (DATA и GND);
  * плохой контакт;
  * отсутствие необходимого подтягивающего резистора при нестандартной топологии.
* '''Ошибки чтения:'''
  * кабель слишком длинный;
  * есть разветвления;
  * используется паразитное питание.
* '''Периодическое пропадание датчиков:'''
  * слабое питание;
  * наводки от силовых кабелей;
  * плохая пайка или скрутки.


== 📘 Заключение ==
* [https://wiki.wirenboard.com/wiki/1-Wire Общие рекомендации Wiren Board по сети 1-Wire]
* [https://wiki.wirenboard.com/wiki/Wbincludes:1-Wire_Network Схема подключения сети 1-Wire]
* [https://wirenboard.com/en/product/1wire-DS18B20/ Датчик температуры DS18B20]


1-Wire — удобный и экономичный интерфейс для подключения цифровых датчиков к Wiren Board. При соблюдении рекомендаций по монтажу и топологии система работает стабильно. Встроенный резистор подтяжки присутствует, но в некоторых случаях может потребоваться замена на другой номинал для повышения надёжности.
Сначала выполните [[Wiren-board-basic-setup|Базовая настройка Wiren Board]], затем проверьте физические датчики и только после этого связывайте их адреса с устройствами XIOT.
 
[[Категория:Документация XIOT]]
[[Категория:Драйверы XIOT]]
{{DEFAULTSORT:Подключение 1-Wire датчиков к контроллеру Wiren Board}}

Текущая версия от 22:16, 2 октября 2026

Эта инструкция описывает подключение датчиков DS18B20 по шине 1-Wire к Wiren Board. Наличие штатного входа 1-Wire, обозначения клемм и поддерживаемые модули зависят от точной модели и ревизии контроллера. Перед монтажом откройте документацию именно своего устройства.

Результат: датчики получают отдельное питание, подключены к общей шине с подходящей топологией и стабильно отображаются в веб-интерфейсе Wiren Board.

Проверьте совместимость оборудования

  1. Уточните модель и ревизию контроллера.
  2. По официальному руководству проверьте наличие штатного входа 1-Wire и расположение его клемм. Обычно используются обозначения 1W, GND и +5V, но руководство точной модели имеет приоритет.
  3. Если подходящего штатного входа нет, выберите совместимый модуль или преобразователь 1-Wire по документации Wiren Board.
  4. Сверьте назначение проводов конкретного датчика: цветовая маркировка у разных производителей может отличаться.

Не переносите схему подключения с другой модели Wiren Board без проверки: даже близкие варианты контроллеров могут иметь разный набор встроенных портов и модулей расширения.

Подключите датчики по трёхпроводной схеме

Перед монтажом отключите питание контроллера и подключаемого оборудования.

  1. Соедините выводы GND датчиков с клеммой GND входа 1-Wire.
  2. Соедините выводы DATA датчиков с клеммой 1W.
  3. Соедините выводы питания датчиков с клеммой +5V.
  4. Проверьте полярность и отсутствие короткого замыкания, затем подайте питание.

Для одного или нескольких датчиков используйте трёхпроводное подключение +5V / GND / DATA. Двухпроводный режим с паразитным питанием не рекомендуется, особенно для нескольких датчиков.

На штатном входе 1-Wire контроллера Wiren Board уже установлен подтягивающий резистор 3 кОм. В обычной схеме внешний подтягивающий резистор не нужен. Не заменяйте встроенную подтяжку и не добавляйте параллельный резистор без требования руководства точной модели или расчёта специалиста.

Проложите линию 1-Wire

  • Используйте качественную медную витую пару, например Cat 5e.
  • Ведите DATA вместе с GND в одной витой паре. Для питания используйте другую пару.
  • Предпочитайте линейную магистраль с короткими ответвлениями. Топология «звезда» не рекомендуется: отражения сигнала на длинных ответвлениях снижают надёжность.
  • Не прокладывайте сигнальную линию рядом с силовыми кабелями и источниками помех.
  • Выполняйте соединения клеммами или пайкой и защищайте их от влаги; не оставляйте ненадёжные скрутки.

У 1-Wire нет одного гарантированного предела длины для всех объектов. Работоспособность зависит от кабеля, топологии, числа датчиков и суммарной ёмкости. В официальных рекомендациях Wiren Board суммарная ёмкостная нагрузка линии ограничена значением 5 нФ. Проектируйте протяжённую сеть по этому параметру и проверяйте её на объекте, а не по универсальному правилу «до 30 метров».

Проверьте датчики в Wiren Board

  1. Откройте веб-интерфейс контроллера из доверенной локальной сети.
  2. Убедитесь, что служба и драйвер 1-Wire включены согласно руководству вашей версии ПО Wiren Board.
  3. Откройте раздел устройств и найдите обнаруженные датчики. DS18B20 определяется по уникальному адресу, который обычно начинается с 28-.
  4. Сравните показания с ожидаемой температурой и наблюдайте за ними несколько минут.
  5. Поочерёдно прогрейте или охладите каждый датчик, чтобы подписать его адрес без путаницы.

Не переходите к настройке XIOT, пока все датчики не работают стабильно непосредственно в Wiren Board. Общий маршрут подготовки контроллера описан в статье Подключение Wiren Board.

Если датчик не обнаружен или пропадает

  1. Снова отключите питание и проверьте назначение +5V, GND и DATA по документации датчика и контроллера.
  2. Проверьте напряжение питания, контакты, целостность кабеля и отсутствие короткого замыкания.
  3. Временно подключите один датчик коротким кабелем рядом с контроллером. Если он работает, последовательно возвращайте участки линии и остальные датчики.
  4. Уберите длинные ответвления и топологию «звезда», оцените суммарную ёмкость кабеля.
  5. Проверьте журнал драйвера 1-Wire и наличие повторяющихся ошибок чтения.
  6. Не устанавливайте внешний резистор наугад. Если штатная схема не работает после проверки линии, обратитесь к руководству точной модели или в техническую поддержку.

Официальная документация

Сначала выполните Базовая настройка Wiren Board, затем проверьте физические датчики и только после этого связывайте их адреса с устройствами XIOT.