Developer Guide

Dual-Mode Operation

How to use KLSTR.nano and KLSTR.one together — wiring, configuration, and communication between the two modules.

KLSTR.nano acts as a communication bridge between KLSTR.one and the host CPU. This setup requires minimal software effort on the host fixture side because plain RDM+DMX is used as a communication protocol.

When to use dual mode

Dual mode is the right choice when:

  • Your fixture needs Ethernet connectivity (Art-Net/sACN) and compact internal integration
  • You want full RDM support while keeping the fixture’s internal module small
  • The KLSTR.nano is embedded on the fixture PCB

Architecture

Ethernet ──► KLSTR.one ──► DMX_LAN ──► KLSTR.nano ──► Host CPU               │                           │            Art-Net                    DMX decode            sACN                       & control            RDM

The KLSTR.one converts network protocols to DMX. The KLSTR.nano receives this DMX via the DMX_LAN interface and forwards it to the host fixture’s RS485 transceiver. The KLSTR.nano also maintains the external DMX daisy-chain (DMX_IN/DMX_OUT) independently.

Connection blocks

KLSTR.nano — 6 connection blocks

The KLSTR.nano requires 6 connection blocks to work properly when used in dual mode with a KLSTR.one:

  1. DMX IN
  2. DMX OUT
  3. DMX LAN
  4. POWER — Powered via pin 17 with 5V0
  5. KLSTR.one Interface — USB, heartbeat signals, reset signals
  6. Serial Wire Debug

KLSTR.one — 5 connection blocks

The KLSTR.one requires 5 connection blocks to work properly when used in dual mode with a KLSTR.nano:

  1. Ethernet A–B + Ethernet Bypass Relay Circuit
  2. Ethernet C
  3. POWER — Powered via pins 84–89 with 3V3. Bypass relays powered with 5V0.
  4. KLSTR.nano Interface — USB, heartbeat signals, reset signals
  5. Console Port

Wiring

  1. Connect DMX_LAN between the two modules

    KLSTR.oneSignalKLSTR.nano Pin
    DMX LAN A+RS485 A+Pin 23 (DMX_LAN_A)
    DMX LAN B−RS485 B−Pin 22 (DMX_LAN_B)
    GNDGroundPin 21 (GND)
    Route as a 120 Ω differential pair. Keep the connection as short as possible — DMX_LAN has no external line protection.
  2. Connect KLSTR.one/KLSTR.nano interface

    The interface between the two modules includes USB, heartbeat signals, and reset signals:
    SignalKLSTR.nano PinDescription
    Heartbeat KLSTR.onePin 35 (PC2)KLSTR.one alive signal
    Heartbeat KLSTR.nanoPin 32 (PB8)KLSTR.nano alive signal
    Reset KLSTR.nanoPin 34 (NRESET)Active-low reset for KLSTR.nano
    Reset KLSTR.onePin 33 (PB9)Active-low reset for KLSTR.one
    USB_NPin 14USB port negative
    USB_PPin 15USB port positive
  3. Power each module

    • KLSTR.one: 3.3 V DC via pins 84–89. Bypass relays powered with 5V0.
    • KLSTR.nano: Powered via pin 17 with 5V0.
  4. Connect Serial Wire Debug (KLSTR.nano)

    KLSTR.nano PinLabelFunction
    16SWDIOProgramming
    24SWCLKProgramming
    30PB3_SWOProgramming
  5. Connect Console Port (KLSTR.one)

    KLSTR.one PinLabelFunction
    108GNDGround
    109TXD1UART Lite TX Data
    110RXD1UART Lite RX Data

Dual mode connection schematic

Reference board — top view

Reference board — 3D render

Reference board — PCB layout

Configuration

After wiring, provision each module according to its respective guide:

  1. KLSTR.one Provisioning — claim, configure network/protocol settings
  2. KLSTR.nano Provisioning — flash firmware, assign license

In KLSTR.ctrl, the dual-mode pair appears as a single logical device once both modules are online and the heartbeat is active. You can:

  • Configure Art-Net/sACN settings on the KLSTR.one side
  • Monitor DMX forwarding status on the KLSTR.nano side
  • View combined device health (both modules’ firmware, temperature, uptime)

Failover behavior

ScenarioBehavior
KLSTR.one loses powerKLSTR.nano continues operating on the external DMX daisy-chain (DMX_IN → DMX_OUT). Network connectivity is lost.
KLSTR.nano loses powerRelay bypass activates — external daisy-chain continuity is maintained. KLSTR.one continues receiving network data but cannot deliver to the host CPU.
Both lose powerRelay bypass on KLSTR.nano maintains daisy-chain. No active functionality.
Heartbeat timeoutThe surviving module logs a warning. No automatic action — the system continues with reduced functionality.

Next steps

Copyright © 2026