Python toolchain and compiler for the SCARA Robotics
Version: 1.1.1
Target: Industrial SCARA Robotic Manipulators
Toolchain: scaralang (scarac compiler, decompiler & binary protocol engine)
Author: Vladimir Roncevic
License: GPL-3.0 / Apache-2.0
MOVE_J — Rapid Joint Point-to-Point MotionMOVE_L — Linear Cartesian Interpolated MotionMOVE_REL — Relative Cartesian Incremental MotionARC_CW — Clockwise Circular Arc InterpolationARC_CCW — Counter-Clockwise Circular Arc InterpolationAPPROACH — Relative Vertical DescentRETRACT — Relative Vertical AscentJOG_AXIS — Manual Incremental Cartesian JogJOG_JOINT — Manual Incremental Joint JogPROBE — Tactile Surface SearchJUMP — 3D Parabolic Arch Pick & PlacePALLET_DEF — Matrix Pallet Grid DefinitionMOVE_PALLET — Pallet Index PositioningDEF / END — User-Defined Subroutine RoutineCALL — Subroutine InvocationREPEAT / END — Fixed-Count Iteration LoopZONE_DEF — User-Defined Spatial Keep-Out ZonePUMP — Vacuum Generator ActuationVALVE — Vacuum Blow-Off Release ValveTOOL — Vertical Slide Stage ActuationTOOL_ORIENT — End-Effector Orientation ModeCONFIG ELBOW — Kinematic Arm Solution BranchCONFIG MOTOR — Stepper Drive Feedback ModeFRAME_SET / FRAME — Work Coordinate System (WCS)FRAME_RESET — Reset Coordinate System to World BaseHOME — Multi-Axis Calibration & Homing RoutineThe SCARA Domain-Specific Language (DSL) is a high-level, human-readable robotic programming language designed specifically for Selective Compliance Assembly Robot Arm (SCARA) 4-axis manipulators ($X, Y, Z, \Phi$).
Unlike generic CNC G-code, SCARA DSL is natively aware of:
JUMP arches, pallet matrix generation, rapid approach/retract moves).0xAA 0x55 wire protocol).A .scara program consists of sequence lines. Each line contains at most one statement. A statement starts with a command keyword, followed by optional or required parameters:
MOVE_L X 150.0 Y 45.0 Z 20.0
PUMP ON
WAIT 150
All command keywords and parameter identifiers are case-insensitive:
MOVE_L X 100.0 Y 50.0 Z 10.0
move_l x 100.0 y 50.0 z 10.0
Move_L X 100.0 Y 50.0 Z 10.0
All three variants produce identical AST nodes and binary instructions.
Parameters may be passed either using whitespace separation (KEY VALUE) or explicit assignment (KEY=VALUE):
# Whitespace style
MOVE_L X 150.0 Y 75.0 Z 20.0 P 45.0
# Assignment style
MOVE_L X=150.0 Y=75.0 Z=20.0 P=45.0
# Mixed style (fully supported)
JUMP X 150.0 Y=75.0 Z 20.0 ARCH=35.0
# or ; and extend to the end of the line:
# This is a comment
SPEED WORK 80.0 ; Set working feedrate to 80 mm/s
| Dimension | Axis | Unit | Description |
|---|---|---|---|
| Linear Coordinates | X, Y, Z |
Millimeters (mm) |
Absolute or frame-relative Cartesian position. |
| Tool Orientation | P / PHI |
Degrees (°) |
4th-axis end-effector yaw rotation ($\pm 180^\circ$). |
| Arc Center Offsets | I, J |
Millimeters (mm) |
Incremental vector offset from starting point to arc center. |
| Feedrate | SPEED |
mm/s |
Tool center point (TCP) linear speed. |
| Acceleration | ACCEL |
mm/s² |
Linear path acceleration and deceleration. |
| Time Delay | WAIT / WAIT_MS |
Milliseconds (ms) |
Hardware execution dwell. |
| Joint Angles | deg |
Degrees (°) |
Joint 1, Joint 2 arm angles, Joint 4 yaw. |
MOVE_JRapid Joint Point-to-Point Motion
Moves the robot arm to the target Cartesian coordinates using non-interpolated joint motion. Both arm joints articulate simultaneously at maximum speed without enforcing a straight-line Cartesian path. Best used for clearance travel and rapid repositioning.
MOVE_J X <x> Y <y> Z <z> [P <phi>]X: float (mm) — Target X coordinate.Y: float (mm) — Target Y coordinate.Z: float (mm) — Target Z coordinate.P / PHI: float (deg, optional) — Target tool orientation angle.MOVE_J X 150.0 Y -50.0 Z 40.0 P 0.0
MOVE_LLinear Cartesian Interpolated Motion
Executes a linear, straight-line trajectory from the current position to the destination coordinates at the currently active working feedrate (SPEED WORK).
MOVE_L X <x> Y <y> Z <z> [P <phi>]X: float (mm) — Target X coordinate.Y: float (mm) — Target Y coordinate.Z: float (mm) — Target Z coordinate.P / PHI: float (deg, optional) — Target tool orientation angle.MOVE_L X 180.0 Y 60.0 Z 15.0 P 90.0
MOVE_RELRelative Cartesian Incremental Motion
Executes an incremental straight-line Cartesian motion relative to the current tool pose. Incremental offsets ($\Delta X, \Delta Y, \Delta Z, \Delta \Phi$) are applied in the currently active coordinate work frame.
MOVE_REL [X <dx>] [Y <dy>] [Z <dz>] [P <dphi>] [SPEED <spd>]X: float (mm, optional) — Relative displacement along X axis (default 0.0).Y: float (mm, optional) — Relative displacement along Y axis (default 0.0).Z: float (mm, optional) — Relative displacement along Z axis (default 0.0).P / PHI: float (deg, optional) — Relative rotation angle about tool axis (default 0.0).SPEED: float (mm/s, optional) — Target path velocity.# Shift 20mm in X, 10mm in Y, and descend 5mm
MOVE_REL X=20.0 Y=10.0 Z=-5.0 SPEED=40.0
ARC_CWClockwise Circular Arc Interpolation
Interpolates a circular arc in the XY plane in a clockwise direction. The arc begins at the current robot position and terminates at (X, Y). The circle center is defined relative to the starting position via I (X offset) and J (Y offset).
ARC_CW X <x> Y <y> I <i> J <j> [Z <z>] [P <p>]X, Y: float (mm) — Arc endpoint coordinates.I: float (mm) — Incremental X distance from start position to circle center.J: float (mm) — Incremental Y distance from start position to circle center.Z: float (mm, optional) — Helical motion target Z coordinate.P: float (deg, optional) — Final tool orientation.# Semi-circle of radius 25mm clockwise
ARC_CW X 150.0 Y 50.0 I 0.0 J 25.0
ARC_CCWCounter-Clockwise Circular Arc Interpolation
Interpolates a circular arc in the XY plane in a counter-clockwise direction from the current position to (X, Y) around the center offset (I, J).
ARC_CCW X <x> Y <y> I <i> J <j> [Z <z>] [P <p>]X, Y: float (mm) — Arc endpoint coordinates.I, J: float (mm) — Arc center vector offsets.Z: float (mm, optional) — Optional helical vertical coordinate.ARC_CCW X 100.0 Y 80.0 I -20.0 J 0.0
APPROACHRelative Vertical Descent
Performs a relative vertical descent along the negative Z axis from the current position by the specified clearance distance. Used to move down safely from clearance plane to pickup or placement plane.
APPROACH DIST <d>DIST: float (mm, > 0) — Vertical descent distance.APPROACH DIST 35.0
RETRACTRelative Vertical Ascent
Performs a relative vertical ascent along the positive Z axis from the current position by the specified clearance distance. Used to lift the tool up safely away from workpiece and fixtures before horizontal moves.
RETRACT DIST <d>DIST: float (mm, > 0) — Vertical ascent distance.RETRACT DIST 35.0
JOG_AXISManual Incremental Cartesian Jog
Commands a single-axis relative jog displacement along a chosen Cartesian degree of freedom. Used primarily in manual setup, calibration, and REPL control.
JOG_AXIS <X|Y|Z|PHI> <step>X, Y, Z, or PHI.step: float — Distance in mm (or degrees for PHI) to step.JOG_AXIS X 5.0
JOG_AXIS Z -1.0
JOG_AXIS PHI 15.0
JOG_JOINTManual Incremental Joint Jog
Rotates an individual robotic actuator joint by a relative angle.
JOG_JOINT <joint_id> <deg>joint_id: int (1 to 4) — Joint 1 (Base shoulder), Joint 2 (Elbow), Joint 3 (Z axis), Joint 4 (Wrist yaw).deg: float — Relative rotation in degrees (or mm for linear Z joint 3).JOG_JOINT 1 10.0
JOG_JOINT 2 -5.5
PROBETactile Surface Search
Drives the Z-axis downwards at a controlled speed until a tactile touch probe or microswitch sensor triggers. Upon contact, the current coordinate is registered, motion halts cleanly, and subsequent commands proceed from the probed plane.
PROBE [SPEED <s>] [DIST <d>]SPEED: float (mm/s, optional) — Search velocity (default: 10 mm/s).DIST: float (mm, optional) — Maximum search travel distance.PROBE SPEED 5.0 DIST 40.0
JUMP3D Parabolic Arch Pick & Place
The quintessential robotic pick-and-place command. Expands into a smooth, time-optimal 3D motion consisting of:
ARCH.(X, Y, Z).Eliminates discrete corner stops and optimizes cycle times.
JUMP X <x> Y <y> Z <z> [ARCH <h> | ARCH_HEIGHT <h>]X, Y, Z: float (mm) — Destination coordinates.ARCH / ARCH_HEIGHT: float (mm, optional) — Height of arch apex above the higher of source or target Z (default: 25.0 mm).JUMP X 220.0 Y 45.0 Z 10.0 ARCH 35.0
PALLET_DEFMatrix Pallet Grid Definition
Defines a structured 2D Cartesian pallet matrix of components or trays. Establishes the grid layout with row count, column count, and pitch offsets between cells.
PALLET_DEF <name> ROWS <r> COLS <c> DX <dx> DY <dy> [Z <z>] [P <p>]name: string — Unique identifier for the pallet grid.ROWS: int — Number of rows in the pallet grid.COLS: int — Number of columns in the pallet grid.DX: float (mm) — Pitch spacing between adjacent columns along X.DY: float (mm) — Pitch spacing between adjacent rows along Y.Z: float (mm, optional) — Default pallet working plane height.P: float (deg, optional) — Default component orientation.PALLET_DEF TRAY1 ROWS 4 COLS 6 DX 20.0 DY 25.0 Z 12.0
MOVE_PALLETPallet Index Positioning
Moves the robot to the specified 1-indexed cell within a previously defined pallet matrix. Automatically computes the Cartesian coordinates based on row and column index.
MOVE_PALLET <name> INDEX <i>name: string — Name of previously defined pallet.INDEX: int (1 to ROWSCOLS)* — 1-based sequential slot index.MOVE_PALLET TRAY1 INDEX 7
APPROACH DIST 15.0
PUMP ON
DEF / ENDUser-Defined Subroutine Definition
Declares a reusable, parameterized routine block consisting of high-level SCARA instructions. The routine is registered into the AST symbol table and expanded inline upon invocation with nested block support.
DEF <name>
<instructions>
END
name: string — Unique identifier for the subroutine.DEF PICK_PART
APPROACH DIST 25.0
PUMP ON
WAIT 100
RETRACT DIST 25.0
END
CALLSubroutine Invocation
Invokes a previously declared user subroutine by name. Expands into the defined sequence of instructions during the macro compilation phase.
CALL <name>name: string — Identifier of the defined subroutine to execute.CALL PICK_PART
REPEAT / ENDFixed-Count Iteration Loop
Executes an enclosed block of SCARA instructions for a specified number of repetitions. Loops can be nested and support incremental relative motions, pallet advances, and sensor sampling.
REPEAT COUNT <n>
<instructions>
END
COUNT: int — Number of iterations to execute ($N \ge 1$).REPEAT COUNT 4
MOVE_REL X 10.0 Y 0.0 Z 0.0
TOOL DOWN
WAIT 50
TOOL UP
END
ZONE_DEFUser-Defined Spatial Keep-Out Zone
Declares a geometric forbidden keep-out obstacle zone (rectangular bounding box or 2D circular boundary) in the robot’s Cartesian workspace. During compilation and linting, the static obstacle collision checker verifies all trajectory segments (linear, joint, and circular arcs) against declared zones, reporting OBSTACLE_COLLISION errors before hardware transmission.
ZONE_DEF <id> BOX X_MIN <x1> X_MAX <x2> Y_MIN <y1> Y_MAX <y2>ZONE_DEF <id> CIRCLE CENTER_X <cx> CENTER_Y <cy> RADIUS <r>id: string — Unique identifier for the spatial obstacle zone.BOX: Declares rectangular boundary where $X_{min} < X_{max}$ and $Y_{min} < Y_{max}$.CIRCLE: Declares circular boundary where $R > 0$.ZONE_DEF POST1 BOX X_MIN 120.0 X_MAX 140.0 Y_MIN -20.0 Y_MAX 20.0
ZONE_DEF TOWER CIRCLE CENTER_X 200.0 CENTER_Y 50.0 RADIUS 25.0
PUMPVacuum Generator Actuation
Controls the vacuum suction generator pump for end-effector pneumatic pick-and-place grippers.
PUMP <ON|OFF>ON (energize vacuum generator) or OFF (cut vacuum).PUMP ON is commanded while VALVE ON is active (pneumatic conflict), or if rapid motion occurs without an intervening WAIT to establish vacuum seal.PUMP ON
WAIT 150
VALVEVacuum Blow-Off Release Valve
Actuates the pneumatic release blow-off valve to exhaust vacuum pressure and instantaneously release gripped parts.
VALVE <ON|OFF>ON (open release valve) or OFF (close release valve).PUMP OFF
VALVE ON
WAIT 80
VALVE OFF
TOOLVertical Slide Stage Actuation
Controls a secondary high-speed pneumatic or motorized vertical slide stage mounted on the tool head.
TOOL <UP|DOWN>UP (retract tool head slide) or DOWN (extend tool head slide).TOOL DOWN
PUMP ON
WAIT 100
TOOL UP
TOOL_ORIENTEnd-Effector Orientation Mode
Configures the 4th-axis tool yaw tracking behavior during multi-axis path execution.
TOOL_ORIENT <AUTO|TANGENT|FIXED>AUTO: Automatically computes orientation to match arm configuration.TANGENT: Dynamically rotates the tool center point tangential to the travel path curve (vital for dispensing, cutting, and welding).FIXED: Preserves constant world orientation regardless of arm kinematics.TOOL_ORIENT TANGENT
SPEEDTravel and Working Feedrate Limit
Sets the maximum Cartesian linear velocity for subsequent motion segments. Supports separate definitions for rapid positioning (RAPID) and working contact travel (WORK).
SPEED <RAPID|WORK> <feedrate>RAPID or WORK.feedrate: float (mm/s, > 0) — Linear velocity limit.SPEED RAPID 250.0
SPEED WORK 60.0
ACCELPath Acceleration Limit
Configures the maximum linear path acceleration and deceleration for trajectory planning.
ACCEL <val>val: float (mm/s², > 0) — Acceleration limit.ACCEL 500.0
OVERRIDEDynamic Real-Time Speed Override
Applies a dynamic global percentage scaling factor to all path feedrates without modifying programmed velocity coordinates.
OVERRIDE <percent>percent: int or float (10 to 200) — Speed percentage (100 = 100% nominal speed).OVERRIDE 80
ZONECorner Path Blending & Rounding Mode
Controls corner rounding and trajectory continuous path blending between adjacent motion segments.
ZONE <OFF|FINE|EXACT|Z1..Z50>OFF / FINE / EXACT: Decelerates to an exact full stop at the programmed waypoint before beginning the next segment (zero corner rounding).Z1 to Z50: Blends corners smoothly with a tolerance zone of 1mm to 50mm, preserving continuous velocity and cutting cycle times.ZONE Z5
MOVE_L X 100.0 Y 50.0 Z 20.0
MOVE_L X 150.0 Y 100.0 Z 20.0
ZONE EXACT
CONFIG ELBOWKinematic Arm Solution Branch
Specifies the inverse kinematics arm solution configuration. For any SCARA Cartesian coordinate within the workspace, two valid joint angles exist: Elbow Left or Elbow Right.
CONFIG ELBOW <LEFT|RIGHT>LEFT or RIGHT.CONFIG ELBOW RIGHT
CONFIG MOTORStepper Drive Feedback Mode
Selects the actuation drive mode of the robot joint steppers.
CONFIG MOTOR <OPEN_LOOP|CLOSED_LOOP>OPEN_LOOP (standard microstepping) or CLOSED_LOOP (encoder closed-loop field-oriented control).CONFIG MOTOR CLOSED_LOOP
FRAME_SET / FRAMEWork Coordinate System (WCS)
Defines a local User Coordinate System offset from the robot base. All subsequent motion coordinates are interpreted relative to this frame.
FRAME X <x> Y <y> Z <z> [PHI <p>] or FRAME_SET X <x> Y <y> Z <z> [PHI <p>]X, Y, Z: float (mm) — Origin translation vector from base world origin.PHI: float (deg, optional) — Rotation angle of the work frame around Z.FRAME X 100.0 Y 50.0 Z 0.0 PHI 30.0
FRAME_RESETReset Coordinate System to World Base
Clears all active work coordinate transformations, restoring the global robot base origin as the reference coordinate frame.
FRAME_RESETFRAME_RESET
HOMEMulti-Axis Calibration & Homing Routine
Executes the hardware reference homing sequence for all axes (Joint 1, Joint 2, Z-axis, Tool yaw). Synchronizes stepper motor step counters with optical physical limit switches.
HOMEHOME produces a high-priority warning from MotionCalibrationValidator.HOME
WAIT / WAIT_MSTrajectory Dwell Delay
Pauses program execution for a specified duration in milliseconds. Used to allow pneumatic pressures to equalize, mechanical vibrations to dampen, or peripheral automation to index.
WAIT <ms> or WAIT_MS <ms>ms: int or float (>= 0) — Dwell delay in milliseconds.WAIT 200
SYNCTrajectory Buffer Barrier Flush
Inserts an execution barrier that blocks further command execution until the robot controller’s motion buffer completely drains and all axes come to a complete physical standstill.
SYNCSYNC
HOLDTrajectory Feed Hold (Pause)
Commands a controlled deceleration and immediate suspension of the running trajectory. Motors remain energized and position coordinates are preserved.
HOLDRESUMEResume Paused Trajectory
Resumes motion along a previously paused (HOLD) trajectory from the exact suspended coordinates.
RESUMEESTOPImmediate Emergency Stop
Executes an instantaneous hard stop aborting all motion, clearing command queues, and locking execution until an explicit reset.
ESTOPENABLEEnergize Motor Driver Stages
Powers up and energizes the stepper motor driver stages, applying holding torque to all axes.
ENABLEDISABLEDe-energize Motor Driver Stages
Cuts power to stepper driver motor windings, releasing holding torque. Allows manual positioning by hand.
DISABLEThe scaralang toolchain includes an industrial-grade static analyzer and linter (scarac lint). It inspects AST instructions before compilation and flags semantic issues into three severity categories: ERROR, WARNING, and INFO.
| Rule Identifier | Checker Service | Description | Severity |
|---|---|---|---|
MOTION_UNCALIBRATED |
MotionCalibrationValidator |
Motion instruction (MOVE_J, MOVE_L, etc.) is commanded before HOME homing routine. |
WARNING |
MOTION_DUPLICATE |
MotionDuplicateValidator |
Adjacent move instructions specify identical target coordinates, wasting trajectory planning cycles. | INFO |
MOTION_WORKSPACE_LIMIT |
TrajectoryValidator |
Target coordinate falls outside the physical reach envelope ($R_{min} \le r \le R_{max}$, $Z_{min} \le z \le Z_{max}$). | ERROR |
| Rule Identifier | Checker Service | Description | Severity |
|---|---|---|---|
PNEUMATIC_CONFLICT |
PneumaticConflictValidator |
PUMP ON and VALVE ON are commanded simultaneously, causing hardware pneumatic contention. |
ERROR |
PNEUMATIC_FLYBY |
PneumaticFlybyValidator |
PUMP ON is triggered without a subsequent dwell (WAIT) before initiating rapid motion, risking part drop. |
WARNING |
PNEUMATIC_REDUNDANT |
PneumaticRedundancyValidator |
Consecutive redundant state changes (e.g. PUMP ON followed immediately by PUMP ON). |
INFO |
| Rule Identifier | Checker Service | Description | Severity |
|---|---|---|---|
STATE_HOMING_REDUNDANT |
StateHomingValidator |
Multiple HOME commands placed without physical reason. |
INFO |
STATE_MOTOR_MODE |
MotorModeValidator |
Incompatible motor drive mode or configuration timing. | WARNING |
STATE_ZONE_CONFLICT |
StateZoneValidator |
Zone rounding enabled during precision pick/place or probing sequences. | WARNING |
| Rule Identifier | Checker Service | Description | Severity |
|---|---|---|---|
TIMING_DWELL_EXCESSIVE |
TimingDwellValidator |
Single WAIT command exceeds 60,000 ms (1 minute), likely an error. |
WARNING |
TIMING_BLEND_COLLISION |
TimingBlendZoneValidator |
Corner blend zone radius is larger than the motion segment distance. | ERROR |
| Rule Identifier | Checker Service | Description | Severity |
|---|---|---|---|
OBSTACLE_COLLISION |
ObstacleLintRule |
Trajectory path segment (linear, joint, or arc) intersects user-defined spatial keep-out obstacle zone (ZONE_DEF). |
ERROR |
The examples/ directory at the repository root contains 50 industrial test programs providing reference implementations for all categories of the SCARA DSL specification.
Every example program in examples/ includes 4 artifact files validating round-trip toolchain compilation, binary wire framing, and decompilation:
| File Extension | Artifact Role | Description |
|---|---|---|
.scara |
High-Level Source | Original human-readable SCARA DSL script adhering to the language specification. |
.bin |
Compiled Bytecode | Packed binary execution payload framed with 0xAA 0x55 delimiter, message IDs, payload bytes, and CRC-16-CCITT checksums. |
.dis |
Disassembly Inspection | Frame-by-frame textual disassembly detailing wire sequence numbers, opcode IDs, payload unpacks, and hex bytes. |
_decompiled.scara |
Decompiled Source | Regenerated SCARA DSL script reverse-engineered directly from .bin by scaralang decompile. |
| # | Program Name | Primary Features & DSL Instructions | Source & Artifacts |
|---|---|---|---|
| 01 | Multi-Axis Homing | Multi-axis motor energizing, vertical slide homing, and coordinate origin calibration (ENABLE, HOME) |
01_homing.scara01_homing.bin |
| 02 | Cartesian Linear Motion | Coordinated straight-line Cartesian interpolation with feedrate limits (MOVE_L, SPEED WORK, SPEED RAPID) |
02_linear_motion.scara02_linear_motion.bin |
| 03 | Joint-Interpolated Rapid | Unconstrained multi-joint point-to-point rapid transit between fixtures (MOVE_J) |
03_joint_rapid.scara03_joint_rapid.bin |
| 04 | Circular Arc Interpolation | Planar arc interpolation with relative center offsets (ARC_CW, ARC_CCW, I, J) |
04_circular_arc.scara04_circular_arc.bin |
| 05 | 3D Parabolic Jump Arch | Industrial pick-and-place arch move with parameterized clearance height (JUMP, ARCH) |
05_jump_arch.scara05_jump_arch.bin |
| 06 | Pneumatics & Vacuum Control | Vacuum suction cup engagement, positive blow-off burst, and dwell settling (PUMP, VALVE, WAIT_MS) |
06_pneumatics.scara06_pneumatics.bin |
| 07 | Relative Approach & Retract | Controlled low-speed vertical descent and high-speed vertical ascent (APPROACH, RETRACT) |
07_approach_retract.scara07_approach_retract.bin |
| 08 | Work Coordinate Frames (WCS) | Named local coordinate frames, spatial origin shifts, and base reset (FRAME_DEF, FRAME_SET, FRAME_RESET) |
08_work_frames.scara08_work_frames.bin |
| 09 | Palletizing Matrix Grid | 2D matrix tray definition and zero-indexed cell positioning (PALLET_DEF, MOVE_PALLET) |
09_pallet_matrix.scara09_pallet_matrix.bin |
| 10 | Tangential Tool Orientation | Continuous 4th-axis yaw alignment tangential to trajectory path vector (TOOL_ORIENT TANGENT) |
10_tangent_orientation.scara10_tangent_orientation.bin |
| 11 | Corner Zone Blending | Fly-by corner rounding and exact stop transition blending (ZONE EXACT, ZONE BLEND R=...) |
11_zone_blending.scara11_zone_blending.bin |
| 12 | Industrial Pick & Place | Complete coordinated industrial pick-and-place workcell routine combining all subsystem capabilities | 12_industrial_pick_place.scara12_industrial_pick_place.bin |
| 13 | Elbow Reconfiguration | Dynamic elbow orientation switching (LEFT to RIGHT) with singularity clearance | 13_elbow_reconfiguration.scara13_elbow_reconfiguration.bin |
| 14 | Singularity Avoidance | Multi-tier singularity prevention and near-boundary damping | 14_singularity_avoidance.scara14_singularity_avoidance.bin |
| 15 | Boundary Reach Limits | Cartesian workspace envelop boundary verification and clamping | 15_boundary_reach_limits.scara15_boundary_reach_limits.bin |
| 16 | Multi-Frame Palletizing | Multiple work frame definitions with local pallet grid assembly | 16_multi_frame_palletizing.scara16_multi_frame_palletizing.bin |
| 17 | Bidirectional Assembly | Reconfiguration and bilateral pallet transfer across dual fixtures | 17_bidirectional_elbow_assembly.scara17_bidirectional_elbow_assembly.bin |
| 18 | Tangential Dispensing | Smooth glue bead dispensing with continuous tangential tool orientation | 18_tangential_contour_dispensing.scara18_tangential_contour_dispensing.bin |
| 19 | High-Speed Sorter Jump | Fast parabolic jump gate pick-and-place with velocity tuning | 19_high_speed_sorter_jump.scara19_high_speed_sorter_jump.bin |
| 20 | Annular Inspection Scan | Coordinated multi-point annular circular scan routine | 20_annular_inspection_scan.scara20_annular_inspection_scan.bin |
| 21 | Incremental Relative Motion | Incremental relative Cartesian tool moves with active work frame mapping (MOVE_REL) |
21_relative_motion_incremental.scara21_relative_motion_incremental.bin |
| 22 | Conveyor Tracking Relative | High-speed conveyor synchronized incremental pick-and-place tracking (MOVE_REL) |
22_conveyor_tracking_relative.scara22_conveyor_tracking_relative.bin |
| 23 | Bidirectional Arc Contour | High-speed smooth bidirectional arc transition with dynamic feedrates (ARC_CW, ARC_CCW) |
23_bidirectional_arc_contour.scara23_bidirectional_arc_contour.bin |
| 24 | Matrix Pallet Depalletizing | Automated depalletizing grid extraction with coordinate frame mapping | 24_matrix_pallet_depalletizing.scara24_matrix_pallet_depalletizing.bin |
| 25 | Stepper Motor Calibration | Closed-loop stepper encoder calibration and torque testing (CONFIG MOTOR) |
25_stepper_motor_calibration.scara25_stepper_motor_calibration.bin |
| 26 | Multi-Zone High Speed Blending | Continuous high-velocity trajectory with mixed fine and coarse zone blending (ZONE) |
26_multi_zone_high_speed_blending.scara26_multi_zone_high_speed_blending.bin |
| 27 | Emergency Hold Recovery | In-flight trajectory pause, sensor verification, and motion resumption (HOLD, RESUME) |
27_emergency_hold_recovery.scara27_emergency_hold_recovery.bin |
| 28 | Three-Frame Assembly Station | Multi-station fixture transformations across base, feeder, and nest (FRAME_SET, FRAME_RESET) |
28_three_frame_assembly_station.scara28_three_frame_assembly_station.bin |
| 29 | Precision Dispensing Tangent | Constant-velocity continuous adhesive contouring with tangential tool yaw (TOOL_ORIENT TANGENT) |
29_precision_dispensing_tangent.scara29_precision_dispensing_tangent.bin |
| 30 | Complex Automation Workcell | Fully integrated assembly cell combining pallets, frames, blending, and pneumatics | 30_complex_automation_workcell.scara30_complex_automation_workcell.bin |
| 31 | Subroutine Pick Place | Parametric pick-and-place routines using modular subroutines (DEF, CALL, END) |
31_subroutine_pick_place.scara31_subroutine_pick_place.bin |
| 32 | Repeat Loop Array | Automated repetitive grid testing using fixed-count iteration loops (REPEAT, END) |
32_repeat_loop_array.scara32_repeat_loop_array.bin |
| 33 | Nested Repeat Palletizing | Multi-layer nested iteration loops with relative coordinate indexing | 33_nested_repeat_palletizing.scara33_nested_repeat_palletizing.bin |
| 34 | Subroutine Relative Motion | Subroutine routines integrating relative Cartesian moves and frame offsets | 34_subroutine_with_relative_motion.scara34_subroutine_with_relative_motion.bin |
| 35 | Complex Cycle Subroutines Loops | Full industrial automation routine combining nested loops, subroutines, and error recovery | 35_complex_cycle_subroutines_and_loops.scara35_complex_cycle_subroutines_and_loops.bin |
| 36 | Spatial Keep-Out Zones | User-defined rectangular box and circular obstacle keep-out zones (ZONE_DEF BOX, ZONE_DEF CIRCLE) |
36_spatial_keepout_zones.scara36_spatial_keepout_zones.bin |
| 37 | Multi-Obstacle Dual Elbow | Obstacle avoidance (BOX & CIRCLE) with in-flight dynamic elbow reconfiguration (CONFIG ELBOW) |
37_obstacle_avoidance_dual_elbow.scara37_obstacle_avoidance_dual_elbow.bin |
| 38 | Nested Matrix Frame Sorting | Angled work frame transformations (FRAME_SET), nested iteration loops (REPEAT), and relative moves (MOVE_REL) |
38_nested_matrix_frame_sorting.scara38_nested_matrix_frame_sorting.bin |
| 39 | Closed-Loop Contour Hold Recovery | Bidirectional circular arcs (ARC_CW/CCW), corner blending (ZONE BLEND), and in-flight feed hold/resume (HOLD/RESUME) |
39_closed_loop_contour_hold_recovery.scara39_closed_loop_contour_hold_recovery.bin |
| 40 | Pallet Obstacle Jump Transfer | Dual matrix pallets (PALLET_DEF), 3D parabolic jump arch (JUMP), and keep-out corridor navigation |
40_pallet_obstacle_jump_transfer.scara40_pallet_obstacle_jump_transfer.bin |
| 41 | Dynamic Feedrate & Accel Profiling | Multi-stage dynamic velocity and acceleration scheduling (ACCEL, SPEED WORK, OVERRIDE, ZONE BLEND) |
41_dynamic_feedrate_accel_profiling.scara41_dynamic_feedrate_accel_profiling.bin |
| 42 | Vacuum Decay & Pressure Equalization | High-precision vacuum seal validation, multi-stage pressure equalization micro-dwells (WAIT_MS, PUMP, VALVE, APPROACH) |
42_vacuum_decay_pressure_equalization.scara42_vacuum_decay_pressure_equalization.bin |
| 43 | Concentric Pocket Milling Tangency | Multi-depth concentric pocket profiling with alternating circular arcs, incremental Z depth stepping, and tool tangency (ARC_CW/CCW, TOOL_ORIENT TANGENTIAL) |
43_tangential_pocket_milling.scara43_tangential_pocket_milling.bin |
| 44 | Hierarchical Subroutine Chain | 3-level deep subroutine call stack expansion (Master -> Task -> Atomic) with recursion tracking (DEF, CALL, END) |
44_hierarchical_subroutine_chain.scara44_hierarchical_subroutine_chain.bin |
| 45 | Polar Rotary Inspection Sweep | Polar quadrant arc sweeps with discrete 4th-axis yaw re-orientation and camera exposure dwell (ARC_CCW, MOVE_REL PHI, WAIT_MS) |
45_polar_rotary_inspection_sweep.scara45_polar_rotary_inspection_sweep.bin |
| 46 | Rotated Frame Relative Stepping | Angled work frame transformations (FRAME_SET ... ANGLE=30.0), relative incremental raster steps (MOVE_REL), and base reset (FRAME_RESET) |
46_rotated_frame_relative_stepping.scara46_rotated_frame_relative_stepping.bin |
| 47 | Asymmetric Dual Obstacle Channel | Tight collision-free corridor navigation between rectangular enclosure (ZONE_DEF BOX) and cylindrical column (ZONE_DEF CIRCLE) with blend transitions |
47_asymmetric_dual_obstacle_channel.scara47_asymmetric_dual_obstacle_channel.bin |
| 48 | Hybrid Motor Mode Torque Switch | Dynamic runtime switching between open-loop high-speed transit and closed-loop delicate seating (CONFIG MOTOR OPEN_LOOP/CLOSED_LOOP) |
48_hybrid_motor_mode_torque_switch.scara48_hybrid_motor_mode_torque_switch.bin |
| 49 | Serpentine Raster Dispensing | Continuous planar serpentine meander path with linear passes joined by 180° alternating circular U-turn arcs (ARC_CW/CCW, TOOL_ORIENT TANGENTIAL, ZONE BLEND) |
49_serpentine_raster_dispensing.scara49_serpentine_raster_dispensing.bin |
| 50 | Master Multi-System Production Cell | Full-scale capstone manufacturing cell integrating pallets, frames, obstacle keep-out, parabolic jumps, subroutines, tool tangency, and pneumatics | 50_master_multisystem_production_cell.scara50_master_multisystem_production_cell.bin |
Developers and integrators can use the scaralang command-line interface to compile, inspect, disassemble, decompile, and export any example program:
compile)Compiles a human-readable .scara script into a packed binary execution stream (.bin):
scaralang compile -s examples/12_industrial_pick_place.scara -o examples/12_industrial_pick_place.bin
disassemble)Decodes binary wire protocol frames into formatted textual inspection instructions (.dis):
scaralang disassemble -b examples/12_industrial_pick_place.bin -o examples/12_industrial_pick_place.dis
decompile)Reconstructs high-level .scara DSL instructions directly from binary wire frames (_decompiled.scara):
scaralang decompile -b examples/12_industrial_pick_place.bin -o examples/12_industrial_pick_place_decompiled.scara
export)Exports trajectory plans to multi-target formats (G-code, CSV time series, JSON telemetry, SVG visualization):
scaralang export -s examples/12_industrial_pick_place.scara -f gcode -o examples/12_pick_place.gcode
scaralang export -s examples/12_industrial_pick_place.scara -f svg -o examples/12_pick_place.svg
scaralang export -s examples/12_industrial_pick_place.scara -f csv -o examples/12_pick_place.csv
scaralang export -s examples/12_industrial_pick_place.scara -f json -o examples/12_pick_place.json
lint)Validates robotic motion safety, pneumatic timing, and kinematic boundaries before execution:
scaralang lint -s examples/12_industrial_pick_place.scara
# ------------------------------------------------------------------
# Industrial Palletizing Routine: Pick from Feeder, Place into Tray
# ------------------------------------------------------------------
CONFIG ELBOW LEFT
CONFIG MOTOR CLOSED_LOOP
SPEED RAPID 220.0
SPEED WORK 80.0
ACCEL 600.0
OVERRIDE 100
# 1. Calibrate reference home
HOME
# 2. Define a 3x4 Component Tray Matrix
PALLET_DEF TRAY_OUT ROWS 3 COLS 4 DX 30.0 DY 30.0 Z 10.0
# 3. Position above component feeder station
MOVE_J X 120.0 Y -60.0 Z 40.0
APPROACH DIST 35.0
# 4. Grip first component
PUMP ON
WAIT 150
RETRACT DIST 35.0
# 5. High-speed parabolic arch transfer to Pallet Slot #1
JUMP X 180.0 Y 50.0 Z 10.0 ARCH 30.0
# 6. Release component
PUMP OFF
VALVE ON
WAIT 60
VALVE OFF
# 7. Move directly to Pallet Slot #2 for second cycle
MOVE_PALLET TRAY_OUT INDEX 2
APPROACH DIST 10.0
# ------------------------------------------------------------------
# Continuous Circular Gasket Dispensing with Tangential Tool Yaw
# ------------------------------------------------------------------
SPEED RAPID 180.0
SPEED WORK 50.0
ACCEL 400.0
HOME
ZONE Z5
TOOL_ORIENT TANGENT
# Approach starting contour point
MOVE_J X 150.0 Y 0.0 Z 25.0
MOVE_L X 150.0 Y 0.0 Z 5.0
# Dispenser ON
TOOL DOWN
WAIT 50
# Continuous circular toolpath (R=40mm)
ARC_CW X 190.0 Y 40.0 I 0.0 J 40.0
ARC_CW X 230.0 Y 0.0 I 0.0 J -40.0
ARC_CW X 190.0 Y -40.0 I -40.0 J 0.0
ARC_CW X 150.0 Y 0.0 I 0.0 J 40.0
# Dispenser OFF
ZONE EXACT
TOOL UP
RETRACT DIST 30.0
# ------------------------------------------------------------------
# PCB Height Surface Probing and Touch-Off
# ------------------------------------------------------------------
CONFIG ELBOW RIGHT
SPEED RAPID 150.0
SPEED WORK 30.0
HOME
# Move above PCB test pad
MOVE_J X 140.0 Y 20.0 Z 35.0
# Search for PCB top plane at controlled velocity
PROBE SPEED 5.0 DIST 30.0
# Set Work Coordinate System relative to probed surface
FRAME X 140.0 Y 20.0 Z 0.0
# Dispense micro-dot exactly 0.5 mm above probed surface
MOVE_L X 0.0 Y 0.0 Z 0.5
TOOL DOWN
WAIT 100
TOOL UP
RETRACT DIST 20.0
FRAME_RESET