Skip to main content

Sensor Integration

Ward integrates with BLE wristbands for proximity verification, elopement detection, and real-time patient list ordering.

Sensor Types

Sensor Hub

The sensor hub is an on-premise gateway running a headless daemon that:

  • Processes wristband data for proximity and elopement alerts
  • Monitors wristband health (battery, connectivity)
  • Reports fleet telemetry (CPU, memory, disk, BLE radio status) to Ward's cloud
  • Auto-updates with signature verification and automatic rollback
  • Communicates securely with Ward's cloud over HTTPS

Each unit needs at least one hub.

Patient Wristbands

BLE wristbands worn by patients:

  • Enable proximity verification for observations
  • Enable elopement detection via fixed BLE receivers
  • Provide real-time distance for patient list ordering

Assign one wristband per patient.

Fixed BLE Receivers

BLE gateways that detect wristband signals and forward to the hub via HTTP:

  • Exit receivers (base deployment) — placed at unit exits, stairwells, and facility exits for elopement detection
  • Room doorway receivers (optional) — placed at patient room doorways to enable room-level geofencing and presence confirmation

Hardware Setup

Installing the Hub

  1. Connect hub to facility network (ethernet recommended, WiFi supported)
  2. Power on the hub
  3. Wait for the hub to boot (~60 seconds) — the status LED turns red (unprovisioned)
  4. The hub advertises itself on the local network

Registering the Hub

  1. Open the Ward app on a device connected to the same network as the hub
  2. Navigate to ManagementDevicesAdd Hub
  3. The app discovers unprovisioned hubs on the local network
  4. Tap the discovered hub and select a unit assignment
  5. The app registers the hub and configures it automatically
  6. Hub confirms connection — status LED turns green

Adding Wristbands

  1. In ManagementDevices, tap Add Wristband
  2. On mobile, nearby unregistered wristbands are detected automatically and listed by signal strength — tap one to select it
  3. Or enter the MAC address manually
  4. Optionally assign to a patient immediately

Wristbands can also be assigned to patients later from the patient detail screen.

Adding BLE Receivers

  1. Mount the receiver at the boundary point (unit exit, stairwell, facility exit, or room doorway)
  2. Power and network connect the receiver
  3. In ManagementDevices, add the receiver
  4. Set boundary type (unit exit, stairwell, facility exit, or room doorway)
  5. If room doorway: select the room this receiver monitors
  6. Associate with the hub

Proximity Verification

With a wristband assigned to a patient, the staff phone:

  1. Scans for nearby BLE wristbands
  2. Calculates distance from signal strength
  3. Auto-verifies proximity when within configured threshold
  4. Records distance with the observation

Staff see "Proximity Verified" with distance when documenting if the wristband is detected.

Patient List Ordering

The patient list sorts by proximity — nearest patients appear first. This updates in real-time as staff move through the facility. Patients without wristbands appear below detected patients.

On wider screens (landscape tablets and desktop), the patient list is always visible as a sidebar alongside every screen, so proximity-sorted patients are accessible from the dashboard, alerts, shift view, or any other screen.

Elopement Detection

For patients with elopement risk and a configured geofence:

  1. Assign a wristband to the patient
  2. Configure geofence level (unit, floor, or campus — room level available when room doorway receivers are installed)
  3. Fixed BLE receivers detect the wristband at boundaries
  4. Hub evaluates whether detection constitutes a violation
  5. Alert triggers after confirmation

Wristband Health

The hub continuously monitors all registered wristbands:

  • Battery: Warning at 20%, critical at 10%
  • Connectivity: Alert if not seen for >1 hour

Health indicators appear on patient cards and in the device management screen.

Device Management

Device Management

Viewing Device Status

Navigate to ManagementDevices to see:

  • All registered devices (hubs, wristbands, receivers)
  • Online/offline status
  • Battery level (wristbands)
  • Last seen timestamp
  • Hub software version and health metrics

Hub Fleet Management

The device management screen provides fleet-level visibility for hubs:

  • Status: Online/offline, software version, uptime
  • Health: CPU, memory, disk usage, CPU temperature, BLE radio status
  • Updates: Current version vs. latest available, version pinning per hub

Hubs auto-update and roll back automatically if an update fails.

Device Health Alerts

Ward alerts when devices have issues:

  • Wristband battery low or critical
  • Wristband or hub offline
  • Hub degraded (high CPU, low disk, outdated version)

Hub Status LED

The hub has an LED that indicates its current state:

PatternMeaning
Solid greenConnected to Ward's cloud
Solid redUnprovisioned — needs to be registered
Alternating green/red blinkProvisioned but can't reach cloud
Red blinkError

Troubleshooting

Hub offline:

  • Check the status LED (see table above)
  • Check power connection
  • Verify network connectivity
  • If on the same network, use Local Diagnostics:
    • Open the hub's detail screen in ManagementDevices
    • Enter the hub's hostname (e.g. ward-hub-1.local) or IP address
    • View real-time CPU, memory, BLE radio status, uptime, and wristband count
  • Restart the hub if needed

Hub not updating:

  • Verify hub can reach Ward's CDN (outbound HTTPS)
  • Check the hub's current version in device management
  • Trigger a manual update or unpin the version from device management

Wristband not detecting:

  • Check battery level
  • Verify wristband is assigned to patient
  • Ensure staff phone has Bluetooth enabled

Proximity not verifying:

  • Confirm patient has a wristband assigned
  • Check that staff phone BLE scanning is active
  • Move closer to patient — RSSI accuracy improves at shorter range

Enterprise RTLS Integration

For facilities with existing Real-Time Location Systems, Ward can integrate with your current infrastructure through custom integration projects.

Contact your Ward representative to discuss RTLS integration requirements.