Sensors Configuration Web UI

This page walks you through the configuration of your sensor using the Web UI and Web UI+ interfaces. Whether you are setting up the sensor for the first time, adjusting scanner settings, configuring an internet connection, or exporting data, this guide covers each step in sequence. Follow the sections in order for initial setup, or jump to the relevant section if you are making a specific change.

Connect TrafficXHub Unit to the Internet Using Phone Hotspot

You can use the Hotspot feature on any iOS or Android cellphones to temporary connect the TrafficXHub unit to the internet.

The images above show the hotspot settings screens for both iOS and Android. On iOS, make sure Maximize Compatibility is enabled so the TrafficXHub can connect successfully. On Android, select the 2.4 GHz band - the TrafficXHub does not support 5 GHz connections.

iOS Hotspot Configuration / Android Hotspot Configurationn

Once your phone hotspot is configured, open the TrafficXHub Web UI configuration page and go to Config > Connectivity > Network. Set the values to match your hotspot credentials as shown below.

This screen is where you enter your hotspot's SSID and password. Make sure the values match exactly what is configured on your phone before saving.

TrafficXHub Web UI: Config > Connectivity > Network

Sensors Configuration Web UI

The Web UI is your local interface for configuring the TrafficXHub™ sensor. From here you can manage scanner settings, set up your internet connection, monitor system status, and export collected data. The sections below walk you through each part of the interface in order.

Connecting to the Web UI

The sensor includes a comprehensive local web interface that you can use to configure the sensor, download collected data, and perform various other tasks.

There are two ways to connect to the Web UI: static IP or DHCP.

Static IP: Connect the sensor to your PC using an Ethernet cable. Change your PC's Ethernet settings to the following:

• IP: 192.168.0.20
• Subnet mask: 255.255.255.0

This screen shows where to apply the static IP and subnet mask in your PC's network adapter settings. Set these values exactly as shown before proceeding.

Turn on the sensor. Open a web browser (Chrome or Firefox) and type 192.168.0.22 in the URL bar, then press Enter. The sensor Web UI status page should appear shortly.

DHCP: An office router is required. Connect the sensor to the router using an Ethernet cable - the router will automatically assign an IP address to the sensor. You can find this IP address by checking the router's device list or by using http://raspberrypi.local/ as the hostname. Once you have the IP address, open a browser, type it into the URL bar, and press Enter to open the Web UI.

To access all configuration menus, log in using "admin" as both the username and password.

System Status

Once logged in, the System Status page gives you an overview of the sensor's current state.

This section shows the sensor's hardware and firmware versions, serial number, and clock sync status. The clock sync status is a critical indicator — a status of "True" confirms the clock has been synced via GPS or internet since power-on, and that data will be recorded correctly. If this reads "False," do not begin data collection until the clock has synced.

The records and logs statistics show information about the last MAC address record (Wi-Fi and Bluetooth MAC addresses, RSSI, and Detection Time) and the most recent system log saved to the sensor's SD card.

If no recent records appear here, verify that the clock sync status is "True" before troubleshooting further.

The Monitor section provides a live view of the sensor's connection status, GPS signal, SD card usage, and temperature and humidity readings. Check this panel to confirm connectivity and storage availability before and during deployment.

The System Processes section lists all running processes and their current status — running, stopped, or exited. To view the output of any individual process, click the "stdout" or "stderr" button next to it. If a process shows as "stopped" or "exited" unexpectedly, use these outputs to help diagnose the issue.

Basic Configurations

The Basic Configurations tab is where you manage the sensor's core settings, including the scanner, connection to the SMATS iNode™ analytics server, and internet connectivity.

General

The General tab contains the following settings:

• MAC Hashing: Set to "Yes" to store a hashed form of detected MAC addresses, which protects privacy by preventing the original address from being recovered.
• Time Zone: Set this to the local time zone of the location where data is being collected.
• Host Domain: This is the endpoint for connecting the sensor to the iNode™ data analytics server.

Make sure the time zone and host domain are correctly configured before deploying the sensor.

Scanner

