Devices
Register, configure, and monitor campus RFID/NFC hardware scanner kiosks, turnstiles, and desktop readers.
📸 [Image Placeholder: Devices Changelist View]
Overview & Description​
The Devices module manages the physical scanning hardware deployed across campus (including ESP32 microcontrollers, Raspberry Pi nodes, gate turnstiles, and Windows desktop readers). It links each device to an Area, tracks online status, and handles API authentication.
Navigation Steps​
Navigate to Admin Sidebar > Devices > Devices.
Fields & Device Attributes​
| Field Name | Description |
|---|---|
| Device ID | Unique hardware identifier or serial code configured on the device (e.g., GATE-01, LIB-DESK-02). |
| Area | The physical campus venue or gate where this hardware unit is stationed. |
| Description | Optional hardware model details or mounting location notes. |
| Last Seen | Live timestamp indicating the most recent heartbeat or card scan received from the device. |
| Status | Real-time health indicator (Online, Stale, or Offline). |
Operations​
How to Register a New Scanner Device​
- Click the
+button on the Devices page. - Enter the unique Device ID configured in your scanner's firmware.
- Assign the device to a campus Area.
- Click Save.
How to Update or Reassign a Device​
- Click the Device ID in the table.
- Re-assign location or update device descriptions.
- Click Save.
Operations such as viewing, registering, modifying, or deleting scanner devices may be subject to user or group permission restrictions. Access to permissions can be coordinated with your administrators if needed.
Frequently Asked Questions (FAQ)​
Q: Who would likely have Adding, Editing, or Deleting access to this feature?
A: [Placeholder: Add role-specific guidance based on your institution's access policies. Access to hardware scanner device configuration is determined by assigned user or group permissions. Coordinate with your administrators for specific access requirements.]
Q: How does the system calculate whether a device is Online, Stale, or Offline?
A: In the system, device status is determined by the timestamp of its latest received log or heartbeat:
- Online: Heartbeat received within the last 90 seconds.
- Stale: Heartbeat received between 90 and 180 seconds ago.
- Offline: No heartbeat received for more than 180 seconds (or no logs recorded).
Q: How do we troubleshoot an offline scanner?
A: Check the physical scanner's power and network connectivity. You can review connection events and error logs under Devices > Device Logs.