Get Robot Status
SUMMARY
Get Robot Status returns the robot status as a brand-specific bitmask or integer code.
On Universal Robots, this corresponds to the RTDE robot_status_bits field encoding power, program, and safety states.
SUPPORTED ROBOTS
This skill is currently supported on Universal Robots only. Calling this method on other robot brands will raise a NotImplementedError.
The Skill
python
status = robot.get_robot_status()The Code
Example: Read and Log Robot Status
Connect to the robot and read its current status bitmask.
python
from loguru import logger
from telekinesis.synapse.robots.manipulators import universal_robots
robot_ip = "192.168.1.2" # replace with your robot's IP
robot = universal_robots.UniversalRobotsUR10E()
# Connect
robot.connect(ip=robot_ip)
status = robot.get_robot_status()
logger.success(f"Robot status: {status}")
# Disconnect
robot.disconnect()The Explanation of the Code
get_robot_status reads the robot_status_bits field from the RTDE data stream. Each bit encodes a distinct status flag — power state, program state, teach-pendant state, and more. Consult the UR RTDE Interface documentation for the full bit layout.
How to Tune the Parameters
This skill takes no input parameters.
Return Value
| Type | Description |
|---|---|
str | Robot status as a brand-specific bitmask or integer code. |
Where to Use the Skill
- Health monitoring — Poll the status bitmask to detect power or program state changes
- Diagnostics — Log the raw status field alongside other telemetry for post-hoc analysis
When Not to Use the Skill
Do not use Get Robot Status when:
- You need only the operating mode — use Get Robot Mode for a single integer code
- You need the safety state — use Get Safety Mode instead