Форматирование виртуального устройства
Jump to navigation
Jump to search
Пример описания в XML
1<item addr="100:245" back-rgba="0xff7100ff" iw-="1" length="5" name="aa" prf="prf('A: %d\10B: %ds dhjhfg hdfj dfhdfh', device(100, 247).status(0) $ 7, status(1))" sub-type="prf" text-rgb="0xffffff" title-rgb="0xff00" type="virtual"/>
Параметры
Название | Тип и диапазон | Описание |
---|---|---|
iw | число; 1, 2, 3.. |
Ширина текстового поля |
back-rgba | число; 0xRRGGBBAA |
Настройка фона текстового поля. RR – насыщенность красного, 0..0хFF; GG – насыщенность зеленого, 0..0xFF; BB – насыщенность синего, 0..0xFF; AA – насыщенность фона, 0..0xFF |
text-rgb | число; 0xRRGGBB |
Настройка цвета текста. RR – насыщенность красного, 0..0хFF; GG – насыщенность зеленого, 0..0xFF; BB – насыщенность синего, 0..0xFF. |
title-rgb | число; 0xRRGGBB |
RR – насыщенность красного, 0..0хFF; GG – насыщенность зеленого, 0..0xFF; BB – насыщенность синего, 0..0xFF |
prf | строка; | Описание статуса устройства. Статус имеет формат sprintf. Размер статуса не должен превышать 256 байт. В устройстве хранятся только указанные данные, текст не сохраняется в статус. Подробное описание ниже. |
описание атрибута prf
prf="prf('TEXT %[flags][wigth][.precision]type', STATUS)"
- TEXT – отображаемый неизменяемый текст;
- flags, with, precision, type — описание форматирования статуса, см. sprintf.
- STATUS – описание статуса
- id() – идентификатор устройства, u16
- subId() — subId устройства, u8
- addr() — адрес устройства, u32
- addrString() – текстовый адрес устройства
- statusStringHex() – строка состояния устройства в шестнадцатеричном виде.
- statusString() – строка со статусом устройства
- statusString(u32 byteOffset = 0) – строка со статусом устройства со смещением byteOffset
- statusString(u32 byteOffset=0, u32 len=0) – строка со статусом устройства со смещением byteOffset и длиной len
- status() — статус устройства, i8
- status(u32 byteOffset = 0) — статус устройства со смещением byteOffset, i8
- statusU() — статус устройства, u8
- statusBit1Count() – количество бит состояния(?)
- statusRgb() — статус RGB, 0xRRGGBB
- statusU16(u32 byteOffset=0) – статус устройства, u16
- statusU32(u32 byteOffset=0) – статус устройства, u32
- statusBit(u32 byteOffset=0, u32 bitOffset=0) – состояние бита состояния со смещением bitOffset, с байтовым смещением byteOffset,
- statusBit(u32 bitOffset=0) – состояние бита состояния со смещением bitOffset
- statusBits(u32 byteOffset=0, u32 bitOffset=0, u32 len=0) – статус бита len, начиная с bitOffset байта byteOffset
- statusBits(u32 bitOffset=0, u32 len=0) – статус бита len, начиная с bitOffset
- statusFloat() — дробный статус (status/250)
- statusFloat() – беззнаковая дробная часть состояния (status/250)
- statusFloat2(u32 byteOffset=0) – статус дробный (status/256)
- statusFloat2U(u32 byteOffset=0) – беззнаковая дробь состояния (status/256) со смещением byteOffset
- statusFloat(u32 byteOffset=0) – дробный статус (status/250) со смещением byteOffset
- statusLevel() — уровень (например, диммер)
- statusFloatString() – строка с дробным статусом (status/250)
- statusFloatString(u32 byteOffset = 0) — строка с дробным статусом (status/250) со смещением byteOffset
- statusFloatString2() – строка с дробным статусом (status/256)
- statusFloatString2(u32 byteOffset=0) – строка с дробным статусом (status/256) со смещением byteOffset
Также можно указать условия, например:
prf=" prf('Text%s', status(0)?'Yes':'No')
если статус (0) равен true, будет отображаться "Text Yes", в противном случае отображается "Text No"
Или получить статус устройств. Например, есть штора 343:22 и лампа 299:1:
1prf="string a[] ={'Closed', 'Open', 'Is closing', 'Is opening'}; prf('Curtain%s\10Data %d \10Status: %s\10 String%s',a[device(343:22)->status(0)], status(0), (device(299:21)->status(0) $7)?'On':'Off',statusString(1))"
Установка статуса для такого элемента следующая: setStatus(299:201,{134,"Text"});
После установки статуса в текстовом поле будет отображаться следующее:
"Curtain is opening Data 134 Status On String Text"
"Curtain" будет зависеть от статуса шторы,
Статус будет "Off", если 0 байт с маской 7 статуса 299:21 равен нулю, иначе Статус будет "On"