Sapius-Handbuch
Vom Projektordner zum übersetzten Baustein. Alles, was Sie brauchen, um selbstständig loszulegen.
1. Was ist Sapius?
Sapius ist der virtuelle Kollege des SPS-Programmierers: Er liest die Projektunterlagen, schreibt den Code, bringt ihn in die Umgebung des Herstellers, übersetzt, korrigiert die Fehler und bewahrt Ergebnisse und Nachweise auf. Sie beschreiben das Ergebnis; die Entscheidungen bleiben bei Ihnen und sind im Projekt festgehalten. Sie können ihn auch um begründete Vorschläge bitten, zum Beispiel dazu, wie sich die Parameter eines Bausteins organisieren lassen.
Im TIA Portal (V16–V20) arbeitet er an einer geprüften Kopie Ihres Projekts: Er schreibt die Bausteine in SCL, importiert sie, übersetzt und korrigiert, bis null Fehler bleiben. Er legt UDTs, DBs und Variablen an, liest die Hardware aus und bereitet WinCC-HMI-Bilder und -Variablen sowie die Tests mit PLCSIM Advanced vor. Für Rockwell, CODESYS, Schneider und TwinCAT sowie für die HMIs Optix und Weintek erzeugt und bearbeitet er Quellcode und Projektdateien, fertig zum Import in die Umgebung des Herstellers (Kapitel 8).
Für die Diagnose liest er die Werte aus der SPS über S7, Modbus TCP, OPC UA und EtherNet/IP. SPS-Hersteller, Engineering-Umgebung und Protokoll sind getrennte Entscheidungen: Sie treffen sie selbst, Projekt für Projekt.
Jeder Schreibvorgang braucht Ihr Ja oder läuft über den Zustimmungsmodus, den Sie wählen (Kapitel 7). In die CPU lädt Sapius nichts: Das Laden übernehmen Sie selbst aus TIA, wenn Sie mit der Arbeit zufrieden sind.
2. Installation
Voraussetzungen
Sapius läuft unter Windows 10 mit 64 Bit (1809 oder neuer) und unter Windows 11, mit WebView2. Die Agenten-Engine ist im Installer enthalten. Sie brauchen ein Konto auf sapiusportal.it, als Privatkunde oder als Unternehmen, und die KI Ihrer Wahl: Ihr KI-Konto, Ihre eigene kompatible API, die von Sapius verwaltete KI oder die lokale KI auf Ihrem PC. Für TIA Portal: V16–V20 mit Openness, .NET Framework 4.8 und Ihr Windows-Benutzer in der Gruppe Siemens TIA Openness. Für die anderen Hersteller: die Engineering-Software des Herstellers mit ihren Lizenzen.
Sapius installieren
Laden Sie den Installer im Kundenbereich unter Download herunter. Bei einem Update schließen Sie Sapius, bevor Sie den Installer starten: Projekte, Konten und Einstellungen bleiben an ihrem Platz. Das Programm wird nach C:\Program Files\Sapius installiert; sapius können Sie zum PATH hinzufügen. Projekte und Einstellungen liegen unter %LOCALAPPDATA%\SapiusV2 und bleiben bei der Deinstallation erhalten.
Sapius_Setup_<Version>.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
Konto und KI
Melden Sie sich mit E-Mail und Passwort Ihres Sapius-Kontos an. Wenn Sie Ihr ChatGPT-Konto nutzen, klicken Sie auf ChatGPT verbinden und schließen Sie die OpenAI-Anmeldung im Browser ab: Es sind zwei getrennte Anmeldungen. Um das Sapius-Konto zu wechseln, verwenden Sie Abmelden; um das ChatGPT-Konto zu wechseln, trennen Sie es im Kontofenster und verbinden es neu. Die Projekte bleiben auf dem PC.
Updates und Wissen
Sobald ein Update verfügbar ist, erscheint Jetzt aktualisieren: Sapius prüft den Download anhand der veröffentlichten Prüfsumme und startet dann den Installer. Sie können das Update auch verschieben. Beim ersten Start entscheiden Sie, ob Sie zur gemeinsamen technischen Wissensbasis beitragen: Das ist freiwillig, und Sie können es jederzeit in den Einstellungen ändern (Kapitel 6).
Sprache von Sapius
Wählen Sie Italienisch, Englisch, Spanisch, Deutsch oder Französisch über die Sprachschaltfläche oben oder unter Einstellungen → Sprache, auch schon vor der Anmeldung. Die Auswahl bleibt auf diesem PC gespeichert, und beim Wechsel bleiben Entwürfe, Anhänge und laufende Arbeiten erhalten. In neuen Unterhaltungen verwendet der Assistent die gewählte Sprache, sofern Sie nichts anderes verlangen. SPS-Code, Variablennamen, Dokumente und technische Originalmeldungen bleiben, wie sie sind.
Symbole, Spalten und Hilfe
Die Leiste zeigt Symbole mit einer Kurzbeschreibung, sobald Sie mit der Maus darauf zeigen: Protokoll, Handbuch, Sprache, Einstellungen und Abmelden. Das Buch öffnet dieses Handbuch in der gewählten Sprache. Ziehen Sie den Rand zwischen Projekten und Chat oder zwischen Chat und Details, um die Breiten zu ändern; sie werden auf diesem PC gespeichert. Per Tastatur wählen Sie die Trennlinie aus und verwenden die Pfeiltasten; Umschalt vergrößert den Schritt, Pos1 oder ein Doppelklick stellt die Ausgangsbreite wieder her. In schmalen Fenstern passen sich die Bereiche dem verfügbaren Platz an.
Für ein neues Projekt verwenden Sie das + neben Projekte (Neues Projekt), tragen Name, Kunde und Revision ein und bestätigen. Die große Schaltfläche oben erstellt dagegen, bei geöffnetem Projekt, eine neue Unterhaltung. Sie können Sapius fragen, wie das Programm bedient wird: Er kennt die Anleitung der installierten Version und erklärt Ihnen die Schritte.
3. Testphase, Preise und Lizenzen
Die 7-Tage-Testphase
Sieben Tage mit einem Projekt, inklusive Officina, ohne Kreditkarte. Legen Sie das Konto an, als Privatkunde oder als Unternehmen, bestätigen Sie Ihre E-Mail-Adresse und akzeptieren Sie die Verkaufsbedingungen mit dem Code, den Sie per E-Mail erhalten (sechs Ziffern, 15 Minuten gültig). In Sapius klicken Sie auf 7-tägige Testversion aktivieren oder verwenden /prova. In der Testphase nutzen Sie Ihr KI-Konto, Ihre eigene kompatible API oder die lokale KI.
Jedes Konto und jeder PC hat Anspruch auf eine Testphase. Nach Ablauf gibt es keine automatische Abbuchung: Ihre Projekte bleiben auf dem PC. Zum Weiterarbeiten schließen Sie das Abonnement ab, wann Sie möchten.
Der Preis
| Sapius, pro Arbeitsplatz | Erster Monat | Ab dem zweiten Monat |
|---|---|---|
| Unternehmen und Freiberufler | 149 € zzgl. MwSt. | 299 € zzgl. MwSt. pro Monat |
| Privatkunden in Italien | 181,78 € inkl. MwSt. | 364,78 € inkl. MwSt. pro Monat |
Der Aktionspreis für den ersten Monat gilt bei der ersten bezahlten Aktivierung des Kontos. Das Abonnement umfasst alle Sapius-Werkzeuge, Officina, die Updates und 10 € KI-Guthaben für jeden bezahlten Monat und Arbeitsplatz. Ihr eigenes Konto, Ihre eigene API oder die lokale KI können Sie jederzeit nutzen. Software und Lizenzen der Hersteller erwerben Sie beim jeweiligen Hersteller.
Kauf und Verlängerung
Öffnen Sie im Kundenbereich Acquisti (Käufe), wählen Sie Sapius und bezahlen Sie über Stripe: Die Übersicht zeigt Betrag und Mehrwertsteuer gemäß Ihren Rechnungsdaten. Sobald die Zahlung bestätigt ist, finden Sie die Lizenz auf der Seite Lizenzen. Unter Abonnements und Rechnungen finden Sie die Dokumente und die Kontoverwaltung.
Das Abonnement verlängert sich jeden Monat. Sie kündigen jederzeit im Kundenbereich, und es bleibt bis zum Ende des bezahlten Zeitraums aktiv. In der Zahlungsverwaltung aktualisieren Sie die Zahlungsmethode. Die elektronische Rechnung wird separat über das italienische SDI übermittelt. Wenn Sie als Privatkunde kaufen, haben Sie 14 Tage Zeit für den Widerruf: Die Schaltfläche finden Sie auf der Seite Acquisti, das Formular auf der Seite Widerrufsformular.
Arbeitsplatzlizenz
Das Kontofenster und /licenza zeigen den 24-stelligen Maschinencode. Auf der Seite Lizenzen im Kundenbereich fügen Sie den Code ein, aktivieren den Arbeitsplatz und laden die Datei .licenza herunter; anschließend laden Sie sie in Sapius über das Kontofenster (Lizenz laden) oder mit /licenza <file> im Terminal.
Der Code identifiziert den PC: Er leitet sich von der Hauptplatine oder von der Windows-Installation ab, deshalb läuft Sapius auch in einer virtuellen Maschine. Wenn Sie Windows neu installieren, heben Sie die alte Aktivierung auf der Seite Lizenzen auf und aktivieren den neuen Code. Bei mehreren geklonten virtuellen Maschinen geben Sie jeder ihre eigene Windows-Installation, bevor Sie sie aktivieren.
Sie können die Lizenz bis zu dreimal in 12 Monaten auf einen anderen PC übertragen; das erneute Herunterladen derselben Lizenz zählt nicht als Übertragung. Ihre Projekte bleiben immer auf dem PC.
4. KI, Guthaben und Budget
Vier Wege, die KI zu nutzen
- Ihr KI-Konto: Sie verbinden ChatGPT und arbeiten mit den Modellen aus Ihrem Katalog.
- Ihre eigene kompatible API: Sie geben Modell und Endpunkt an und arbeiten mit Ihrem Anbieter.
- Von Sapius verwaltete KI: Sie nutzen das im Abonnement enthaltene Guthaben und die Aufladungen; Modelle und Tarife stehen im Katalog.
- Lokale KI: Das Modell arbeitet auf Ihrem PC und verbraucht weder API-Aufrufe noch Guthaben.
Die Sapius-Werkzeuge sind in allen vier Fällen dieselben. Die Wahl gilt für neue Unterhaltungen: Bereits geöffnete behalten Modell, Verbindung und Abrechnungsprofil.
Mit eigenem Konto oder eigener API gehen die für die Arbeit nötigen Inhalte an den Anbieter, den Sie gewählt haben. Bei der von Sapius verwalteten KI laufen sie über das Sapius-Gateway zu dem im Katalog genannten Anbieter. Mit der lokalen KI werden sie auf Ihrem PC verarbeitet. Die gemeinsame Wissensbasis ist etwas anderes: Die Zustimmung zu den technischen Hinweisen betrifft weder Chats noch Projekte. Beachten Sie die Datenschutzerklärung und die Bedingungen.
KI einrichten
- Öffnen Sie Einstellungen → KI und Verbrauch.
- Wählen Sie Ihr ChatGPT-Konto, Ihre eigene API, die von Sapius verwaltete KI oder die lokale KI.
- Bei der von Sapius verwalteten KI wählen Sie ein Modell aus dem Katalog und das maximale Budget in Euro für die Arbeit. Für Ihre eigene API geben Sie das Modell, den kompatiblen Responses-Endpunkt und den Namen der Umgebungsvariablen an, die den Schlüssel enthält: Das Geheimnis bleibt außerhalb von Sapius. Ein lokaler Endpunkt ohne Authentifizierung kommt ohne die Variable aus.
- Im Portal öffnen Sie KI und Guthaben und sehen dort Verfügbarkeit, enthaltenes und gekauftes Guthaben, Reservierungen, Buchungen und Tarife.
Für neue Unterhaltungen mit der von Sapius verwalteten KI oder mit einer kompatiblen API wird GPT 6.1 Sol (gpt-6.1-sol) empfohlen, mit den fünf Intensitätsstufen low, medium, high, xhigh und max. Mit Ihrem eigenen Konto finden Sie die Modelle aus dessen Katalog.
Guthaben, Aufladungen und Budget
Jeder bezahlte Monat enthält 10 € KI-Guthaben pro Arbeitsplatz, nutzbar innerhalb des im Portal angegebenen Zeitraums. Die optionalen Aufladungen gibt es zu 20, 50 und 100 € zzgl. MwSt. (für Privatkunden in Italien 24,40 €, 61,00 € und 122,00 € inkl. MwSt.): Sie verlängern sich nicht automatisch und bleiben auch beim Monatswechsel verfügbar. Vor der Zahlung zeigt Stripe den Gesamtbetrag. Die Tarife je Modell stehen auf der Seite KI und Guthaben, getrennt nach Eingabe, Cache und Ausgabe; abgerechnet wird der tatsächliche Verbrauch.
Ist das Guthaben oder das Budget ausgeschöpft, pausiert die Arbeit, und die Ergebnisse bleiben erhalten: Sie entscheiden, ob Sie das Limit anheben, aufladen oder die KI-Verbindung wechseln. Keine Aufladung und kein Modellwechsel startet von selbst. Um das Limit einer bereits geöffneten Unterhaltung zu ändern, klicken Sie auf die Budget-Schaltfläche neben der Intensität, wenn die Arbeit pausiert oder abgeschlossen ist: Das neue Limit schließt den bisherigen Verbrauch ein.
Lokale KI
Öffnen Sie KI-Einstellungen → Lokale KI installieren → Installieren und starten und wählen Sie dann die lokale KI für eine neue Unterhaltung. Erforderlich sind Windows x64, mindestens 16 GB installierter RAM, 8 GB freier RAM und 8 GB freier Speicherplatz. Das Modell, etwa 2,76 GB, wird beim ersten Start heruntergeladen und läuft auf der CPU Ihres PCs.
5. Das erste Projekt
Projekt anlegen
Klicken Sie auf Neues Projekt, geben Sie Name, Kunde und Revision an und öffnen Sie eine Unterhaltung. Beschreiben Sie Ziel und Randbedingungen der Arbeit. Wählen Sie das Engineering-Profil des Projekts: Siemens, Rockwell, Schneider Machine Expert oder Control Expert, CODESYS oder Beckhoff.
Ordner wählen
Öffnen Sie die drei Punkte neben dem Projekttitel und dann Projektordner. Sie durchsuchen die Ordner des PCs, ohne den Pfad einzutippen. Bestätigen Sie die Revision; mit Aktualisieren importieren Sie die geänderten Dateien. Die übernommenen Dateien werden mit Quelle und Revision in das Sapius-Projekt kopiert.
Dokumente als Quellen importieren
Über dieselben drei Punkte öffnen Sie Quellen → Importieren. Wählen Sie in der gewohnten Dateiauswahl eine oder mehrere Dateien und öffnen Sie sie. Sapius verwendet die aktuelle Revision des Projekts, meldet für jede Datei ein Ergebnis und erkennt bereits übernommene Dateien, ohne Quellen doppelt anzulegen.
Die Quellen bleiben mit Herkunft und Revision im Projekt und stehen in allen Unterhaltungen des Projekts zur Verfügung, auch nach einem Neustart. Sie sind etwas anderes als die Nachrichtenanhänge, die Sie mit dem + im Eingabefeld hinzufügen.
Sie können bis zu 20 MB pro Datei importieren: PDF, Word .docx, Excel .xlsx/.xlsm, Markdown, CSV, XML, JSON, Text und SPS-Quellcode. Die Zusammenfassung zeigt das Ergebnis Datei für Datei. Für ein gescanntes PDF bereiten Sie eine Fassung mit auswählbarem Text vor: Das Original bewahrt Sapius in jedem Fall bei den Quellen auf.
SPS / Kommunikation
Öffnen Sie im Projektfenster PLC / Kommunikation. Wählen Sie Hersteller oder Umgebung, Familie oder Modell und das Protokoll. Im zweiten Schritt stellen Sie die Parameter ein: S7 verwendet Host, Port, Rack und Slot; Modbus TCP Unit ID, Adressbasis und Wortreihenfolge; OPC UA URL und Sicherheit; EtherNet/IP CIP-Familie und Pfad. Bestätigen speichert die Konfiguration für die nächsten Starts; Abbrechen lässt alles, wie es war.
Die Engineering-Verbindung zum Projekt und die Kommunikation mit der SPS haben getrennte Zustände: Sie wechseln den Hersteller, ohne das Protokoll anzufassen, und umgekehrt.
Kommunikation testen
Klicken Sie auf Test für eine sofortige Prüfung. Bei S7 wird die Protokollaushandlung geprüft. Für Modbus TCP, OPC UA und EtherNet/IP geben Sie die Adresse oder die Variable und den zu lesenden Datentyp an. Der Test liest nur: kein geschriebener Wert, kein Befehl an die CPU. Nach dem Ergebnis klicken Sie auf Bestätigen, um die Konfiguration zu speichern.
OPC UA behält die Zertifikatsprüfungen bei; das Formular konfiguriert den anonymen Zugang.
6. Mit dem Agenten arbeiten
Unterhaltungen und Fenster
Beschreiben Sie das gewünschte Ergebnis, hängen Sie die Quellen mit + an und überlassen Sie dem Agenten den Zyklus aus Lesen, Ändern und Prüfen. In der Leiste wählen Sie die Arbeitsintensität. Das Protokoll zeigt die Aktivitäten; Schließen oder Esc schließt die Fenster wieder. Über Abmelden wechseln Sie das Konto.
Während Sapius arbeitet, zeigt der Chat Fortschrittsmeldungen und Aktivitäten mit Symbolen und aufklappbaren Details, getrennt von der abschließenden Antwort, sowie den Plan, sobald die Engine ihn meldet. Die Ansicht folgt der Arbeit, solange Sie nahe am unteren Rand sind; scrollen Sie zum Lesen nach oben, bleibt Ihre Position erhalten, und Neueste Aktualisierungen bringt Sie zurück zum aktuellen Stand. Die abschließende Antwort nutzt Markdown für Listen, Code und Links.
Eingabe sendet die Nachricht; Shift+Eingabe (Umschalt+Eingabe) fügt einen Zeilenumbruch ein. Auch Strg+Eingabe sendet. Arbeitet der Agent gerade, kommt die Nachricht in die Warteschlange, wie unten beschrieben; Stop ist der separate Befehl, um den Durchgang anzuhalten.
Zum Anhängen verwenden Sie +, ziehen eine Datei in das Eingabefeld oder fügen einen Screenshot ein. Jeder Anhang darf bis zu 25 MB groß sein. Warten Sie mit dem Senden, bis der Upload abgeschlossen ist; mit dem Kreuz an seiner Karte entfernen Sie einen Anhang aus der nächsten Nachricht.
Ein Klick auf einen Anhang oder ein Artefakt öffnet die Vorschau: Bilder und PDFs werden im Vorschaubereich angezeigt, Texte und Quellcode, auch Markdown, lesen Sie als Text. Andere Formate öffnen Sie aus dem Projektordner. Sie können den Bereich verbreitern, seinen Rand ziehen oder ihn schließen; in schmalen Fenstern öffnet er sich über dem Chat und lässt sich auch mit Esc schließen.
Über die Schaltfläche i öffnen Sie die Informationen und Darstellung. Dort wählen Sie das Farbschema: hell, dunkel oder wie Windows. Die Wahl bleibt auf dem Arbeitsplatz gespeichert. Das Menü ··· neben dem Projekttitel öffnet die Projektoptionen, den Ordner und die SPS-Kommunikation.
Warteschlange und Umleiten
Sie können weitere Nachrichten senden, während der Agent arbeitet: Sie bleiben in der Warteschlange der Unterhaltung und werden der Reihe nach verarbeitet. Umleiten gibt die Präzisierung an den laufenden Durchgang weiter, ohne ihn neu zu starten: Damit korrigieren Sie eine Annahme oder ergänzen eine Randbedingung. Die Berechtigungen bleiben so, wie Sie sie gewählt haben.
Nach einem Stop, einem Fehler oder einem Neustart bleibt die Warteschlange pausiert und steht Ihnen zur Verfügung: Prüfen Sie sie und setzen Sie fort. Ein Versand mit ungewissem Ergebnis wird nicht von selbst wiederholt: Das entscheiden Sie.
Ergebnisse und Projektgedächtnis
Artefakte, Fakten mit ihrer Quelle, Entscheidungen und offene Fragen bleiben im Projekt. Ein vorgeschlagener Quellcode, ein übersetzter Baustein, ein Test in der Simulation und eine Prüfung an der Anlage sind verschiedene Ergebnisse, und Sapius hält sie auseinander: Verlangen Sie zusammen mit der Datei immer das Übersetzungsergebnis und die durchgeführten Tests.
Der Agent kann die Organisation der Parameter-DBs, die Bausteinaufrufe, die Diagnose oder einen zum Kontext passenden Test vorschlagen. Maßgeblich bleiben die Entscheidungen, die Sie bereits getroffen haben.
Gemeinsame Wissensbasis
Beim ersten Start oder in den Einstellungen können Sie dem Teilen strukturierter allgemeiner technischer Hinweise zustimmen. Bei aktiver Zustimmung sendet Sapius sie zur Prüfung an den Verantwortlichen, der über die Veröffentlichung entscheidet. Chats, Dokumente, Quellcode und Projektdaten bleiben außen vor.
Freitextentwürfe brauchen jedes Mal Ihre Bestätigung. Die Zustimmung können Sie in den Einstellungen jederzeit widerrufen. Persönliche Vorlieben, Projektfakten und geteilte Erkenntnisse bleiben drei getrennte Speicher.
Nach einer Korrektur verknüpft Sapius Fehler, Änderung und erfolgreiche Prüfung und hält Symptom, vermutete Ursache, Lösung und Anwendungsbedingungen fest. Die Suche erkennt auch italienische und englische technische Synonyme, und die Rückmeldungen zur Wiederverwendung helfen, die Erkenntnisse zu bewerten.
7. Berechtigungen, Alles-Modus und Officina
Die Zustimmung im Dienst
Der Dienst prüft die Berechtigungen in dem Moment, in dem er das Werkzeug ausführt: Sie entscheiden, und nur Sie. Analyse, Schreiben von Dateien, Offline-Engineering, Importe ins Projekt und Lesezugriffe auf die SPS sind getrennte Vorgänge, und jeder behält Parameter, Ergebnis und Herkunft.
Modus wählen
- Manuell: fragt für jeden Vorgang, der über die reine Analyse hinausgeht, nach Ihrer Zustimmung.
- Dateiänderungen: erlaubt Arbeitsdateien, Offline-Engineering und lokale Befehle; fragt bei den weitergehenden Klassen nach.
- Automatisch: umfasst zusätzlich die Lesezugriffe auf die SPS am angegebenen Ziel.
- Alles: umfasst die TIA-Importe in die Arbeitskopie, einschließlich FBs, FCs, neuer DBs, UDTs und Main, ohne einen Klick je Baustein. Der Dienst hält die Zustimmung für jeden Versuch und jeden Inhalt fest.
- Officina: Eine Zustimmung für einen FB oder FC deckt die Korrekturen an diesem Baustein acht Stunden lang ab, in derselben Kopie und CPU; die anderen Bausteine folgen ihrer eigenen Freigabe.
Kopien, Prüfungen und Fortsetzung
Der Alles-Modus arbeitet an der Kopie: Das Original bleibt, wie es ist, und das Laden und die Bedienhandlungen an der SPS bleiben in Ihrer Hand. Die Prüfungen der Kopie, die Archive und die Schutzmaßnahmen bleiben aktiv. Der Austausch eines bestehenden DBs folgt einem eigenen Weg: Analyse, isolierte Kopie, Übersetzung und Prüfung.
Wird eine Zustimmung angefragt, prüfen Sie Ziel und Parameter. Auch eine Ablehnung wird festgehalten. Bei der Fortsetzung wartet ein Vorgang mit ungewissem Ergebnis auf Ihre Entscheidung. Lokale Befehle können Dateien und Ressourcen des PCs nutzen: Wählen Sie den Modus passend zu der Arbeit, die Sie übergeben möchten.
8. TIA Portal und weitere Umgebungen
TIA vorbereiten und verbinden
Stellen Sie die TIA-Version und den Ordner für die Arbeitskopien ein. Der Agent erstellt die Kopie durch Archivieren und erneutes Öffnen und identifiziert dann Sitzung und Pfad, bevor er sich verbindet. Verwenden Sie die Version des Projekts: So vermeiden Sie ungewollte Konvertierungen. Zeigt TIA die Openness-Zugriffsabfrage an, bestätigen Sie sie in der Siemens-Anwendung; nach einem Update kann TIA erneut danach fragen.
Programm und Hardware
Sapius untersucht CPUs, Bausteine, Variablentabellen und Hardwarekonfiguration und arbeitet an der Kopie. Er schreibt und importiert SCL und SimaticML, organisiert FBs, FCs, DBs und UDTs, ruft die Arbeit im Main auf, übersetzt, liest die Fehler, korrigiert und speichert, bis null Fehler bleiben. Vor dem Hinzufügen eines Moduls prüft er Katalog, Kompatibilität und die vorhandene Konfiguration.
Im Alles-Modus läuft der Zyklus mit der Zustimmung weiter, die Sie für die Kopie bereits gegeben haben. Bei bestehenden DBs analysiert Sapius die Auswirkungen, erprobt den Austausch an einer isolierten Kopie und bewahrt die Nachweise auf, bevor der Austausch übernommen wird. Know-how-geschützte Bausteine und das Sicherheitsprogramm bleiben, wie sie sind.
WinCC und PLCSIM
Die WinCC-HMI-Werkzeuge arbeiten in TIA an Bildern, Variablen und Textlisten, immer an der Kopie; Vorlagen lassen sich erfassen und exportieren. Nutzt das Panel eine integrierte Verbindung, finden Sie sie in den Variablen, auch wenn die Liste Connections leer ist: Eine weitere anzulegen ist nicht nötig. Mit PLCSIM Advanced testet Sapius das Programm in einer eigenen Simulationsinstanz, getrennt von Ihrer Arbeitssitzung.
Die Übergabe unterscheidet die Übersetzung von SPS-Software, Hardware und HMI. Nach dem Vergleich der Exporte speichert Sapius und kann ein vollständiges Projektarchiv mit Größe und SHA-256 erstellen.
Weitere SPS und HMIs
| Umgebung | Was Sapius macht und wie Sie weitermachen |
|---|---|
| Rockwell / Studio 5000 | Liest L5X-Exporte, erstellt daraus ein Inventar und erzeugt oder bearbeitet ST-Routinen, Tags und Datentypen in einer Kopie. Sie importieren die Datei in Studio 5000 und übersetzen dort. |
| CODESYS / Schneider Machine Expert | Erzeugt ST-Quellcode und Visualisierungen (Visualization XML) aus einer Spezifikation, mit einem Katalog von neun Komponenten, und liest die Exporte. Sie importieren die Dateien in Ihre CODESYS- oder Machine-Expert-IDE. |
| Schneider Control Expert | Erzeugt und validiert ST-Sektionen .XST und neue Variablen .XSY, auf Wunsch mit einem Export Ihres Projekts als Vorlage. In Control Expert importieren Sie zuerst die Variablen und dann die Sektion, analysieren und übersetzen; meldet die IDE Fehler, geben Sie sie an Sapius zurück, und er korrigiert sie. |
| Beckhoff TwinCAT | Liest SPS-Projekte und -Objekte und bearbeitet die ST-POUs in einer Kopie, mit Archiv. Sie öffnen die Kopie in XAE, um zu übersetzen und zu aktivieren. |
| Weintek EasyBuilder Pro | Erzeugt die CSV-Dateien der Tags und die typisierten GetData/SetData-Makros aus einer Spezifikation, fertig zum Import in EasyBuilder Pro. |
| FactoryTalk Optix | Erzeugt C#-NetLogic und YAML-Knoten für Panels, Variablen und Widgets, auch in einer Kopie des Projekts. Sie öffnen das Projekt in FactoryTalk Optix und rufen die Methode Build auf. |
Für jeden Hersteller prüft Sapius das Format der Dateien, die er erzeugt, und arbeitet immer an Kopien: Das Original bleibt, wie es ist. Zum Importieren und Übersetzen verwenden Sie die Software des Herstellers mit ihren Lizenzen.
Arbeit abschließen
Verlangen Sie eine Übergabe mit Dateien, Übersetzungsergebnis, Tests und offenen Punkten. Über die Übernahme ins endgültige Projekt und in die SPS entscheiden Sie: Sie kopieren den Baustein in TIA von einem Projekt ins andere oder importieren den Quellcode, der bei den Dateien des Projekts bleibt.
9. Das Terminal
Starten Sie sapius; sapius --aiuto listet die Optionen auf. Das Terminal teilt Projekte, Quellen und Kontrollen mit dem Fenster. Hier nutzt der Agent Ihre eigene API: Den Schlüssel übergeben Sie mit OPENAI_API_KEY oder ANTHROPIC_API_KEY.
/progetti, /nuovo, /conversazioni, /nuova, /fonti und /importa verwalten die Arbeit. /costruttore wählt das Engineering-Profil. /plc zeigt die Kommunikation; /plc configura file.json speichert sie, /plc test file.json [indirizzo tipo] führt einen Test aus und /plc rimuovi entfernt sie. /cpu bleibt für S7 verfügbar.
/accedi esci meldet das Konto ab; /licenza, /prova, /aggiornamenti, /registro, /riprendi und /aiuto ergänzen die wichtigsten Befehle. Wird eine Zustimmung angefragt, braucht es Ihre ausdrückliche Antwort: Das Terminal zu schließen gilt nicht als Ja.
10. Wenn es einmal hakt
Anmeldung, Kontingent und Update
Prüfen Sie zuerst, welches Sapius-Konto und welches KI-Konto verbunden sind. Ist das Kontingent Ihres OpenAI-Kontos aufgebraucht, sehen Sie in Ihrem OpenAI-Konto nach oder wechseln Sie in den Einstellungen zu einer anderen KI-Verbindung. Fehlt die Lizenz, aktivieren Sie sie im Kundenbereich. Erscheint ein Update nicht, prüfen Sie die Verbindung und starten Sie die Updatesuche.
SPS- oder TIA-Verbindung
Prüfen Sie Hersteller, Protokoll, Ziel und Parameter. Bei S7 prüfen Sie Rack, Slot und die Zugriffseinstellungen: PUT/GET und DBs mit Standardzugriff sind für die S7-Lesezugriffe nötig. Bei den anderen Protokollen prüfen Sie Testadresse, Datentyp und Sicherheitseinstellungen. Bei TIA prüfen Sie Version, Openness-Gruppe und wartende Dialoge.
Arbeit fortsetzen
Schließen Sie die Fenster mit Schließen oder Esc. Nach einem Stop öffnen Sie die Unterhaltung wieder, prüfen die Warteschlange und setzen fort. Bei einem Vorgang mit ungewissem Ergebnis sehen Sie im Protokoll und am Ziel nach und entscheiden dann, ob Sie ihn wiederholen. Wenn Sie Unterstützung brauchen, schreiben Sie an support@sapiusportal.it: Es antwortet Ihnen ein SPS-Programmierer.
11. Glossar
Projekt: eine Aufgabe mit ihren Quellen, Revisionen und Entscheidungen. Artefakt: erzeugte und aufbewahrte Datei. Arbeitskopie: die Kopie des Projekts, in die Sapius schreibt. Protokoll: Kommunikation mit dem Gerät, unabhängig von der IDE gewählt. Messwert: aus der SPS gelesener Wert mit Qualität, Zeitpunkt und Herkunft. Übersetzt: vom Compiler angenommen. Simuliert: in einer Simulationsumgebung ausgeführt. Im Feld geprüft: an der Anlage kontrolliert, mit Nachweisen. Officina: Modus, in dem eine Zustimmung die Korrekturen am selben Baustein acht Stunden lang abdeckt. Von Sapius verwaltete KI: von Sapius bereitgestellte KI, über Guthaben abgerechnet.
SAPIUS