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:
Даниил Грабарь
2026-08-13 18:01:59 +03:00
parent 08ebd40671
commit 79d88db930
42 changed files with 2973 additions and 17 deletions
@@ -0,0 +1,85 @@
# Installing libraries
Additional libraries distributed as `.zip` archives must be installed for the SunriseWorkbench project to work fully.
!!! note "Prerequisite"
Before installing the libraries, make sure that the project has been created or loaded. See [Creating a new project](new-project.md) or [Loading an existing project](load-project.md).
## Opening the settings
In the SunriseWorkbench main menu, select **Window → Preferences**. In the window that opens, go to **Install/Update → Available Software Sites**.
![Window → Preferences menu](../assets/config/libraries/step-01.png)
## Adding library archives
Click **Add**. In the dialog, click **Archive...** and add a library `.zip` archive.
![Available Software Sites](../assets/config/libraries/step-02.png)
### Windows users
Use the standard file-selection dialog to locate and select the archive.
### Linux users
Because SunriseWorkbench runs in an emulated Windows environment, use the following procedure to access the Linux file system:
1. In the file-selection dialog, click **Look in:** and select **My Computer**.
![Adding a software source](../assets/config/libraries/step-03.png)
2. A list of mounted drives appears. It may contain more entries than the number of physical drives because of how the compatibility environment works.
![Selecting an archive](../assets/config/libraries/step-04.png)
3. Check each drive in turn. One of them contains the Linux file system (drive H in this example).
![My Computer](../assets/config/libraries/step-05.png)
4. Open the directory containing the libraries, select one of the `.zip` archives, and click **OK**.
![Drive list](../assets/config/libraries/step-06.png)
5. Confirm the selected archive by clicking **OK** in the next window.
![Linux file system](../assets/config/libraries/step-07.png)
## Adding the remaining archives
The archive appears in the **Available Software Sites** list. Repeat the procedure for every remaining library `.zip` file.
![Selecting an archive](../assets/config/libraries/step-08.png)
After adding all archives, click **OK** to save the settings.
## Installing the libraries
Select **Help → Install New Software...** from the menu. In the **Work with** field, select **All Available Sites**. Components from all added archives appear in the list.
![List of added archives](../assets/config/libraries/step-09.png)
Select every available component and click **Next**. Review the installation summary and click **Next** again.
![Help → Install New Software](../assets/config/libraries/step-10.png)
Accept the license agreements and click **Finish** to begin installation.
![Component list](../assets/config/libraries/step-11.png)
!!! warning "Installation duration"
Installing the libraries may take a significant amount of time. Do not interrupt the process.
![Selecting components](../assets/config/libraries/step-12.png)
## Restarting the application
When installation finishes, SunriseWorkbench prompts you to restart. Click **Restart Now**.
![Installation process](../assets/config/libraries/step-13.png)
After the restart, the interface switches to Russian and all installed libraries appear in `StationSetup.cat`.
![Restart prompt](../assets/config/libraries/step-14.png)
!!! tip "Next step"
If the project has not yet been configured, see [Creating a new project](new-project.md) or [Loading an existing project](load-project.md).
@@ -0,0 +1,30 @@
# Loading a project from the controller
This section explains how to import an existing project directly from the KUKA controller into SunriseWorkbench.
!!! note "Prerequisite"
Make sure that SunriseWorkbench is installed and running. See the [Windows](../sun_install/windows.md) and [Linux](../sun_install/linux/linux.md) installation guides.
## Starting the project import wizard
In the main SunriseWorkbench window, click **New Sunrise Project**.
![Main SunriseWorkbench window](../assets/config/new-project/step-01.png)
In the dialog that opens, select **Load project from controller** and enter the IP address of the KUKA Sunrise Cabinet controller.
![Controller connection dialog](../assets/config/load-config/step_01.png)
!!! info "Controller IP address"
The default controller IP address is `172.31.1.147`. If the controller has been reconfigured, enter its current address. This configuration uses `192.168.21.147`. To find the current address, see [Station configuration](../kuka/features/station.md).
Click **Next** to begin downloading the project from the controller.
![Project download process](../assets/config/load-config/step_02.png)
When the download is complete, the imported project appears in the SunriseWorkbench project tree. In this example, the project is named `SunriseProject`.
![Imported project in the workspace](../assets/config/load-config/step_03.png)
!!! tip "Next step"
All required libraries must be installed for full robot operation. See [Installing libraries](libraries.md).
@@ -3,7 +3,7 @@
В данном разделе описана процедура импорта существующего проекта непосредственно с контроллера KUKA в среду SunriseWorkbench.
!!! note "Предварительное требование"
Убедитесь, что SunriseWorkbench установлен и запущен. Инструкции по установке приведены в разделах [Windows](../install/windows.md) и [Linux](../install/linux/linux.md).
Убедитесь, что SunriseWorkbench установлен и запущен. Инструкции по установке приведены в разделах [Windows](../sun_install/windows.md) и [Linux](../sun_install/linux/linux.md).
## Запуск мастера импорта проекта
@@ -27,4 +27,4 @@
![Импортированный проект в рабочей области](../assets/config/load-config/step_03.png)
!!! tip "Следующий шаг"
Для полноценной работы с роботом необходимо установить все требуемые библиотеки. Инструкции приведены в разделе [Установка библиотек](libraries.md).
Для полноценной работы с роботом необходимо установить все требуемые библиотеки. Инструкции приведены в разделе [Установка библиотек](libraries.md).
@@ -0,0 +1,63 @@
# Creating a new project
This section explains how to create a SunriseWorkbench project and perform the initial configuration for a KUKA LBR IIWA 7.
!!! note "Prerequisite"
Before creating a project, make sure that SunriseWorkbench is installed. See the [Windows](../sun_install/windows.md) and [Linux](../sun_install/linux/linux.md) installation guides.
## Starting the new-project wizard
In the main SunriseWorkbench window, click **New Sunrise Project**.
![Main SunriseWorkbench window](../assets/config/new-project/step-01.png)
## Configuring the controller connection
Enter the IP address of the KUKA Sunrise Cabinet controller in the dialog.
![Entering the controller IP address](../assets/config/new-project/step-02.png)
!!! warning "Controller IP address"
The default controller IP address is `172.31.1.147`. If your configuration uses a different address, replace it with the current value.
## Project name
Enter the project name in the corresponding field.
![Entering the project name](../assets/config/new-project/step-03.png)
## Selecting the robot model
Select the robot model from the drop-down list. For a KUKA LBR IIWA 7, choose **LBR iiwa 7 R800**.
![Selecting the robot model](../assets/config/new-project/step-04.png)
## Selecting the flange
Select the flange type that matches your robot configuration.
![Selecting the flange](../assets/config/new-project/step-05.png)
!!! warning "Flange selection"
The flange type must exactly match the physical robot configuration. This setup uses **Medien-Flansch elektrisch**. Leave its orientation at the default value of 0°.
## Reviewing the configuration
Review all parameters in the summary window. If they are correct, click **Finish**.
![Reviewing the parameters](../assets/config/new-project/step-06.png)
## Selecting an application template
After the project is created, the template selection dialog opens. Select one of the examples and click **Finish**.
![Selecting a template](../assets/config/new-project/step-07.png)
## Main editor window
After the wizard completes successfully, SunriseWorkbench opens the new project in its main editor window.
![Main editor window](../assets/config/new-project/step-08.png)
!!! tip "Next step"
All required libraries must be installed for full robot operation. See [Installing libraries](libraries.md).
@@ -3,7 +3,7 @@
В данном разделе описан процесс создания нового проекта в SunriseWorkbench и его первоначальная конфигурация для работы с роботом KUKA LBR IIWA 7.
!!! note "Предварительное требование"
Перед созданием проекта убедитесь, что SunriseWorkbench установлен. Инструкции по установке приведены в разделах [Windows](../install/windows.md) и [Linux](../install/linux/linux.md).
Перед созданием проекта убедитесь, что SunriseWorkbench установлен. Инструкции по установке приведены в разделах [Windows](../sun_install/windows.md) и [Linux](../sun_install/linux/linux.md).
## Запуск мастера создания проекта