Noyito Relay Driver

jumpstarter-driver-noyito-relay provides Jumpstarter power drivers for NOYITO USB relay boards in 1, 2, 4, and 8-channel variants.

Two hardware series are supported:

• NoyitoPowerSerial - 1/2-channel boards using a CH340 USB-to-serial chip (serial port, supports status query)
• NoyitoPowerHID - 4/8-channel "HID Drive-free" boards presenting as a USB HID device (no serial port, supports all-channels status query)

Both use the same 4-byte binary command protocol (A0 + channel + state + checksum).

Installation

:substitutions:
$ pip3 install --extra-index-url {{index_url}} jumpstarter-driver-noyito-relay

If you are using NoyitoPowerHID, the hid Python package requires the native hidapi shared library. Install it for your OS before use:

Configuration

NoyitoPowerSerial (1/2-Channel Serial)

Example configuration controlling both channels independently:

export:
  relay1:
    type: jumpstarter_driver_noyito_relay.driver.NoyitoPowerSerial
    config:
      port: "/dev/ttyUSB0"
      channel: 1
  relay2:
    type: jumpstarter_driver_noyito_relay.driver.NoyitoPowerSerial
    config:
      port: "/dev/ttyUSB0"
      channel: 2

NoyitoPowerHID (4/8-Channel HID)

Example configuration for a 4-channel board (channel 1) and an 8-channel board (all channels simultaneously):

export:
  relay_4ch_ch1:
    type: jumpstarter_driver_noyito_relay.driver.NoyitoPowerHID
    config:
      num_channels: 4
      channel: 1
  relay_8ch_all:
    type: jumpstarter_driver_noyito_relay.driver.NoyitoPowerHID
    config:
      num_channels: 8
      channel: 1
      all_channels: true

Board Detection

To determine which driver to use, check whether the board appears as a serial port or a HID device:

• Serial port (/dev/ttyUSB*, /dev/tty.usbserial-*): Use NoyitoPowerSerial (1/2-channel CH340 board)
• No serial port / HID only: Use NoyitoPowerHID (4/8-channel HID Drive-free board). Confirm with lsusb - the NOYITO HID module appears with VID 0x1409 / PID 0x07D7 (decimal: 5131 / 2007).

Hardware Notes (Serial)

• Purchase: NOYITO 2-Channel USB Relay Module (Amazon)
• Chip: CH340 USB-to-serial
• Baud rate: 9600
• Default port: /dev/ttyUSB0 (Linux) - may appear as /dev/tty.usbserial-* on macOS
• Channels: 1 or 2 independent relay channels on one USB port
• Supply voltage: 5 V via USB

Hardware Notes (HID)

• Purchase (4-channel): NOYITO 4-Channel HID Drive-free USB Relay (Amazon)
• Purchase (8-channel): NOYITO 8-Channel HID Drive-free USB Relay (Amazon)
• Interface: USB HID (no serial port)
• Default VID/PID: 5131 / 2007 (0x1409 / 0x07D7)
• Channels: 4 or 8 independent relay channels
• Supply voltage: 5 V via USB

Usage

Inside a jmp exporter shell:

# Power on relay 1
j relay1 on

# Query state of relay 1
j relay1 status
# on

# Power cycle relay 2 with a 3-second wait
j relay2 cycle --wait 3

# Power off relay 1
j relay1 off

# Power on all 8 channels simultaneously
j relay_8ch_all on

API Reference

.. autoclass:: jumpstarter_driver_noyito_relay.driver.NoyitoPowerSerial()
    :members:

.. autoclass:: jumpstarter_driver_noyito_relay.driver.NoyitoPowerHID()
    :members: