Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Создание конфигурационного файла

Для того, чтобы работать с уставками в Alpha.HMI.SetPoints, нужно прописать информацию о картах уставок в конфигурационном файле и загрузить этот файл в Alpha.HMI.SetPoints. Информацию о картах уставок нужно добавлять в конфигурационный файл вручную в формате JSON.

В папке установки Alpha.HMI.SetPoints C:\Program Files\Automiq\Alpha.HMI.SetPoints (ОС Windows) или /opt/Automiq/Alpha.HMI.SetPoints (ОС Linux) есть файл-пример example.spcfg, содержимое которого можно брать за основу при формировании конфигурационного файла. Ниже описаны правила наполнения файла. Старайтесь придерживаться их, чтобы ваш файл без ошибок загрузился в Alpha.HMI.SetPoints.

Карты уставок

Карта уставок в Alpha.HMI.SetPoints выглядит как таблица, в каждой строке которой содержится информация об отдельном параметре и его уставках.

Добавляйте карты уставок в раздел Tables. Максимально можно добавить 20 карт уставок.

{
  "Id": "B4033877-C025-40C3-A555-65BA8F45B9BB","Tables":
  [
  {
      "Name": "Санитарно-бытовой корпус",
      "Id": "Idtable1",
      "Type": "Table",
      "DataType": "float",
      "Format": "%.2f",				
      "Columns": [{...}, {...}, ...],
      "RowTypes": [ {...}, {...}, ... ],
      "Rows": [{...}, {...}, ...]
    }, 
  {
      "Name": "Корпус №3",
      "Id": "Idtable2",
      "Type": "Table",
      "DataType": "float",
      "Columns": [{...}, {...}, ...],
      "RowTypes": [ {...}, {...}, ... ],
      "Rows": [{...}, {...}, ...]
    }
  ]
}

Чтобы добавить новую карту уставок, добавьте внутри раздела Tables новый блок с полями Name, Id, Type, DataType и разделами Columns, Rows, RowTypes.

Name Имя карты уставок, отображаемое в дереве карт уставок Alpha.HMI.SetPoints.
Id Идентификатор карты уставок. Можно указать любое значение, но помните о том, что у каждой карты уставки должен быть уникальный идентификатор.
Type Тип узла в дереве карт уставок Alpha.HMI.SetPoints. Укажите значение Table, если вы хотите создать одиночную карту уставок, а не папку, объединяющую несколько карт уставок в группу.
DataType

Тип данных всех уставок в этой карте уставок. Указанный здесь тип можно переопределить внутри параметра или уставки.

Format

Точность отображаемых значений всех уставок в этой карте уставок. Указанную здесь точность можно переопределить внутри параметра или уставки.

Если вы не укажете здесь значение и не переопределите точность внутри параметра или уставки, для всех уставок в этой карте будет выставлена максимально допустимая точность в пределах типа их значений:

  • %.7g – float;
  • %.15g – double;
  • %llu – uint4, uint8;
  • %lld – int8;
  • %d – int1, uint1, int2, uint2, int4;
  • нет | да – bool (синтаксис – falseText|trueText).
Columns Массив, содержащий список столбцов карты уставок.
Rows Массив, содержащий список параметров карты уставок.
RowTypes Массив, содержащий типы параметров, используемых в пределах конфигурационного файла (можно не указывать).

Параметры и уставки

Добавляйте параметры вместе с их уставками в раздел Rows. Максимальное количество параметров определяется по формуле: Pmax = 3000/количество уставок, где Pmax – количество параметров.

{
  "Id": "B4033877-C025-40C3-A555-65BA8F45B9BB",
  "Tables":
      [
        {
      "Name": "Санитарно-бытовой корпус",
      "Id": "Idtable1",
      "Type": "Table",
      "DataType": "float",
      "Columns": [{...}, {...}, ...],
      "Rows": [{ 
          "Id": "SRP52CP001",
          "Name": "Давление на напоре 00SRP52CP001",
          "EUnit": "МПа",
          "Format": "%.3g",
          "DataType": "float",
          "Tag": "TestSignals.Device1",
          "LoLo": {...},
          "Lo":  {...}  
       }, { 
          "Id": "00SRP52CP002",
          "Name": "Давление на напоре 00SRP52CP002",
          "Tag": "TestSignals.Device2",
          "HiHi": {...} 
          } 
        ]
        }
      ]
}

Чтобы добавить новый параметр, добавьте внутри раздела Rows новый блок с полями, описывающими сам параметр: Id, Name, EUnit, Tag, Type, DataType и полями, содержащими описание уставок. Для удобства вы можете вынести повторяющиеся поля в отдельные блоки (в раздел RowTypes), а внутри раздела Row просто ссылаться на эти типы.

Id Идентификатор параметра, отображаемый в столбце Идентификатор таблицы карты уставок Alpha.HMI.SetPoints.
Name Имя параметра, отображаемое в столбце Наименование таблицы карты уставок Alpha.HMI.SetPoints.
EUnit Единица измерения всех уставок этого параметра, отображаемая в таблице карты уставок Alpha.HMI.SetPoints. Указанное здесь значение можно переопределить внутри каждой уставки.
Format

Точность отображаемых значений всех уставок этого параметра. Указанную здесь точность можно переопределить внутри каждой уставки.

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

  • %.7g – float;
  • %.15g – double;
  • %llu – uint4, uint8;
  • %lld – int8;
  • %d – int1, uint1, int2, uint2, int4;
  • нет | да – bool (синтаксис – falseText|trueText).
Tag Тег параметра, который будет добавляться к тэгу уставки при построении полного пути к сигналам чтения/записи уставки. Можно не указывать, тогда для каждой уставки нужно прописать полный путь к сигналам.
Type Тип параметра. Если вы не подготовили для параметра типы, можете не указывать здесь значение.
DataType Тип данных всех уставок этого параметра, отображаемый в таблице карты уставок Alpha.HMI.SetPoints. Можно не указывать, тогда для всех уставок параметра будет использоваться тип данных, указанный в карте уставок. Если же для отдельных уставок определены собственные типы, будут использоваться именно они.
Поля уставок На каждый параметр вы можете добавить до 20 уставок. Имена уставок могут быть любыми, но каждое имя должно совпадать с именем, указанным в поле Id для столбца, в который помещается значение этой уставки.

Типы параметров

Иногда у разных параметров есть поля с одинаковыми значениями. В таком случае удобно описывать эти поля отдельно, за пределами раздела Rows (с описанием параметров), а в разделе Rows ссылаться на них. Ниже представлен пример создания типов параметров.

У параметров Давление на напоре 00SRP52CP001 и Давление на напоре 00SRP52CP002 есть общая уставка HiHi, и для полей EUnit и DataType заданы одинаковые значения.

"Rows": [{
     "Id": "SRP52CP001",
     "Name": "Давление на напоре 00SRP52CP001",
     "Tag": "TestSignals.Device1",
     "DataType": "double",
     "EUnit": "МПа",
     "HiHi":{ 
       "ReadTag": "HiHiLimit", 
       "WriteTag": "HiHiLimit.writeValue", 
       "MinLimit": 1, 
       "MaxLimit": 5 
     } 
   }, {
     "Id": "SRP52CP002",
     "Name": "Давление на напоре 00SRP52CP002",
     "Tag": "TestSignals.Device2",
     "DataType": "double",
     "EUnit": "МПа",
     "HiHi":{ 
       "ReadTag": "HiHiLimit",
       "WriteTag": "HiHiLimit.writeValue",
       "MinLimit": 1,
       "MaxLimit": 5 
     } 
   }
   ]

Поместим все одинаковые поля в тип с именем AP6_PRESS. Чтобы добавить тип, создайте раздел RowTypes и добавьте внутри новый блок с полями Name (Имя типа), EUnit, DataType и полями уставки HiHi.


 "RowTypes": [ {
      "Name": "AP6_PRESS",
      "DataType": "double",
      "EUnit": "МПа",
      "HiHi": {
        "ReadTag": "HiHiLimit",
        "WriteTag": "HiHiLimit.writeValue",
        "MinLimit": 1,
        "MaxLimit": 5
      }
    }
  ],
 "Rows": [{... }, {...}]

Теперь в полях параметров Давление на напоре 00SRP52CP001 и Давление на напоре 00SRP52CP002 нужно сослаться на созданный тип. Для этого в поле Type укажите имя созданного типа AP6_PRESS.

"Rows": [{
     "Id": "SRP52CP001",
     "Name": "Давление на напоре 00SRP52CP001",
     "Tag": "TestSignals.Device1",
     "Type": "AP6_PRESS" 
   }, {
     "Id": "SRP52CP002",
     "Name": "Давление на напоре 00SRP52CP002",
     "Tag": "TestSignals.Device2",
     "Type": "AP6_PRESS" 
   }
   ]

Добавление уставок и связи с тегами сигналов

Добавляйте уставки для каждого параметра внутри раздела Rows. Максимально можно добавить 20 уставок в одну карту уставок.

{
  "Id": "B4033877-C025-40C3-A555-65BA8F45B9BB",
  "Tables":
	[
	{
  "Name": "Санитарно-бытовой корпус",
  "Id": "Idtable1",
  "Type": "Table",
  "DataType": "float",
  "Columns": [{...}, {...}, ...],
  "Rows": [{
    "Id": "SRP52CP001",
    "Name": "Давление на напоре 00SRP52CP001",
    "EUnit": "МПа",
    "DataType": "float",
    "Tag": "TestSignals.Device1",
    "LoLo": { 
	 "ReadTag": "LoLoLimit",
	 "WriteTag": "LoLoLimit.writeValue",
	 "Format": "%.3g",
	 "MinLimit": 0,
	 "MaxLimit": 98,
	 "DataType": "float" 
    },
    "Lo":  { 
	 "ReadTag": "LoLimit",
	 "WriteTag": "LoLimit",
	 "MinLimit": "sp:LoLo"} 
			}, {
    "Id": "00SRP52CP002",
    "Name": "Давление на напоре 00SRP52CP002",
    "Tag": "TestSignals.Device2",
    "HiHi": { 
	 "ReadTag": "HiHiLimit",
	 "WriteTag": "HiHiLimit.writeValue",
	 "MinLimit": 10,
	 "MaxLimit": 50} 
    }
  ]
  }
	]
}

Чтобы добавить новую уставку, добавьте новый блок после полей параметра с именем уставки и её полями ReadTag, WriteTag, DataType, MinLimit и MaxLimit. Имя уставки может быть любым, но оно обязательно должно совпадать с именем, указанным в поле Id для столбца, в который помещается значение этой уставки.

Чтобы связать указанные уставки и сигналы сервера, укажите в поле ReadTag тег сигнала, из которого будет читаться значение уставки, а в поле WriteTag - тег сигнала, в который будет записываться значение уставки. Полный путь к сигналам строится с учетом тега, указанного в параметре (поле Tag), если он задан.

ReadTag

Тег сигнала, из которого будет читаться значение уставки и помещаться в таблицу Alpha.HMI.SetPoints. Вы можете указать полный тег, либо только его часть. Часть, общую для всех уставок параметра, можно вынести в поле Tag параметра.

Если вы хотите указать, что в ПЛК (в архиве) нет такой уставки, оставьте это поле пустым.

"ReadTag": ""
WriteTag

Тег сигнала, в который будет записываться значение уставки из таблицы Alpha.HMI.SetPoints. Вы можете указать полный тег, либо только его часть. Часть, общую для всех уставок параметра, можно вынести в поле Tag параметра.

Если вы хотите указать, что уставка доступна только для чтения, оставьте это поле пустым.

"WriteTag": ""
Format

