86 lines
3.7 KiB
Markdown
86 lines
3.7 KiB
Markdown
|
# SmartCube
|
||
|
|
|
||
|
|
**SmartCube** is a compact and customizable project using the ESP8266 D1 Mini. It features a rechargeable power supply, three input buttons, an SSD1306 OLED display for user interface, and a piezo buzzer for sound.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Features
|
||
|
|
- **Microcontroller**: ESP8266 D1 Mini (WeMos)
|
||
|
|
- **Display**: SSD1306 OLED (128x64 resolution)
|
||
|
|
- **Input**: Three push buttons
|
||
|
|
- **Sound**: Piezo buzzer for audio feedback
|
||
|
|
- **Power**: 14250 rechargeable battery with TP4056 charging module
|
||
|
|
- **Case**: 3D-printable design included in `/hardware` directory
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Bill of Materials
|
||
|
|
|
||
|
|
| **Component** | **Quantity** | **Description** | **Notes** |
|
||
|
|
|---------------------------|--------------|-------------------------------------------|---------------------------------------------|
|
||
|
|
| ESP8266 D1 Mini | 1 | Microcontroller module | Base of the SmartCube |
|
||
|
|
| SSD1306 OLED Display | 1 | 128x64 resolution, I2C interface | Ensure proper wiring for SDA/SCL |
|
||
|
|
| 14250 Rechargeable Battery| 1 | Lithium-ion battery | For powering the cube |
|
||
|
|
| TP4056 Module | 1 | Charging and protection circuit | For battery management |
|
||
|
|
| Push Buttons | 3 | Tactile push buttons | Used for user input |
|
||
|
|
| Piezo Buzzer | 1 | Active buzzer | Provides audio feedback |
|
||
|
|
| Resistors (10kΩ) | 3 | Pull-down resistors for buttons | Ensures stable button input |
|
||
|
|
| Wires / Dupont Connectors | Several | For connections | Ensure reliable wiring |
|
||
|
|
| Enclosure (Optional) | 1 | 3D-printed or custom-made case | For housing the components |
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Pin Connections
|
||
|
|
|
||
|
|
### OLED Display Settings
|
||
|
|
```c
|
||
|
|
#define SCREEN_WIDTH 128
|
||
|
|
#define SCREEN_HEIGHT 64
|
||
|
|
#define OLED_RESET -1
|
||
|
|
#define FRAMERATE 8
|
||
|
|
```
|
||
|
|
Connect the OLED display via I2C to the D1 Mini:
|
||
|
|
- **SDA**: D2 (GPIO4)
|
||
|
|
- **SCL**: D1 (GPIO5)
|
||
|
|
|
||
|
|
### Buttons and Buzzer
|
||
|
|
```c
|
||
|
|
#define PIN_BTN_L 12 // D6
|
||
|
|
#define PIN_BTN_M 13 // D7
|
||
|
|
#define PIN_BTN_R 15 // D8
|
||
|
|
#define PIN_BUZZER 0 // D3
|
||
|
|
```
|
||
|
|
- Button Left (PIN_BTN_L): GPIO12
|
||
|
|
- Button Middle (PIN_BTN_M): GPIO13
|
||
|
|
- Button Right (PIN_BTN_R): GPIO15
|
||
|
|
- Piezo Buzzer (PIN_BUZZER): GPIO0
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Assembly Instructions
|
||
|
|
|
||
|
|
1. **Power Supply Setup**: Connect the 14250 battery to the TP4056 module for safe charging and protection. Wire the output of the TP4056 to power the D1 Mini.
|
||
|
|
2. **OLED Display**: Solder connections for SDA and SCL to the respective pins on the D1 Mini.
|
||
|
|
3. **Buttons**: Attach each button to the specified GPIO pins with pull-down resistors to ensure reliable input.
|
||
|
|
4. **Buzzer**: Connect the piezo buzzer to GPIO0. Ensure proper polarity.
|
||
|
|
5. **Enclosure (Optional)**: Assemble all components in a secure housing.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
- Power the device using the rechargeable battery.
|
||
|
|
- Use the buttons for input.
|
||
|
|
- Visual feedback is displayed on the OLED screen.
|
||
|
|
- Audio feedback is provided through the piezo buzzer.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Notes
|
||
|
|
|
||
|
|
- This is still a work in progress
|
||
|
|
- Ensure all connections are secure to avoid malfunction.
|
||
|
|
- Test the circuit thoroughly before placing it in the enclosure.
|
||
|
|
- Handle the battery with care to prevent damage.
|
||
|
|
|
||
|
|
For questions or additional details, feel free to reach out!
|