TCP长连接物联网服务器李卓文

简介

　　物联网应用高性能TCP长连接服务器，单个设备赋有256字符存储空间（可存储256个中英文字符，但是设备标识占用14位，命令占用3位，所以最终可用的存储大小为239个中英文字符），服务器提供数据上传、数据查询、数据推送、时间查询、设备别名、在线状态查询等功能。

　　服务器心跳：20s一次，数据为‘ping’，连续第三次心跳发出后服务器将主动断开客户端连接，期间向服务器发送任意数据可重置心跳计数器。

　　服务器长期运行，可放心使用！问题反馈QQ：479846095。

使用说明

1. 接口：tcp.lifanko.cn:8282
2. 服务器建立TCP连接，服务器返回字符串【[HPU-IOT Server! By 1420-Lab]】
3. 向服务器发送注册信息以表明设备联网成功，格式：【login+设备标识】，设备标识长度必须为14位，内容自定义（因为是自定义设备标识，所以用户多的时候可能会发生重复，建议在确定自己的设备标志前先使用RXD+设备标识命令获取信息，如果服务器返回【New Device】，则说明该设备标识未被使用，若为其它内容请更换新的设备标识）；发送成功后服务器会立即回复：【loginOK】，表明注册设备成功。
4. 根据需求发送相应指令和数据，参考——功能说明

功能说明

以下内容中的举例，设备标识均假设为aaaaaaaaaaaaaa

• TXD：数据上传，格式为：【TXD+设备标识+数据】（例1：TXDaaaaaaaaaaaaaaI Am Data，例2：TXDaaaaaaaaaaaaaa我是数据），发送成功后服务器立即返回【TXDOK】
• RXD：数据查询，格式为：【RXD+设备标识】（例：RXDaaaaaaaaaaaaaa），服务器会立即返回【RXD+数据】（例：RXDI Am Data）
• STA：设备在线状态查询，格式为：【STA+设备标识】（例：STAaaaaaaaaaaaaaa），服务器会立即返回【STAonline】或【STAoffline】
• MOV：即时数据推送，格式为：【MOV+设备标识+要推送的数据】（例：MOVaaaaaaaaaaaaaaTurn on the light），服务器会立即返回【MOVOK】，若推送失败则返回【MOVFail】（原因：要推送的设备地址不存在或设备当前未联网）
• NAM：设备别名设置，格式为：【NAM+设备标识+别名】（例：NAMaaaaaaaaaaaaaa客厅开关），服务器会立即返回【NAMOK】
• ALI：设备别名查询，格式为【ALI+设备标识】（例：ALIaaaaaaaaaaaaaa），服务器会立即返回【ALI+别名】（例：ALI客厅开关）
• TIM：获取时间，格式为：【TIM】（例：TIM），服务器会立即返回12个字符，格式为：【TIM+年月日时分秒】（例：TIM180514183015，代表2018年5月14日18点30分15秒）

其它返回内容，参考——返回码

返回码

No Device：无设备标识所对应的设备

Too Long：数据过长，单次数据长度限制为256字符

额外说明

　　实际服务器会给每个设备标志分配两部分存储空间，分别用于存储设备别名和上传的数据，其中设备别名的空间为32位字符长度，数据的空间为256位字符长度，如果256个字符长度不够使用，则可以把设备别名的空间加以利用，所以实际可用存储空间为：【256+32=288】位字符长度。

特别注意：服务器返回的任何消息均以【\r\n】结尾。

文档（0.0.3）生效日期：2018/05/15 11:30