Псевдонимы

Псевдонимы (псевдонимы) - это объекты виртуальных состояний, которые связаны с реальными состояниями.

Случаи использования

Часто реальные устройства будут сломаны, и пользователь должен заменить это устройство. Кроме того, что оборудование будет заменено, адрес этого устройства будет изменен. Например. от hm-rpc.0.ABC123 до hm-rpc.0.QJU978.

Поскольку старый адрес использовался во многих местах, таких как vis, javascript, сцены или другие, пользователь теперь должен найти все эти места и заменить их там.

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

Другой вариант использования этой функции - поддержка устройства в специальных интеллектуальных адаптерах, таких как iot или material. С помощью псевдонимов может быть создана необходимая структура состояний, но значения будут считываться с физических устройств.

Объяснение

Все состояния, созданные в пространстве имен объектов alias.0, будут управляться как псевдонимы.

Значение состояния псевдонима будет считываться из связанного состояния (цель), но значения объекта (как общие, собственные) будут считываться из состояния псевдонима сам.

Фактически объект alias будет отражать значение состояния целевого объекта. Если это разрешено, оба состояния могут быть изменены и автоматически синхронизированы базовой системой ioBroker. Также оба состояния могут использоваться для подписки в сценариях и должны вести себя абсолютно одинаково.

Вот пример такого объекта:

{
  "_id": "alias.0.Light.Device_1.WORKING",
  "type": "state",
  "common": {
    "alias": {
      "id": "admin.0.connected"
    },
    "name": "WORKING",
    "role": "indicator.working",
    "type": "boolean"
  },
  "native": {}
}

native всегда пуст, потому что ни одно устройство не находится за самим псевдонимом, и все настройки будут сохранены в common.

Но в common.alias.id хранится идентификатор, где значение состояния должно быть считано или записано.

Псевдоним выполняет автоматическое преобразование значения, если заданы минимальные / максимальные параметры для обоих объектов (псевдоним и целевой объект).

Например. если псевдоним имеет min=0,max=100, а цель имеет min=0,max=255, то при чтении значение 10 из целевого состояния будет преобразовано в 3.9215686274509802, а записанное в псевдоним 10 будет преобразовано в 25.5.

Типы будут преобразованы автоматически. От строки к номеру, от числа к логическому значению и так далее. Зависит от типа псевдонима и цели.

Кроме того, функции записи и чтения могут быть определены в common.alias:

{
  "_id": "alias.0.Temperature.SET",
  "type": "state",
  "common": {
    "alias": {
      "id": "knx.0.6786878.value",
      "write": "(val * 9/5) + 32",
      "read": "(val − 32) * 5/9"
    },
    "unit": "°C",
    "name": "Temperature",
    "role": "value.temperature",
    "type": "number"
  },
  "native": {}
}

а также

{
  "_id": "knx.0.6786878.value",
  "type": "state",
  "common": {
    "unit": "°F",
    "name": "Temperature",
    "role": "value.temperature",
    "type": "number"
  },
  "native": {}
}

Если определены функции преобразования, автоматическое преобразование будет деактивировано. Только для чтения функция записи может быть опущена, соответственно, для функций только для записи - функция чтения.

Например.

{
  "_id": "alias.0.button",
  "type": "state",
  "common": {
    "alias": {
      "id": "knx.0.6786879.value",
      "write": "val ? 1 : 0"
    },
    "name": "Button",
    "role": "button",
    "type": "boolean"
  },
  "native": {}
}

а также

{
  "_id": "knx.0.6786879.value",
  "type": "state",
  "common": {
    "name": "KNX Switch",
    "role": "value",
    "type": "number",
    "min": 0,
    "max": 1
  },
  "native": {}
}

Внутренняя функция преобразования имеет следующие параметры и выглядит следующим образом:

function read(val, type, min, max, sType, sMin, sMax) {
    // val - source value
    // type - the type of alias
    // min - minimum limit (if exists) of alias
    // max - maximum limit (if exists) of alias
    // sType - the type of "s"ource value
    // sMin - minimum limit (if exists) of source value
    // sMax - maximum limit (if exists) of source value
    return val > max ? max : (val < min ? min : val);
}

Вы, как пользователь, должны написать только строку с возвратом: common.alias.read="val > max ? max : (val < min ? min : val)".

Функция записи выглядит следующим образом:

function write(val, type, min, max, sType, sMin, sMax) {
    // val - source value
    // type - the type of alias
    // min - minimum limit (if exists) of alias
    // max - maximum limit (if exists) of alias
    // tType - the type of target value
    // tMin - minimum limit (if exists) of target value
    // tMax - maximum limit (if exists) of target value
    return val > tMax ? tMax : (val < tMin ? tMin : val);
}

Вы, как пользователь, должны написать только строку с возвратом: common.alias.write="val > tMax ? tMax : (val < tMin ? tMin : val)".

** max, min и type будут предоставлены только из js-controller >= 3.2.x **

Подписки будут управляться автоматически. Если псевдоним будет подписан, значит, целевой идентификатор тоже будет подписан.

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