Skip to the content
2 layers100 × 90 mmSolenoid, the printed circuit board in 3D
Size
100 × 90 mm
Copper layers
2
Thickness
1.6 mm
Parts
30
Nets
30
Pads
92
Tracks, vias
245, 3
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
30 Jun 2026
Updated
5 Oct 2026

Overview

Solenoid is an open-source printed circuit board by isrxth, from the isrxth/Octave---Automated-Piano-Playing-Sytem repository on GitHub. It is a 2-layer board of 100 × 90 mm with 30 parts on 30 nets, routed with 245 tracks and 3 vias.

Its parts include 27 connectors, 2 capacitors and 1 IC. It belongs with the ESP32 boards of this library.

README

README.md
🎹 Project Octave
By Team WeBeSyncing
Project Octave is a high-speed, polyphonic, CNC-style robotic piano playing system. Utilizing a multi-microcontroller architecture, ESP-NOW wireless synchronization, and a custom lookahead kinematic engine, Octave translates standard .mid files into precise physical movements, playing an acoustic piano with superhuman speed and accuracy.

https://github.com/user-attachments/assets/f8b78fd2-65e9-428f-8b61-9593326f1c79

✨ Key Features
Polyphonic "Cluster" Engine: Groups simultaneous MIDI notes and calculates a "Center of Gravity" offset, allowing a rigid solenoid block to perfectly strike multiple keys at once.
Anti-Flood Staggering: Automatically spaces out simultaneous polyphonic WebSocket commands by 15ms to prevent Arduino Uno serial buffer overflow and dropped notes.
Lookahead Background Pre-Positioning: The Web UI calculates future moves and silently drives the stepper carriages into position during the natural musical rests, eliminating mechanical latency.
Strict Hardware Interlock: A closed-loop feedback system using ESP-NOW guarantees that solenoids will never fire while the carriage is in transit, completely protecting the 3D-printed mounts from lateral shear forces.
Dynamic Velocity Control: Maps MIDI velocity data to hardware PWM duty cycles, allowing for expressive, dynamic play (Soft vs. Hard strikes), or strict binary toggling.
Asynchronous Web UI: A beautiful, dark-mode TailwindCSS web interface hosted directly on the ESP32. Features live BPM scaling, dynamic clearance tuning, and an interactive virtual keyboard.
Over-The-Air (OTA) Updates: Fully integrated ElegantOTA allows for flashing firmware to the embedded microcontrollers via Wi-Fi without dismantling the piano hardware.
🧠 System Architecture
Octave uses a distributed computing model to ensure non-blocking, real-time performance.
1. The Master Node (ESP32)
Hosts the Web UI (test.html) via ESPAsyncWebServer.
Receives WebSocket commands from the user's browser.
Directly drives the Black Key Solenoids (S1 - S5) via hardware PWM.
Broadcasts MOVE commands to the Stepper Node over ESP-NOW.
Sends Serial commands to the Arduino Uno.
2. The Stepper Node (ESP32)
Listens for ESP-NOW packets and drives two NEMA 17 stepper motors using AccelStepper.
Motor 1 (White Carriage): Uses sliding-window nearest-neighbor logic to traverse the white keys.
Motor 2 (Black Carriage): Uses inverted, octave-locked kinematics to perfectly align with the irregular 2-and-3 black key clusters.
Reads physical limit switches and transmits AT_TARGET packets back to the Master to unlock the software thread.
3. The Strike Node (Arduino Uno)
Receives ultra-fast Serial packets from the Master ESP32 via a logic level shifter.
Manages a non-blocking 40ms ballistic state machine for the 7 White Key Solenoids.
Utilizes a custom 1kHz Software PWM engine for digital pins to maintain a 23% low-current hold state, preventing coil burnout.
🛠️ Hardware Requirements
2x ESP32 Development Boards
1x Arduino Uno R3
2x NEMA 17 Stepper Motors (w/ TMC2209 or A4988 Drivers)
12x 15N Push-Pull Solenoids
3D-Printed Carriages & Solenoid Mounts
12V / 24V Power Supplies & Logic Level Converters (HW-209)
🛜 Changing the Wi-Fi Network Name (SSID)
By default, the Master ESP32 creates a hotspot named POCOF3. Because the Master and Stepper nodes must communicate, their network credentials must match perfectly.
Open solenoid_esp.cpp (Master) and modify:
C++
const char* hotspotSSID = "Project_Octave"; // Your new name
const char* hotspotPassword = "00000000"; // Your new password
Open stepper_esp.cpp (Stepper) and ensure lines 8 & 9 match exactly.
Re-flash both ESP32s.
🚀 Installation & Setup
1. Flash the Firmware
Open the project in PlatformIO or the Arduino IDE.
Install the required libraries: ESPAsyncWebServer, AsyncTCP, AccelStepper, ElegantOTA.
Flash solenoid_esp.cpp and stepper_esp.cpp to your respective ESP32s.
Flash solenoid_uno.ino to your Arduino Uno.
2. Connect to the UI
Power on the Master ESP32.
Connect your computer/tablet to the Octave Wi-Fi hotspot.
Open your web browser and navigate to the ESP32's IP address (default: http://192.168.4.1).
Enter the IP into the Master Control UI and click CONNECT WS.
🎹 Polyphony Limits & Hardware Constraints
While the software fully supports polyphonic MIDI playback, it is bound by the physical laws of the rigid 3D-printed solenoid blocks.
The Span Limit: The system can play multiple notes at the exact same time, but they must physically fit under the 7-solenoid white carriage or the 5-solenoid black carriage. * The Outlier Drop: If a MIDI file demands a C3 and a C5 simultaneously, the carriage cannot stretch. The software's Cluster Engine will calculate a "Center of Gravity" to cover the densest cluster of notes and safely ignore the unreachable outliers to prevent the motors from destroying the mounts.
🎯 Usage & Tuning
Once connected to the UI, you can calibrate Octave to match your specific physical build:
White Home / Black Home: Adjust these steps to perfectly align the 3D-printed carriages over the physical C3 octave. (Note: Black Home uses inverted kinematics, so its home step is a high value like 2400).
Clearance (ms): The mechanical time allowed for the 15N solenoid springs to pull the metal slugs out of the keybed before the stepper motors are allowed to move. Lower this value for faster songs, but ensure the slugs clear the keys to avoid lateral dragging.
Target BPM: The live tempo scaler. You can speed up or slow down a loaded MIDI file in real-time.
📝 License & Credits

