Wiki source code of LoRaWAN Communication Debug

Version 32.15 by Xiaoling on 2022/07/13 15:36

version	line-number	content
32.2	1	~ Table of Contents:
1.1	2
	3	{{toc/}}
	4
	5
30.2	6
1.1	7	= 1. OTAA Join Process Debug =
	8
32.3	9
1.1	10	These pages are useful to check what is wrong on the Join process. Below shows the four steps that we can check the Join Process.
2.1	11	\\If user has checked below steps and still can't solve the problem, please send us (support @ dragino.com) the sceenshots for each step to check. They include:
1.1	12
	13	* End node console to show the Join freuqency and DR. (If possible)
	14	* Gateway (from gateway UI) traffic to show the packet got from end node and receive from Server. (If possible)
	15	* Gateway traffic (from server UI) to shows the data exchange between gateway and server. (Normaly possible)
	16	* End Node traffic (from server UI) to shows end node activity in server. (Normaly possible)
	17	* End Node Keys screen shot shows in end node and server. so we can check if the keys are correct. (In most case, we found keys doesn't match, especially APP EUI)
	18
	19
32.14	20
	21	(% style="color:blue" %)1. End Device Join Screen shot, we can check:
	22
1.1	23	* If the device is sending join request to server?
	24	* What frequency the device is sending?
	25
23.2	26	[[image:image-20220526164956-15.png]]
1.1	27
	28	Console Output from End device to see the transmit frequency
	29
	30
32.14	31	(% style="color:blue" %)2. Gateway packet traffic in gateway web or ssh. we can check:
1.1	32
	33	* If the gateway receive the Join request packet from sensor? (If this fail, check if the gateway and sensor works on the match frequency)
	34	* If the gateway gets the Join Accept message from server and transmit it via LoRa?
	35
10.2	36	[[image:image-20220526163608-2.png]]
1.1	37
	38	Console Output from Gateway to see packets between end node and server.
	39
	40
32.14	41	(% style="color:blue" %)3. Gateway Traffic Page in LoRaWAN Server
1.1	42
	43	* If the Join Request packet arrive the gateway traffic in server? If not, check the internet connection and gateway LoRaWAN server settings.
	44	* If the server send back a Join Accept for the Join Request? if not, check if the keys from the device match the keys you put in the server, or try to choose a different server route for this end device.
	45	* If the Join Accept message are in correct frequency? If you set the server to use US915 band, and your end node and gateway is EU868, you will see the Join Accept message are in US915 band so no possible to Join success.
	46
13.2	47	[[image:image-20220526163633-3.png]]
1.1	48
	49	The Traffic for the End node in the server, use TTN as example
	50
	51
32.14	52	(% style="color:blue" %)4. Data Page in LoRaWAN server
1.1	53
	54	* If this data page shows the Join Request message from the end node? If not, most properly you have wrong settings in the keys. Keys in the server doesn't match the keys in End Node.
	55
13.2	56	[[image:image-20220526163704-4.png]]
1.1	57
	58	The data for the end device set in server
	59
13.2	60	[[image:image-20220526163732-5.png]]
1.1	61
	62	Check if OTAA Keys match the keys in device
	63
	64
2.1	65	= 2. Notice of US915/CN470/AU915 Frequency band =
1.1	66
32.3	67
4.2	68	(((
1.1	69	If user has problem to work with lorawan server in band US915/AU915/CN470, he can check:
4.2	70	)))
1.1	71
4.2	72	* (((
	73	What sub-band the server support ?
	74	)))
	75	* (((
	76	What is the sub-band the gateway support ?
	77	)))
	78	* (((
	79	What is the sub-band the end node is using ?
	80	)))
1.1	81
4.2	82	(((
1.1	83	All of above should match so End Node can properly Join the server and don't have packet lost.
4.2	84	)))
1.1	85
4.2	86	(((
	87
	88	)))
	89
	90	(((
1.1	91	In LoRaWAN protocol, the frequency bands US915, AU915, CN470 each includes at least 72 frequencies. Many gateways support only 8 or 16 frequencies, and server might support 8 frequency only. In this case, the OTAA join time and uplink schedule is long and unpredictable while the end node is hopping in 72 frequencies, because the end node will send data in many frequency that the gateway or server doesn,t support.
4.2	92	)))
1.1	93
4.2	94	(((
	95
	96	)))
	97
	98	(((
1.1	99	Here are the freuqency tables for these bands as reference:
4.2	100	)))
1.1	101
14.2	102	[[image:image-20220526163801-6.png]]
1.1	103
	104	US915 Channels
	105
18.2	106	[[image:image-20220526163926-7.png]]
1.1	107
	108	AU915 Channels
	109
32.3	110
18.2	111	[[image:image-20220526163941-8.png]]
1.1	112
4.4	113	(((
1.1	114	CN470 Channels
32.3	115
	116
4.4	117	)))
1.1	118
4.3	119	(((
1.1	120	If we look at the [[TTN network server frequency plan>>url:https://www.thethingsnetwork.org/docs/lorawan/frequency-plans.html]], we can see the US915 frequency band use the channel 8~~15.So the End Node must work at the same frequency in US915 8~~15 channels for TTN server.
4.3	121	)))
1.1	122
18.2	123	[[image:image-20220526164052-9.png]]
1.1	124
4.4	125	(((
1.1	126	TTN FREQUENCY PLAN
32.3	127
	128
4.4	129	)))
1.1	130
4.3	131	(((
1.1	132	In dragino end node, user can use AT+CHE command to set what frequencies set the end node will use. The default settings for Dragino end node are preconfigure for TTN server, so use 8~~15 channels, which is AT+CHE=2. (AT+CHE=1 for first 8 channels, AT+CHE=2 for second 8 channels.. etc, and AT+CHE=0 for all 72 channels. )
4.3	133	)))
1.1	134
	135
2.1	136	= 3. Why i see data lost/unperiocially uplink data? Even the signal strength is good =
1.1	137
32.3	138
1.1	139	In this case, we can check if the frequency band matches in End Node, Gateway and LoRaWAN server. A typical case is using US915 in ChirpStack server as below:
	140
2.1	141	* End node ~-~-> Use Sub-band2 (Channel 8,9,10,11,12,13,14,15) for Dragino Sensor. ADR is also enable, this is the default settings for dragino sensors.
	142	* Gateway ~-~-> Use Sub-band2 (Channel 8,9,10,11,12,13,14,15) for Dragino Gateway. this is the default settings for dragino sensors.
	143	* LoRaWAN server ~-~-> ChirpStack default installation and use Sub-band1, enabled_uplink_channels=[0, 1, 2, 3, 4, 5, 6, 7] in the file chirpstack-network-server.toml.
1.1	144
4.3	145	(((
1.1	146	When Sensor power on, it will use sub-band2 to join the network, the frequency matches the settings in gateway so all Join Request will be passed to the server for Join. Server will ask the sensor to change to Sub-band1 in the Join Accept downlink message. Sensor will change to sub-band1 for data upload. This cause the sensor and gateway have different frequencies so user see lost of most data or even no data.
4.3	147	)))
1.1	148
4.3	149	(((
	150
	151	)))
	152
	153	(((
1.1	154	Use Subband2 as a default subband cause the sensor to have problem to work with the LoRaWAN server which use other subband, and use need to access to the end node to change the subband by console. that is not user frendily,. So since Dragino LoRaWAN Stack version DLS-005(release on end of 2020), we have changed the device to use All Subbands for OTAA join, for example, device will use the first frequency in Sub-Band1 as firt OTAA join packet, then use the first frequency in Sub-Band 2 , then first frequency in sub-band 3, and so on. LoRaWAN server will normally provide the required subband in the OTAA accept process, so end node will know what subband it use after join. If LoRaWAN server doesn't provide subband info in OTAA join, end node will use the subband which join success as the working subband. So the new method cause a longer OTAA Join time but will be compatible with all LoRaWAN server. And new method won't affect the normal uplink after Join Success.
4.3	155	)))
1.1	156
	157
2.1	158	= 4. Transmision on ABP Mode =
1.1	159
32.3	160
4.3	161	(((
1.1	162	In ABP mode, there is a Frame Counter Checks. With this check enabled, the server will only accept the frame with a higher counter. If you reboot the device in ABP mode, the device will start from count 0, so you won't be able to see the frame update in server.
4.3	163	)))
1.1	164
4.3	165	(((
	166
	167	)))
	168
	169	(((
1.1	170	So in ABP mode, first check if the packet already arrive your gateway, if the packet arrive gatewat but didn't arrive server. Please check if this is the issue.
4.3	171	)))
1.1	172
4.3	173	(((
	174
	175	)))
	176
	177	(((
1.1	178	To solve this, disable the Frame Counter Check will solve this issue , or reset the frame counter in the device page.
4.3	179	)))
1.1	180
18.2	181	[[image:image-20220526164508-10.png]]
1.1	182
	183	Disable Frame Counter Check in ABP Mode
	184
	185
2.1	186	= 5. Downstream Debug =
1.1	187
2.1	188	== 5.1 How it work ==
1.1	189
32.3	190
1.1	191	LoRaWAN End node will open two receive windows to receive the downstream data. If the downstream packets arrive the end node at these receive windows, the end node will be able to get this packet and process it.
	192
4.3	193	(((
1.1	194	Depends on Class A or Class C, the receive windows will be a little difference,
4.3	195	)))
1.1	196
31.2	197	[[image:image-20220531161828-1.png]]
1.1	198
	199	receive windows for Class A and Class C
	200
32.3	201
1.1	202	Below are the requirement for the End Device to receive the packets.
	203
	204	* The End Device must open the receive windows: RX1 or RX2
	205	* The LoRaWAN server must send a downstream packet, and the gateway forward this downstream packet for this end node.
	206	* This downstream packet must arrive to the end node while RX1 or RX2 is open.
	207	* This packet must match the frequency of the RX1 or RX2 window.
32.3	208	* This packet must match the DataRate of RX1(RX1DR) or RX2 (RX2DR). (% style="color:red" %)This is the common fail point, because different lorawan server might use different RX2DR and they don't info End Node via ADR message so cause the mismatch. If this happen, user need to change the RX2DR to the right value in end node. In OTAA, LoRaWAN Server will send the RX2DR setting in Join Accept message so the end node will auto adjust. but ABP uplink doesn't support this auto change.
1.1	209
32.15	210
	211
	212
2.1	213	== 5.2 See Debug Info ==
1.1	214
32.3	215
4.6	216	(((
32.3	217	(% style="color:blue" %)For LoRaWAN Server
4.6	218	)))
1.1	219
4.6	220	(((
1.1	221	We can check if there is downlink message for this end node, use TTN for example:
4.6	222	)))
1.1	223
4.6	224	(((
1.1	225	Configure a downstream to the end device
4.6	226	)))
1.1	227
22.2	228	[[image:image-20220526164623-12.png]]
1.1	229
4.6	230	(((
1.1	231	Set a downstream in TTN and see it is sent
4.6	232	)))
1.1	233
	234
4.3	235	(((
1.1	236	This downstream info will then pass to the gateway downstream list. and include the DR which is used (SF9BW125) in EU868 is DR3
4.3	237	)))
1.1	238
22.2	239	[[image:image-20220526164650-13.png]]
1.1	240
4.6	241	(((
1.1	242	Gateway Traffic can see this downstream info
4.6	243	)))
1.1	244
	245
4.6	246	(((
32.3	247	(% style="color:blue" %)For LoRaWAN Gateway
4.6	248	)))
1.1	249
4.3	250	(((
1.1	251	When the downstream packet appear on the traffic of Gateway page. The LoRaWAN gateway can get it from LoRaWAN server and transmit it. In Dragion Gateway, this can be checked by runinng "logread -f" in the SSH console. and see below:
4.3	252	)))
1.1	253
22.2	254	[[image:image-20220526164734-14.png]]
1.1	255
4.6	256	(((
1.1	257	Gateway Sent out this packet
4.6	258	)))
1.1	259
	260
4.6	261	(((
32.3	262	(% style="color:blue" %)For End Node
4.6	263	)))
1.1	264
4.8	265	(((
1.1	266	we can use AT Command (AT+CFG) to check the RX1 configure and RX2 configure. as below:
4.8	267	)))
1.1	268
4.9	269	(((
32.4	270	(% style="color:#037691" %)AT+RX2FQ=869525000 (%%) ~-~--> The RX2 Window frequency
	271	(% style="color:#037691" %)AT+RX2DR=3 (%%) ~-~--> The RX2 DataRate
	272	(% style="color:#037691" %)AT+RX1DL=1000 (%%) ~-~--> Receive Delay 1
	273	(% style="color:#037691" %)AT+RX2DL=2000 (%%) ~-~--> Receive Delay 2
	274
4.9	275
	276	)))
	277
	278	(((
32.3	279	(% style="color:blue" %)when the device running, we can see below info:
4.7	280	)))
1.1	281
4.8	282	{{{ [12502]*** UpLinkCounter= 0 ***
	283	[12503]TX on freq 868500000 Hz at DR 0
	284	[13992]txDone
4.13	285	[15022]RX on freq 868500000 Hz at DR 0 --> RX1 window open at frequency: 868500000, DR0, after 15022-13992= 1030ms of txdone
	286	[15222]rxTimeOut --> no packet arrive in RX1 window. (duration: 200ms)
	287	[15987]RX on freq 869525000 Hz at DR 3 --> RX2 window open at frequency: 869525000, DR3, after 15987-13992= 1995ms of txdone
	288	[16027]rxTimeOut --> no packet arrive in RX2 window. (duration: 40 ms)}}}
1.1	289
4.3	290	(((
4.5	291
	292	)))
	293
4.7	294	(((
32.3	295	(% style="color:blue" %)Another message:
4.7	296	)))
4.5	297
4.8	298	{{{ [12502]*** UpLinkCounter= 0 ***
	299	[12503]TX on freq 868100000 Hz at DR 0
	300	[13992]txDone
	301	[15022]RX on freq 868100000 Hz at DR 0
	302	[15222]rxTimeOut
	303	[15987]RX on freq 869525000 Hz at DR 3
4.13	304	[16185]rxDone --> We have got the downstream packet.
4.8	305	Rssi= -64
	306	Receive data
	307	1:0012345678}}}
4.5	308
22.2	309
32.6	310	== 5.3 If problem doesn't solve ==
1.1	311
32.6	312
23.2	313	(% style="color:red" %)If user has checked below steps and still can't solve the problem, please send us (support @ dragino.com) the sceenshots for each step to check. They include:
1.1	314
	315	* End node console to show the transmit freuqency and DR.
	316	* Gateway (from gateway UI) traffic to show the packet got from end node and receive from Server.
	317	* Gateway traffic (from server UI) to shows the data exchange between gateway and server.
	318	* End Node traffic (from server UI) to shows end node activity in server.
	319
32.6	320
	321
2.1	322	= 6. Downlink Issue ~-~- Packet REJECTED, unsupported frequency =
1.1	323
32.7	324
4.5	325	(((
1.1	326	In LoRaWAN, the gatewat will use the frequency specify by the server to transmit a packet as downlink purpose. Each Frequency band has different downlink frequency. and the gateway has a frequency range limited to transmit downlink.
4.5	327	)))
1.1	328
4.5	329	(((
	330
	331	)))
	332
	333	(((
1.1	334	So if the LoRaWAN server is an AS923 server which ask the gateway to transmit at 923.2Mhz frequency, but the gateway is IN868 frequency band (support 865~~867Mhz to transmit). In the gateway log it will show something like below:
4.5	335	)))
1.1	336
4.7	337	{{{Sat Nov 21 08:04:17 2020 daemon.info lora_pkt_fwd[1680]: ERROR~ Packet REJECTED, unsupported frequency - 923200000 (min:865000000,max:867000000)}}}
1.1	338
4.5	339	(((
4.6	340
	341	)))
	342
	343	(((
1.1	344	In this case, please double check the gateway frequency and the server frequency band.
4.5	345	)))
1.1	346
	347
2.1	348	= 7. Decrypt a LoRaWAN Packet =
1.1	349
	350
32.7	351	(% style="color:blue" %)1. LHT65 End device configure:
1.1	352
32.7	353	Change to ABP Mode: AT+NJM=0
	354	Change to fix frequency: AT+CHS=904900000
	355	Change to fix DR: AT+DR=0
	356
32.12	357
29.2	358	[[image:image-20220526165525-16.png]]
1.1	359
29.2	360
32.7	361	(% style="color:blue" %)2. In LG02 , configure to receive above message
1.1	362
29.2	363	[[image:image-20220526165612-17.png]]
1.1	364
29.2	365
1.1	366	In LG02 console, we can see the hex receive are:
	367
29.2	368	[[image:image-20220526171112-21.png]]
1.1	369
29.2	370
32.7	371	(% style="color:blue" %)3. Decode the info in web
1.1	372
	373	[[https:~~/~~/lorawan-packet-decoder-0ta6puiniaut.runkit.sh>>url:https://lorawan-packet-decoder-0ta6puiniaut.runkit.sh/]]
	374
	375	Need these three fields:
	376
	377	LoRa packet hex format: 40c1190126800100024926272bf18bbb6341584e27e23245 (from LG02)
	378
	379	AT+NWKSKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 01 11 (End node Network Session Key)
	380
	381	AT+APPSKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 01 11 (End Node App Session Key)
	382
32.9	383
1.1	384	[[https:~~/~~/lorawan-packet-decoder-0ta6puiniaut.runkit.sh/?data=40c1190126800100024926272bf18bbb6341584e27e23245&nwkskey=00000000000000000000000000000111&appskey=00000000000000000000000000000111>>url:https://lorawan-packet-decoder-0ta6puiniaut.runkit.sh/?data=40c1190126800100024926272bf18bbb6341584e27e23245&nwkskey=00000000000000000000000000000111&appskey=00000000000000000000000000000111]]
	385
29.2	386	[[image:image-20220526171029-20.png]]
1.1	387
4.10	388	(((
4.11	389	The FRMPayload is the device payload.
4.10	390	)))
1.1	391
	392
2.1	393	= 8. Why i see uplink 0x00 periodcally on the LHT65 v1.8 firmware =
1.1	394
32.9	395
1.1	396	Since firmware v1.8, LHT65 will send MAC command to request time, in the case if DR only support max 11 bytes, this MAC command will be bundled to a separate uplink payload with 0x00.
	397
29.3	398
2.1	399	= 9. Why do I see a "MIC Mismatch" error message from the server? =
1.1	400
32.9	401
4.7	402	(((
32.9	403	1) If the user receives a "MIC Mismatch" message after registering the node on the server.
4.7	404	)))
1.1	405
4.7	406	(((
1.1	407	It is likely that the user filled in the wrong APPKEY when registering the node. Many users fill in "APPSKEY".
4.7	408	)))
1.1	409
4.7	410	* (((
	411	Please note the distinction between "APPKEY" and "APPSKEY".
	412	)))
1.1	413
4.7	414	(((
1.1	415	2）If the node works on the server for a period of time, the device stops working and receives a "MIC Mismatch" message.
4.7	416	)))
1.1	417
4.7	418	(((
1.1	419	The user needs a USB-TTL adapter to connect the serial port to modify the node APPKEY.
4.7	420	)))
1.1	421
4.7	422	* (((
	423	If a node is registered with multiple servers, it may also cause the "mic mismatch" error.
5.1	424
32.9	425
	426
5.1	427
4.7	428	)))
1.1	429
2.1	430	= 10. Why i got the payload only with "0x00" or "AA~=~="? =
1.1	431
32.9	432
4.16	433	* If you are using US915, AU915 and AS923 frequencies.This is normal phenomenon.
1.1	434
4.7	435	(((
4.19	436	When using the frequency mentioned above, the server sometimes adjusts the rate of the node, because the node defaults to the adaptive rate.
4.7	437	)))
1.1	438
4.7	439	(((
4.19	440	When the server adjusts your node rate to 0, the maximum payload length is 11 bytes. The server sometimes sends an ADR packet to the node,and the node will reply to the server after receiving the ADR packet, but the number of payload bytes exceeds the limit,so it will send a normal uplink packet, and an additional 00 data packet.
4.7	441	)))
1.1	442
4.7	443	* (((
	444	Solution: Use the decoder to filter out this 00 packet.
	445	)))
	446	* (((
6.1	447	Some node decoders may not have filtering function, or you need decoders of other servers and formats. Please send an email to [[david.huang@dragino.cc>>mailto:david.huang@dragino.cc]]
	448
32.9	449
	450
6.1	451
4.7	452	)))
1.1	453
5.1	454	= 11. Why my Dev EUI and APP EUI is 0x000000000000, how to solve? =
	455
32.9	456
29.4	457	(((
7.1	458	It is possible the keys is erased during upgrading of firmware. and the console output shows below after AT+CFG
29.4	459	)))
5.1	460
29.4	461	(((
5.1	462	AT+APPKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
29.4	463	)))
5.1	464
29.4	465	(((
5.1	466	AT+NWKSKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
29.4	467	)))
5.1	468
29.4	469	(((
5.1	470	AT+APPSKEY=00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
29.4	471	)))
5.1	472
29.4	473	(((
5.1	474	AT+APPEUI=00 00 00 00 00 00 00 00
29.4	475	)))
5.1	476
29.4	477	(((
	478
	479	)))
5.1	480
29.4	481	(((
5.1	482	You can get the keys from the box sticker or send mail to Dragino Support to check keys with the provided SN number.
29.4	483	)))
5.1	484
29.4	485	(((
5.1	486	You can rewrites the keys by running commands in AT Console
32.9	487
	488
29.4	489	)))
5.1	490
29.4	491	(((
	492	For example：
	493	)))
5.1	494
29.4	495	(((
8.1	496	AT+APPKEY=85 41 47 20 45 58 28 14 16 82 A0 F0 80 0D DD EE
29.4	497	)))
5.1	498
29.4	499	(((
8.1	500	AT+NWKSKEY=AA CC B0 20 30 45 37 32 14 1E 14 93 E2 3B 20 11
29.4	501	)))
8.1	502
29.4	503	(((
8.1	504	AT+APPSKEY=11 23 02 20 30 20 30 60 80 20 20 30 30 20 10 10
29.4	505	)))
8.1	506
29.4	507	(((
8.1	508	AT+APPEUI=2C 45 47 E3 24 12 23 24
29.4	509	)))
8.1	510
29.4	511	(((
8.1	512	(Any combination of 16 bit codes can be used）
32.1	513
	514
	515	= 12. I set my device is LoRaWAN Class C mode, why i still see Class A after boot? =
29.4	516	)))
8.1	517
	518
32.1	519	Class C only refers to status after OTAA Join successfully. The OTAA Join Process will use Class A mode.
	520
	521
	522
29.3	523	(% class="wikigeneratedid" %)
	524

Wiki source code of LoRaWAN Communication Debug

Applications

Navigation