SIMIT KUKA Coupling: Install the KUKA Connector in SIMIT 11.3
The SIMIT KUKA Coupling is an optional, licensable add-on to Siemens SIMIT 11.3 that enables co-simulation between a SIMIT virtual commissioning project and a KUKA robot controller. The KUKA connector is not bundled with the base SIMIT 11.3 license; it must be acquired, licensed in the Automation License Manager, and installed as a separate component before it appears in the SIMIT Connectors menu. This guide walks through the licensing, installation, and shared-memory (SHM) workflow that bridges SIMIT to KUKA OfficeLite (recommended for development: OfficeLite Y200 or the KR C5 cabinet variant equivalent).
1. Overview of the SIMIT KUKA Coupling Architecture
SIMIT (Siemens Mechatronics Integration Tool) is the digital-twin and virtual-commissioning platform from Siemens used to simulate SIMATIC S7-1500, ET 200SP, SINAMICS drives, and—via add-on couplings—third-party subsystems. The KUKA Coupling extends the SIMIT runtime so that a SIMIT simulation graph can exchange process data with a KUKA robot controller (KR C4, KR C5, or OfficeLite) in real time.
The coupling is implemented as a Shared Memory (SHM) interface. Both processes (SIMIT and the KUKA controller / OfficeLite) write to and read from a common memory block, which avoids Ethernet protocol overhead and yields deterministic sub-millisecond cycle exchange. This is documented in the Siemens Industry Online Support (SIOS) document 109795246 — SIMIT Couplings, applicative expansions of the interface, where Chapter 4 — KUKA covers the SHM-based handshake and signal mapping rules.
| Component | Role | Default State in SIMIT 11.3 |
|---|---|---|
| SIMIT Base (VC / CTE) | Simulation kernel, signal editor, graph compiler | Installed with base license |
| SIMIT KUKA Coupling | SHM gateway between SIMIT and KUKA OfficeLite/KR C | Not included; requires add-on |
| Automation License Manager (ALM) | Hosts the SIMIT and KUKA license tickets | Installed with SIMIT |
| KUKA OfficeLite Y200 | PC-based KUKA robot controller (development) | Separate KUKA product, KSS 8.x or newer |
| KUKA.PLC mxAutomation / KUKA.CR | Option packages enabling external SHM access | Ordered separately from my.KUKA |
2. Prerequisites
- SIMIT 11.3 base license installed and functional. Verify by launching SIMIT VC and confirming the project tree loads.
- Automation License Manager (ALM) present. The KUKA Coupling license is bound to the same ALM dongle (USB or software) that hosts SIMIT.
-
SIMIT KUKA Coupling add-on license purchased from your Siemens sales channel. The license is delivered as a License Key file (e.g.
....zipcontaining....licticket). - KUKA OfficeLite (or licensed KR C4 / KR C5 controller). Recommended: OfficeLite Y200 or newer. KSS version must match the SHM option package installed on the controller.
- Windows 10 / 11 (64-bit) with both SIMIT and OfficeLite installed on the same machine (for development) or on machines connected by a defined network path (for production cells).
- Administrator rights for installing the add-on DLLs and registering the SHM coupling service.
3. Verify the Existing SIMIT 11.3 License
Before installing anything, confirm what your current SIMIT 11.3 license actually grants. Many users assume the KUKA connector is included because it is documented in the same SIOS manual as the SIMIT base — it is not.
- Open Automation License Manager from the Windows Start menu.
- Select the local host (or network dongle) hosting the SIMIT ticket.
- Look for entries in the form:
SIMATIC SIMIT V11.0
SIMATIC SIMIT KUKA Coupling V11.0 - If only the first line is present, the KUKA add-on is missing. The connector will not appear in the SIMIT Connectors menu regardless of DLLs being on disk.
Status colors in ALM:
| ALM Status | Meaning | Action |
|---|---|---|
| Green check | Valid local license, in use | None |
| Yellow triangle | License present but not in use | Proceed |
| Red X | License missing or expired | Contact Siemens rep for renewal |
| Grayed out | Dongle not connected | Reconnect USB / network license server |
4. Acquire the KUKA Coupling Add-On
4.1 License Purchase
Order the SIMATIC SIMIT KUKA Coupling add-on through your Siemens regional sales contact or via the Siemens Industry Mall. Provide the host ID of the ALM machine; Siemens issues a license key bound to that ID. Lead time is typically 5–10 business days.
4.2 Software Package Download
The KUKA Coupling add-on is distributed through Siemens Industry Online Support:
- Navigate to the SIOS entry 109795246 — SIMIT Couplings, applicative expansions of the interface.
- Open the entry and read Chapter 4 — KUKA to understand SHM mapping and to confirm signal limits.
- Open a SIOS support ticket requesting the KUKA Coupling application example package. The application example contains:
- The connector installer (MSI / setup.exe)
- A sample SIMIT project with a pre-configured KUKA coupling block
- A reference KRL program for OfficeLite (or .NET mxAutomation demo)
- Release notes for the matching SIMIT 11.3 build
Keep the downloaded package on a local path that does not contain spaces or Unicode characters (e.g. C:\SIMIT\AddOns\Kuka) to avoid installer issues.
5. Install the KUKA Coupling
5.1 Pre-Install Checklist
- SIMIT 11.3 closed (no SIMIT VC or SIMIT CTE running).
- ALM stopped to avoid file lock during
SIMITKukaCoupling.dllregistration. - ALM dongle or network license server reachable.
5.2 Installer Run
- Right-click
setup.exe→ Run as administrator. - Accept the license agreement.
- Installer detects the SIMIT 11.3 install path (default
C:\Program Files\Siemens\Automation\SIMIT\11.3). - Select KUKA Coupling feature. Optionally include the sample project.
- Click Install. Files placed:\li>
| Path | File | Purpose |
|---|---|---|
...\SIMIT\11.3\Bin |
SIMITKukaCoupling.dll |
Coupling backend loaded by SIMIT kernel |
...\SIMIT\11.3\Connectors |
KUKA.cml |
Coupling editor definition |
...\SIMIT\11.3\Examples |
*.simit |
Sample project (if selected) |
...\Common Files\Siemens\Automation\SIMIT\SHM |
shm_driver.exe |
Shared-memory bridge service |
5.3 Register the License
- Start Automation License Manager.
- Locate the new
SIMATIC SIMIT KUKA Coupling V11.0license line. - If shown red, click License Key → Install and select the
.licfile from Siemens. - Restart the ALM service:
net stop "ALM" && net start "ALM"(admin command prompt).
5.4 Verify in SIMIT
- Launch SIMIT VC.
- Open or create a project.
- In the project tree expand Connectors.
- Confirm KUKA is listed. If it still is not, see Section 9.
6. Configure the Shared-Memory (SHM) Channel
The KUKA Coupling communicates through a named shared-memory block. Both SIMIT and the KUKA controller / OfficeLite must agree on the block name, byte size, and signal layout. The defaults in SIMIT 11.3 are:
| Parameter | Default | Editable in SIMIT? | Notes |
|---|---|---|---|
| SHM block name | SIMIT_KUKA_SHM |
Yes (Coupling editor) | Must match the KRL or mxAutomation configuration |
| Cycle time | 4 ms (typical) or 12 ms (KRC) | Yes | Must be ≥ KUKA interpolation cycle |
| Max signals | 256 in / 256 out | Yes (coupling limits) | For larger I/O, split into multiple blocks |
| Endianness | Little-endian | No | KUKA controllers expect little-endian |
| Trigger source | SIMIT (default) or KUKA | Yes | Choosing KUKA trigger aligns simulation to robot interpolation |
6.1 SIMIT-Side Coupling Editor
- Project tree → Connectors → KUKA → right-click → Open.
- Set Block name, Cycle time, Trigger source.
- Map SIMIT signals to SHM indices. Example for a digital output (SIMIT → KUKA):
Index: 0Type: BOOLDirection: SIMIT → KUKASIMIT tag: HMI_StartButton - Compile the coupling (F7 or right-click → Compile).
6.2 OfficeLite-Side Configuration
- Start KUKA OfficeLite Y200 and load a project containing the SHM option package.
- Open the KRL program (or mxAutomation config) that writes to the SHM block. Example KRL snippet (KSS 8.6) using a submit interpreter:
; KUKA SHM handshake — submit program
DECL GLOBAL CHAR SHM_NAME[20]
SHM_NAME[] = "SIMIT_KUKA_SHM"
; Open shared memory block
$FLAG[1] = shm_open(SHM_NAME[], 256)
; Write digital outputs from controller to SIMIT
shm_write_word(0, $IN[1] + $IN[2]*2 + $IN[3]*4 + $IN[4]*8)
; Read digital inputs from SIMIT
DECL INT SIM_IN
SIM_IN = shm_read_word(0)
$OUT[10] = B_AND(SIM_IN, 1) ; Bit 0 → DO10
$OUT[11] = B_AND(SIM_IN, 2) / 2 ; Bit 1 → DO11
- Save, select, and run the submit program in OfficeLite.
- Switch to T1 or Aut mode as required for signal exchange.
shm_open, shm_write_word, shm_read_word) in your KSS version. Do not invent system calls — verify in the KUKA documentation shipped with the option package.7. KUKA Side Requirements: mxAutomation or KUKA.CR
For SIMIT to drive a KUKA robot in co-simulation, the controller must expose its I/O and motion interface to a PLC or external process. Two product lines support SHM access:
- KUKA.PLC mxAutomation — soft-PLC integration using PROFINET, EtherNet/IP, or shared memory. The mxAutomation SHM bridge component is the actual gateway SIMIT talks to. Available in versions for KR C4 and KR C5.
- KUKA.CR (Conveyor Ready / Controller ready) — for conveyor tracking and discrete I/O; supports a subset of the SHM signals.
The component identifier Coupler in the my.KUKA catalog (Component 130304) is the add-on part that physically or logically enables the SHM bridge in the controller. See the official entry: my.KUKA — Coupler (Component 130304). Ordering channels, customer-specific prices, and the KSS-version compatibility matrix are managed in the same portal.
| KUKA Product | Order via | Required KSS | Typical Use |
|---|---|---|---|
| KUKA.PLC mxAutomation 4.x | Siemens / KUKA sales | 8.3 – 8.7 | Full motion + I/O co-simulation |
| KUKA.CR | my.KUKA | 8.5 – 8.7 | Conveyor / I/O simulation only |
| OfficeLite Y200 | KUKA sales (PC license) | 8.6 / 8.7 typical | Development & commissioning, no hardware |
8. Run a First Co-Simulation
- Start KUKA OfficeLite. Load the SHM-enabled project. Confirm the submit interpreter is running and $FLAG[1] = TRUE (SHM open).
- Start SIMIT VC. Open the sample project from the install (e.g.
...\SIMIT\11.3\Examples\Kuka_Demo.simit). - In SIMIT, click Start Simulation (F5). The coupling indicator should turn green within one cycle.
- In OfficeLite, force a digital input:
$IN[1] = TRUE. Observe that the mapped SIMIT signal changes value within 1–2 SHM cycles. - From SIMIT, drive a digital output: Set tag HMI_StartButton = TRUE. Observe $OUT[10] on the OfficeLite side go high.
- Trigger a stop condition (E-Stop, $ALARM_STOP, or SIMIT Halt). Verify both sides honor the stop.
8.1 Verification Checklist
| Check | Expected | Where to confirm |
|---|---|---|
| SIMIT coupling status LED | Green | SIMIT VC status bar |
| SHM block open | $FLAG[1] = TRUE |
OfficeLite variable monitor |
| Cycle time stability | Within ±5% of configured value | SIMIT Trace tool |
| Bidirectional exchange | DO from SIMIT changes KUKA output | KUKA smartHMI I/O indicator |
| License status | Green in ALM | Automation License Manager |
| E-Stop propagation | Both sides halt within 1 cycle | Manual test |
9. Troubleshooting Matrix
| Symptom | Likely Root Cause | Remedy |
|---|---|---|
| Connectors menu has no KUKA entry | Add-on not installed or license missing | Re-run installer; import license into ALM; restart SIMIT |
| Coupling present but Start Simulation errors with SHM open failure | OfficeLite SHM service not started | Run KRL submit program; check shm_open return code |
| Block opens but signals do not update | Endian mismatch or wrong index | Verify byte order; re-map signal indices to match KRL layout |
| Signals update sporadically with high jitter | Trigger source = SIMIT, KUKA cycle slower | Switch trigger to KUKA; or raise SIMIT cycle to ≥ KUKA interpolation |
| ALM shows license in red after install | License bound to different host ID | Rehost license to current ALM host ID via Siemens License Web-Portal |
| OfficeLite crashes when SHM coupling starts | SHM size too large for KSS version | Reduce block size to ≤ 256 words; check KSS SHM limits |
| “Coupling not licensed” popup at SIMIT start | License server unreachable | Check network; start ALM; reload license |
| Different SHM block names on each side | Manual rename on one side not propagated | Edit both Couplings in SIMIT and KRL; recompile and re-select |
10. Field-Commissioning Notes
10.1 Performance Sizing
Shared memory bandwidth on a Windows 10/11 host typically sustains up to 10 kHz update rates for blocks of 256 words. For dense multi-axis cells with several hundred signals, consider splitting the exchange across two SHM blocks (e.g. SIMIT_KUKA_SHM_A, SIMIT_KUKA_SHM_B) rather than enlarging one block.
10.2 Determinism
SIMIT is a Windows user-mode process and is therefore subject to OS scheduling jitter. For deterministic motion HIL, run SIMIT on a dedicated engineering machine with Windows high-performance power profile, real-time priorities disabled for non-SIMIT processes, and the SIMIT trigger set to follow the KUKA interpolation cycle (4 ms or 12 ms depending on KSS).
10.3 License Mobility
The KUKA Coupling license follows the SIMIT license: if you move SIMIT to a new ALM host, you must also rehost the KUKA ticket. The Siemens License Web-Portal allows this once per license period for free; additional moves incur an administrative fee.
10.4 Version Compatibility
Always match the KUKA Coupling add-on build to the SIMIT 11.3 minor build (e.g. SIMIT 11.3.0 + KUKA add-on 11.3.0). Cross-build operation is not supported and may produce undefined SHM behavior. SIOS document 109795246 lists validated combinations.
11. Diagnostic Tools and Log Locations
| Log | Path | Information |
|---|---|---|
| SIMIT coupling log | %LOCALAPPDATA%\Siemens\Automation\SIMIT\11.3\Coupling_Kuka.log |
SHM open/close, cycle, signal errors |
| ALM trace | %ProgramData%\Siemens\AutomationLicenseManager\Logs\ |
License check-in/out |
| OfficeLite log | C:\KUKA\OfficeLite\Log\ |
Submit interpreter, SHM driver |
| Windows Application log | eventvwr.msc |
Service start/stop, .NET exceptions |
When escalating to Siemens support, attach all four log sets plus the output of ALMdiag.exe from the SIMIT install directory.
12. Frequently Asked Questions
Is the KUKA Coupling included in the SIMIT 11.3 base license?
No. The KUKA Coupling is a separately licensed add-on. The base SIMIT 11.3 license grants only the core simulation engine and the standard coupling library (PLCSIM, NX MCD, etc.). KUKA support is delivered as an additional license ticket that must be installed in the same Automation License Manager host as the SIMIT base license.
Where do I obtain the SIMIT KUKA Coupling installer?
Open a SIOS support ticket against document 109795246 (SIMIT Couplings, applicative expansions of the interface) and request the KUKA application example. Siemens distributes the installer (DLLs, sample project, KRL reference) as a download through SIOS. Your Siemens sales channel issues the matching license key bound to your ALM host ID.
What KUKA controller is best for SIMIT co-simulation during development?
KUKA OfficeLite Y200 (PC-based controller) is the standard development target. It requires a KSS version that supports the SHM option package (KSS 8.6 or 8.7 typical). For hardware-in-the-loop acceptance, the same SHM configuration transfers unchanged to a KR C4 or KR C5 cabinet provided the matching KUKA.PLC mxAutomation or KUKA.CR option is installed and licensed.
Why does the KUKA connector not appear in SIMIT even after I install the DLLs?
The DLLs are only one of two prerequisites. The second is a valid KUKA Coupling license in the Automation License Manager. If ALM does not show a green "SIMATIC SIMIT KUKA Coupling" line, the connector entry will be hidden from the SIMIT Connectors menu regardless of whether the files are present. Rehost the license, restart the ALM service, then relaunch SIMIT.
Does the coupling work without KUKA.PLC mxAutomation?
Only for trivial I/O exchange. Full motion co-simulation (driving axis positions, reading back actual values, and synchronizing with interpolation) requires the mxAutomation SHM bridge or an equivalent custom KRL submit interpreter that opens the shared-memory block and reads/writes the agreed indices. A pure KRL-only configuration is possible but is limited to digital and small numeric I/O.
What cycle time should I configure?
Match it to the KUKA interpolation cycle. On KSS 8.6 / 8.7, the interpolation cycle is typically 4 ms (high-perf) or 12 ms (standard). If the SIMIT trigger source is set to KUKA, the configured SIMIT cycle must be ≥ the KUKA cycle to avoid overrun. A 4 ms SIMIT cycle paired with a 12 ms KUKA cycle is a common, stable combination.
Can the coupling run across two separate PCs (one SIMIT, one OfficeLite)?
Shared memory is a single-host mechanism. For two-machine operation, replace SHM with a network protocol coupling (e.g. SIMIT OPC UA coupling, or a custom TCP coupling). The SIOS document 109795246 covers SHM only; for distributed simulation, the OPC UA coupling section applies.
How do I move the KUKA Coupling license to a new engineering PC?
Return the license via the Siemens License Web-Portal, reissue to the new host ID, and reimport on the target machine. The KUKA add-on follows the same rehost rules as the SIMIT base license and is typically allowed one free rehost per license period.