ZoneX Cloud — Web Dashboard
ZoneX Cloud is the central control point for all your RFID-tracked assets. Access it from any browser, on any device.
- Multi-company, multi-site — each tenant sees only its own data
- Real-time event stream via MQTT — tag reads and alerts in under 1 second
- Role-based access — per-module visibility and page-level permissions
- JWT authentication — browser session, no VPN required
- Timezone-aware display — configurable per deployment (default: Africa/Tunis)
ZoneX Cloud — real-time multi-site RFID visibility
Operations
Live view
Hierarchy View
Interactive D3 tree of zones, asset types, alerts, and RFID doors. Auto-refresh every 5 seconds. Filterable by watch list (focus list). Navigate directly to asset lists or alerts from any node.
Alerts
Alert Engine
Three alert streams — asset alerts, equipment alerts, truck alerts — each with filtering, status tracking, and comments. Configurable rules engine (conditions, attachments, types) drives all alert triggers.
Fleet
Truck & Fleet Tracking
Live truck positions via MQTT, GPS zones, asset classification per vehicle, detailed popup (reader, heartbeat, categories). Trip history with asset manifests per journey.
Overview
Zone Overview
Location-tree navigation across all zones. Grid view per zone with asset summary, search, and detail panel. Periodic polling keeps counts current without a full page reload.
Tracking
Audit & Movement Tracking
Searchable passage audit by door, reader, or focus list. Asset movement timeline. RFID trigger cycle analysis. Watch-list (focus list) stored per browser session for fast repeatable queries.
Analytics
Analytics Dashboard
Product statistics, zone coverage, category distribution, and foreign-object detection (tags detected but not registered to the company). Summary widgets and distribution charts.
Management
Infrastructure
Reader & Infrastructure Management
Full CRUD for readers, antennas, zones, doors. Reader detail: live heartbeat, temperature, CPU/RAM metrics, antenna return-loss curves. Remote commands: start/stop RFID, reboot, antenna power, ping, SMS.
Objects
Asset Registry
Register, edit, and track every tagged asset. Full lifecycle view and movement history per object. Category/type hierarchy. Foreign-element detection for unregistered tags detected in the field.
Inventory
Inventory Management
Schedule inventory campaigns. Run adjustments in three modes: mobile (handheld), desktop (browser), or MQTT (live fixed reader). Reporting module for completed sessions with export.
Team
Users, Roles & Audit Log
User CRUD, role assignment, and per-module page visibility control. Full user action log for compliance and troubleshooting. Company, licence, and licence history management.
POS
RFID Point-of-Sale (Caisse)
Full RFID-driven POS module. Choose reader and antennas, open a session, scan items over MQTT, group by product type and price, process payment, view order history.
Monitoring
Platform Performance & Monitoring
API performance metrics from frontend interceptor and backend. Multi-tenant health dashboard (SAC): per-company health score, risk filters, licence status, dependency graph.
Technical Stack
| Frontend | React, Vite, MUI, Redux, React Router |
| Backend | Django, Django REST Framework, JWT (Djoser + Simple JWT) |
| Real-time | MQTT broker — topics per reader serial and company ID |
| Mapping | Leaflet / Mapbox for GPS zone views and truck tracking |
| Authentication | JWT — browser session, no VPN, multi-company scoping |
| Database | MySQL — fully relational, per-company row-level isolation |
| Hosting | cloud.zonex-rfid.com (VPS, continuous uptime) |
| Timezone | Configurable display timezone (default Africa/Tunis) |
ZoneX Edge — Fixed Reader Software
WatchReader is ZoneX Edge software running on Hopeland HH340 fixed readers. It scans continuously, evaluates tags against cloud-configured rules, triggers physical outputs, and streams telemetry — all without operator interaction, from device power-on.
- Up to 4 independent antenna ports — per-antenna power control (0–33 dBm)
- 2 000 tag reads per cycle with deduplication — unique EPC and TID counts
- Cloud-driven alarm engine — wanted-EPC list refreshed every 10 minutes
- 8 MQTT topics: status, heartbeat, telemetry, alarms, return-loss, grouped alerts
- GPIO outputs: independent warning (GPIO3) and alarm (GPIO4) — 1 to 30 s timers
- Device health telemetry: CPU, RAM, disk, all thermal zones, kernel-panic detection
- Always-on foreground service — survives screen-off, Doze mode, and OS process kill
- Remote configuration via MQTT — no on-site visit needed for parameter changes
Hopeland HH340 portal gate running ZoneX Edge — automated pallet counting
Alarm Engine
Cloud-Driven Alarm Engine
Rules and watched assets are managed on ZoneX Cloud and synchronized to the device automatically. Each tag carries a list of prohibited zones; violation triggers a full lifecycle from NEW through EXPIRED.
| State | Condition | Action |
|---|---|---|
| NEW | EPC detected in prohibited zone for the first time | GPIO trigger + 3 MQTT publishes |
| UPDATE | Same EPC still present | Lightweight MQTT heartbeat |
| DEBOUNCE | EPC reappears within 20 s of clearing | Treated as continuation — count preserved |
| EXPIRED | EPC absent for > 20 s | Alarm cleared — grouped summary updated |
MQTT Telemetry Topics
| Topic | When |
|---|---|
watchreader/status/{serial} | Birth / LWT (retained) |
watchreader/heartbeat/{serial} | Every ~15 s — uptime, company |
watchreader/telemetry/{serial} | Every ~60 s — CPU, RAM, temperature |
watchreader/rl/{serial} | Periodic — antenna return-loss (dB) |
alertbyreader/{serial} | Per alarm event — single-alarm update |
alert/{company_id} | New alarm — full detail (retained) |
alert_grouped/{company_id} | Any alarm change — full active aggregate |
Key Features
Always-On Service
Android foreground service with CPU wake lock, Doze exemption, and BOOT_COMPLETED auto-start. The RFID scan is fully independent of the UI — closing the app has no effect.
Device Health Monitoring
CPU, RAM, disk, and all sysfs thermal zones captured every 60 s. MT6765 kernel-panic sentinel detection publishes a warning before a crash occurs — enabling proactive remote restart.
Antenna Health (Return Loss)
Periodic measurement of antenna return-loss on all active ports. Threshold alert published when a cable or antenna fault is detected — before performance degrades.
Remote Configuration
All parameters — heartbeat interval, drain window, antenna power, GPIO timers, return-loss settings — can be pushed via MQTT command. No physical access required.
GPIO Output Control
GPIO3 (warning) and GPIO4 (alarm) independently configurable: single-pulse, continuous, or pulsed-repeat wiring modes. Timers: 1–30 s each. Fires immediately on new alarm detection.
Mass Deployment
Bash ADB script deploys to all devices in parallel via SSH reverse tunnels. Uninstalls legacy version, installs APK, grants Doze exemption, launches boot-receiver, reboots. Pass/fail per device.
COMPANION APP
ZoneX Alarm Monitor
Windows workstation application that receives RFID intrusion alerts from ZoneX Cloud via MQTT and immediately notifies on-site security through visual and audible signals. Runs silently in the background; rises to the foreground automatically on each new alert.
- Large alarm counter (0–99+) colour-coded by severity — green / orange / red
- Active zone panel in 72pt font — readable from across the security room
- Arduino Nano + 8×8 LED matrix + buzzer — auto-detected USB serial, no manual config
- Smart buzzer: triggers only on new violations, silent on decreasing counts
- One-click built-in test alarm — exercises full pipeline without a real RFID event
- Windows startup integration — clean background launch with no console window
- Rotating file log: 5 × 5 MB audit trail — MQTT events, alarms, user actions
STATUS INDICATORS
| Transport | MQTT / TCP port 1883, QoS 1 |
| Hardware | Arduino Nano + MAX7219 8×8 LED matrix, 9600 baud |
| OS | Windows 10 / 11 (64-bit), no admin rights required |
| Multi-tenancy | Per-company topic scoping — no cross-tenant visibility |
Technical Specifications — WatchReader
| Platform | Android 8.0+ (minSdk 26), targetSdk 34 |
| Hardware | Hopeland HH340 (MT6765 SoC) |
| RFID standard | UHF EPC Gen2 (ISO 18000-6C) |
| Antenna ports | Up to 4 simultaneous |
| Reader interface | Hopeland SDK — TCP 127.0.0.1:9090, 20 s hang timeout |
| Alarm refresh | Every 10 minutes from ZoneX Cloud API |
| Heartbeat | Every ~15 seconds |
| Telemetry | Every ~60 seconds |
ZoneX Mobile — Android App
ZoneX Mobile runs on the Chainway C5 UHF RFID handheld. It covers the full field-operations lifecycle: enrolment, inventory, transfer, repair, and asset search — with full offline support and cloud sync on reconnect.
- Simultaneous EPC + TID reading — ISO 18000-6C / EPC Gen2
- Physical hardware trigger (keyCode 293) — no on-screen tap needed
- Offline SQLite cache — full inventory without active connection
- REST API with JWT auth — sync to ZoneX Cloud on reconnect
- Per-module antenna power, RSSI threshold, and read-count filters
- Anti-theft integration — fixed reader exits trigger GPIO + MQTT + cloud log
ZoneX Mobile on Chainway C5 — linen inventory in hotel storage room
Application Modules
Reception
- Enrol new items in a single scan session
- 1 to 4 TIDs per item (Single / Double / Triple / Quadruple mode)
- Auto-detection of already-registered items (colour-flagged)
- Batch upload to cloud — 20 items per batch
- Real-time counter: new / valid / total scanned
Inventory
- Zone-by-zone count: building → floor → room breadcrumb navigation
- Real-time comparison against the cloud reference plan
- Tag classification: present / unexpected / missing
- Category breakdown (sheets, towels, pillowcases, etc.)
- Offline local cache — full cycle without a connection
Transfer
- Track linen going out to and returning from washing company
- Zone validation per item: In Place / Wrong Zone / Unknown
- Movement recorded in ZoneX Cloud (MoveElements API)
- Real-time duplicate filtering — each EPC counted once per session
Repair
- TID-based identification — works even if the EPC is damaged
- Matches scanned TIDs against the server defect database
- Staff confirm each item individually before committing the record
Search & Locate
- Locate any tagged item anywhere in the building
- Real-time RSSI proximity radar: red (far) → orange → yellow → green (close)
- Directional beep — interval shortens as you approach (4 speed levels)
- Target selected from the live scan list
Configuration
- Per-module antenna power (0–100% / 5–1300 cm / 1–33 dBm)
- Per-module RSSI threshold filter (reject weak reads)
- Per-module minimum read-count filter (reject fleeting reads)
- 5 selectable scan beep tones with instant preview
- Inventory clear PIN (4–16 digits)
Compatible Hardware
| Device | Chainway C5 — Android 11+, UHF Gen 2, IP65, 8 h+ battery |
| RFID | Simultaneous EPC + TID — ISO 18000-6C / EPC Gen2 |
| Trigger | Physical hardware button (keyCode 293) — no on-screen tap needed |
| Cloud | REST API + JWT auth — zonex-rfid.com (Django + MySQL + MQTT) |
| Offline | Local SQLite cache — reads queue and sync on reconnect |
Anti-Theft Integration
Fixed Readers at Exits
- UHF fixed readers at hotel exits scan continuously
- Items in prohibited zones trigger GPIO output → physical alarm (light / siren)
- MQTT alert → ZoneX Alarm Monitor (Windows) for on-site security station
- Persistent cloud log entry — full audit trail per event