Vollständige Dokumentation

API-Referenzen, Tutorials und Leitfäden: alles, was Sie für den Einstieg und vertiefende Arbeit benötigen.

Was es ist

DevTools ist Zeugwerks Suite von CI/CD-Tools für TwinCAT-Automatisierungssoftware. Manuelle Builds in der IDE skalieren nicht: Ein Projekt kompiliert bei einem Ingenieur und bei einem anderen nicht, eine Regression geht live, weil vor dem Deployment niemand die Tests laufen ließ, oder die Dokumentation läuft dem Code innerhalb eines Monats davon. DevTools bringt gängige Software-Engineering-Praktiken in die SPS-Entwicklung: automatisierte Builds, kontinuierliches Testen, Dokumentation und Backup/Restore.

Passt sich Ihrer Pipeline an

“Wir haben doch schon Jenkins, Azure DevOps oder TeamCity - warum noch ein Anbieter dazu?”

Sie fügen keine Plattform hinzu, sondern einen Schritt. zkbuild-action ist eine GitHub-, GitLab- oder Bitbucket-Action; zkmake ist eine CLI, die Sie aus Ihrer bestehenden Build-Umgebung aufrufen. Ihr Git-Host, Ihre Artefakt-Ablage und Ihre bestehende Pipeline bleiben genau da, wo sie sind.

“Unser SPS-Quellcode soll nicht durch die Cloud eines Dritten laufen.”

Genau dafür gibt es die On-Premises-CLIs. Dasselbe Tool, dieselbe .Zeugwerk/config.json, aber die Binary und Ihr Quellcode verlassen nie Ihr Netz. Starten Sie mit der kostenlosen Cloud-Action an einem Nebenprojekt und wechseln Sie zur lizenzierten CLI, sobald die Netzwerkrichtlinie es verlangt - beide können sogar im selben Projekt nebeneinander laufen, z. B. Cloud-Builds bei Pull Requests und ein On-Premises-Build für das signierte Release-Artefakt.

“Wie bekommen wir das auf jeden Build-Knoten, und wie halten wir es dort aktuell?”

Die On-Premises-CLIs werden über einen privaten Scoop-Bucket installiert und aktualisiert - einmal scoop install zkmake zkdoc pro Knoten, danach scoop update für die aktuelle Version, oder fest auf eine bestimmte Version gepinnt für eine Pipeline, die sich nicht ungefragt ändern soll. Kein manueller Download, keine Zugangsdaten fest in Pipeline-Skripten. Wie wir das gebaut haben →

Cloud oder On-Premises

Jede DevTools-Fähigkeit gibt es als Cloud-Action und - für Build, Dokumentation und Backup/Restore - zusätzlich als lizenzierte On-Premises-CLI:

ToolCloudOn-Premises
Build & Testzkbuild-action - kostenlos für öffentliche Reposzkmake - lizenzierte Windows-CLI, läuft auf Ihren eigenen Jenkins-/Azure-DevOps-/TeamCity-Agents hinter der Firewall
Dokumentationzkdoc-action - kostenlos für öffentliche Reposzkdoc - lizenzierte, plattformübergreifende .NET-CLI für selbst gehostete Pipelines
Bindingszkbindings-action - kostenlos für öffentliche ReposLizenziert für On-Premises-Nutzung - Kontakt aufnehmen
SBOMAutomatisch bei jedem zkbuild-action-Build enthaltenzkmake sbom - in der zkmake-Lizenz enthalten
Backup & Restore-zkdatawrangler - lizenzierte CLI, für Deploy-Skripte, Wartungsroutinen und CI/CD-Pipelines

Kein Aufruf eines TwinCAT-Lizenzservers, kein Quellcode, der Ihr Netz verlassen muss - die On-Premises-CLIs laufen vollständig auf Infrastruktur, die Sie kontrollieren. Lizenzpreise für On-Premises finden Sie unter Preise, oder kontaktieren Sie uns für ein Angebot.

Tools

Automatisierte SPS-Builds und Tests (zkbuild / zkmake)

SPS-Projekte reproduzierbar kompilieren und Unit-Tests ausführen, ohne die TwinCAT-IDE zu öffnen.

  • Reproduzierbare Builds, unabhängig vom lokalen Maschinenzustand
  • TcUnit- oder Framework-Unit-Tests bei jedem Commit ausführen; Build schlägt fehl, wenn Tests fehlschlagen
  • Erzeugt .library-Artefakte, bereit zur Auslieferung
  • Cloud: zkbuild-action für GitHub-, GitLab- und Bitbucket-Pipelines - kein Jenkins, keine Build-Server zu warten
  • On-Premises: zkmake, dieselbe Build-Engine als lizenzierte CLI für Ihre eigenen Build-Agents und Ihr Netz

Ein zkbuild-action-Lauf auf GitHub Actions: Build, TcUnit-Tests und .library-Artefakte, alles grün

SBOM für jeden Build (zkmake sbom)

