Jump to content

MESH FIRST START: Difference between revisions

From Teltonika Telematics Wiki
Created page with "== Wirepas First Start Guide (WNT, WPT & MQTT Console) == 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..."
 
No edit summary
Line 1: Line 1:
== Wirepas First Start Guide (WNT, WPT & MQTT Console) ==
== 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.
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.
Line 12: Line 12:
* A web browser
* A web browser


----
== Initial Gateway Connection ==


== Part 1: Gateway Initial Connection ==
'''1.''' Power on the gateway. The Wi-Fi LED should be blinking white.


'''Step 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).


'''Step 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:<code>tinygateway</code>


'''Step 3.''' Connect to the network. The default password is:
''' 4.''' Open a browser and navigate to:<code>192.168.4.1</code>
tinygateway


'''Step 4.''' Open a browser and navigate to:
''' 5.''' When prompted, enter the gateway web UI password:<code>blueup</code>
192.168.4.1
 
'''Step 5.''' When prompted, enter the gateway web UI password:
blueup


You are now connected to the gateway configuration interface.
You are now connected to the gateway configuration interface.


----
== Gateway Wi-Fi Configuration ==


== Part 2: Gateway Wi-Fi Configuration ==
'''1.''' Go to '''Configuration → Wi-Fi'''.


'''Step 1.''' Go to '''Configuration → Wi-Fi'''.
'''2.''' Change the '''Mode''' from '''Access Point''' to '''Station'''.


'''Step 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.


'''Step 3.''' Click the symbol 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'''.


'''Step 4.''' Enter the password for your chosen Wi-Fi network and press '''Save'''.
'''5.''' A reboot banner will appear — press '''Reboot now'''.
 
'''Step 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).
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).


{{Warning|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>}}
{| 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>
|}


== Part 3: Sink Configuration ==
== Sink Configuration ==


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


{{Note|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.}}
{| class="main-table" style="background: #E7F1FE; color: black;"
{| style="width: 800px;height: 60px; text-align: left; border: 1 px solid #0054A6; border-bottom: 1px solid #0054A6; border-left: 1px solid #0054A6;border-top: 1px solid #0054A6;border-right: 1px solid #0054A6;background: #E7F1FE; color: black; text-align: left; padding: 10px;"
| style="width: 40px;height: 20px;padding: 10px;" | [[File:Note_icon.png|30 px|link=]]
|| 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.
Save any changes and reboot when prompted.


----
== MQTT Configuration ==
 
== Part 4: MQTT Configuration ==


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


'''Step 2.''' Change the URI protocol from <code>mqtt://</code> to <code>mqtts://</code> by clicking the protocol prefix field.
'''2.''' Change the URI protocol from <code>mqtt://</code> to <code>mqtts://</code> by clicking the protocol prefix field.


'''Step 3.''' Enter the '''domain''' provided by Wirepas and change the '''port''' to:
'''3.''' Enter the '''domain''' provided by Wirepas and change the '''port''' to:<code>8883</code>
8883


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


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


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


=== Verifying Gateway Connectivity ===
=== Verifying Gateway Connectivity ===
Line 89: Line 84:
----
----


== Part 5: Wirepas Network Tool (WNT) Setup ==
== Wirepas Network Tool (WNT) Setup ==


'''Step 1.''' Install the '''Wirepas Network Tool''' provided by Wirepas.
''' 1.''' Install the '''Wirepas Network Tool''' provided by Wirepas.


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


'''Step 3.''' Click '''Connect''' and enter your login credentials. Click '''Log in'''.
''' 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).
Once logged in, node data will begin populating under the '''Nodes''' section (updated over time).
Line 112: Line 107:
----
----


== Part 6: Floor Plan Setup (Positioning) ==
== Floor Plan Setup (Positioning) ==


'''Step 1.''' Navigate to '''Settings → Building Floor Plans'''.
'''1.''' Navigate to '''Settings → Building Floor Plans'''.


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


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


You will see:
You will see:
Line 126: Line 121:
{{Note|The map can be panned by dragging and zoomed using the mouse wheel.}}
{{Note|The map can be panned by dragging and zoomed using the mouse wheel.}}


'''Step 4.''' Once all data is entered, press '''Save'''.
''' 4.''' Once all data is entered, press '''Save'''.


=== Placing Devices on the Map ===
=== Placing Devices on the Map ===


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


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


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


----
----


== Part 7: MQTT Console ==
== MQTT Console ==


The MQTT Console can be used locally or via browser:
The MQTT Console can be used locally or via browser:
Line 146: Line 141:
=== Connecting ===
=== Connecting ===


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


'''Step 2.''' Enter the connection details:
''' 2.''' Enter the connection details:


{| class="wikitable"
{| class="wikitable"
Line 163: Line 158:
|}
|}


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


=== Monitoring Messages ===
=== Monitoring Messages ===
Line 171: Line 166:
----
----


== Part 8: Data Parsing Reference ==
== Data Parsing Reference ==


