Disclaimer: This is an independent resource site.
Not affiliated with the Voron project or its development team.
<article class="guide-article">
<header>
<h1>Voron Klipper Pin Reference</h1>
<p class="lead">Complete pin mapping reference for the most common Voron controller boards used in builds and upgrades.</p>
</header>
<section>
<h2>Using This Reference</h2>
<p>
This guide provides pin assignments for the most popular Voron control boards: BTT Octopus v1.1, SKR v1.4 Turbo, Fysetc Spider v2.2, and BTT Manta M8P. Use these tables when wiring your Voron or when converting printer.cfg between board types.
</p>
<p>
<strong>Note on pin naming:</strong> Klipper uses different pin naming formats depending on the MCU. STM32-based boards (Octopus, Manta) use <code>PC0</code> format. LPC1769-based boards (SKR v1.4 Turbo) use <code>P1.26</code> format. Always match the format expected by your firmware build.
</p>
</section>
<section>
<h2>BTT Octopus v1.1 (STM32F446 / STM32F429)</h2>
<p>
The Octopus v1.1 is the most widely used board in Voron V2.4 and Trident builds. It supports up to 8 stepper drivers and has abundant GPIO for expandability.
</p>
<h3>Stepper Driver Assignments</h3>
<table>
<thead>
<tr>
<th>Driver Slot</th>
<th>Klipper Name</th>
<th>Step Pin</th>
<th>Dir Pin</th>
<th>Enable Pin</th>
<th>UART Pin</th>
<th>Typical Use</th>
</tr>
</thead>
<tbody>
<tr>
<td>Driver 0</td>
<td>stepper_x</td>
<td>PF13</td>
<td>PF12</td>
<td>PF14</td>
<td>PF15</td>
<td>X axis</td>
</tr>
<tr>
<td>Driver 1</td>
<td>stepper_y</td>
<td>PF9</td>
<td>PF8</td>
<td>PF10</td>
<td>PF11</td>
<td>Y axis</td>
</tr>
<tr>
<td>Driver 2</td>
<td>stepper_z</td>
<td>PF5</td>
<td>PF4</td>
<td>PF6</td>
<td>PF7</td>
<td>Z (Trident) or Z1 (V2.4)</td>
</tr>
<tr>
<td>Driver 3</td>
<td>stepper_z1</td>
<td>PF1</td>
<td>PF0</td>
<td>PF2</td>
<td>PF3</td>
<td>Z (V2.4) or extruder (Trident)</td>
</tr>
<tr>
<td>Driver 4</td>
<td>stepper_z2</td>
<td>PD15</td>
<td>PD14</td>
<td>PD13</td>
<td>PE6</td>
<td>Z2 (V2.4 only)</td>
</tr>
<tr>
<td>Driver 5</td>
<td>stepper_z3</td>
<td>PD11</td>
<td>PD10</td>
<td>PD12</td>
<td>PD9</td>
<td>Z3 (V2.4 only)</td>
</tr>
<tr>
<td>Driver 6</td>
<td>extruder</td>
<td>PD6</td>
<td>PD5</td>
<td>PD7</td>
<td>PD4</td>
<td>Extruder (E0)</td>
</tr>
<tr>
<td>Driver 7</td>
<td>extruder1 (optional)</td>
<td>PD2</td>
<td>PD1</td>
<td>PD3</td>
<td>PD0</td>
<td>Second extruder / ERCF</td>
</tr>
</tbody>
</table>
<h3>Endstop & Probe Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
<th>Connector Label</th>
</tr>
</thead>
<tbody>
<tr>
<td>X Endstop</td>
<td>PG6</td>
<td>STOP 0</td>
</tr>
<tr>
<td>Y Endstop</td>
<td>PG9</td>
<td>STOP 1</td>
</tr>
<tr>
<td>Z Endstop (min)</td>
<td>PG10</td>
<td>STOP 2</td>
</tr>
<tr>
<td>Z Endstop (max)</td>
<td>PG11</td>
<td>STOP 3</td>
</tr>
<tr>
<td>Probe (Z Probe)</td>
<td>PG12</td>
<td>STOP 4 / PROBE</td>
</tr>
</tbody>
</table>
<h3>Heater & Thermistor Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
<th>Connector Label</th>
</tr>
</thead>
<tbody>
<tr>
<td>Hotend Heater</td>
<td>PA0 (or PB5 for heater 1)</td>
<td>HE0 / HE1</td>
</tr>
<tr>
<td>Bed Heater</td>
<td>PB5</td>
<td>HB</td>
</tr>
<tr>
<td>Hotend Thermistor</td>
<td>PC4 (T0)</td>
<td>TH0 / TH1</td>
</tr>
<tr>
<td>Bed Thermistor</td>
<td>PC5 (T1)</td>
<td>THB</td>
</tr>
<tr>
<td>Chamber Thermistor (optional)</td>
<td>PC6 (T2)</td>
<td>TH2</td>
</tr>
</tbody>
</table>
<h3>Fan Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
<th>Connector Label</th>
</tr>
</thead>
<tbody>
<tr>
<td>Part Cooling Fan (FAN0)</td>
<td>PE5</td>
<td>FAN0</td>
</tr>
<tr>
<td>Hotend Fan (FAN1)</td>
<td>PE4</td>
<td>FAN1</td>
</tr>
<tr>
<td>Controller Fan (FAN2)</td>
<td>PE3</td>
<td>FAN2</td>
</tr>
<tr>
<td>Enclosure Fan / Exhaust (FAN3)</td>
<td>PE2</td>
<td>FAN3</td>
</tr>
</tbody>
</table>
</section>
<section>
<h2>SKR v1.4 Turbo (LPC1769)</h2>
<p>
The SKR v1.4 Turbo was a common board for early Voron builds. It uses LPC1769 MCU with 4 stepper driver sockets.
</p>
<h3>Stepper Driver Assignments</h3>
<table>
<thead>
<tr>
<th>Driver Slot</th>
<th>Klipper Name</th>
<th>Step Pin</th>
<th>Dir Pin</th>
<th>Enable Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>X</td>
<td>stepper_x</td>
<td>P2.1</td>
<td>P2.2</td>
<td>P2.8</td>
</tr>
<tr>
<td>Y</td>
<td>stepper_y</td>
<td>P2.3</td>
<td>P2.4</td>
<td>P2.9</td>
</tr>
<tr>
<td>Z</td>
<td>stepper_z</td>
<td>P0.9</td>
<td>P0.8</td>
<td>P0.10</td>
</tr>
<tr>
<td>E0</td>
<td>extruder</td>
<td>P0.7</td>
<td>P0.6</td>
<td>P0.5</td>
</tr>
</tbody>
</table>
<h3>Endstop Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>X-Endstop (Min)</td>
<td>P1.29</td>
</tr>
<tr>
<td>Y-Endstop (Min)</td>
<td>P1.28</td>
</tr>
<tr>
<td>Z-Endstop (Min)</td>
<td>P1.27</td>
</tr>
<tr>
<td>Z-Probe (STOP)</td>
<td>P1.26</td>
</tr>
</tbody>
</table>
<h3>Heater & Thermistor Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>Hotend Heater</td>
<td>P2.7</td>
</tr>
<tr>
<td>Hotend Thermistor</td>
<td>P0.24</td>
</tr>
<tr>
<td>Bed Heater</td>
<td>P2.5</td>
</tr>
<tr>
<td>Bed Thermistor</td>
<td>P0.25</td>
</tr>
</tbody>
</table>
</section>
<section>
<h2>Fysetc Spider v2.2 (STM32F446)</h2>
<p>
The Spider v2.2 was designed specifically for Voron builds. It has 5 stepper driver slots and dedicated ports for Voron-specific features.
</p>
<h3>Stepper Driver Assignments</h3>
<table>
<thead>
<tr>
<th>Driver Slot</th>
<th>Klipper Name</th>
<th>Step Pin</th>
<th>Dir Pin</th>
<th>Enable Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>X</td>
<td>stepper_x</td>
<td>PC0</td>
<td>PC1</td>
<td>PC2</td>
</tr>
<tr>
<td>Y</td>
<td>stepper_y</td>
<td>PC3</td>
<td>PC4</td>
<td>PC5</td>
</tr>
<tr>
<td>Z1</td>
<td>stepper_z</td>
<td>PB7</td>
<td>PB6</td>
<td>PB8</td>
</tr>
<tr>
<td>Z2</td>
<td>stepper_z1 (V2.4)</td>
<td>PB9</td>
<td>PB5</td>
<td>PB4</td>
</tr>
<tr>
<td>E0</td>
<td>extruder</td>
<td>PA8</td>
<td>PA9</td>
<td>PA10</td>
</tr>
</tbody>
</table>
<h3>Endstop & Probe Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>X Endstop</td>
<td>PC14</td>
</tr>
<tr>
<td>Y Endstop</td>
<td>PC15</td>
</tr>
<tr>
<td>Z Endstop</td>
<td>PA0</td>
</tr>
<tr>
<td>Probe</td>
<td>PA1</td>
</tr>
</tbody>
</table>
<h3>Heater & Thermistor Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>Hotend Heater</td>
<td>PA2</td>
</tr>
<tr>
<td>Bed Heater</td>
<td>PA3</td>
</tr>
<tr>
<td>Hotend Thermistor</td>
<td>PC6</td>
</tr>
<tr>
<td>Bed Thermistor</td>
<td>PC7</td>
</tr>
</tbody>
</table>
</section>
<section>
<h2>BTT Manta M8P (STM32F407 / STM32F446)</h2>
<p>
The Manta M8P is a modern Voron board with integrated CB1 or CM4 compute module support. It offers 8 stepper drivers in a compact form factor.
</p>
<h3>Stepper Driver Assignments</h3>
<table>
<thead>
<tr>
<th>Driver Slot</th>
<th>Klipper Name</th>
<th>Step Pin</th>
<th>Dir Pin</th>
<th>Enable Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>M0 (X)</td>
<td>stepper_x</td>
<td>PC0</td>
<td>PC1</td>
<td>PC2</td>
</tr>
<tr>
<td>M1 (Y)</td>
<td>stepper_y</td>
<td>PC3</td>
<td>PC4</td>
<td>PC5</td>
</tr>
<tr>
<td>M2 (Z)</td>
<td>stepper_z</td>
<td>PB7</td>
<td>PB6</td>
<td>PB8</td>
</tr>
<tr>
<td>M3 (Z1)</td>
<td>stepper_z1</td>
<td>PB9</td>
<td>PB5</td>
<td>PB4</td>
</tr>
<tr>
<td>M4 (Z2)</td>
<td>stepper_z2</td>
<td>PB1</td>
<td>PB0</td>
<td>PA7</td>
</tr>
<tr>
<td>M5 (Z3)</td>
<td>stepper_z3</td>
<td>PA6</td>
<td>PA5</td>
<td>PA4</td>
</tr>
<tr>
<td>M6 (E0)</td>
<td>extruder</td>
<td>PA3</td>
<td>PA2</td>
<td>PA1</td>
</tr>
<tr>
<td>M7 (E1)</td>
<td>extruder1 (optional)</td>
<td>PD15</td>
<td>PD14</td>
<td>PD13</td>
</tr>
</tbody>
</table>
<h3>Endstop & Probe Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>X Endstop</td>
<td>PC14</td>
</tr>
<tr>
<td>Y Endstop</td>
<td>PC15</td>
</tr>
<tr>
<td>Z Endstop</td>
<td>PA0</td>
</tr>
<tr>
<td>Probe</td>
<td>PA1</td>
</tr>
</tbody>
</table>
<h3>Heater & Thermistor Pins</h3>
<table>
<thead>
<tr>
<th>Function</th>
<th>Klipper Pin</th>
</tr>
</thead>
<tbody>
<tr>
<td>Hotend Heater</td>
<td>PA2</td>
</tr>
<tr>
<td>Bed Heater</td>
<td>PA3</td>
</tr>
<tr>
<td>Hotend Thermistor</td>
<td>PC6</td>
</tr>
<tr>
<td>Bed Thermistor</td>
<td>PC7</td>
</tr>
<tr>
<td>Chamber Thermistor</td>
<td>PC8</td>
</tr>
</tbody>
</table>
</section>
<section>
<h2>Board Comparison Table</h2>
<table>
<thead>
<tr>
<th>Feature</th>
<th>Octopus v1.1</th>
<th>SKR v1.4 Turbo</th>
<th>Spider v2.2</th>
<th>Manta M8P</th>
</tr>
</thead>
<tbody>
<tr>
<td>MCU</td>
<td>STM32F446/F429</td>
<td>LPC1769</td>
<td>STM32F446</td>
<td>STM32F407/F446</td>
</tr>
<tr>
<td>Driver Sockets</td>
<td>8</td>
<td>4</td>
<td>5</td>
<td>8</td>
</tr>
<tr>
<td>Z Motors (V2.4)</td>
<td>4</td>
<td>1 (needs expansion)</td>
<td>2</td>
<td>4</td>
</tr>
<tr>
<td>Z Motors (Trident)</td>
<td>3</td>
<td>1 (needs expansion)</td>
<td>2 (needs expansion)</td>
<td>3</td>
</tr>
<tr>
<td>Thermistor Ports</td>
<td>4</td>
<td>2</td>
<td>2</td>
<td>3</td>
</tr>
<tr>
<td>Fan Ports</td>
<td>4</td>
<td>2</td>
<td>3</td>
<td>4</td>
</tr>
<tr>
<td>Integrated Compute</td>
<td>No</td>
<td>No</td>
<td>No</td>
<td>Yes (CB1/CM4)</td>
</tr>
<tr>
<td>Pin Naming</td>
<td>PA0, PB1, ...</td>
<td>P0.24, P1.26, ...</td>
<td>PA0, PB1, ...</td>
<td>PA0, PB1, ...</td>
</tr>
</tbody>
</table>
</section>
<section>
<h2>Common Voron Config Snippets</h2>
<h3>V2.4 Quad-Z on Octopus v1.1</h3>
<pre>[stepper_z]
step_pin: PF5
dir_pin: !PF4
enable_pin: !PF6
microsteps: 32
rotation_distance: 40
endstop_pin: probe:z_virtual_endstop
[stepper_z1]
step_pin: PF1
dir_pin: !PF0
enable_pin: !PF2
microsteps: 32
rotation_distance: 40
[stepper_z2]
step_pin: PD15
dir_pin: !PD14
enable_pin: !PD13
microsteps: 32
rotation_distance: 40
[stepper_z3]
step_pin: PD11
dir_pin: !PD10
enable_pin: !PD12
microsteps: 32
rotation_distance: 40
[z_tilt]
z_positions:
-90, 90
-90, -90
90, -90
90, 90
horizontal_move_z: 10
retries: 5</pre>
<h3>Trident Triple-Z on Octopus v1.1</h3>
<pre>[stepper_z]
step_pin: PF5
dir_pin: !PF4
enable_pin: !PF6
microsteps: 32
rotation_distance: 40
endstop_pin: probe:z_virtual_endstop
[stepper_z1]
step_pin: PF1
dir_pin: !PF0
enable_pin: !PF2
microsteps: 32
rotation_distance: 40
[stepper_z2]
step_pin: PD15
dir_pin: !PD14
enable_pin: !PD13
microsteps: 32
rotation_distance: 40
[z_tilt]
z_positions:
90, 90
90, -90
-90, -90
horizontal_move_z: 10
retries: 5</pre>
</section>
</article>