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.
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.
| 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
- 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. - 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.
- 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.
- 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. - 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.
- 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
FLTlow,DEMPlow,XSMThigh andFMTlow, and tieSCKto 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_encryptionfrom 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: falselines 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.
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: