https://github.com/pierreportal/knobgpio
KnobGPIO is a custom Chugin (ChucK plugin) written in C++ that enables direct access to the Raspberry Pi’s GPIO pins from within ChucK. It allows ChucK programs to interface with physical hardware like knobs, buttons, and sensors, making it ideal for real-time, interactive audio systems running on the Pi.
https://github.com/pierreportal/knobgpio
analog embedded low-level-programming music raspberry-pi synthesizer
Last synced: 3 months ago
JSON representation
KnobGPIO is a custom Chugin (ChucK plugin) written in C++ that enables direct access to the Raspberry Pi’s GPIO pins from within ChucK. It allows ChucK programs to interface with physical hardware like knobs, buttons, and sensors, making it ideal for real-time, interactive audio systems running on the Pi.
- Host: GitHub
- URL: https://github.com/pierreportal/knobgpio
- Owner: pierreportal
- Created: 2025-03-08T15:34:37.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-04-15T08:20:10.000Z (about 1 year ago)
- Last Synced: 2025-04-15T09:29:26.125Z (about 1 year ago)
- Topics: analog, embedded, low-level-programming, music, raspberry-pi, synthesizer
- Language: C++
- Homepage:
- Size: 32.2 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# KnobGPIO
Plugin for the [ChucK programming language](https://chuck.stanford.edu/).
## Prerequisite
### MCP3008
The MCP3008 is a 10-bit Analog-to-Digital Converter (ADC) chip that allows microcontrollers (like the Raspberry Pi) to read analog signals. The Raspberry Pi does not have built-in analog input pins, so if you're using an analog sensor (like a potentiometer, temperature sensor, or light sensor), you need an external ADC like the MCP3008 to convert the analog signal into a digital value that the Pi can process.
| MCP3008 Pin | Connect to Raspberry Pi Pin |
| ------------- | -------------------------------------------------------------- |
| **VDD (16)** | **3.3V (Pin 1)** |
| **VREF (15)** | **3.3V (Pin 1)** |
| **AGND (14)** | **GND (Pin 6)** |
| **CLK (13)** | **GPIO11 (SPI CLK, Pin 23)** |
| **DOUT (12)** | **GPIO9 (SPI MISO, Pin 21)** |
| **DIN (11)** | **GPIO10 (SPI MOSI, Pin 19)** |
| **CS (10)** | **GPIO8 (SPI CE0, Pin 24)** |
| **DGND (9)** | **GND (Pin 6)** |
| **CH0 - CH7** | **Connect to potentiometer middle pin or other analog sensor** |
```
_______
CH0 --|1 ° 16|-- VDD -> 3.3v
CH1 --|2 15|-- VREF -> 3.3v
CH2 --|3 14|-- AGND -> gnd
CH3 --|4 13|-- CLK -> GPIO11 (SPI CLK, Pin 23)
CH4 --|5 12|-- DOUT -> GPIO9 (SPI MISO, Pin 21)
CH5 --|6 11|-- DIN -> GPIO10 (SPI MISO, Pin 19)
CH6 --|7 10|-- CS/SHDN -> GPIO8 (SPI CE0, Pin 24)
CH7 --|8_____9|-- DGND -> gnd
```
## Install
On linux
```sh
git clone https://github.com/pierreportal/KnobGPIO.git
cd KnobGPIO
```
```sh
make linux
```
```sh
sudo make install
```
## Usage
```cpp
KnobGPIO knob;
while (true)
{
<<< knob.last() >>>;
}
```