BETA — Open to testers. Tell us what to fix on @vomehome or via a tester code.

Build your own AUX-2-style box from parts

For most people the ready-made Home Assistant Connect AUX-2 is the better buy. If you want to see how it works, reuse parts you already have, or need a different mix of ports, here is a shopping list, the wiring and an ESPHome config that builds.

Updated 12 November 2026 esphomehardwarebluetoothz-wavehow-to


We have not built one of these yet

The config below is checked and compiled by ESPHome 2026.10.2. It is adapted from Nabu Casa's own AUX-2 firmware, with the pins changed to suit this board. Nobody here has wired one up and played music through it yet. Read it as a recipe we expect to work, and tell us if you get there first.

This box is a Bluetooth proxy, two RS-232 ports, a USB port for a Z-Wave or Zigbee stick, and an analogue or optical audio output, all on one PoE cable. That is most of Home Assistant Connect AUX-2. The software is the same ESPHome that runs on the real one. The real one is open source, so we started from it.

Buy one or build one?

Buy one, unless you have a reason not to. The parts below come to roughly 480 SEK at sale prices. An AUX-2 costs €59, about 650 SEK. Building it yourself saves you only about 170 SEK, and the ready-made box gives you all of this for that difference:

  • you support Home Assistant. Nabu Casa makes the AUX-2. It employs many of the people who build Home Assistant and ESPHome, and it funds the Open Home Foundation, which owns them. Buying its hardware is one of the most direct ways to pay for the software this box, and the rest of your smart home, runs on. A board from AliExpress pays for none of it;
  • a case, CE marking and a warranty;
  • automatic analogue/optical switching: the AUX-2 detects which plug is in its jack, where here you choose from a drop-down;
  • Wi-Fi as a fallback, where this config is wired Ethernet only;
  • firmware updates from Nabu Casa, where here you build your own;
  • an evening back, and nothing to debug with a multimeter.

Build one if:

  • you already own some of the parts. The Waveshare board is the one in Home Assistant's official ZWA-2 PoE recipe, so you may have one in a drawer;
  • you want a different mix. You might want four serial ports and no audio, a camera instead of optical out, or a sensor bundle;
  • you want to learn how it works. Every part of the AUX-2 is visible here, and that is the best reason of the three.

Done properly, building saves little. If you will accept some compromises, it gets much cheaper: a bare development board on Wi-Fi and a phone charger does most of the same job for about a third of the price. See On a shoestring below.

The shopping list

This is how the parts fit together. Every module hangs off the one board, and the one network cable carries power in.

PCM5102A DAC TOTX177 2 × MAX3232 I²C sensor USB 2.0 hub ZWA-2 or ZBT-2 PoE switch analogue out, 3.5 mm optical out two DB9 serial ports SHT40, BME280 and so on optional or an RS-485 dongle power + network, 802.3af ESP32-S3 Waveshare ESP32-S3-ETH + PoE module Bluetooth on the chip 38 · 39 · 40 41 17/18 · 47/48 1 · 2 USB-C + OTG numbers are GPIO pins
The numbers on the left-hand lines are the GPIO pins each module uses. The hub is only needed for more than one USB device.

AliExpress prices in Swedish kronor (SEK) on 12 November 2026, during the 11.11 sale, which ends 18 November. Expect a little more afterwards. Hover over a price to see it in euros, at about 11 SEK to the euro.

Part Search for Price
Waveshare ESP32-S3-ETH with the PoE module ESP32-S3-ETH PoE, pick the Main-Board – POE option about 295 SEK (330 SEK out of the sale)
PCM5102A DAC board, for analogue audio GY-PCM5102 20–45 SEK
2 × MAX3232 board with a DB9 socket MAX3232 RS232 TTL DB9 7–30 SEK each
TOTX177 optical transmitter (3.3 V), for optical audio TOTX177 35–80 SEK for two
USB-C (male) to USB-A (female) adapter USB C OTG adapter about 45 SEK
Jumper wires and a small box about 50 SEK

The list does not include a Z-Wave or Zigbee stick or a PoE switch, and an AUX-2 doesn't come with them either.

