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

Version 69.12 by Xiaoling on 2023/05/16 11:28

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.11	281	\|(% style="width:50px" %)Size(bytes)\|(% style="width:42px" %)2\|(% style="width:42px" %)1\|(% style="width:42px" %)2\|(% style="width:42px" %)2\|(% style="width:42px" %)2\|(% style="width:42px" %)2\|(% style="width:42px" %)2\|(% style="width:42px" %)2\|(% style="width:42px" %)2\|(% style="width:42px" %)2\|(% style="width:42px" %)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
69.12	421
	422
64.2	423	== 4.2 Set Interrupt Mode ==
	424
68.5	425
32.1	426	Feature, Set Interrupt mode for GPIO_EXIT.
	427
65.12	428	(% style="color:#037691" %)AT Command: AT+INTMOD
32.1	429
69.4	430	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
	431	\|=(% 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
	432	\|(% style="width:154px" %)AT+INTMOD=?\|(% style="width:196px" %)Show current interrupt mode\|(% style="width:157px" %)(((
	433	0
	434	OK
	435	the mode is 0 =No interruption
	436	)))
	437	\|(% style="width:154px" %)AT+INTMOD=2\|(% style="width:196px" %)(((
	438	Set Transmit Interval
	439	~1. (Disable Interrupt),
	440	2. (Trigger by rising and falling edge)
	441	3. (Trigger by falling edge)
	442	4. (Trigger by rising edge)
	443	)))\|(% style="width:157px" %)OK
32.1	444
65.12	445	(% style="color:#037691" %)Downlink Command: 0x06
32.1	446
	447	Format: Command Code (0x06) followed by 3 bytes.
	448
	449	This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
	450
68.6	451	* Example 1: Downlink Payload: 06000000 ~/~/ Turn off interrupt mode
	452	* Example 2: Downlink Payload: 06000003 ~/~/ Set the interrupt mode to rising edge trigger
32.1	453
69.12	454
	455
65.10	456	== 4.3 Set the sensor delay time ==
	457
68.5	458
67.16	459	(((
54.1	460	Feature: Change the sensor delay time.
68.5	461
	462
67.16	463	)))
54.1	464
67.16	465	(((
62.1	466	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	467	)))
62.1	468
67.16	469	(((
55.1	470	The default delay is 1000ms.
67.16	471	)))
55.1	472
67.16	473	(((
65.12	474	(% style="color:#037691" %)AT Command: AT+SDELAY
69.4	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
65.12	489	(% style="color:#037691" %)Downlink Command: 0xA1
54.1	490
	491	Format: Command Code (0xA1) followed by 3 bytes time value.
	492
	493	If the downlink payload=A10007D0, it means set the sensor delay time to 0x0007D0=2000ms, while type code is A1.
	494
68.6	495	* Example 1: Downlink Payload: A10003E8 ~/~/ Set the sensor delay time = 1000ms
	496	* Example 2: Downlink Payload: A10007D0 ~/~/ Set the sensor delay time = 2000ms
54.1	497
69.12	498
	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
65.12	505	(% style="color:#037691" %)Downlink Command: 0xFA00
62.1	506
	507
64.2	508	== 4.5 Get Firmware Version Info ==
62.1	509
68.5	510
32.1	511	Feature: use downlink to get firmware version.
	512
65.12	513	(% style="color:#037691" %)Downlink Command: 0x26
32.1	514
69.5	515	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:500px" %)
	516	\|(% style="width:193px" %)Downlink Control Type\|(% style="width:57px" %)FPort\|(% style="width:91px" %)Type Code\|(% style="width:149px" %)Downlink payload size(bytes)
	517	\|(% style="width:193px" %)Get Firmware Version Info\|(% style="width:57px" %)Any\|(% style="width:91px" %)26\|(% style="width:149px" %)2
32.1	518
	519	* Reply to the confirmation package: 26 01
	520	* Reply to non-confirmed packet: 26 00
	521
	522	Device will send an uplink after got this downlink command. With below payload:
	523
	524	Configures info payload:
	525
69.5	526	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:520px" %)
69.9	527	\|(% 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	528	\|(% 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	529
65.12	530	(% style="color:#037691" %)Software Type(%%): Always 0x03 for GroPoint Air
32.1	531
	532
65.12	533	(% style="color:#037691" %)Frequency Band(%%):
65.10	534
32.1	535	*0x01: EU868
	536
	537	*0x02: US915
	538
	539	*0x03: IN865
	540
	541	*0x04: AU915
	542
	543	*0x05: KZ865
	544
	545	*0x06: RU864
	546
	547	*0x07: AS923
	548
	549	*0x08: AS923-1
	550
	551	*0x09: AS923-2
	552
41.1	553	*0x0A: AS923-3
32.1	554
41.1	555	*0x0B: AS923-4
	556
32.1	557
66.2	558	(% style="color:#037691" %)Sub-Band(%%): value 0x00 ~~ 0x08
32.1	559
	560
66.2	561	(% style="color:#037691" %)Firmware Version(%%): 0x0100, Means: v1.0.0 version
65.11	562
66.2	563
65.12	564	(% style="color:#037691" %)Sensor Type(%%):
65.11	565
32.1	566	0x01: LSE01
	567
	568	0x02: LDDS75
	569
	570	0x03: LDDS20
	571
	572	0x04: LLMS01
	573
	574	0x05: LSPH01
	575
	576	0x06: LSNPK01
	577
41.1	578	0x07: LDDS45
32.1	579
41.1	580	0x08: LSLP01
32.1	581
11.1	582
64.2	583	= 5. Use AT Command =
25.1	584
64.2	585	== 5.1 Access AT Commands ==
	586
68.5	587
25.1	588	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.
	589
65.6	590	(% 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	591
	592	Connection:
	593
	594	(% style="background-color:yellow" %) USB TTL GND <~-~-~-~-> GND
	595
	596	(% style="background-color:yellow" %) USB TTL TXD <~-~-~-~-> UART_RXD
	597
	598	(% style="background-color:yellow" %) USB TTL RXD <~-~-~-~-> UART_TXD
	599
	600
67.17	601	(((
25.1	602	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	603	)))
25.1	604
65.6	605	(% 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	606
66.3	607	Valid AT Command please check [[Configure Device>>\|\|anchor="H4.A0ConfigureGroPointAirviaATCommandorLoRaWANDownlink"]].
25.1	608
	609
68.7	610	= 6. Battery & Power Consumption =
28.1	611
	612
68.7	613	GroPoint Air uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
68.5	614
68.7	615	[[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	616
68.9	617
64.3	618	= 7. FAQ =
28.1	619
64.4	620	== 7.1 How to change the LoRa Frequency Bands/Region ==
18.1	621
68.5	622
24.1	623	You can follow the instruction here: [[how to upgrade image>>doc:Main.Firmware Upgrade Instruction for STM32 base products.WebHome\|\|anchor="H2.HardwareUpgradeMethodSupportList"]].
	624	When downloading the images, choose the required image file for download.
18.1	625
	626
64.4	627	= 8. Trouble Shooting =
18.1	628
66.4	629	== 8.1 AT Commands input doesn't work ==
18.1	630
	631
68.5	632	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	633
68.5	634
64.4	635	== 8.2 Why i see the payload is 7FFF? ==
	636
68.5	637
62.1	638	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	639
11.1	640
64.4	641	= 9. Order Info =
	642
68.5	643
66.4	644	Part Number: (% style="color:blue" %)GROPOINT AIR-M-XX
11.1	645
66.4	646	(% style="color:blue" %)XX(%%): The default frequency band
11.1	647
66.4	648	* (% style="color:red" %)AS923(%%): LoRaWAN AS923 band
	649	* (% style="color:red" %)AU915(%%): LoRaWAN AU915 band
	650	* (% style="color:red" %)EU433(%%): LoRaWAN EU433 band
	651	* (% style="color:red" %)EU868(%%): LoRaWAN EU868 band
	652	* (% style="color:red" %)KR920(%%): LoRaWAN KR920 band
	653	* (% style="color:red" %)US915(%%): LoRaWAN US915 band
66.5	654	* (% style="color:red" %)IN865(%%): LoRaWAN IN865 band
66.4	655	* (% style="color:red" %)CN470(%%): LoRaWAN CN470 band
11.1	656
64.4	657
16.1	658
64.4	659
68.5	660	= 10. Packing Info =
64.4	661
	662
67.20	663	(((
17.1	664	Package Includes:
67.20	665	)))
16.1	666
17.1	667	* GroPoint Air-M x 1
	668
67.20	669	(((
17.1	670	Dimension and weight:
67.20	671	)))
17.1	672
	673	* Device Size: cm
	674	* Device Weight: g
	675	* Package Size / pcs : cm
	676	* Weight / pcs : g

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

Applications