82 lines
1.8 KiB
Markdown
82 lines
1.8 KiB
Markdown
# SmartCube V1
|
||
|
||
**SmartCube** is a tiny, customizable desk toy built with an ESP8266 D1 Mini. It can display messages on an OLED, monitor battery voltage, control a buzzer, and respond to button presses.
|
||
|
||
The guide how to make one is [available here](https://git.kopic.hr/tomislav/SmartCubeV1)
|
||
|
||
---
|
||
|
||
# How to flash EPSHome on the SmartCube?
|
||
|
||
## 1️⃣ Clone the Repository
|
||
|
||
You may need to install [git first](https://git-scm.com/downloads/win)
|
||
If you are on **Windows**, open **Command Prompt (CMD)**:
|
||
|
||
1. Press **Win + R**, type `cmd`, and press **Enter**.
|
||
|
||
2. Clone the repo:
|
||
|
||
```bash
|
||
git clone https://git.kopic.hr/tomislav/SmartCube_ESPHome.git
|
||
cd SmartCube_ESPHome
|
||
```
|
||
|
||
This downloads all the files for your SmartCube.
|
||
|
||
---
|
||
|
||
## 2️⃣ Install Python
|
||
|
||
1. Download Python 3.13+ from [python.org](https://www.python.org/downloads/).
|
||
2. During installation, **check “Add Python to PATH”**.
|
||
3. Verify installation in CMD:
|
||
|
||
```bash
|
||
python --version
|
||
```
|
||
|
||
---
|
||
|
||
## 3️⃣ Install ESPHome
|
||
|
||
Install ESPHome using Python’s package manager:
|
||
|
||
```bash
|
||
pip install esphome
|
||
```
|
||
|
||
Check installation:
|
||
|
||
```bash
|
||
esphome version
|
||
```
|
||
|
||
---
|
||
|
||
## 4️⃣ Flash the SmartCube
|
||
|
||
1. Connect your SmartCube to your PC using a **data-capable USB cable**.
|
||
|
||
2. Upload the firmware:
|
||
|
||
```bash
|
||
esphome run smartcube.yaml
|
||
```
|
||
|
||
**3. ESPHome may ask which device to flash.**
|
||
Look for the entry that says something like:
|
||
|
||
```
|
||
(USB Serial Port (COMX))
|
||
```
|
||
|
||
Select that one by typing its number and pressing **Enter**.
|
||
|
||
ESPHome will compile and flash the firmware.
|
||
|
||
4. After flashing, the cube will connect to the Wi-Fi if you configured it in the smartcube.yaml file.
|
||
|
||
* If you did not, that's okay, it will start a fallback AP named **SmartCube** with password **12345678**.
|
||
* Connect to this AP with your phone or PC to configure the Wi-Fi.
|