Wiki source code of GroPoint Air - LoRaWAN Multi Segment Soil Sensor Converter User Manual

Version 69.10 by Xiaoling on 2023/05/16 11:23

version	line-number	content
65.2	1
1.1	2
65.6	3	(% aria-label="image-20220530000243-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)
	4	(((
	5	(% data-widget="image" style="text-align:center" %)
	6	[[image:image-20220530000243-1.png\|\|height="332" width="531"]](% title="Click and drag to resize" %)
5.1	7
65.6	8	(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|height="15" role="presentation" title="Click and drag to move" width="15"]]
	9	)))
5.1	10
65.6	11
68.2	12
	13
	14
	15
	16
	17
65.2	18	Table of Contents：
1.1	19
65.6	20	(% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)
	21	(((
65.8	22
65.6	23	)))
7.1	24
65.8	25	{{toc/}}
64.2	26
	27
	28
	29
	30
	31
	32
	33	= 1. Introduction =
	34
	35	== 1.1 What is GroPoint Air ==
	36
	37
67.6	38	(((
2.1	39	The Dragino GroPoint is a (% style="color:blue" %)LoRaWAN Multi Soil Segment Converter(%%) for IoT of Agriculture. It is designed to connect to [[GroPoint Profile Multi-depth Soil moisture and temperature profile Sensor>>url:https://www.gropoint.com/products/soil-sensors/gropoint-profile]] and get GroPoint Profile’s reading and send it to IoT server via LoRaWAN wireless network.
67.6	40	)))
1.1	41
67.6	42	(((
3.1	43	(% style="color:blue" %)GroPoint Profile is plug-and-play with GroPoint Air(%%) to get soil moisture and send via wireless. GroPoint Profile is powered by GroPoint Air, (% style="color:blue" %)no need external power source(%%).
67.6	44	)))
1.1	45
67.6	46	(((
1.1	47	The LoRa wireless technology used in GroPoint Air allows devices to send data and reach extremely long ranges at low data-rates. It provides ultra-long range spread spectrum communication and high interference immunity whilst minimizing current consumption.
67.6	48	)))
1.1	49
67.6	50	(((
1.1	51	GroPoint Air is powered by (% style="color:blue" %)an 8500mAh Li-SOCI2 battery(%%), it is designed for long-term use for up to 5 years.
67.6	52	)))
1.1	53
67.6	54	(((
1.1	55	Each GroPoint Air is pre-load with a set of unique keys for LoRaWAN registrations, register these keys to the local LoRaWAN server and it will auto-connect after power on.
67.6	56	)))
1.1	57
65.10	58	(% aria-label="image-20220530002019-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220530002019-2.png\|\|data-widget="image" height="295" width="655"]](% title="Click and drag to resize" %)
1.1	59
	60
64.2	61	== 1.2 Features ==
1.1	62
68.5	63
11.1	64	* LoRaWAN 1.0.3 Class A
	65	* Ultra-low power consumption
	66	* Supports GroPoint Profile
	67	* Bands: CN470/EU433/KR920/US915/EU868/AS923/AU915/IN865
	68	* AT Commands to change parameters
	69	* Uplink on periodically
	70	* Downlink to change configure
	71	* IP66 Waterproof Enclosure
	72	* 8500mAh Battery for long term use
1.1	73
69.10	74
	75
64.2	76	== 1.3 Probe Specification ==
	77
68.5	78
67.7	79	(((
11.1	80	GroPoint Air includes an M12 5-pin connector, the pins definition matches GroPoint Profile M12 version probes. Users can connect this connector to GroPoint Profile directly.
67.7	81	)))
1.1	82
67.7	83	(((
12.1	84	GroPoint Profile includes a series of multi-depth soil moisture and temperature sensors. The specification for GroPoint Profile can be found here: [[https:~~/~~/www.gropoint.com/products/soil-sensors/gropoint-profile>>https://www.gropoint.com/products/soil-sensors/gropoint-profile]]
67.7	85	)))
1.1	86
	87
64.2	88	== 1.4 Applications ==
12.1	89
68.5	90
11.1	91	* Smart Agriculture
1.1	92
69.10	93
	94
64.2	95	== 1.5 Pin Mapping ==
	96
68.5	97
11.1	98	Inner PCB Pin mapping for reference:
	99
65.6	100	(% aria-label="image-20220530002453-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220530002453-3.png\|\|data-widget="image" height="262" width="493"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
11.1	101
	102
64.2	103	= 2. Connect LoRaWAN Network =
39.1	104
64.2	105	== 2.1 LED Indicator ==
36.1	106
68.5	107
38.1	108	The GroPoint Air has an internal LED which can show the status of different states.
	109
	110	* The sensor is detected when the device is turned on, and it will flash 4 times quickly when it is detected.
	111	* Blink once when device transmits a packet.
	112
69.10	113
	114
64.2	115	== 2.2 Firmware and Changelog ==
	116
68.5	117
65.3	118	(((
68.6	119	Firmware Download Location: [[https:~~/~~/www.dropbox.com/sh/xjj8dh5zs1zre20/AAB5pGtSHItnTrpPLUpRNJAYa?dl=0>>https://www.dropbox.com/sh/xjj8dh5zs1zre20/AAB5pGtSHItnTrpPLUpRNJAYa?dl=0]]
65.3	120	)))
36.1	121
65.3	122	(((
	123	Change Log:
	124	)))
36.1	125
65.3	126	(((
	127	v1.0: Release.
	128	)))
36.1	129
65.3	130
64.2	131	= 3. How to use? =
36.1	132
64.2	133	== 3.1 Connect to GroPoint Profile ==
42.1	134
68.5	135
67.8	136	(((
57.2	137	GroPoint Air must be used with [[GroPoint Profile>>https://www.gropoint.com/products/soil-sensors/gropoint-profile]]. There are different interface model from GroPoint, users need to choose the one:
67.8	138	)))
57.2	139
67.8	140	* (((
	141	Support RS485 Interface
	142	)))
	143	* (((
	144	with M12 5pin connector.
	145	)))
57.2	146
67.8	147	(((
65.5	148	Such model in GroPoint Profile is: (% style="color:blue" %)2625-N-T-x-M-M (%%)(Where x is different depending on how many levels it detects).
67.8	149	)))
57.2	150
	151
64.2	152	== 3.2 Connect to LoRaWAN Network? ==
57.2	153
68.5	154
42.1	155	Each GroPoint Air is shipped with a worldwide unique set of OTAA keys. To use GroPoint Air in a LoRaWAN network, user needs to input the OTAA keys in the LoRaWAN network server. So GroPoint Air can join the LoRaWAN network and start to transmit sensor data
	156
	157
64.2	158	== 3.3 Example to use for LoRaWAN network ==
42.1	159
68.5	160
67.10	161	(((
42.1	162	This section shows an example of how to join the TTN V3 LoRaWAN IoT server. Usages with other LoRaWAN IoT servers are similar.
67.10	163	)))
42.1	164
67.10	165	* (((
	166	In this use case, the GroPoint Air measures soil moisture and temperature and sends the status to the LoRaWAN server.The GroPoint Air will uplink different types of messages to the LoRaWAN server. See [[Uplink payload>>\|\|anchor="H3.4A0UplinkPayloadAnalyze"]] for detail.
	167	)))
42.1	168
67.10	169	(((
42.1	170	Assume the DLOS8 is already set to connect to the [[TTN V3 network >>url:https://eu1.cloud.thethings.network/]]. We need to add the GroPoint Air device in TTN V3:
67.10	171	)))
42.1	172
67.10	173	(((
	174
	175	)))
42.1	176
67.10	177	(((
65.5	178	(% style="color:blue" %)Step 1(%%): Create a device in TTN V3 with the OTAA keys from GroPoint Air.
67.10	179	)))
65.5	180
67.10	181	(((
42.1	182	Each GroPoint Air is shipped with a sticker with the default device EUI as below:
67.10	183	)))
42.1	184
69.4	185	[[image:image-20230426084611-1.png\|\|height="262" width="564"]](% style="display:none" %)
42.1	186
69.2	187	(% title="Click and drag to resize" %)
42.1	188
	189	Users can enter these keys in the LoRaWAN Server portal. Below is the TTN V3 screenshot:
	190
65.5	191	Add APP EUI in the application.
42.1	192
68.6	193	(% aria-label="image-20220519151704-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519151704-1.png?rev=1.1\|\|alt="image-20220519151704-1.png" data-widget="image"]]
42.1	194
68.6	195	(% title="Click and drag to resize" %)
42.1	196
68.6	197	(% aria-label="image-20220519151704-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519151704-2.png?width=717&height=322&rev=1.1\|\|alt="image-20220519151704-2.png" data-widget="image" height="322" width="717"]]
42.1	198
68.6	199	(% title="Click and drag to resize" %)
	200
	201	(% aria-label="image-20220519151704-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519151704-3.png?rev=1.1\|\|alt="image-20220519151704-3.png" data-widget="image"]]
	202
	203	(% title="Click and drag to resize" %)
	204
65.10	205	(% aria-label="image-20220519151704-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519151704-4.png?rev=1.1\|\|alt="image-20220519151704-4.png" data-widget="image"]](% title="Click and drag to resize" %)
42.1	206
65.5	207	Add APP KEY and DEV EUI
42.1	208
	209
65.5	210	(% style="color:blue" %)Step 2(%%): Power on GroPoint Air
	211
67.11	212	(% aria-label="image-20220519094347-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/image-20220519094347-1.png?width=725&height=430&rev=1.1\|\|alt="image-20220519094347-1.png" data-widget="image" height="430" width="725"]]
42.1	213
67.11	214	(% title="Click and drag to resize" %)
	215
	216	(((
42.1	217	Put the jumper to power on GroPoint Air and it will auto-join to the TTN V3 network. After join success, it will start to upload sensor data to TTN V3 and the user can see it in the panel.
67.11	218	)))
42.1	219
65.10	220	(% aria-label="image-20220611174943-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220611174943-1.png\|\|data-widget="image" height="139" width="1008"]](% title="Click and drag to resize" %)
42.1	221
44.1	222
69.4	223	(% style="display:none" %) (%%)
68.6	224
64.2	225	=== Decoder in TTN V3 ===
42.1	226
65.10	227	(% aria-label="1652927365661-475.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SW3L%20LoRaWAN%20Outdoor%20Flow%20Sensor/WebHome/1652927365661-475.png?width=723&height=359&rev=1.1\|\|alt="1652927365661-475.png" data-widget="image" height="359" width="723"]](% title="Click and drag to resize" %)
42.1	228
68.6	229	Please check the decoder [gropoint_Decoder_V1.0.0.js] from this link: [[https:~~/~~/github.com/dragino/dragino-end-node-decoder>>https://github.com/dragino/dragino-end-node-decoder]]
42.1	230
	231
64.2	232	== 3.4 Uplink Payload Analyze ==
56.2	233
68.5	234
67.12	235	(((
61.1	236	Uplink payloads have two types:
67.12	237	)))
56.2	238
61.1	239	* (((
67.12	240	(((
61.1	241	Report temperature and humidity status normally: Use FPORT=2
	242	)))
67.12	243	)))
61.1	244	* (((
67.12	245	(((
61.1	246	Other control commands: Use other FPORT fields.
	247	)))
67.12	248	)))
56.2	249
67.12	250	(((
61.1	251	The application server should parse the correct value based on FPORT settings.
67.12	252	)))
56.2	253
61.1	254
64.2	255	== 3.5 temperature and humidity Value, Uplink FPORT~=2 ==
61.1	256
	257
67.12	258	(((
61.1	259	GroPoint Air will send this uplink after Device Status once join the LoRaWAN network successfully. And GroPoint Air will:
67.12	260	)))
61.1	261
67.12	262	(((
61.1	263	periodically send this uplink every 20 minutes, this interval can be changed.
67.12	264	)))
61.1	265
67.12	266	(((
61.1	267	The drawing below shows the probe dimensions of the 2-8 segment probes, Temperature sen sor locations provided in table below:
67.12	268	)))
61.1	269
65.10	270	(% aria-label="image-20220621093414-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220621093414-1.png\|\|data-widget="image" height="932" width="816"]](% title="Click and drag to resize" %)
61.1	271
65.5	272	GroPoint Air's sensors come in six models: GPLP-2，GPLP-3，GPLP-4，GPLP-5，GPLP-6，GPLP-8.
61.1	273
	274	The amount of temperature and humidity is different for each model, so the payload of each model is different.
	275
	276	Take GPLP-3 as an example：
	277
	278	Uplink Payload totals 21 bytes.
	279
69.4	280	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
69.10	281	\|(% style="width:50px" %)Size(bytes)\|(% style="width:30px" %)2\|(% style="width:30px" %)1\|(% style="width:30px" %)2\|(% style="width:30px" %)2\|(% style="width:30px" %)2\|(% style="width:30px" %)2\|(% style="width:30px" %)2\|(% style="width:30px" %)2\|(% style="width:30px" %)2\|(% style="width:30px" %)2\|(% style="width:30px" %)2
69.4	282	\|(% style="width:94px" %)value\|(% style="width:38px" %)Bat\|(% style="width:39px" %)sen\|(% style="width:52px" %)Tem1\|(% style="width:52px" %)Tem2\|(% style="width:52px" %)Tem3\|(% style="width:52px" %)Tem4\|(% style="width:50px" %)Tem5\|(% style="width:52px" %)Tem6\|(% style="width:55px" %)Hum1\|(% style="width:55px" %)Hum2\|(% style="width:56px" %)Hum3
61.1	283
69.4	284	(% title="Click and drag to resize" %)
	285
65.10	286	(% aria-label="image-20220611174943-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220611174943-1.png\|\|data-widget="image" height="139" width="1008"]](% title="Click and drag to resize" %)
61.1	287
	288
67.13	289	(((
63.1	290	For US915 frequency, when DR=0 and the payload length exceeds 11, the DR of this packet is switched to 1.
67.13	291	)))
63.1	292
67.13	293	(((
64.1	294	For AU915 frequency, when DR=2，Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3.
67.13	295	)))
63.1	296
67.13	297	(((
64.1	298	For AS923 frequency, when DR=2，Dwelltime=1 and the payload length exceeds 11, the DR of this packet is switched to 3.
67.13	299	)))
64.1	300
42.1	301
64.2	302	== 3.6 Show data on Datacake ==
	303
68.5	304
67.14	305	(((
42.1	306	Datacake IoT platform provides a human-friendly interface to show the sensor data, once we have sensor data in TTN V3, we can use Datacake to connect to TTN V3 and see the data in Datacake. Below are the steps:
67.14	307	)))
42.1	308
67.14	309	(((
65.5	310	(% style="color:blue" %)Step 1(%%): Link TTNv3 to Datacake [[https:~~/~~/docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti>>url:https://docs.datacake.de/lorawan/lns/thethingsindustries#create-integration-on-tti]]
67.14	311	)))
42.1	312
67.14	313	(((
65.5	314	(% style="color:blue" %)Step 2(%%): Configure SW3L in Datacake
67.14	315	)))
42.1	316
69.4	317	(% aria-label="image-20220613171007-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171007-1.png\|\|data-widget="image" height="567" width="542"]]
42.1	318
69.4	319	(% title="Click and drag to resize" %)
	320
65.6	321	(% aria-label="image-20220613171015-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171015-2.png\|\|data-widget="image" height="600" width="586"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
42.1	322
65.6	323	(% aria-label="image-20220613171029-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171029-3.png\|\|data-widget="image" height="507" width="513"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
42.1	324
65.10	325	(% aria-label="image-20220613171038-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171038-4.png\|\|data-widget="image" height="469" width="786"]]
42.1	326
65.10	327	(% title="Click and drag to resize" %)
42.1	328
65.10	329	(% aria-label="image-20220613171105-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171105-5.png\|\|data-widget="image" height="533" width="949"]]
42.1	330
65.10	331	(% title="Click and drag to resize" %)
42.1	332
65.10	333	(% aria-label="image-20220613171117-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171117-6.png\|\|data-widget="image" height="501" width="925"]]
42.1	334
65.10	335	(% title="Click and drag to resize" %)
42.1	336
65.10	337	(% aria-label="image-20220613171124-7.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220613171124-7.png\|\|data-widget="image" height="466" width="877"]](% title="Click and drag to resize" %)
	338
	339
64.2	340	= 4. Configure GroPoint Air via AT Command or LoRaWAN Downlink =
32.1	341
68.5	342
67.15	343	(((
32.1	344	Use can configure GroPoint Air via AT Command or LoRaWAN Downlink.
67.15	345	)))
32.1	346
67.15	347	* (((
68.3	348	AT Command Connection: See [[FAQ>>\|\|anchor="H7.A0FAQ"]].
67.15	349	)))
	350	* (((
	351	LoRaWAN Downlink instruction for different platforms: [[IoT LoRaWAN Server>>url:http://8.211.40.43/xwiki/bin/view/Main/]]
	352	)))
32.1	353
67.15	354	(((
34.1	355	There are two kinds of commands to configure GroPoint Air, they are:
67.15	356	)))
32.1	357
	358	* (((
67.15	359	(((
65.12	360	~ (% style="color:#4472c4" %)General Commands(%%)(% style="color:#4472c4" %).
32.1	361	)))
67.15	362	)))
32.1	363
67.15	364	(((
32.1	365	These commands are to configure:
67.15	366	)))
32.1	367
67.15	368	* (((
	369	General system settings like: uplink interval.
	370	)))
	371	* (((
	372	LoRaWAN protocol & radio-related command.
	373	)))
32.1	374
67.15	375	(((
32.1	376	They are the same for all Dragino Device that support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki: [[End Device AT Commands and Downlink Command>>url:http://8.211.40.43/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
67.15	377	)))
32.1	378
	379
65.10	380
32.1	381	* (((
67.15	382	(((
65.12	383	~ (% style="color:#4472c4" %)Commands special design for GroPoint Air(%%)
32.1	384	)))
67.15	385	)))
32.1	386
67.15	387	(((
34.1	388	These commands only valid for GroPoint Air, as below:
67.15	389	)))
32.1	390
	391
64.2	392	== 4.1 Set Transmit Interval Time ==
	393
68.5	394
32.1	395	Feature: Change LoRaWAN End Node Transmit Interval.
	396
68.5	397
65.12	398	(% style="color:#037691" %)AT Command: AT+TDC
32.1	399
69.4	400	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	401	\|=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 137px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Response
	402	\|(% style="width:156px" %)AT+TDC=?\|(% style="width:137px" %)Show current transmit Interval\|(((
	403	30000
	404	OK
	405	the interval is 30000ms = 30s
	406	)))
	407	\|(% style="width:156px" %)AT+TDC=60000\|(% style="width:137px" %)Set Transmit Interval\|(((
	408	OK
	409	Set transmit interval to 60000ms = 60 seconds
	410	)))
32.1	411
65.12	412	(% style="color:#037691" %)Downlink Command: 0x01
32.1	413
	414	Format: Command Code (0x01) followed by 3 bytes time value.
	415
	416	If the downlink payload=0100003C, it means set the END Node’s Transmit Interval to 0x00003C=60(S), while type code is 01.
	417
68.6	418	* Example 1: Downlink Payload: 0100001E ~/~/ Set Transmit Interval (TDC) = 30 seconds
	419	* Example 2: Downlink Payload: 0100003C ~/~/ Set Transmit Interval (TDC) = 60 seconds
32.1	420
64.2	421	== 4.2 Set Interrupt Mode ==
	422
68.5	423
32.1	424	Feature, Set Interrupt mode for GPIO_EXIT.
	425
68.5	426
65.12	427	(% style="color:#037691" %)AT Command: AT+INTMOD
32.1	428
69.4	429	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	430	\|=(% style="width: 154px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 196px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="width: 157px;background-color:#D9E2F3;color:#0070C0" %)Response
	431	\|(% style="width:154px" %)AT+INTMOD=?\|(% style="width:196px" %)Show current interrupt mode\|(% style="width:157px" %)(((
	432	0
	433	OK
	434	the mode is 0 =No interruption
	435	)))
	436	\|(% style="width:154px" %)AT+INTMOD=2\|(% style="width:196px" %)(((
	437	Set Transmit Interval
	438	~1. (Disable Interrupt),
	439	2. (Trigger by rising and falling edge)
	440	3. (Trigger by falling edge)
	441	4. (Trigger by rising edge)
	442	)))\|(% style="width:157px" %)OK
32.1	443
69.4	444	(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
	445
65.12	446	(% style="color:#037691" %)Downlink Command: 0x06
32.1	447
	448	Format: Command Code (0x06) followed by 3 bytes.
	449
	450	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	451
68.6	452	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
	453	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
32.1	454
65.10	455	== 4.3 Set the sensor delay time ==
	456
68.5	457
67.16	458	(((
54.1	459	Feature: Change the sensor delay time.
68.5	460
	461
67.16	462	)))
54.1	463
67.16	464	(((
62.1	465	There are six models of GroPoint Air, and each model returns a different number of temperature and humidity. The more bytes of the returned value, the longer the delay. The AT+SDELAY command can adjust the time that the sensor returns data to the node, and can adjust different delays according to different types of sensors.
67.16	466	)))
62.1	467
67.16	468	(((
55.1	469	The default delay is 1000ms.
67.16	470	)))
55.1	471
67.16	472	(((
65.12	473	(% style="color:#037691" %)AT Command: AT+SDELAY
69.4	474
	475
	476	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	477	\|=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)Command Example\|=(% style="width: 137px;background-color:#D9E2F3;color:#0070C0" %)Function\|=(% style="background-color:#D9E2F3;color:#0070C0" %)Response
	478	\|(% style="width:156px" %)AT+SDELAY=?\|(% style="width:137px" %)Show the sensor delay time\|(((
	479	1000
	480	OK
	481	the sensor delay time is 1000ms
67.16	482	)))
69.4	483	\|(% style="width:156px" %)AT+SDELAY=2000\|(% style="width:137px" %)Set the sensor delay time\|(((
	484	OK
	485	Set the sensor delay time to 2000ms
	486	)))
	487	)))
54.1	488
69.4	489	(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
54.1	490
65.12	491	(% style="color:#037691" %)Downlink Command: 0xA1
54.1	492
	493	Format: Command Code (0xA1) followed by 3 bytes time value.
	494
	495	If the downlink payload=A10007D0, it means set the sensor delay time to 0x0007D0=2000ms, while type code is A1.
	496
68.6	497	* Example 1: Downlink Payload: A10003E8 ~/~/ Set the sensor delay time = 1000ms
	498	* Example 2: Downlink Payload: A10007D0 ~/~/ Set the sensor delay time = 2000ms
54.1	499
64.2	500	== 4.4 Query sensor model function ==
	501
68.5	502
62.1	503	Feature: Using this function will re-update the model.
	504
68.5	505
65.12	506	(% style="color:#037691" %)Downlink Command: 0xFA00
62.1	507
	508
64.2	509	== 4.5 Get Firmware Version Info ==
62.1	510
68.5	511
32.1	512	Feature: use downlink to get firmware version.
	513
68.5	514
65.12	515	(% style="color:#037691" %)Downlink Command: 0x26
32.1	516
69.5	517	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
	518	\|(% style="width:193px" %)Downlink Control Type\|(% style="width:57px" %)FPort\|(% style="width:91px" %)Type Code\|(% style="width:149px" %)Downlink payload size(bytes)
	519	\|(% style="width:193px" %)Get Firmware Version Info\|(% style="width:57px" %)Any\|(% style="width:91px" %)26\|(% style="width:149px" %)2
32.1	520
	521	* Reply to the confirmation package: 26 01
	522	* Reply to non-confirmed packet: 26 00
	523
	524	Device will send an uplink after got this downlink command. With below payload:
	525
	526	Configures info payload:
	527
69.5	528	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
69.9	529	\|(% style="width:50px" %)Size(bytes)\|(% style="width:70px" %)1\|(% style="width:70px" %)1\|(% style="width:50px" %)1\|(% style="width:70px" %)2\|(% style="width:60px" %)1\|(% style="width:50px" %)4\|(% style="width:100px" %)1
69.5	530	\|(% style="width:93px" %)Value\|(% style="width:114px" %)Software Type\|(% style="width:139px" %)Frequency Band\|(% style="width:149px" %)Sub-band\|(% style="width:149px" %)Firmware Version\|(% style="width:149px" %)Sensor Type\|(% style="width:63px" %)Reserve\|(% style="width:63px" %)Message Tpye Always 0x02
32.1	531
	532
65.12	533	(% style="color:#037691" %)Software Type(%%): Always 0x03 for GroPoint Air
32.1	534
	535
65.12	536	(% style="color:#037691" %)Frequency Band(%%):
65.10	537
32.1	538	*0x01: EU868
	539
	540	*0x02: US915
	541
	542	*0x03: IN865
	543
	544	*0x04: AU915
	545
	546	*0x05: KZ865
	547
	548	*0x06: RU864
	549
	550	*0x07: AS923
	551
	552	*0x08: AS923-1
	553
	554	*0x09: AS923-2
	555
41.1	556	*0x0A: AS923-3
32.1	557
41.1	558	*0x0B: AS923-4
	559
32.1	560
66.2	561	(% style="color:#037691" %)Sub-Band(%%): value 0x00 ~~ 0x08
32.1	562
	563
66.2	564	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
65.11	565
66.2	566
65.12	567	(% style="color:#037691" %)Sensor Type(%%):
65.11	568
32.1	569	0x01: LSE01
	570
	571	0x02: LDDS75
	572
	573	0x03: LDDS20
	574
	575	0x04: LLMS01
	576
	577	0x05: LSPH01
	578
	579	0x06: LSNPK01
	580
41.1	581	0x07: LDDS45
32.1	582
41.1	583	0x08: LSLP01
32.1	584
11.1	585
64.2	586	= 5. Use AT Command =
25.1	587
64.2	588	== 5.1 Access AT Commands ==
	589
68.5	590
25.1	591	GroPoint Air supports AT Command set in the stock firmware. You can use a USB to TTL adapter to connect to GroPoint Air for using AT command, as below.
	592
65.6	593	(% aria-label="1654593668970-604.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:Main.User Manual for LoRaWAN End Nodes.LLMS01-LoRaWAN Leaf Moisture Sensor User Manual.WebHome@1654593668970-604.png\|\|data-widget="image" height="297" width="474"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
25.1	594
	595	Connection:
	596
	597	(% style="background-color:yellow" %) USB TTL GND <~-~-~-~-> GND
	598
	599	(% style="background-color:yellow" %) USB TTL TXD <~-~-~-~-> UART_RXD
	600
	601	(% style="background-color:yellow" %) USB TTL RXD <~-~-~-~-> UART_TXD
	602
	603
67.17	604	(((
25.1	605	In the PC, you need to set the serial baud rate to (% style="color:green" %)9600(%%) to access the serial console for GroPoint Air. GroPoint Air will output system info once power on as below:
67.17	606	)))
25.1	607
65.6	608	(% aria-label="1654653659449-932.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:Main.User Manual for LoRaWAN End Nodes.LLMS01-LoRaWAN Leaf Moisture Sensor User Manual.WebHome@1654653659449-932.png\|\|data-widget="image" height="471" width="674"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
25.1	609
66.3	610	Valid AT Command please check [[Configure Device>>\|\|anchor="H4.A0ConfigureGroPointAirviaATCommandorLoRaWANDownlink"]].
25.1	611
	612
68.7	613	= 6. Battery & Power Consumption =
28.1	614
	615
68.7	616	GroPoint Air uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
68.5	617
68.7	618	[[Battery Info & Power Consumption Analyze>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
28.1	619
68.9	620
64.3	621	= 7. FAQ =
28.1	622
64.4	623	== 7.1 How to change the LoRa Frequency Bands/Region ==
18.1	624
68.5	625
24.1	626	You can follow the instruction here: [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome\|\|anchor="H2.HardwareUpgradeMethodSupportList"]].
	627	When downloading the images, choose the required image file for download.
18.1	628
	629
64.4	630	= 8. Trouble Shooting =
18.1	631
66.4	632	== 8.1 AT Commands input doesn't work ==
18.1	633
	634
68.5	635	In case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)ENTER(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)ENTER(%%) while pressing the send key, user need to add ENTER in their string.
18.1	636
68.5	637
64.4	638	== 8.2 Why i see the payload is 7FFF? ==
	639
68.5	640
62.1	641	The device will judge the length of the data received by the serial port. If the length of the received data is 0, it means that there is a problem with the sensor communication or the sensor is not connected properly, it is invalid data, and the uploaded data is 7FFF.
18.1	642
11.1	643
64.4	644	= 9. Order Info =
	645
68.5	646
66.4	647	Part Number: (% style="color:blue" %)GROPOINT AIR-M-XX
11.1	648
66.4	649	(% style="color:blue" %)XX(%%): The default frequency band
11.1	650
66.4	651	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	652	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	653	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	654	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	655	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	656	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
66.5	657	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
66.4	658	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
11.1	659
64.4	660
16.1	661
64.4	662
68.5	663	= 10. Packing Info =
64.4	664
	665
67.20	666	(((
17.1	667	Package Includes:
67.20	668	)))
16.1	669
17.1	670	* GroPoint Air-M x 1
	671
67.20	672	(((
17.1	673	Dimension and weight:
67.20	674	)))
17.1	675
	676	* Device Size: cm
	677	* Device Weight: g
	678	* Package Size / pcs : cm
	679	* Weight / pcs : g

Wiki source code of GroPoint Air - LoRaWAN Multi Segment Soil Sensor Converter User Manual

Applications