Skip to content
DeckConnectorSet it up
Skip to Content

Hardware

The ESP32-P4 board that runs DeckConnector, how to power it, and which decks work with it.

Board

Waveshare ESP32-P4-WIFI6-POE-ETH, from about 25 US dollars at Waveshare, plus shipping. The base kit is enough. Details are in the Waveshare wiki.

It needs ESP32-P4 chip revision v3.1 or a later v3. Some boards shipped with older v1.3 chips. Ask the seller. The flasher checks the revision before it writes anything.

Its Wi-Fi is 2.4 GHz only.

USB-C goes to the computer for flashing, setup over USB and power. USB-A takes the Stream Deck. The network port takes Ethernet and PoE power. BOOT and RST put the board into download mode.

USB-CTo the computer: flashing, setup over USB, power without PoE
USB-AThe Stream Deck. Not for flashing
EthernetNetwork, and power with PoE
BOOT + RSTDownload mode: hold BOOT, press and release RST, release BOOT

With PoE the board and the deck run from one cable. With PoE and USB-C both plugged in, the board keeps running when PoE goes away.

Use standard PoE only, from a switch or injector to IEEE 802.3af or 802.3at. A passive PoE injector can destroy the board. The base kit has no case, so keep the board away from metal and water. You run it at your own risk.

A speaker on the board's speaker connector plays short sounds when a source connects or goes away. Home Assistant can play audio on it.

Decks

DeckState
Stream Deck +Tested. 8 keys, 4 dials, touch strip
Stream Deck MK.2, XL, V2, Mini, Neo, + XL, Pedal, Module 6, 15 and 32Very likely work. Tested on emulated decks, not yet on real ones
Mirabox, Ajazz, Soomfon, Streonor: Stream Dock 293V3, 293S, XL, N3, N4, N4 Pro, AKP153, AKP153E, AKP03E, AKP05E, CN002, S15Should work, not tested on hardware. Companion and own servers only

Some of these decks share one serial number. The connector tells them apart by their USB port, so keep each deck on its port.

Some controls send only the press, not the release. You cannot hold them, so a long press in Companion does not work there. This affects:

  • the dials and the touch strip of the N4, N4 Pro and Ajazz AKP05E
  • the right key column of the 293S with USB ID 6602:1014 or 6603:1014
  • every key of the Ajazz AKP153, and of the 293S with USB ID 5548:6670

The right key column of the Streonor S15 sends nothing.

The Deck tab shows which keys open the menu.

Behind a USB hub the connector drives up to four decks. Two is the default. All decks on a hub without its own power supply share the 2 A of the USB port. Set the limit in the web UI under Deck. Decks over the limit stay dark. A lower limit applies to decks you plug in after the change.

A deck on its own is always deck 1. With several decks, each keeps its number when you plug it in again. Companion and the Elgato app see each deck as its own surface or device. An own server draws on the deck with the lowest number only. The menu opens on the deck where you hold the keys. A hub often forces full speed, which makes pictures slower.

Speed numbers are on Benchmarks.

On this page