DOER USB GPIO BOARD

Control hardware from any computer.

One USB-C cable gives Windows, macOS, and Linux a set of 28 Raspberry Pi-style GPIO pins. Write Python, connect an LED or sensor, and start building.

Original Doer USB GPIO Board product banner
28 pins. Digital I/O, PWM, ADC, and I2C.

WHY GPIO

A small board with a useful surface area.

Keep the computer you already use. The board handles the real-time pin work, and the open-source Python library keeps your code familiar.

01

Cross-platform

Works over USB on Windows, macOS, and Linux. The board appears as a CH340 USB-serial device and the library finds it for you.

02

Raspberry Pi-style API

Use familiar setup(), input(), and output() calls with GPIO numbers printed on the board.

03

Digital, PWM, ADC, and I2C

All 28 pins handle digital I/O. Eight support hardware PWM, eight support 12-bit analog input, and one I2C controller has two routes.

04

Open source

The Python library and STM32 firmware are public and GPL-licensed, so you can inspect the protocol and adapt your setup.

SEE IT RUN

A blinking LED is enough to start.

The original board demo uses a few lines of Python to make an LED blink from a desktop computer.

Prefer a standalone page? Open the demo video page or watch on YouTube.

GET STARTED

From USB cable to first signal.

Install the library, plug in a data-capable USB-C cable, and run a normal Python script. The board reports its hardware and software version when it connects.

1

Install the library

DoerGPIO supports Python 3.9 and newer. pyserial is installed automatically.

pip install DoerGPIO

Use pip3 or python -m pip when your system needs it.

2

Connect the board

Plug the board into a USB port with a data-capable USB-C cable. It identifies as a CH340 USB-serial device.

If your computer does not detect it, the troubleshooting guide has the checks to make next.

3

Run your first script

from DoerGPIO import GPIO
import time

GPIO.setup(17, GPIO.OUT)
for _ in range(5):
    GPIO.output(17, GPIO.HIGH)
    time.sleep(0.5)
    GPIO.output(17, GPIO.LOW)
    time.sleep(0.5)

# Read an input with its pull-up enabled
GPIO.setup(22, GPIO.IN, pull_up_down=GPIO.PUD_UP)
print("GPIO 22:", GPIO.input(22))
Need the exact API, pin map, and compatibility notes?Open the full technical documentation →

WHAT YOU CAN BUILD

Four ways into the pins.

Digital I/O

Use any GPIO 0–27 as an input or output with configurable pull-up, pull-down, or no pull resistor.

28 configurable pins

PWM output

Set a whole-number duty cycle from 0–100 on GPIO 4, 9, 10, 16, 18, 20, 22, and 26. Some pins share a timer.

8 PWM pins

Analog input

Read 12-bit values with GPIO.adc_read() on GPIO 0, 9, 10, 11, 14, 15, 18, and 26.

8 ADC pins · 0–4095

I2C

Use the hardware controller on either GPIO 16/20 or GPIO 3/2. Only one route is active at a time.

2 selectable routes

AT A GLANCE

The numbers that matter.

These are the current software and source-backed specifications. The full docs keep individual items that still need hardware confirmation clearly marked.

MicrocontrollerSTM32F070 · exact variant (C6 or CB) to be confirmed
GPIO pins28 configurable pins · GPIO 0–27
USBUSB-C through a CH340 bridge · USB ID 1a86:7523
PWM8 pins: 4, 9, 10, 16, 18, 20, 22, 26 · whole-number duty cycle 0–100 · default 1 kHz
ADC8 pins: 0, 9, 10, 11, 14, 15, 18, 26 · 12-bit readings from 0–4095
Pull resistorsConfigurable pull-up / pull-down on all pins
PlatformsWindows · macOS · Linux · driver availability depends on OS and version
I2C1 controller · two selectable pin routes
Serial link230400 baud
Python3.9+ · pip install DoerGPIO · library 1.1
FirmwareC (STM32CubeIDE) · source release v0.2
LicenseGPL-3.0 (library: GPL-3.0-or-later)

See the full specification table for PWM frequency notes and the firmware notes for board compatibility.

MADE FOR

Useful when a Raspberry Pi is one step too far.

Makers and hobbyists

Blink LEDs, read sensors, and control a motor through a suitable external motor driver from the laptop on your bench.

Rapid prototyping

Test hardware interactions from the same development machine where you write and debug the rest of your code.

Teaching

Explain GPIO with familiar Python syntax on the Windows, Mac, or Linux computers already in the classroom.

FROM SCHEMATIC TO CASE

Built in public, one layer at a time.

The board's story runs from schematic and layout through assembly and the finished 3D-printed case.

Doer USB GPIO boards and finished cases
Finished boards and cases.
GPIO board schematic
01 · Schematic
GPIO board PCB layout
02 · Layout
Bare GPIO board
03 · Bare board
Assembled GPIO board
04 · Assembly
Finished 3D-printed case for the GPIO board
05 · Case

Read the full build story →

OPEN SOURCE

Firmware you can inspect.

The board runs open-source STM32 firmware, and the Python library is developed alongside it. DoerGPIO 1.1 with firmware v0.2 adds I2C support.

CURRENT SOURCE VERSIONDoerGPIO_HW0.2_SW0.2

For update requirements, bootloader details, and the version check output, use the firmware section in the full docs.

ORIGINAL PRODUCT INSTRUCTIONS

How to update firmware.

The original GPIO page included these three steps. They remain here for review; board and bootloader compatibility by shipment batch is still unverified. Do not run them until the hardware audit is complete.

1

Install the upload tool dependency

pip install pyserial
2

Download the firmware and upload script

Get the latest .bin firmware file and upload_fw.py from the GitHub Releases page.

3

Run the upload script

With the board unplugged, run the script and plug it in when prompted. The original command was:

python3 upload_fw.py DoerGPIO_FW.bin

The original banner also says “FIRMWARE UPDATE VIA OTA”; that wording is retained in the source artwork and is not treated as a verified capability. Read the migration notes →

FAQ

A few practical answers.

Which operating systems are supported?

Windows, macOS, and Linux. Driver availability can depend on the operating system and its version; the full troubleshooting guide covers what to check if the board is not detected.

How do I install the Python library?

Run pip install DoerGPIO. Python 3.9 or newer is required, and the library finds the board over USB when it connects.

Which pins support PWM and ADC?

PWM: 4, 9, 10, 16, 18, 20, 22, 26. ADC: 0, 9, 10, 11, 14, 15, 18, 26. All pins support standard digital I/O.

Is the firmware open source?

Yes. The Python library and STM32 firmware are public under GPL licenses. Browse the library and firmware repositories.

Where can I buy the board?

The board is available from the Doer online store.

READY TO BUILD?

One USB cable. Pure Python.

Start with the board, then keep the complete pinout, API reference, troubleshooting, and firmware notes close by.