Skip to the content
2 layers64 × 39 mmBubble bot pcb, the printed circuit board in 3D

A friendly desktop companion robot. Bubble-Bot chats with you through a phone app powered by Google Gemini, replies in a short conversational style, and tags every reply with an emotion ([HAPPY], [SAD], [THINKING], ...)…

Size
64 × 39 mm
Copper layers
2
Thickness
1.6 mm
Parts
10
Nets
19
Pads
45
Tracks, vias
114, 0
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
23 Sep 2026
Updated
23 Sep 2026

Overview

Bubble bot pcb is an open-source printed circuit board by PreetinderSinghBadesha, from the PreetinderSinghBadesha/bubble-bot repository on GitHub. It is a 2-layer board of 64 × 39 mm with 10 parts on 19 nets, routed with 114 tracks and 0 vias.

Its parts include 2 resistors, 1 capacitor, 1 IC and 1 diode.

README

README.md

Bubble-Bot

A friendly desktop companion robot. Bubble-Bot chats with you through a phone app powered by Google Gemini, replies in a short conversational style, and tags every reply with an emotion ([HAPPY], [SAD], [THINKING], ...) that the robot shows as a face on its OLED display.

The project covers the whole stack: 3D-printed enclosure, custom PCB, ESP32 firmware, and a Flutter controller app.

Bubble-Bot with its OLED face Inside the Bubble-Bot enclosure

Left: Bubble-Bot showing a neutral face with a battery indicator. Right: the electronics inside the printed body.

Repository layout

FolderContents
bubble-bot-code/bubble-bot-codeESP32 firmware (PlatformIO, Arduino framework)
bubble-bot-code/bubble_appFlutter controller app (BLE + Gemini chat)
bubble-bot-model3D-printable enclosure: front cover, back cover, main body (STL / 3MF)
bubble-bot-pcbKiCad 9 project: schematic, PCB layout, STEP model
pcb v1Earlier PCB revision
Bubble-Bot Embedded Systems.pdf / .pptxProject presentation

How it works

text
 Phone (Flutter app)                         Bubble-Bot (ESP32)
┌────────────────────────┐   BLE write     ┌──────────────────────────┐
│ Chat UI                │  "HAPPY" etc.   │ XIAO ESP32               │
│ Gemini 2.5 Flash       │ ───────────────►│  └─ I2C ─► OLED face     │
│ Parses [EMOTION] tag   │                 │  I2S ─► mic / speaker    │
└────────────────────────┘                 └──────────────────────────┘
  1. You type a message in the app.
  2. The app sends it to Gemini (gemini-2.5-flash) with a system prompt that makes it answer briefly and end with an emotion tag.
  3. The app strips the tag, shows the reply, and writes the emotion to the robot over Bluetooth Low Energy.
  4. The robot maps the emotion to a facial expression.

Supported emotions: NEUTRAL, HAPPY, SAD, SURPRISED, THINKING, ANGRY, EXCITED, SLEEPY, CONFUSED, LOVE, WINK.

BLE details used by the app:

  • Device name: Bubble-Bot
  • Service UUID: 4fafc201-1fb5-459e-8fcc-c5c9c331914b
  • Control characteristic UUID: beb5483e-36e1-4688-b7f5-ea07361b26a8 (UTF-8 emotion string)

Hardware

The custom PCB carries:

  • Seeed Studio XIAO ESP32 module (U1), USB-C powered
  • OLED display (I2C) that shows the robot's face
  • INMP441 I2S microphone
  • MAX98357A I2S amplifier driving a small speaker
  • TP5046 Li-ion charger module output, with a Schottky diode (D2) and two 10k resistors (R1, R2) for battery sensing
  • 3D-printed enclosure (see bubble-bot-model)

The firmware in bubble-bot-code/bubble-bot-code is a separate PCA9685 + 6-servo bring-up test for an earlier servo-driven prototype (ESP32 DevKit V1, I2C 0x40, SDA = GPIO21, SCL = GPIO22, servos on channels 0-5).

PCB design

