LiftAuth Integration High Level Guide
Flow A: Standard Mode (Without Robot Mode)
| Step | Action | Description |
|---|---|---|
| 1 | Robot Arrives at Lift Landing | Robot navigates to the lift landing area and positions itself for entry. |
| 2 | Connect to Cloud WebSocket | Robot/Fleet Manager establishes WebSocket connection to LiftAuth cloud servers using API key. |
| 3 | Retrieve OTP | System retrieves one-time password for secure lift access authorization. |
| 4 | Call Lift | Send CALL_LIFT request to summon lift to current floor. |
| 5 | Lift Arrival Notification | Lift arrives and notifies robot via cloud WebSocket. |
| 6 | Robot Enters Lift | Robot drives into the lift cabin. |
| 7 | Connect to Cabin LAN & WebSocket | Robot establishes local connection to cabin controller via LAN and cabin WebSocket. |
| 8 | Close Door & Call Target Floor | Robot sends SET_DOOR_CLOSE command, then sends CALL_LIFT request with destination floor. |
| 9 | Lift Services Target Floor | Lift travels to destination floor (may stop at intermediate floors for other passengers). |
| 10 | Target Floor Arrival Notification | Lift arrives at destination and notifies robot via cabin WebSocket. |
| 11 | Robot Exits Lift | Robot drives out of the lift cabin and proceeds to its task. |
Flow B: Exclusive Mode (With Robot Mode)
| Step | Action | Description |
|---|---|---|
| 1 | Robot Arrives at Lift Landing | Robot navigates to the lift landing area and positions itself for entry. |
| 2 | Connect to Cloud WebSocket | Robot/Fleet Manager establishes WebSocket connection to LiftAuth cloud servers using API key. |
| 3 | Retrieve OTP | System retrieves one-time password for secure lift access authorization. |
| 4 | Enable Robot Mode | Send ROBOT_MODE_ON request to take exclusive control of lobby operations. |
| 5 | Wait for Robot Mode Activation | System waits for confirmation that robot mode is fully activated before proceeding. |
| 6 | Call Lift | Send CALL_LIFT request to summon lift to current floor. |
| 7 | Lift Arrival Notification | Lift arrives and notifies robot via cloud WebSocket. |
| 8 | Robot Enters Lift | Robot drives into the lift cabin. |
| 9 | Connect to Cabin LAN & WebSocket | Robot establishes local connection to cabin controller via LAN and cabin WebSocket. |
| 10 | Close Door & Call Target Floor | Robot sends SET_DOOR_CLOSE command, then sends CALL_LIFT request with destination floor. |
| 11 | Lift Services Target Floor | Lift travels to destination floor without stopping for other calls due to robot mode. |
| 12 | Target Floor Arrival Notification | Lift arrives at destination and notifies robot via cabin WebSocket. |
| 13 | Robot Exits Lift | Robot drives out of the lift cabin. |
| 14 | Reconnect to Cloud WebSocket | Robot/Fleet Manager reconnects to cloud WebSocket (if disconnected). |
| 15 | Disable Robot Mode | Send ROBOT_MODE_OFF request to release exclusive control and return lobby to normal operations. |
Key Differences
Standard Mode
- Lift sharing enabled: Lift may stop at intermediate floors for other passengers
- No exclusive control: Other building users can summon and use the lift normally
- Best for: Low-traffic periods, non-time-sensitive deliveries, buildings with multiple lifts
Robot Mode
- Exclusive lift control: Lift dedicated to robot operation during active session
- No intermediate stops: Direct travel to destination floor
- Requires activation wait: Must confirm robot mode is fully active before calling lift
- Requires explicit deactivation: Must turn off robot mode after task completion