调用CreateEdgeInstanceChannel和UpdateEdgeInstanceChannel接口，配置Configs.N.Content参数，可参照本文编写配置内容，传入键值对配置（KV）或JSON格式内容。

官方Modbus驱动通道配置说明

Modbus驱动Configs.N.Content内容根据传输模式不同，格式也不同，示例如下：

  • 传输模式为RTU时： 
    {
    "protocol": "RTU", 
    "serialPort": "/dev/tty0", 
    "baudRate": 1200, 
    "byteSize": 8, 
    "parity": 1, 
    "stopBits": 2
}
    表 1. Modbus驱动通道配置参数说明（RTU）
    名称 是否必选 类型 描述
    protocol 是 String 通道传输模式，取值为RTU。
    serialPort 是 String 设置串口，如/dev/tty0、/dev/tty1。支持英文字母、数字、正斜杠（/）和下划线（_），长度限制1~64字符。
    baudRate 是 Integer 波特率，即每秒传送的符号个数。有如下14种取值：

    300、600、1200、1440、2400、4800、9600、19200、38400、43000、56000、57600、115200、230400
    byteSize 是 Integer 数据位，即一组数据实际包含的数据位数。取值为5~8范围内的整数。
    parity 是 Integer 校验位，取值如下：
    • 1：表示无校验
    • 2：表示奇校验
    • 3：表示偶校验
    stopBits 是 Integer 停止位，即表示单个包的最后一位。取值为1或2。
  • 传输模式为TCP时： 
    {
    "protocol": "TCP", 
    "ip": "192.168.1.2", 
    "port": 122
}
    表 2. Modbus驱动通道配置参数说明（TCP）
    名称 是否必选 类型 描述
    protocol 是 String 传输模式。取值为TCP。
    ip 是 String Modbus设备IP地址，输入点分十进制格式的地址。
    port 是 Integer Modbus设备端口号，输入1~65535范围的整数。
  • 传输模式为LoRa LAN时： 
    {
  "protocol": "LoRaLAN",
  "devEUI": "d896e00009******",
  "devAddr": "66******",
  "nwkSKey": "e1336a94a03aa3beae55b737ac******",
  "appSKey": "623bd505f042090b5af6609545******",
  "class": "C",
  "upFPort": 10,
  "downFPort": 10
}
    表 3. Modbus驱动通道配置参数说明（LoRa LAN）
    参数 是否必选 类型 描述
    protocol 是 String 传输模式。取值为LoRaLAN。
    devEUI 是 String 设备扩展的唯一标识符。请填写16位十六进制数值。
    devAddr 是 String 设备地址。请填写8位十六进制数值。
    appSKey 是 String 应用会话密钥。请填写32位十六进制数值。
    nwkSKey 是 String 网络会话密钥。请填写32位十六进制数值。
    class 是 String 通信节点的特定类。有A、B和C三种特定类。
    upFPort 是 String 上行应用端口，取值范围为1~223。
    downFPort 是 String 下行应用端口，取值范围为1~223。

官方OPC UA驱动通道配置说明

OPC UA驱动Configs.N.Content格式示例如下：

{
    "url": "opc.tcp://localhost:4840", 
    "secPolicy": "None", 
    "secMode": "None", 
    "userName": "liniotkedge", 
    "password": "123456", 
    "timeout": 10
}
表 4. OPC UA驱动通道配置参数说明
参数 是否必选 类型 描述
url 是 String 通道地址，长度限制为128字符。格式如下： 
<scheme>://<netloc>/<path>;<params>?<query>#<fragment>

其中：

  • <scheme>：取值为opc.tcp
  • <netloc>：取值格式为IP或域名:端口
  • <path>;<params>?<query>#<fragment>：可选项，通道地址后缀，支持英文大小写、数字、英文问号（?）、英文分号（;）、井号（#）、短划线（-）、正斜杠（/）、等号（=）和and符号（&）。

示例：opc.tcp://localhost:4840。

secPolicy 是 String 安全策略，即加密算法策略。取值如下：
  • None：不设置安全策略。
  • Basic128Rsa15：使用Basic128Rsa15安全策略。
  • Basic256：使用Basic256安全策略。
说明 若使用安全策略，则必须设置secMode安全模式（非None参数值），且上传数字证书和密钥证书，详情请参见本表格下方“设置安全策略的OPC UA驱动通道配置说明”。
secMode 是 String 安全模式，即签名类型。取值有None、Sign、SignAndEncrypt三种。
userName 是 String 设置用户名。
password 是 String 设置密码。
timeout 是 Integer 方法调用超时时间，单位为秒，取值范围为1~10。

设置安全策略的OPC UA驱动通道配置说明：

以调用UpdateEdgeInstanceChannel接口为例，如果配置驱动通道时设置安全策略，则接口请求示例如下：

