MESH FIRST START: Difference between revisions

Latest revision as of 09:49, 11 May 2026

Wirepas First Start Guide

This guide covers the initial setup of the Wirepas Mesh Demo Kit with the Wirepas Network Tool (WNT), Wirepas Positioning Tool (WPT), and MQTT Console.

Prerequisites

Before starting, make sure you have the following ready:

Mesh Demo Kit hardware (gateway + anchors + tags)
Software and authentication details requested via HelpDesk
A PC or mobile device with Wi-Fi capability
A web browser

Initial Gateway Connection

1. Power on the gateway. The Wi-Fi LED should be blinking white.

2. On your PC or mobile device, go to Wi-Fi settings and look for a network named similarly to tinygateway-cd0d (the exact name may differ per unit).

3. Connect to the network. The default password is:tinygateway

4. Open a browser and navigate to:192.168.4.1

5. When prompted, enter the gateway web UI password:blueup

You are now connected to the gateway configuration interface.

Gateway Wi-Fi Configuration

1. Go to Configuration → Wi-Fi.

2. Change the Mode from Access Point to Station.

3. Click thesymbol under SSID — a list of visible Wi-Fi networks will appear. Select your local Wi-Fi network.

4. Enter the password for your chosen Wi-Fi network and press Save.

5. A reboot banner will appear — press Reboot now.

The gateway will now attempt to connect to the specified Wi-Fi. Your PC or mobile device should reconnect automatically to the same network (depending on device settings).

If the browser stops on the Rebooting screen, make sure your PC is connected to the same Wi-Fi network as the gateway. Open a new browser tab and enter the URL printed on the back of the gateway. It should have a similar structure to: btgw-0000dcda0c1ccd0c.local

Sink Configuration

Once logged back in to the gateway, go to the Sink configuration section.

If the gateway is from a Teltonika Demo Kit, no changes should be needed here by default. If the gateway was previously reset, configure the sink settings according to the Demo Kit defaults.

Save any changes and Reboot when prompted.

MQTT Configuration

1. Under MQTT settings, click the checkmark next to Disabled to enable MQTT configuration.

2. Change the URI protocol from mqtt:// to mqtts:// by clicking the protocol prefix field.

3. Enter the domain provided by Wirepas and change the port to:8883

4. Click the checkbox next to Use credentials. Enter the Username and Password as provided by Wirepas.

5. Click the Cloud download button to automatically download the CA Certificate.

6. After the certificate downloads, press Save, then Reboot now.

Verifying Gateway Connectivity

After rebooting and reconnecting, navigate to the Device tab. You should see 4 green ticks, indicating:

Gateway configuration is complete
Gateway can reach the MQTT broker

You can also check the Nodes section to confirm live data is flowing through the gateway.

Gateway setup is now complete. You may close the browser — the gateway will always boot with these settings unless physically reset using the button on the device.

Wirepas Network Tool (WNT) Setup

1. Install the Wirepas Network Tool provided by Wirepas.

2. Launch WNT. When prompted, enter the authentication server address provided by Wirepas.

3. Click Connect and enter your login credentials. Click Log in.

Once logged in, node data will begin populating under the Nodes section (updated over time).

Approving Nodes

For nodes to be used in positioning, they must first be approved:

Single node: Right-click the node → Approve
Multiple nodes: Use CTRL+click (individual), SHIFT+click (range), or CTRL+A (all) to select, then right-click → Approve

Setting Anchor Positioning Role

Select your gateway and anchors in the node list, right-click, and choose Set anchor positioning role. This designates them as fixed reference points on the map for positioning tags.

Floor Plan Setup (Positioning)

1. Navigate to Settings → Building Floor Plans.

2. Click the white box under Floor Plans to import a floor plan image.

3. Click on the floor plan to enter Geo Location mode.

You will see:

4 black dots (A, B, C, D) — place these at known GPS positions (e.g. corners of the floor plan). For each dot, enter the Latitude, Longitude, and Height.
2 blue dots (1 and 2) — drag these to two points with a known distance between them (used for scale).

The map can be panned by dragging and zoomed using the mouse wheel.

4. Once all data is entered, press Save.

Placing Devices on the Map

1. Go to Settings → Node Management. In the top right corner, select your floor plan.

2. Drag and drop the gateway and anchors to their known fixed positions on the map.

3. Drag and drop the tag onto the map as well. The tag's position will be updated automatically with each subsequent advertising packet.

MQTT Console

The MQTT Console can be used locally or via browser:

https://wirepas-tools.github.io/mqtt-console/master/

Connecting

1. The dashboard will initially show as disconnected. Click MQTT connection.

2. Enter the connection details:

Field	Value
Address	As per the provided `.rst` file
Port	9002
Username	Same as gateway MQTT credentials
Password	Same as gateway MQTT credentials

3. Click Connect. If successful, you will see a green "Connected" indicator in the top right of the browser tab.

Monitoring Messages

