QtFOC is a tiny, open-source, low-cost BLDC driver board in the form factor of the Seeed Studio XIAO / Adafruit QT Py boards. It is a part of the SimpleFOC project and is designed to be fully compatible with the SimpleFOC library.
You plug in a XIAO or QT Py, connect a motor and a power supply, and you have a complete FOC motor controller in a 25mm x 45mm footprint. The board generates its own 5V supply from the motor power input, so the microcontroller is powered from VIN as well, and no extra regulator or USB cable is needed once it is programmed.
The XIAO / QT Py MCU format has a limited number of pins, but it is enough for many applications. It can run:
- a motor: a BLDC, or a stepper with the HybridStepper mode (SimpleFOC v2.3.5+)
- a position sensor: SPI, encoder, I2C or even PWM (see the limitations)
- current sensing: low-side current sensing on 2 phases
- some simple communication, like USB or Serial
- The board works with all the MCU architectures supported by the SimpleFOC library, but if you want to use the current sensing, make sure your MCU supports low-side current sensing (see the compatibility table).
- Only a few pins are left once the motor, current sensing and voltage measurement are connected:
D6(TX) andD7(RX / CS), plusD8-D10(SPI).- With an SPI sensor connected, only
D6is left. - An encoder needs both
D6andD7, so it can't be used together with an SPI sensor or the UART header. - The I2C pins of the header (
D4/D5) are used for the motor PWM. I2C sensors and devices can be connected through the Stemma QT connector on QT Py boards where it has its own I2C bus.
- With an SPI sensor connected, only
- The onboard 5V buck converter provides up to 200mA, which is enough for the MCU and the sensor, but not for the WiFi / BLE radio of the ESP32 boards. If you want to use WiFi or BLE, power the MCU board from USB as well.
Like the other SimpleFOC boards, it is also meant as a template project the community can modify:
- The board is simple and can be easily changed to fit different requirements.
- The board is designed in EasyEDA and all the fabrication files are available in this repository.
- DRV8316C integrated 3-phase driver - datasheet
- Hardware configuration (no SPI configuration needed)
- 3PWM mode (
R_MODE= 47kΩ) - Integrated low-side current sense amplifiers: gain 0.15V/A (
GAINto GND) - Overcurrent protection: 16A level (
OCP/SRto GND) - Slew rate: 200V/us (
SLEWto AVDD) - Protections: undervoltage lockout, charge pump fault, overcurrent, overtemperature
- Integrated buck converter: 5V output, 200mA max (inductor mode, 47uH)
- Voltage divider (47kΩ / 4.7kΩ) for power supply voltage measurement
- Input voltage: 8-35V
- Current: up to 8A peak (DRV8316 limit). The continuous current depends on cooling.
- Current sensing: 2 phase low-side current sensing (phases A and B), around ±11A range with a 3.3V ADC
- Power supply measurement: VIN/11 on
A2 - Onboard 5V buck: powers the XIAO / QT Py from VIN through a diode, so USB and VIN can be connected at the same time (200mA max, use USB power for WiFi / BLE)
- SPI JST-SH connector (6-pin): for SPI position sensors (for example AS5047, MT6701, AS5048A)
- UART / GPIO header: 3.3V, GND, RX, TX
- Fault LED (
nFAULT) and power LED - Compact: 25mm x 45mm
- Compatible MCUs: any board with the XIAO / QT Py pinout (see the compatibility table)
- Seeed Studio XIAO: SAMD21, RP2040, RP2350, nRF52840, ESP32-C3, ESP32-S3, ESP32-C6...
- Adafruit QT Py: SAMD21, RP2040, ESP32-S2, ESP32-S3, ESP32-C3...
- Open Source:
- Fully designed in EasyEDA - EasyEDA project
- Fully available fabrication files - Gerber, BOM, Pick and Place
- Low-cost: The board is basically a SimpleFOCMini with a couple of more headers, so the price is pretty much the same. It should not cost much more than 10$.
Here is a non-exhaustive list of the MCU boards in this format.
| Board | MCU architecture | Supported by SimpleFOC | Low-side current sensing |
|---|---|---|---|
| QT Py SAMD21 Xiao SAMD21 |
SAMD21 | ✅ | ✅ (v2.3.5+) |
| QT Py RP2040 Xiao RP2040 |
RP2040 | ✅ | ❌ |
| QT Py ESP32-S3 Xiao ESP32-S3 |
ESP32-S3 | ✅ | ✅ |
| QT Py ESP32 Pico | ESP32 Pico | ✅ | ✅ |
| QT Py ESP32-S2 | ESP32-S2 | ✅ | ❌ |
| QT Py CH32V203 | CH32V203 | ❌ | ❌ |
| QT Py ESP32-C3 Xiao ESP32-C3 |
ESP32-C3 | ✅ | ❌ |
| Xiao nRF52840 | nRF52840 | ✅ | ❌ |
| Xiao ESP32-C6 | ESP32-C6 | ✅ | ✅ |
| Xiao RP2350 | RP2350 | ✅ (v2.3.5+) | ❌ |
See more info in the SimpleFOC microcontrollers docs.
The board uses the standard XIAO / QT Py pinout.
| XIAO / QT Py pin | Signal | Description |
|---|---|---|
A0 / D0 |
SOA | Phase A current sense |
A1 / D1 |
SOB | Phase B current sense |
A2 / D2 |
VSENS | Supply voltage sense: VIN/11 (47kΩ / 4.7kΩ divider) |
D3 |
IN1 | Phase A PWM |
D4 |
IN2 | Phase B PWM |
D5 |
IN3 | Phase C PWM |
D6 / TX |
TX | UART TX (header) |
D7 / RX |
CS / RX | SPI sensor chip select, UART RX (header) |
D8 |
SCK | SPI clock |
D9 |
MISO | SPI MISO |
D10 |
MOSI | SPI MOSI |
5V |
5V | Powered from the DRV8316 buck converter through a diode |
3V3 |
3.3V | 3.3V from the MCU board's regulator, used for logic and the sensor |
Note:
D7is shared between the SPI chip select (JST connector) and the RX pin on the UART header. You can use one of them at a time.
Power (screw terminal): VCC (8-35V) and GND
Motor (3-pin header): M1, M2, M3
SPI (JST-SH 1.0mm, 6-pin, SM06B-SRSS-TB):
| Number | Pin | Function |
|---|---|---|
| 1 | GND | GND |
| 2 | 3.3V | 3.3V |
| 3 | D10 | MOSI |
| 4 | D9 | MISO |
| 5 | D8 | SCK |
| 6 | D7 | CS |
UART / GPIO (4-pin header): 3V3, GND, RX, TX
A minimal SimpleFOC setup with the board:
#include <SimpleFOC.h>
BLDCMotor motor = BLDCMotor(7); // set your motor's pole pair number
BLDCDriver3PWM driver = BLDCDriver3PWM(D3, D4, D5);
// DRV8316 low-side current sense: 0.15V/A = 150mV/A, phases A and B
// requires an MCU with low-side current sensing support (see the compatibility table)
// if your MCU doesn't support it (ex. RP2040), remove the current sense and use voltage torque control
LowsideCurrentSense current_sense = LowsideCurrentSense(150.0f, A0, A1);
// SPI position sensor on the JST connector
MagneticSensorSPI sensor = MagneticSensorSPI(AS5047_SPI, D7);
void setup() {
Serial.begin(115200);
SimpleFOCDebug::enable(&Serial);
sensor.init();
motor.linkSensor(&sensor);
driver.voltage_power_supply = 12; // your power supply voltage
driver.init();
motor.linkDriver(&driver);
current_sense.linkDriver(&driver);
current_sense.init();
motor.linkCurrentSense(¤t_sense);
motor.torque_controller = TorqueControlType::foc_current;
motor.controller = MotionControlType::velocity;
motor.init();
motor.initFOC();
}
void loop() {
motor.loopFOC();
motor.move(5); // 5 rad/s
}The supply voltage can be measured on A2:
float vin = analogRead(A2) * 3.3f / 4095.0f * 11.0f; // adjust for your ADC resolutionMost of the Adafruit QT Py boards have a Stemma QT I2C connector. It can be an awesome addition to this setup and allows many cool applications, for example controlling the motor with an I2C gamepad, as in the picture below (QT Py RP2040 + Adafruit Gamepad QT).
Note: On most QT Py boards (RP2040, ESP32-S2, ESP32-S3...) the Stemma QT connector has its own I2C bus (
Wire1), so it does not interfere with the motor pins. On boards where it shares theSDA/SCLheader pins (D4/D5), it can't be used with this board, as those pins drive the motor. Check the pinout of your QT Py.
| Release | Date | Description |
|---|---|---|
| v1.0 | 2025-07 | First version, the MCU needs a separate power supply |
| v1.6 | 2026-02 | Initial public release - MCU powered from the DRV8316 buck converter (5V) |
The hardware design is released under the MIT license.
For help and discussion, see the SimpleFOC community forum and the SimpleFOC docs.






