Gateways
The Gateways page provides a real-time, read-only view of every BLE gateway (receiver) registered in the system. Gateways are the fixed hardware units mounted throughout your facility that detect and receive signals from personnel badges and asset tags. Keeping gateways online is essential — an offline gateway creates a coverage gap and can cause personnel to appear missing during a muster.
This page is view-only. To add, edit, or remove gateways, go to Admin > Devices > Gateways.
Getting to Gateways
From the main navigation, select Gateways under the Monitoring section.
Page Overview
Screenshot placeholder: Gateways page — stats cards and card grid
When the page loads, it fetches the current status of all gateways and displays them. The page refreshes its status indicators automatically every 30 seconds.
Summary Stats
Three counters appear at the top:
| Stat | Meaning |
|---|---|
| Total Gateways | Total number of gateways configured in the system |
| Online | Gateways currently communicating with the system |
| Offline | Gateways that have not been seen recently and are considered unreachable |
Online and Offline Status
Each gateway shows one of two statuses:
| Status | Indicator | Meaning |
|---|---|---|
| Online | Green badge | The gateway has reported recently and is actively receiving BLE signals |
| Offline | Red badge | The gateway has not reported within the expected window — it may be powered off, disconnected from the network, or experiencing a fault |
Important: An offline gateway means any badges or assets in its coverage area will not be detected. If a muster is called while gateways are offline, personnel in those zones may not be accounted for. Investigate offline gateways promptly.
The status is re-evaluated every 30 seconds based on the gateway's last heartbeat time. A gateway that was recently online may briefly show as offline if it misses one check-in cycle — wait one refresh cycle before escalating.
Searching and Filtering
Search
A search box appears in the toolbar above the gateway list.
- Click the search box.
- Type part of a gateway name, ID, type, building name, or IP address.
- Results filter immediately as you type.
To clear the search, delete the text from the search box.
Building and Floor
The search field matches against building name, so typing a building name (for example, "North Building") narrows the list to gateways assigned to that location. This is useful in large facilities with many gateways spread across multiple buildings.
Switching Between Card and Table View
The Gateways page offers two ways to display the gateway list.
Card View (default)
Each gateway appears as a separate card showing:
- Gateway name (bold header)
- Status badge (Online / Offline)
- Type
- Building and floor assignment
- IP address
- MAC address
- Firmware version
- Last Seen timestamp
Offline gateway cards are visually distinguished with a red border tint so they stand out in a large grid.
To switch to card view, click the grid icon in the toolbar.
Table View
All gateways are shown in a sortable, paginated data table. Columns include:
| Column | Description |
|---|---|
| Name | Gateway friendly name |
| Type | Hardware or integration type |
| Status | Online / Offline badge |
| Building | Building assignment |
| Floor | Floor assignment |
| IP Address | Network IP (static or from last heartbeat) |
| MAC Address | Hardware MAC address |
| Firmware | Firmware version string |
| Last Seen | How long ago the gateway last checked in |
To sort by a column, click the column header. Click again to reverse the sort order. To switch to table view, click the table icon in the toolbar.
Tip: Use table view when you need to copy IP or MAC addresses, or when comparing firmware versions across many gateways at once.
Understanding Gateway Data Fields
Last Seen
Shows how recently the gateway last reported to the system. Values are displayed in a human-readable format:
- "Just now" — within the last minute
- "5m ago" — 5 minutes ago
- "2h ago" — 2 hours ago
- A date — if the gateway has not been seen for more than 24 hours
If "Last Seen" shows a date rather than a relative time, treat the gateway as potentially decommissioned or faulty.
IP Address
The gateway's network IP address, used to communicate with the system. The page uses the static IP address configured in Admin if available; if not, it falls back to the IP reported in the gateway's last heartbeat message. An IP of "N/A" means neither is available.
MAC Address
The hardware MAC address of the gateway. This is useful for correlating with network switch port information when diagnosing connectivity issues.
RSSI (Signal Strength)
Some gateway types report an average RSSI value — the received signal strength from the devices they are picking up. RSSI is measured in dBm (decibel-milliwatts):
| Range | Signal quality |
|---|---|
| Above -70 dBm | Strong |
| -70 to -85 dBm | Medium |
| Below -85 dBm | Weak |
A weak average RSSI may indicate that the gateway is too far from the devices it is monitoring, or that there is physical interference.
Event Count
If displayed, this shows the number of BLE events the gateway has reported in the current monitoring window. A gateway that is online but shows zero events may indicate a software or configuration issue even though the hardware is reachable.
Firmware Version
The firmware version string reported by the gateway. If firmware version management is relevant for your deployment, compare versions across gateways to identify units that may need updating. Contact your system administrator or the gateway vendor for firmware update procedures.
Exporting Gateway Data
To export the full gateway list to CSV:
- Click the Export button in the toolbar.
- A file named
gateways-YYYY-MM-DD.csvdownloads automatically. - The file includes: Name, Type, Status, Building, Floor, IP Address, MAC Address, Firmware, Last Seen.
Use case: Export the gateway list before a scheduled maintenance window so you have a baseline record of which gateways were online before work began.
Auto-Refresh Behaviour
The Gateways page uses a 30-second timer to re-evaluate each gateway's online/offline status based on its last-seen timestamp. The timer runs in the background — you do not need to manually refresh the page.
The gateway list itself is refreshed when you click the Refresh button (circular arrow icon) in the toolbar. Clicking Refresh re-fetches gateway records from the server, which is useful after adding a new gateway in Admin or after a network change.
What to Do When Gateways Are Offline
If you notice one or more gateways showing as Offline:
- Check physical connectivity — Confirm the gateway device is powered on and its network cable or Wi-Fi connection is active.
- Check the network — Confirm the gateway can reach the server. A network switch or firewall change may have blocked communication.
- Review the Last Seen time — If "Last Seen" is hours or days ago rather than minutes, the gateway has been offline for an extended period and needs investigation.
- Check the Activity Log — Go to the Activity Log and filter by the gateway in question. If recent events appear from that gateway, the offline status may be transient and will clear on the next refresh.
- Contact your IT team — If the gateway appears unreachable after confirming physical power and network, escalate to your IT or facilities team.
During an active muster: If gateways are offline during a muster event, personnel in the affected areas may not be automatically accounted for. Use manual roll-call procedures as a backup for those zones.
Frequently Asked Questions
How do I add a new gateway? New gateways are added in Admin > Devices > Gateways. The Gateways monitoring page is view-only.
Why does a gateway show as offline immediately after I added it? A newly added gateway will show as offline until it connects and sends its first heartbeat. Allow a few minutes for the gateway to initialise and check in.
The gateway shows online, but personnel in that area are not being detected. An online status only means the gateway is communicating with the system — it does not guarantee the gateway is detecting BLE signals. Check that badges in the area have sufficient battery (see Battery Health), and confirm the gateway's physical placement has line-of-sight or minimal obstruction to the coverage area.
Can I see which specific devices a gateway has detected? Yes — use the Activity Log and filter by the specific gateway to see all recent device detections.
Related Pages
- Battery Health — Monitor badge and device battery levels
- Activity Log — See individual detection events per gateway
- Analytics — Compare gateway event counts and signal quality over time