

- 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






Developed by Team WeBeSyncing.
Built for the intersection of Embedded Systems, Mechanical Engineering, and Music.
Parts
30| Qty | Value | Footprint | References |
|---|---|---|---|
| 14 | Conn_01x02_Pin | TerminalBlock_Phoenix:TerminalBlock_Phoenix_PT-1,5-2-3.5-H_1x02_P3.50mm_Horizontal | J1, J2, J16, J17, J18, J19, J20, J21, J22, J23, J24, J25, J26, J27 |
| 13 | Conn_01x02_Pin | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J3, J4, J5, J6, J7, J8, J9, J10, J11, J12, J13, J14, J15 |
| 2 | C_Polarized | Capacitor_THT:CP_Radial_D10.0mm_P5.00mm | C1, C2 |
| 1 | ESP32-DEVKIT-V1 | ESP32-DEVKIT-V1:MODULE_ESP32_DEVKIT_V1 | U1 |
More from isrxth/Octave---Automated-Piano-Playing-Sytem
3Similar boards
- 2 layers52.2 × 52.2 mm

Base promicro
google/mozc-devices
Circuit diagrams and firmware source code for Gboard DIY keyboards
30 parts3kApache-2.0 - 2 layers40.6 × 15.2 mm

- 2 layers270 × 11 mm

Daylight
VoronDesign/Voron-Hardware
Cool Hardware designed by the Voron Design group
30 parts1.1kGPL-3.0 - 2 layers65 × 30 mm

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 mm

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 mm

MotionCubeViewAllForces
hackclub/OnBoard
💡 Join 1,000 teenagers and make your first PCB with a $100 grant!
30 parts915 - 2 layers57.4 × 62 mm

- 2 layers52.1 × 46.8 mm

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.

