Wiki source code of Mapwize

Last modified by Xiaoling on 2023/04/23 15:31
Show last authors
1 **~ Table of Contents：**
2
3 {{toc/}}
4
5
6
7
8 = 1.  Introduction =
9
10
11 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.
12
13
14 [[image:image-20220526150521-2.png]]
15
16 LBT1 Indoor Positioning Network Structure
17
18
19 = 2.  Prepare Map =
20
21 == 2.1  Prepare iBeacons ==
22
23
24 (((
25 (((
26 Any BLE iBeacons should work in this solution, each iBeacon stands for a fix position in the map. Here is an iBeacon for example.
27 )))
28 )))
29
30 (((
31 (((
32 First of all, user needs to accurately place the beacon at each location, which is the reference for positioning.
33 )))
34 )))
35
36 (((
37 (((
38 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]]
39
40
41 )))
42 )))
43
44 [[image:image-20220526150651-4.png]]
45
46 BCN01 iBeacon
47
48
49
50 (((
51 (((
52 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".
53 )))
54 )))
55
56 [[image:image-20220526150743-5.png]]
57
58 beacon software
59
60
61
62 [[image:image-20220526150824-6.png]]
63
64 beacon software
65
66
67 == 2.2  Create Map ==
68
69
70 (((
71 (((
72 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.
73
74
75 )))
76 )))
77
78 (((
79 (((
80 **~1. Register an account at [[https:~~/~~/studio.mapwize.io/>>url:https://studio.mapwize.io/]] to create an indoor map.**
81 )))
82 )))
83
84 (((
85 (((
86 **2. Create Place Types.**
87
88
89 )))
90 )))
91
92 [[image:image-20220526150915-7.png]]
93
94 Create place types
95
96
97
98 **3. Search Venues. （Indoor map area identification）**
99
100
101 [[image:image-20220526151046-8.png]]
102
103
104 (((
105 (((
106 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.
107
108
109
110 )))
111 )))
112
113 **4. Upload Floor plan.**
114
115
116 [[image:image-20220526151223-9.png]]
117
118 add images
119
120
121
122 **5. Create Layer**
123
124
125 [[image:image-20220526151305-10.png]]
126
127 create layer
128
129
130 (((
131 **6. Add iBeacon position info. Drag the iBeacon to match position and input the UUID, MAJOR and MINOR of this iBeacon.**
132
133
134 )))
135
136 [[image:image-20220526151519-11.png]]
137
138 create iBeacon
139
140
141 = 3.  Configure TTN =
142
143 == 3.1  Configure LBT1 to Upload data to TTN ==
144
145
146 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.
147
148
149 == 3.2  Decoder in TTN ==
150
151
152 (% class="box" %)
153 (((
154 function Decoder(bytes, port) {
155 \\~/~/ Decode an uplink message from a buffer
156 \\~/~/ (array) of bytes to an object of fields.
157 \\value = bytes[0] << 8 | bytes[1];
158 \\var batV = value/1000;~/~/Battery,units:V
159 \\var mode = bytes[5];
160 \\~/~/var value=(bytes[3]-0x30)*1000 +(bytes[5]-0x30)*100 + (bytes[5]-0x30)*10 +(bytes[6]-0x30);
161 \\~/~/var value = bytes.slice(3);
162 \\var i;
163 \\var con;
164 \\var str = "";
165 \\var major = 1;
166 \\var minor = 1;
167 \\var rssi = 0;
168 \\var addr = "";
169 \\if(mode ==2 ) {
170 \\ for(i = 38 ; i<50 ; i++) {
171 \\ con = bytes[i].toString();
172 \\ str += String.fromCharCode(con);
173 \\ }
174 \\ addr = str;
175 \\ str = "";
176 \\ for(i = 6 ; i<38 ; i++) {
177 \\ con = bytes[i].toString();
178 \\ str += String.fromCharCode(con);
179 \\ }
180 \\ value = str;
181 \\}
182 \\if(mode == 3 ) {
183 \\ str = "";
184 \\ for(i = 18 ; i < 22 ; i++) {
185 \\ con = bytes[i].toString();
186 \\ str += String.fromCharCode(con);
187 \\ }
188 \\ major = parseInt(str, 16);
189 \\ str = "";
190 \\ for(i = 22 ; i < 26 ; i++) {
191 \\ con = bytes[i].toString();
192 \\ str += String.fromCharCode(con);
193 \\ }
194 \\ minor = parseInt(str, 16);
195 \\ str = "";
196 \\ for(i = 28 ; i < 32 ; i++) {
197 \\ con = bytes[i].toString();
198 \\ str += String.fromCharCode(con);
199 \\ }
200 \\ rssi = parseInt(str);
201 \\ str = "";
202 \\ for(i = 6 ; i < 18 ; i++) {
203 \\ con = bytes[i].toString();
204 \\ str += String.fromCharCode(con);
205 }
206 \\ value = str;
207 }
208 \\if(mode == 1) {
209 \\ for(i = 6 ; i<11 ; i++) {
210 \\ con = bytes[i].toString();
211 \\ str += String.fromCharCode(con);
212 \\ }
213 \\ value = str;
214 }
215 \\var uuid = value;
216 \\var alarm = bytes[2] >> 4 & 0x0F;
217 \\var step_count = (bytes[2] & 0x0F) << 16 | bytes[3] << 8 | bytes[4];
218 \\return {
219 UUID: uuid,
220 ADDR: addr,
221 MAJOR: major,
222 MINOR: minor,
223 RSSI:rssi,
224 STEP: step_count,
225 ALARM: alarm,
226 BatV:batV,
227 };
228 }
229
230 )))
231
232
233 = 4.  Set Up Converter Server =
234
235
236 * (((
237 (% style="color:blue" %)**How to install and run this service on Linux?**
238 )))
239
240 (((
241 (% style="color:red" %)**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).
242 )))
243
244 (((
245 (% style="color:red" %)**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.
246
247
248 )))
249
250 (((
251 **System:  Debian / Ubuntu**
252 )))
253
254 (% class="box" %)
255 (((
256 (% style="color:blue" %)**step:**(%%)
257 \\1. **sudo** apt install libcurl4-dev 
258 \\2. **sudo** apt **install  gcc automake autoconf** libtool **make** cmake
259 \\3. git clone -b master https:~/~/github.com/mikayong/location.git
260 \\4. cd location/libmqtt
261 \\5. mkdir build
262 \\6. cd build && cmake ../
263 \\7. make && sudo make install 
264 \\8. cd ../
265 \\9. make 
266 \\10. sudo cp location_conf.json  /etc/
267 \\11. Edit the configuration file, and run the location service in the background: ./location &
268 )))
269
270 (((
271 (% style="color:red" %)**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
272
273
274 )))
275
276 = 5.  Configuration file： location_conf.json =
277
278
279 * (((
280 (% style="color:blue" %)**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.**
281
282
283 )))
284
285 (((
286 { "location_conf": {
287 )))
288
289 (% class="box" %)
290 (((
291 (((
292 "loctype": "indoor",       ~/~/ indoor/outdoor
293 "locmap": "mapwize"    ~/~/   Map interface: mapwize， traccar
294 )))
295 )))
296
297 (((
298 }, "mqtt_conf": {
299 )))
300
301 (% class="box" %)
302 (((
303 (((
304 "servaddr": "[str]",    ~/~/     Lorawan server address: Refer to TTN app handler：eu.thethings.network
305 "servport": [int],       ~/~/   Lorawan server port: 1883
306 "clientid": "[str]",       ~/~/   MQTT client identity: Custom
307 "qos":[int],                 ~/~/  （Optional） MQTT service quality: 0
308 "username":"[str]",     ~/~/   Agent name of mqtt: application ID of TTN
309 "password":"[str]",      ~/~/  The proxy password of mqtt: application access key of TTN
310 "topic":"[str]",              ~/~/ The topic of mqtt subscription: TTN is + / devices / + / up
311 "connection":"[str]" },   ~/~/（Optional） mqtt is a string used for direct connection, composed of serveraddr and port
312 "mapwize_conf":{          ~/~/Map settings
313 "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
314 "venueid":"[str]",        ~/~/ （Optional）Indoor map area identification
315 "orgid":"[str]",           ~/~/  The identity of the user organizer
316 "universesid":"[str]",   ~/~/The range indicator of the indoor map, find it on the universes page
317 "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
318 },
319 "loracloud":{
320 "token":  "[str]"          ~/~/The password string of loracloud location service, the outdoor map must fill in the account token of loracloud
321 )))
322 )))
323
324 (((
325 }
326 )))
327
328 (% class="box" %)
329 (((
330 (((
331 "rssi_conf": {
332 "rssirate": [int],          ~/~/ （Optional） A basis for rssi calculation distance, the rssi value (absolute value) when the beacon is 1 meter apart 
333 "rssidiv": [float] }        ~/~/ （Optional） rssi measures an attenuation value of distance. As the distance to the beacon is farther, the value changes speed
334 )))
335 )))
336
337 (((
338 }
339
340
341
342 )))
343
344 * (% style="color:blue" %)**Parameter acquisition method of configuration file：**
345
346
347 (% class="box" %)
348 (((
349 **"username":"[str]" **
350 )))
351
352
353 [[image:image-20220526151707-12.png]]
354
355 username
356
357
358
359 (% class="box" %)
360 (((
361 **"password":"[str]" **
362 )))
363
364 [[image:image-20220526151736-13.png]]
365
366 password
367
368
369
370 (% class="box" %)
371 (((
372 **"apikey": "[str]" **
373 )))
374
375 [[image:image-20220526151819-14.png||height="588" width="1203"]]
376
377 apikey
378
379
380
381 (% class="box" %)
382 (((
383 **"orgid":"[str]"**
384 )))
385
386 [[image:image-20220526152014-15.png]]
387
388 orgid
389
390
391
392 (% class="box" %)
393 (((
394 **"universesid":"[str]"**
395 )))
396
397 [[image:image-20220526152115-16.png]]
398
399 universesid
400
401
402
403 (% class="box" %)
404 (((
405 **"placetype": "[str]"**
406 )))
407
408 [[image:image-20220526152150-17.png]]
409
410 placetype
411
412
413
414 (% style="color:blue" %)**Here are two ways to enter the server：**
415
416 (% style="color:red" %)**1. WinSCP**
417
418 [[image:image-20220526152303-18.png]]
419
420
421 [[image:image-20220526152355-19.png]]
422
423
424 [[image:image-20220526152912-20.png]]
425
426 way1
427
428
429
430 (% style="color:red" %)**2. secureCRT**
431
432 [[image:image-20220526153145-22.png]]
433
434 [[image:image-20220526153236-23.png]]
435
436 [[image:image-20220526153304-24.png]]
437
438 way2
439
440
441 = 6.  Test Result =
442
443
444 The real-time position on the map is obtained according to the moving change of LBT1.
445
446
447 [[image:image-20220526153424-25.png||height="693" width="1414"]]

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0