Errors
SkillError and its kinds: what each one means and what to change in the skill or the world.
The motion, gripper and world functions of the skill API report failure by raising, never by returning a flag. The errors they raise for a skill-level problem are SkillError subclasses (SkillError is a RuntimeError). A SkillError message names the call, the target and the reason, and usually includes a hint: line saying what to change.
Let these errors propagate: an uncaught error fails the step with that message. Catch one only to do something specific, and re-raise what you do not handle.
The run's error ends with where it was raised: the skill, the workflow step (on a workflow run) and the line of the skill's own code, for example Unreachable: ... [skill move_plate, node transfer, robotic_code.py:57]. zeon run, zeon wait and zeon logs print it, and the app shows it on the failed step.
try:
move_arm(ARM, target)
except Unreachable:
move_arm(ARM, fallback_target)| Attribute | Value |
|---|---|
hint | What to change, in one line. |
details | Every problem found, one line each. |
cause | The underlying error, for motion errors. |
Motion
The motion errors below, except MotionUnavailable, are subclasses of MotionFailed. When a move is refused, nothing has moved.
| Error | Meaning | What to change |
|---|---|---|
Unreachable | No arm configuration reaches the target. | Move the object in the world, loosen the tolerance, or approach from elsewhere. |
WouldCollide | The move would bring the arm, gripper or held object too near something. | If the contact is intended, declare it with contact(). Otherwise change the target or the approach. |
JointLimit | The goal needs a joint beyond its limit. | Approach from another direction, or turn the wrist the other way first with a joint move. |
StraightLineImpossible | The straight line from where the tool is cannot be followed. | Start the straight move from elsewhere, or drop straight_line. |
NoRoute | No collision-free path to the goal was found. | Add a via pose or a joint move on the way. |
ConstraintViolated | A constraint such as keep_upright does not hold at the start or cannot be kept. | Loosen it or start elsewhere. |
MotionStalled | The arm stopped short of the goal and was held there. | Something is in the way, or the goal moved. |
MotionAborted | The move was stopped (a Stop, a change to the world, a fault) and the arm brought to rest. | Find out what stopped it before running again. |
MotionUnavailable | The arm cannot be moved on this set right now. | Check the arm and the run mode. |
Objects and holding
| Error | Meaning |
|---|---|
ObjectNotFound | No object with that id or display name; the message lists the closest ids. |
AmbiguousObject | Several objects share that display name; pass the instance id. |
AnchorNotFound | The object has no anchor of that name; the message lists its anchors. |
NotHolding | release with nothing held. |
HeldByOtherArm | attach on an object the other arm holds. |
HeldByArm | The object is held, so it cannot be placed, seated or removed; release it first. |
HolderHasOccupants | Removing an object other objects sit on. |
Arms and calls
| Error | Meaning |
|---|---|
ArmNotInSetup | The setup has no arm of that name. |
ArmNotInLeg | Inside run_parallel, a leg named the other arm. |
DualArmRequired | run_parallel with two legs on a one-arm setup. |
TcpSpeedOnFreeMove | tcp_speed on a free move; use speed, or straight_line=True. |
StaleArmState | On a real rig, the arm stopped reporting its joints. Check the arm and its connection. |
Arguments that are wrong in kind raise ordinary Python errors: ValueError for a speed outside (0, 1], an unknown contact part or a joint move not given six values; TypeError for a joint move given a name instead of values.
The camera functions, api_request and localize_object_tags are the exception: they never raise on a failure and return None or a result with success: False instead. Check their result.
After a failure
A skill that fails halfway can leave an arm holding or touching something in the world model. Later moves can then be refused until that is resolved. A world reload puts the objects back but does not move the arms. In the simulator, first run zeon reset-arms, or click Reset in the Skills Editor or the Workflow Editor: it puts both simulated arms back at their start position and lets go of anything they hold. Then reload the world (zeon run <workflow> --world <world> reloads it before the run). Do not retry an unchanged move after a refusal: read the reason and change the target, the approach, the contact or the placement.
A cancelled run raises ExecutionCancelledInSkillError from the next pause point. It is not a SkillError; let it propagate. See Pausing and operator prompts.
Updated 1 day ago