Wiki source code of Notes for LORIOT
Version 73.1 by Kilight Cao on 2023/11/01 16:37
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 :[[dragino-LORIOT~~-~~-v5.4.1676942123-squashfs-sysupgrade.bin>>http://repo.dragino.com/release/openwrt-firmware/lgw/dragino-LORIOT--v5.4.1676942123-squashfs-sysupgrade.bin]] | ||
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 "(% style="color:blue" %)**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 | (% style="color:blue" %)**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 (% style="color:blue" %)**git ~-~-> Packet Forwarder Semtech**(%%) can be selected | ||
73 | |||
74 | [[image:image-20220831115222-11.png||height="596" width="1221"]] | ||
75 | |||
76 | |||
77 | (% style="color:blue" %)**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 | == 2.4 Step 4: Check Connection == | ||
101 | |||
102 | |||
103 | ((( | ||
104 | LORIOT will show disconnect if Gateway doesn't connect | ||
105 | ))) | ||
106 | |||
107 | ((( | ||
108 | LORIOT will show connect if Gateway connect to LORIOT ok. | ||
109 | ))) | ||
110 | |||
111 | [[image:image-20220831114125-8.png||height="561" width="1150"]] | ||
112 | |||
113 | |||
114 | == 2.5 Trouble Shooting == | ||
115 | |||
116 | |||
117 | User can check the station log in the(% style="color:blue" %)** LogRead ~-~-> System Log **(%%)page. | ||
118 | |||
119 | [[image:image-20220831114647-9.png||height="706" width="894"]] | ||
120 | |||
121 | |||
122 | and recode the station log in the (% style="color:blue" %)** LogRead ~-~-> Recode Log**(%%) page. | ||
123 | |||
124 | [[image:image-20220831114746-10.png||height="292" width="972"]] | ||
125 | |||
126 | |||
127 | = 3. Gateways are connected using LORIOT software = | ||
128 | |||
129 | == 3.1 Step 1: Get Gateway ETH0 MAC Address == | ||
130 | |||
131 | |||
132 | ((( | ||
133 | 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. | ||
134 | |||
135 | |||
136 | ))) | ||
137 | |||
138 | [[image:image-20220524175559-2.png]] | ||
139 | |||
140 | Get ETH0 MAC address | ||
141 | |||
142 | |||
143 | ((( | ||
144 | (% style="color:red" %)**Note**: **To make set up more friendly, the ETH0 will show on the LORIOT page in a new firmware version.** | ||
145 | |||
146 | |||
147 | ))) | ||
148 | |||
149 | == 3.2 Step 2: Choose LORIOT service == | ||
150 | |||
151 | |||
152 | [[image:image-20220531182035-1.png]] | ||
153 | |||
154 | Choose to use LORIOT as LoRaWAN service provider | ||
155 | |||
156 | |||
157 | |||
158 | [[image:image-20220531182109-2.png]] | ||
159 | |||
160 | Install and choose the LORIOT server to be used | ||
161 | |||
162 | |||
163 | == 3.3 Step 3: Checking Connection Status == | ||
164 | |||
165 | |||
166 | [[image:image-20220531182202-3.png]] | ||
167 | |||
168 | Click to Home page and check the connection status | ||
169 | |||
170 | |||
171 | == 3.4 Step 4: Setup Account in LORIOT == | ||
172 | |||
173 | |||
174 | Login [[LORIOT>>url:https://www.loriot.io/]] and create account | ||
175 | |||
176 | [[image:image-20220531182253-4.png]] | ||
177 | |||
178 | Log in LORIOT portal | ||
179 | |||
180 | |||
181 | |||
182 | Choose to use the server same as the gateway setting | ||
183 | |||
184 | [[image:image-20220526111312-1.png||height="493" width="1098"]] | ||
185 | |||
186 | Choose server | ||
187 | |||
188 | |||
189 | |||
190 | Create a New Network | ||
191 | |||
192 | [[image:image-20220526111425-2.png||height="579" width="1378"]] | ||
193 | |||
194 | Create a New Network | ||
195 | |||
196 | |||
197 | [[image:image-20220526111500-3.png]] | ||
198 | |||
199 | Create a New Network | ||
200 | |||
201 | |||
202 | == 3.5 Step 5: Register the gateway == | ||
203 | |||
204 | |||
205 | [[image:image-20220526111650-4.png]] | ||
206 | |||
207 | Register the Gateway in LORIOT | ||
208 | |||
209 | |||
210 | |||
211 | Choose LG308 as gateway model | ||
212 | |||
213 | [[image:image-20220526111742-5.png||height="496" width="1372"]] | ||
214 | |||
215 | Choose LG308 as gateway model | ||
216 | |||
217 | |||
218 | |||
219 | Input Gateway ETH0 address | ||
220 | |||
221 | [[image:image-20220526111918-6.png||height="744" width="1336"]] | ||
222 | |||
223 | Choose SX1301 Reference and use SPI protocol | ||
224 | |||
225 | |||
226 | |||
227 | Choose the right Frequency Band and input location | ||
228 | |||
229 | [[image:image-20220526112029-7.png||height="620" width="1306"]] | ||
230 | |||
231 | Set up regional settings. | ||
232 | |||
233 | |||
234 | == 3.6 Step 6: Check Connection == | ||
235 | |||
236 | |||
237 | ((( | ||
238 | LORIOT will show disconnect if Gateway doesn't connect | ||
239 | ))) | ||
240 | |||
241 | ((( | ||
242 | LORIOT will show connect if Gateway connect to LORIOT ok. | ||
243 | |||
244 | |||
245 | ))) | ||
246 | |||
247 | [[image:image-20220526112143-8.png||height="654" width="1373"]] | ||
248 | |||
249 | Status: Connected | ||
250 | |||
251 | |||
252 | == 3.7 Debug If there is connection issue == | ||
253 | |||
254 | |||
255 | User can check if loriot is running by checking the web ui | ||
256 | |||
257 | |||
258 | [[image:image-20220526112917-18.png]] | ||
259 | |||
260 | Status: Connected | ||
261 | |||
262 | |||
263 | ((( | ||
264 | If user want to see more log, he can run below commands in Linux and see the full log: | ||
265 | ))) | ||
266 | |||
267 | (% class="box" %) | ||
268 | ((( | ||
269 | ((( | ||
270 | ps | grep "loriot_dragino" | grep -v grep | awk '{print $1}' | xargs kill -s 9 | ||
271 | /usr/bin/loriot_dragino_lg308_spi -f -s eu1.loriot.io | ||
272 | ))) | ||
273 | ))) | ||
274 | |||
275 | ((( | ||
276 | |||
277 | |||
278 | Above two commands will first kill the loriot process and run it again to get more output. | ||
279 | ))) | ||
280 | |||
281 | [[image:image-20220530145011-1.png]] | ||
282 | |||
283 | Get more debug info | ||
284 | |||
285 | |||
286 | = 4. End Device Note = | ||
287 | |||
288 | == 4.1 Downlink Setup == | ||
289 | |||
290 | |||
291 | [[image:image-20220530145133-2.png]] | ||
292 | |||
293 | |||
294 | [[image:image-20220526112416-11.png]] | ||
295 | |||
296 | |||
297 | [[image:image-20220526112459-12.png]] | ||
298 | |||
299 | |||
300 | [[image:image-20220526112537-13.png]] | ||
301 | |||
302 | |||
303 | [[image:image-20220526112608-14.png||height="610" width="1382"]] | ||
304 | |||
305 | |||
306 | [[image:image-20220526112655-15.png]] | ||
307 | |||
308 | |||
309 | [[image:image-20220526112719-16.png]] | ||
310 | |||
311 | |||
312 | [[image:image-20220526112759-17.png||height="483" width="1386"]] |