CSM API String Addon

API String 核心功能

API String - Is Supported Datatype.vi

判断数据类型是否为API String支持的转换数据类型。

  • Ref: API String参数支持
  • Ref: CSM HEXSTR格式

– 输入控件(Controls) –

  • Data: 输入数据。

– 输出控件(Indicators) –

  • Data(Dup): 输入数据副本。
  • Supported Datatype?: 是否支持API String的布尔值。

Convert Data To API String Arguments.vim

将数据转换为API String格式。

  • Ref: API String参数支持

– 输入控件(Controls) –

  • Data: 输入数据。
  • Reference Cluster Data: 参考簇数据，转换簇数据时，会比较输入数据和参考数据中的元素，若完全匹配，则转换结果将忽略该元素。
  • No Tag Mode? (F): 对于簇数据，当为TRUE时，转换为API String时不包含标签信息。

– 输出控件(Indicators) –

  • API String: 转换后的API String格式。

Convert API String Arguments to Data.vim

将API String转换为相应的数据类型。

  • Ref: API String参数支持

– 输入控件(Controls) –

  • API String: API String格式的输入字符串。
  • Strict Label Check? (T): 严格标签检查，当为TRUE时，若参考数据中不包含标签，转换将失败报错。
  • Reference Type: 参考数据。

– 输出控件(Indicators) –

  • Data: 转换后的数据。

Query Data as API String Arguments.vim

查询簇数据中的指定数据项，并转换为API String格式。

应用场景: 例如在API String Addon包含的新CSM模块模板中，新增了Data: Get Configuration状态，在此状态下，通过发送希望查询的数据项名称，即可返回对应的数据项值。

特殊情况: 若将Name设置为<list>，将返回所有可用设置的列表。

– 输入控件(Controls) –

  • Cluster Data: 簇数据。
  • Name: 数据名称。

– 输出控件(Indicators) –

  • Cluster Data(dup): 簇数据副本。
  • API String: API String格式的查询结果。

配置

API String - Add Boolean Strings.vi

将自定义布尔字符串添加到API String布尔值解析列表中，并返回更新后的列表。

  • Ref: TRUE值的默认字符串
  • Ref: FALSE值的默认字符串

– 输入控件(Controls) –

  • Custom False Boolean Strings: 自定义FALSE字符串列表。
  • Custom True Boolean Strings: 自定义TRUE字符串列表。

– 输出控件(Indicators) –

  • False Boolean Strings: 更新后的FALSE字符串列表。
  • True Boolean Strings: 更新后的TRUE字符串列表。

API String - Remove Boolean Strings.vi

从API String布尔值解析列表中移除自定义布尔字符串，并返回更新后的列表。

  • Ref: TRUE值的默认字符串
  • Ref: FALSE值的默认字符串

– 输入控件(Controls) –

  • Custom False Boolean Strings: 要移除的FALSE字符串列表。
  • Custom True Boolean Strings: 要移除的TRUE字符串列表。

– 输出控件(Indicators) –

  • False Boolean Strings: 更新后的FALSE字符串列表。
  • True Boolean Strings: 更新后的TRUE字符串列表。

API String - List Boolean Strings.vi

列出当前所有可用的布尔值字符串。

  • Ref: TRUE值的默认字符串
  • Ref: FALSE值的默认字符串

– 输出控件(Indicators) –

  • False Boolean Strings: 当前的FALSE字符串列表。
  • True Boolean Strings: 当前的TRUE字符串列表。

API String - Set Float Format String.vi

设置浮点数的格式字符串，可参考LabVIEW format string格式。

  • Ref: 浮点数默认格式

– 输入控件(Controls) –

  • Float Format String Setting: 浮点数格式字符串设置。

– 输出控件(Indicators) –

  • Float Format String: 当前的浮点数格式字符串。

API String - Float Format String.vi

获取当前的浮点数格式字符串。

  • Ref: 浮点数默认格式

– 输出控件(Indicators) –

  • Float Format String: 当前的浮点数格式字符串。

API String - Set Float Precision.vi

设置浮点数的精度。

  • Ref: 浮点数默认格式

– 输入控件(Controls) –

  • Precision: 浮点数精度设置。

– 输出控件(Indicators) –

  • Float Format String: 更新后的浮点数格式字符串。

字符串转换

String to Boolean_csm.vi

将字符串转换为布尔值。支持多种TRUE/FALSE表示方式，可通过API String - Add Boolean Strings VI添加自定义的TRUE/FALSE字符串。

  • Ref: TRUE值的默认字符串
  • Ref: FALSE值的默认字符串

