Skip to content

irk645/levoit-esphome

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Levoit ESPHome Configs

ESPHome firmware configurations for Levoit Core 200S and Core 300S air purifiers. Flash these to break free from the VeSync cloud and get native Home Assistant control.

Supported Models

  • Levoit Core 200S
  • Levoit Core 300S

Watch the Video

Full walkthrough including teardown, wiring, flashing, and Home Assistant setup: [YouTube Link Coming Soon]

Credits

The ESPHome component that makes this possible was built by acvigue. This repo provides ready-to-use configs built on top of that component.

What You'll Need

  • Home Assistant with the ESPHome add-on installed
  • A USB UART adapter (3.3V logic — confirmed working: DSD Tech SH-U09CS)
  • Hook probe jumper wires
  • Phillips screwdriver
  • 300S only: UART adapter powers the board via 3.3V
  • 200S only: Mains power required during flashing — have an extension cord handy

Quick Start

1. Set Up Your Secrets

Copy secrets.yaml.example to secrets.yaml and fill in your values:

wifi_ssid: "YourNetworkName"
wifi_password: "YourWiFiPassword"
ap_password: "YourFallbackPassword"
api_key: "YourAPIKey"
ota_password: "YourOTAPassword"

Never commit your secrets.yaml file. It is already in .gitignore.

2. Create the Device in ESPHome

  • Open ESPHome in Home Assistant
  • Click New Device and skip the wizard
  • Paste in the config for your model from the /configs folder
  • Click Install → Manual Download → Modern Format
  • Save the downloaded .bin file

3. Flash the Firmware

See the video for the full wiring guide. Brief summary:

  • Connect UART adapter: TX→RX, RX→TX, GND→GND
  • 300S: Connect 3.3V from adapter to board VCC
  • 200S: Skip VCC connection, power from mains instead
  • Jump IO0 to GND before applying power to enter bootloader mode
  • Open ESPHome Web, connect, and flash your .bin
  • Remove IO0 jumper once erasing begins
  • Reassemble and power on

4. Adopt in Home Assistant

The purifier will appear as a discovered device in Home Assistant. Accept the adoption and your entities will be ready to use.

Entities

Both Models

  • Fan (with speed control)
  • Master Power switch
  • Display On/Off switch
  • Display Lock switch
  • Filter Reset button
  • Auto Mode select
  • WiFi Signal sensor
  • Uptime sensor

300S Only

  • PM2.5 sensor
  • Air Quality Index sensor

Multiple Units

Using more than one of the same model? Just duplicate the config file, give it a unique name, and update your secrets entries to match.

License

MIT

About

ESPHome configurations for Levoit air purifiers

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors