
Badge
NuttyShell/NuttyBadge
NuttyBadge: A NuttyShell crafted multi-tool. Opensourced Hardawre and Software

PenguinBot V3.0 — 桌面轮足机器人 | ESP32-S3 定制PCB | ICM-42688-P SPI | TOF防跌落 | 离线唤醒词 | 自动充电坞 | BLE App | ¥589 BOM
PenguinBotV3 is an open-source printed circuit board by zhangshua1, from the zhangshua1/PenguinBotV3 repository on GitHub. It is a 4-layer board of 56 × 38 mm with 78 parts on 49 nets, routed with 93 tracks and 14 vias.
It is built around the ESP32-S3-WROOM-1-N16R8, PCA9685PW and AMS1117-3.3, with the ICM-42688-P, 1N4148WS and SS34 among its other parts. Its parts include 22 resistors, 15 capacitors, 15 connectors, 7 ICs and 5 diodes. It belongs with the ESP32 boards of this library.
双轮自平衡 + 企鹅形态 | ESP32-S3 定制 PCB | ICM-42688-P | TOF 防跌落 | 离线唤醒词 | 自动充电坞 | BLE App | ¥589 BOM
| 特性 | V2.0 | V3.0 |
|---|---|---|
| PCB | 6 块独立模块 + 杜邦线 | 1 块定制 PCB (56×38mm 4L) |
| IMU | MPU6050 I2C | ICM-42688-P SPI (零漂 0.1°/hr) |
| 防跌落 | 无 | VL53L4CD TOF ×2 桌面边缘检测 |
| 交互 | 无触摸 | 电容触摸 "摸头杀" |
| 唤醒词 | 无 | ESP-SR 离线 "嘿企鹅" |
| 充电 | USB 手动 | 弹簧触点 + IR 引导自动充电坞 |
| 摄像头 | 无 | OV2640 200W 拍照 |
| 通信 | WiFi 仅 | WiFi + BLE GATT 手机 App |
| App | WebUI 仅 | React Native 跨平台 App |
| 成本 | ¥486 | ¥589 |
# 1. 安装 PlatformIO
pip install platformio
# 2. 编译固件
cd firmware
pio run
# 3. 烧录
pio run -t upload
# 4. 上传 WebUI 到 SPIFFS
pio run -t uploadfs
# 5. 连接 PenguinBot WiFi AP
# SSID: PenguinBot-XXXX 密码: penguin123
# 浏览器打开 http://192.168.4.1PenguinBotV3/
├── firmware/ # ESP32-S3 固件 (PlatformIO)
│ ├── platformio.ini
│ ├── src/
│ │ ├── main.cpp # 入口 + 8 FreeRTOS 任务
│ │ ├── config.h # V3 GPIO 重映射 + 全系统配置
│ │ ├── balance/ # 平衡控制 (ICM-42688-P SPI + 级联PID + TOF边缘)
│ │ ├── motor/ # TB6612 驱动 + AS5600 编码器 + 里程计
│ │ ├── servo/ # PCA9685 驱动 + 关键帧动画引擎
│ │ ├── display/ # ST7789 TFT 驱动 + 表情精灵 + V3 图标
│ │ ├── comm/ # WiFi AP + WebSocket + JSON + BLE GATT
│ │ ├── sensors/ # [NEW] TOF ×2 / Touch / IR 传感器
│ │ ├── audio/ # INMP441 麦克风 + ESP-SR 离线唤醒词
│ │ ├── ai/ # AI 对话服务 + LLM 接口
│ │ ├── charging/ # [NEW] 充电坞状态机 + IR 引导
│ │ ├── vision/ # [NEW] OV2640 摄像头 + 视觉任务
│ │ ├── system/ # 电池监测 + 环形日志
│ │ └── ui/ # SPIFFS WebUI + V3 新增 API
│ └── data/ # V3 WebUI 静态资源
│ ├── index.html # 7 标签页 (仪表盘/PID/舵机/移动/AI/拍照/系统)
│ ├── style.css # TOF 仪表 / Dock 面板 / 摄像头 / BLE 样式
│ └── app.js # JPEG 分片接收 / TOF 仪表 / Dock UI / 触摸事件
├── mechanical/ # OpenSCAD 3D 模型 (V3 紧凑设计)
│ ├── config.scad # V3 尺寸参数 + PCB + TOF + 摄像头 + 充电坞ESP32-S3 定制PCB (56×38mm 4层板)
├── SPI3 → ICM-42688-P (1kHz IMU, 互补滤波 α=0.99)
├── SPI2 → ST7789 2.0" TFT (240×320)
├── I2C0 → PCA9685舵机 + VL53L4CD×2 TOF (0x54/0x55)
├── 8-bit Parallel → OV2640 摄像头 (GPIO 分时复用)
├── GPIO → TB6612FNG → N20 ×2 (编码器电机)
├── I2S → MAX98357 → Speaker + INMP441 麦克风
├── Touch13 (GPIO14) → 电容触摸 "摸头杀"
├── IR (GPIO17 TX / GPIO18 RX) → 充电坞引导
├── ADC → 电池电压 + 充电触点电压检测
├── WiFi AP / STA → WebSocket → WebUI
└── BLE (NimBLE) → GATT 4通道 → 手机App| 任务 | 频率 | 核心 | 栈 | 功能 |
|---|---|---|---|---|
| balance | 200Hz | Core 1 | 4096 | 级联PID + TOF边缘急停 |
| servo | 50Hz | — | 4096 | 舵机 + TOF + Touch 传感器 |
| comm | 20Hz | — | 12288 | WebSocket + BLE 遥测 + 唤醒词推理 |
| display | 30Hz | — | 8192 | TFT 表情 + 状态图标 |
| conversation | 50Hz | — | 8192 | AI 对话状态机 |
| dock | 10Hz | — | 4096 | 充电坞状态机 + IR 解码 |
| vision | 5Hz | — | 16384 | 摄像头拍照 + 视觉任务 |
| monitor | 1Hz | — | 2048 | 电池监控 + 低电自动回充 |
| 类别 | V2 金额 | V3 金额 |
|---|---|---|
| 电子元器件 | ¥281.5 | ¥384.5 |
| 紧固件 | ¥10 | ¥9 |
| 3D 打印耗材 | ¥195 | ¥195 |
| 合计 | ¥486 | ¥589 |
详见: PenguinBot-V3-Design.md
| Qty | Value | Footprint | References |
|---|---|---|---|
| 8 | 10k | Resistor_SMD:R_0603_1608Metric | R1, R2, R3, R4, R5, R6, R7, R8 |
| 6 | 100k | Resistor_SMD:R_0603_1608Metric | R9, R10, R11, R12, R13, R14 |
| 4 | 100R | Resistor_SMD:R_0603_1608Metric | R17, R18, R19, R20 |
| 4 | 100nF | Capacitor_SMD:C_0603_1608Metric | C6, C7, C8, C9 |
| 4 | 10uF | Capacitor_SMD:C_0805_2012Metric | C1, C2, C3, C4 |
| 4 | — | MountingHole:MountingHole_2.2mm_M2 | MH, MH, MH, MH |
| 2 | 10R | Resistor_SMD:R_0603_1608Metric | R21, R22 |
| 2 | 1k | Resistor_SMD:R_0603_1608Metric | R15, R16 |
| 2 | 1uF | Capacitor_SMD:C_0402_1005Metric | C14, C15 |
| 2 | 22pF | Capacitor_SMD:C_0402_1005Metric | C10, C11 |
| 2 | 4.7uF | Capacitor_SMD:C_0603_1608Metric | C12, C13 |
| 1 | 10uF | Capacitor_SMD:C_0603_1608Metric | C5 |
| 1 | 1N4148WS | Diode_SMD:D_SOD-323 | D2 |
| 1 | 2A PTC | Resistor_SMD:R_1812 | F1 |
| 1 | 32.768kHz | Crystal:Crystal_SMD_3215-2Pin_3.2x1.5mm | X2 |
| 1 | 4.7uH 3.3V | Inductor_SMD:L_CD54_5.2x5.8mm | L2 |
| 1 | 4.7uH 5V | Inductor_SMD:L_CD54_5.2x5.8mm | L1 |
| 1 | 40MHz | Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm | X1 |
| 1 | AMS1117-3.3 | Package_TO_SOT_SMD:SOT-223-3_TabPin2 | U6 |
| 1 | BOOT | Button_SMD_SW:SW_Push_1P1T_PTS645 | SW1 |
| 1 | Battery 2S | Connector_JST:JST_XH_B2B-XH-A | J2 |
| 1 | DEBUG | TestPoint:TestPoint_Pad_D1.0mm | TP3 |
| 1 | Dock Contact L | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J13 |
| 1 | Dock Contact R | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | J14 |
| 1 | ENC Left | Connector_JST:JST_XH_B3B-XH-A | J7 |
| 1 | ENC Right | Connector_JST:JST_XH_B3B-XH-A | J8 |
| 1 | ESP32-S3-WROOM-1-N16R8 | RF_Module:ESP32-S3-WROOM-1 | U1 |
| 1 | GND | TestPoint:TestPoint_Pad_D1.0mm | TP2 |
| 1 | Green PWR | LED_SMD:LED_0603_1608Metric | LED2 |
| 1 | ICM-42688-P | Sensor_Motion:ICM-42688-P_LGA-14_2.5x3mm | U4 |
| 1 | INMP441 Mic | Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_Vertical | J4 |
| 1 | MAX98357 Spk | Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_Vertical | J5 |
| 1 | Motor L | Connector_JST:JST_XH_B2B-XH-A | J9 |
| 1 | Motor R | Connector_JST:JST_XH_B2B-XH-A | J10 |
| 1 | OV2640 Camera | Connector_FFC-FPC:Hirose_FH12-24S-0.5SH | J15 |
| 1 | PCA9685PW | Package_SO:TSSOP-28_4.4x9.7mm_P0.65mm | U3 |
| 1 | POWER | Button_Switch_THT:SW_SPDT_MSK-12C02 | SW2 |
| 1 | PWR | TestPoint:TestPoint_Pad_D1.0mm | TP1 |
| 1 | Red CHG | LED_SMD:LED_0603_1608Metric | LED3 |
| 1 | SS34 | Diode_SMD:D_SMA | D1 |
| 1 | ST7789 TFT | Connector_PinHeader_2.54mm:PinHeader_1x08_P2.54mm_Vertical | J3 |
| 1 | SY8089 3.3V | Package_TO_SOT_SMD:SOT-23-5 | U5B |
| 1 | SY8089 5V | Package_TO_SOT_SMD:SOT-23-5 | U5A |
| 1 | TB6612FNG | Package_SO:SSOP-24_5.3x8.2mm_P0.65mm | U2 |
| 1 | TOF Left | Connector_JST:JST_XH_B4B-XH-A | J11 |
| 1 | TOF Right | Connector_JST:JST_XH_B4B-XH-A | J12 |
| 1 | USB-C | Connector_USB:USB_C_Receptacle_GCT_USB4105 | J1 |
| 1 | VS1838B IR | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | J6 |
| 1 | WS2812B | LED_SMD:LED_WS2812B-3535 | LED1 |

