Device Management

ZenEdge manages IoT device adapters through their full lifecycle: registration, capability discovery, health monitoring, and decommissioning.

Adding an Adapter

1. Navigate to the physical space's Adapters tab
2. Click Add Adapter
3. Enter the Adapter Endpoint URL (includes ?device_id=...)
4. Enter the API Key for the adapter
5. Click Preview Capabilities — ZenEdge queries the adapter's /capabilities endpoint
6. Review the summary: device type, criticality, protocol version, supported actions
7. Click Confirm & Onboard

Adapter Properties

Property	Description
Device Type	lock, wifi, fan, light, display, camera, sensor
Criticality	CRITICAL, STANDARD, OPTIONAL
Protocol Version	Adapter contract version
Webhook Capable	Whether the device pushes live events
HTML Embed	Whether guests see a live control tile
Actions	Supported actions (unlock, status, generate_voucher, etc.)

Health Monitoring

ZenEdge continuously monitors device health:

• Periodic ping — Calls /ping at configurable intervals
• Health status — Active (green), Disabled (grey), Error (red)
• Failure tracking — Records consecutive failures and last successful ping
• Alerts — Escalated based on criticality tier

Guest Visibility

Each adapter has a visibility toggle:

• On — Device tile appears on the guest's magic-link page
• Off — Device still works and is monitored, but hidden from guests

Adapter Actions

From the admin dashboard, operators can:

• Test adapter — Manually trigger a /ping or /status call
• Disable/Enable — Take a device offline without removing it
• Edit — Update endpoint URL or API key
• Remove — Decommission the adapter

Next Steps

• Magic Links — How guests access devices
• Adapter Protocol — The technical specification