Wiki source code of Mapwize

Version 8.1 by Xiaoling on 2022/05/26 15:08

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

Wiki source code of Mapwize

Applications

Navigation