Unit Fader Home Assistant Integration

1. Preparation

1. Hardware

• 1 x Unit Fader
• 1 x AtomS3R
• 1 x HY2.0-4P Grove Cable (20cm)
• 1 x Home Assistant host (server, mini PC, NAS, etc.)

2. Software & versions

• Home Assistant 2026.2.0 or later
  • ESPHome Device Builder 2026.2.2 or later

2. Create Device

1. Open ESPHome Dashboard. If the initial wizard appears, click CONTINUE.

2. Click the green + button in the bottom right to create a new device.

3. Click New Device Setup to enter the device creation wizard.

4. Enter a device name and click NEXT.

5. Select the device type and click ESP32S3.

6. Click SKIP to skip the encryption key setup.

7. Click EDIT to open the YAML editor and customize the device configuration.

3. Device Configuration

3.1 Sensor configuration

Add the Sensor component to read the potentiometer value.

sensor:
  - platform: adc
    pin: GPIO1
    name: "Fader ADC"
    id: fader_adc
    update_interval: 100ms
    attenuation: 12db
    filters:
      - exponential_moving_average:
          alpha: 0.2

3.2 Light configuration

Add the Light component to control the LED strip.

light:
  - platform: esp32_rmt_led_strip
    rgb_order: GRB
    pin: GPIO2
    num_leds: 14
    name: "Fader LED Strip"
    id: led_strip
    chipset: ws2812

4. Build and Flash Firmware

4.1 Build firmware

1. After editing the YAML configuration, click SAVE in the top right, then click INSTALL.

2. In the popup dialog, select Manual Download.

3. Wait for the firmware to compile, then click Download and choose Factory format (Previously Modern) to save the firmware file locally.

4.2 Flash firmware

4. Connect AtomS3R to your computer using a USB Type-C cable. Open ESPHome Web and click CONNECT.

5. In the serial port selection dialog, select the correct port.

6. Click INSTALL.

7. Select the firmware file downloaded in step 3 and start flashing.

5. Start Using in Home Assistant

1. In Home Assistant, go to Settings > Devices & Services to open the integration management page.

2. In the Discovered section, find the Unit Fader device, click CONFIGURE, and follow the wizard to complete the setup.

3. After the device is added, you can view it in the Devices list.

4. Finally, add these sensor entities to a dashboard.