ESPHome Configuration

Full ESPHome setup for the Pico W with the purespa component.

Basic Configuration

esphome:
  name: intex-spa
  friendly_name: "Intex Spa"

rp2040:
  board: rpipicow

logger:
  level: INFO

api:
  encryption:
    key: !secret api_key

ota:
  - platform: esphome
    password: !secret ota_password

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  ap:
    ssid: "Intex-Spa Fallback"
    password: !secret fallback_password

web_server:
  port: 80

external_components:
  - source: ./components
    components: [purespa]

purespa:
  climate:
    name: "Water Temperature"
  power:
    name: "Power"
    icon: mdi:power
  filter:
    name: "Filter Pump"
    icon: mdi:pump
  bubble:
    name: "Bubbles"
    icon: mdi:chart-bubble
  heater:
    name: "Heater"
    icon: mdi:radiator
  error_text:
    name: "Error Code"
    icon: mdi:alert-circle

Exposed Entities

Climate Entity

Shows current temp, allows setting target (20-40°C), HVAC mode

Power Switch

Main power on/off — same as control panel power button

Filter Switch

Circulation pump on/off

Heater Switch

Heater on/off (shows standby when target reached)

Bubble Switch

Air bubbles on/off

Error Sensor

Text sensor showing error code if present

Secrets File

Create secrets.yaml in the same directory:

wifi_ssid: "YourWiFiNetwork"
wifi_password: "YourWiFiPassword"
api_key: "your-32-byte-base64-key"
ota_password: "your-ota-password"
fallback_password: "fallback-hotspot-password"

Installation Steps

1

Clone the component

git clone https://github.com/RealByron/PicoW-Intex-PureSpa

2

Create secrets.yaml

Add your WiFi credentials and encryption keys

3

First flash via USB

esphome run spa.yaml (hold BOOTSEL while connecting USB)

4

Subsequent updates via OTA

esphome run spa.yaml --device intex-spa.local

5

Add to Home Assistant

Auto-discovered via ESPHome integration

Web Dashboard

The web_server component provides a standalone dashboard at http://intex-spa.local/. No Home Assistant required — control the spa from any browser on your network.

Home Assistant Integration

Once connected, you'll have these entities in HA:

climate.intex_spa_water_temperature
switch.intex_spa_power
switch.intex_spa_filter_pump
switch.intex_spa_heater
switch.intex_spa_bubbles
sensor.intex_spa_error_code

Source: PicoW-Intex-PureSpa by RealByron