Skip to main content

Overview

The BLE API enables the robot to communicate with the LOP and COP via BLE requests in order for the robot to take the lift to its desired floor. Currently, the connection timeout duration between the robot and the LOP/COP is set to 90 seconds.

Codes

This section lists all the BLE API codes for the LOP and COP.

LOP

The LOP is responsible for processing the robot's request to call a lift in the direction of its target floor (up or down).

Request Codes

CodePurpose
AUTHAuthenticate the robot with the LOP
DOWNPress the down button to the LOP
UPPress the up button on the LOP
KEEP_ALIVEExtend the connection timeout duration

Response Codes

CodePurpose
AUTH_OKRobot authentication successful.
ERRORAn error has occurred. Please see error message.
INFOInformation about the state of the lift.
ARRIVAL_UPLift travelling up has arrived.
ARRIVAL_DOWNLIft travelling down has arrived

COP

The COP is responsible for processing the robot's request to go to a particular floor as well as opening and closing the door for the robot to exit and enter.

Request Codes

CodePurpose
AUTHAuthenticate the robot with the COP
CLOSE_DOORCloses the lift door
OPEN_DOOROpens the lift door for a pre-determined duration
GOGo to target floor
KEEP_ALIVEExtends the connection timeout duration

Response Codes

CodePurpose
AUTH_OKRobot authentication successful.
ERRORAn error has occurred. Please see error message.
INFOInformation about the state of the lift.
CURRENT_FLOORThe COP will continously inform the robot of the current floor of the lift