Synapsys Module
The Synapsys module is the main tracking component of the ION Guard platform. It provides BLE-based indoor location, panic alerts, device monitoring, and analytics.
Sub-features per site
Synapsys groups its capabilities into sub-features that the Platform Admin can enable or disable individually per site — without turning off the entire module (see Modules):
| Sub-feature | Identifier | What it delivers |
|---|---|---|
| Panic Button | panic-button | Panic alerts triggered by beacons and the associated response flow |
| Asset Tracking | asset-tracking | Location and history of beacons/assets by zone, tracking menu items |
| Cold Room | cold-room | Dwell time and thermal break monitoring — see Cold Room Module |
In the portal, Cold Room is documented as its own subcategory because it has an extensive functional scope, but technically it is delivered as the cold-room sub-feature within the Synapsys module (indoor-location), reusing the same beacon and antenna infrastructure.
Features
Real-time tracking
- Beacon location by zone using RSSI signals captured by antennas
- Confidence calculation based on signal count, intensity, margin, and temporal consistency
- Hysteresis to avoid oscillation between adjacent zones
- Visualization in Zone Map with interactive floor plans
- Location history per beacon
Alerts
The module registers 5 alert types:
| Type | Severity | Trigger | Auto-resolve |
|---|---|---|---|
| Panic Button | Critical | Beacon sends panic signal | No |
| Device Offline | High | Beacon stops sending signals | Yes (when back online) |
| Antenna Offline | High | Antenna stops transmitting | Yes (when back online) |
| Low Battery | Warning | Battery level below threshold | Yes (when level normalizes) |
| Restricted Zone Entry | High | Beacon detected in a Restricted zone | Configurable |
All alerts are escalatable — see Escalation for times per type.
Devices
- Management of Beacons (3 types: panic, asset, personal)
- Management of Antennas with automatic MQTT configuration
- Health monitoring: online/offline status, battery level, last signal
Analytics
The module includes an Analytics page (/analytics) with:
- Response metrics — Average alert response time (avg, p50, p95)
- Alert volume — Breakdown by type and severity
- Resolution — Manual vs. automatic resolution rate
- Zone occupancy — Presence heatmap by zone
- Operator performance — Metrics per operator
- Device availability — Ranking of most-alerted devices
- Escalation trend — Evolution of escalated alerts
Reports
6 report types available for download (CSV, XLSX, PDF):
| Report | Description |
|---|---|
| Beacon Availability | Uptime/downtime per beacon in the period |
| Antenna Health | Status and availability of antennas |
| Device Activity | Activity log (signals, movements) |
| Restricted Zone Entry | Record of entries into restricted zones |
| Zone Occupancy | Presence metrics per zone |
| Security Incidents | Summary of alerts and resolutions |
Menus added
When enabled, the module adds to the side menu:
- Beacons — Beacon management
- Antennas — Antenna management
- Tracking — Zone view with beacon count
- Site Map — Interactive visualization with floor plan
- Analytics — Dashboards and metrics
Prerequisites
For the module to work correctly on the site:
- Zones configured — At least one zone on the site
- Antennas registered and assigned — Each zone needs at least one antenna
- Beacons registered — Devices registered with the correct driver
- Operational MQTT — Active Mosquitto broker to receive signals from antennas
- Operational InfluxDB — For time-series signal storage
Enablement
The module is enabled per site. To enable it:
- Go to Modules in the administration menu
- Locate "Synapsys"
- Click "Enable" for the desired site
See Modules for detailed instructions.
Calibration
The module includes a complete calibration tool (route /commissioning) with 4 tabs:
- Signal Monitor — Real-time heatmap (RSSI per antenna × beacon)
- Zone Testing — Detailed location analysis per beacon, with confidence score
- Calibration — Adjustment of site parameters and per-antenna offsets
- Verification — Diagnostics of infrastructure, devices, and coverage
Calibration lets you adjust the time window, RSSI thresholds, hysteresis, and individual per-antenna offsets — with immediate effect and real-time validation.
See the Calibration Guide for detailed usage instructions.
Configuration
The module has adjustable settings in config/location.php:
| Parameter | Description |
|---|---|
| Window size | Time window for signal collection (seconds) |
| Thresholds | RSSI thresholds for zone detection |
| Hysteresis | Anti-oscillation parameters between zones |
| Intervals | Location calculation frequency |
To change these parameters in production, consult the system administrator. See Configuration.