Changes for page Mapwize

Last modified by Xiaoling on 2023/04/23 15:31

From version 2.3
edited by Xiaoling
on 2022/05/17 11:02
Change comment: There is no comment for this version
To version 1.2
edited by Xiaoling
on 2022/05/17 10:13
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,4 +1,4 @@
1 -**~ Contents:**
1 +**Contents:**
2 2  
3 3  {{toc/}}
4 4  
... ... @@ -16,22 +16,16 @@
16 16  == 2.1 Prepare iBeacons ==
17 17  
18 18  (((
19 -(((
20 20  Any BLE iBeacons should work in this solution, each iBeacon stands for a fix position in the map. Here is an iBeacon for example.
21 21  )))
22 -)))
23 23  
24 24  (((
25 -(((
26 26  First of all, user needs to accurately place the beacon at each location, which is the reference for positioning.
27 27  )))
28 -)))
29 29  
30 30  (((
31 -(((
32 32  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]]
33 33  )))
34 -)))
35 35  
36 36  [[image:https://wiki.dragino.com/images/thumb/8/88/Ibeacon1.png/300px-Ibeacon1.png||height="169" width="300"]]
37 37  
... ... @@ -38,10 +38,8 @@
38 38  BCN01 iBeacon
39 39  
40 40  (((
41 -(((
42 42  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".
43 43  )))
44 -)))
45 45  
46 46  [[image:https://wiki.dragino.com/images/thumb/f/fa/Ibeacon2.jpg/400px-Ibeacon2.jpg||height="867" width="400"]]
47 47  
... ... @@ -55,22 +55,16 @@
55 55  == 2.2 Create Map ==
56 56  
57 57  (((
58 -(((
59 59  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.
60 60  )))
61 -)))
62 62  
63 63  (((
64 -(((
65 65  ~1. Register an account at [[https:~~/~~/studio.mapwize.io/>>url:https://studio.mapwize.io/]] to create an indoor map.
66 66  )))
67 -)))
68 68  
69 69  (((
70 -(((
71 71  2. Create Place Types.
72 72  )))
73 -)))
74 74  
75 75  [[image:https://wiki.dragino.com/images/thumb/4/4d/Beacon10.png/600px-Beacon10.png||height="274" width="600"]]
76 76  
... ... @@ -81,14 +81,12 @@
81 81  [[image:https://wiki.dragino.com/images/thumb/e/e8/Beacon11.jpg/600px-Beacon11.jpg||alt="Beacon11.jpg" height="324" width="600"]]
82 82  
83 83  (((
84 -(((
85 85  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.
86 86  )))
87 -)))
88 88  
89 89  4. Upload Floor plan.
90 90  
91 -[[image:https://wiki.dragino.com/images/thumb/d/d1/Beacon12.png/800px-Beacon12.png||alt="File:Beacon12.png" height="196" width="598"]]
75 +[[image:https://wiki.dragino.com/images/thumb/d/d1/Beacon12.png/600px-Beacon12.png||height="197" width="600"]]
92 92  
93 93  add images
94 94  
... ... @@ -98,9 +98,7 @@
98 98  
99 99  create layer
100 100  
101 -(((
102 102  6. Add iBeacon position info. Drag the iBeacon to match position and input the UUID, MAJOR and MINOR of this iBeacon.
103 -)))
104 104  
105 105  [[image:https://wiki.dragino.com/images/thumb/1/1d/Beacon14.png/600px-Beacon14.png||height="261" width="600"]]
106 106  
... ... @@ -196,155 +196,120 @@
196 196  
197 197  = 4. Set Up Converter Server =
198 198  
199 -* (((
200 -How to install and run this service on Linux?
201 -)))
181 +* How to install and run this service on Linux?
202 202  
203 -(((
204 204  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).
205 -)))
206 206  
207 -(((
208 208  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.
209 -)))
210 210  
211 -(((
187 +
212 212  System: Debian / Ubuntu
213 -)))
214 214  
215 -(% class="box" %)
216 -(((
217 -step:
218 -\\1. sudo apt install libcurl4-dev 
219 -\\2. sudo apt install  gcc automake autoconf libtool make cmake
220 -\\3. git clone -b master https:~/~/github.com/mikayong/location.git
221 -\\4. cd location/libmqtt
222 -\\5. mkdir build
223 -\\6. cd build && cmake ../
224 -\\7. make && sudo make install 
225 -\\8. cd ../
226 -\\9. make 
227 -\\10. sudo cp location_conf.json  /etc/
228 -\\11. Edit the configuration file, and run the location service in the background: ./location &
229 -)))
190 +{{{step:
191
192 +1. sudo apt install libcurl4-dev 
193
194 +2. sudo apt install  gcc automake autoconf libtool make cmake
195
196 +3. git clone -b master https://github.com/mikayong/location.git
197
198 +4. cd location/libmqtt
199
200 +5. mkdir build
201
202 +6. cd build && cmake ../
203
204 +7. make && sudo make install 
205
206 +8. cd ../
207
208 +9. make 
209
210 +10. sudo cp location_conf.json  /etc/
211
212 +11. Edit the configuration file, and run the location service in the background: ./location &}}}
230 230  
231 -(((
232 232  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
233 -)))
234 234  
235 235  = 5. Configuration file: location_conf.json =
236 236  
237 -* (((
238 -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.
239 -)))
218 +* 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.
240 240  
241 -(((
242 242  { "location_conf": {
243 -)))
244 244  
245 -(% class="box" %)
246 -(((
247 -(((
248 - "loctype": "indoor",       ~/~/ indoor/outdoor
249 - "locmap": "mapwize"    ~/~/   Map interface: mapwize, traccar
250 -)))
251 -)))
222 +{{{ "loctype": "indoor", // indoor/outdoor
223 + "locmap": "mapwize" // Map interface: mapwize, traccar
224 +}}}
252 252  
253 -(((
254 254  }, "mqtt_conf": {
255 -)))
256 256  
257 -(% class="box" %)
258 -(((
259 -(((
260 - "servaddr": "[str]",    ~/~/     Lorawan server address: Refer to TTN app handler:eu.thethings.network
261 - "servport": [int],       ~/~/   Lorawan server port: 1883
262 - "clientid": "[str]",       ~/~/   MQTT client identity: Custom
263 - "qos":[int],                 ~/~/  (Optional) MQTT service quality: 0
264 - "username":"[str]",     ~/~/   Agent name of mqtt: application ID of TTN
265 - "password":"[str]",      ~/~/  The proxy password of mqtt: application access key of TTN
266 - "topic":"[str]",              ~/~/ The topic of mqtt subscription: TTN is + / devices / + / up
267 - "connection":"[str]" },   ~/~/(Optional) mqtt is a string used for direct connection, composed of serveraddr and port
268 - "mapwize_conf":{          ~/~/Map settings
269 - "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
270 - "venueid":"[str]",        ~/~/ (Optional)Indoor map area identification
271 - "orgid":"[str]",           ~/~/  The identity of the user organizer
272 - "universesid":"[str]",   ~/~/The range indicator of the indoor map, find it on the universes page
273 - "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
228 +{{{ "servaddr": "[str]", // Lorawan server address: Refer to TTN app handler:eu.thethings.network
229 + "servport": [int], // Lorawan server port: 1883
230 + "clientid": "[str]", // MQTT client identity: Custom
231 + "qos":[int], // (Optional) MQTT service quality: 0
232 + "username":"[str]", // Agent name of mqtt: application ID of TTN
233 + "password":"[str]", // The proxy password of mqtt: application access key of TTN
234 + "topic":"[str]", // The topic of mqtt subscription: TTN is + / devices / + / up
235 + "connection":"[str]" }, //(Optional) mqtt is a string used for direct connection, composed of serveraddr and port
236 +"mapwize_conf":{ //Map settings
237 + "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
238 + "venueid":"[str]", // (Optional)Indoor map area identification
239 + "orgid":"[str]", // The identity of the user organizer
240 + "universesid":"[str]", //The range indicator of the indoor map, find it on the universes page
241 + "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
274 274   },
275 275  "loracloud":{
276 - "token":  "[str]"          ~/~/The password string of loracloud location service, the outdoor map must fill in the account token of loracloud
277 -)))
278 -)))
244 + "token": "[str]" //The password string of loracloud location service, the outdoor map must fill in the account token of loracloud
245 +}}}
279 279  
280 -(((
281 281  }
282 -)))
283 283  
284 -(% class="box" %)
285 -(((
286 -(((
287 -"rssi_conf": {
288 - "rssirate": [int],          ~/~/ (Optional) A basis for rssi calculation distance, the rssi value (absolute value) when the beacon is 1 meter apart 
289 - "rssidiv": [float] }        ~/~/ (Optional) rssi measures an attenuation value of distance. As the distance to the beacon is farther, the value changes speed
290 -)))
291 -)))
249 +{{{"rssi_conf": {
250 + "rssirate": [int], // (Optional) A basis for rssi calculation distance, the rssi value (absolute value) when the beacon is 1 meter apart
251 + "rssidiv": [float] } // (Optional) rssi measures an attenuation value of distance. As the distance to the beacon is farther, the value changes speed
252 +}}}
292 292  
293 -(((
294 294  }
295 -)))
296 296  
297 297  * Parameter acquisition method of configuration file:
298 298  
299 -(% class="box" %)
300 -(((
301 -"username":"[str]"
302 -)))
258 +{{{"username":"[str]"
259 +}}}
303 303  
304 304  [[image:https://wiki.dragino.com/images/thumb/d/da/Beacon50.png/600px-Beacon50.png||height="185" width="600"]]
305 305  
306 306  username
307 307  
308 -(% class="box" %)
309 -(((
310 -"password":"[str]"     
311 -)))
265 +{{{"password":"[str]"
266 +}}}
312 312  
313 -[[image:https://wiki.dragino.com/images/thumb/b/bd/Beacon51.png/800px-Beacon51.png||alt="File:Beacon51.png" height="259" width="598"]]
268 +[[image:https://wiki.dragino.com/images/thumb/b/bd/Beacon51.png/600px-Beacon51.png||height="260" width="600"]]
314 314  
315 315  password
316 316  
317 -(% class="box" %)
318 -(((
319 -"apikey": "[str]"
320 -)))
272 +{{{"apikey": "[str]"
273 +}}}
321 321  
322 -[[image:https://wiki.dragino.com/images/thumb/5/53/Qwe3.png/800px-Qwe3.png||alt="File:Qwe3.png" height="328" width="612"]]
275 +[[image:https://wiki.dragino.com/images/thumb/5/53/Qwe3.png/600px-Qwe3.png||height="321" width="600"]]
323 323  
324 324  apikey
325 325  
326 -(% class="box" %)
327 -(((
328 -"orgid":"[str]"
329 -)))
279 +{{{"orgid":"[str]"
280 +}}}
330 330  
331 -[[image:https://wiki.dragino.com/images/thumb/f/f4/Qwe4.png/800px-Qwe4.png||alt="File:Qwe4.png" height="304" width="622"]]
282 +[[image:https://wiki.dragino.com/images/thumb/f/f4/Qwe4.png/600px-Qwe4.png||height="293" width="600"]]
332 332  
333 333  orgid
334 334  
335 -(% class="box" %)
336 -(((
337 -"universesid":"[str]"
338 -)))
286 +{{{"universesid":"[str]"
287 +}}}
339 339  
340 340  [[image:https://wiki.dragino.com/images/thumb/9/9a/Qwe5.jpg/600px-Qwe5.jpg||height="424" width="600"]]
341 341  
342 342  universesid
343 343  
344 -(% class="box" %)
345 -(((
346 -"placetype": "[str]"
347 -)))
293 +{{{"placetype": "[str]"
294 +}}}
348 348  
349 349  [[image:https://wiki.dragino.com/images/thumb/9/93/Qwe6.png/600px-Qwe6.png||height="318" width="600"]]
350 350  
... ... @@ -351,25 +351,24 @@
351 351  placetype
352 352  
353 353  
354 -**Here are two ways to enter the server:**
301 +* Here are two ways to enter the server
302 +* WinSCP
355 355  
356 -**~1. WinSCP**
357 -
358 358  [[image:https://wiki.dragino.com/images/thumb/6/6b/Ibeacon4.jpg/600px-Ibeacon4.jpg||height="385" width="600"]]
359 359  
360 360  [[image:https://wiki.dragino.com/images/thumb/7/78/Ibeacon5.jpg/600px-Ibeacon5.jpg||height="385" width="600"]]
361 361  
362 -[[image:https://wiki.dragino.com/images/thumb/c/cd/Ibeacon6.jpg/800px-Ibeacon6.jpg||alt="File:Ibeacon6.jpg" height="362" width="599"]]
308 +[[image:https://wiki.dragino.com/images/thumb/c/cd/Ibeacon6.jpg/600px-Ibeacon6.jpg||height="363" width="600"]]
363 363  
364 364  way1
365 365  
366 -**2. secureCRT**
312 +* secureCRT
367 367  
368 368  [[image:https://wiki.dragino.com/images/thumb/7/7b/Ibeacon7.jpg/600px-Ibeacon7.jpg||height="326" width="600"]]
369 369  
370 370  [[image:https://wiki.dragino.com/images/thumb/6/64/Ibeacon8.jpg/600px-Ibeacon8.jpg||height="326" width="600"]]
371 371  
372 -[[image:https://wiki.dragino.com/images/thumb/d/de/Ibeacon9.jpg/800px-Ibeacon9.jpg||alt="File:Ibeacon9.jpg" height="327" width="602"]]
318 +[[image:https://wiki.dragino.com/images/thumb/d/de/Ibeacon9.jpg/600px-Ibeacon9.jpg||height="326" width="600"]]
373 373  
374 374  way2
375 375