====== Plan: Hermes-Anbindung an die KUKA-Roboter ====== **Status: Entwurf, noch nicht umgesetzt** (notiert 2026-11-16 von Hermes in Absprache mit Holger/Felix). Ziel: Den Hermes-Agenten (KI im Vereins-Slack) sicher an die iiwa-Roboter anbinden. ====== Zielarchitektur ====== Kette: **Steuerrechner ↔ Win10-PC (Sunrise Workbench) ↔ Linux-PC (ROS 2) ↔ Hermes** * **Win10-PC:** KUKA Sunrise Workbench 1.16.2.16 — Installer liegt schon im Nextcloud: ''/Vereinsmitglieder_lesen/02_Bereiche/01_Robotik/Kuka/SunriseWorkbench-1.16.2.16-win32-x86.zip'' (32-Bit-Build, läuft auf 64-Bit-Win10). Dient zur Konfiguration/Monitoring, nicht zur Echtzeitsteuerung. * **Linux-PC (dediziert, im Roboter-Netz):** Ubuntu 22.04 + ROS 2 Humble + [[https://github.com/lbr-stack/lbr_fri_ros2_stack|lbr_fri_ros2_stack]] (FRI-Client über X66, UDP Port 30000). * **Hermes:** spricht ausschließlich eine schmale API auf dem Linux-PC an (whitelistete Aktionen mit serverseitig hart verdrahteten Limits), niemals den Steuerrechner direkt. ====== Meilensteine ====== === M0 — Hardware & Netzwerk === * Steuerrechner 1/3 zuordnen; Steuerrechner 4 (defektes Netzteil, [[bereiche:robot:kuka#zustand_der_geraete|siehe Zustandsliste]]) testen bzw. reparieren/ersetzen. * X66-Problem einkreisen (Kabel/Switch), eigenes Roboternetz-VLAN abgeschottet vom Vereins-LAN. * Abnahme: Ping Steuerrechner ↔ Linux-PC stabil > 10 min. === M1 — Win10-PC + Sunrise Workbench === * Win10-PC besorgen, Workbench aus dem Nextcloud installieren. * Robotertyp-Fehlzordnung bei den iiwa 14 beheben, FRI/„External Control“ einrichten (Sunrise OS 1.7, passend zur SI-Doku im Nextcloud). * Grundhaltung: Reflexions-/Mapping-Modus, Speed-Limit 10–20 %, Zonen aktiv. * Abnahme: Roboter fährt sauber hoch, Typ stimmt, X66 in der Workbench stabil. === M2 — Linux-PC mit ROS 2 === * lbr_fri_ros2_stack kompilieren, FRI-Verbindung aufbauen. * Abnahme: FRI „ready“, ''joint_states'' in ROS 2 — Roboter bewegt sich noch **nicht**. === M3 — Hermes-Brücke === * Schlanker FastAPI-/WebSocket-Dienst auf dem Linux-PC mit Aktionen wie ''status'', ''home'', ''move_joint'', ''move_lin'', ''stop'' — Limits serverseitig. * Hermes-seitig Skill/Tool dafür anlegen. * Abnahme: vorbereiteter Waypoint bei 10 % Speed, Not-Au getestet, Mensch am Bedienteil. === M4 — später === * Handführung-Teaching (Drag&Drop) → Posen speichern → Hermes spielt Sequenzen ab; ggf. Kamera. ====== Sicherheitsregeln (nicht verhandelbar) ====== * Vor jedem bewegten Test: Mensch mit Not-Au am Bedienteil, Bereich frei, Speed-Limit an. * Hermes bekommt keine Rohraten-Schnittstelle, nur vordefinierte Aktionen mit Limits. * Bewegungstests nur unter Zwei-Personen-Regel; Roboternetz bleibt vom Vereins-LAN getrennt. ====== Offene Fragen ====== * Welcher Win10-PC wird zweckentfremdet bzw. neu beschafft? * Steuerrechner 4: Netzteil-Reparatur oder Ersatz? * Linux-PC: dedizierter Mini-PC? Geplanter Aufwand: M0 ein Werkstattabend, M1–M3 je 1–2 Abende, M4 offenes Projekt. ---- //Dieser Plan spiegelt den Entwurf aus dem Hermes-Host (''~/plans/kuka-hermes-anbindung.md'').//