There are two main message types:
There are two main message types:
Line 186: Line 181:
=== Parsing Standard 238/238 Endpoint (RSSI and Battery Info) ===
=== Parsing Standard 238/238 Endpoint (RSSI and Battery Info) ===


See also: [[EYE_SENSOR_MESH/MTSMP1#Parsing_standard_238/238_endpoint_for_Rssi_and_battery_info]]
Also see: [[EYE_SENSOR_MESH/MTSMP1#Parsing_standard_238/238_endpoint_for_Rssi_and_battery_info|Parsing standard 238/238 endpoint for Rssi and battery info]]


Example TLV payload:
Example TLV payload:<br>
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
<code><span style="color: blue;">47 11</span> <span style="color: green;">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</span> <span style="color: orange;">04 02 b7 0b</span> 06 0a 3c 00 00 00 11 00 00 00 01 ff</code>


{| class="wikitable"
{| class="wikitable"
Line 195: Line 190:
! Bytes !! Type !! Description
! Bytes !! Type !! Description
|-
|-
| <code>47 11</code> || Header || Message header; sequence number, incremented with every packet sent by this node
| <code><span style="color: blue;">47 11</span></code> || Header || Message header; sequence number, incremented with every packet sent by this node
|-
|-
| <code>05</code> || Type || 0x05 = Tag RSSI measurement
| <code><span style="color: green;">05</span></code> || Type || 0x05 = Tag RSSI measurement
|-
|-
| <code>1e</code> || Length || 30 bytes
| <code><span style="color: green;">1e</span></code> || Length || 30 bytes
|-
|-
| <code>43 9e 89 00</code> || Neighbor 1 || Node ID: 00 89 9e 43 hex → 9018947 dec
| <code><span style="color: green;">43 9e 89 00</span></code> || Neighbor 1 || Node ID: 00 89 9e 43 hex → 9018947 dec
|-
|-
| <code>80</code> || RSSI || Value × −0.5 → −64 dBm
| <code><span style="color: green;">80</span></code> || RSSI || Value × −0.5 → −64 dBm
|-
|-
| <code>31 9f 89 00</code> || Neighbor 2 || Node ID: 9019185
| <code><span style="color: green;">31 9f 89 00</span></code> || Neighbor 2 || Node ID: 9019185
|-
|-
| <code>7a</code> || RSSI || −61 dBm
| <code><span style="color: green;">7a</span></code> || RSSI || −61 dBm
|-
|-
| <code>7e 9e 89 00</code> || Neighbor 3 || Node ID: 9019006
| <code><span style="color: green;">7e 9e 89 00</span></code> || Neighbor 3 || Node ID: 9019006
|-
|-
| <code>84</code> || RSSI || −66 dBm
| <code><span style="color: green;">84</span></code> || RSSI || −66 dBm
|-
|-
| <code>25 00 00 00</code> || Neighbor 4 || Node ID: 37 (sink)
| <code><span style="color: green;">25 00 00 00</span></code> || Neighbor 4 || Node ID: 37 (sink)
|-
|-
| <code>68</code> || RSSI || −52 dBm
| <code><span style="color: green;">68</span></code> || RSSI || −52 dBm
|-
|-
| <code>48 9f 89 00</code> || Neighbor 5 || Node ID: 9019208
| <code><span style="color: green;">48 9f 89 00</span></code> || Neighbor 5 || Node ID: 9019208
|-
|-
| <code>74</code> || RSSI || −58 dBm
| <code><span style="color: green;">74</span></code> || RSSI || −58 dBm
|-
|-
| <code>3e 9f 89 00</code> || Neighbor 6 || Node ID: 9019198
| <code><span style="color: green;">3e 9f 89 00</span></code> || Neighbor 6 || Node ID: 9019198
|-
|-
| <code>74</code> || RSSI || −58 dBm
| <code><span style="color: green;">74</span></code> || RSSI || −58 dBm
|-
|-
| <code>04</code> || Type || 0x04 = Battery voltage
| <code><span style="color: orange;">04</span></code> || Type || 0x04 = Battery voltage
|-
|-
| <code>02</code> || Length || 2 bytes
| <code><span style="color: orange;">02</span></code> || Length || 2 bytes
|-
|-
| <code>b7 0b</code> || Battery voltage || 0b b7 hex → 2999 mV dec
| <code><span style="color: orange;">b7 0b</span></code> || Battery voltage || 0b b7 hex → 2999 mV dec
|-
|-
| <code>06 0a 3c 00 00 00 11 00 00 00 01 ff</code> || Reserved || Wirepas internal use
| <code>06 0a 3c 00 00 00 11 00 00 00 01 ff</code> || Reserved || Wirepas internal use
Line 236: Line 231:
=== Parsing Custom 11/11 Endpoint (Sensor Data) ===
=== Parsing Custom 11/11 Endpoint (Sensor Data) ===


See also: [[EYE_SENSOR_MESH/MTSMP1#Parsing_Custom_11/11_endpoint_for_Sensors_data]]
Also see: [[EYE_SENSOR_MESH/MTSMP1#Parsing_Custom_11/11_endpoint_for_Sensors_data|Parsing Custom 11/11 endpoint for Sensors data]]


Example TLV payload:
Example TLV payload: <br>
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
<code><span style="color: orange;"> 01 02 48 11</span> <span style="color: green;">02 04 3b 09 00 00</span> <span style="color: blue;">03 04 f6 93 00 00</span> <span style="color: brown;">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 </span><span style="color: pink;">0a 01 00</span></code>


{| class="wikitable"
{| class="wikitable"
Line 245: Line 240:
! Bytes !! Type !! Description
! Bytes !! Type !! Description
|-
|-
| <code>01</code> || 0x01 || Message counter
| <code><span style="color: orange;">01</span></code> || 0x01 || Message counter
|-
|-
| <code>02</code> || Length || 2 bytes
| <code><span style="color: orange;">02</span></code> || Length || 2 bytes
|-
|-
| <code>48 11</code> || Value || 11 48 hex → 4424 dec (counter value)
| <code><span style="color: orange;">48 11</span></code> || Value || 11 48 hex → 4424 dec (counter value)
|-
|-
| <code>02</code> || 0x02 || Temperature
| <code><span style="color: green;">02</span></code> || 0x02 || Temperature
|-
|-
| <code>04</code> || Length || 4 bytes
| <code><span style="color: green;">04</span></code> || Length || 4 bytes
|-
|-
| <code>3b 09 00 00</code> || Value || 09 3b hex → 2363 dec → '''23.63 °C'''
| <code><span style="color: green;">3b 09 00 00</span></code> || Value || 09 3b hex → 2363 dec → '''23.63 °C'''
|-
|-
| <code>03</code> || 0x03 || Humidity
| <code><span style="color: blue;">03</span></code> || 0x03 || Humidity
|-
|-
| <code>04</code> || Length || 4 bytes
| <code><span style="color: blue;">04</span></code> || Length || 4 bytes
|-
|-
| <code>f6 93 00 00</code> || Value || 5287 dec → '''52.87%'''
| <code><span style="color: blue;">f6 93 00 00</span></code> || Value || 5287 dec → '''52.87%'''
|-
|-
| <code>05</code> || 0x05 || Accelerometer X
| <code><span style="color: brown;">05</span></code> || 0x05 || Accelerometer X
|-
|-
| <code>04</code> || Length || 4 bytes
| <code><span style="color: brown;">04</span></code> || Length || 4 bytes
|-
|-
| <code>00 01 00 00</code> || Value || '''256 mG'''
| <code><span style="color: brown;">00 01 00 00</span></code> || Value || '''256 mG'''
|-
|-
| <code>06</code> || 0x06 || Accelerometer Y
| <code><span style="color: brown;">06</span></code> || 0x06 || Accelerometer Y
|-
|-
| <code>04</code> || Length || 4 bytes
| <code><span style="color: brown;">04</span></code> || Length || 4 bytes
|-
|-
| <code>90 fb ff ff</code> || Value || '''−1136 mG'''
| <code><span style="color: brown;">90 fb ff ff</span></code> || Value || '''−1136 mG'''
|-
|-
| <code>07</code> || 0x07 || Accelerometer Z
| <code><span style="color: brown;">07</span></code> || 0x07 || Accelerometer Z
|-
|-
| <code>04</code> || Length || 4 bytes
| <code><span style="color: brown;">04</span></code> || Length || 4 bytes
|-
|-
| <code>c0 fa ff ff</code> || Value || '''−1344 mG'''
| <code><span style="color: brown;">c0 fa ff ff</span></code> || Value || '''−1344 mG'''
|-
|-
| <code>08</code> || 0x08 || Roll
| <code><span style="color: brown;">08</span></code> || 0x08 || Roll
|-
|-
| <code>02</code> || Length || 2 bytes
| <code><span style="color: brown;">02</span></code> || Length || 2 bytes
|-
|-
| <code>08 00</code> || Value || '''8°'''
| <code><span style="color: brown;">08 00</span></code> || Value || '''8°'''
|-
|-
| <code>09</code> || 0x09 || Pitch
| <code><span style="color: brown;">09</span></code> || 0x09 || Pitch
|-
|-
| <code>02</code> || Length || 2 bytes
| <code><span style="color: brown;">02</span></code> || Length || 2 bytes
|-
|-
| <code>74 ff</code> || Value || '''−140°'''
| <code><span style="color: brown;">74 ff</span></code> || Value || '''−140°'''
|-
|-
| <code>0a</code> || 0x0a || Magnet status
| <code><span style="color: pink;">0a</span></code> || 0x0a || Magnet status
|-
|-
| <code>01</code> || Length || 1 byte
| <code><span style="color: pink;">01</span></code> || Length || 1 byte
|-
|-
| <code>00</code> || Value || Boolean — magnet '''not present'''
| <code><span style="color: pink;">00</span></code> || Value || Boolean — magnet '''not present'''
|}
|}

Revision as of 09:11, 4 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 the symbol 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 look similar 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.

Template:Note


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).

Template:Note

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
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