【开源】4G远程GPS定位器 之 【4G+GPS TCP云服务教程】

功能概述：

参考本文档可实现将GPS 定位信息（经度，纬度，UTC 时间），通过 TCP 传输给远端的云服务器。发送的 TCP 消息 Json 字符串形式举例如下：

{"Uid":"Test01","Longtitude":119.2,"Latitude":26.1,"UTC":1679488305}

步骤一：接线

• 通过 DC 座或者端子座的 “+” 和 “-” 给设备提供 5-24V 电源
• "A" 和 "B" 接 485 总线的 A 和 B 端
• "ANT1" SMA 接口接 4G 天线，"ANT2" SMA 接口接 GPS 天线

步骤二：拷贝代码

首先用 TypeC USB 数据线将设备和电脑连接，然后在电脑上会自动出现一个 1.6MB 大小的 U 盘（如果 U 盘大小是 0MB，则需用 FAT32 快速格式化该盘），接着将 /Code/ 文件夹中的 main.lua 代码文件拷贝覆盖至该 U 盘。

步骤三：更新配置信息

在 U 盘中用记事本或者其他代码文本编辑器打开 main.lua 代码文件，用户需编辑文件开头部分的 配置信息 ，替换成实际信息然后 ctrl+S 保存即可，最后拔掉 USB 线，设备此时如果仍有供电，则会自动耗时 2 秒时间更新代码，否则设备下次上电时会自动耗时 2 秒时间更新代码。需要更改的配置信息如下：

这里只需关心 Part1，Part2 参数即可。

----------------------配置信息开始----------------------
--Part1: 系统配置
SysMode = 0 --0:4G_TCP, 1:4G_Mqtt
SysGpsUse = "AUTO_AGPS" --NO_GPS: 不带GPS功能, AUTO_AGPS:带GPS功能
SysWorkInterval = 10 --单位秒，系统采集传感器并发送数据的间隔周期。
--如果SysSleepEn=1，则SysWorkInterval周期间隔内会断电低功耗
SysSleepEn = 0 --0:不使用低功耗休眠 1：使用。该功能必须外挂BateryFriend才有用
--SysMyID可任意设定，用作设备的唯一标识，
--也可以用LIB_GetSysUniID()函数获取的芯片唯一ID，形如"761A6617E803F78402"
SysMyID = "Test01" -- SysMyID = LIB_GetSysUniID()

--Part2: Tcp参数（SysMode=0时才有用）
TcpServerIp = "122.114.122.174" --需要连接的服务器IP地址
TcpServerPort = 33210 --需要连接的服务器端口号

----------------------配置信息结束----------------------

（1）工作模式配置

[SysMode] 需设置成 0 ，表示设备以 4G_TCP 模式工作。

（2）GPS 功能开启

[SysGpsUse] 需设置成 "AUTO_AGPS"，这样上传给服务器的 Json 信息也将包含经度(Longtitude)，纬度(Latitude)，以及UTC时间戳。

（3）TCP 服务器配置

[TcpServerIp] 需设置为远端 TCP 云服务器的 IP 地址或者域名

[TcpServerPort] 需设置为远端 TCP 云服务器的端口号

（4）采集传输工作周期设置

[SysWorkInterval] 该值设置的越大工作采样和传输间隔时间越长，这样可以减少 Sim 卡流量的消耗，建议结合实际情况设置，单位秒。

（5）低功耗休眠功能开启（需外挂 BatteryFriend ）

[SysSleepEn] 设置为 1 时将开启低功耗功能。当该功能开启后，设备每次采集并传输完数据后将进入休眠状态，休眠时间为 [SysWorkInterval] 秒，休眠期间设备的电流仅为 uA 级别。

注意1：如果没有外挂 BatteryFriend 电池低功耗管理硬件设备， [SysSleepEn] 即使设置为 1 也不会有低功耗休眠功能！

注意2：BatteryFriend 和本设备配合使用的教程请访问本地址。

步骤四：开始工作

上电后观察设备的 LED 指示灯状态：

白色：表明刚上电

红色：表明已检测到 Sim 卡

蓝色：表明已连上附近基站

绿色：表明已和服务器建立连接

测试方法：

如果没有远端 TCP 测试服务器，可暂时借用安信可提供的 TCP 透传测试云：

服务器接入实例教程请访问ShineBlink 的gitee开源仓库