The Scanner tab lets you configure the Wi-Fi and Bluetooth scanning behaviour. The first image shows the main scanner settings. The second shows the format for entering MAC addresses when using Range Test Mode.

• Auto Start: When enabled, the scanner starts automatically each time the sensor boots up.
• Range Test Mode: Set to "Yes" to test the sensor's detection range. Enter the 6-byte MAC addresses of known devices in the format shown in the image above. In this mode, the scanner's LED blinks rapidly — once the target MAC address is detected, the LED becomes solid. To reset the LED, toggle the LED switch off and back on.

To determine detection range, begin approaching the sensor from a distance with a known device - such as a phone with Bluetooth in discovery mode (go to Settings > Bluetooth), or with Wi-Fi on and the screen unlocked. The distance at which the LED turns solid is the maximum detection range for that device in that environment.

Ignore MAC Interval (in seconds) sets a window during which a repeated MAC address will not be recorded as a new detection. Adjust this to manage how frequently repeat detections are logged and to conserve SD card storage.

Advanced Configurations

The Advanced Configurations section contains settings that go beyond the standard setup. Only make changes here if you are specifically instructed to by SMATS — incorrect configuration can affect the sensor's connection and data recording.

General

The Advanced General tab contains the UUID — the unique identifier that the sensor uses to establish its connection to iNode™. If you are moving a sensor from one project or location to another, this UUID must be reset. Resetting it causes iNode™ to treat the sensor as a new device and creates a new data table on the server.

Monitor

The Monitor tab is used for advanced configuration of internet connection, VPN, Database Sweeper, and related settings. This section is intended for advanced users only. Do not modify settings here unless you are specifically instructed to.

Internet Connection (GSM Settings)

An internet connection is required for real-time communication between the sensor and the iNode™ server, and also for syncing the sensor's clock in locations where GPS signal is poor (such as indoors).

You can configure the internet source - cellular (GSM), Wi-Fi, or Ethernet - under the Internet Connection tab.

This screen shows the settings for a GSM internet connection. The sensor ships with a GSM modem compatible with your cellular network provider. If SMATS did not provide the SIM card, insert a Micro-SIM card and enter the SIM card's APN in the configuration menu before saving.

VPN Settings

To enable remote access to the sensor, a VPN connection must be established between the sensor and the iNode™ server..

Under the Monitor tab in the advanced configuration settings, you can upload a VPN config client file. In most cases, this file comes pre-loaded on the sensor. If the VPN config file needs to be replaced, upload the new file here before adjusting any other VPN parameters.

System Command

The System Command menu gives you access to maintenance and update functions for the sensor. The available actions are:

