Getting Started
Prerequisites
You’re going to need the following items:
Steps
1. Install firmware on base station
You can either proceed with the automatic firmware installation via your webbrowser below or refer to the manual installation instructions.
1.1 Automatic installation via Browser
Just press the install button below with your device connected via usb:
If the serial port is not showing up, your computer might be missing the drivers for the USB serial chip used in your ESP device. These drivers work for most ESP devices:
1.2 Manual installation
- Download the latest released firmware for your ESP device
- Download one of the following tools to write the firmware to your ESP device:
- esptool.py or ESPHome-Flasher - we’re going to use ESPHome-Flasher here (Mac-Users, please take note of this bug first!)
- Connect your ESP device to your computer
- Start ESPHome-Flasher
- Select the appropiate serial port (should be automatically detected)
- Click “View Logs”
- Start flashing via the “Flash ESP” button
After the flash completed successfully, you should see the SSID you’re supposed to connect to in the next step on one of the last lines in the Console window:
2. Wifi/MQTT setup on base station
The ESP32 will launch a captive browser (under it’s own SSID) on first normal boot after flashing that will allow you to configure:
- WiFi settings
- MQTT settings
- Room name
- Discovery distance
3. Configure Home Assistant
See the page on configuring Home Assistant
Troubleshooting
If you’re having difficulty getting things set up and work properly, check out the troubleshooting page before you open an issue. It will help you determine what information you need to provide to identify and fix what’s gone wrong.