Wiki source code of Notes for LORIOT
Version 68.1 by Kilight Cao on 2022/10/13 14:16
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | (% class="wikigeneratedid" %) | ||
2 | **~ Table of Contents:** | ||
3 | |||
4 | {{toc/}} | ||
5 | |||
6 | |||
7 | |||
8 | |||
9 | = 1. Introduction = | ||
10 | |||
11 | |||
12 | ((( | ||
13 | ((( | ||
14 | The Dragino LoRaWAN gateway can communicate with [[LORIOT>>url:https://www.loriot.io/]] LoRaWAN Network Server: | ||
15 | ))) | ||
16 | ))) | ||
17 | |||
18 | ((( | ||
19 | ((( | ||
20 | Below list the products and requirements that support communication with LORIOT using Semtech UDP: | ||
21 | ))) | ||
22 | ))) | ||
23 | |||
24 | ((( | ||
25 | ((( | ||
26 | 1.LoRaWAN Gateway model: [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]],[[LPS8N>>https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]],[[LG308N>>https://www.dragino.com/products/lora-lorawan-gateway/item/229-lg308n.html]] | ||
27 | |||
28 | ((( | ||
29 | ((( | ||
30 | 2.Firmware version since : [[lgw~~-~~-build-v5.4.1661158991-20220822-1704>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]] | ||
31 | |||
32 | |||
33 | ))) | ||
34 | ))) | ||
35 | |||
36 | Below list the products and requirements that support the use of LORIOT software: | ||
37 | ))) | ||
38 | ))) | ||
39 | |||
40 | 1.LoRaWAN Gateway model: [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]], [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]] | ||
41 | |||
42 | ((( | ||
43 | ((( | ||
44 | 2.Firmware version since :[[LG02_LG08~~-~~-build-v5.4.1590459021-20200526-1012>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]] | ||
45 | |||
46 | |||
47 | ))) | ||
48 | ))) | ||
49 | |||
50 | = 2. Gateway Registration for Semtech UDP = | ||
51 | |||
52 | == 2.1 Step 1: Get Gateway ETH0 MAC Address == | ||
53 | |||
54 | |||
55 | Dragino LoRaWAN gateway uses ETH0 MAC address to generate Gateway EUI to communicate with LORIOT, The user needs to find the ETH0 MAC in the "**System -> System Overview**" menu. | ||
56 | |||
57 | |||
58 | [[image:image-20220831110558-1.png||height="595" width="909"]] | ||
59 | |||
60 | |||
61 | == 2.2 Step 2: Register Gateway == | ||
62 | |||
63 | |||
64 | [[image:image-20220831111032-2.png||height="617" width="1263"]] | ||
65 | |||
66 | |||
67 | **Choose gateway model** | ||
68 | |||
69 | [[image:image-20220831111132-3.png||height="596" width="1223"]] | ||
70 | |||
71 | |||
72 | (% style="color:red" %)**Special reminder: **If the user does not find the gateway Model, then **git ~-~-> Packet Forwarder Semtech** can be selected | ||
73 | |||
74 | [[image:image-20220831115222-11.png||height="596" width="1221"]] | ||
75 | |||
76 | |||
77 | **Enter the ETH0 MAC of the gateway** | ||
78 | |||
79 | [[image:image-20220831111307-4.png||height="850" width="1237"]] | ||
80 | |||
81 | |||
82 | [[image:image-20220831111821-5.png||height="604" width="1239"]] | ||
83 | |||
84 | |||
85 | == 2.3 Step 3: Back to Semtech UDP page == | ||
86 | |||
87 | |||
88 | Back to the page of Semtech UDP check the secondary server settings and click the button of (% style="color:blue" %)**Save&Apply.** | ||
89 | |||
90 | (% class="box infomessage" %) | ||
91 | ((( | ||
92 | Server Address: ~-~-> LORIOT Different servers use different addresses, Such as: **next.loriot.io** | ||
93 | |||
94 | Uplink /Downlink Port : ~-~-> 1780 | ||
95 | ))) | ||
96 | |||
97 | [[image:image-20220831112553-7.png]] | ||
98 | |||
99 | |||
100 | |||
101 | == 2.4 Step 4: Check Connection == | ||
102 | |||
103 | |||
104 | ((( | ||
105 | LORIOT will show disconnect if Gateway doesn't connect | ||
106 | ))) | ||
107 | |||
108 | ((( | ||
109 | LORIOT will show connect if Gateway connect to LORIOT ok. | ||
110 | ))) | ||
111 | |||
112 | [[image:image-20220831114125-8.png||height="561" width="1150"]] | ||
113 | |||
114 | |||
115 | == 2.5 Trouble Shooting == | ||
116 | |||
117 | |||
118 | User can check the station log in the(% style="color:blue" %)** LogRead ~-~-> System Log **(%%)page. | ||
119 | |||
120 | [[image:image-20220831114647-9.png||height="706" width="894"]] | ||
121 | |||
122 | |||
123 | and recode the station log in the (% style="color:blue" %)** LogRead ~-~-> Recode Log**(%%) page. | ||
124 | |||
125 | [[image:image-20220831114746-10.png||height="292" width="972"]] | ||
126 | |||
127 | |||
128 | = 3. Gateways are connected using LORIOT software = | ||
129 | |||
130 | == 3.1 Step 1: Get Gateway ETH0 MAC Address == | ||
131 | |||
132 | |||
133 | ((( | ||
134 | Dragino LoRaWAN gateway use ETH0 MAC address to generate Gateway ID to communicate with LORIOT, User can get the ETH0 MAC address from SSH access and run **ifconfig** command. | ||
135 | |||
136 | |||
137 | ))) | ||
138 | |||
139 | [[image:image-20220524175559-2.png]] | ||
140 | |||
141 | Get ETH0 MAC address | ||
142 | |||
143 | |||
144 | ((( | ||
145 | (% style="color:red" %)**Note**: **To make set up more friendly, the ETH0 will show on the LORIOT page in a new firmware version.** | ||
146 | |||
147 | |||
148 | ))) | ||
149 | |||
150 | == 3.2 Step 2: Choose LORIOT service == | ||
151 | |||
152 | |||
153 | [[image:image-20220531182035-1.png]] | ||
154 | |||
155 | Choose to use LORIOT as LoRaWAN service provider | ||
156 | |||
157 | |||
158 | |||
159 | [[image:image-20220531182109-2.png]] | ||
160 | |||
161 | Install and choose the LORIOT server to be used | ||
162 | |||
163 | |||
164 | |||
165 | == 3.3 Step 3: Checking Connection Status == | ||
166 | |||
167 | |||
168 | [[image:image-20220531182202-3.png]] | ||
169 | |||
170 | Click to Home page and check the connection status | ||
171 | |||
172 | |||
173 | |||
174 | == 3.4 Step 4: Setup Account in LORIOT == | ||
175 | |||
176 | |||
177 | Login [[LORIOT>>url:https://www.loriot.io/]] and create account | ||
178 | |||
179 | [[image:image-20220531182253-4.png]] | ||
180 | |||
181 | Log in LORIOT portal | ||
182 | |||
183 | |||
184 | |||
185 | Choose to use the server same as the gateway setting | ||
186 | |||
187 | [[image:image-20220526111312-1.png||height="493" width="1098"]] | ||
188 | |||
189 | Choose server | ||
190 | |||
191 | |||
192 | |||
193 | Create a New Network | ||
194 | |||
195 | [[image:image-20220526111425-2.png||height="579" width="1378"]] | ||
196 | |||
197 | Create a New Network | ||
198 | |||
199 | |||
200 | [[image:image-20220526111500-3.png]] | ||
201 | |||
202 | Create a New Network | ||
203 | |||
204 | |||
205 | |||
206 | == 3.5 Step 5: Register the gateway == | ||
207 | |||
208 | |||
209 | [[image:image-20220526111650-4.png]] | ||
210 | |||
211 | Register the Gateway in LORIOT | ||
212 | |||
213 | |||
214 | |||
215 | Choose LG308 as gateway model | ||
216 | |||
217 | [[image:image-20220526111742-5.png||height="496" width="1372"]] | ||
218 | |||
219 | Choose LG308 as gateway model | ||
220 | |||
221 | |||
222 | |||
223 | Input Gateway ETH0 address | ||
224 | |||
225 | [[image:image-20220526111918-6.png||height="744" width="1336"]] | ||
226 | |||
227 | Choose SX1301 Reference and use SPI protocol | ||
228 | |||
229 | |||
230 | |||
231 | Choose the right Frequency Band and input location | ||
232 | |||
233 | [[image:image-20220526112029-7.png||height="620" width="1306"]] | ||
234 | |||
235 | Set up regional settings. | ||
236 | |||
237 | |||
238 | |||
239 | == 3.6 Step 6: Check Connection == | ||
240 | |||
241 | |||
242 | ((( | ||
243 | LORIOT will show disconnect if Gateway doesn't connect | ||
244 | ))) | ||
245 | |||
246 | ((( | ||
247 | LORIOT will show connect if Gateway connect to LORIOT ok. | ||
248 | |||
249 | |||
250 | ))) | ||
251 | |||
252 | [[image:image-20220526112143-8.png||height="654" width="1373"]] | ||
253 | |||
254 | Status: Connected | ||
255 | |||
256 | |||
257 | |||
258 | == 3.7 Debug If there is connection issue == | ||
259 | |||
260 | |||
261 | User can check if loriot is running by checking the web ui | ||
262 | |||
263 | |||
264 | [[image:image-20220526112917-18.png]] | ||
265 | |||
266 | Status: Connected | ||
267 | |||
268 | |||
269 | ((( | ||
270 | If user want to see more log, he can run below commands in Linux and see the full log: | ||
271 | ))) | ||
272 | |||
273 | (% class="box" %) | ||
274 | ((( | ||
275 | ((( | ||
276 | ps | grep "loriot_dragino" | grep -v grep | awk '{print $1}' | xargs kill -s 9 | ||
277 | /usr/bin/loriot_dragino_lg308_spi -f -s eu1.loriot.io | ||
278 | ))) | ||
279 | ))) | ||
280 | |||
281 | ((( | ||
282 | |||
283 | |||
284 | Above two commands will first kill the loriot process and run it again to get more output. | ||
285 | ))) | ||
286 | |||
287 | [[image:image-20220530145011-1.png]] | ||
288 | |||
289 | Get more debug info | ||
290 | |||
291 | |||
292 | |||
293 | = 4. End Device Note = | ||
294 | |||
295 | == 4.1 Downlink Setup == | ||
296 | |||
297 | |||
298 | [[image:image-20220530145133-2.png]] | ||
299 | |||
300 | |||
301 | [[image:image-20220526112416-11.png]] | ||
302 | |||
303 | |||
304 | [[image:image-20220526112459-12.png]] | ||
305 | |||
306 | |||
307 | [[image:image-20220526112537-13.png]] | ||
308 | |||
309 | |||
310 | [[image:image-20220526112608-14.png||height="610" width="1382"]] | ||
311 | |||
312 | |||
313 | [[image:image-20220526112655-15.png]] | ||
314 | |||
315 | |||
316 | [[image:image-20220526112719-16.png]] | ||
317 | |||
318 | |||
319 | [[image:image-20220526112759-17.png||height="483" width="1386"]] |