Dynamic Siemens Language Support

Siemens Language Support

This VS Code extension provides syntax highlighting and language tooling (diagnostics, hover, completion, and go-to-definition) for Siemens SCL / Structured Text projects, plus related TIA export formats.

Bugs/incorrect/missing diagnostics can be reported to danielv@danielv.no - reproducible examples are appreciated.

Features

Syntax highlighting via TextMate grammar for Siemens source files
Table based editor for tag table XML files
FBD block preview from .s7dcl files
Comment toggling and bracket pairing via language configuration
Diagnostics and type checking via the Go language server backend
Hover type information, completion, and go-to-definition (including quoted identifiers)
.s7dcl inlay hints for .s7res titles + navigation from .s7dcl references to .s7res entries
Workspace type scoping via .plc.json roots

FBD block preview Tag table editor S7DCL editor

File associations

Files ending in .scl, .st, .s7res, .s7dcl, .udt, .db, and .awl will be highlighted.

PLC tag-table .xml files are scanned to resolve global symbols and receive dedicated XML diagnostics (for example undefined types, duplicate tag names, and name conflicts).

Settings

siemensLanguageServer.goBinaryPath: absolute path to a custom siemens-lsp backend binary (leave empty to use the bundled binary).

PLC scopes with `.plc.json`

Place a .plc.json file in each PLC project folder to give it an isolated type scope. This keeps types from one PLC from spilling into another when you have multiple PLCs inside one VS Code workspace.
The language server treats the folder containing .plc.json (plus any extra libraries you list) as one scope. Every subdirectory under that PLC root automatically shares the same type index.
Example configuration:

{
	"name": "PackingLine PLC",
	"description": "Main line controller",
	"libraries": [
		"../shared_types",
		"../lib/opc_blocks"
	]
}

libraries paths are resolved relative to the .plc.json file and must exist to be used.
Type lookups never fall back to other PLC roots; each .plc.json keeps its scope isolated.
Editing or adding .plc.json files causes the language server to rescan automatically.

Development

Open this folder in VS Code and press F5 to launch the Extension Development Host.

Releases

To publish the VS Code extension (VS Marketplace + Open VSX) and release plccheck on npm with the same version number, run releases from the repo root:

npm version patch|minor|major
git push --follow-tags

The extension is published to:

On vX.Y.Z tag pushes, GitHub Actions publishes the extension to both registries.

Required GitHub Actions secrets:

VSCE_PAT: Azure DevOps PAT with Marketplace publish permissions.
OPEN_VSX_TOKEN: Open VSX access token for the DynamicEngineering namespace.

Notes:

npm version ... auto-syncs the same version to all npm/plccheck-* platform packages before it creates the git commit + vX.Y.Z tag.
Pushing the tag triggers the Release plccheck (npm) GitHub Actions workflow which publishes plccheck and the platform packages to npm, and publishes the VS Code extension.

Optional: one-shot command to do all of the above:

npm run release:all -- patch

Dynamic Engineering