Getting started with ENCY Robot
You have a license and a KUKA robot. These steps take you from an empty project to the first program running on the real cell: build the cell, calibrate tool and base, run a simple contour.
In this guide
- Before you start
- Step 0. Install, activate, and know where to ask
- Step 1. Build your cell in MachineMaker
- Step 2. Calibrate tool and base: measure the tool
- Measure the base on the robot
- Enter the tool in ENCY
- Enter the base in ENCY
- Step 3. Run a first simple project
- Step 4. Learn with ENCY Academy
- Step 5. Move to real parts
- Common first-week problems
- Stuck? Send your dealer the full picture
Before you start
You have a license and a KUKA robot. These steps take you from an empty project to the first program running on the real cell, without guesswork.
You need a trained robot operator
ENCY Robot creates the robot program. It does not replace the person who runs the robot. Someone on your side must be able to:
- jog the robot safely, switch operating modes, start, stop and run programs on the controller;
- measure and verify the tool and the base on the controller;
- load program files onto the controller (USB or network);
- confirm the robot has been fully commissioned: axis mastering, safety configuration and I/O are done.
Who does what
| Who | Responsible for |
|---|---|
| ENCY and your dealer | The license, updates, documentation, ENCY Academy and technical support for the software. Your dealer is the first line. Ready postprocessors come from the catalog, and adjustments for special controller functions are available on request. |
| You, as the robot owner | Install and activate the software, build the cell in MachineMaker and provide 3D models of your equipment, measure the tool and the base on the robot and enter them in ENCY, and run programs on the robot: safe operation, commissioning and first runs. |
We are happy to help at every step, but the cell and the calibration describe your equipment, so they stay your responsibility.
Have these ready
- Exact robot model, controller model and software version
- 3D models (STEP) of the tool or spindle, its mounting flange, tables, fixtures, rails or positioners
- A license that covers your application (milling, cutting, welding, additive and so on)
- A postprocessor for your controller. Check Digital Machine Center or ask your dealer
Step 0. Install, activate, and know where to ask
- Install the latest version from the Download Center. Sign in with the same account the license was issued to. The license email has no attached file: an online license activates on sign-in.
- No internet on the shop-floor PC? Tell your dealer before the license is issued, so it is issued for offline use.
- Check the license covers your process. The email lists the modules. Milling, disc cutting, welding and additive are separate options. If yours is missing, ask your dealer before building the project.
- Where to ask. The first line is the dealer who sold you the software.
Step 1. Build your cell in MachineMaker
MachineMaker builds the digital twin that ENCY uses for toolpaths, collision checks and simulation. Pick your robot from the library, then add your tool, tables, fixtures and any extra axes.
- Every object that matters needs a model. A missing tool or spindle model is the most frequent reason a cell cannot be finished.
- Place objects using real measurements from your shop floor, not estimates.
- Robot not in the library? Request it in Digital Machine Center or build it from the manufacturer's data.
Quick check: does the twin match the real robot?
Put the real robot and the twin in the same reference pose: A1 0°, A2 −90°, A3 +90°, A4 0°, A5 0°, A6 0°. Robot and tool should look the same in both. If they don't, fix the model before calibrating.
Step 2. Calibrate tool and base: measure the tool
The robot needs to know where the tool tip is (TCP) and where the part is (base). If either is off, every toolpath is shifted. Measure both on the robot, verify them, then enter the same values in ENCY. If you have several bases (fixtures, tables), calibrate each one.
Measure the tool on the robot
Menu ▸ Start-up ▸ Measure ▸ Tool ▸ XYZ 4-point, T1 mode, user level Expert or higher.
- Enter the tool number and a clear name, for example Mill_D16_01.
- Bring the tool tip to a fixed reference point and confirm. Repeat from 4 clearly different orientations.
- Check the error the controller reports. It should be no more than 0.3 mm; otherwise measure again.
- Then set the orientation: Tool ▸ ABC World. Don't skip the angles: without them ENCY has only half the tool data.
Exact dimensions known from a drawing? Use Tool ▸ Numeric input.
Measure the base on the robot
Menu ▸ Start-up ▸ Measure ▸ Base ▸ 3-point, using the tool you have just measured.
- Enter the base number and name, and select the measuring tool.
- Touch the origin (for example a corner of the fixture), then a point on +X, then a point in the XY plane on the +Y side.
- Save. Repeat for every base you will use.
Verify before moving on
- TCP: jog in TOOL coordinates and rotate around A, B, C. The tip should stay in place. If it drifts, measure again.
- Base: jog in BASE coordinates along X, Y, Z. The robot should travel along the edges of the fixture.
Enter the tool in ENCY
In MachineMaker, open Calibration and set Tool point to TCP. Copy the values exactly as the controller shows them:
| On the controller | In ENCY |
|---|---|
| X, Y, Z of the tool (mm) | X, Y, Z |
| A of the tool (°) | A (Rz) |
| B of the tool (°) | B (Ry) |
| C of the tool (°) | C (Rx) |
Also fill in:
| Field in ENCY | What to enter |
|---|---|
| Tool overhang | Length of the cutter, full length or from tip to the holder. Always fill it in. |
| Tool along | Tool axis direction, for example Z+. |
Enter the base in ENCY
- Create a coordinate system on the part: Create new CS, for example by start point, X and Y axes.
- Open Setup and tooling ▸ Base setup and in Workpiece setup enter the values below.
| Field in Workpiece setup | What to enter |
|---|---|
| Geometry CS | The CS you created on the part, for example Local CS1. |
| Machine CS | World CS. |
| Offset X, Y, Z | Position of the base from the robot, mm. |
| Rotation Rz, Ry, Rx | A, B, C of the base. |
| Base № | The same number as on the robot. |
Step 3. Run a first simple project
Start with a plain contour, not a real part. The goal is to prove that the cell, the calibration and the postprocessor all agree.
- Create a project with your cell, draw a simple rectangle on the part, and add a 2D contouring operation.
- For the first run, lift the toolpath above the surface (for example +20 mm) so the tool cuts air.
- Simulate and fix any collisions or reach problems.
- Post-process. Check that the tool and base in the program are the ones you measured on the robot.
- Load the program on the controller and run it in reduced-speed manual mode, step by step, hand on the enabling switch.
- If the path follows the contour correctly, lower it to the surface and run again.
Loading the program on the controller
A program is two files, .src (motion) and .dat (points). Always copy them together. In the Navigator, open R1 ▸ Program, paste both files, select the .src and press Select. Check that the BASE_DATA and TOOL_DATA numbers in the program match your measurements.
Step 4. Learn with ENCY Academy
Free video courses, in 14 languages, recorded by our engineers.
- Launch your first robot project: tool measurement, TCP, MachineMaker and a test project (45 min).
- Robot Programmer pathway: from the interface to 2D/3D milling, contouring and 5D machining.
Step 5. Move to real parts
When the test contour runs where it should, you are ready for real projects: 3D milling, trimming, rotary tables and rails, and other applications covered by your license. Keep the habit of simulating every program and running new ones first at reduced speed.
Common first-week problems
- The path is shifted or tilted relative to the part
The base was not measured, or not entered in ENCY, or the program uses a different base.
- Simulation is fine, but the real tool is off by a constant amount
Wrong TCP, missing orientation, or tool length not set in ENCY.
- The tip drifts when rotating around the TCP
The tool measurement is inaccurate. Measure it again.
- The controller rejects the program
The postprocessor does not match your controller or its options. Ask your dealer and send the file with the error text.
- You need I/O, external axes or process commands in the program
The postprocessor needs adjusting for your setup. Ask your dealer.
- A program that worked before behaves differently after an update
Keep the previous version installed next to the new one. Re-simulate old projects in the new version before running them, and report the difference to your dealer with both project files.
- Calculation or simulation is very slow
Check that the PC meets the system requirements. If you use a network license server, compare with a standalone license and send logs to your dealer.
- Your robot or equipment is not in MachineMaker
Request it in Digital Machine Center, or build it from the manufacturer's data.
Stuck? Send your dealer the full picture
Contact your dealer and attach: the project file (.stcp), the generated program, a photo of the cell, robot and controller model, your tool and base values, and the exact error text from the pendant. With these, a first reply is usually enough to move forward.