Optional extras:

  • a small USB 2.0 hub (40–60 SEK), if you want more than one USB device;
  • a USB RS-485 dongle with a CH343 chip (about 100 SEK), for Modbus. It is the chip the AUX-2 firmware expects;
  • an I²C sensor such as an SHT40 or BME280 (20–40 SEK), in place of the AUX-2's Grove port.

If you want Bluetooth and Z-Wave over PoE and nothing else, the board on its own is enough.

Wiring

Every module runs from the board's 3.3 V and ground pins. The diagram shows which pin goes where. It shows pin names, not their positions on the header, so check the silkscreen on your board.

ESP32-S3 Waveshare ESP32-S3-ETH GPIO38GPIO39 GPIO40GPIO41 GPIO17GPIO18 GPIO47GPIO48 GPIO1GPIO2 3V3 GND 3V3 GND GY-PCM5102 analogue out L · G · R pads → 3.5 mm jack Pads on the back: FLT L · DEMP L · XSMT H FMT L · SCK to GND VINGND BCKLCKDIN TOTX177 → optical cable VCCGNDIN MAX3232 1MAX3232 2I²C sensor DB9 → deviceDB9 → deviceSHT40, BME280 VCCGNDTXDRXD VCCGNDTXDRXD VCCGNDSDASCL 3V33V3 3V33V33V3 GNDGND GNDGNDGND
Red labels go to the board's 3V3 pin, grey ones to GND. If a serial device never answers, swap that board's TXD and RXD wires first.
Board pin Goes to
GPIO38 PCM5102A BCK
GPIO39 PCM5102A LCK
GPIO40 PCM5102A DIN
GPIO41 TOTX177 signal input
GPIO17 / GPIO18 first MAX3232, TXD / RXD on its TTL side
GPIO47 / GPIO48 second MAX3232, TXD / RXD
GPIO1 / GPIO2 sensor SDA / SCL
USB-C OTG adapter, then the hub or a single stick
GPIO43 / GPIO44 a USB-serial adapter, only if you want to read logs over a wire

The RS-232, sensor and USB assignments match the AUX-2's, so its documentation for those parts applies here too. The pins we kept clear:

  • 33–37 are on the header, but the board's PSRAM uses them inside the chip;
  • 4–7 go to the TF card slot;
  • 9–14 drive the Ethernet chip;
  • 0, 3, 45 and 46 decide how the chip boots.

The audio pins are the camera connector's, so this build has no camera.

Steps

  1. Flash it once over USB. Leave the PoE cable out. Connect the board's USB-C to your computer and install the config below with ESPHome Device Builder or ESPHome Web. Put your own API key in secrets.yaml. The flash tool should report success. The board will not show as online yet, because it has no network until PoE is in.
  2. Unplug USB and wire everything else. From now on the USB-C port is a USB host for your stick. It no longer talks to your computer.
  3. Plug in PoE. Within a minute the board is on Ethernet and Home Assistant discovers it. When you add it, give Home Assistant the API key.
  4. Point Z-Wave JS at it, if you have a ZWA-2 plugged in, using esphome://<the board's IP address>. A DHCP reservation keeps that address from changing.
  5. Add your serial devices. The RS-232 ports are ESPHome serial proxies. Home Assistant 2026.9 and later can hand them to integrations that support it. Set up the device's own integration as you would on an AUX-2, and check it is one that can use a proxied port.
  6. Choose the audio output under Audio Output on the device page. Music Assistant finds the box as a Sendspin player.

Once the box is online, Claude can handle changes after that if it is connected to your home through Vome. It can edit the config, validate it, build it and send the update over your Vome link.

Traps we know about

We have not built this, so this section is not the usual "failures we have seen". These are traps from the parts' own documentation and the AUX-2 source.

  • The DAC stays silent. GY-PCM5102 boards ship with solder pads on the back left open. Bridge FLT low, DEMP low, XSMT high and FMT low, and tie SCK to ground. Otherwise the chip stays muted or never locks onto the clock.
  • The serial device never answers. The TX/RX labels on cheap MAX3232 boards follow no convention. Swap the two wires before suspecting anything else.
  • Do not copy nvs_encryption from the AUX-2 config. It writes a key to the chip's eFuses, and that cannot be undone. We left it out.
  • USB devices beyond three or four. The ESP32-S3 has eight USB host channels. A hub uses two, and each stick uses up to four. The AUX-2's claim_comm_interface: false lines are what make a hub, a ZWA-2 and an RS-485 dongle fit.
  • Getting back into USB flashing. Hold BOOT, press and release RESET, then release BOOT. Waveshare's recovery steps work here too.
  • Z-Wave JS and encryption. When Z-Wave over ESPHome arrived, Z-Wave JS could not use ESPHome's API encryption, and Home Assistant's own guide says to remove the key for the ZWA-2 PoE firmware. If your Z-Wave JS will not connect, that is the first thing to check. Keep the box on a network you trust.

On a shoestring

The Waveshare board is most of the cost above. A plain ESP32-S3 development board has the same chip and memory for a fraction of the price. It has no Ethernet, PoE or case. Add back only the parts you want:

Build Board and extras About
Wi-Fi, phone charger ESP32-S3 dev board (search ESP32-S3 N16R8 DevKitC-1, 40–90 SEK) and the same DAC, serial boards, optical transmitter, adapter and wires as above. Power comes from any USB charger you already own. 230 SEK
Wired add a W5500 Ethernet module (W5500 Ethernet module, 35–55 SEK) 270 SEK
Wired, with PoE add an 802.3af PoE splitter with a 5 V USB-C output (PoE splitter type C 5V 802.3af, 40–70 SEK) 320 SEK

Leave out the optical transmitter and the second serial board if you don't need them, and the Wi-Fi build comes to under 200 SEK. Prices are AliExpress on 12 November 2026, during the 11.11 sale.

USB phone charger PoE splitter Z-Wave or Zigbee stick DAC, serial, optical, sensor modules any charger you own 802.3af in, 5 V USB-C out from a PoE switch through an OTG adapter pins in the table below ESP32-S3 N16R8 dev board ESP32-S3 COM USB bridge the OTG pad Wi-Fi + Bluetooth on the chip 5 V or 5 V Ethernet SPI W5500 module GPIO9–14 the Wi-Fi build added for wired and PoE
The COM port takes power and the native USB port drives the stick. The wired builds add the dashed parts.

What you give up, on top of everything in Buy one or build one?:

  • Wi-Fi shares a radio with Bluetooth. On the Wi-Fi build, the Bluetooth proxy and the network take turns on one antenna. ESPHome recommends wired boards for Bluetooth proxies for this reason. Z-Wave and audio will be only as good as your Wi-Fi where the box sits.
  • A loose board and a tangle of modules, in whatever box you find. The PoE build is three boards and a splitter where the Waveshare is one.
  • Boards vary. Dozens of shops sell these boards, and their small details differ. The two that matter are below.

Buy N16R8 (16 MB flash, 8 MB PSRAM), not N8R2 or N8. The audio needs the larger, faster PSRAM, and the config expects it.

Changes to the wiring and config

These boards have two USB-C ports. The one marked USB (the chip's own) is the USB host for your stick. The one marked COM (or UART) is for flashing, power and logs. The camera and TF-card pins are free here, and some boards put their RGB LED on GPIO38 or GPIO48, so the audio and second serial port move:

Function Waveshare build Dev board
PCM5102A BCK / LCK / DIN GPIO38 / 39 / 40 GPIO4 / 5 / 6
TOTX177 signal GPIO41 GPIO7
second MAX3232 TXD / RXD GPIO47 / 48 GPIO15 / 16
W5500 MOSI / MISO / SCLK / CS / RST / INT on the board GPIO11 / 12 / 13 / 14 / 9 / 10

Everything else stays where it is. In the config, change the audio and second serial port pins to the ones in the table, and delete the light: block, because the board's own LED is somewhere else or nowhere.

For the wired builds, keep the ethernet: block as it is. The W5500 module goes on the same pins the Waveshare board uses. For the Wi-Fi build, replace the whole ethernet: block with this. ESPHome refuses to build the Z-Wave proxy with Wi-Fi power saving on.

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  power_save_mode: none

Both versions pass ESPHome 2026.10.2's checks, and we have compiled the Wi-Fi one. Neither has been built in hardware.

The one trap specific to these boards: the stick gets no power. Many of them leave the native USB port without 5 V. Look for a solder jumper marked USB-OTG (sometimes IN-OUT) on the back and bridge it. Check for one in the product photos before you order.

The config

Adapted from NabuCasa/aux-2 under the ESPHome licence.

# A home-built AUX-2-style box on a Waveshare ESP32-S3-ETH (with PoE module).
# Adapted from Nabu Casa's AUX-2 firmware (github.com/NabuCasa/aux-2, ESPHome
# licence) with this board's pins. Ethernet only. Not the official firmware.
substitutions:
  name: diy-aux
  friendly_name: DIY AUX

esphome:
  name: ${name}
  friendly_name: ${friendly_name}
  name_add_mac_suffix: true
  min_version: 2026.10.2

esp32:
  board: esp32-s3-devkitc-1
  variant: esp32s3
  cpu_frequency: 240MHz
  flash_size: 16MB
  framework:
    type: esp-idf
    sdkconfig_options:
      CONFIG_SPIRAM_RODATA: "y"
      CONFIG_SPIRAM_FETCH_INSTRUCTIONS: "y"

psram:
  mode: octal
  speed: 80MHz

# The board's W5500 (same pins as the ZWA-2 PoE firmware)
ethernet:
  type: W5500
  clock_speed: 80MHz
  mosi_pin: GPIO11
  miso_pin: GPIO12
  clk_pin: GPIO13
  cs_pin: GPIO14
  reset_pin: GPIO9
  interrupt_pin: GPIO10

# USB-C is the USB host now, so logs go to UART0 (GPIO43/44 on the header)
logger:
  hardware_uart: UART0

api:
  reboot_timeout: 0s
  encryption:
    key: !secret diy_aux_api_key

ota:
  - platform: esphome
    encryption:

##### Bluetooth proxy
esp32_ble:
  use_psram: true

esp32_ble_tracker:

bluetooth_proxy:
  active: true

##### USB: Z-Wave stick, Zigbee stick, RS-485 dongle (through a small hub)
mdns:
  services:
    - service: "_zwave"
      protocol: "_tcp"
      port: 6053
      txt:
        protocol: "esphome"

usb_host:
  enable_hubs: true

usb_uart:
  - id: usb_uart_zw
    type: CDC_ACM
    vid: 0x303A
    pid: 0x4001
    manufacturer: Nabu Casa
    product: ZWA-2
    claim_comm_interface: false
    channels:
      - id: uch_zw
        baud_rate: 115200
        buffer_size: 1024
  - id: usb_uart_zb
    type: CDC_ACM
    vid: 0x303A
    pid: 0
    manufacturer: Nabu Casa
    product: ZBT-2
    claim_comm_interface: false
    channels:
      - id: uch_zb
  - id: usb_uart_rs485
    type: CH34X
    vid: 0x1A86
    pid: 0x55D3
    channels:
      - id: uch_rs485
        baud_rate: 9600
        buffer_size: 1024

zwave_proxy:
  uart_id: uch_zw

##### Two RS-232 ports through MAX3232 boards
uart:
  - id: uart_rs232_1
    tx_pin: GPIO17
    rx_pin: GPIO18
    baud_rate: 9600
  - id: uart_rs232_2
    tx_pin: GPIO47
    rx_pin: GPIO48
    baud_rate: 9600

serial_proxy:
  - uart_id: uart_rs232_1
    name: RS-232 Port 1
    port_type: RS232
  - uart_id: uart_rs232_2
    name: RS-232 Port 2
    port_type: RS232
  - uart_id: uch_rs485
    name: USB Serial Port
    port_type: RS485
  - uart_id: uch_zb
    name: USB Zigbee
    port_type: USB_SERIAL

##### Sensors (the AUX-2's Grove port uses the same pins)
i2c:
  - id: i2c_sensors
    sda: GPIO1
    scl: GPIO2
    scan: true

##### Audio: PCM5102A for analogue, a TOTX177 for optical
i2s_audio:
  - id: i2s_bus
    i2s_bclk_pin: GPIO38
    i2s_lrclk_pin: GPIO39

speaker:
  - platform: router
    id: audio_router_speaker
    output_speakers:
      - analog_speaker
      - optical_speaker
    bits_per_sample: 24
    num_channels: 2
    sample_rate: 48000

  - platform: i2s_audio
    id: analog_speaker
    i2s_audio_id: i2s_bus
    i2s_dout_pin: GPIO40
    dac_type: external
    sample_rate: 48000
    bits_per_sample: 32bit
    channel: stereo
    timeout: never
    buffer_duration: 50ms

  - platform: i2s_audio
    id: optical_speaker
    i2s_audio_id: i2s_bus
    i2s_dout_pin: GPIO41
    spdif_mode: true
    use_apll: true
    dac_type: external
    sample_rate: 48000
    bits_per_sample: 16bit
    channel: stereo
    timeout: 5s
    buffer_duration: 50ms

  - platform: mixer
    id: mixing_speaker
    task_stack_in_psram: true
    output_speaker: audio_router_speaker
    num_channels: 2
    source_speakers:
      - id: announcement_mixing_input
        timeout: never
      - id: media_mixing_input
        timeout: never

  - platform: resampler
    id: announcement_resampling_speaker
    task_stack_in_psram: true
    output_speaker: announcement_mixing_input
    sample_rate: 48000
    bits_per_sample: 16
  - platform: resampler
    id: media_resampling_speaker
    task_stack_in_psram: true
    output_speaker: media_mixing_input
    sample_rate: 48000
    bits_per_sample: 24

sendspin:
  task_stack_in_psram: true

audio:
  codecs:
    flac:

media_source:
  - platform: audio_http
    id: announcement_http_source
    task_stack_in_psram: true
  - platform: audio_http
    id: media_http_source
    task_stack_in_psram: true
  - platform: sendspin
    id: sendspin_source
    task_stack_in_psram: true
    static_delay_adjustable: true
    codecs: [flac, pcm]

media_player:
  - platform: speaker_source
    id: diy_media_player
    name: Media Player
    volume_increment: 0.05
    volume_min: 0.4
    volume_max: 0.85
    announcement_pipeline:
      speaker: announcement_resampling_speaker
      format: FLAC
      num_channels: 1
      sample_rate: 48000
      sources:
        - announcement_http_source
    media_pipeline:
      speaker: media_resampling_speaker
      format: FLAC
      num_channels: 2
      sample_rate: 48000
      sources:
        - media_http_source
        - sendspin_source
    on_announcement:
      - mixer_speaker.apply_ducking:
          id: media_mixing_input
          decibel_reduction: 20
          duration: 0.0s
    on_state:
      if:
        condition:
          not:
            media_player.is_announcing: diy_media_player
        then:
          - mixer_speaker.apply_ducking:
              id: media_mixing_input
              decibel_reduction: 0
              duration: 1.0s

select:
  - platform: template
    id: audio_output
    name: Audio Output
    entity_category: config
    optimistic: true
    restore_value: true
    options:
      - "Analog"
      - "Optical"
    on_value:
      - router.speaker.switch_output:
          id: audio_router_speaker
          target_speaker: !lambda |-
            if (x == "Optical") {
              return id(optical_speaker);
            }
            return id(analog_speaker);

##### Housekeeping
light:
  - platform: esp32_rmt_led_strip
    id: status_light
    name: Status Light
    entity_category: config
    pin: GPIO21
    chipset: ws2812
    channel_colors: GRB
    num_leds: 1

button:
  - platform: restart
    name: Restart
    entity_category: diagnostic

switch:
  - platform: sendspin
    type: enabled
    name: Sendspin
    restore_mode: RESTORE_DEFAULT_ON
    entity_category: config
  - platform: template
    name: Bluetooth
    optimistic: true
    restore_mode: RESTORE_DEFAULT_ON
    entity_category: config
    turn_on_action:
      - ble.enable:
    turn_off_action:
      - ble.disable:
Rather not do this alone?
The Vome assistant will walk you through this guide a step at a time, and can do some of it for you.
Sign in for AI help

Something wrong or missing here? Tell us — these pages are written from real work, so corrections are welcome.