Under the Messages tab, all traffic can be monitored. Use filters to search for specific gateway or tag data.

Data Parsing Reference

There are two main message types:

Source/Destination	Content
238 / 238	Positioning information (RSSI + battery)
11 / 11	Tag sensor data

Parsing Standard 238/238 Endpoint (RSSI and Battery Info)

Also see: Parsing standard 238/238 endpoint for Rssi and battery info

Example TLV payload:
47 11 05 1e 43 9e 89 00 80 31 9f 89 00 7a 7e 9e 89 00 84 25 00 00 00 68 48 9f 89 00 74 3e 9f 89 00 74 04 02 b7 0b 06 0a 3c 00 00 00 11 00 00 00 01 ff

Bytes	Type	Description
`47 11`	Header	Message header; sequence number, incremented with every packet sent by this node
`05`	Type	0x05 = Tag RSSI measurement
`1e`	Length	30 bytes
`43 9e 89 00`	Neighbor 1	Node ID: 00 89 9e 43 hex → 9018947 dec
`80`	RSSI	Value × −0.5 → −64 dBm
`31 9f 89 00`	Neighbor 2	Node ID: 9019185
`7a`	RSSI	−61 dBm
`7e 9e 89 00`	Neighbor 3	Node ID: 9019006
`84`	RSSI	−66 dBm
`25 00 00 00`	Neighbor 4	Node ID: 37 (sink)
`68`	RSSI	−52 dBm
`48 9f 89 00`	Neighbor 5	Node ID: 9019208
`74`	RSSI	−58 dBm
`3e 9f 89 00`	Neighbor 6	Node ID: 9019198
`74`	RSSI	−58 dBm
`04`	Type	0x04 = Battery voltage
`02`	Length	2 bytes
`b7 0b`	Battery voltage	0b b7 hex → 2999 mV dec
`06 0a 3c 00 00 00 11 00 00 00 01 ff`	Reserved	Wirepas internal use

Parsing Custom 11/11 Endpoint (Sensor Data)

Also see: Parsing Custom 11/11 endpoint for Sensors data

Example TLV payload:
01 02 48 11 02 04 3b 09 00 00 03 04 f6 93 00 00 05 04 00 01 00 00 06 04 90 fb ff ff 07 04 c0 fa ff ff 08 02 08 00 09 02 74 ff 0a 01 00

Bytes	Type	Description
`01`	0x01	Message counter
`02`	Length	2 bytes
`48 11`	Value	11 48 hex → 4424 dec (counter value)
`02`	0x02	Temperature
`04`	Length	4 bytes
`3b 09 00 00`	Value	09 3b hex → 2363 dec → 23.63 °C
`03`	0x03	Humidity
`04`	Length	4 bytes
`f6 93 00 00`	Value	5287 dec → 52.87%
`05`	0x05	Accelerometer X
`04`	Length	4 bytes
`00 01 00 00`	Value	256 mG
`06`	0x06	Accelerometer Y
`04`	Length	4 bytes
`90 fb ff ff`	Value	−1136 mG
`07`	0x07	Accelerometer Z
`04`	Length	4 bytes
`c0 fa ff ff`	Value	−1344 mG
`08`	0x08	Roll
`02`	Length	2 bytes
`08 00`	Value	8°
`09`	0x09	Pitch
`02`	Length	2 bytes
`74 ff`	Value	−140°
`0a`	0x0a	Magnet status
`01`	Length	1 byte
`00`	Value	Boolean — magnet not present

@@ Line 17: / Line 17: @@
 '''2.''' On your PC or mobile device, go to Wi-Fi settings and look for a network named similarly to '''tinygateway-cd0d''' (the exact name may differ per unit).
+[[File:Mesh cd0d.png|300x300px]]
 ''' 3.''' Connect to the network. The default password is:<code>tinygateway</code>
@@ Line 29: / Line 30: @@
 '''1.''' Go to '''Configuration → Wi-Fi'''.
+[[File:Teltonika Gateway Wirepass - Configuration.png|450x450px]]
 '''2.''' Change the '''Mode''' from '''Access Point''' to '''Station'''.
-'''3.''' Click the symbol under '''SSID''' — a list of visible Wi-Fi networks will appear. Select your local Wi-Fi network.
+'''3.''' Click the[[File:Wi-Fi icon wirepass.png|40x40px]]symbol under '''SSID''' — a list of visible Wi-Fi networks will appear. Select your local Wi-Fi network.
+[[File:Wirepass network SSID.png|300x300px]]
 '''4.''' Enter the password for your chosen Wi-Fi network and press '''Save'''.
 '''5.''' A reboot banner will appear — press '''Reboot now'''.
+[[File:Wirepass reboot banner.png|1000x1000px]]
 The gateway will now attempt to connect to the specified Wi-Fi. Your PC or mobile device should reconnect automatically to the same network (depending on device settings).
