继电器控制与读取

注意：当 doNum>0 时，才支持此功能，doNum可在此页的info信息中查看

符号	数值	描述
DO_CTRL	101	DO控制，控制指令在info中
DO_CTRL_SUCCEED	102	DO控制成功
DO_CTRL_FAIL	103	DO控制失败
DO_CTRL_CMD_ERR	104	DO控制指令错误
DO_READ	105	读取DO状态，查询指令的内容放在info中
DO_READ_SUCCEED	106	读取DO状态成功
DO_READ_FAIL	107	读取DO状态失败
DO_STATUS	108	返回的DO状态数据
DO_DLY_CTRL	109	DO延时控制，当 doNum>1 时，才支持此功能
DO_DLY_CTRL_SUCCEED	110	DO延时控制成功
DO_DLY_CTRL_FAIL	111	DO延时控制失败
DO_DLY_CTRL_CMD_ERR	112	DO延时控制指令错误

1、DO控制

• 客户端发送

  {
    "userKey":"AAAAABBBBBCCCCCDDDDD",
    "msgCode":101,
    "info":{
        "requestId":"xxxxxxxx",
        "devSn":"ltC2luw5LXbmeoAx6fLM",
        "ch":1,
        "sta":1
    }
  }

  info信息说明如下:

数据名	数据类型	必选	描述
requestId	String	否	由二次开发端添加的requestId，最大长度不要超过40位字符串，可随机生成
devSn	String	否	当要对某个设备进行控制时，填上设备的devSn信息， 当要对当前开发者账号下所有设备时，此值为空即可
ch	int	是	0为当前设备的所有通道，>0时，1即通道1，2即通道2，依此类推
sta	int	是	0 - 自锁关，关闭后状态长保持，参数dlyTime、waitTime和times可忽略。查看示例 1 - 自锁开，开启后状态长保持，参数dlyTime、waitTime和times可忽略。查看示例 2 - 点动关，关闭后延时dlyTime时间再开启，参数waitTime和times可忽略。查看示例 3 - 点动开，开启后延时dlyTime时间再关闭，参数waitTime和times可忽略。查看示例 4 - 互锁延时，互锁通道关闭，本通道等待waitTime时间后开启，dlyTime固定为 100000，参数times可忽略。查看示例 5 - 互锁点动，互锁通道关闭，本通道等待waitTime时间后开启，开启后延时dlyTime时间再关闭，参数times可忽略。查看示例 6 - 循环，开启后延时dlyTime时间再关闭，关闭后等待waitTime时间再开启，循环次数达到times次后停止。查看示例 7 - 翻转，当前状态取反，开启转关闭，关闭转开启，参数dlyTime、waitTime和times可忽略。查看示例 注：互锁通道固定为 1 和 2，3 和 4，5 和 6
dlyTime	int	否	时间单位为秒或 100 毫秒，可通过 AT+DLYUNIT 指令设置，默认为秒 1…99999 - 点动关、点动开、互锁点动和循环模式的取值范围 100000 - 自锁关、自锁开、互锁延时和翻转模式固定为此值
waitTime	int	否	时间单位为秒或 100 毫秒，可通过 AT+DLYUNIT 指令设置，默认为秒 0…99999 - 互锁延时和互锁点动模式的取值范围 1…99999 - 循环模式的取值范围 100000 - 自锁关、自锁开、点动关、点动开和翻转模式固定为此值
times	int	否	1…999999 - 循环模式的循环次数 1000000 - 循环模式时此值为无限循环，非循环模式时固定为此值

• 以下为8种不同控制模式的示例，以单设备的通道1控制进行举例

  • 自锁关

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":101,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":0
      }
    }

  • 自锁开

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":101,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":1
      }
    }

  • 点动关：5秒

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":101,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":2,
          "dlyTime":5
      }
    }

  • 点动开：5秒

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":101,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":3,
          "dlyTime":5
      }
    }

  • 互锁延时：延时3秒开启

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":101,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":4,
          "waitTime":3
      }
    }

  • 互锁点动：延时3秒开启，开启5秒后关闭

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":101,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":5,
          "dlyTime":5,
          "waitTime":3
      }
    }

  • 循环:5秒延时，循环10次

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":101,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":6,
          "dlyTime":5,
          "times":10
      }
    }

  • 翻转

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":101,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":7
      }
    }

• 服务端响应示例，以设备通道1自锁关为例
  

  • 返回成功：此状态只有硬件响应OK时，才会返回，所以有一定的等待时间，一般在1秒内，客户端可以设置3秒超时

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":102,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":0
      }
    }

  • 返回失败

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":103,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":0
      }
    }

  • 返回指令错误

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":104,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1,
          "sta":6, #缺少其他参数
          "times":10 
      }
    }

