Files
lightweight-cobot/doc/lwc-doc/docs/sunrise/kuka/features/robot-menu.en.md
T
Даниил Грабарь 79d88db930 Add documentation for KUKA Sunrise features and programs
- Created a new document for the Station interface, detailing its menu structure, process data, safety functions, frames, and smartPAD function buttons.
- Added a document for RobotPowerControl, explaining its purpose for safely shutting down or restarting the KUKA Sunrise Cabinet controller.
- Introduced ServerFriRos2 documentation, outlining its role in establishing an FRI connection between the KUKA LBR iiwa and a ROS 2 computer.
- Documented the TeachKuka application, which allows manual teaching of the KUKA LBR iiwa, including position capturing and trajectory recording.
- Added an overview of Sunrise Workbench, including installation instructions for Windows and Linux.
- Created a section on installing a Windows compatibility tool (PortProton) on Linux.
- Documented the installation process for SunriseWorkbench on Linux using PortProton.
- Added installation instructions for SunriseWorkbench on Windows.
- Created troubleshooting documentation for configuration errors and SSL errors during installation.
- Implemented a hook to generate the shared PDF only during the default-language build.
2026-08-13 18:01:59 +03:00

6.7 KiB

Robot menu

The Robot section is one of the main areas of KUKA smartHMI. It provides diagnostic robot-state information, mastering functions, tool and base calibration, and load parameters.

Robot menu

The table below lists the main menu items.

Item Description
Axis position Displays the current position of each robot axis in degrees
Cartesian position Displays the current tool position in Cartesian coordinates
Axis torques Displays the current torque on each robot axis
Mastering Provides axis mastering and tool-offset teaching functions
Load data Enters or calibrates the load parameters at the flange
Move enable Displays the manual-motion enable signal state
Log Displays events and errors; equivalent to the item under Station
Device state Displays the current device state with a color indicator
Calibration Provides tool and base calibration functions

Axis position

This section displays the current angular position of each of the robot's seven axes in degrees. Values update in real time. Software limits are also shown as minimum and maximum permitted values for each axis.

Axis position

Cartesian position

This section displays the tool center point (TCP) position in Cartesian coordinates relative to the selected base. The following parameters are available:

  • X, Y, Z — linear TCP coordinates in millimeters;
  • A, B, C — orientation angles in degrees.

!!! info "Angle-axis correspondence" A is rotation around Z, B around Y, and C around X, following the ZYX convention.

The current calculation context is also displayed:

  • selected Tool;
  • active TCP;
  • selected Base.

Change these values under Manual method options; see Extra menu. After selecting another tool, TCP, or base, the values on this page are recalculated accordingly.

Cartesian position

Axis torques

This section displays current torque on each of the seven axes in newton-meters (Nm). Values update in real time. This information lets the operator:

  • monitor the load on each axis;
  • diagnose possible mechanical problems;
  • identify characteristic torque values for later control-program tuning.

Axis torques

Mastering

Mastering maps the mechanical robot position to its software model. Without correct mastering, software coordinates do not match the actual axis positions.

The main mastering menu provides functions for updating mastering data, unmastering individual axes, and teaching tool offsets.

Main mastering menu

Use Update mastering data to save new mastering values after completing the procedure. The controller records the current mechanical axis positions as references.

Updating mastering data

Unmaster removes mastering data from a selected axis. An unmastered axis is considered uncalibrated and may move beyond software limits.

Unmastering an axis

!!! warning "When should an axis be unmastered?" Unmaster an axis if it reaches a software limit and cannot continue moving. After moving it away from the limit, master it again to restore correct robot operation.

Teach tool offset applies a correction to an axis zero position without repeating the complete mastering procedure. Use it for small mechanical offsets.

Teaching a tool offset

!!! warning "Important" Select the tool whose offset will be taught before activating this function.

Load data

Correct load parameters are required for accurate motion planning, prevention of axis overload, and proper operation of Power and Force Limiting (PFL).

The main load-data menu lists the available tool slots. Load parameters can be entered or calibrated for each tool.

Main load-data menu

Under Determine load data, enter or automatically determine mass, center of mass, and inertia tensor.

Determining load data

The Tool mass calibration procedure lets the controller measure the attached tool mass automatically by performing test motions. Follow the on-screen instructions.

Tool mass calibration

When the procedure finishes, the controller displays the measured load parameters. Review them and verify that they match the actual tool characteristics.

Calibration results

After confirmation, the controller saves and immediately applies the updated load data.

Updated load data

Move enable

This item displays the state of the manual-motion enable signal. The signal is activated by pressing the enable button on the manipulator body. smartHMI indicates the active state by changing the axis indicators from gray to white.

!!! note "Mode limitation" Move enable is unavailable in automatic mode (AUT). The signal is active only in manual modes T1 and T2.

Log

This section is equivalent to Log under Station. It displays controller events, warnings, and errors so that the operator can review their chronology and diagnose faults.

Device state

This section displays the current device state with a color indicator:

Color State
Green The device is operating normally
Yellow A warning or potential issue requires attention
Red A critical error or fault has been detected

Calibration

The Calibration section contains procedures for determining the geometric parameters of tools and bases used by the controller to calculate Cartesian coordinates.

The main menu contains two categories: base calibration and tool calibration.

Main calibration menu

Base calibration defines the position of a working coordinate system relative to the World coordinate system. It associates the program with the physical location of a workpiece or equipment in the robot cell.

Base calibration

Tool calibration determines the TCP position and tool orientation relative to the robot flange. Several calibration methods are available for each tool.

Tool calibration

The selected method determines the procedure. The common XYZ 4-Point method approaches one reference point from four different orientations.

Selected tool calibration method