Wiki source code of Mapwize

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

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
28.3	19	= 2. Prepare Map =
1.1	20
28.3	21	== 2.1 Prepare iBeacons ==
	22
	23
1.2	24	(((
1.3	25	(((
1.2	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	)))
1.3	28	)))
1.1	29
1.2	30	(((
1.3	31	(((
1.2	32	First of all, user needs to accurately place the beacon at each location, which is the reference for positioning.
	33	)))
1.3	34	)))
1.1	35
1.2	36	(((
1.3	37	(((
1.2	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]]
28.3	39
	40
1.2	41	)))
1.3	42	)))
1.1	43
6.2	44	[[image:image-20220526150651-4.png]]
1.1	45
1.2	46	BCN01 iBeacon
1.1	47
8.2	48
28.3	49
1.2	50	(((
1.3	51	(((
1.2	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	)))
1.3	54	)))
1.1	55
8.2	56	[[image:image-20220526150743-5.png]]
1.1	57
1.2	58	beacon software
	59
	60
28.3	61
8.2	62	[[image:image-20220526150824-6.png]]
1.2	63
	64	beacon software
	65
8.2	66
28.3	67	== 2.2 Create Map ==
	68
	69
1.2	70	(((
1.3	71	(((
1.2	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.
28.3	73
	74
1.2	75	)))
1.3	76	)))
1.2	77
	78	(((
1.3	79	(((
28.3	80	~1. Register an account at [[https:~~/~~/studio.mapwize.io/>>url:https://studio.mapwize.io/]] to create an indoor map.
1.2	81	)))
1.3	82	)))
1.2	83
	84	(((
1.3	85	(((
28.3	86	2. Create Place Types.
	87
	88
1.2	89	)))
1.3	90	)))
1.2	91
9.2	92	[[image:image-20220526150915-7.png]]
1.2	93
	94	Create place types
	95
9.2	96
1.2	97
28.3	98	3. Search Venues. （Indoor map area identification）
	99
	100
11.2	101	[[image:image-20220526151046-8.png]]
1.2	102
28.3	103
1.2	104	(((
1.4	105	(((
1.2	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.
11.2	107
28.3	108
11.2	109
1.2	110	)))
1.4	111	)))
1.2	112
28.3	113	4. Upload Floor plan.
1.2	114
28.3	115
11.2	116	[[image:image-20220526151223-9.png]]
1.2	117
	118	add images
	119
13.2	120
1.2	121
28.3	122	5. Create Layer
	123
	124
13.2	125	[[image:image-20220526151305-10.png]]
1.2	126
	127	create layer
	128
13.2	129
1.4	130	(((
28.3	131	6. Add iBeacon position info. Drag the iBeacon to match position and input the UUID, MAJOR and MINOR of this iBeacon.
	132
	133
1.4	134	)))
1.2	135
13.2	136	[[image:image-20220526151519-11.png]]
1.2	137
	138	create iBeacon
	139
15.2	140
28.4	141	= 3. Configure TTN =
1.2	142
28.4	143	== 3.1 Configure LBT1 to Upload data to TTN ==
	144
	145
2.4	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.
1.2	147
15.2	148
28.4	149	== 3.2 Decoder in TTN ==
	150
	151
1.2	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
15.2	232
28.4	233	= 4. Set Up Converter Server =
	234
	235
1.4	236	* (((
28.5	237	(% style="color:blue" %)How to install and run this service on Linux?
1.4	238	)))
1.2	239
1.4	240	(((
28.11	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).
1.4	242	)))
1.2	243
1.4	244	(((
28.11	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.
28.5	246
	247
1.4	248	)))
1.2	249
1.4	250	(((
28.5	251	System: Debian / Ubuntu
1.4	252	)))
1.2	253
1.4	254	(% class="box" %)
	255	(((
28.5	256	(% style="color:blue" %)step:(%%)
28.7	257	\\1. sudo apt install libcurl4-dev
	258	\\2. sudo apt install gcc automake autoconf libtool make cmake
1.8	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 &
1.4	268	)))
1.2	269
1.4	270	(((
28.11	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
15.2	272
	273
1.4	274	)))
1.2	275
28.6	276	= 5. Configuration file： location_conf.json =
1.2	277
28.6	278
1.9	279	* (((
28.8	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.
28.7	281
	282
1.9	283	)))
1.2	284
1.9	285	(((
1.2	286	{ "location_conf": {
1.9	287	)))
1.2	288
1.5	289	(% class="box" %)
	290	(((
1.9	291	(((
1.5	292	"loctype": "indoor", ~/~/ indoor/outdoor
	293	"locmap": "mapwize" ~/~/ Map interface: mapwize， traccar
	294	)))
1.9	295	)))
1.2	296
1.9	297	(((
1.2	298	}, "mqtt_conf": {
1.9	299	)))
1.2	300
1.5	301	(% class="box" %)
	302	(((
1.9	303	(((
1.5	304	"servaddr": "[str]", ~/~/ Lorawan server address: Refer to TTN app handler：eu.thethings.network
	305	"servport": [int], ~/~/ Lorawan server port: 1883
1.9	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
1.5	309	"password":"[str]", ~/~/ The proxy password of mqtt: application access key of TTN
1.10	310	"topic":"[str]", ~/~/ The topic of mqtt subscription: TTN is + / devices / + / up
1.5	311	"connection":"[str]" }, ~/~/（Optional） mqtt is a string used for direct connection, composed of serveraddr and port
1.9	312	"mapwize_conf":{ ~/~/Map settings
1.5	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
1.2	318	},
	319	"loracloud":{
1.5	320	"token": "[str]" ~/~/The password string of loracloud location service, the outdoor map must fill in the account token of loracloud
	321	)))
1.9	322	)))
1.2	323
1.9	324	(((
1.2	325	}
1.9	326	)))
1.2	327
1.5	328	(% class="box" %)
	329	(((
1.9	330	(((
1.5	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	)))
1.9	335	)))
1.2	336
1.9	337	(((
1.2	338	}
28.8	339
	340
	341
1.9	342	)))
1.2	343
28.8	344	* (% style="color:blue" %)Parameter acquisition method of configuration file：
1.2	345
28.8	346
1.6	347	(% class="box" %)
	348	(((
28.9	349	"username":"[str]"
1.6	350	)))
1.2	351
28.7	352
15.2	353	[[image:image-20220526151707-12.png]]
1.2	354
	355	username
	356
15.2	357
28.7	358
1.6	359	(% class="box" %)
	360	(((
28.9	361	"password":"[str]"
1.6	362	)))
1.2	363
15.2	364	[[image:image-20220526151736-13.png]]
1.2	365
	366	password
	367
15.2	368
28.7	369
1.6	370	(% class="box" %)
	371	(((
28.9	372	"apikey": "[str]"
1.6	373	)))
1.2	374
19.2	375	[[image:image-20220526151819-14.png\|\|height="588" width="1203"]]
1.2	376
	377	apikey
	378
28.7	379
	380
1.6	381	(% class="box" %)
	382	(((
28.9	383	"orgid":"[str]"
1.6	384	)))
1.2	385
19.2	386	[[image:image-20220526152014-15.png]]
1.2	387
	388	orgid
	389
19.2	390
28.7	391
1.6	392	(% class="box" %)
	393	(((
28.9	394	"universesid":"[str]"
1.6	395	)))
1.2	396
19.2	397	[[image:image-20220526152115-16.png]]
1.2	398
	399	universesid
	400
19.2	401
28.7	402
1.6	403	(% class="box" %)
	404	(((
28.9	405	"placetype": "[str]"
1.6	406	)))
1.2	407
19.2	408	[[image:image-20220526152150-17.png]]
1.2	409
	410	placetype
	411
	412
	413
28.7	414	(% style="color:blue" %)Here are two ways to enter the server：
1.6	415
28.7	416	(% style="color:red" %)1. WinSCP
	417
20.2	418	[[image:image-20220526152303-18.png]]
1.2	419
	420
24.2	421	[[image:image-20220526152355-19.png]]
20.3	422
1.2	423
24.2	424	[[image:image-20220526152912-20.png]]
	425
1.2	426	way1
	427
24.2	428
1.2	429
28.7	430	(% style="color:red" %)2. secureCRT
	431
24.2	432	[[image:image-20220526153145-22.png]]
1.2	433
26.2	434	[[image:image-20220526153236-23.png]]
1.2	435
26.2	436	[[image:image-20220526153304-24.png]]
1.2	437
	438	way2
	439
27.2	440
28.7	441	= 6. Test Result =
	442
	443
1.2	444	The real-time position on the map is obtained according to the moving change of LBT1.
	445
28.7	446
27.2	447	[[image:image-20220526153424-25.png\|\|height="693" width="1414"]]

Wiki source code of Mapwize

Applications

Navigation