hex文件修改_树莓派工控机RevPi（十一）自定义设备（RAP文件）

A

id

模块/设备的内部ID

String

必要

B

version

模块/设备版本

String

必要

C

comment

内部注释，例如用于解释

String-Array

可选

D

screencomment

设备类型的预置注释，显示在应用程序里的设备信息表的注释列中；可以由用户为每个设备更改

String

必要

E

size

扩展模块的宽度；可用于确定DIN导轨上是否有足够的空间

String

可选

F

devicetype

设备的定位类型；确定设备可插入的位置(请输入大写字母)
 BASE Core单元；必须先定位
 LEFT 模块只能位于Core单元的左侧
 RIGHT 模块只能位于Core单元的右侧
 LEFT_EDGE 模块只能位于最左侧
 RIGHT_EDGE 模块只能位于最右侧
 LEFT_RIGHT 模块可以位于BASE单元的左侧或右侧
 RIGHT_LEFT 模块可以位于BASE单元的左侧或右侧
 VIRTUAL 虚拟设备 - 自动放入虚拟设备区域。

String

必要

G

producttype

KUNBUS产品系列的单元号

Num

必要

H

input / output / memory

在操作期间修改的设备的实际操作数据(“属性”)；数据声明由以下描述的值(H.1到H.12)组成。input，output和memory数组都必须存在于文件中，但允许为空([])。

Object-Array

必要

H.1

name

值的名称
 提醒：读取文件时，名称中的空格将被下划线替换！尽可能避免使用空格。

String

必要

H.2

type

DIN61131数据类型；例如BOOL，BYTE，WORD；用大写字母

String

必要

H.3

range

值输入的有效范围；基于不同的类型，可以生成合理性检查或预定义的下拉列表。每个“range”条目包含依照下例格式的两个子条目：
 "range":{
 "type":"tooltip_loop",
 "values":[0,1,1]
 }
 可用的type/values组合参见H.3.1至H.3.3

Object

必要

H.3.1

Range类型01：
 loop

根据“values”数组中定义的循环值创建一个下拉列表，例如"values":[0,10,1.5]创建一个下拉列表，其值为0到10，步长为1.5(0,1.5,3,4.5,6...等)

-

-

H.3.2

Range类型02：
 tooltip_loop

创建一个普通的文本输入字段，当鼠标置于此处时在提示框中显示有效值范围；在输入值之后检查值范围，如果输入错误，则生成错误消息。

-

-

H.3.3

Range类型03：
 list

用“values”数组中定义的常量生成下拉列表：
 "values":[
 "M01|1",
 "M02|2",
 "M03|3"
 ]
 “|”符号前面的条目在下拉框中显示为可读文本，“|”符号后面的条目将作为实际工作值导出。

-

-

H.4

default

属性的默认值；注意：请确保它在“range/values”定义的值范围内！当使用“list”range类型时，该值必须在'|'分隔符之后有定义！

String

必要

H.5

unit

描述属性值单位的文本字符串；出现在编辑列表的“Unit”列中；如果其为空，则将数据类型显示为单位。

String

可选

H.6

tags

属性的任意描述性文本标签；但是，至少必须指定属性区域(“input / output /  memory”)和属性的“type”(bool，byte，word等)，用逗号分隔。
 注意：属性的范围和类型也可以在标记中存储，以便更轻松，更有效地处理RAP文件。但它们不应与属性区域/类型的内容相对立。

String

必要

H.7

edit

属性的编辑模式；确定用户可以输入或更改哪个部分；有效值是0-4之间的值
 0 既不能编辑属性的名称也不能编辑属性的值
 1 可以编辑属性的值
 2 可以编辑属性的名称
 3 可以编辑属性的名称和值
 4 值列不显示在编辑列表中(用于不应向用户显示的常量或不可更改的值)

String

必要

H.8

order

排序顺序，即在编辑列表中的相对位置；这里可以输入任何有间断的数值，然后执行升序排序，例如：10，20，25，99等。注意：不要使用两次相同值，否则排序将导致不可预测的结果。

Num

必要

H.9

offset

属性的内存偏移量；设备的第一个属性从‘0’开始；为了确保正确连续地分配偏移量，请根据值类型(“type”条目，例如BYTE)输入距离下一个属性的适当偏移距离，例如：
 "name":"Input01",
 "type":"WORD",
 "offset":0,
 :
 "name":"Input02",
 "type":"BYTE",
 "offset":2
 作为WORD型值，Input01占用字节0和1；因此，Input02的偏移量从字节2开始。

Num

必要

H.10

multi

