ESPHome telepítése Ubuntu/Linux alatt (Python alapokon) standalone mód

Részletes, Ubuntu/Linux rendszeren használható, lépésről lépésre haladó útmutató az ESPHome telepítéséhez Python segítségével. Ez a módszer teljes szabadságot ad YAML fájlok szerkesztésében, firmware fordításban és feltöltésben is, grafikus felületen
Author: HESTORE Hungary Kft. / Ecker János

Ez a módszer lehetővé teszi, hogy:

• saját .yaml konfigurációból fordítsunk firmware-t ESP8266/ESP32 eszközökhöz,
• USB-n vagy WiFi-n keresztül feltöltsük azokat,
• ESPHome dashboardot használjunk böngészőből, grafikus felületen

Mit fog tartalmazni ez a telepítés?

• Teljes ESPHome CLI telepítése Python segítségével
• Virtuális környezet használata (elkerülve a rendszer-szintű zavarokat)
• USB-n keresztüli feltöltés támogatása
• HESTORE kínálatában szereplő ESP modulok támogatása (pl. ESP8266, ESP32, ESP32-C3)

Előkészületek: amire szükség lesz

Eszköz vagy szoftver	Megjegyzés	Termék
Python 3.10 vagy újabb	Telepítéshez szükséges
pip csomagkezelő	A Python csomagtelepítője
Git (nem kötelező, de ajánlott)	Fejlettebb munkafolyamathoz hasznos
USB-UART átalakító vagy microUSB kábel	A modul típusától függően szükséges	AK-300110-010-S 100.345.35 1+: 685 Ft
Egy ESP32 vagy ESP8266 modul a HESTORE-ból	Ajánlott: Wemos D1 Mini, ESP32-WROOM, ESP8266 NodeMCU, stb.	WEMOS-D1-MINI 100.379.01 1+: 2 094 Ft

1. Python és PIP telepítése Ubuntura

Bizonyosodjunk meg róla, hogy fel van-e telepítve a python3 és a pip3

apt install python3 python3-pip

Telepítés után ellenőrizzük terminálban (Win + R → cmd):

python3 --version
pip3 --version

2. Virtuális környezet létrehozása (ajánlott)

1. Hozzunk létre egy új mappát, pl. /home/usernevunk/esphome-hestore
2. Nyissunk egy parancssort a mappában:
BASHMásolás

python3 -m venv .venv
source .venv/bin/activate

2b. PIP frissítése

BASHMásolás

python3 -m pip install --upgrade pip

3. ESPHome telepítése pip-pel

Az aktív környezetben (abban a parancssori ablakban futtassuk, mint ahol a venv-et létrehoztuk):

pip3 install esphome

Telepítés után ellenőrizzük:

esphome version

4. ESPHome dasboard indítása

esphome dashboard .

Nyissuk meg ezután böngészőben az alábbi URL-t, hogy elérjük a grafikus Dashboard felületet: http://127.0.0.1:6052

A grafikus felületen pedig a + NEW DEVICE gomb segítségével el is készíthetjük az első ESPHome eszközünk konfigurációját.

5. Eszköznév, alap WiFi információk megadása

1. A +NEW DEVICE gombra kattintva egy wizard nyílik meg, ahol bekéri az eszköz nevét (például: testproject-hestore)
2. Csatlakoztassuk a számítógéphez USB-n az ESP fejlesztői panelt
3. Nyissuk egy új terminál ablakot, és ellenőrizzük hogy rendben felismerte-e (pl. dmesg)
4. Az ESPHome Dashboard-on folytassuk az új eszköz létrehozási folyamatot és az Installation dialógusok kattintsunk a CONNECT gombra.
5. A böngészőben megnyíló párpeszédpanel kéri, hogy válasszuk ki az eszköz tty* portját.
6. Ezt követően elkezdődik az első projekt létrehozása automatikusan és alapkódok eszközre töltése (több percet is igénybe vehet)
7. A WiFi csatlakozáshoz bekéri az AP-nk SSID-jét és a hozzá való jelszót.

Az első feltöltésnél szükség van fizikai kapcsolatra (pl. microUSB, USB–UART). Később OTA (WiFi) is elegendő.

6. YAML szerkesztése és fordítás

1. A létrejött projekt kártyáján kattintsunk az EDIT gombra a YAML szerkesztő megjelenítéséhez
2. A fájl szerkesztését követően a SAVE segítségével mentsük el a YAML fájlt (jobb felső sarok)
3. Az INSTALL gomb megnyomásával elindítható a fordítás (platformio)
4. A fordítás végeztével válasszuk a Plug into this computer lehetőséget, hogy USB-n csatlakoztatott eszközre feltöltsük a fordított programot.

Fontos figyelmeztetés

Tipikus kompatibilis hardverek a HESTORE-tól az első kísérletezésekhez

Megnevezés	HESTORE cikkszám / típusjavaslat
Wemos D1 mini	WEMOS-D1-MINI 100.379.01 1+: 2 094 Ft
ESP32-WROOM-32 fejlesztőpanel	ESP-WROOM-32-ESP32S 100.446.79 1+: 2 158 Ft
USB-microUSB kábel	AK-300110-010-S 100.345.35 1+: 685 Ft
USB–UART átalakító (3.3V/5V jumperrel)	FT232RL-M-USB-C 100.480.91 1+: 652 Ft
USB–UART átalakító (3.3V/5V jumperrel)	CH340G-M 100.378.97 1+: 527 Ft

Összefoglaló

Az ESPHome CLI telepítése Python segítségével Ubuntu/Linux rendszerre kiváló kiindulási pont az okoseszközök világába. Ez a módszer teljes szabadságot kínál a fejlesztésben, verziókezelésben és modulkonfigurálásban. A HESTORE.hu kínálatából könnyedén beszerezhetők a kompatibilis ESP modulok és kiegészítők, így gyorsan el lehet kezdeni a saját automatizált otthon kialakítását.