Точность отображаемого значения уставки. Указанную здесь точность можно переопределить внутри каждой уставки. Можно не указывать, тогда для уставки будет использоваться точность, указанная в карте уставок или параметре.

Если вы не укажете здесь значение и для уставки не определена точность выше (в карте уставок или параметре), для уставки будет выставлена максимально допустимая точность в пределах типа её значения:

  • %.7g – float;
  • %.15g – double;
  • %llu – uint4, uint8;
  • %lld – int8;
  • %d – int1, uint1, int2, uint2, int4;
  • нет | да – bool (синтаксис – falseText|trueText).
MinLimit/MaxLimit

Минимальное/максимальное значение уставки. Вы можете не указывать точное значение, а сослаться на другую уставку. Для этого укажите идентификатор другой уставки с префиксом sp:.

"MinLimit": "sp:LoLo"

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

DataType Тип данных уставки. Можно не указывать, тогда для уставки будет использоваться тип данных, указанный в карте уставок или параметре.

Столбцы карты уставок

Добавляйте столбцы в раздел Columns.

{
  "Id": "B4033877-C025-40C3-A555-65BA8F45B9BB",
  "Tables":
      [
        {
      "Name": "Санитарно-бытовой корпус",
      "Id": "Idtable1",
      "Type": "Table",
      "DataType": "float",
      "Columns": [{ 
          "Id": "Number",
          "Name": "№",
          "Width": "50" 
        }, { 
          "Id": "Name",
          "Name": "Наименование" 
        }, { 
          "Id": "Id",
          "Name": "Идентификатор",
          "Width": 150 
        }, { 
          "Id": "LoLo",
          "Name": "Нижняя аварийная",
          "Width": 150 
          "Format": "%.3g",
        }, { 
          "Id": "Lo",
          "Name": "Нижняя предупредительная" 
        }, { 
          "Id": "HiHi",
          "Name": "Верхняя аварийная" 
          } 
        ],
      "Rows": [{...}, {...}, ...]
        }
    ]
}

Все столбцы карты уставок заполняются данными из раздела Rows (с описанием параметров). Первые четыре столбца: Number (имя – №), Id (имя – Идентификатор), Name (Имя – Наименование)и EUnit) (имя – Единицы измерения) нужны для отображения информации о параметрах. Обязательно добавьте столбцы с идентификаторами Id и Name. Остальные столбцы содержат информацию об уставках, поэтому добавляйте их с учетом всех уставок, существующих в разделе Rows.

Чтобы добавить новый столбец, добавьте внутри раздела Columns новый блок с полями Id, Name, Width, EUnit, Format и Values.

Id Идентификатор уставки (для первых четырех столбцов это идентификатор данных параметра). Для того, чтобы значения уставок помещались в нужный столбец, указывайте здесь именно то имя уставки, которое вы указали в разделе Rows.
Name Имя столбца, отображаемое в таблице карты уставок Alpha.HMI.SetPoints.
Width Ширина столбца в пикселях (можно не указывать).
Format

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

Если вы не укажете здесь значение и не переопределите точность уставки в параметре или внутри уставки, для всех уставок в этом столбце будет выставлена максимально допустимая точность в пределах типа их значений:

  • %.7g – float;
  • %.15g – double;
  • %llu – uint4, uint8;
  • %lld – int8;
  • %d – int1, uint1, int2, uint2, int4;
  • нет | да – bool (синтаксис – falseText|trueText).
EUnit Единица измерения, отображаемая при задании значения уставки. Можно не указывать, тогда для уставки будет использоваться единица измерения, указанная для параметра.
Values

Список возможных значений уставки, отображаемый при задании значения уставки в Alpha.HMI.SetPoints (можно не указывать).

Пусть уставка может принимать значения: 0.5, 0.7, 1 и 1.25. Чтобы сформировать выпадающий список, который будет отображаться в Alpha.HMI.SetPoints при задании значения уставки, задайте здесь значение в формате:

"Values": [0.5, 0.7, 1, 1.25]

Объединение карт уставок в группы

Вы можете объединять карты уставок в группы (по принадлежности к технологическим системам, объектам и т.д.), которые в дереве карт уставок Alpha.HMI.SetPoints будут выглядеть как папки.

Чтобы создать новую группу, добавьте в массив Tables структуру с типом "группа" (с полем "Type": "Group") со своим именем (поле Name) и своим идентификатором (поле Id). Внутрь этой структуры добавьте массив Tables с картами уставок. Так вы можете вкладывать группы друг в друга.

{
  "Id": "B4033877-C025-40C3-A555-65BA8F45B9BB",
  "Tables": [{...}, {
      "Name": "НПС Сатарино",
      "Id": "IdGroup1",
      "Type": "Group",
      "Tables": [{...}, {...}]
            }
          ]
}

Отключение уставок, наследуемых из типа параметра

Иногда уставки, описанные в типе параметра, могут не использоваться в каком-то параметре. Такие уставки можно отключить прямо внутри самого параметра. Для этого нужно явно прописать неиспользуемые уставки и для каждой добавить пустой тег чтения или тег записи (поля ReadTag или WriteTag).

"Rows": [{
        "Id": "TT111",
        "Name": "МНА1. Давление нефти на входе",
        "Tag": "NPS.MNA1.TTn11",
        "Type": "OIP",
        "Hi3": { "ReadTag": "" },
        "Hi2": { "ReadTag": "" },
        "Hi1": { "ReadTag": "" }
    }, {
        "Id": "TT112",
        "Name": "МНА1. Давление нефти на выходе",
        "Tag": "NPS.MNA1.TTn12",
        "Type": "OIP",
        "Lo3": { "ReadTag": "" },
        "Lo2": { "ReadTag": "" },
        "Lo1": { "ReadTag": "" }
    }
]

Доступ к настройкам уставки

Считывать настройки уставки с ПЛК (архива) или вручную настраивать уставки в Alpha.HMI.SetPoints возможно, если в конфигурационном файле указать области памяти ПЛК, где хранятся настройки уставки, а также прописать теги сигналов для записи и чтения состояния уставки.

Чтобы добавить в конфигурационный файл сведения о настройках уставки, добавьте внутрь уставки блок Flags с полями Use, Sound и Message.


  "Rows": [
          {
             "Id": "SRP52CP001",
             "Name": "Давление на напоре 00SRP52CP001",
             "EUnit": "МПа",
             "DataType": "float",
             "Tag": "TestSignals.Device1",
             "LoLo": { 
	          "ReadTag": "LoLoLimit",
	          "WriteTag": "LoLoLimit.writeValue",
	          "MinLimit": 0,
	          "MaxLimit": 98,
	          "DataType": "float",
	          "Format": "%.1f",
	          "Flags": { 
	             "Use": { 
		           "Bit": 0,
		           "ReadTag": "LoLoLimit.Sets",
		           "WriteTag": "LoLoLimit.Sets.writeValue"  
	             }, 
	             "Sound": { 
		           "Bit": 1,
		           "ReadTag": "LoLoLimit.Sets",
		           "WriteTag": "LoLoLimit.Sets.writeValue"   
	             }, 
	             "Message": { 
		           "Bit": 2,
		           "ReadTag": "LoLoLimit.Sets",
		           "WriteTag": "LoLoLimit.Sets.writeValue"  
	             }  
	          }  
             },
             "Lo":  { 
	          "ReadTag": "LoLimit",
	          "WriteTag": "LoLimit",
	          "MinLimit": "sp:LoLo"
             } 
          } 
       ]
Use Группа полей описывающих настройки включения/отключения уставки.
Sound Группа полей, описывающих настройки подачи звукового сигнала при срабатывании уставки.
Message Группа полей, описывающих настройки выдачи сообщений при срабатывании уставки.

Поля внутри групп Use, Sound и Message:

Bit

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

Номер бита для настройки уставки должен быть указан обязательно, даже если поля ReadTag и WriteTag не заданы. Именно после указания номера бита в Alpha.HMI.SetPoints появляется возможность считывания этой настройки с ПЛК (архива) или изменения настроек уставки.

При включении уставки/сообщения/звука в указанный бит записывается true.

ReadTag

Тег сигнала, из которого будет читаться настройка уставки и помещаться в ячейку уставки в таблице Alpha.HMI.SetPoints.

Сигналы для хранения настроек уставки должны быть типа uint1/uint2/uint4/uint8.

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

Максимальное число тегов для чтения настроек уставок в одном конфигурационном файле - 1000. Тип данных тега ограничивает количество настроек, которое он может содержать. Например, если в теге используется тип int4, то в нем может храниться 32 настройки (4 байта * 8 бит). Максимально тег может хранить 64 настройки (в Alpha.HMI.SetPoints считается, что максимальный размер слова состояния – 8 байт).

Максимальное число настроек в одном конфигурационном файле вычисляется по формуле:

64 (настройки) * 1000 (тегов) = 64 000 (настроек)

Помните про указанные ограничения при указании тегов с помощью поля ReadTag и номеров битов с помощью поля Bit.

Можно не указывать тег для конкретной настройки, а прописать его выше, в блоке Flags. Такой тег будет распространяться на все настройки уставки при условии, что для настроек указано значение поля Bit.


{
	"LoLo": { 
	     "ReadTag": "LoLoLimit",
	     "WriteTag": "LoLoLimit.writeValue",
	     "MinLimit": 0,
	     "MaxLimit": 98,
	     "DataType": "float",
	     "Format": "%.1f",
	     "Flags": { 
	         "ReadTag": "LoLoLimit.Sets",
	         "WriteTag": "LoLoLimit.Sets.writeValue",
                "Use": { 
		        "Bit": 0,
	         }, 
	         "Sound": { 
		        "Bit": 1,  
	         }, 
	         "Message": { 
		        "Bit": 2,
	         }  
           } 
     } 
}
WriteTag

Тег сигнала, в который будет  записываться настройка уставки, сделанная вручную в Alpha.HMI.SetPoints.

Сигналы для хранения настроек уставки должны быть типа uint1/uint2/uint4/uint8.

Значение поля можно не указывать, тогда конфигурируемую настройку нельзя будет изменять (команда изменения настройки в ячейке уставки будет неактивна). Если не добавлять это поле ни в одну из настроек уставки (группы Use, Sound и Message, то настройки этой уставки в ячейке Alpha.HMI.SetPoints будут доступны только для чтения.

Максимальное число тегов для записи настроек уставок в одном конфигурационном файле - 1000. Тип данных тега ограничивает количество настроек, которое он может содержать. Например, если в теге используется тип int4, то в нем может храниться 32 настройки (4 байта * 8 бит). Максимально тег может хранить 64 настройки (в Alpha.HMI.SetPoints считается, что максимальный размер слова состояния – 8 байт).

Максимальное число настроек в одном конфигурационном файле вычисляется по формуле:

64 (настройки) * 1000 (тегов) = 64 000 (настроек)

Помните про указанные ограничения при указании тегов с помощью поля WriteTag и номеров битов с помощью поля Bit.

Можно не указывать тег для конкретной настройки, а прописать его выше, в блоке Flags. Такой тег будет распространяться на все настройки уставки (см. пример для ReadTag).

Папка с оперативным архивом значений уставок

По умолчанию для оперативного архива используется путь:

  • C:\ProgramData\Automiq\HMI.SetPoints\Archive для ОС Windows;
  • /home/<user>/Automiq/HMI.SetPoints для ОС Linux.

Если же у вас есть ограничения на запись файлов в папку по умолчанию, пропишите свой путь в разделе Archive (поле Path).

{
  "Id": "B4033877-C025-40C3-A555-65BA8F45B9BB",
  "Archive": {
    "Path": "C:\\WORK\\SetPoints\\Archive"
  },
  "Tables":
  [{...},{...}]
}