从1到n的整数值；从该属性生成所需数量的多个属性(主要是为了省略许多相似或相关值的冗余数据录入)；按顺序的编号将附加到属性的名称中，例如：
 "name":"Input01",
 "multi":3
 ...创建属性Input01_1到Input01_3。
 注意：
 如果未设置“multi”值，则默认值为1。
 如果没有为BOOL值定义“multi”值，则在内部读取RAP文件时，“multi”值会自动固定为“8”，以便将它们设置为字节限制。RAP文件中的“multi”值会覆盖此默认设置 - 需要确认仅定义“8”的倍数的值。

Num

可选

H.11

active

true或false；定义在读取RAP文件时是否考虑属性值。这使你可以完全停用属性值。

Bool

可选

H.12

export

true或false；确定编辑列表的“Export”列中该属性是否默认进行导出。

Bool

可选

I

colorEdit

＃000000和#ffffff之间的十六进制颜色代码；为可编辑输入字段设置单独的背景颜色；如果此值不存在，则使用config.json文件中的默认值。("colors":{colorEdit...)

Hex-color

可选

J

colorReadOnly

＃000000和#ffffff之间的十六进制颜色代码；为不可编辑(只读)输入字段设置单独的背景颜色；如果此值不存在，则使用config.json文件中的默认值。("colors":{colorReadOnly...)

Hex-color

可选

K

colorTextEdit

＃000000和#ffffff之间的十六进制颜色代码；为可编辑输入字段设置单独的文本颜色；如果此值不存在，则使用config.json文件中的默认值。("colors":{colorTextEdit...)

Hex-color

可选

L

colorTextReadOnly

＃000000和#ffffff之间的十六进制颜色代码；为不可编辑(只读)输入字段设置单独的文本颜色；如果此值不存在，则使用config.json文件中的默认值。("colors":{colorTextReadOnly...)

Hex-color

可选

M

Variant-specific

要创建变体层次结构，输入/输出条目后需要以下附加条目：
 "variants":[
 {
 "id":"Variante 001",
 "isDefault":true,
 "data":[
 :
 :
 变体“id”将显示在“PiCtory”的未来版本中，用于变体选择。在这里，你应输入具有唯一性的描述性文本。
 “isDefault”指定将RAP文件导入PiCtory后的默认变体。请注意定义的规则，并在设置'isDefault'时考虑它们。PiCtory目前仅在用户手动更改变体时才应用规则，并且无法解决与'isDefault'条目的矛盾！
 在“data”数组中，再次输入“normal”输入/输出属性，因为它们将在没有变体的情况下完成。
 注意：通过使用变体，输入/输出条目的类型从数组变为对象(矩形括号到大括号)，例如：
 "input":[...
 变为
 "input":{...

Array

可选

N

lang

为了实现值显示的国际化，工作值的名称(标签)用作指向相应国家名称的指针。如果标签条目以前缀“lang_”开头，则将其解释为指针。如果没有此前缀，则值将按规定存储在显示中。
 例如:
 work unit:"lang_input":"8″
 国际化区域
 "lang":{
 {
 "de": {
 "input":"Eingang",
 "output":"Ausgang"
 },
 "en":{
 "input":"Input",
 "output":"Output"
 }
 }
 }
 如果设置了德语，则在值编辑器中进行渲染：
 Eingang：8

Object

可选

O

rules

包含输入和输出条目的RAP文件变体，可用于通过指定“rules”在输入和输出变体之间创建逻辑链接。一旦选择了变体，这会使“PiCtory”自动“同步”链接的变体。 例如：
 "rules":{
 "IO":[
 {
 "sync"：[0,0]
 },
 {
 "sync":[1,1]
 }
 ]
 }
 在此示例中，链接了第0个输入和第0个输出变量，以及第1个输入和第1个输出变量。如果用户将输入更改为变量1，则“PiCtory”会自动将输出更改为变量1。如果输出重置为0，则输入自动跳回0。

Object

可选

P

include

要集成由外部配置工具创建的数据定义，还可以在运行时从外部文件中读取输入，输出和内存块的内容(PiCtory读取RAP文件时)。必须按如下方式对相应的块进行编码：
 "input":
 {
 "include":"[path to Include file]"
 }
 注意以下几点：
 包含文件的路径必须以物理和权限相关的方式定义，以便通过Ajax调用(Web服务器的用户上下文)访问它。
 包含文件的内容必须是JSON格式；它完全替换“input”对象块，这意味着它不只是被添加到“include”条目所在的对象块中。这意味着普通(非变体)内容的包含文件必须包含数组的方括号，例如：
 [
 {
 "name":"RevPiLED",
 "type":"BYTE",
 "offset":1,
 :
 :
 如果是变体定义，它必须如下所示：
 {
 "variants":[
 {
 "id":"001",
 "isDefault":true,
 :
 :