【开源】智慧农业盒子（4G_GPS）之【4G接入ShineBlink免开发云+小程序】

功能概述：

ShineBlink 提供了一款极易接入的免开发云，并且可以自动生成小程序，用户无需自己开发云和小程序，即可拥有一个小程序显示一些定制化的数据内容。参考本文档可实现将各种传感器、 GPS 定位信息（经度，纬度）这些数据，在 ShineBlink 免开发云小程序上显示。

显示的内容如下：

Json对象	描述	类型	单位	值域
Id	设备唯一标识	字符串	无	无
Lo	定位经度	浮点数	度
La	定位纬度	浮点数	度
T	环境温度	整数(带负数)	0.1℃	-400~800
H	环境湿度	整数	%	0-1000
W	土壤含水率实时值	整数	0.1%	0-1000
S	土壤温度	整数(带负数)	0.1℃	-400~800
U	土壤电导率实时值	整数	1us/cm	0~20000us
P	土壤PH实时值	整数	0.1	30~90
Ni	氮含量暂存值	整数	mg/Kg	0-2999
Ph	磷含量暂存值	整数	mg/Kg	0-2999
Po	钾含量暂存值	整数	mg/Kg	0-2999
C	环境二氧化碳浓度	整数	ppm	0-5000
L	光照强度值	整数	100Lux	0-2000
B	电池电压	浮点数	V	0~15.9

小程序上显示的内容举例如下：

--经度28.311，纬度112.892，温度26.1度，湿度%98.2，土壤含水量33.7%，土壤温度28.0度，土壤电导率
--15400us，土壤PH值7.4，氮含量1300mg/KG，磷含量1100mg/KG，钾含量1000mg/KG，二氧化碳浓度1500ppm，
--光照强度值123400Lux，电池电压11.8v
{Id=Box01 Lo=28.311 La=112.892 T=261 H=982 W=337 S=280 U=15400 P=74 Ni=1300 Ph=1100 Po=1000 C=1500 L=1234 B=11.8}

步骤一：接线

• 在12V DC端口上接12V电源
• 在CH1端口上接温湿度传感器
• 在CH2端口上接土壤环境传感器
• 在CH3端口上接土壤氮磷钾传感器
• 在CH4端口上接二氧化碳传感器
• 在CH5端口上接光照强度传感器

步骤二：拷贝代码

首先断开设备电源取出设备电路板上的TF卡，将TF插入电脑，接着将 /Code/ 文件夹中的 main.lua 代码文件拷贝覆盖至该 TF 卡。

步骤三：更新配置信息

在 TF 卡中用记事本或者其他代码文本编辑器打开 main.lua 代码文件，用户需编辑文件开头部分的 配置信息 ，替换成实际信息然后 ctrl+S 保存即可，最后给设备重新上电，如果绿灯闪烁完成说明程序更新成功，如果红灯亮起说明代码有问题，可以打开 TF 卡上的LOG.TXT文件查看报错信息（比如Lua语法错误）。需要更改的配置信息如下：

这里只需关心 Part1，Part2 参数即可，其他 Part 参数可查看代码中的注释。

----------------------配置信息开始----------------------
--Part1: 系统配置
SysMode = 2 --0:4G_TCP, 1:4G_Mqtt, 2:4G_ShineBlinkCloud
SysGpsUse = "AUTO_AGPS" --NO_GPS: 不带GPS功能, AUTO_AGPS:带GPS功能
SysWorkInterval = 10 --单位秒，系统采集传感器并发送数据的间隔周期。
--如果SysSleepEn=1，则SysWorkInterval周期间隔内会断电进入低功耗状态
SysSleepEn = 1 --0:不使用低功耗休眠 1：使用。
--SysMyID可任意设定，用作设备的唯一标识，
--也可以用LIB_GetSysUniID()函数获取的芯片唯一ID，形如"761A6617E803F78402"
SysMyID = "Box01" -- SysMyID = LIB_GetSysUniID()
--定义magic number，每次修改将触发序号计数器清零
MagicNumber = 555 --改成任意值即会触发

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

（1）工作模式配置

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

（2）GPS 功能开启

[SysGpsUse] 需设置成 “AUTO_AGPS”，这样上传给服务器的 Json 信息也将包含经度(Longtitude)，纬度(Latitude)。如果你所在的地方无GPS信号，建议设置成“NO_GPS”，这样可以省掉GPS搜星时间，减少设备工作时间周期和功耗。

（3）采集传输工作周期设置（休眠时长）

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

（4）低功耗休眠功能开启

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

步骤四：开始工作

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

白色：表明刚上电

红色：表明已检测到 Sim 卡

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

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

步骤五：ShineBlink 免开发云微信小程序使用

（1）使用方法

手机微信扫码，扫码后如果设备连上服务器，即可在小程序中看到设备上传的传感器数据。

（2）二维码生成方法

二维码的生成需要使用到设备的UID（唯一ID），UID可以在LOG.TXT中开头的部分找到，具体生成方法可以参考如下教程：

https://gitee.com/shine_blink/tutorials/tree/master/ShineBlinkCloud