---
name: "usbrelay"
section: "1"
platform: "linux"
package: "usbrelay"
version: "1.0-2.2+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/usbrelay"
---

# usbrelay(1)

control or query USB HID relays

## NAME

usbrelay - control or query USB HID relays

## SYNOPSIS

**usbrelay** \[OPTION...\] \[ACTION...\]

## DESCRIPTION

**usbrelay** allows for querying and setting the state of USB HID electrical relays. If no ACTION is passed, the state of all relays is printed to stdout. RELID\_N=\[0\|1\] sets the N-th relay on module RELID to off or on.

Multiple actions can be performed with one command

eg:

usbrelay REL0A\_1=0 REL0A\_2=1 REL0B\_2=0...

The Relay module ID can be changed on DCTTECH relays: RELID\_0=NEWID sets the relay RELID to NEWID

## OPTIONS

- **-d**, **--debug**

  Produce debugging output

- **-q**, **--quiet**

  Suppress output

- **-?**, **--help**

  Print the help menu

- **--usage**

  Print a usage description

- **-V**, **--version**

  Print the program version

## SEE ALSO

/usr/share/doc/usbrelay/README.md.gz