... |
... |
@@ -16,16 +16,22 @@ |
16 |
16 |
== 2.1 Prepare iBeacons == |
17 |
17 |
|
18 |
18 |
((( |
|
19 |
+((( |
19 |
19 |
Any BLE iBeacons should work in this solution, each iBeacon stands for a fix position in the map. Here is an iBeacon for example. |
20 |
20 |
))) |
|
22 |
+))) |
21 |
21 |
|
22 |
22 |
((( |
|
25 |
+((( |
23 |
23 |
First of all, user needs to accurately place the beacon at each location, which is the reference for positioning. |
24 |
24 |
))) |
|
28 |
+))) |
25 |
25 |
|
26 |
26 |
((( |
|
31 |
+((( |
27 |
27 |
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]] |
28 |
28 |
))) |
|
34 |
+))) |
29 |
29 |
|
30 |
30 |
[[image:https://wiki.dragino.com/images/thumb/8/88/Ibeacon1.png/300px-Ibeacon1.png||height="169" width="300"]] |
31 |
31 |
|
... |
... |
@@ -32,8 +32,10 @@ |
32 |
32 |
BCN01 iBeacon |
33 |
33 |
|
34 |
34 |
((( |
|
41 |
+((( |
35 |
35 |
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". |
36 |
36 |
))) |
|
44 |
+))) |
37 |
37 |
|
38 |
38 |
[[image:https://wiki.dragino.com/images/thumb/f/fa/Ibeacon2.jpg/400px-Ibeacon2.jpg||height="867" width="400"]] |
39 |
39 |
|
... |
... |
@@ -47,16 +47,22 @@ |
47 |
47 |
== 2.2 Create Map == |
48 |
48 |
|
49 |
49 |
((( |
|
58 |
+((( |
50 |
50 |
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. |
51 |
51 |
))) |
|
61 |
+))) |
52 |
52 |
|
53 |
53 |
((( |
|
64 |
+((( |
54 |
54 |
~1. Register an account at [[https:~~/~~/studio.mapwize.io/>>url:https://studio.mapwize.io/]] to create an indoor map. |
55 |
55 |
))) |
|
67 |
+))) |
56 |
56 |
|
57 |
57 |
((( |
|
70 |
+((( |
58 |
58 |
2. Create Place Types. |
59 |
59 |
))) |
|
73 |
+))) |
60 |
60 |
|
61 |
61 |
[[image:https://wiki.dragino.com/images/thumb/4/4d/Beacon10.png/600px-Beacon10.png||height="274" width="600"]] |
62 |
62 |
|
... |
... |
@@ -67,8 +67,10 @@ |
67 |
67 |
[[image:https://wiki.dragino.com/images/thumb/e/e8/Beacon11.jpg/600px-Beacon11.jpg||alt="Beacon11.jpg" height="324" width="600"]] |
68 |
68 |
|
69 |
69 |
((( |
|
84 |
+((( |
70 |
70 |
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. |
71 |
71 |
))) |
|
87 |
+))) |
72 |
72 |
|
73 |
73 |
4. Upload Floor plan. |
74 |
74 |
|
... |
... |
@@ -82,7 +82,9 @@ |
82 |
82 |
|
83 |
83 |
create layer |
84 |
84 |
|
|
101 |
+((( |
85 |
85 |
6. Add iBeacon position info. Drag the iBeacon to match position and input the UUID, MAJOR and MINOR of this iBeacon. |
|
103 |
+))) |
86 |
86 |
|
87 |
87 |
[[image:https://wiki.dragino.com/images/thumb/1/1d/Beacon14.png/600px-Beacon14.png||height="261" width="600"]] |
88 |
88 |
|
... |
... |
@@ -178,40 +178,53 @@ |
178 |
178 |
|
179 |
179 |
= 4. Set Up Converter Server = |
180 |
180 |
|
181 |
|
-* How to install and run this service on Linux? |
|
199 |
+* ((( |
|
200 |
+How to install and run this service on Linux? |
|
201 |
+))) |
182 |
182 |
|
|
203 |
+((( |
183 |
183 |
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 |
+))) |
184 |
184 |
|
|
207 |
+((( |
185 |
185 |
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 |
+))) |
186 |
186 |
|
|
211 |
+((( |
187 |
187 |
|
188 |
188 |
System: Debian / Ubuntu |
|
214 |
+))) |
189 |
189 |
|
190 |
|
-{{{step: |
191 |
|
- |
192 |
|
-1. sudo apt install libcurl4-dev |
193 |
|
- |
|
216 |
+(% class="box" %) |
|
217 |
+((( |
|
218 |
+step: |
|
219 |
+ |
|
220 |
+~1. sudo apt install libcurl4-dev |
|
221 |
+ |
194 |
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 |
|
- |
|
223 |
+ |
|
224 |
+3. git clone -b master https:~/~/github.com/mikayong/location.git |
|
225 |
+ |
198 |
198 |
4. cd location/libmqtt |
199 |
|
- |
|
227 |
+ |
200 |
200 |
5. mkdir build |
201 |
|
- |
|
229 |
+ |
202 |
202 |
6. cd build && cmake ../ |
203 |
|
- |
|
231 |
+ |
204 |
204 |
7. make && sudo make install |
205 |
|
- |
|
233 |
+ |
206 |
206 |
8. cd ../ |
207 |
|
- |
|
235 |
+ |
208 |
208 |
9. make |
209 |
|
- |
|
237 |
+ |
210 |
210 |
10. sudo cp location_conf.json /etc/ |
211 |
|
- |
212 |
|
-11. Edit the configuration file, and run the location service in the background: ./location &}}} |
|
239 |
+ |
|
240 |
+~11. Edit the configuration file, and run the location service in the background: ./location & |
|
241 |
+))) |
213 |
213 |
|
|
243 |
+((( |
214 |
214 |
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 |
|
245 |
+))) |
215 |
215 |
|
216 |
216 |
= 5. Configuration file: location_conf.json = |
217 |
217 |
|
... |
... |
@@ -219,37 +219,43 @@ |
219 |
219 |
|
220 |
220 |
{ "location_conf": { |
221 |
221 |
|
222 |
|
-{{{ "loctype": "indoor", // indoor/outdoor |
223 |
|
- "locmap": "mapwize" // Map interface: mapwize, traccar |
224 |
|
-}}} |
|
253 |
+(% class="box" %) |
|
254 |
+((( |
|
255 |
+ "loctype": "indoor", ~/~/ indoor/outdoor |
|
256 |
+ "locmap": "mapwize" ~/~/ Map interface: mapwize, traccar |
|
257 |
+))) |
225 |
225 |
|
226 |
226 |
}, "mqtt_conf": { |
227 |
227 |
|
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 |
|
261 |
+(% class="box" %) |
|
262 |
+((( |
|
263 |
+ "servaddr": "[str]", ~/~/ Lorawan server address: Refer to TTN app handler:eu.thethings.network |
|
264 |
+ "servport": [int], ~/~/ Lorawan server port: 1883 |
|
265 |
+ "clientid": "[str]", ~/~/ MQTT client identity: Custom |
|
266 |
+ "qos":[int], ~/~/ (Optional) MQTT service quality: 0 |
|
267 |
+ "username":"[str]", ~/~/ Agent name of mqtt: application ID of TTN |
|
268 |
+ "password":"[str]", ~/~/ The proxy password of mqtt: application access key of TTN |
|
269 |
+ "topic":"[str]", ~/~/ The topic of mqtt subscription: TTN is + / devices / + / up |
|
270 |
+ "connection":"[str]" }, ~/~/(Optional) mqtt is a string used for direct connection, composed of serveraddr and port |
|
271 |
+"mapwize_conf":{ ~/~/Map settings |
|
272 |
+ "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 |
|
273 |
+ "venueid":"[str]", ~/~/ (Optional)Indoor map area identification |
|
274 |
+ "orgid":"[str]", ~/~/ The identity of the user organizer |
|
275 |
+ "universesid":"[str]", ~/~/The range indicator of the indoor map, find it on the universes page |
|
276 |
+ "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 |
242 |
242 |
}, |
243 |
243 |
"loracloud":{ |
244 |
|
- "token": "[str]" //The password string of loracloud location service, the outdoor map must fill in the account token of loracloud |
245 |
|
-}}} |
|
279 |
+ "token": "[str]" ~/~/The password string of loracloud location service, the outdoor map must fill in the account token of loracloud |
|
280 |
+))) |
246 |
246 |
|
247 |
247 |
} |
248 |
248 |
|
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 |
|
-}}} |
|
284 |
+(% class="box" %) |
|
285 |
+((( |
|
286 |
+"rssi_conf": { |
|
287 |
+ "rssirate": [int], ~/~/ (Optional) A basis for rssi calculation distance, the rssi value (absolute value) when the beacon is 1 meter apart |
|
288 |
+ "rssidiv": [float] } ~/~/ (Optional) rssi measures an attenuation value of distance. As the distance to the beacon is farther, the value changes speed |
|
289 |
+))) |
253 |
253 |
|
254 |
254 |
} |
255 |
255 |
|