KRL Helper

KRL Helper is a Visual Studio Code extension providing language support and productivity features for KUKA Robot Language (KRL).

Features

• Syntax highlighting for .src, .dat, and .sub files.
• Separate, configurable syntax-color palettes for dark and light themes.
• Shared function parsing for local and global DEF and DEFFCT declarations.
• Document Outline, function hover, and Go to Definition for project routines and variables.
• Conversion of selected PTP, LIN, SPTP, and SLIN motion blocks into iiQKA-style folds.
• Line comments using ;, including the standard VS Code Toggle Line Comment command and dedicated KRL Helper shortcuts.
• Configurable diagnostics for local variables, global variables, and $IN[...] / $OUT[...] aliases.
• Visibility-aware declaration indexing across module files, public DAT files, $config.dat, and global source declarations.

Installation

Visual Studio Marketplace

After the extension is published, open the Extensions view in Visual Studio Code, search for KRL Helper, and select Install.

Local VSIX

For development or testing, build a VSIX and install it from the command line:

npm ci
npm run package
npx @vscode/vsce package
code --install-extension krl-helper-0.2.0.vsix

You can also use Extensions: Install from VSIX... from the Command Palette.

Usage

Open a .src, .dat, or .sub file. Visual Studio Code automatically selects the KRL language mode.

The Outline view lists supported routine declarations. Hovering a user-defined function call shows its complete declaration, visibility, relative file path, and line number. Go to Definition returns all visible function or variable declarations, with declarations in the current document first.

For example:

DEF TestProgram()
  DECL BOOL bPartDetected
  DECL INT nCounter

  bPartDetected = FALSE
  nCounter = 0
END

Useful commands are available from the Command Palette:

• KRL Helper: Open Settings opens the Dark Colors, Light Colors, and Diagnostics tabs.
• KRL Helper: Toggle Line Comment toggles ; comments on the selected lines.
• KRL Helper: Convert Selection to iiQKA Fold wraps a selected supported motion block in fold metadata.

For fold conversion, select only the motion block. Existing old ;FOLD and ;ENDFOLD lines are not removed automatically: delete those lines manually before selecting and converting the motion block. Tool and base indices are read from the selection where possible, then from the companion DAT file or Global_Points.dat. Display names are read from the nearest workspace $config.dat.

Configuration

krlHighlighting.applyCustomColors enables or disables extension-managed KRL TextMate colors. It defaults to true and preserves unrelated TextMate rules.

The following settings accept CSS-style hexadecimal colors such as #C0C0C0 or #001080:

The color editor stores separate light and dark palettes and switches them with the active VS Code theme.

Diagnostics

The Diagnostics tab and native VS Code Settings expose four array settings:

Each Diagnostics field can be edited at User or Workspace scope. Workspace overrides take precedence; inherited values are marked in the editor. Reset removes only the selected scope's override. Prefixes are trimmed, deduplicated case-insensitively, and matched literally. An empty list disables that check.

Global prefixes are evaluated before local prefixes, so b_Part is global with the defaults even though it also starts with b. A one-character prefix matches only when followed by an uppercase letter, a digit, or _; KRL keywords are excluded from variable diagnostics.

Local declarations are taken from the current .src or .sub, its function parameters, and its same-named companion .dat. Global-prefixed variables are checked only against the global declaration space; a normal local declaration does not satisfy that check. Global declarations come from:

• every declaration in $config.dat;
• DECL GLOBAL lines in another DAT only when that DAT has a case-insensitive DEFDAT <Name> PUBLIC header; and
• explicit global declarations in project .src and .sub files.

The diagnostics check declaration existence and visibility. They do not yet validate whether a prefix agrees with the declared KRL data type.

Function and variable navigation

Function lookup is case-insensitive and supports DEF, GLOBAL DEF, DEFFCT, and GLOBAL DEFFCT. All functions in the current document are visible. From another .src or .sub, explicit global routines and the module entry routine whose name matches the source filename are visible. Other local helper routines remain private. Comments, known KRL built-ins, and unresolved calls produce no navigation result.

Variable Go to Definition prioritizes the same visibility rules as diagnostics: current source declarations and parameters, the same-named companion DAT, $config.dat, public DECL GLOBAL DAT declarations, and explicit global source declarations. If no valid local declaration exists, navigation can still lead to a syntactic GLOBAL <type> declaration in a public DAT so that the visibility error can be inspected and repaired; this does not suppress the diagnostic. Prefix-classified global variables never fall back to a same-named local declaration. For individually opened files below a KRC/R1 tree, navigation infers that tree as the project root. Both project indexes use unsaved open documents and refresh after file, editor, configuration, and workspace changes.

Limitations

KRL Helper does not implement the complete KRL grammar and is not a replacement for the controller compiler, simulation, validation, or safety review.

Syntax recognition, symbol extraction, fold conversion, and diagnostics use heuristic, incrementally developed analysis. Valid code can therefore produce false positives or incomplete results, and invalid code may not be detected. Always validate robot programs with the appropriate engineering and controller tools before use.

Disclaimer

KRL Helper is an independent, unofficial community project.

It is not affiliated with, endorsed by, sponsored by, or maintained by KUKA AG.

KUKA and KUKA Robot Language (KRL) are trademarks or product names of their respective owners.

Support

KRL Helper is maintained as a personal open-source project on a best-effort basis. See SUPPORT.md for support expectations, reporting guidance, and the full project disclaimer.

Contributing

Issues and pull requests are welcome. Please use synthetic examples and do not submit customer, company, machine, production, or other confidential data.

License

KRL Helper is available under the MIT License.

Repository

Source code and issue tracking are available at github.com/MichaeINeumann/krl-helper.