Hide last authors
author | version | line-number | content |
---|---|---|---|
1.7 | 1 | **~ Contents:** | |
1.2 | 2 | ||
1.1 | 3 | {{toc/}} | |
4 | |||
5 | |||
1.2 | 6 | = 1. Introduction = | |
1.1 | 7 | ||
1.2 | 8 | This article shows how to use [[LBT1>>url:http://www.dragino.com/products/lora-lorawan-end-node/item/165-lbt1.html]] to build an Indoor Positioning Solution. | |
1.1 | 9 | ||
6.2 | 10 | [[image:image-20220526150521-2.png]] | |
1.1 | 11 | ||
1.2 | 12 | LBT1 Indoor Positioning Network Structure | |
1.1 | 13 | ||
6.2 | 14 | ||
1.2 | 15 | = 2. Prepare Map = | |
1.1 | 16 | ||
1.2 | 17 | == 2.1 Prepare iBeacons == | |
1.1 | 18 | ||
1.2 | 19 | ((( | |
1.3 | 20 | ((( | |
1.2 | 21 | Any BLE iBeacons should work in this solution, each iBeacon stands for a fix position in the map. Here is an iBeacon for example. | |
22 | ))) | ||
1.3 | 23 | ))) | |
1.1 | 24 | ||
1.2 | 25 | ((( | |
1.3 | 26 | ((( | |
1.2 | 27 | First of all, user needs to accurately place the beacon at each location, which is the reference for positioning. | |
28 | ))) | ||
1.3 | 29 | ))) | |
1.1 | 30 | ||
1.2 | 31 | ((( | |
1.3 | 32 | ((( | |
1.2 | 33 | BCN01 iBeacon from Dragino: [[http:~~/~~/www.dragino.com/products/accessories/item/166-bcn01.html>>url:http://www.dragino.com/products/accessories/item/166-bcn01.html]] | |
34 | ))) | ||
1.3 | 35 | ))) | |
1.1 | 36 | ||
6.2 | 37 | [[image:image-20220526150651-4.png]] | |
1.1 | 38 | ||
1.2 | 39 | BCN01 iBeacon | |
1.1 | 40 | ||
8.2 | 41 | ||
1.2 | 42 | ((( | |
1.3 | 43 | ((( | |
1.2 | 44 | We need to get the UUID, MAJOR, MINOR, TXPOWER where each iBeacon is placed. We can get it with the iBeacon software, such as "EW-beacon". | |
45 | ))) | ||
1.3 | 46 | ))) | |
1.1 | 47 | ||
8.2 | 48 | [[image:image-20220526150743-5.png]] | |
1.1 | 49 | ||
1.2 | 50 | beacon software | |
51 | |||
52 | |||
8.2 | 53 | [[image:image-20220526150824-6.png]] | |
1.2 | 54 | ||
55 | beacon software | ||
56 | |||
8.2 | 57 | ||
1.2 | 58 | == 2.2 Create Map == | |
59 | |||
60 | ((( | ||
1.3 | 61 | ((( | |
1.2 | 62 | Here we use the indoor map at [[https:~~/~~/studio.mapwize.io/>>url:https://studio.mapwize.io/]]. Below shows the steps for create a map and put the iBeacon on a fix position. | |
63 | ))) | ||
1.3 | 64 | ))) | |
1.2 | 65 | ||
66 | ((( | ||
1.3 | 67 | ((( | |
1.2 | 68 | ~1. Register an account at [[https:~~/~~/studio.mapwize.io/>>url:https://studio.mapwize.io/]] to create an indoor map. | |
69 | ))) | ||
1.3 | 70 | ))) | |
1.2 | 71 | ||
72 | ((( | ||
1.3 | 73 | ((( | |
1.2 | 74 | 2. Create Place Types. | |
75 | ))) | ||
1.3 | 76 | ))) | |
1.2 | 77 | ||
9.2 | 78 | [[image:image-20220526150915-7.png]] | |
1.2 | 79 | ||
80 | Create place types | ||
81 | |||
9.2 | 82 | ||
1.2 | 83 | 3. Search Venues. (Indoor map area identification) | |
84 | |||
11.2 | 85 | [[image:image-20220526151046-8.png]] | |
1.2 | 86 | ||
87 | ((( | ||
1.4 | 88 | ((( | |
1.2 | 89 | The map accurately places the beacon of ibeacon, which is the reference for positioning. At this time, UUID, MAJOR and MINOR must be filled in correctly. | |
11.2 | 90 | ||
91 | |||
1.2 | 92 | ))) | |
1.4 | 93 | ))) | |
1.2 | 94 | ||
95 | 4. Upload Floor plan. | ||
96 | |||
11.2 | 97 | [[image:image-20220526151223-9.png]] | |
1.2 | 98 | ||
99 | add images | ||
100 | |||
13.2 | 101 | ||
1.2 | 102 | 5. Create Layer | |
103 | |||
13.2 | 104 | [[image:image-20220526151305-10.png]] | |
1.2 | 105 | ||
106 | create layer | ||
107 | |||
13.2 | 108 | ||
1.4 | 109 | ((( | |
1.2 | 110 | 6. Add iBeacon position info. Drag the iBeacon to match position and input the UUID, MAJOR and MINOR of this iBeacon. | |
1.4 | 111 | ))) | |
1.2 | 112 | ||
13.2 | 113 | [[image:image-20220526151519-11.png]] | |
1.2 | 114 | ||
115 | create iBeacon | ||
116 | |||
15.2 | 117 | ||
1.2 | 118 | = 3. Configure TTN = | |
119 | |||
120 | == 3.1 Configure LBT1 to Upload data to TTN == | ||
121 | |||
2.4 | 122 | Please refer the instruction in the [[User Manual>>url:http://www.dragino.com/downloads/index.php?dir=accessories/Bluetooth/BCN01]]. Note the (% style="color:#4f81bd" %)**LBT1 need to set to MOD=3**(%%) here. | |
1.2 | 123 | ||
15.2 | 124 | ||
1.2 | 125 | == 3.2 Decoder in TTN == | |
126 | |||
127 | (% class="box" %) | ||
128 | ((( | ||
129 | function Decoder(bytes, port) { | ||
130 | \\~/~/ Decode an uplink message from a buffer | ||
131 | \\~/~/ (array) of bytes to an object of fields. | ||
132 | \\value = bytes[0] << 8 | bytes[1]; | ||
133 | \\var batV = value/1000;~/~/Battery,units:V | ||
134 | \\var mode = bytes[5]; | ||
135 | \\~/~/var value=(bytes[3]-0x30)*1000 +(bytes[5]-0x30)*100 + (bytes[5]-0x30)*10 +(bytes[6]-0x30); | ||
136 | \\~/~/var value = bytes.slice(3); | ||
137 | \\var i; | ||
138 | \\var con; | ||
139 | \\var str = ""; | ||
140 | \\var major = 1; | ||
141 | \\var minor = 1; | ||
142 | \\var rssi = 0; | ||
143 | \\var addr = ""; | ||
144 | \\if(mode ==2 ) { | ||
145 | \\ for(i = 38 ; i<50 ; i++) { | ||
146 | \\ con = bytes[i].toString(); | ||
147 | \\ str += String.fromCharCode(con); | ||
148 | \\ } | ||
149 | \\ addr = str; | ||
150 | \\ str = ""; | ||
151 | \\ for(i = 6 ; i<38 ; i++) { | ||
152 | \\ con = bytes[i].toString(); | ||
153 | \\ str += String.fromCharCode(con); | ||
154 | \\ } | ||
155 | \\ value = str; | ||
156 | \\} | ||
157 | \\if(mode == 3 ) { | ||
158 | \\ str = ""; | ||
159 | \\ for(i = 18 ; i < 22 ; i++) { | ||
160 | \\ con = bytes[i].toString(); | ||
161 | \\ str += String.fromCharCode(con); | ||
162 | \\ } | ||
163 | \\ major = parseInt(str, 16); | ||
164 | \\ str = ""; | ||
165 | \\ for(i = 22 ; i < 26 ; i++) { | ||
166 | \\ con = bytes[i].toString(); | ||
167 | \\ str += String.fromCharCode(con); | ||
168 | \\ } | ||
169 | \\ minor = parseInt(str, 16); | ||
170 | \\ str = ""; | ||
171 | \\ for(i = 28 ; i < 32 ; i++) { | ||
172 | \\ con = bytes[i].toString(); | ||
173 | \\ str += String.fromCharCode(con); | ||
174 | \\ } | ||
175 | \\ rssi = parseInt(str); | ||
176 | \\ str = ""; | ||
177 | \\ for(i = 6 ; i < 18 ; i++) { | ||
178 | \\ con = bytes[i].toString(); | ||
179 | \\ str += String.fromCharCode(con); | ||
180 | } | ||
181 | \\ value = str; | ||
182 | } | ||
183 | \\if(mode == 1) { | ||
184 | \\ for(i = 6 ; i<11 ; i++) { | ||
185 | \\ con = bytes[i].toString(); | ||
186 | \\ str += String.fromCharCode(con); | ||
187 | \\ } | ||
188 | \\ value = str; | ||
189 | } | ||
190 | \\var uuid = value; | ||
191 | \\var alarm = bytes[2] >> 4 & 0x0F; | ||
192 | \\var step_count = (bytes[2] & 0x0F) << 16 | bytes[3] << 8 | bytes[4]; | ||
193 | \\return { | ||
194 | UUID: uuid, | ||
195 | ADDR: addr, | ||
196 | MAJOR: major, | ||
197 | MINOR: minor, | ||
198 | RSSI:rssi, | ||
199 | STEP: step_count, | ||
200 | ALARM: alarm, | ||
201 | BatV:batV, | ||
202 | }; | ||
203 | } | ||
204 | |||
205 | ))) | ||
206 | |||
15.2 | 207 | ||
1.2 | 208 | = 4. Set Up Converter Server = | |
209 | |||
1.4 | 210 | * ((( | |
211 | How to install and run this service on Linux? | ||
212 | ))) | ||
1.2 | 213 | ||
1.4 | 214 | ((( | |
1.2 | 215 | Step1.Rent a Linux on Amazon cloud or alicloud to the host, and pre install the Linux system (Debian, Ubuntu, CentOS are available for distribution). | |
1.4 | 216 | ))) | |
1.2 | 217 | ||
1.4 | 218 | ((( | |
1.2 | 219 | Step2.Run the code on the server after compiling. Compilation requires the support of libcurl. First, compile libmqtt in the code, and then compile location. | |
1.4 | 220 | ))) | |
1.2 | 221 | ||
1.4 | 222 | ((( | |
1.2 | 223 | System: Debian / Ubuntu | |
1.4 | 224 | ))) | |
1.2 | 225 | ||
1.4 | 226 | (% class="box" %) | |
227 | ((( | ||
228 | step: | ||
1.8 | 229 | \\1. sudo apt install libcurl4-dev | |
230 | \\2. sudo apt install gcc automake autoconf libtool make cmake | ||
231 | \\3. git clone -b master https:~/~/github.com/mikayong/location.git | ||
232 | \\4. cd location/libmqtt | ||
233 | \\5. mkdir build | ||
234 | \\6. cd build && cmake ../ | ||
235 | \\7. make && sudo make install | ||
236 | \\8. cd ../ | ||
237 | \\9. make | ||
238 | \\10. sudo cp location_conf.json /etc/ | ||
239 | \\11. Edit the configuration file, and run the location service in the background: ./location & | ||
1.4 | 240 | ))) | |
1.2 | 241 | ||
1.4 | 242 | ((( | |
1.2 | 243 | Step3.The location service subscribes to the lora information stream on TTN through the mqtt protocol, parses the information to generate a geographic location, and finally creates a geographic location on the mapwize map. The following is the configuration of the location service, the configuration file is in json format, the file is /etc/location_conf.json | |
15.2 | 244 | ||
245 | |||
1.4 | 246 | ))) | |
1.2 | 247 | ||
248 | = 5. Configuration file: location_conf.json = | ||
249 | |||
1.9 | 250 | * ((( | |
251 | We use the 120.78.138.177 server as an example. The location service is currently installed on the 120.78.138.177 server, the code is in /root/location, and the configuration file for running location pre-read directly is /etc/location_conf.json. | ||
252 | ))) | ||
1.2 | 253 | ||
1.9 | 254 | ((( | |
1.2 | 255 | { "location_conf": { | |
1.9 | 256 | ))) | |
1.2 | 257 | ||
1.5 | 258 | (% class="box" %) | |
259 | ((( | ||
1.9 | 260 | ((( | |
1.5 | 261 | "loctype": "indoor", ~/~/ indoor/outdoor | |
262 | "locmap": "mapwize" ~/~/ Map interface: mapwize, traccar | ||
263 | ))) | ||
1.9 | 264 | ))) | |
1.2 | 265 | ||
1.9 | 266 | ((( | |
1.2 | 267 | }, "mqtt_conf": { | |
1.9 | 268 | ))) | |
1.2 | 269 | ||
1.5 | 270 | (% class="box" %) | |
271 | ((( | ||
1.9 | 272 | ((( | |
1.5 | 273 | "servaddr": "[str]", ~/~/ Lorawan server address: Refer to TTN app handler:eu.thethings.network | |
274 | "servport": [int], ~/~/ Lorawan server port: 1883 | ||
1.9 | 275 | "clientid": "[str]", ~/~/ MQTT client identity: Custom | |
276 | "qos":[int], ~/~/ (Optional) MQTT service quality: 0 | ||
277 | "username":"[str]", ~/~/ Agent name of mqtt: application ID of TTN | ||
1.5 | 278 | "password":"[str]", ~/~/ The proxy password of mqtt: application access key of TTN | |
1.10 | 279 | "topic":"[str]", ~/~/ The topic of mqtt subscription: TTN is + / devices / + / up | |
1.5 | 280 | "connection":"[str]" }, ~/~/(Optional) mqtt is a string used for direct connection, composed of serveraddr and port | |
1.9 | 281 | "mapwize_conf":{ ~/~/Map settings | |
1.5 | 282 | "apikey": "[str]", ~/~/ The apikey of the map user can be found on the Api keys page of wapwize, and read and write permissions need to be set | |
283 | "venueid":"[str]", ~/~/ (Optional)Indoor map area identification | ||
284 | "orgid":"[str]", ~/~/ The identity of the user organizer | ||
285 | "universesid":"[str]", ~/~/The range indicator of the indoor map, find it on the universes page | ||
286 | "placetype": "[str]" ~/~/The type of place used to identify the creation must be created on the placetypes page in the map, where the placetype name is filled in | ||
1.2 | 287 | }, | |
288 | "loracloud":{ | ||
1.5 | 289 | "token": "[str]" ~/~/The password string of loracloud location service, the outdoor map must fill in the account token of loracloud | |
290 | ))) | ||
1.9 | 291 | ))) | |
1.2 | 292 | ||
1.9 | 293 | ((( | |
1.2 | 294 | } | |
1.9 | 295 | ))) | |
1.2 | 296 | ||
1.5 | 297 | (% class="box" %) | |
298 | ((( | ||
1.9 | 299 | ((( | |
1.5 | 300 | "rssi_conf": { | |
301 | "rssirate": [int], ~/~/ (Optional) A basis for rssi calculation distance, the rssi value (absolute value) when the beacon is 1 meter apart | ||
302 | "rssidiv": [float] } ~/~/ (Optional) rssi measures an attenuation value of distance. As the distance to the beacon is farther, the value changes speed | ||
303 | ))) | ||
1.9 | 304 | ))) | |
1.2 | 305 | ||
1.9 | 306 | ((( | |
1.2 | 307 | } | |
1.9 | 308 | ))) | |
1.2 | 309 | ||
310 | * Parameter acquisition method of configuration file: | ||
311 | |||
1.6 | 312 | (% class="box" %) | |
313 | ((( | ||
314 | "username":"[str]" | ||
315 | ))) | ||
1.2 | 316 | ||
15.2 | 317 | [[image:image-20220526151707-12.png]] | |
1.2 | 318 | ||
319 | username | ||
320 | |||
15.2 | 321 | ||
1.6 | 322 | (% class="box" %) | |
323 | ((( | ||
1.8 | 324 | "password":"[str]" | |
1.6 | 325 | ))) | |
1.2 | 326 | ||
15.2 | 327 | [[image:image-20220526151736-13.png]] | |
1.2 | 328 | ||
329 | password | ||
330 | |||
15.2 | 331 | ||
1.6 | 332 | (% class="box" %) | |
333 | ((( | ||
334 | "apikey": "[str]" | ||
335 | ))) | ||
1.2 | 336 | ||
19.2 | 337 | [[image:image-20220526151819-14.png||height="588" width="1203"]] | |
1.2 | 338 | ||
339 | apikey | ||
340 | |||
1.6 | 341 | (% class="box" %) | |
342 | ((( | ||
343 | "orgid":"[str]" | ||
344 | ))) | ||
1.2 | 345 | ||
19.2 | 346 | [[image:image-20220526152014-15.png]] | |
1.2 | 347 | ||
348 | orgid | ||
349 | |||
19.2 | 350 | ||
1.6 | 351 | (% class="box" %) | |
352 | ((( | ||
353 | "universesid":"[str]" | ||
354 | ))) | ||
1.2 | 355 | ||
19.2 | 356 | [[image:image-20220526152115-16.png]] | |
1.2 | 357 | ||
358 | universesid | ||
359 | |||
19.2 | 360 | ||
1.6 | 361 | (% class="box" %) | |
362 | ((( | ||
363 | "placetype": "[str]" | ||
364 | ))) | ||
1.2 | 365 | ||
19.2 | 366 | [[image:image-20220526152150-17.png]] | |
1.2 | 367 | ||
368 | placetype | ||
369 | |||
370 | |||
1.6 | 371 | **Here are two ways to enter the server:** | |
1.2 | 372 | ||
1.6 | 373 | **~1. WinSCP** | |
374 | |||
1.2 | 375 | [[image:https://wiki.dragino.com/images/thumb/6/6b/Ibeacon4.jpg/600px-Ibeacon4.jpg||height="385" width="600"]] | |
376 | |||
377 | [[image:https://wiki.dragino.com/images/thumb/7/78/Ibeacon5.jpg/600px-Ibeacon5.jpg||height="385" width="600"]] | ||
378 | |||
1.10 | 379 | [[image:https://wiki.dragino.com/images/thumb/c/cd/Ibeacon6.jpg/800px-Ibeacon6.jpg||alt="File:Ibeacon6.jpg" height="362" width="599"]] | |
1.2 | 380 | ||
381 | way1 | ||
382 | |||
1.6 | 383 | **2. secureCRT** | |
1.2 | 384 | ||
385 | [[image:https://wiki.dragino.com/images/thumb/7/7b/Ibeacon7.jpg/600px-Ibeacon7.jpg||height="326" width="600"]] | ||
386 | |||
387 | [[image:https://wiki.dragino.com/images/thumb/6/64/Ibeacon8.jpg/600px-Ibeacon8.jpg||height="326" width="600"]] | ||
388 | |||
1.10 | 389 | [[image:https://wiki.dragino.com/images/thumb/d/de/Ibeacon9.jpg/800px-Ibeacon9.jpg||alt="File:Ibeacon9.jpg" height="327" width="602"]] | |
1.2 | 390 | ||
391 | way2 | ||
392 | |||
393 | = 6. Test Result = | ||
394 | |||
395 | The real-time position on the map is obtained according to the moving change of LBT1. | ||
396 | |||
397 | [[image:https://wiki.dragino.com/images/thumb/7/70/Beacon15.png/600px-Beacon15.png||alt="Beacon15.png" height="294" width="600"]] |