Getting Started With ESPHome Workshop: Difference between revisions

From HOPE Wiki
Fortuna (talk | contribs)
Fortuna (talk | contribs)
Add links
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Getting Started With ESPHome: From Zero to Cool workshop =
= Getting Started With ESPHome: From Zero to Cool workshop =


== Abstract ==
⚠️ '''You must bring: a laptop + a USB-C data cable (not just charging).''' ⚠️


This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about home automation.
📆 '''Date:''' Day 2, Saturday, 16-August-2025<br>
🕔 '''Time:''' 5:00pm - 6:30pm<br>
📍 '''Location:''' Tobin 219 (Workshop A)<br>
[http://Schedulehttps://schedule.hope.net/hope16/talk/T7XAL9/ Schedule]


== Day / Time / Location ==
This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about creating IoT devices and home automation.


'''Date:''' Day 2, Saturday, 16-August-2025<br>
By '''Vinicius Fortuna''' — [https://www.viniciusfortuna.com Home] · [https://www.linkedin.com/in/vfortuna/ LinkedIn] · [https://mastodon.social/@vinifortuna Mastodon]
'''Time:''' 5:00pm - 6:30pm<br>
'''Location:''' Tobin 219 (Workshop A)


Schedule entry: https://schedule.hope.net/hope16/talk/T7XAL9/
== Materials ==
 
The workshop is free to attend, but you’ll need an '''ESP32 device''' (ESP32-C3 preferred), plus a '''laptop''' and '''USB-C data cable'''.
== Full Description ==
 
== Registration -- NOT required ==


<span style="color:orange">'''NOTE:  You do NOT need to register to take this workshop<br>-- please show up early to ensure a seat at Tobin 219 (Workshop A).'''<br>
'''ESP32 devices:''' I’ll have '''20 ESP32-C3 Super Mini''' boards available for purchase at '''$4''' (cash, crypto, Venmo, PayPal). You can also borrow one if available; priority goes to folks purchasing.
 
== Presenter(s) ==
 
'''Vinicius Fortuna'''<br>
[https://www.viniciusfortuna.com Home Page] - [https://www.linkedin.com/in/vfortuna/ LinkedIn] - [https://mastodon.social/@vinifortuna Mastodon]
 
== Materials ==


You will need:
'''Bring last year’s badge:''' You can use the [[HOPE XV Electronic Badge]] (it has an ESP32-C3 inside).


* A '''ESP32 development board''' that you will program.
'''USB-C data cables:''' I’ll bring ~20 to loan during the session (please return). If your laptop doesn’t have USB-C, bring your own USB-A↔USB-C cable or adapter. '''Make sure it’s a data-capable cable.'''
* A '''laptop''', to program your board (with power cable as needed)
* A '''USB-C *data* cable''', to connect your laptop to the development board


No soldering or other equipment is needed.
No soldering or extra tools needed. No registration; first-come, first-served seating. If you lack materials, you can still sit in if space allows—priority to those ready to flash.


20 [https://www.amazon.com/dp/B0DPSNVWB2/ref=sspa_dk_detail_3 ESP32-C3 Super Mini board] will be available for purchase at $5 each (cash, crypto, Venmo, Paypal accepted). You can borrow one for free if available, but preference will be given to those acquiring a board. You can use last year's [[HOPE XV Electronic Badge]], please bring it if you have one (it has a ESP32-C3 inside!).
== Preparation ==


I'll have 20 USB-C to USB-C data cables available to borrow if needed (please return them), but it's best if you bring your own. You must bring your own cable or an adaptor if your laptop USB is not Type C (usually Type A). '''Make sure it's a data cable.''' Your original phone charger cable will probably work.
This can be problematic and doing it in advance can ensure the workshop can get started without delays.


If you do not have the materials needed, you can still spectate if there's extra space available. Preference will be given to those with the required materials.
*[https://esphome.io/guides/installing_esphome.html Install ESPHome]
* Have https://github.com/fortuna/ESPHomeWorkshop open in your laptop to copy the code and follow along.


== Required Software / What to bring ==
== Quick links ==


laptop with ESPHome and text editor (Visual Code Studio recommended) installed
Workshop code: https://github.com/fortuna/ESPHomeWorkshop


<pre>
ESPHome docs: [https://esphome.io/#getting-started Getting Started] - [https://esphome.io/components/ List of Components]
# Create and enter workspace folder
mkdir esphome
cd esphome


# Create and activate Python environment
Home Assistant ESPHome integration:
python3 -m venv venv
https://www.home-assistant.io/integrations/esphome/
source venv/bin/activate


# Install and check ESPHome tool
Community:
pip3 install esphome
esphome --version
</pre>


== Links ==
* ESPHome: [https://discord.com/invite/KhAMKrd Discord Server], [https://community.home-assistant.io/c/esphome/36 Forum]
* Home Assistant: [https://discord.com/invite/KhAMKrd Discord Server], [https://community.home-assistant.io/ Forum]

Latest revision as of 20:29, 17 August 2025

Getting Started With ESPHome: From Zero to Cool workshop

⚠️ You must bring: a laptop + a USB-C data cable (not just charging). ⚠️

📆 Date: Day 2, Saturday, 16-August-2025
🕔 Time: 5:00pm - 6:30pm
📍 Location: Tobin 219 (Workshop A)
Schedule

This hands-on workshop introduces participants to ESPHome, an open-source platform for integrating ESP32 microcontrollers with home automation systems. Participants will learn the fundamentals of configuring ESPHome YAML files to control inputs and outputs, connect to Wi-Fi, enable remote access, perform over-the-air (OTA) updates, integrate with Home Assistant, and add external sensors or components. Attendees will walk away with the knowledge to create their own simple IoT solutions using ESPHome. No programming or soldering skills are required, making this workshop highly accessible to beginners and anyone curious about creating IoT devices and home automation.

By Vinicius FortunaHome · LinkedIn · Mastodon

Materials

The workshop is free to attend, but you’ll need an ESP32 device (ESP32-C3 preferred), plus a laptop and USB-C data cable.

ESP32 devices: I’ll have 20 ESP32-C3 Super Mini boards available for purchase at $4 (cash, crypto, Venmo, PayPal). You can also borrow one if available; priority goes to folks purchasing.

Bring last year’s badge: You can use the HOPE XV Electronic Badge (it has an ESP32-C3 inside).

USB-C data cables: I’ll bring ~20 to loan during the session (please return). If your laptop doesn’t have USB-C, bring your own USB-A↔USB-C cable or adapter. Make sure it’s a data-capable cable.

No soldering or extra tools needed. No registration; first-come, first-served seating. If you lack materials, you can still sit in if space allows—priority to those ready to flash.

Preparation

This can be problematic and doing it in advance can ensure the workshop can get started without delays.

Quick links

Workshop code: https://github.com/fortuna/ESPHomeWorkshop

ESPHome docs: Getting Started - List of Components

Home Assistant ESPHome integration: https://www.home-assistant.io/integrations/esphome/

Community: