drumkit/README.md

Drumkit

This is a simple drum machine / loopstation. It’s made for three hand-wound solenoids mounted to a tambourine. It is controlled by a Raspberry Pi Pico.

Quick Start

Initialize your local repo and prepare the build:

git clone https://git.xythobuz.de/thomas/drumkit.git
cd drumkit
git submodule update --init
cd pico-sdk
git submodule update --init
cd ..
mkdir build
cd build
cmake ..
cd ..

Then you can build new binaries like this:

make -Cbuild -j4

Flash as usual using the mass storage bootloader (hold BOOTSEL while pluggin in the Pico).

Hardware Connections

Pin 1    GP0    I2C0 SDA
Pin 2    GP1    I2C0 SCL

Pin 29   GP22   Output Channel A
Pin 31   GP26   Output Channel B
Pin 32   GP27   Output Channel C

Pin 34   GP28   Vbat (ADC2)

Pin 11   GP8    Button 1
Pin 12   GP9    Button 2
Pin 16   GP12   Button 3
Pin 19   GP14   Button 4

Pin 22   GP17   Encoder A
Pin 24   GP18   Encoder B
Pin 21   GP16   Encoder Click

Pin 14   GP10   LED 1
Pin 15   GP11   LED 2
Pin 17   GP13   LED 3
Pin 20   GP15   LED 4

License

This firmware is licensed as GPLv3. It uses the Pi Pico SDK, licensed as BSD 3-clause, and therefore also TinyUSB, licensed under the MIT license.

The code in src/encoder.c is derived from mathertel/RotaryEncoder and therefore licensed as BSD 3-clause.

The PCB design uses Mini360_step_down_converter library from rayvburn/KiCad.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

See <http://www.gnu.org/licenses/>.