Open Source · MIT License

The Stepper-Ninja
Motion Interface

Stepper-Ninja logo

High-performance step generator, quadrature encoder counter, digital I/O, and PWM interface for LinuxCNC — open-source and free.

⚙ Open Configurator 📦 Install Guide 📋 HAL Pins

⚙ Configurator

🚧

The web configurator is currently under construction.

⚙ Go to Configurator
Features

Everything you need for precision motion control in a single compact interface.

Step Generator

Up to 8 channels (pico) or 12 (pico2) at 1 MHz per channel. Pulse width configurable from 60 ns to 6300 ns.

🔄

Quadrature Encoder

Up to 12 high-speed channels with zero-pulse handling, velocity estimation, and spindle-synchronized motion support.

🔌

Digital I/O

Configure free pico GPIO pins as inputs or outputs. Breakout board: 16 isolated inputs, 8 isolated outputs.

📶

PWM Output

Up to 16 GPIOs. 1900 Hz at 16-bit resolution up to 1 MHz at 7-bit. Active-low or active-high selectable.

🌐

UDP Ethernet

Native UDP for W5100S/W5500 modules. Low-latency real-time communication with LinuxCNC.

🖥

SBC / SPI Support

Raspberry Pi 4, Pi Zero 2W and other SBCs via kernel SPI drivers and libgpiod v2.

🔩

Breakout Board v1.0

16 opto-isolated inputs, 8 isolated outputs, 4 differential step generators, 2 encoders, 2 × 12-bit DAC.

🧩

I/O Expander

Up to 64 inputs and 32 outputs with 3 expanders — 24 V optically isolated.

🛡

HAL Driver

LinuxCNC HAL driver, up to 4 instances. Safety: watchdog timeout and data integrity checks.


Supported Configurations

No official breakout board required — a cheap printer-port breakout board works fine.

W5100S-evb-pico UDP Ethernet
W5500-evb-pico
W5100S-evb-pico2
W5500-evb-pico2
pico + W5500 module
pico2 + W5500 module (48 GPIO)
pico + Raspberry Pi 4 (direct SPI)
pico2 + Raspberry Pi 4
pico + Pi Zero 2W (LinuxCNC, RT kernel)
pico2 + Pi Zero 2W
Official Stepper-Ninja breakout board

Documentation

Everything you need to get up and running.


Contributors

Built by the community, for the community.

Code

atrex66, pippin88

Testing

Jimfong1, Griletos

Supporters

Griletos, Cofhal, Sunhapas, milhead2, vanOverload

Known-Ninjas

Griletos, Cofhal, Sunhapas, milhead2, vanOverload, Player


License

Open-source under permissive licenses.

MIT Main codebase and documentation — MIT License.
BSD-3 Quadrature encoder PIO program — BSD-3-Clause by Raspberry Pi (Trading) Ltd.
MIT ioLibrary_Driver — MIT License by Wiznet.