Mass currently carried at the tool flange, in kilograms. Used for duty-cycle and derating analysis and as a sanity check on gripper state. Arrives in grams, kilograms and pounds depending on the vendor and the market the controller was configured for.
robot.payloadEach of these is a real tag as the device or controller emits it, taken from the Forge mapping corpus. This is the table that does not exist anywhere else — the reason cross-vendor telemetry is hard is visible in a single column.
| OEM / profile | Raw tag as the device emits it | Confidence |
|---|---|---|
| ABB Robotics | MechUnitLoad | 1.00 |
| Doosan Robotics | payload_kg | 1.00 |
| Epson Robots | payload_kg | 1.00 |
| Fanuc Robotics | payload_kg | 1.00 |
| Franka Emika | payload_kg | 1.00 |
| KUKA | $PAYLOAD.M | 1.00 |
| Kawasaki Robotics | payload_kg | 1.00 |
| Omron Robotics | payload_kg | 1.00 |
| Stäubli | payload_kg | 1.00 |
| Techman Robot | payload_kg | 1.00 |
| Yaskawa Motoman | tool_load | 1.00 |
Every row above is an exact match — a deterministic pack entry or a confirmed corpus mapping — so all of them carry confidence 1.00. That is not a rounding: these are the two exact-match layers, and a tag that resolves here never reaches the embedding or LLM layers. Mappings resolved by the LLM layer do carry sub-1.0 confidence, but those are per-tenant and are not published here.
The canonical field is not just a name. It is a contract about units, sign convention and plausible range, enforced on the way in and re-checked at read time.
| SI / canonical unit | kg |
| Accepted input units | g kg lb oz ton tonne |
| Converted on ingest | g lb oz ton tonne → kg |
| Physics bounds | 0 to 50 kg |
| Measurement type | instantaneous |
| Distinct source tags in the corpus | 7 |
No mapping table to maintain, and no per-vendor branch in your code. The same request shape works for every OEM in the table above.
Transports this field is carried on in the corpus.
OPC UA ROS 2 (DDS) EtherNet/IP Modbus TCPRead alongside this one.
robot.joint.position robot.mode robot.tcp.speed spindle_speed_rpm spindle_load_pct