Awtrix 3 (Awtrix Light)

Интегрирует ваш Awtrix 3 через HTTP

Текущий релиз
4.0.0
Разработчик
Matthias Kleine
Лицензия
MIT

Требования

  • Node.js 22 (или более новая версия)
  • js-controller 6.0.11 (или более новая версия)
  • Административный адаптер 7.6.20 (или более новая версия)
  • Устройство Awtrix 3 с версией прошивки 0.98 (или новее) — например, Ulanzi TC001.

Купить можно здесь: Aliexpress.com , здесь: Amazon.de или здесь: ulanzi.de (партнерские ссылки)

Первые шаги

  1. Прошейте микропрограмму на устройство и добавьте его в локальную сеть через Wi-Fi — см. документацию.
  2. Установите адаптер awtrix-light в ioBroker (и создайте новый экземпляр).
  3. Откройте конфигурацию экземпляра и введите IP-адрес устройства в локальной сети.

Часто задаваемые вопросы (FAQ)

Можно ли использовать адаптер для отключения приложений по умолчанию (например, для отображения уровня заряда батареи или данных с датчиков)?

Нет, эта функция была удалена из прошивки awtrix-light. Используйте меню самого устройства, чтобы навсегда скрыть эти приложения.

Можно ли заменить логические значения (истина/ложь) другим текстом?

Просто создайте псевдоним вalias.0 типаstring (строка) и преобразуйте логическое значение в любое другое значение, используя функцию чтения (например)val ? 'offen' : 'geschlossen' Это стандартная функция ioBroker и не имеет прямого отношения к данному адаптеру.

Как мне перейти на последнюю версию прошивки?

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

Устройство нагревается во время зарядки.

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

Можно ли извлечь батарею из устройства?

Да, это возможно. Однако устройство нужно будет вскрыть с помощью термофена, так как передняя панель приклеена. Кроме того, для корректной работы всего необходимо припаять понижающий преобразователь .

Можно ли изменить порядок приложений на устройстве?

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

Для определения пользовательских позиций можно активировать функцию определения позиций пользователем в настройках экспертного режима. После этого каждому приложению можно присвоить числовое значение.

Можно ли указать другой формат чисел?

Все состояния типа number (common.type)number Данные форматируются в соответствии с конфигурацией в ioBroker. Формат системы по умолчанию можно изменить с помощью экспертных настроек (начиная с версии адаптера 0.7.1). Числа могут отображаться в следующих форматах:

  • Системный стандарт
  • xx.xxx,xx
  • xx,xxx.xx (Формат США)
  • xxxxx,xx
  • xxxxx.xx (Формат США)

Можно ли ограничить доступ к веб-интерфейсу awtrix-light?

Да, начиная с версии прошивки 0.82, доступ можно защитить с помощью имени пользователя и пароля. Начиная с версии адаптера 0.8.0, эти пользовательские данные также можно хранить в настройках экземпляра.

Как работает функция удержания уведомлений?

Если уведомление содержит опциюhold: true После отправки текст остается на экране до тех пор, пока уведомление не будет подтверждено. Это можно сделать либо с помощью средней кнопки на устройстве, либо изменив статус.notification.dismiss наtrue установлено.

Некоторые изменения состояния отображаются не сразу.

Если состояние изменяется очень часто (например, каждую секунду), некоторые изменения игнорируются и не передаются, чтобы минимизировать нагрузку на устройство. Для этой цели каждое приложение использует собственное «время блокировки», которое можно настроить глобально в параметрах экземпляра. Время по умолчанию составляет 3 секунды. Установка значения меньше 3 не рекомендуется.

Идентичные приложения на нескольких устройствах

Если необходимо управлять несколькими устройствами awtrix-light с помощью одного и того же приложения, для каждого устройства необходимо создать отдельный экземпляр. Однако в настройках экземпляра дополнительных устройств можно указать, что приложения должны наследоваться от другого экземпляра.

Пример

  1. Настройте все необходимые приложения в экземпляре.awtrix-light.0
  2. Создайте еще один экземпляр для второго устройства (awtrix-light.1 )
  3. Выбиратьawtrix-light.0 в настройках экземпляраawtrix-light.1 чтобы отобразить те же приложения на втором устройстве

Начиная с версии 0.15.0 (и более поздних версий), видимость пользовательских приложений и всего содержимого экспертных приложений также передается на другие устройства, которые копируют настройки приложения. В приведенном выше примере, например, копируются приложения экземпляра.awtrix-light.1 Также скрывается, когда видимость приложения снижается в основном экземпляре.awtrix-light.0 Это будет изменено. То же самое относится ко всему контенту в приложениях для экспертов.

Blockly и JavaScript

sendTo / messagebox можно использовать для

  • Отобразить одноразовое уведомление (с текстом, звуком, символом и т. д.).
  • воспроизводить звук

Уведомления

Отправить одноразовое уведомление на устройство:

sendTo('awtrix-light.0', 'notification', { text: 'haus-automatisierung.com', repeat: 1, stack: true, wakeup: true, hold: false }, (res) => {
    if (res && res.error) {
        console.error(res.error);
    }
});

Объект сообщения поддерживает все параметры, доступные в микропрограмме. Подробности см. в документации .

Кроме того, для создания уведомления можно использовать блок Blockly (не все доступные там опции).

тона

Звуковые файлы должны быть в формате RTTTL и находиться в папке MELODIES. Расширение файла для этих звуков — .txt. Расширение файла не должно указываться при воспроизведении звуков!

Для использования (ранее созданного) аудиофайлаbeispiel.txt играть:

sendTo('awtrix-light.0', 'sound', { sound: 'beispiel' }, (res) => {
    if (res && res.error) {
        console.error(res.error);
    }
});

Объект сообщения поддерживает все параметры, доступные в микропрограмме. Подробности см. в документации .

Для упрощения этого вызова можно использовать блок Blockly.

Чтобы воспроизвести свой собственный рингтон:

sendTo('awtrix-light.0', 'rtttl', 'Beep: d=32,o=7,b=120: a,P,c#', (res) => {
    if (res && res.error) {
        console.error(res.error);
    }
});

Приложения

Названия приложений должны состоять только из строчных букв (az) и быть уникальными. Не допускаются цифры, специальные символы и пробелы.

Следующие названия приложений зарезервированы для внутренних приложений и не могут быть использованы:Time ,Date ,Temperature ,Humidity ,Battery .

  • Сactivate -Состояние каждого приложения позволяет вывести его на передний план.
  • Эти условия играют свою роль.button и разрешать только логические значения.true (Другие значения приведут к предупреждению в журнале)

Каждое самостоятельно созданное приложение имеет состояние с идентификатором.apps.<name>.visible Если это условие возникнетfalse Если эта настройка указана неверно, приложение будет удалено с устройства и больше не будет отображаться. Это полезно для ограничения работы определенных приложений только в дневное время или в определенные периоды времени.

Пользовательские приложения

  • %s является заполнителем для значения состояния.
  • %u является заполнителем для обозначения единицы измерения государства (например,°C )

Эти заполнители можно использовать в тексте пользовательских приложений (например,Außentemperatur: %s %u ).

Пользовательские приложения отображают только проверенные значения! Управляйте значениями с помощьюack: false Эти запросы будут проигнорированы (во избежание повторных запросов к устройству и для обеспечения корректности отображаемых значений)!

Выбранное состояние должно иметь строковый тип данных.string или числоnumber быть. Другие типы (например)boolean Они также поддерживаются, но генерируют предупреждения. Рекомендуется использовать псевдоним с функцией преобразования для замены логических значений текстом (например,val ? 'an' : 'aus' илиval ? 'offen' : 'geschlossen' Подробности см. в документации ioBroker. Эта стандартная функция не связана с адаптером.

Следующие комбинации приведут к появлению предупреждения в журнале:

  • В пользовательском приложении с выбранным идентификатором объекта отсутствует заполнитель.%s в тексте
  • Создается пользовательское приложение с выбранным идентификатором объекта без указания модуля.common.unit создан, но%u содержится в тексте
  • Идентификатор объекта не выбран, но%s используется в тексте

Исторические приложения / Графики

ЧТО СДЕЛАТЬ

На графиках отображаются только подтвержденные значения. Контрольные значения сack: false Эти сообщения будут отфильтрованы и проигнорированы!

Экспертные приложения

Экспертные приложения доступны начиная с версии адаптера 0.10.0. Эти приложения позволяют вручную устанавливать все значения через состояния и управлять ими с помощью собственной логики. Чтобы создать новое экспертное приложение:

  • Откройте вкладку «Экспертные параметры» в настройках экземпляра.
  • Создайте новое приложение для экспертов с именем на ваш выбор (например,test )
  • Сохраните настройки экземпляра.

После этого отобразятся все управляемые состояния приложения.test подawtrix-light.0.apps.test создано. Чтобы изменить соответствующие значения приложения, просто измените значение состояний.icon ,text , и т. д. можно установить с помощью пользовательских скриптов (например, JavaScript или Blockly).

Пример: приложение погоды

Основные объекты

Требуется адаптер версии 2.0.0 (и новее).

Базовый объект представляет собой фундаментальное определение для приложения Awtrix, позволяющее устанавливать все существующие параметры. Базовый объект расширяется всеми остальными атрибутами экспертного приложения.

Пример: Вы хотите использовать эффект радуги в приложении для экспертов, но нет предопределенной точки данных для непосредственного использования этой функции. В этом случае атрибут можно определить в базовом объекте (в формате JSON):{ "rainbow": true } .

См. документацию для получения информации обо всех доступных атрибутах.

Скрыть нативные приложения

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

Changelog

4.0.0 (2026-07-30)

  • (@Brainbug01) Added option/setting for global overlay
  • (copilot) Adapter requires node.js >= 22 now
  • (@klein0r) admin 7.6.20 and js-controller 6.0.11 (or later) are required
  • (@klein0r) Acknowledge new values of buttons (for admin ui)
  • (@klein0r) Fixed state object role definitions

3.0.0 (2025-10-21)

  • (@klein0r) admin 7.6.17 and js-controller 6.0.11 (or later) are required

2.0.0 (2025-05-02)

  • (@klein0r) Added base object for expert apps to allow all options
  • (@klein0r) Added responsive design for admin config

1.7.0 (2025-04-08)

  • (@klein0r) Improved error handling when adapter is not ready (starting)
  • (@klein0r) Added scroll speed to expert apps
  • (@klein0r) Added icons for custom apps in object tree

1.6.0 (2025-01-27)

Updated recommended firmware version to 0.98

  • (@klein0r) Updated dependencies

License

MIT License

Copyright (c) 2026 Matthias Kleine info@haus-automatisierung.com

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.