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.
This commit is contained in:
Даниил Грабарь
@@ -0,0 +1,146 @@
|
||||
# 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.
|
||||
|
||||
|
||||
|
||||
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](station.md) |
|
||||
| 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.
|
||||
|
||||
|
||||
|
||||
## 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](extra-menu.md). After selecting another tool, TCP, or base, the values on this page are recalculated accordingly.
|
||||
|
||||
|
||||
|
||||
## 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.
|
||||
|
||||
|
||||
|
||||
## 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.
|
||||
|
||||
|
||||
|
||||
Use **Update mastering data** to save new mastering values after completing the procedure. The controller records the current mechanical axis positions as references.
|
||||
|
||||
|
||||
|
||||
**Unmaster** removes mastering data from a selected axis. An unmastered axis is considered uncalibrated and may move beyond software limits.
|
||||
|
||||
|
||||
|
||||
!!! 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.
|
||||
|
||||
|
||||
|
||||
!!! 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.
|
||||
|
||||
|
||||
|
||||
Under **Determine load data**, enter or automatically determine mass, center of mass, and inertia tensor.
|
||||
|
||||
|
||||
|
||||
The **Tool mass calibration** procedure lets the controller measure the attached tool mass automatically by performing test motions. Follow the on-screen instructions.
|
||||
|
||||
|
||||
|
||||
When the procedure finishes, the controller displays the measured load parameters. Review them and verify that they match the actual tool characteristics.
|
||||
|
||||
|
||||
|
||||
After confirmation, the controller saves and immediately applies the 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](station.md). 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.
|
||||
|
||||
|
||||
|
||||
**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.
|
||||
|
||||
|
||||
|
||||
**Tool calibration** determines the TCP position and tool orientation relative to the robot flange. Several calibration methods are available for each tool.
|
||||
|
||||
|
||||
|
||||
The selected method determines the procedure. The common **XYZ 4-Point** method approaches one reference point from four different orientations.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user