---
name: "sim_pin"
section: "1"
platform: "linux"
package: "linuxcnc-uspace"
version: "1:2.9.4-2+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sim_pin"
---

# sim\_pin(1)

GUI for displaying and setting one or more HAL inputs

## NAME

**sim\_pin** - GUI for displaying and setting one or more HAL inputs

## SYNOPSIS

**sim\_pin *\[Options\]* *name1* \[*name2* \[*name3* ...\]\]**

*Options*:\
   **--help** (shows help text)\
   **--title title\_string**

For bit items, the name may include a /mode= specifier:\
     *namei***/mode=**\[**pulse** \| **toggle** \| **hold**\]\
     (default is toggle)

## DESCRIPTION

HAL boolean items (bit) and numerical items (u32, s32, float) are supported.

If the named input is a numerical type, the GUI displays:

   **Entry**  Entry widget for value or a valid Tcl expression.\
\
    **Set**    Pushbutton to set new value from Entry (or use \<RETURN\>)\
\
    **Reset**  Pushbutton to reset to the value present on initiation

If the input is a **bit** type, the GUI shows a single pushbutton that is controlled by radio-button selectors:

   mode=**pulse**   Pulse input to 1 for each pushbutton press\
\
    mode=**toggle**  Toggle input for each pushbutton press\
\
    mode=**hold**    Set input to 1 while pushbutton pressed

If the bit item mode begins with an uppercase letter, the radio buttons for selecting other modes are not shown

## NOTE

LinuxCNC or a standalone HAL application must be running

A named item can specify a **pin**, **param**, or **signal**. The named item must be writable:

  **pin    IN or I/O** (and not connected to a signal with a writer)\
\
   **param  RW**\
\
   **signal connected to a writable pin**

## USAGE

**sim\_pin** can be used interactively from a shell command line or started automatically from a configuration INI file.

## EXAMPLE

Example for INI file usage:

   \[APPLICATIONS\]\
    DELAY = 5\
    APP = **sim\_pin** \\\
\
           halui.machine.off/mode=pulse \\\
\
           ini.traj\_arc\_blend\_enable \\\
\
           motion-command-handler-tmax