Wiki source code of LA66 USB LoRaWAN Adapter User Manual
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | |||
2 | |||
3 | **Table of Contents:** | ||
4 | |||
5 | {{toc/}} | ||
6 | |||
7 | |||
8 | |||
9 | |||
10 | |||
11 | = 1. LA66 USB LoRaWAN Adapter = | ||
12 | |||
13 | |||
14 | == 1.1 Overview == | ||
15 | |||
16 | |||
17 | [[image:image-20220715001142-3.png||height="145" width="220"]] | ||
18 | |||
19 | |||
20 | ((( | ||
21 | (% style="color:blue" %)**LA66 USB LoRaWAN Adapter**(%%) is designed to fast turn USB devices to support LoRaWAN wireless features. It combines a CP2101 USB TTL Chip and LA66 LoRaWAN module which can easy to add LoRaWAN wireless feature to PC / Mobile phone or an embedded device that has USB Interface. | ||
22 | ))) | ||
23 | |||
24 | ((( | ||
25 | (% style="color:blue" %)**LA66**(%%) is a ready-to-use module that includes the (% style="color:blue" %)**LoRaWAN v1.0.3 protocol**(%%). The LoRaWAN stack used in LA66 is used in more than 1 million LoRaWAN End Devices deployed world widely. This mature LoRaWAN stack greatly reduces the risk to make stable LoRaWAN Sensors to support different LoRaWAN servers and different countries' standards. External MCU can use AT command to call LA66 and start to transmit data via the LoRaWAN protocol. | ||
26 | ))) | ||
27 | |||
28 | ((( | ||
29 | Each LA66 module includes a (% style="color:blue" %)**world-unique OTAA key**(%%) for LoRaWAN registration. | ||
30 | ))) | ||
31 | |||
32 | ((( | ||
33 | Besides the support of the LoRaWAN protocol, LA66 also supports (% style="color:blue" %)**open-source peer-to-peer LoRa Protocol**(%%) for the none-LoRaWAN application. | ||
34 | ))) | ||
35 | |||
36 | ((( | ||
37 | LA66 is equipped with (% style="color:blue" %)**TCXO crystal**(%%) which ensures the module can achieve stable performance in extreme temperatures. | ||
38 | ))) | ||
39 | |||
40 | |||
41 | |||
42 | == 1.2 Features == | ||
43 | |||
44 | |||
45 | * LoRaWAN USB adapter base on LA66 LoRaWAN module | ||
46 | * Ultra-long RF range | ||
47 | * Support LoRaWAN v1.0.4 protocol | ||
48 | * Support peer-to-peer protocol | ||
49 | * TCXO crystal to ensure RF performance on low temperature | ||
50 | * Spring RF antenna | ||
51 | * Available in different frequency LoRaWAN frequency bands. | ||
52 | * World-wide unique OTAA keys. | ||
53 | * AT Command via UART-TTL interface | ||
54 | * Firmware upgradable via UART interface | ||
55 | * Open Source Mobile App for LoRaWAN signal detect and GPS tracking. | ||
56 | |||
57 | |||
58 | |||
59 | |||
60 | == 1.3 Specification == | ||
61 | |||
62 | |||
63 | * CPU: 32-bit 48 MHz | ||
64 | * Flash: 256KB | ||
65 | * RAM: 64KB | ||
66 | * Input Power Range: 5v | ||
67 | * Frequency Range: 150 MHz ~~ 960 MHz | ||
68 | * Maximum Power +22 dBm constant RF output | ||
69 | * High sensitivity: -148 dBm | ||
70 | * Temperature: | ||
71 | ** Storage: -55 ~~ +125℃ | ||
72 | ** Operating: -40 ~~ +85℃ | ||
73 | * Humidity: | ||
74 | ** Storage: 5 ~~ 95% (Non-Condensing) | ||
75 | ** Operating: 10 ~~ 95% (Non-Condensing) | ||
76 | * LoRa Tx Current: <90 mA at +17 dBm, 108 mA at +22 dBm | ||
77 | * LoRa Rx current: <9 mA | ||
78 | |||
79 | |||
80 | |||
81 | |||
82 | == 1.4 Pin Mapping & LED == | ||
83 | |||
84 | [[image:image-20220813183239-3.png||height="526" width="662"]] | ||
85 | |||
86 | |||
87 | |||
88 | == 1.5 Example: Send & Get Messages via LoRaWAN in PC == | ||
89 | |||
90 | |||
91 | ((( | ||
92 | Assume user already input the LA66 USB LoRaWAN Adapter OTAA Keys in TTN and there is already TTN network coverage. | ||
93 | ))) | ||
94 | |||
95 | |||
96 | (% style="color:blue" %)**1. Connect the LA66 USB LoRaWAN adapter to PC** | ||
97 | |||
98 | |||
99 | [[image:image-20220723100027-1.png]] | ||
100 | |||
101 | |||
102 | Open the serial port tool | ||
103 | |||
104 | [[image:image-20220602161617-8.png]] | ||
105 | |||
106 | [[image:image-20220602161718-9.png||height="457" width="800"]] | ||
107 | |||
108 | |||
109 | |||
110 | (% style="color:blue" %)**2. Press the reset switch RST on the LA66 USB LoRaWAN Adapter to reset it.** | ||
111 | |||
112 | The following picture appears to prove that the LA66 USB LoRaWAN Adapter successfully Join the LoRaWAN network | ||
113 | |||
114 | |||
115 | [[image:image-20220602161935-10.png||height="498" width="800"]] | ||
116 | |||
117 | |||
118 | |||
119 | (% style="color:blue" %)**3. See Uplink Command** | ||
120 | |||
121 | Command format: (% style="color:#4472c4" %)** AT+SENDB=<confirn_status>,<Fport>,<data_len>,<data>** | ||
122 | |||
123 | example: AT+SENDB=01,02,8,05820802581ea0a5 | ||
124 | |||
125 | [[image:image-20220602162157-11.png||height="497" width="800"]] | ||
126 | |||
127 | |||
128 | |||
129 | (% style="color:blue" %)**4. Check to see if TTN received the message** | ||
130 | |||
131 | [[image:image-20220602162331-12.png||height="420" width="800"]] | ||
132 | |||
133 | |||
134 | |||
135 | == 1.6 Example: Send PC's CPU/RAM usage to TTN via python == | ||
136 | |||
137 | |||
138 | **Use python as an example:**[[https:~~/~~/github.com/dragino/LA66/blob/main/Send_information_to_TTN_WindosPC.py>>https://github.com/dragino/LA66/blob/main/Send_information_to_TTN_WindosPC.py]] | ||
139 | |||
140 | (**Raspberry Pi example: **[[https:~~/~~/github.com/dragino/LA66/blob/main/Send_information_to_TTN_Raspberry%20Pi.py>>https://github.com/dragino/LA66/blob/main/Send_information_to_TTN_Raspberry%20Pi.py]]) | ||
141 | |||
142 | (% style="color:red" %)**Preconditions:** | ||
143 | |||
144 | (% style="color:red" %)**1. LA66 USB LoRaWAN Adapter works fine** | ||
145 | |||
146 | (% style="color:red" %)**2. LA66 USB LoRaWAN Adapter is registered with TTN** | ||
147 | |||
148 | |||
149 | |||
150 | (% style="color:blue" %)**Steps for usage:** | ||
151 | |||
152 | (% style="color:blue" %)**1.**(%%) Press the reset switch RESET on the LA66 USB LoRaWAN Adapter | ||
153 | |||
154 | (% style="color:blue" %)**2.**(%%) Run the python script in PC and see the TTN | ||
155 | |||
156 | [[image:image-20220602115852-3.png||height="450" width="1187"]] | ||
157 | |||
158 | |||
159 | |||
160 | == 1.7 Example: Send & Get Messages via LoRaWAN in RPi == | ||
161 | |||
162 | |||
163 | Assume user already input the LA66 USB LoRaWAN Adapter OTAA Keys in TTN and there is already TTN network coverage. | ||
164 | |||
165 | |||
166 | (% style="color:blue" %)**1. Connect the LA66 USB LoRaWAN Adapter to the Raspberry Pi** | ||
167 | |||
168 | [[image:image-20220723100439-2.png]] | ||
169 | |||
170 | |||
171 | |||
172 | (% style="color:blue" %)**2. Install Minicom in RPi.** | ||
173 | |||
174 | (% id="cke_bm_509388S" style="display:none" %) (%%)Enter the following command in the RPi terminal | ||
175 | |||
176 | (% style="background-color:yellow" %)**apt update** | ||
177 | |||
178 | (% style="background-color:yellow" %)**apt install minicom** | ||
179 | |||
180 | |||
181 | Use minicom to connect to the RPI's terminal | ||
182 | |||
183 | [[image:image-20220602153146-3.png||height="439" width="500"]] | ||
184 | |||
185 | |||
186 | |||
187 | (% style="color:blue" %)**3. Press the reset switch RST on the LA66 USB LoRaWAN Adapter.** | ||
188 | |||
189 | The following picture appears to prove that the LA66 USB LoRaWAN Adapter successfully entered the network. | ||
190 | |||
191 | |||
192 | [[image:image-20220602154928-5.png||height="436" width="500"]] | ||
193 | |||
194 | |||
195 | |||
196 | (% style="color:blue" %)**4. Send Uplink message** | ||
197 | |||
198 | Format: (% style="color:#4472c4" %)**AT+SENDB=<confirn_status>,<Fport>,<data_len>,<data>** | ||
199 | |||
200 | example: AT+SENDB=01,02,8,05820802581ea0a5 | ||
201 | |||
202 | |||
203 | [[image:image-20220602160339-6.png||height="517" width="600"]] | ||
204 | |||
205 | |||
206 | |||
207 | Check to see if TTN received the message | ||
208 | |||
209 | [[image:image-20220602160627-7.png||height="369" width="800"]] | ||
210 | |||
211 | |||
212 | |||
213 | == 1.8 Example: Use of LA66 USB LoRaWAN Adapter and mobile APP == | ||
214 | |||
215 | |||
216 | === 1.8.1 Hardware and Software Connection === | ||
217 | |||
218 | |||
219 | |||
220 | ==== (% style="color:blue" %)**Overview:**(%%) ==== | ||
221 | |||
222 | |||
223 | ((( | ||
224 | DRAGINO-LA66-APP is an Open Source mobile APP for LA66 USB LoRaWAN Adapter. DRAGINO-LA66-APP has below features: | ||
225 | |||
226 | * Send real-time location information of mobile phone to LoRaWAN network. | ||
227 | * Check LoRaWAN network signal strengh. | ||
228 | * Manually send messages to LoRaWAN network. | ||
229 | ))) | ||
230 | |||
231 | |||
232 | |||
233 | |||
234 | ==== (% style="color:blue" %)**Hardware Connection:**(%%) ==== | ||
235 | |||
236 | A USB to Type-C adapter is needed to connect to a Mobile phone. | ||
237 | |||
238 | Note: The package of LA66 USB adapter already includes this USB Type-C adapter. | ||
239 | |||
240 | [[image:image-20220813174353-2.png||height="360" width="313"]] | ||
241 | |||
242 | |||
243 | |||
244 | ==== (% style="color:blue" %)**Download and Install App:**(%%) ==== | ||
245 | |||
246 | [[(% id="cke_bm_895007S" style="display:none" %)** **(%%)**Download Link for Android apk **>>https://www.dropbox.com/sh/zxwx16qb777uvkz/AABE_P8coGCQ4DAC8enH4bUya?dl=0]]. (Android Version Only) | ||
247 | |||
248 | [[image:image-20220813173738-1.png]] | ||
249 | |||
250 | |||
251 | |||
252 | ==== (% style="color:blue" %)**Use of APP:**(%%) ==== | ||
253 | |||
254 | Function and page introduction | ||
255 | |||
256 | [[image:image-20220723113448-7.png||height="995" width="450"]] | ||
257 | |||
258 | **Block Explain:** | ||
259 | |||
260 | 1. Display LA66 USB LoRaWAN Module connection status | ||
261 | |||
262 | 2. Check and reconnect | ||
263 | |||
264 | 3. Turn send timestamps on or off | ||
265 | |||
266 | 4. Display LoRaWan connection status | ||
267 | |||
268 | 5. Check LoRaWan connection status | ||
269 | |||
270 | 6. The RSSI value of the node when the ACK is received | ||
271 | |||
272 | 7. Node's Signal Strength Icon | ||
273 | |||
274 | 8. Configure Location Uplink Interval | ||
275 | |||
276 | 9. AT command input box | ||
277 | |||
278 | 10. Send Button: Send input box info to LA66 USB Adapter | ||
279 | |||
280 | 11. Output Log from LA66 USB adapter | ||
281 | |||
282 | 12. clear log button | ||
283 | |||
284 | 13. exit button | ||
285 | |||
286 | |||
287 | LA66 USB LoRaWAN Module not connected | ||
288 | |||
289 | [[image:image-20220723110520-5.png||height="677" width="508"]] | ||
290 | |||
291 | |||
292 | |||
293 | Connect LA66 USB LoRaWAN Module | ||
294 | |||
295 | [[image:image-20220723110626-6.png||height="681" width="511"]] | ||
296 | |||
297 | |||
298 | |||
299 | === 1.8.2 Send data to TTNv3 and plot location info in Node-Red === | ||
300 | |||
301 | |||
302 | (% style="color:blue" %)**1. Register LA66 USB LoRaWAN Module to TTNV3** | ||
303 | |||
304 | [[image:image-20220723134549-8.png]] | ||
305 | |||
306 | |||
307 | |||
308 | (% style="color:blue" %)**2. Open Node-RED,And import the JSON file to generate the flow** | ||
309 | |||
310 | Sample JSON file please go to **[[this link>>https://www.dropbox.com/sh/zxwx16qb777uvkz/AABE_P8coGCQ4DAC8enH4bUya?dl=0]]** to download. | ||
311 | |||
312 | For the usage of Node-RED, please refer to: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Node-RED/>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] | ||
313 | |||
314 | After see LoRaWAN Online, walk around and the APP will keep sending location info to LoRaWAN server and then to the Node Red. | ||
315 | |||
316 | |||
317 | Example output in NodeRed is as below: | ||
318 | |||
319 | [[image:image-20220723144339-1.png]] | ||
320 | |||
321 | |||
322 | |||
323 | == 1.9 Upgrade Firmware of LA66 USB LoRaWAN Adapter == | ||
324 | |||
325 | |||
326 | The LA66 USB LoRaWAN Adapter is the same as the LA66 LoRaWAN Shield update method | ||
327 | |||
328 | Just use the yellow jumper cap to short the BOOT corner and the RX corner, and then press the RESET button (without the jumper cap, you can directly short the BOOT corner and the RX corner with a wire to achieve the same effect) | ||
329 | |||
330 | [[image:image-20220723150132-2.png]] | ||
331 | |||
332 | |||
333 | |||
334 | = 2. FAQ = | ||
335 | |||
336 | |||
337 | == 2.1 How to Compile Source Code for LA66? == | ||
338 | |||
339 | |||
340 | Compile and Upload Code to ASR6601 Platform :[[Instruction>>Main.User Manual for LoRaWAN End Nodes.LA66 LoRaWAN Module.Compile and Upload Code to ASR6601 Platform.WebHome]] | ||
341 | |||
342 | |||
343 | |||
344 | = 3. Order Info = | ||
345 | |||
346 | |||
347 | **Part Number:** (% style="color:blue" %)**LA66-USB-LoRaWAN-Adapter-XXX** | ||
348 | |||
349 | |||
350 | (% style="color:blue" %)**XXX**(%%): The default frequency band | ||
351 | |||
352 | * (% style="color:red" %)**AS923**(%%): LoRaWAN AS923 band | ||
353 | * (% style="color:red" %)**AU915**(%%): LoRaWAN AU915 band | ||
354 | * (% style="color:red" %)**EU433**(%%): LoRaWAN EU433 band | ||
355 | * (% style="color:red" %)**EU868**(%%): LoRaWAN EU868 band | ||
356 | * (% style="color:red" %)**KR920**(%%): LoRaWAN KR920 band | ||
357 | * (% style="color:red" %)**US915**(%%): LoRaWAN US915 band | ||
358 | * (% style="color:red" %)**IN865**(%%): LoRaWAN IN865 band | ||
359 | * (% style="color:red" %)**CN470**(%%): LoRaWAN CN470 band | ||
360 | * (% style="color:red" %)**PP**(%%): Peer to Peer LoRa Protocol | ||
361 | |||
362 | |||
363 | |||
364 | |||
365 | = 4. Reference = | ||
366 | |||
367 | |||
368 | * Hardware Design File for LA66 USB LoRaWAN Adapter : [[Download>>https://www.dropbox.com/sh/a3wbmdcvqjxaqw5/AADZfvAiykJTK624RgMquH86a?dl=0]] |