@@ Line 42: / Line 49: @@
 {| style="width: 800px;height: 60px; text-align: left; border: 1 px solid #FFCC33; border-bottom: 1px solid #FFCC33; border-left: 1px solid #FFCC33;border-top: 1px solid #FFCC33;border-right: 1px solid #FFCC33;background: #FEF6E7; color: black; text-align: left; padding: 10px;"
 | style="width: 40px;height: 20px;padding: 10px;" | [[File:Warning.png|30 px|link=]]
-||If the browser stops on the ''Rebooting'' screen, make sure your PC is connected to the same Wi-Fi network as the gateway. Open a new browser tab and enter the URL printed on the back of the gateway. It should look similar to: <code>btgw-0000dcda0c1ccd0c.local</code>
+||If the browser stops on the ''Rebooting'' screen, make sure your PC is connected to the same Wi-Fi network as the gateway. Open a new browser tab and enter the URL printed on the back of the gateway. It should have a similar structure to: <code>btgw-0000dcda0c1ccd0c.local</code>
 |}
@@ Line 55: / Line 62: @@
 |}
-Save any changes and reboot when prompted.
+'''Save''' any changes and '''Reboot''' when prompted.
 == MQTT Configuration ==
 '''1.''' Under '''MQTT settings''', click the checkmark next to '''Disabled''' to enable MQTT configuration.
+[[File:Wirepass MQTT.png]]
 '''2.''' Change the URI protocol from <code>mqtt://</code> to <code>mqtts://</code> by clicking the protocol prefix field.
+[[File:Wirepass Uri.png]]
 '''3.''' Enter the '''domain''' provided by Wirepas and change the '''port''' to:<code>8883</code>
 '''4.''' Click the checkbox next to '''Use credentials'''. Enter the '''Username''' and '''Password''' as provided by Wirepas.
+[[File:Wirepas user credentials.png|750x750px]]
 '''5.''' Click the '''Cloud download''' button to automatically download the CA Certificate.
+[[File:Wirepas CA certificate DW.png|500x500px]]
 '''6.''' After the certificate downloads, press '''Save''', then '''Reboot now'''.
+[[File:Wirepas CA certificate reboot.png|500x500px]]
 === Verifying Gateway Connectivity ===
@@ Line 91: / Line 108: @@
 ''' 2.''' Launch WNT. When prompted, enter the '''authentication server address''' provided by Wirepas.
+[[File:Wirepas network tool screen.png|500x500px]]
 ''' 3.''' Click '''Connect''' and enter your login credentials. Click '''Log in'''.
@@ Line 102: / Line 121: @@
 * '''Single node:''' Right-click the node → '''Approve'''
 * '''Multiple nodes:''' Use '''CTRL+click''' (individual), '''SHIFT+click''' (range), or '''CTRL+A''' (all) to select, then right-click → '''Approve'''
+[[File:WNT approve node.png|500x500px]]
 === Setting Anchor Positioning Role ===
 Select your '''gateway and anchors''' in the node list, right-click, and choose '''Set anchor positioning role'''. This designates them as fixed reference points on the map for positioning tags.
+[[File:WNT anchor possition.png|500x500px]]
 == Floor Plan Setup (Positioning) ==
@@ Line 112: / Line 135: @@
 '''2.''' Click the white box under '''Floor Plans''' to import a floor plan image.
+[[File:WTN Floor Plans.png|500x500px]]
 '''3.''' Click on the floor plan to enter '''Geo Location''' mode.
+[[File:WTN Floor Plans Settings.png|500x500px]]
 You will see:
@@ Line 126: / Line 153: @@
 ''' 4.''' Once all data is entered, press '''Save'''.
+[[File:WTN Floor Plans Settings Save.png|750x750px]]
 === Placing Devices on the Map ===
 '''1.''' Go to '''Settings → Node Management'''. In the top right corner, select your floor plan.
+[[File:Mesh Node Management.png|750x750px]]
 '''2.''' Drag and drop the '''gateway and anchors''' to their known fixed positions on the map.
+[[File:MESH floor plan.png|750x750px]]
 '''3.''' Drag and drop the '''tag''' onto the map as well. The tag's position will be updated automatically with each subsequent advertising packet.
+[[File:MESH floor plan 1.png|750x750px]]
 == MQTT Console ==
@@ Line 144: / Line 179: @@
 ''' 1.''' The dashboard will initially show as disconnected. Click '''MQTT connection'''.
+[[File:MQTT Console.png|750x750px]]
 ''' 2.''' Enter the connection details:
@@ Line 161: / Line 198: @@
 ''' 3.''' Click '''Connect'''. If successful, you will see a '''green "Connected"''' indicator in the top right of the browser tab.
+[[File:MQTT broker connection.png|650x650px]]
 === Monitoring Messages ===
 Under the '''Messages''' tab, all traffic can be monitored. Use filters to search for specific gateway or tag data.
+[[File:MQTT Console Trafic.png|1000x1000px]]
 == Data Parsing Reference ==