air-Q

Содержание

• О
• Начиная
• Лицензия

О

Этот адаптер ioBroker используется в сочетании с нашим устройством air-Q . Он опрашивает значения с наших датчиков и отображает их в среде ioBroker.

Начиная

iobroker add air-q

iobroker install air-q

Для получения более подробной информации посетите документацию по CLI ioBroker по адресу https://github.com/ioBroker/ioBroker/wiki/Console-commands .

Конфигурация

Как найти ваше устройство air-Q

Адаптер может автоматически обнаруживать устройства air-Q в вашей локальной сети с помощью mDNS (Bonjour). При открытии настроек экземпляра выпадающий список «Сканировать сеть» выполнит поиск устройств (примерно 10 секунд) и отобразит список всех найденных устройств air-Q по имени. Выберите ваше устройство, и короткий идентификатор и IP-адрес будут заполнены автоматически.

Если устройства не обнаружены , возможно, ваш маршрутизатор блокирует mDNS-трафик между устройствами (это часто встречается в ячеистых сетях, гостевых сетях или корпоративных конфигурациях). В этом случае установите флажок «Подключиться по IP» и введите IP-адрес устройства вручную. IP-адрес можно найти в приложении air-Q для смартфона или в списке устройств вашего маршрутизатора.

Вы также можете настроить адаптер через ioBroker.discovery : запустите сканирование сети с помощью адаптера обнаружения, и устройства air-Q будут обнаружены автоматически через DNS или HTTP.

Варианты подключения

• Сканирование сети : Автоматически обнаруживает устройства air-Q через mDNS. Выберите устройство, чтобы автоматически заполнить короткий идентификатор и IP-адрес.
• Подключение по IP : Подключайтесь напрямую, используя IP-адрес устройства. Используйте этот вариант, если обнаружение mDNS не работает в вашей сети.
• Краткий идентификатор : первые 5 символов серийного номера вашего устройства. Используется для поиска mDNS, если флажок «Подключиться по IP» снят.
• Пароль устройства : Пароль вашего устройства air-Q.

Необязательный

• Учитывать ночной режим устройства . По умолчанию:on Если на вашем устройстве air-Q включен ночной режим, но Wi-Fi отключен в ночное время, адаптер может автоматически пропускать попытки опроса в эти часы. Это исключает ненужные ошибки подключения в ваших журналах. ⚠️ Если вы измените настройки ночного режима на вашем устройстве (время начала/окончания, включение/выключение), у вас есть два варианта:

  1. (Рекомендуется): Перезагрузите адаптер, чтобы немедленно загрузить новую конфигурацию.
  2. (Автоматический режим): Подождите до 1 часа, пока адаптер автоматически обновит конфигурацию (работает только вне ночного режима).

• Отсечь отрицательные значения . По умолчанию:off Для целей базовой калибровки некоторые значения датчиков могут кратковременно становиться отрицательными. Такие значения можно безопасно обнулить.

• Опрашивать данные каждые x секунд . По умолчанию:10 Вы можете настроить частоту опроса данных, введя число в секундах.

• Получить тип данных . По умолчанию:Average data В конфигурации по умолчанию air-Q усредняет поток показаний датчика. Этот адаптер позволяет переключаться между опросом усредненных и необработанных данных с устройства. Для опроса зашумленных показаний датчика с устройства выберитеRealtime data из выпадающего меню.

Теперь всё должно быть готово, и вы можете начинать работу!

Датчики — это объекты.

Данные будут получены и отображены на вкладке «Объекты» в соответствии с вашей конфигурацией после обнаружения устройства. Конечно, в зависимости от вашего устройства может отображаться больше датчиков.

На данный момент все датчики для Air-Q Pro включены. Дополнительные датчики будут добавлены в одном из будущих обновлений.

Changelog

1.2.0

• Network discovery: air-Q devices on the local network are now automatically discovered via mDNS. Select a device from the dropdown and the Short ID and IP are filled in automatically.
• Admin UI modernized: Migrated from Materialize HTML to jsonConfig (declarative JSON). Settings are now organized in two tabs: Connection and Data Retrieval.
• ioBroker.discovery integration: Fixed the detection file to correctly populate adapter config fields, call the discovery callback, and distinguish multiple air-Q devices. Added HTTP /ping fallback for networks without reverse DNS.
• Troubleshooting guidance: The admin UI now explains what to do when mDNS doesn't work (router blocking, how to find the device IP).

1.1.0

• Added support for 19 new sensors: acetaldehyde (C₂H₄O), arsine (AsH₃), bromine (Br₂), methanethiol (CH₄S), chlorine dioxide (ClO₂), carbon disulfide (CS₂), ethylene (C₂H₄), fluorine (F₂), temperature in Farenheit, hydrochloric acid (HCl), hydrogen cyanide (HCN), hydrogen fluoride (HF), hydrogen peroxide (H₂O₂), mold protection, phosphine (PH₃), refrigerant R-32, refrigerant R-454B, refrigerant R-454C, silane (SiH₄)

1.0.7

• Missing (e.g. warming up) sensors are skipped gracefully
• Fixed incorrect translations
• Refactor redundant methods

1.0.6

• The adapter can automatically respect your air-Q device's night mode configuration

1.0.5

• Fixed sensors dropping custom configuration after a restart
• Updated dependencies: version bump for adapter-core

1.0.4

• Updated dependencies: bumped multiple packages (chai-as-promised, sinon, mocha) to address vulnerabilities
• Codebase maintenance: updated io-package.json and added tests against Node.js 22

1.0.3

• Added a checkbox for showing and hiding the password in the instance configuration
• Edited the error messages to be more helpful
• Added logging information when the air-Q device is actually connected

1.0.2

• Added units for each sensor value
• Updates within config files

1.0.1

• Added sensor list update when connecting to a different air-Q in the same instance
• Fixed name display and update of device

1.0.0

• Include typescript files by @pr0crstntr in #6
• Created air-Q class by @pr0crstntr in #4
• Fix restart bug by @pr0crstntr in #7
• Update data poll by @pr0crstntr in #8
• Updated io-package by @pr0crstntr in #9
• Fixed save option for configuration by @pr0crstntr in #16
• Added clear intervals on unload by @pr0crstntr in #26
• Update README by @pr0crstntr in #37
• Changed role for temperature and added unit by @pr0crstntr in #38

0.0.1

• (Katharina K.) initial release

License

MIT License

Copyright (c) 2024-2026 Corant GmbH

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.