SchematicLayout3D view
SchematicPCB layoutPCB 3D render

Getting started

Firmware

Requires PlatformIO.

bash
cd bubble-bot-code/bubble-bot-code
pio run -t upload
pio device monitor      # 115200 baud

Status: the current firmware is a servo bring-up test. It sweeps each of the six servos 0° → 180° → 0° in turn. The BLE server and emotion-to-movement mapping that the app talks to are not implemented in this firmware yet.

Servo pulse limits are set by SERVOMIN / SERVOMAX in src/main.cpp; tune them if your servos jitter or overshoot.

Controller app

Requires the Flutter SDK (Dart ^3.8.1) and a Gemini API key. The key is supplied at build time and is never stored in the repo:

bash
cd bubble-bot-code/bubble_app
flutter pub get
flutter run --dart-define=GEMINI_API_KEY=your_key_here

The app needs Bluetooth and location permissions on Android in order to scan for the robot.

Building the PCB

Open bubble-bot-pcb/bubble-bot-pcb.kicad_pro in KiCad 9. A STEP model of the board is included for enclosure fitting.

Enclosure

Print main body.stl, front-cover.stl and back cover.stl from bubble-bot-model/.

Roadmap

  • BLE GATT server on the ESP32 matching the UUIDs above
  • Emotion-to-face animation table
  • Battery and power management

License

No license has been chosen yet. Until one is added, all rights are reserved by the author.

Parts

10
QtyValueFootprintReferences
2RResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR1-10k1, R2-10k1
1C_PolarizedCapacitor_THT:CP_Radial_D5.0mm_P2.00mmC1
1Conn_01x02Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalTP5046-OUT-pins1
1Conn_01x02_PinConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalSpeaker1
1Conn_01x04Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalOLED1
1Conn_01x06_PinConnector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_VerticalMic-INMP441
1Conn_01x07_PinConnector_PinHeader_2.54mm:PinHeader_1x07_P2.54mm_VerticalAMP-MAX98357A1
1D_SchottkyDiode_THT:D_DO-41_SOD81_P10.16mm_HorizontalD2
1~ESP32C3-footprint-eagle_single_device_kicad:MOUDLE14P-SMD-2.54-21X17.8MMU1

Similar boards

  • 2 layers57 × 55.2 mmLogicAnalyzer, the printed circuit board in 3D

    LogicAnalyzer

    gusmanb/logicanalyzer

    24 channel, 100Msps logic analyzer hardware and software

    10 parts5.1kGPL-3.0
  • 2 layers32.2 × 15.4 mmProtector, the printed circuit board in 3D

    Protector

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    10 parts4.3kMIT
  • 2 layers26 × 18 mmConn, the printed circuit board in 3D

    Conn

    yaqwsx/KiKit

    Automation tools for KiCAD

    10 parts2.1kMIT
  • 2 layers44.3 × 30.5 mmLime2-SATA RevA, the printed circuit board in 3D

    Lime2-SATA RevA

    OLIMEX/OLINUXINO

    OLINUXINO is Open Source / Open Hardware, low cost from EUR 24 Linux Industrial grade Single Board Computer capable to operate -25+85C

    10 parts1.5k
  • 2 layers17.8 × 43.2 mmNano Adapter, the printed circuit board in 3D

    Nano Adapter

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    10 parts1.1kGPL-3.0
  • 2 layers53.9 × 23.2 mmBuffer, the printed circuit board in 3D

    Buffer

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    10 parts1kGPL-3.0

Questions

How big is the Bubble bot pcb PCB?

It measures 64 × 39 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Bubble bot pcb use?

10 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Bubble bot pcb KiCad files?

From the PreetinderSinghBadesha/bubble-bot repository on GitHub, at the commit this page was made from: the board is bubble-bot-pcb/bubble-bot-pcb.kicad_pcb and its schematic bubble-bot-pcb/bubble-bot-pcb.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Bubble bot pcb design in my own project?

Its repository states no licence, so its author keeps all rights: ask PreetinderSinghBadesha before reusing the design.