View source for MESH FIRST START

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

----

== Part 1: Gateway Initial Connection ==

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

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

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

'''Step 4.''' Open a browser and navigate to:
 192.168.4.1

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

You are now connected to the gateway configuration interface.

----

== Part 2: Gateway Wi-Fi Configuration ==

'''Step 1.''' Go to '''Configuration → Wi-Fi'''.

'''Step 2.''' Change the '''Mode''' from '''Access Point''' to '''Station'''.

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

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

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

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

----

== Part 3: Sink Configuration ==

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

Save any changes and reboot when prompted.

----

== Part 4: MQTT Configuration ==

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

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

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

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

{{Note|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.}}

----

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

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

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

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.

----

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

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

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

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

{{Note|The map can be panned by dragging and zoomed using the mouse wheel.}}

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

=== Placing Devices on the Map ===

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

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

----

== Part 7: MQTT Console ==

The MQTT Console can be used locally or via browser:

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

=== Connecting ===

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

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

{| class="wikitable"
|-
! Field !! Value
|-
| Address || As per the provided <code>.rst</code> file
|-
| Port || 9002
|-
| Username || Same as gateway MQTT credentials
|-
| Password || Same as gateway MQTT credentials
|}

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

----

== Part 8: Data Parsing Reference ==

There are two main message types:

{| class="wikitable"
|-
! Source/Destination !! Content
|-
| 238 / 238 || Positioning information (RSSI + battery)
|-
| 11 / 11 || Tag sensor data
|}

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

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

{| class="wikitable"
|-
! Bytes !! Type !! Description
|-
| <code>47 11</code> || Header || Message header; sequence number, incremented with every packet sent by this node
|-
| <code>05</code> || Type || 0x05 = Tag RSSI measurement
|-
| <code>1e</code> || Length || 30 bytes
|-
| <code>43 9e 89 00</code> || Neighbor 1 || Node ID: 00 89 9e 43 hex → 9018947 dec
|-
| <code>80</code> || RSSI || Value × −0.5 → −64 dBm
|-
| <code>31 9f 89 00</code> || Neighbor 2 || Node ID: 9019185
|-
| <code>7a</code> || RSSI || −61 dBm
|-
| <code>7e 9e 89 00</code> || Neighbor 3 || Node ID: 9019006
|-
| <code>84</code> || RSSI || −66 dBm
|-
| <code>25 00 00 00</code> || Neighbor 4 || Node ID: 37 (sink)
|-
| <code>68</code> || RSSI || −52 dBm
|-
| <code>48 9f 89 00</code> || Neighbor 5 || Node ID: 9019208
|-
| <code>74</code> || RSSI || −58 dBm
|-
| <code>3e 9f 89 00</code> || Neighbor 6 || Node ID: 9019198
|-
| <code>74</code> || RSSI || −58 dBm
|-
| <code>04</code> || Type || 0x04 = Battery voltage
|-
| <code>02</code> || Length || 2 bytes
|-
| <code>b7 0b</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
|}

=== Parsing Custom 11/11 Endpoint (Sensor Data) ===

See also: [[EYE_SENSOR_MESH/MTSMP1#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

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