Wiki source code of Mapwize

Version 28.9 by Xiaoling on 2022/07/25 13:42

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

Wiki source code of Mapwize

Applications

Navigation