tomislav/SmartCube_ESPHome
1
0
Fork 0
Code Activity
Files
430a4491d212146b4ff32d86db414cb2020a9ff1
SmartCube_ESPHome/Readme.md
Tomislav Kopić 430a4491d2 Initial commit
2025-09-16 21:41:15 +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. Navigate to the folder where you want to store the project (optional):
cd C:\Users\YourUsername\Downloads
  1. Clone the repo:
git clone https://git.kopic.hr/tomislav/SmartCube_ESPHome
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 micro-USB cable.

  2. Upload the firmware:

esphome run smartcube.yaml

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.