1. Clear (sensor's local) database - empties MAC address records from the SD card
2. Check for firmware update
3. Update sensor firmware (internet connection required)
4. Restart device
5. Remove system logs
6. Save current local settings
7. Export current settings as a zip file
8. Import settings as a zip file
9. Restore last local settings

Use these options with care - clearing the database or restoring settings cannot be undone.

Data Export

The collected MAC address records can be exported to a CSV file using the Export menu shown above. Select your desired date range and click Export to download the data.

The export produces two output files:

records.csv contains the fingerprint (MAC address), detection type (e.g. Bluetooth vs. Wi-Fi), detection signal strength (RSSI), and detection time (create_time). The image above shows an example of this file's contents.

Detection types are coded as shown in the table above. Use this reference when interpreting the detection_type column in your exported records.

config.csv contains the latest status of the sensor at time of export, including SD card usage and last known GPS coordinates.

Sensor Configuration Web UI+

The Web UI+ is an updated version of the sensor's local interface with an enhanced layout. The connection process and configuration options are the same as the standard Web UI - if you've already worked through that section, the structure here will feel familiar.

Connecting to the Web UI+

The Web UI+ is an updated version of the sensor's local web interface with an enhanced layout. The connection process is the same as the standard Web UI — you can connect via static IP or DHCP.

Static IP: Connect the sensor to your PC via Ethernet, then update your PC's Ethernet settings:

• IP: 192.168.0.20
• Subnet mask: 255.255.255.0

Apply these settings in your network adapter configuration exactly as shown above before proceeding.

Turn on the sensor, open Chrome or Firefox, and navigate to 192.168.0.22. The Web UI+ status page will load shortly.

DHCP: Connect the sensor to an office router via Ethernet. The router will assign an IP automatically. Find it in the router's device list or use http://smats-xxxxxx.local as the hostname, replacing xxxxxx with the last 6 digits of the sensor's serial number. Open a browser, enter the IP in the URL bar, and press Enter.

Log in with "admin" as both the username and password to access all configuration menus.

System Status

The System Status page in the Web UI+ shows the sensor's hardware and firmware versions, serial number, and clock sync status. A status of "True" confirms the clock is synced and the sensor is recording correctly. Verify this before starting data collection.

The Monitor section shows the sensor's connection status, GPS signal, SD card usage, and temperature and humidity readings. Check this panel to confirm connectivity and available storage before deploying.

The System Processes section lists all active background services and their statuses. Click "stdout" or "stderr" to view output for any process.

To view detailed logs for a specific process, click the "Action" dropdown for that process and select "View Logs".

The first image shows the Action dropdown menu. The second shows the log viewer - use this to troubleshoot any processes that are not running as expected.

Configurations Menu

The Configurations Menu is where you manage the sensor's core settings. The tabs below cover the key areas you'll need to configure before and during deployment.

General

The General tab contains the sensor's time zone, MAC Hashing setting, and Host Domain — the same fields as the standard Web UI. Confirm these settings match your deployment requirements before proceeding.

Scanner

The Scanner tab works the same way as in the standard Web UI. Set Auto Start, configure Range Test Mode if needed, and enter MAC addresses for range testing.

Ignore MAC Interval (in seconds) sets a window during which a repeated detection will not be re-recorded. Adjust this to manage storage usage.

Internet Connection (GSM Settings)

Internet connection settings in the Web UI+ work the same as in the standard Web UI. The first image shows the main GSM settings screen. The second shows additional fields that may appear depending on your SIM card provider. Configure your GSM, Wi-Fi, or Ethernet source under the Internet Connection tab.

VPN Settings

VPN configuration works the same as in the standard Web UI. If the pre-loaded VPN config is active, no action is needed. If it needs to be replaced, upload the new config file here before adjusting any other settings.

Monitor

The Monitor tab provides advanced configuration options for internet connection, VPN, Database Sweeper, and more. This section is intended for advanced users only. Do not make changes here unless you are specifically instructed to.

System Command

The System Command menu in the Web UI+ includes an expanded set of actions compared to the standard Web UI:

1. Restart Sensor
2. Force Restart Sensor
3. Restart XHub Service
4. Restart Database Service
5. Restart Redis Service
6. Restart Webssh Service
7. Prune Images
8. Truncate Records
9. Truncate Logs
10. Re-init Database
11. Backup Config (local)
12. Restore Config (from local config backup)
13. Download/Restore Config
14. Upload/Restore Config
15. Flush Redis
16. Check Latest Firmware Update
17. Pull Latest Firmware Update
18. Apply Latest Firmware Update

Use these options carefully - actions like Truncate Records and Re-init Database cannot be undone.

Data Export

The Export menu in the Web UI+ works the same as in the standard Web UI. Use it to download records.csv and config.csv.

records.csv contains the fingerprint (MAC address), detection type, signal strength (RSSI), and detection time.

Detection types follow the same coding as the standard Web UI. Use the table above to interpret the detection_type column in your exported data.

Table of Contents

• Sensors Configuration Web UI
• Connect TrafficXHub Unit to the Internet Using Phone Hotspot
• iOS Hotspot Configuration / Android Hotspot Configurationn
• Sensors Configuration Web UI
• Connecting to the Web UI
• System Status
• Basic Configurations
• General
• Scanner
• Advanced Configurations
• General
• Monitor
• System Command
• Data Export
• Sensor Configuration Web UI+
• Connecting to the Web UI+
• System Status
• Configurations Menu
• General
• Scanner
• Internet Connection (GSM Settings)
• VPN Settings
• Monitor
• System Command
• Data Export