要开始了解V2适配器脚本的概述，请访问本知识库文章．
一个变量生成的一段命名数据将其他数据在适配器脚本中可用。变量定义在一个叫做变量．一些你可能用变量解决的问题的例子是:
- 将传感器信号转换为执行状态
- 对脉冲信号进行部件计数
- 将多个信号组合成一个状态
下面是一个变量的例子，该变量基于模拟输入来计数部件，该模拟输入在每一个部件制造的几秒钟内转换为高压状态:
变量:
part-count:
——来源:AIN0
-阈值:5
——前沿
——数
使用上面的例子，变量是由唯一名称part-count定义的，变量的主体是列表的操作．以破折号开头的每一行都是an操作．操作可以被认为是一个接一个执行的工作步骤。每个步骤都将前一步的结果作为其输入，对其执行一些工作，然后将其输出供下一个步骤使用。part-count变量可以描述为这一系列步骤。
- 等待AIN0引脚的变化。当一个变化被注意到，然后把它传递给…
- 一个阈值操作，当值高于或低于阈值时，该操作将值转换为true或false。将阈值传递给…
- 一个前沿检测器操作，用于监视值从false到true(从低到高)的变化。这将修改输入，仅在转换发生时为真，其他时间为假，本质上标志事件发生的时间点。将可数值传递给…
- 一个数操作，该操作为前一步中检测到的每个“事件”加1。没有将计数器值传递给的步骤，所以将它作为变量的结果赋值。
列表中的第一个操作表示一种特殊情况，因为之前没有向它传递值的操作。第一个操作仅限于一小组能够监视其他数据变化的操作。当发生更改时，将运行操作链。这些支持的“starter”操作的列表如下源，表达式,状态．
最后一个操作也很特殊，因为没有后续操作来传递其结果。相反，结果变成了变量本身的值，可以在适配器脚本的其他部分引用它。
看到表达式有关变量和其他数据源如何相互引用和导致级联更新的更多信息的文档。
操作参考
操作参考被组织成若干组:
表达式操作
表达式操作处理各种输入，并允许使用复杂的数学或逻辑表达式定义输出。的源Operation是一种特殊类型的表达式操作，必须在每个变量定义的开头使用。
源
语法
——来源:标识符或表达式
每个变量定义都从一个源操作开始。源行标识将提供后续操作序列的数据源。根据配置的设备，有效的数据源可以是大头针、寄存器或标记名。源也可以是另一个变量名，在这种情况下，已命名变量的最终输出将提供给新变量操作链的开始部分。
源可以是简单的名称，也可以是引用一个或多个有效数据源标识符的复杂表达式。当引用的任何数据源被更新时，将计算表达式，并将结果传递到下一阶段。
例子
——来源:pin-0
——来源:另一个变量
-源:引脚1 +引脚2
表达式
语法
-表达式:表达式
一个表达式运算将一个数学(或在有限的情况下，非数学)表达式应用于其输入。计算表达式的结果是操作的输出。
表达式值可以识别特殊关键字这，表示从上一个操作输入的值。适配器脚本中的其他有效标识符(可能来自源代码或其他变量定义)也可以在表达式中使用。
有关表达式的全部功能，请参阅相关的表达式支持文档。
例子
——来源:pin-0
-表达式:这个* 9 / 5 + 32
和
语法
- - -:表达式
一个和操作是一般的特殊形式表达式操作，其中输入值通过逻辑将与表达式结果隐式组合和操作。它相当于:
-表达:this and (表达式）
例子
- source: pin-0 >
- and: pin-1 >
或
语法
(或:表达式
一个或操作是一般的特殊形式表达式操作，其中输入值通过逻辑将与表达式结果隐式组合或操作。它相当于:
-表达:this or (表达式）
例子
- source: pin-0 >
-或:pin-1 > 2
状态
语法
紧凑语法:
-状态:
-RESULT1：表达式1
-RESULT2：表达式2
-RESULT3：表达式3.
扩展语法：
-状态:
-选择:结果1
当:表达式1
-选择:结果2
当:表达式2
-选择:结果3
当:表达式3.
一个状态Operation是一种控制结构，它允许在测试一系列表达式的基础上将常量值赋给变量(或发送给链中的下一个操作)。State类似于其他编程语言中的if/else语句。
状态操作可以有任意数量的结果/表达式对。当任何状态表达式中的任何变量或数据源发生变化时，整个状态将通过按提供的顺序计算每个表达式来重新计算。如果表达式的计算结果为true，则将捕获相关的结果，不再进行进一步的计算。如果表达式的计算结果为false，则将检查列表中的下一个表达式。如果所有表达式的值都为false，则状态操作的结果将是链中前一个操作传递给它的值，或者不可用如果这是第一次手术。
状态规则中的表达式可以引用适配器脚本中的任何其他变量或数据源。如果状态操作不是第一个操作，则指定特殊值这也可用，并保存从前一个操作传入的值。
通常，您应该倾向于使用紧凑的语法来执行此操作。如果您试图分配更复杂的值，并且可能会干扰YAML结构，那么可以使用扩展语法。
例子
#获取基本的执行值
-状态:
—ACTIVE: is-powered和is-cutting
-准备好了:真正的
#重写执行值
——来源:执行
-状态:
- READY:这个== "ACTIVE"和in-warm -program
样操作
重新取样
注意:基于时间的，当前的订购安全问题，避免使用，直到解决。
模拟操作
模拟操作主要消耗模拟输入并产生模拟输出。的阈值操作是产生数字(布尔值)输出的异常。
阈值
语法
-阈值:价值
将前一个操作的输出转换为数字高(true)(如果其值高于或等于阈值)，或数字低(false)(如果值低于阈值)。
除了通用表达式运算外，阈值运算是将模拟输入转换为数字输出的唯一运算。
例子
——来源:pin-0
-阈值:2.5
平均
语法
——平均:
数:样本窗口大小
对于每个传入的样本，输出前一个样本的平均值数看到样品。
例子
——来源:pin-0
——平均:
数:100
马克斯
语法
——马克思:
计数:样本窗口大小
对于每个传入的样本，输出前一个样本中最大的数看到样品。
一个马克斯操作可以过滤掉输入中的短滴，并将延迟识别传入样品中的下降。对应于马克斯是延迟断开操作。
例子
——来源:pin-0
——马克思:
数:100
最小值
语法
-最小值:
数:样本窗口大小
对于每个传入的样本，输出前一个样本的最小值数看到样品。
一个最小值操作可以滤除输入中的短上升，并将延迟识别传入样品的增加。对应于最小值是不容错过操作。
例子
——来源:pin-0
-最小值:
数:100
min-delta
语法
- min-delta:价值
当min-delta获取它的第一个样本，它将记住该值并在新样本进入时继续输出该值，除非样本和所记住的值之间的差超过最小-delta值。当超过差异时，min-delta将输出并记住新的样本。
这个操作的效果是将输入量化为更小的离散值集，尽管它不能保证总是选择相同的值。较小的最小-delta值对于去除较小的信号噪声和减少从操作链流出的数据量非常有用。
例子
——来源:pin-0
——min-delta: 1
数字业务
数字运算主要消耗数字输入并产生数字输出。当应用于模拟输入时，它们通常将任何非零值视为真值，零值视为假值。
反
语法
——反
的反操作不接受任何参数。它将前一个操作的输出反转，使true变成false, false变成true。
如果前面的操作产生一个模拟值，那么0的值将变为真，其他任何值将变为假。
例子
——来源:pin-0
-阈值:4
——反
不容错过
语法
——不容错过:窗口大小
输出一个假值，直到上一阶段的输入在指定的时间内(以秒为单位)保持一个真值，此时输出将切换到真值。任何下降到假输入，即使是瞬间，将切换回假输出和复位延时计数器。
例子
——来源:pin-0
-阈值:4
-不容错过:0.5
延迟断开
语法
-延迟断开:窗口大小
输出一个真值，直到上一阶段的输入在指定的时间内(以秒为单位)保持一个假值，此时输出将切换到假值。任何上升到真在输入，即使是瞬间，将切换输出到真和复位延时计数器。
例子
——来源:pin-0
-阈值:4
-延迟断开:0.5
防反跳
语法
-防反跳:窗口大小
的防反跳运算过滤掉数字输入中持续时间小于指定窗口大小(以秒为单位)的简短变化。解除将帮助锁定信号进入其主导状态。
设置反弹类似于设置不容错过和延迟断开同时进行。
例子
——来源:pin-0
-阈值:4
-防反跳:0.25
事件操作
事件操作检查特定事件的输入信号，例如状态从低到高的转换，并在每次发现事件时输出长度为0的true状态。在其他所有时间，这些操作输出一个假状态。具有关闭延迟的后续事件操作将给出无穷小的事件脉冲的长度。
边缘
语法
——边缘
的边缘操作不接受任何参数。它监视数字输入，并在每次输入从高到低或从低到高转换时发出事件脉冲。
例子
——来源:pin-0
-阈值:2.5
——边缘
下降沿
语法
——下降沿
的下降沿操作不接受任何参数。它观察一个数字输入，并在每次输入从高到低的转换时发出一个事件脉冲。
例子
——来源:pin-0
-阈值:2.5
——下降沿
前沿
语法
——前沿
的前沿操作不接受任何参数。它监视一个数字输入，并在每次输入从低到高的转换时发出一个事件脉冲。
例子
——来源:pin-0
-阈值:2.5
——前沿
价值变化
语法
——价值变化
的价值变化操作不接受任何参数。它监视输入值的任何变化，并在每次看到变化时发出一个事件脉冲。
对于未经过滤的模拟输入，事件可以像每个样本一样频繁地发出。
例子
——来源:pin-0
——min-delta: 1
——价值变化
value-decrease
语法
——value-decrease
的value-decrease操作不接受任何参数。它观察模拟输入，并在数值每次下降时发出一个事件脉冲。
降低值的一个应用是检测计数器输入复位到较低的值。
例子
——来源:pin-0
——min-delta: 1
——value-decrease
值使用
语法
——值
的值使用操作不接受任何参数。它监视一个模拟输入，并在每次数值增加时发出一个事件脉冲。
值递增的一个应用是检测计数器输入的增量，同时忽略对较低值的复位。
例子
——来源:pin-0
——min-delta: 1
——值
柜台业务
计数器操作是一组特殊的操作，它们监视输入并维护内部计数器以响应某些事件。每次计数器改变时，它的值都会作为输出发出。计数器输出被认为是一种模拟类型，在特殊情况下可以由其他模拟操作进一步处理。
数
语法
——数
的数操作不接受任何参数。计数操作旨在遵循任何记录的事件操作，但它们可以由输入中从低到高的任何转换触发。
每次触发count时，其内部值加1，然后输出该值。当适配器重新启动时，内部计数值被重置为0。
例子
——来源:pin-0
-阈值:2.5
——下降沿
——数
窗口计数
语法
-窗口计数:窗口大小
的窗口计数Operation监视输入的任何触发事件，并维护在前一个窗口大小(以秒为单位)内看到的所有事件的计数。
当事件进出被监视的窗口时，窗口计数的内部值将上下波动。每次内部计数器改变时，计数将输出。
例子
——来源:pin-0
-阈值:2.5
——下降沿
- - - - - -窗口计数:1
文本操作
文本(也称为String)操作允许检查或转换文本数据源，比如程序名。在泛型Expression操作中已经提供了一些基本的文本支持。例如，可以使用==操作符测试包含文本的变量或数据输入是否与特定单词匹配。
的要求
语法
-要求:正则表达式
-要求:
模式:正则表达式
组:捕获集团
其他:默认字符串
的的要求操作允许在文本中搜索模式并捕获与该模式匹配的文本部分。
的模式参数是强制性的。它的值可以是一个简单的字符串，例如一个单词或一个数字。该值也可以是一个完整的正则表达式，允许进行更复杂的匹配。正则表达式应该总是用一对斜杠(/)括起来。斜杠不会被认为是模式本身的一部分。
的集团参数是可选的，仅当匹配的模式是正则表达式时使用。正则表达式允许使用括号创建“捕获组”，这是较大模式中的较小模式。当捕获组出现在模式字符串中时，它们被分配一个以1开头的数字。将group参数设置为捕获组的数量将导致操作只捕获模式的那一部分。默认情况下，将捕获整个模式。
的其他的参数是可选的。如果在输入字符串中找不到匹配，则操作的结果将改为else中指定的值。如果没有指定其他值，则结果为空字符串。
模式匹配是一个高级技术主题。如果您打算捕获比精确的字符串匹配更复杂的模式，那么您应该熟悉常见的正则表达式语法和规则。
例子
——来源:程序名
-要求:
模式:WARMUP1
输入:CNCpart1
结果:
输入:WARMUP1
结果:WARMUP1
输入:WARMUP2
结果:
——来源:程序名
-要求:
模式:/ O7 [0 - 9] + /
输入:O8003
结果:
输入:O7005
结果:O7005
——来源:程序名
-要求:
模式:/ O (7 [0 - 9] +) /
组:1
其他:1
输入:O8003
结果:1
输入:O7005
结果:7005
pattern-replace
语法
- pattern-replace:
模式:正则表达式
:更换
其他:默认字符串
的pattern-replace操作允许在文本中搜索模式，并用另一个值替换与模式匹配的文本部分。
的模式参数是强制性的。它的值可以是一个简单的字符串，例如一个单词或一个数字。该值也可以是一个完整的正则表达式，允许进行更复杂的匹配。正则表达式应该总是用一对斜杠(/)括起来。斜杠不会被认为是模式本身的一部分。
的与参数是强制性的。这是对模式匹配的每个实例的替换。通过使用符号，整个匹配值本身可以作为替换的一部分使用＄0．如果在模式中使用了括号(表示模式的部分)，那么那些匹配的部分可以通过使用符号在替换中使用＄1，＄2，＄3等。数字是按照括号组从左到右出现的顺序分配的。
的其他的参数是可选的。如果在输入字符串中找不到匹配，则操作的结果将改为else中指定的值。如果没有指定其他值，则结果是原始的未修改字符串。
模式匹配是一个高级技术主题。如果您打算替换比精确的字符串匹配更复杂的模式，那么您应该熟悉常见的正则表达式语法和规则。
例子
——来源:程序名
- pattern-replace:
模式:O7001
: O7003
输入:O8000
结果:O8000
输入:O7001
结果:O7003
——来源:程序名
- pattern-replace:
模式:/ O ([0 - 9] +) /
: 1美元
输入:O9013
结果:9013
输入:OX123
结果:OX123
——来源:程序名
- pattern-replace:
模式:/ O ([0 - 9] +) /
: 1美元
其他:0
输入:O9013
结果:9013
输入:OX123
结果:0
格式测试
语法
-格式测试:正则表达式
的格式测试操作测试是否存在带有文本的模式。如果模式存在一次或多次，则pattern-test的结果为true，否则为false。
pattern-test的参数可以是一个简单的字符串，比如一个单词或一个数字。该值也可以是一个完整的正则表达式，允许进行更复杂的匹配。正则表达式应该总是用一对斜杠(/)括起来。斜杠不会被认为是模式本身的一部分。
模式匹配是一个高级技术主题。如果您打算替换比精确的字符串匹配更复杂的模式，那么您应该熟悉常见的正则表达式语法和规则。
例子
——来源:程序名
-格式测试:热身
输入:WARMUP1
结果:真正的
输入:O7003
结果:假
——来源:程序名
-格式测试:/ O [0 - 9] + /
输入:O7003
结果:真正的
输入:9001
结果:假
Misc操作
杂项操作不能清晰地归入其他类别，也不能被MachineMetrics内部使用。
日志文件
语法
日志文件:的名字
日志文件:
名称:的名字
格式:格式字符串
repeat-values:真正的或假
的日志文件操作是MachineMetrics有时使用的内部操作，通过将数据记录到磁盘以供稍后检查，帮助诊断集成的问题。它们并不打算由最终用户编写，但您仍然可能在适配器脚本中遇到它们。
可以在一个变量定义中使用多个日志文件操作。日志文件操作的任何输入都将透明地传递给下一个操作。一个适配器脚本中的每个日志文件操作都必须是唯一的的名字．有速记和手写表格。
在普通语法中，a格式可以提供字符串。格式字符串支持特殊占位符:
- 美元的价值—日志操作输入的格式化值。
- 美元的时间戳—记录值的十进制Unix时间戳。
- DATETIME美元-一个格式化的ISO日期和时间的值被记录。
如果没有提供，默认格式字符串是:时间戳\ t美元价值
缺省情况下，日志中的值不重复。这种行为可以通过repeat-values选择。
日志记录被限制为10MB的数据或24小时的数据，以较早耗尽的数据为准。
例子
——来源:pin-0
-日志文件：sample1.log
——来源:pin-0
日志文件:
名称:sample2.log
格式:$DATETIME - $VALUE
repeat-values:真
有问题吗?
接触support@machinemetrics.com额外的帮助。
评论
0评论
请登录留下评论。