玄道智控平台

# 中控机插件控制使用手册

⽂档版本 内容修订 修订⼈ 修订⽇期
V1.0 初稿 邵首纯 2024-12-03

# 目录

# 一：中控机插件应用场景

  1. 需求来源 部分项目需要控制多个串口设备，但是电脑很难支持多个串口设备使用，所以需要一个能通过网络协议转发串口协议的中控主机，进行指令转发。但是中控主机需要加特定的指令作为前后缀，然后还需要计算校验和等操作，所以需要一个插件进行统一计算和转发。
  2. 支持的功能
    • KINGV中控主机串口指令的转发
    • KINGV中控主机自带的弱电继电器的控制
    • 串口服务器的串口指令转发

# 二：中控机插件使用说明

  1. 插件提供的接口 插件提供了一个post接口

    /sansi/centralControl/send/commond [post]

    都通过这个接口进行指令的发送

    post的body规范：

{
	"centralControl": [      //可以添加多个中控主机
	  {
		"COMMsg": [      //可以添加多个控制端口
		  {
			"baud": 9600,      //波特率，当设备是中控主机时需要填，填控制端口的波特率
			"body": "0110000e0001020000a77e",     //body是指需要发送的内容
			"checksum": 0,                //校验位，默认为0，也可以是偶校验1，奇校验2
			"port": 7018,                 //端口是设备上的端口号，如果是中控主机则是1-16对应com1到com16，如果是串口服务器，写对应的端口即可
			"type": "Serial"             //只有中控主机才需要这个参数： Serial（串口）、Relay（弱电继电器）
		  }
		],
		"ip": "192.168.1.181",              //中控主机的ip或者串口服务器的ip
		"port": 1024,                       //只有中控主机才需要填这个中控主机的端口
		"type": "VirtualSerialServer"       //设备类型 VirtualSerialServer、CentralControl
	  }
	]
}
  1. json实例

    • 中控主机串口

      {
	"centralControl": [
	  {
		"COMMsg": [
		  {
			"ExtMsg": "string",
			"baud": 9600,
			"body": "AABBCC0203",
			"checksum": 0,
			"port": 1,
			"type": "Serial"
		  }
		],
		"ip": "192.168.1.10",
		"port": 1024,
		"type": "CentralControl"
	  }
	]
   }

    • 中控主机弱电继电器

      {
	"centralControl": [
	  {
		"COMMsg": [
		  {
			"ExtMsg": "string",
			"baud": 9600,
			"body": "AA 05 00 03 01 01 00 0D",
			"checksum": 0,
			"port": 1,
			"type": "Relay"
		  }
		],
		"ip": "192.168.1.10",
		"port": 1024,
		"type": "CentralControl"
	  }
	]
   }

      继电器body中的内容

      闭合1：AA 05 00 03 01 01 00 0D
断开1：AA 05 00 03 01 00 00 0D

闭合2：AA 05 00 03 02 01 00 0D
断开2：AA 05 00 03 02 00 00 0D

闭合3：AA 05 00 03 03 01 00 0D
断开3：AA 05 00 03 03 00 00 0D

闭合4：AA 05 00 03 04 01 00 0D
断开4：AA 05 00 03 04 00 00 0D

闭合5：AA 05 00 03 05 01 00 0D
断开5：AA 05 00 03 05 00 00 0D

闭合6：AA 05 00 03 06 01 00 0D
断开6：AA 05 00 03 06 00 00 0D

闭合7：AA 05 00 03 07 01 00 0D
断开7：AA 05 00 03 07 00 00 0D

闭合8：AA 05 00 03 08 01 00 0D
断开8：AA 05 00 03 08 00 00 0D

    • 串口服务器

      {
	"centralControl": [
	  {
		"COMMsg": [
		  {
			"ExtMsg": "string",
			"baud": 9600,
			"body": "0110000e0001020000a77e",
			"checksum": 0,
			"port": 7018,
			"type": "Serial"
		  }
		],
		"ip": "192.168.1.181",
		"port": 1024,
		"type": "VirtualSerialServer"
	  }
	]
   }
  2. 如何使用
    • 访问ccspro
    • 在基本元素中找到按钮
    • 添加http事件,通信类型选择post，加入url（http://127.0.0.1:3490/sansi/centralControl/send/commond），
    • 添加上面教程中的实例稍作修改

具体如图所示：

1733214150786