{
    "RegionId": "cn-shanghai", 
    "Configs.1.Format": "JSON", 
    "Configs.1.Content": "{\"url\":\"opc.tcp://localhost:4840\",\"secPolicy\":\"Basic128Rsa15\",\"secMode\":\"Sign\",\"userName\":\"linkiotedge\",\"password\":\"123456\",\"timeout\":10}", 
    "Configs.2.Format": "FILE", 
    "Configs.2.Content": "https://nova-scene-cn-sh.oss-cn-shanghai.aliyuncs.com/config/bf839be*****4fd9bbcdb1/1572*****586/sshssssss.pem", 
    "Configs.2.Key": "certificate", 
    "Configs.3.Format": "FILE", 
    "Configs.3.Content": "https://nova-scene-cn-sh.oss-cn-shanghai.aliyuncs.com/config/bf839be6351*****b14fd9bbcdb1/1572*****664/EC2PWD.pem", 
    "Configs.3.Key": "privateKey", 
    "InstanceId": "rTEbQzh*****pDty61AE", 
    "DriverId": "0769ebc7*****f62e36f11f80a5", 
    "ChannelName": "OPCUA通道_有证书"
}

驱动配置相关参数说明如下：

表 5. UpdateEdgeInstanceChannel接口示例参数说明
参数 描述
Configs.1.Content 根据官方OPC UA驱动通道配置说明编写的配置内容。
注意 其中：
  • secPolicy参数设置了Basic128Rsa15或Basic256的参数值。
  • secMode参数设置了Sign或SignAndEncrypt的参数值。

因此，需要上传数字证书和密钥证书。
Configs.2.Key和Configs.3.Key 表示文件标识符，类型为String，取值如下：
  • certificate：数字证书。
  • privateKey：密钥证书。
Configs.2.Content和Configs.3.Content 表示数字证书和密钥证书的OSS（对象存储）地址，类型为String。支持.der和.pem格式的文件。
说明 调用OSS接口，上传证书文件到OSS的操作请参见对象存储API参考。

官方WebSocket驱动通道配置说明

WebSocket驱动Configs.N.Content格式示例如下：

{
    "serverIp": "192.168.0.0", 
    "serverPort": 17682, 
    "tlsSwitch": 0
}
表 6. WebSocket驱动通道配置参数说明
参数 是否必选 类型 描述
serverIp 是 String IP地址，即WebSocket驱动监听地址，默认为驱动所在机器的IP地址。
serverPort 是 Integer WebSocket驱动监听端口，取值范围为1 ~ 65535，默认端口为17682。
tlsSwitch 是 Integer TLS加密开关，取值如下：
  • 0：不使用TLS认证加密。
  • 1：使用TLS加密认证。
    说明 若使用TLS加密认证，则需要上传公钥文件和私钥文件，详情请参见本表格下方“使用TLS加密认证的驱动通道配置说明”。

默认取值为0。

使用TLS加密认证的驱动通道配置说明：

以调用UpdateEdgeInstanceChannel接口为例，如果使用TLS加密认证，则接口请求示例如下：

{
    "RegionId": "cn-shanghai", 
    "Configs.1.Format": "JSON", 
    "Configs.1.Content": "{\"serverIp\":\"0.0.0.1\",\"serverPort\":17682,\"tlsSwitch\":1}", 
    "Configs.2.Format": "FILE", 
    "Configs.2.Content": "https://nova-scene-cn-sh.oss-cn-shanghai.aliyuncs.com/config/bf839be635****e86b14fd9bbcdb1/1572****61547/sss.cer", 
    "Configs.2.Key": "publicKey", 
    "Configs.3.Format": "FILE", 
    "Configs.3.Content": "https://nova-scene-cn-sh.oss-cn-shanghai.aliyuncs.com/config/bf839be6351****6b14fd9bbcdb1/15725****5984/fds-(10).pvk", 
    "Configs.3.Key": "privateKey", 
    "InstanceId": "rTEbQzh****pDty61AE", 
    "DriverId": "5c3da6b3a87b****91a2f338e4ffd"
}

驱动配置相关参数说明如下：

表 7. UpdateEdgeInstanceChannel接口示例参数说明
参数 描述
Configs.1.Content 根据表 6编写的配置内容。
注意 其中，tlsSwitch取值为1，因此需要上传公钥文件和私钥文件。
Configs.2.Key和Configs.3.Key 表示文件标识符，类型为String，取值如下：
  • publicKey：公钥文件。
  • privateKey：私钥文件。
Configs.2.Content和Configs.3.Content 表示公钥文件和私钥文件的OSS（对象存储）地址，类型为String。支持.cer和.pvk格式的文件。
说明 调用OSS接口，上传文件到OSS的操作请参见对象存储API参考。

LoRa WAN驱动通道配置说明

LoRa WAN驱动Configs.N.Content格式示例如下：

{
  "devEUI": "d896e00009******",
  "devAddr": "66******",
  "nwkSKey": "e1336a94a03aa3beae55b737ac******",
  "appSKey": "623bd505f042090b5af6609545******",
  "class": "C",
  "upFPort": 10,
  "downFPort": 10
}
表 8. 参数说明
参数 是否必选 类型 描述
devEUI 是 String 设备扩展的唯一标识符。请填写16位十六进制数值。
devAddr 是 String 设备地址。请填写8位十六进制数值。
appSKey 是 String 应用会话密钥。请填写32位十六进制数值。
nwkSKey 是 String 网络会话密钥。请填写32位十六进制数值。
class 是 String 通信节点的特定类。有A、B和C三种特定类。
upFPort 是 String 上行应用端口，取值范围为1~223。
downFPort 是 String 下行应用端口，取值范围为1~223。