概述

在本节中，我们将使用卷曲来阅读凹槽I/O的模块安装在凹槽史诗般的底盘。

步骤1-构建请求

为了提出HTTP请求，我们需要三个基本信息：

  • 主机名或IP地址凹槽史诗处理器
  • 请求的URL路径
  • A的API键凹槽用户凹槽管理权限

在此示例中，我们将使用一个示例主机名Opto-01-02-03对于地址和一个示例API键3KBLB7YZRXNTBP49NEMOBDKRPMPKFOBO。

获取模块列表的URL路径是/manage/api/v1/io/local/locules/type。有关它的更多信息API参考。

步骤2-执行请求

结合步骤1的信息，卷曲请求看起来像这样：

curl -K -H apikey：3KBLB7YZRXNTBP49NEMOBDKRPMPKFOBO https：/////opo-01-02-02-03/manage/api/api/api/v1/io/local/local/local/模块/类型

-K标志用于忽略任何SSL错误。默认，凹槽Epic处理器使用自签名的SSL证书，但是您的计算机和卷发没有参考。为了使这些示例更容易，我们只是忽略了-K标志的问题。这些请求仍将被加密，但是证书本身将无法验证。

API键使用-H标志设置，该标志将一个名为“ Apikey”的自定义HTTP标头添加到请求中。

如果您运行上述命令（对自己的地址和API密钥进行调整），则响应应该看起来像：

{“ type”：[{“ index”：0，“ type”：“ 0x5000000f”，“ name”：“ grv-iac-24”}，{“ index”：1，'type'：“ 0x90000012”，“名称“：” grv-oac-12“}，{“ index”：2，“ type”：“ 0x600002”，“名称”：“ grv-iv-24”}，{“ index”：3，“ type”，“ type”：“ 0xa0000003”，“ name”：“ grv-ovmalc-8”}，{“ index”：4，“ type”：“ 0x00000000”：“ 0x00000000”，“ name”：“”}，{“ index”：5，“类型”“：” 0x00000000“”，“名称”：“”}，{“ index”：6，“ type”：“ 0x00000000”，“名称”：“}，{”}，{“ index”：7，“ type”：“ 0x000000000000”“，”名称“：”}，{“ index”：8，“ type”：“ 0x5400000a”，“ name”：“ grv-iacis-12”}，{“ index”：9：9，“ type”：“：”0x94000019“，”名称“：” grv-omris-8“}，{“ index”：10，“ type”：“ 0x00000000”，“ name”：“”}，{“ index”：11，“ type”，“ type”：“ 0x00000000”，“名称”：“”}，{“ index”：12，“ type”：“ 0x00000000”，“名称”：“}，{“ index”：13，“ type”：“ 0x00000000”：“ 0x00000000”，，“名称”：“”}，{“ index”：14，“类型”：“ 0x00000000”，“名称”：“”}，{“ index”：15，“ type”：“ 0x00000000”，“ name”：“：”：“：”：：“”“}]}}

响应是一个包含模块描述数组的JSON对象。如果我们非常打印，那么阅读要容易得多：

{“ type”：[{“ index”：0，“ type”：“ 0x5000000f”，“ name”：“ grv-iac-24”}，{“ index”：1，'type'：“ 0x90000012”，“名称“：” grv-oac-12“}，{“ index”：2，“ type”：“ 0x600002”，“名称”：“ grv-iv-24”}，{“ index”：3，“ type”，“ type”：“ 0xa0000003”，“名称”：“ grv-ovmalc-8”}，{“ index”：4，'type'：“ 0x00000000”，“ name”：“”：“”}，...等级...]}}

对于每个模块，该类型作为字符串版本给出，模块类型ID的十六进制值的字符串版本。每个模块类型都有一个唯一的ID，即32位无符号号码。例如，GRV-IAC-24的“ 0x5000000F”。如果没有将模块插入插槽中，则“ ID”将为“ 0x00000000”。

还给出了模块的名称，例如“ GRV-IAC-24”或“ GRV-OVMALC-8”。

其他模块信息

REST API具有多个URL端点，用于获取有关模块和频道类型的信息。

这/api/v1/io/descriptions/模块/{模块}端点可以使用模块ID（例如“ 0x600002”）或模块名称（例如“ GRV-IV-24”），并将返回有关该类型模块的信息。

使用卷曲和模块名称，我们可以这样请求：

curl -K -H apikey：3KBLB7YZRXNTBP49NEMOBDKRPMPKFOBO https：/////opo-01-01-02-03/manage/api/api/api/v1/v1/io/defictions/io/descriptions/grv-iv-24

或使用模块ID：

curl -K -H apikey：3KBLB7YZRXNTBP49NEMOBDKRPMPKFOBO https：/////opo-01-01-02-03/manage/api/api/api/v1/io/deciptions/defictions/docriptions/doctriptions/0x60000002

响应是：

{“ schemaversion”：“ 1.0.0”，“ contentVersion”：“ 1.0.4”，“ ModuleID”：“ 0x60000002”，“ productNumber”：“ GRV-IV-24”，“ NumberOfChannels”，“ NumberOfChannels”：24，“ ProductDesteScription”：{{“ en”：“模拟电压输入，24个通道，8个可配置的输入范围从±160 V到±1.25 V“}，“ ChannEldescriptions”：{“ all”：{“ channeltypes”：[“ channeTypes”：[“ 0x60000024”，“ 0x60000024”，“ 0x6000000D”，“ 0x6000000D“，” 0x6000000b“，” 0x6000000a“，” 0x60000017“，” 0x60000019“，”，“ 0x60000025”，“ 0x60000001”]，“ defaultChannelType”：“ 0x60000024”}}，“ 0德赢下载x60000024”}}，'0x60000024“}}，”“：”±160.0 vdc，±80.0 vdc，±40.0 vdc，±20.0 vdc，±10.0 vdc，±10.0 vdc，±5.0 vdc，±2.5 vdc，±2.5 vdc，±1.25 vdc“VDC，±44.0 VDC，±22.0 VDC，±11.0 VDC，±5.5 VDC，±2.75 VDC，±2.75 VDC，±1.375 vdc“，“分辨率”，“分辨率”：“ range / 1,048,576（20 bits）”，“范围0.1％”范围0.1％：“±160 mV，±80 mV，±40 mV，±20 mV，±10 mV，±5 mV，±2.5 mV，±2.5 mV，±1.25 mV，“增益温度系数”：“ PPM/°C”，“ OffSOT温度系数”：“ PPM/°C”，“输入阻抗名义”：“ 9.7 MOHMS”，“输入过滤器”：“ -3 DB处于460 Hz“，”软件数据过滤，SMA（简单移动平均）和加权过滤器（原始）“：” 1至32读数，移动平均值和（原始）1至4096滤波器权重”，“步骤输入响应时间”：“ 277 ms x sma值（8.8 s @ 32 sma，默认SMA = 4）”，“数据新鲜 /更新”：“ 277 ms”，“模拟数据过滤”：“ -3 db @ 2.4 Hz / -25 db@ 60 Hz“，“ DC公共模式拒绝”：“> -120 dB”，“ AC COMMON模式拒绝”：“> -120 dB”，“最大。可生存的输入“：” 300 V“，”最大。操作通用模式电压“：”：“ 250 V”，“问题指示”：“超出范围”，“隔离（现场到逻辑）”：“ 300 V工作，1500 V瞬态（1分钟）”，“隔离（通道到渠道）“：” A区域A（CH 0-11）和B区（CH12-23），“频道数”：“ 24”，“底盘功耗”：“ 1.0 W”，“连接器”：“ 28–14 AWG”，“扭矩，连接器螺钉”：“ 2.5 in-lb（0.28 n-m）”，“扭矩，固定螺钉”：“ 3.5 in-lb（0.4 n-m），”，“Temperature (operating)": "-20 °C to +70 °C", "Temperature (storage)": "-40 °C to +85 °C", "Relative Humidity (non-condensing)": "5–95%", "Agency Approvals": "UL/cUL(Class 1 Div. 2); CE, ATEX(Category 3, Zone 2), RoHS; DFARS; CB Scheme", "Warranty": "Lifetime" } } }

注意值channeldescript.channeltypes.channeltypes [0]是“ 0x60000024”

我们可以使用带有的0x60000024通道类型/api/v1/io/descriptions/channels/{channelid}端点：

curl -K -H apikey：3KBLB7YZRXNTBP49NEMOBDKRPMPKFOBO https：/////opo-01-01-02-03/manage/api/api/api/v1/io/decriptions/channels/channels/channels/0x60000024

回复：

{“ ChanneTypeid”：“ 0x60000024”，“名称”：{“ en”：“±160V”}，“ EngineeringUnits”：“ V”，“ MinunderScale”：-177.6，“ Lowscale”，“ Lowscale”：-160，“ HighScale”：“ HighScale”：“ High Scale”：“ High Scale”：“：160，“ Maxoverscale”：177.6}

从该响应中，我们可以看到正常的操作量表为-160至160V。

下一步

继续读写数字渠道。