Справка по NSG Linux: дерево команд

Что это такое?

Это настройка данного состояния датчика. (Для датчиков, измеряющих аналоговые физические величины: ток, напряжение, температуру и т.п.)

Зачем это нужно?

Чтобы определить границы данного диапазона и его название.

Как это настроить?

Вести имя для данного состояния.
Указать одно или два предельных значения диапазона (включительно), в который должно попадать текущее показание датчика. Любое из значений может быть опущено, в этом случае состояние определяется только по другому параметру: больше from или меньше to, соответственно.

Состояния анализируются последовательно в порядке нумерации, пока не найдётся первое, подходящее к текущему значению датчика. Таким образом, последовательно расписывать все возможные диапазоны и следить, чтобы они не пересекались, нет необходимости (хотя для человека это делает конфигурацию более понятной). Например, для датчика температуры, работающего с точностью 0,1°С, следующие две конфигурации равносильны:

port
: usb1
: : type = "multisensor"
: : event-generator
: : : enable = true
: : : TEMP-states
: : : : 1
: : : : : from = "50"
: : : : : event-name = "hot"
: : : : 2
: : : : : from = "30"
: : : : : event-name = "warm"
: : : : 3
: : : : : from = "5"
: : : : : event-name = "normal"
: : : : 4
: : : : : from = "-5"
: : : : : event-name = "shilly"
: : : : 5
: : : : : to = "-5.1"
: : : : : event-name = "frozen"

port
: usb1
: : type = "multisensor"
: : event-generator
: : : enable = true
: : : TEMP-states
: : : : 1
: : : : : from = "50"
: : : : : event-name = "hot"
: : : : 2
: : : : : from = "30"
: : : : : to = "49.9"
: : : : : event-name = "warm"
: : : : 3
: : : : : from = "5"
: : : : : to = "29.9"
: : : : : event-name = "normal"
: : : : 4
: : : : : from = "-5"
: : : : : to = "4.9"
: : : : : event-name = "shilly"
: : : : 5
: : : : : to = "-5.1"
: : : : : event-name = "frozen"

Как только найдено состояние, соответствующее текущему значению переменной, дальнейший анализ прекращается и датчик передаёт обработчику событий (event-handler) это состояние. Если просмотрен весь список и ни одного подходящего состояния не найдено (например, между описанными состояниями имеются разрывы, и результат измерения попал в один из них), то передаётся состояние UNKNOWN, что в переводе означает "а хрен его знает".