CocktailBerryBoard I2C#
The CocktailBerryBoard is a dedicated control board for CocktailBerry machines. It replaces the extensive wiring and generic relay arrays normally used to switch the pumps, giving you clean, repeatable wiring on a single board. It drives its outputs directly from the Raspberry Pi's I²C interface.
Beta
This board is in beta. The design is functional and under final validation. Production artifacts may be available, but minor revisions are still possible before release.
Overview#
The board switches up to 10 circuits through the Raspberry Pi's I²C interface and on-board MOSFETs, replacing relay arrays with a quieter and more compact solution. Each output carries a built-in flyback (backflow) diode, and the 12 V supply can be daisy-chained onward, which keeps wiring across the machine simple. The I²C bus can be daisy-chained to further devices, sharing the Pi's single bus.
Although it was designed for the MK IV, it works with any device that can be controlled over I²C.
Specifications#
| Property | Detail |
|---|---|
| Variant | I²C (CBB-I2C) |
| Channels | Up to 10 independently switched circuits |
| Switching | MOSFET, driven from Raspberry Pi I²C |
| Wiring | 2×4 Pin Headers, 2×SH 4 pin (SDA, SCL, GND, VCC) |
| Power | 12 V input and output connector (PSU daisy-chain) |
| Dispenser outputs | One (+/–) connector per dispenser - no voltage conversion |
| Protection | Input fuse and per-channel flyback diodes |
| Indication | On/off status LED |
Mechanical#
- Shares the Raspberry Pi mounting-hole pattern, so the board and a Pi can be stacked / co-mounted.
- It is not a HAT - it does not plug onto the Pi's 40-pin header. Connections are made via pin headers: one 4-pin header per channel, wired to the Pi's I²C interface.
Extender Mapping#
Currently, the default I2C address is 0x27, and the board can be configured to use addresses down to 0x20 by soldering the appropriate jumpers (A0, A1, A2) on the board.
The pumps are mapped to the channels as follows: 0 to 1, 1 to 2, ..., 9 to 10 (Pump - 1 = Pin/Channel).
Use this number for the CocktailBerry software as the pin number of the pump.
Files#
Production files are attached to each release as a single archive, generated with KiKit:
- Fabrication package (JLCPCB):
cbb-i2c.zip - Gerbers, BOM, and positions (pick-and-place).
All parts (SMD, THT) are included in the package, so you can order the board and all parts from JLCPCB directly.
Disclaimer
The CocktailBerry hardware is open-source and provided as-is, without any warranty. You build, modify, and operate it at your own risk. Always follow local electrical-safety regulations and double-check wiring, polarity, and supply voltages before powering a board. Neither the authors nor the contributors are liable for any damage, injury, or loss resulting from its use.