Esacode

Docs / Blocks / Devices

xArm

Drives a UFactory xArm from the worker it is connected to: status, home, moves, drawing with a pen, and live commands.

Runs on a worker (Python) Devices Version 1.1 Code you can open and adapt

How it works

The worker must reach the arm's control box on the network (its IP address). Start with Dry run on: nothing moves, the block streams the poses it would go through (connect its live telemetry to a Chart, Gauges or the Live panel). Every target is checked against the safe box below and speeds are capped.

Draw: strokes on a board (mm from its lower-left corner, x to the right, y away from the arm) placed at Board X/Y and turned by Board rotation; the pen goes down to Draw height and up to Travel height. Without a Path input, it draws the chosen figure (a tic-tac-toe grid, an X or an O in a cell).

Live commands: messages on the channel below, from a Controls view: home, stop, grid, x 5, o 5, move 300,0,150, jog z-5, pen up. Keep the emergency stop within reach.

Inputs

InputTakesWhat it is
Path
path
Files
json, csv
Optional: poses to move through ([[x,y,z],…] in mm) or strokes to draw ({"strokes": [[[x,y],…],…]} in board mm) Optional.

Outputs

OutputGivesWhat it is
Poses
log
Table
csv
poses.csv: every pose sent or simulated
Live telemetry
telemetry
Live telemetryWhat the block sends while it runs, for views such as Chart or 3D view.

Settings

SettingDefaultWhat it does
Arm IP address
ip
192.168.1.200
Action
action
status
One of: status, home, move, draw, touch corners, live commands
Dry run (nothing moves)
dry_run
on
Figure to draw (without a Path)
figure
tic-tac-toe grid
One of: tic-tac-toe grid, X, O, square
Cell (1-9, for X and O)
cell
5
From 1 to 9
Board X (mm)
board_x
390
Board Y (mm)
board_y
-70
Board rotation (degrees)
board_rotation
90 90: the top of the sheet towards the arm, the way the visitor sitting opposite reads it
Board size (mm)
board_size
140
From 30 to 160
Draw height (mm)
z_draw
100
Travel height (mm)
z_up
130
Tool roll (degrees)
roll
180
Tool pitch (degrees)
pitch
0
Tool yaw (degrees)
yaw
0
Speed (mm/s)
speed
80 At most 150 mm/s; the arm's controller is told the limit too
From 1 to 150
Acceleration (mm/s²)
accel
400
From 10 to 800
Safe box (mm)
safe_box
100,600, -350,350, 20,450 x min, x max, y min, y max, z min, z max: no target outside is sent
Channel for live commands
channel
xarm
Live commands for at most (seconds)
seconds
600
From 10 to 86400

Where it runs

On one of your computers with the EsaSim worker: Any worker. The worker installs the Python packages it needs when they are missing: xarm-python-sdk.

In its code, settings are ctx.params["key"], inputs ctx.inputs["id"] and outputs ctx.output("id", "name.ext"); see Custom blocks.

More in Devices