LinuxCNC Documentation
This page is 13% translated. Untranslated text is shown in English.

SYNOPSIS

haltcl [-i <INI file>] [filename]

DESCRIPTION

Tcl is a scripting language from the 90s that is very easy to extend. Haltcl extends the regular Tcl interpreter with a set of commands to interact with HAL, i.e. it allows to manipulate the HAL (Hardware Abstraction Layer) from the command line using a Tcl interpreter. haltcl can optionally read commands from a file (filename), allowing complex HAL configurations to be set up with a single command.

OPTIONS

-i <INI file>

If specified, the INI file is read and used to create Tcl global variable arrays. An array is created for each SECTION of the INI file with elements for each ITEM in the section.

For example, if the INI file contains:
[SECTION_A]
ITEM_1 = 1
[SECTION_A]
ITEM_2 = 2
[SECTION_B]
ITEM_1 = 10
The corresponding Tcl variables are:
SECTION_A(ITEM_1) = 1
SECTION_A(ITEM_2) = 2
SECTION_B(ITEM_1) = 10
-ini <INI file>

Declining usage, use -i <INI file>

filename

If specified, the Tcl commands of filename are executed. If no filename is specified, haltcl opens an interactive session.

COMMANDS

The executable haltcl includes the commands of a Tcl interpreter augmented with commands for the hal language as described for halcmd(1). The augmented commands can be listed with the command:

haltcl: hal --commands+

addf alias delf delsig getp gets initf ptype stype help linkpp linkps linksp list loadrt loadusr lock net newsig save setexact_for_test_suite_only setp sets show source start status stop unalias unlinkp unload unloadrt unloadusr unlock waitusr

Dos de los comandos aumentados, list y gets, requieren un tratamiento especial para evitar conflictos con los comandos internos de Tcl que tengan los mismos nombres. Para usar esos comandos, deben ir precedidos de la palabra clave hal:

hal list
hal gets

REPORTING BUGS

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

halcmd(1), halrun(1)