tomislav/SmartCube_ESPHome
1
0
Fork 0
Code Activity
Files
0605e635780a7fdc7501855b9b7e10de30a4338e
SmartCube_ESPHome/Readme.md
Tomislav Kopić 0605e63578 Correct readme
2025-09-16 21:48:04 +02:00

1.5 KiB
Raw Blame History

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.

1️⃣ Clone the Repository

If you are on Windows, open Command Prompt (CMD):

  1. Press Win + R, type cmd, and press Enter.

  2. Clone the repo:

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.
  2. During installation, check “Add Python to PATH”.
  3. Verify installation in CMD:
python --version

3️⃣ Install ESPHome

Install ESPHome using Python’s package manager:

pip install esphome

Check installation:

esphome version

4️⃣ Flash the SmartCube

  1. Connect your D1 Mini to your PC using a data-capable USB cable.

  2. Upload the firmware:

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 (usually your D1 Mini) by typing its number and pressing Enter.

ESPHome will compile and flash the firmware.

  1. After flashing, the cube will connect to the Wi-Fi you set in the config.

    • If it fails, it will start a fallback AP named SmartCube with password 12345678.
    • Connect to this AP to configure your Wi-Fi.