Schematics & PCB

Schematic and PCB overview

Schematic detail

PCB detail

Power board schematic

Solenoid board schematic

Stepper board schematic

Developed by Team WeBeSyncing.
Built for the intersection of Embedded Systems, Mechanical Engineering, and Music.

Parts

30
QtyValueFootprintReferences
14Conn_01x02_PinTerminalBlock_Phoenix:TerminalBlock_Phoenix_PT-1,5-2-3.5-H_1x02_P3.50mm_HorizontalJ1, J2, J16, J17, J18, J19, J20, J21, J22, J23, J24, J25, J26, J27
13Conn_01x02_PinConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ3, J4, J5, J6, J7, J8, J9, J10, J11, J12, J13, J14, J15
2C_PolarizedCapacitor_THT:CP_Radial_D10.0mm_P5.00mmC1, C2
1ESP32-DEVKIT-V1ESP32-DEVKIT-V1:MODULE_ESP32_DEVKIT_V1U1

More from isrxth/Octave---Automated-Piano-Playing-Sytem

3
  • 2 layers100 × 90 mmStep, the printed circuit board in 3D

    Step

    isrxth/Octave---Automated-Piano-Playing-Sytem

    18 parts
  • 2 layers67.5 × 72.5 mmPower, the printed circuit board in 3D

    Power

    isrxth/Octave---Automated-Piano-Playing-Sytem

    13 parts

Similar boards

  • 2 layers52.2 × 52.2 mmBase promicro, the printed circuit board in 3D

    Base promicro

    google/mozc-devices

    Circuit diagrams and firmware source code for Gboard DIY keyboards

    30 parts3kApache-2.0
  • 2 layers40.6 × 15.2 mmVr mmm, the printed circuit board in 3D

    Vr mmm

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    30 parts1.2k
  • 2 layers270 × 11 mmDaylight, the printed circuit board in 3D

    Daylight

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    30 parts1.1kGPL-3.0
  • 2 layers65 × 30 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    30 parts1kGPL-3.0
  • 2 layers40.5 × 58 mmInitial v, the printed circuit board in 3D

    Initial v

    tenderlove/initial-v

    It's a BMW shifter converted to a Bluetooth Keyboard that you use with Vim

    30 parts1kApache-2.0
  • 2 layers34.3 × 41.8 mmMotionCubeViewAllForces, the printed circuit board in 3D

    MotionCubeViewAllForces

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    30 parts915
  • 2 layers57.4 × 62 mmPicoWS2812, the printed circuit board in 3D

    PicoWS2812

    ErichStyger/mcuoneclipse

    McuOnEclipse projects and examples

    30 parts765
  • 2 layers52.1 × 46.8 mmFIRE TEST PANEL, the printed circuit board in 3D

    FIRE TEST PANEL

    jrsteensen/OpenHornet

    OpenHornet 1:1 F/A-18C Simulator Repository

    30 parts431

Questions

How big is the Solenoid PCB?

It measures 100 × 90 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Solenoid use?

30 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Solenoid KiCad files?

From the isrxth/Octave---Automated-Piano-Playing-Sytem repository on GitHub, at the commit this page was made from: the board is PCB/solenoid/solenoid.kicad_pcb and its schematic PCB/power/power/power.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Solenoid design in my own project?

Its repository states no licence, so its author keeps all rights: ask isrxth before reusing the design.