2、读取DO状态，只能读取设备的某个通道或设备的所有通道

• 客户端发送，以读取设备的通道1为例

    {
        "userKey":"AAAAABBBBBCCCCCDDDDD",
        "msgCode":105,
        "info":{
            "requestId":"xxxxxxxx",
            "devSn":"ltC2luw5LXbmeoAx6fLM",
            "ch":1  #如果需要读取整个设备的所有通道，此值为0即可
        }
    }

• 服务端响应
  • 读取成功

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":106,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1
      }
    }

  • 读取失败

    {
      "userKey":"AAAAABBBBBCCCCCDDDDD",
      "msgCode":107,
      "info":{
          "requestId":"xxxxxxxx",
          "devSn":"ltC2luw5LXbmeoAx6fLM",
          "ch":1
      }
    }

3、DO状态信息

• 服务端响应

    {
        "userKey":"AAAAABBBBBCCCCCDDDDD",
        "msgCode":108,
        "info":[
            {
                "devSn":"ltC2luw5LXbmeoAx6fLM",
                "ch":1,
                "val":1,
                "dlyTime":5,
                "times":10
            },
            {
                "devSn":"ltC2luw5LXbmeoAx6fLM",
                "ch":2,
                "val":0,
                "dlyTime":3,
                "times":6
            }
        ]
    }

  info信息说明如下：

数据名	数据类型	描述
devSn	String	设备条码
ch	int	当前通道号
val	int	当前通道状态值，0为断开，1为吸合
dlyTime	int	延时时间
times	int	循环剩余次数

4、DO的延时控制

说明：当 doNum>1 时，才支持此功能。目前只支持延时自锁关、延时自锁开及退出延时控制

• 延时自锁关：示例为通道1到通道4，每通道间隔5秒执行自锁关
  • 客户端发送

      {
          "userKey":"AAAAABBBBBCCCCCDDDDD",
          "msgCode":109,
          "info":{
              "requestId":"xxxxxxxx",
              "devSn":"ltC2luw5LXbmeoAx6fLM",
              "en":1,
              "stCh":1,
              "endCh":4,
              "interval":5,
              "sta":0
          }
      }

  • 服务端响应
    • 返回成功

      {
        "userKey":"AAAAABBBBBCCCCCDDDDD",
        "msgCode":110,
        "info":{
            "requestId":"xxxxxxxx",
            "devSn":"ltC2luw5LXbmeoAx6fLM",
            "en":1,
            "stCh":1,#
            "endCh":4,
            "interval":5,
            "sta":0
        }
      }

    • 返回失败

      {
        "userKey":"AAAAABBBBBCCCCCDDDDD",
        "msgCode":111,
        "info":{
            "requestId":"xxxxxxxx",
            "devSn":"ltC2luw5LXbmeoAx6fLM",
            "en":1,
            "stCh":1,
            "endCh":4,
            "interval":5,
            "sta":0
        }
      }

    • 返回指令错误

      {
        "userKey":"AAAAABBBBBCCCCCDDDDD",
        "msgCode":112,
        "info":{
            "requestId":"xxxxxxxx",
            "devSn":"ltC2luw5LXbmeoAx6fLM",
            "en":1,
            "stCh":1,
            "endCh":1,#结束通道号必须大于起始通道号
            "interval":5,
            "sta":0
        }
      }

      info信息说明

数据名	数据类型	描述
requestId	String	否	由二次开发端添加的id，最大长度不要超过40位字符串，可随机生成
devSn	String	否	当要对某个设备进行控制时，填上设备的devSn信息， 当要对当前开发者账号下所有设备时，此值为空即可
en	int	0退出延时控制，1启动延时控制
stCh	int	起始通道号
endCh	int	结束通道号，结束通道号必须大于起始通道号
interval	int	相邻通道的动作间隔时间
sta	int	0为自锁关，1为自锁开

• 延时自锁开：示例为通道1到通道4，每通道间隔5秒执行自锁开
  • 客户端发送

      {
          "userKey":"AAAAABBBBBCCCCCDDDDD",
          "msgCode":109,
          "info":{
              "requestId":"xxxxxxxx",
              "devSn":"ltC2luw5LXbmeoAx6fLM",
              "en":1,
              "stCh":1,
              "endCh":4,
              "interval":5,
              "sta":1
          }
      }

  • 服务端响应
    查看上述返回
• 退出延时控制
  • 客户端发送

      {
          "userKey":"AAAAABBBBBCCCCCDDDDD",
          "msgCode":109,
          "info":{
              "requestId":"xxxxxxxx",
              "devSn":"ltC2luw5LXbmeoAx6fLM",
              "en":0 #为0即为退出
          }
      }

  • 服务端响应
    查看上述返回