WebHMI Internal Registers
The following internal registers are available in WebHMI (for version 1.5 and higher):
Содержание
- 1 Cx - Communication registers
- 2 CDxxx - Connection Disabled registers
- 3 Dxxx - Data registers
- 4 DSxxx - Data static registers
- 5 Tx - Time registers
- 6 Hx - Hardware-related registers
- 7 B0 - Sound alert register
- 8 DOx - Digital Output registers
- 9 Ixxx - Intervals
- 10 Rxxx - Random values
- 11 Lx - Linux-related registers
- 12 Exxx.xxx - Event registers
- 13 ESxxx - Event State
- 14 ELxxx - Event Length
- 15 Sxxx - String
- 16 TRxxx - Title of recipe
- 17 WCxxx - Weather Condition registers
- 18 WFxxx - Weather Forecast registers
- 19 WSxxx - Sunset/Sunrize registers
Cx - Communication registers
The presence of communication errors on different connections
| Register | Description | Units | Data type | Read/Write |
| C0 | The presence of communication errors in any of the connections. 0 means there is no communication error. A positive number indicates the connection number in which there is a communication error. | Connection number | Word, Unsigned Int | Read/- |
| C1 | The presence of a communication error in connection with ID = 1. 0 means there are no errors. A positive number means a register ID that can not be read. | Register number | Word, Unsigned Int | Read/- |
| C2 | The presence of a communication error in connection with ID = 2. 0 means there are no errors. A positive number means a register ID that can not be read. | Register number | Word, Unsigned Int | Read/- |
| ... | ... | ... | ... |
CDxxx - Connection Disabled registers
Connection status - enabled / disabled. This register allows you to see whether the exchange is disabled for a specific connection. If the exchange is disabled, the system will return 1. If the exchange is not disabled, it will return 0. Recording to these registers allows you to enable / disable the exchange on the desired connection. To disable the exchange, you need to write 1 to the appropriate register.
| Register | Description | Data type | Read/Write |
| CD1 | Exchange turned on connection with ID = 1. | Bit | Read/Write |
| CD2 | Exchange turned on connection with ID = 2. | Bit | Read/Write |
| CD3 | Exchange turned on connection with ID = 3. | Bit | Read/Write |
| ... | ... | ... |
Dxxx - Data registers
| Register | Описание | Units | Data type | Read/Write | ||
| D0 | A common register for user needs. | Bit, Byte, Word, Double Word | Read/Write | |||
| ... | ||||||
| D1999 | A common register for user needs. | Bit, Byte, Word, Double Word | Read/Write | |||
The data in these registers are NOT stored after the reboot.
The user can access 2000 bytes of RAM. The register address is the address of the beginning of the fragment in the memory block.
В зависимости от выбранного типа данных на один регистр приходится разное количество байт. Так, можно обращаться к регистру с адресом D12 как к байту. В этом случае будет обращение к одному байту в памяти. Если обратится к регистру с адресом D12 как к слову (Word) то физически будет обращение к двум байтам с адресами D12 и D13 из которых будет составлено слово. Таким образом можно обращаться к отдельным байтам в нужном слове или двойном слове. Система не проверяет адреса регистров на пересечения или наложения. Этот контроль должен быть выполнен пользователем.
DSxxx - Data static registers
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write | ||
| DS0 | Энергонезависимый регистр для нужд пользователей. | Byte, Word, Double Word | Read/Write | |||
| ... | ||||||
| DS1999 | Энергонезависимый регистр для нужд пользователей. | Byte, Word, Double Word | Read/Write | |||
Данные в этих регистрах после перезагрузки СОХРАНЯЮТСЯ. Пользователю доступны 2000 байт в энергонезависимой памяти. Адрес регистра - это адрес начала фрагмента в блоке памяти.
В зависимости от выбранного типа данных на один регистр приходится разное количество байт. Так, можно обращаться к регистру с адресом DS12 как к байту. В этом случае будет обращение к одному байту в памяти. Если обратится к регистру с адресом DS12 как к слову (Word) то физически будет обращение к двум байтам с адресами DS12 и DS13 из которых и будет составлено слово. Таким образом можно обращаться к отдельным байтам в нужном слове или двойном слове. Система не проверяет адреса регистров на пересечения или наложения. Этот контроль должен быть выполнен пользователем.
Энергонезависимая память реализована в аппаратной платформа ревизии V5.34 и выше.
Tx - Time registers
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write |
| T0 | Текущее время | Секунды | [UnixTime] | Read/- |
| T1 | Время, затраченное на обмен данными со всеми регистрами в предыдущем цикле. | Милисекунды | Double Word, Unsigned Int | Read/- |
| T2 | Время, затраченное на обмен данными, обработку всех событий, сценариев, записью в базу данных, записью новых значений в устройства в предыдущем цикле. Фактически, это полный цикл без учета паузы между циклами. | Милисекунды | Double Word, Unsigned Int | Read/- |
| T3 | Полное фактическое время предыдущего цикла с учетом паузы между циклами. | Милисекунды | Double Word, Unsigned Int | Read/- |
Регистры для чтения состояния оборудования на борту WebHMI
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write |
| H0 | Флаг валидности значения температуры. 1 = значение достоверное, 0 = значение не достоверно | Bit | Read/- | |
| H1 | Флаг валидности регистров контролера питания, 1 = значения достоверное, 0 = значения не достоверны | Bit | Read/- | |
| H2 | Температура на кристалле RTC | Градусы Цельсия | Double word, float 32 | Read/- |
| H3 | Входное напряжение | Вольты | Double word, float 32 | Read/- |
| H4 | Напряжение на батарее | Вольты | Double word, float 32 | Read/- |
| H5 | “Power OK” - питание в норме | Bit | Read/- | |
| H6 | "Battery Low" - батарея разряжен. 1 означает, что на батарее напряжение достигло минимального но еще рабочего напряжения, WebHMI завершит работу штатным образом. | Bit | Read/- | |
| H7 | Battery Critical. Напряжение на батарее достигло минимального значения, и если в течении 10 сек не появится входное напряжение то контролер обесточит WebHMI. | Bit | Read/- | |
| H8 | System OK. 1 означает что система загрузилась и работает. | Bit | Read/- | |
| H9 | “External Power Supply”. Работаем на 24В. 1 означает что система работает от внешнего питания. | Bit | Read/- | |
| H10 | “Internal Power Supply”. Работаем от аккумулятора. 1 означает что система работает от аккумулятора. | Bit | Read/- | |
| H11 | "Reset enabled" - включен таймер на подачу сигнала RESET. 1 означает что система собирается перезагрузиться. | Bit | Read/- | |
| H12 | “Power OFF enabled”. 1 означает что система собирается выключиться. | Bit | Read/- |
B0 - Sound alert register
С помощью этого регистра можно издавать звуки встроенной в WebHMI пищалкой. В регистр нужно записать значение от 1 до 8. WebHMI издаст соответствующее количество звуковых сигналов. После того как сигналы прозвучат WebHMI перестанет издавать звук. Для повтороного звукового сигнала следует еще раз записать нужное число в этот регистр.
Запись в этот регистр можно организовать с помощью сценариев. Так, например, можно издавать писк при обрыве связи или при наступлении аварийой ситуации.
При чтении из этого регистра всегда будет возвращаться 0.
DOx - Digital Output registers
Регистры внешних сухих контактов. При запиписи в регистр соответствующий сухой контакт будет замкнут.
С помощью сухих контактов можно организовать управление внешнимим устройствами или же передать сигналы но внешние системы. Например, можно подключить охранную или пожарную системы и передавать им сигналы тревоги.
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write |
| DO0 | Сухой контакт номер 1 | Bit | Read/Write | |
| DO1 | Сухой контакт номер 2 | Bit | Read/Write |
Ixxx - Intervals
Регистры интервалов. Обычно применяются в условиях событий. Например, если нужно получить событие, которое срабатывает каждые 10 секунд, то можно сравнивать значение регистра I10 c нулем (I10 == 0). Если нужен интервал 2 минуты то нужно использовать регистр I120.
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write | ||
| I1 | Остаток деления текущего времени на 1 | Секунды | Double Word, Unsigned Int | Read/- | ||
| I2 | Остаток деления текущего времени на 2 | Секунды | Double Word, Unsigned Int | Read/- | ||
| I3 | Остаток деления текущего времени на 3 | Секунды | Double Word, Unsigned Int | Read/- | ||
| ... | ||||||
Rxxx - Random values
Генератор случайных чисел. Rxxx = rand() % xxx.
Значение регистра с номером xxx это остаток от деления случайного числа на xxx (адрес регистра).
Пример: R123 будет возвращать случайные числа в диапазоне от 0 до 122 включительно.
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write | ||
| R2 | Случайное целое в интервале от 0 до 1 (включительно). | Double Word, Unsigned Int | Read/- | |||
| R3 | Случайное целое в интервале от 0 до 2 (включительно). | Double Word, Unsigned Int | Read/- | |||
| R4 | Случайное целое в интервале от 0 до 3 (включительно). | Double Word, Unsigned Int | Read/- | |||
| ... | ||||||
Некоторые наиболее важные метрики операцинной системы.
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write |
| L0 | Свободная память | KiB | Word, Unsigned Int | Read/- |
| L1 | Свободная память плюс память занятая буферами ОС | KiB | Word, Unsigned Int | Read/- |
| L2 | 1 minute [load average] | Double Word, Float 32 | Read/- | |
| L3 | 5 minutes [load average] | Double Word, Float 32 | Read/- | |
| L4 | 15 minutes [load average] | Double Word, Float 32 | Read/- |
Exxx.xxx - Event registers
Регистры из условий. Если условие Х, у которого id = Y, сейчас выполняется, то можно читать некоторые его значения из регистров вида EY.xxx. Только чтение.
Читать можно те значения, которые добавлены в таблицу отчета. Для удобства, каждое такое значение подписано прямо в редакторе условий.
На этом экране видны регистры E1.0, E1.1, E1.2. Когда условие выполняется то в них будут содержаться соответствующие значения из отчета с id = 1. В данном примере в регистре E1.0 будет время начала выполнения условия в формате [UnixTime], в E1.1 время его завершения либо 0 если оно еще не завершилось, в E1.2 - значение из регистра "Рецепт" на момент начала события.
ESxxx - Event State
Регистры состояния условий.
Например, единица в регистре ES2 означает что событие с id=2 сейчас выполняется. Если в регистре ES2 ноль то это это значит что условие не выполняется.
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write | ||
| ES1 | Состояние условия с id=1 | Bit | Read/- | |||
| ES2 | Состояние условия с id=2 | Bit | Read/- | |||
| ES3 | Состояние условия с id=3 | Bit | Read/- | |||
| ... | ||||||
ELxxx - Event Length
Регистры длительности событий.
Например, в регистре EL2 будет содержаться длительность в секундах выполнения события с id=2 при условии что это событие сейчас выполняется. Если в регистре EL2 ноль то это это значит что условие не выполняется или его длительность меньше 1 секунды.
| Регистр | Описание | Единицы измерения | Тип данных | Read/Write | ||
| EL1 | Длительность события с id=1 | Секунды | Double Word | Read/- | ||
| EL2 | Длительность события с id=2 | Секунды | Double Word | Read/- | ||
| EL3 | Длительность события с id=3 | Секунды | Double Word | Read/- | ||
| ... | ||||||
Sxxx - String
Начиная с версии 1.11.0.3478 в WebHMI добавился новый тип данных - строки. Строки доступны как внутренние регистры Sxxx. Всего доступно 200 таких регистров S1...S200.
| Регистр | Описание | Тип данных | Read/Write | |||
| S1 | Переменная типа строка 1 | String | Read/Write | |||
| S2 | Переменная типа строка 2 | String | Read/Write | |||
| S3 | Переменная типа строка 3 | String | Read/Write | |||
| ... | ||||||
| S200 | Переменная типа строка 200 | String | Read/Write | |||
TRxxx - Title of recipe
Начиная с версии 2.7 в WebHMI добавился новый тип внутренних регистров TRxx. В них содержатся названия рецептов с указанным ID.
| Регистр | Описание | Тип данных | Read/Write | |||
| TR1 | Название рецепа с ID=1 | String | Read/Write | |||
| TR2 | Название рецепа с ID=2 | String | Read/Write | |||
| TR3 | Название рецепа с ID=3 | String | Read/Write | |||
| ... | ||||||
WCxxx - Weather Condition registers
Текущая метеоинформация. Группа регистров, предоставляющих погодную информацию на текущий момент в месте установки WebHMI. Данные обновляются примерно каждые два часа. Для работы сервиса требуется интернет-подключение, учетная запись в Level2 и подписка на метеопрогноз. Регистры доступны начиная с версии 2.5.2400.
| Регистр | Описание | Тип данных | Read/Write |
| WC0 | Время, для которого получены данные. | Double Word, Unixtime | Read/- |
| WC1 | Температура воздуха, градусы Цельсия. | Double Word, Float | Read/- |
| WC2 | Давление, hPa. | Word, Int | Read/- |
| WC3 | Относительная влажность, %. | Word, Int | Read/- |
| WC4 | Скорость ветра, м/с. | Double Word, Float | Read/- |
| WC5 | Направление, откуда дует ветер, метрологические градусы. | Double Word, Float | Read/- |
| WC6 | Облачность, %. | Word, Int | Read/- |
| WC7 | Количество осадков (дождь), мм. | Double Word, Float | Read/- |
| WC8 | Количество осадков (снег), мм. | Double Word, Float | Read/- |
| WC9 | Текстовое описание текущей погоды | String | Read/- |
Текстовое описание текущей погоды может быть: Clear, Clouds, Rain, Snow, Thunderstorm, Mist.
WFxxx - Weather Forecast registers
Прогноз погоды на ближайшие сутки с интервалом 3 часа. Доступен прогноз на семь 3-х часовых интервалов вперед. Данные обновляются примерно каждые два часа. Для работы сервиса требуется интернет-подключение, учетная запись в Level2 и подписка на метеопрогноз. Регистры доступны начиная с версии 2.5.2400.
Регистры аналогичны регистрам WCxxx. Адреса регистров строятся таким образом: [номер интервала] * 10 + [адрес регистра WCxxx].
Пример:
WF1 = Температура воздуха в следующем 3-х часовом интервале.
WF21 = Температура воздуха примерно через 6 часов.
WF31 = Температура воздуха примерно через 9 часов.
И т.д.
Для более точного понимания на какое время строится прогноз, можно использовать метки времени в регистрах WFx0.
| Регистр | Описание | Тип данных | Read/Write |
| WF0 | Интервал 1. Время, для которого получены данные. | Double Word, Unixtime | Read/- |
| WF1 | Интервал 1. Температура воздуха, градусы Цельсия. | Double Word, Float | Read/- |
| WF2 | Интервал 1. Давление, hPa. | Word, Int | Read/- |
| WF3 | Интервал 1. Относительная влажность, %. | Word, Int | Read/- |
| WF4 | Интервал 1. Скорость ветра, м/с. | Double Word, Float | Read/- |
| WF5 | Интервал 1. Направление, откуда дует ветер, метрологические градусы. | Double Word, Float | Read/- |
| WF6 | Интервал 1. Облачность, %. | Word, Int | Read/- |
| WF7 | Интервал 1. Количество осадков (дождь), мм. | Double Word, Float | Read/- |
| WF8 | Интервал 1. Количество осадков (снег), мм. | Double Word, Float | Read/- |
| WF9 | Интервал 1. Текстовое описание текущей погоды | String | Read/- |
| WF10 | Интервал 2. Время, для которого получены данные. | Double Word, Unixtime | Read/- |
| WF11 | Интервал 2. Температура воздуха, градусы Цельсия. | Double Word, Float | Read/- |
| WF12 | Интервал 2. Давление, hPa. | Word, Int | Read/- |
| WF13 | Интервал 2. Относительная влажность, %. | Word, Int | Read/- |
| WF14 | Интервал 2. Скорость ветра, м/с. | Double Word, Float | Read/- |
| WF15 | Интервал 2. Направление, откуда дует ветер, метрологические градусы. | Double Word, Float | Read/- |
| WF16 | Интервал 2. Облачность, %. | Word, Int | Read/- |
| WF17 | Интервал 2. Количество осадков (дождь), мм. | Double Word, Float | Read/- |
| WF18 | Интервал 2. Количество осадков (снег), мм. | Double Word, Float | Read/- |
| WF19 | Интервал 2. Текстовое описание текущей погоды | String | Read/- |
| ... | ... | ... | ... |
| WF60 | Интервал 7. Время, для которого получены данные. | Double Word, Unixtime | Read/- |
| WF61 | Интервал 7. Температура воздуха, градусы Цельсия. | Double Word, Float | Read/- |
| WF62 | Интервал 7. Давление, hPa. | Word, Int | Read/- |
| WF63 | Интервал 7. Относительная влажность, %. | Word, Int | Read/- |
| WF64 | Интервал 7. Скорость ветра, м/с. | Double Word, Float | Read/- |
| WF65 | Интервал 7. Направление, откуда дует ветер, метрологические градусы. | Double Word, Float | Read/- |
| WF66 | Интервал 7. Облачность, %. | Word, Int | Read/- |
| WF67 | Интервал 7. Количество осадков (дождь), мм. | Double Word, Float | Read/- |
| WF68 | Интервал 7. Количество осадков (снег), мм. | Double Word, Float | Read/- |
| WF69 | Интервал 7. Текстовое описание текущей погоды | String | Read/- |
Текстовое описание текущей погоды может быть: Clear, Clouds, Rain, Snow, Thunderstorm, Mist.
WSxxx - Sunset/Sunrize registers
Время восхода и заката солнца в текущих сутках. Для работы сервиса требуется интернет-подключение, учетная запись в Level2 и подписка на метеопрогноз. Регистры доступны начиная с версии 2.5.2400.
| Регистр | Описание | Тип данных | Read/Write |
| WS0 | Время рассветра. | Double Word, Unixtime | Read/- |
| WS1 | Время заката. | Double Word, Unixtime | Read/- |
Текстовое описание текущей погоды может быть: Clear, Clouds, Rain, Snow, Thunderstorm, Mist.