– 输入控件(Controls) –

  • String: 输入字符串。
  • Default (F): 转换失败时的默认值。

– 输出控件(Indicators) –

  • Boolean: 转换后的布尔值。

String To Float_csm.vi

将字符串转换为浮点数。支持多种浮点数格式和单位，可通过API String - Set Float Format String VI设置格式。

  • Ref: 浮点数默认格式

– 输入控件(Controls) –

  • String: 输入字符串。
  • Default (0): 转换失败时的默认值。

– 输出控件(Indicators) –

  • Float: 转换后的浮点数。
  • Unit String: 提取的单位字符串。

String To Number(I64)_csm.vi

将字符串转换为64位整数。支持多种数字格式，包括普通整数、十进制、十六进制、二进制、八进制，以及带后缀的表示方法，转换失败时返回0。

– 输入控件(Controls) –

  • String: 输入字符串。

– 输出控件(Indicators) –

  • Numeric: 转换后的64位整数。

String To Indexed Enum_csm.vi

将字符串转换为带索引的枚举类型。

  • Ref: 带索引的枚举类型(Indexed Enum)
_<b>转换规则1: 无索引编号</b>_

通过字符串匹配进行转换

例如Enum = {AAA, BBBB, CCCC}
- 字符串"AAA"将转换为Enum(AAA)，数字值为0
- 字符串"CCC"将转换为Enum(CCC)，数字值为2

_<b>转换规则2: 有索引编号</b>_

既可以通过字符串匹配转换，也可以通过索引编号匹配转换

例如Enum = {1- AAA, 5 - BBBB, 9 - CCCC}
- 字符串"AAA"将转换为Enum(1- AAA)，数字值为0
- 字符串"5"将转换为Enum(5 - BBBB)，数字值为1
- 字符串"9 - CCCC"将转换为Enum(9 - CCCC)，数字值为2

– 输入控件(Controls) –

  • String: 输入字符串。
  • Enum Prototype: 枚举原型。

– 输出控件(Indicators) –

  • Enum: 转换后的枚举值。

Indexed Enum to Numeric_csm.vim

将枚举转换为数值，支持带索引的枚举类型，当枚举数值携带索引编号时，将直接使用索引编号作为数值。

  • Ref: 带索引的枚举类型(Indexed Enum)

– 输入控件(Controls) –

  • Enum: 输入枚举值。

– 输出控件(Indicators) –

  • Numeric: 枚举的数字值。
  • String: 枚举的字符串表示。

Numeric to Indexed Enum_csm.vim

将数字值转换为带索引的枚举。

规则1: 当匹配到索引编号时，将直接使用该索引。

规则2: 当没有匹配到索引编号时，将使用数字值作为枚举索引。

  • Ref: 带索引的枚举类型(Indexed Enum)

– 输入控件(Controls) –

  • Numeric: 输入数字值。
  • Enum Prototype: 枚举原型。

– 输出控件(Indicators) –

  • Enum: 转换后的枚举值。

CSM - Timestamp to API String Arguments.vi

将LabVIEW时间戳转换为API String字符串。

– 输入控件(Controls) –

  • Timestamp (now): 输入时间戳，默认为当前时间。
  • Format(Empty to use UTC): 时间格式字符串，为空时使用UTC格式。

– 输出控件(Indicators) –

  • API String: 转换后的API String格式。

工具函数

CSM - Convert HexStr to Data.vim

提供CSM - Convert HexStr to Data VI自适应数据类型的版本。

– 输入控件(Controls) –

  • HEX String: HEX格式字符串。
  • Type: 数据类型。

– 输出控件(Indicators) –

  • data: 转换后的数据。

CSM - Broadcast Data As API String.vim

使用CSM - Generate User Global Log VI将数据以API String格式广播。

– 输入控件(Controls) –

  • Data: 要广播的数据。
  • CSM: CSM模块引用。
  • API/Condition: API或条件字符串。

– 输出控件(Indicators) –

  • Data (dup): 数据副本。

CSM - Query Internal Data Names By API String.vi

查询CSM模块的内部数据名称。实现逻辑: 使用同步消息发送Data: Get Internal Data命令，参数为<list>，获取CSM模块的内部数据名称列表。

– 输入控件(Controls) –

  • Target Module: CSM 目标模块。
  • Current Module (“” to Generate an ID): 当前模块(空字符串表示生成ID)。
  • Wait (5000ms): 等待时间(毫秒)。

– 输出控件(Indicators) –

  • Configurations: 配置列表。