NuttyShell/NuttyBadge
NuttyBadge: A NuttyShell crafted multi-tool. Opensourced Hardawre and Software

fdiwth/tvc-drone
This repository contains the documentation, hardware designs, and source code for a Thrust Vector Control (TVC) drone.

ajisrawi/DroneMagNav2.0
DroneMagNav 2.0 - survey-fluxgate magnetic-anomaly navigation board for drones (IGRF-14 + EMAG2v3 continued to flight altitude)

AMOVFC/PanTilt
Three projects live in this folder. They share NewLibrary.kicadsym, TMC2209.pretty and the same philosophy: nothing on the board needs precision placement, every active part is a module in a socket.

wvianna/mcp-kicad-vscode
Workspace que combina um servidor MCP para automação de design de PCB com KiCad e o projeto de hardware (placa de circuito impresso) desenvolvido com ele.


VGManasa/PCB-DESIGNS
A collection of PCB designs created using KiCad, including power supply, embedded, and electronics learning projects.

It measures 56 × 38 mm and has 4 copper layers, 1.6 mm thick.
78 parts, built around the ESP32-S3-WROOM-1-N16R8, PCA9685PW, AMS1117-3.3 and ICM-42688-P. 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.
From the zhangshua1/PenguinBotV3 repository on GitHub, at the commit this page was made from: the board is pcb/penguinbot_v3.kicad_pcb and its schematic pcb/penguinbot_v3.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Its repository states no licence, so its author keeps all rights: ask zhangshua1 before reusing the design.