Für jede ausgelieferte SPS-Library oder -Applikation automatisch eine CycloneDX-1.6-SBOM erzeugen.

  • Listet jedes aufgelöste Twinpack-Paket und jede TwinCAT-/Beckhoff-Systembibliothek, mit Lizenz, Version und einem SHA-256-Hash des ausgelieferten Artefakts
  • Rückverfolgbar bis zum genauen Commit, Branch und Build, aus dem sie entstanden ist
  • Markiert fehlende Lizenz- oder ungelöste Versionsangaben, statt Lücken stillschweigend zu übergehen - nützlich für EU-Cyber-Resilience-Act-Reporting, Sicherheitsfragebögen von Kunden und Schwachstellen-Scans
  • Cloud: automatisch in jedem zkbuild-action-Build enthalten - kein zusätzlicher Schritt
  • On-Premises: zkmake sbom, ein CLI-Aufruf nach zkmake build

API-Dokumentation aus SPS-Quellcode (zkdoc)

HTML-API-Dokumentation aus Ihren SPS-Libraries automatisch generieren.

  • Markdown-Kommentare in Structured Text schreiben
  • Auf GitHub Pages, eigenem Server oder beliebigem HTTP-Host deployen
  • Dieselbe Dokumentations-Engine, die die Zeugwerk-Framework-Docs aufbaut
  • Cloud: zkdoc-action baut und veröffentlicht bei jedem Push zu Ihrem Git-Host
  • On-Premises: zkdoc, eine lizenzierte, plattformübergreifende .NET-CLI für selbst gehostete Pipelines - Einmalkauf, kein Abo

Eine Klassenseite von doc.zeugwerk.dev, vollständig von zkdoc aus Structured-Text-Doc-Kommentaren generiert

Typsichere Bindings für C# und C++ (zkbindings)

Typsicheren Client-Code aus der .tmc-Datei Ihrer SPS generieren.

  • C# - Enums, Structs und Wrapper-Klassen mit Beckhoff.TwinCAT.Ads. SPS-Layout ändern und Ihr C#-Projekt bekommt Compile-Fehler statt Runtime-Failures.
  • C++ - Header und Klassen für Qt oder andere C++-Stacks über QAds.
  • Unit-Tests für den generierten Code inklusive.
  • Versionsvergleich zur Erkennung veralteter Bindings zur Laufzeit.
  • Verfügbar über zkbindings-action in CI, oder lizenziert für On-Premises-Nutzung - Kontakt aufnehmen

Von zkbindings generierte C#-Wrapper-Klasse, die SPS-Equipment (Zylinder, Endschalter, Förderbänder) auf typisierte Properties abbildet

TwinCAT-Runtime-Daten sichern und zurückspielen (zkdatawrangler)

Daten von TwinCAT-Controllern exportieren und importieren - vor einem Update sichern oder vorbereitete Daten bei der Inbetriebnahme laden.

  • Dasselbe Tool wie Creators Backup/Restore, als eigenständige CLI (zkdatawrangler)
  • Skriptbares, wiederholbares Backup/Restore für Deploy-Skripte, Wartungsroutinen und CI/CD-Pipelines
  • Für den gesamten Maschinenpark, nicht nur einen Controller
  • Nur On-Premises, lizenziert - Kontakt aufnehmen · mehr im Blog →

Für wen es gedacht ist

  • Teams, die dieselbe Maschine oder Maschinenfamilie wiederholt ausliefern - und keine Lust mehr auf “kompiliert bei mir”-Überraschungen bei der Inbetriebnahme haben.
  • Teams mit strikter Netzwerk- oder Datenrichtlinie (Verteidigung, Pharma, Automobilzulieferer), die trotzdem CI-Disziplin wollen - automatisierte Builds, Tests und Dokumentation - ohne Quellcode in eine fremde Cloud zu schicken.
  • Teams, die SPS-Daten in C#- oder C++-Anwendungen integrieren - HMI, MES, Datenhistorien - und keine handgeschriebenen ADS-Bindings mehr pflegen wollen, die bei jeder Layoutänderung stillschweigend brechen.
  • Teams, die wegen des EU Cyber Resilience Act, Sicherheitsfragebögen von Kunden oder Audits eine SBOM vorlegen müssen - und keine Tabelle mit jeder SPS-Library, Version und Lizenz von Hand pflegen wollen.
  • Alle, die Updates oder Inbetriebnahmen über einen Maschinenpark hinweg fahren und Runtime-Daten aktuell noch manuell sichern und zurückspielen, Controller für Controller.

Preise

LeistungPreisAbrechnung
Build Service (inkl. Doc Gen)€ 180pro Monat
Statische Code-Analyse (Zusatzmodul)+ € 20pro Monat, Zusatz zum Build Service
Doc Gen CLI€ 4.500einmalig, einzelne Installation
See full pricing →

Kommerzielles Angebot anfragen →


Aus dem Blog