Common issues with meeting room displays and their solutions.
Display Not Connecting
| Symptom | Cause | Fix |
|---|
| Stuck on pairing screen | Invalid or expired pairing code | Generate a new pairing code from admin dashboard |
| WebSocket connection failed | Network firewall blocking WebSocket | Allow outbound connections to wss://websocket-service.zenspace.io |
| "Authentication failed" | Expired device JWT | Re-pair the device |
Status Not Updating
| Symptom | Cause | Fix |
|---|
| Room shows "Available" but is booked | WebSocket disconnected | Check network connectivity; display should auto-reconnect |
| Stale schedule | API polling failed | Verify network access to api-zenedge.zenspace.io |
| Status updates delayed | High server load | Check Realtime Service health |
Android-Specific Issues
| Symptom | Cause | Fix |
|---|
| App crashes on startup | Insufficient memory | Use a device with at least 2GB RAM |
| Screen turns off | Power management | Enable "Stay awake" in developer options |
| App not auto-starting | Boot receiver not enabled | Enable auto-start permission for the app |
| Firebase notifications not working | Missing google-services.json | Ensure Firebase configuration is correct |
Network Requirements
Ensure the following endpoints are accessible from the display device:
| Endpoint | Protocol | Port |
|---|
api-zenedge.zenspace.io | HTTPS | 443 |
websocket-service.zenspace.io | WSS | 443 |
firebase.googleapis.com | HTTPS | 443 (Android only) |
Next Steps