说明
参数:
名称 | 值 |
---|---|
服务器 | i.a-diy.cn |
端口 | 9001 |
本服务器免费提供给广大sHMIctrl用户,主要供广大用户测试,因为是免费提供,因此:
- 服务器升级代码期间可能会短暂停止服务(几分钟),不提前公告
- 服务器设计容量5000客户端(前期按1000开放),超过可能出现连接不上
- 不承诺永久服务
- 不建议商用用户选择此服务器,商业用户如果需要自行安装服务器,我司可提供人员配合,但需要适度收费。
- 本服务器目前未设置用户加密方案(主要考虑用户方便),如未来用户增加,可能会考虑,用户验证方案可在商用服务器建设中提出。
客户端协议
客户端是指远端的客户端(PC、手机、8266等)进行的TCP访问,也就是访问该tcpserver的端口后,向该端口发送一个字符串\r\n结束,#>开头的认为是命令,需要调用命令处理程序,用于处理,并返回处理结果的字符串 - #>AB:xxxxx 为标准格式,AB为2字节命令,xxxx为可显示字符
命令 | 参数 | 描述 | 返回值 |
---|---|---|---|
LG | {id} | 登录 | 1-登录成功 2-登录失败 3-已经登录 |
GT | - | 获取服务器时间 | 2019:01:01:12:00:00 |
AT | - | 心跳测试 | OK |
- 非命令数据直接透传,如果要发#>开头的数据,需要发送##>
- 需要识别是服务器传来,还是adm传来传输识别:
字符串头 | 描述 | 例子 |
---|---|---|
S: | TCP服务器传来的数据 | S:00:OK |
C: | 客户端传来的数据 | C:OK |
P: | API端口传来的数据 | P:undefinedH2] |
比如:
#>LG:123
S:00:OK //登录正常
S:01:登录失败
S:02:已经登录
S:03:其他错误
#>GT:
S:2019:01:01:12:00:00
#>AT:
S:OK
P:SET0ON //管理端口发来的控制命令
服务器API
服务器提供http协议的API,通过API可以很方便的给客户端传信息,API格式如下:
http://i.a-diy.cn/tool/a.php?id={id}&msg={msg}
其中:
名称 | 说明 |
---|---|
id | 客户端综合编号,俗称设备码 |
msg | 需要向客户端发送的内容 |
其中,id=getsn(4); 可由getsn语句获取;app.id中存储;