TC3 UnitTest 1.0.0

TC3 UnitTest 1.0.0

First public release of the unit testing and behavior analysis framework for
Beckhoff TwinCAT 3. Library version: 1.0.0.0.

Included

• Reusable Test Cases with optional Preparation and one or more Test States.
• Typed Assertions for values, arrays, text, edges, timing, and behavior across PLC cycles.
• Test Suites and Run Control with lifecycle handling, collection orchestration,
  timeouts, and result aggregation.
• An independent Event Buffer with automatic framework events and a published
  PLC/PC contract for external result collection.
• A complete offline API reference and authoring guides with integration examples.

The separate PLCSIM.UnitTest
application provides a WPF workbench for interactive runs and diagnostics, and
a CLI for automated runs and CI reporting. It is not included in these downloads.

Downloads and installation

File	Purpose
Tc3_UnitTest.4026-1.0.0.0.compiled-library	Normal library installation.
Tc3_UnitTest.4026-1.0.0.0.library	Source-visible alternative for inspection and debugging.
tc3-unittest-help-1.0.0.0.zip	Offline HTML help; extract and open index.html.
release-manifest.json	Public source association, dependency baseline, checksums, and validation scope.
LICENSE.txt	MIT license accompanying the downloads.
SHA256SUMS	SHA-256 checksums for the product downloads, manifest, and license.

Choose one library format for installation through TwinCAT's Library Repository,
then add a reference in the consuming project's Library Manager. Both formats
have the identity Tc3_UnitTest, company Lorenz Software, namespace
Tc3UnitTest, and version 1.0.0.0. The .4026 in the download filename identifies
the target build line; it is not part of the Library Manager title.

Use TwinCAT 3.1 Build 4026. Exact producer dependencies are recorded in the
manifest. Verify effective resolutions in the consumer project. Startup examples
also need the documented direct Tc2_System and task/module references.

Start with the Framework Model
or its copy in the offline help. The GitHub source archives include the development
solution, SelfTests, Runtime composition, tools, and optional authoring skill;
the library downloads contain Framework only.

Verification scope

• Public source baseline: 14b9e7fd60f999ab060ab11d957e790bb6f04a81.
• The native library pair is reused unchanged from the producer build. All 794
  project/source inputs and eight build-tool inputs were reconciled with the
  public baseline, permitting LF/CRLF normalization only. These are not newly
  compiled public-checkout binaries.
• Inherited native evidence uses XAE 3.1.4026.27, Release|TwinCAT OS (x64):
  development and isolated-library rebuild/object checks, both library formats
  in consumers with default and overridden parameters, and bounded runtime smoke.
• Each format passed two starts, reset/readiness, three assertions per start,
  and complete event acknowledgement with no lost events on the local
  Windows Usermode Runtime / x64 target.
• Isolated packaging accepted six documented unused public communication
  declarations; no unexpected blocking diagnostics were recorded. See the
  build workflow.
• The help was regenerated from the clean public baseline and the extracted ZIP
  checked for content integrity and offline browser navigation.

This scope does not qualify other target architectures or runtime configurations,
nor exhaustive assertion boundaries, performance, or load behavior. Native and
runtime checks above are inherited evidence mapped to unchanged inputs; no fresh
PLC build or runtime operation was performed during public release preparation.

License

MIT, copyright 2026 Lorenz Software. See
LICENSE.
TwinCAT and the referenced Beckhoff libraries are separate prerequisites.