Getting Started¶
Welcome to SpoolBuddy! This guide will walk you through building your own filament management station.
Build Process¶
- **Order Components** - Review the [Hardware Required](hardware.md) page and order all components. Allow 1-4 weeks for shipping.
- **Wire Components** - Follow the [Wiring Guide](wiring.md) to connect all components correctly.
- **Assemble Station** - Use the [Assembly Guide](assembly.md) for physical mounting.
- **Flash Firmware** - Follow [Firmware Installation](firmware.md) to program the ESP32.
- **Setup Backend** - Configure the server using [Software Setup](software.md).
- **Start Using** - Connect to your Bambu printer and start managing your filament!
What You'll Need¶
Hardware (~$100-150)¶
| Component | Purpose |
|---|---|
| Elecrow CrowPanel 7.0" Advance | Display + ESP32-S3 |
| Raspberry Pi Pico | NFC reader controller |
| SparkFun Qwiic NAU7802 | Scale ADC |
| 5kg Load Cell | Weight sensor |
| PN5180 NFC Reader | RFID tag reading |
| 22AWG Silicone Wire | Connections |
| M4x25 Screws | Mounting |
Tools¶
- Soldering iron and solder
- Wire strippers
- Small screwdrivers
- Multimeter (recommended)
Software¶
- Python 3.10+ for the backend server
- Node.js 18+ for frontend development
- PlatformIO or Arduino IDE for firmware
Network¶
- WiFi network accessible by both SpoolBuddy and your Bambu printer
- Printer's access code and serial number
Quick Reference¶
Important Warnings¶
- PN5180 is 3.3V only - 5V will damage it!
- RC522 won't work - need PN5180 for ISO 15693
Key Specs¶
- Display: 800x480 IPS touch
- Scale: 5kg capacity, 24-bit ADC
- NFC: ISO 15693 (Bambu Lab tags)
- Power: USB-C 5V/2A
Next Steps¶
Ready to start building?