ErnieHorning: Created DDP protocol page

2026-07-25T15:28:24Z

Created DDP protocol page

New page

{{DISPLAYTITLE:DDP}}

= DDP =

'''DDP''' ('''Distributed Display Protocol''') is a lightweight network protocol designed specifically for transporting pixel data across IP networks. Unlike [[E1.31]], DDP sends continuous pixel data without dividing it into 512-channel universes, making it particularly well suited for large RGB pixel displays.

DDP is supported by several modern sequencing programs and pixel controllers and has become increasingly popular for Wi-Fi-based Christmas lighting displays because of its efficiency and simplified configuration.

[[File:DDP.png|center|900px|thumb|Figure 1 – DDP sends continuous pixel data directly from the sequencer or show player to pixel controllers.]]

== Overview ==

DDP was designed to simplify pixel communication by eliminating many of the limitations associated with universe-based protocols.

Unlike DMX-derived protocols, DDP works directly with continuous pixel data, allowing very large displays to be configured without worrying about universe boundaries.

Typical applications include:

* Pixel controllers
* Wi-Fi displays
* Ethernet displays
* Large matrices
* Mega trees
* House outlines
* Distributed controller networks

== How DDP Works ==

The sequencing software creates a continuous stream of pixel data.

Instead of dividing the data into universes, DDP sends pixel information using data offsets.

A typical signal path is:

<pre>
xLights or FPP
↓
DDP network packets
↓
Ethernet or Wi-Fi
↓
Pixel Controller
↓
Smart Pixels
</pre>

Each controller simply receives the portion of the pixel data assigned to it.

== Pixel Offsets ==

Rather than assigning universes, DDP assigns pixel data using offsets.

Advantages include:

* No universe calculations
* No 170-pixel boundaries
* Easier controller configuration
* Simpler expansion of existing displays

This is especially useful when props contain several hundred or several thousand pixels.

== Why Many Hobbyists Prefer DDP ==

Compared with E1.31, DDP offers several practical advantages for pixel displays:

* No universe management
* Lower protocol overhead
* Simpler controller configuration
* Efficient transport of pixel data
* Excellent performance over Wi-Fi
* Easy support for large props

For displays consisting primarily of smart pixels, many hobbyists find DDP easier to configure and maintain.

== DDP Over Wi-Fi ==

DDP performs well on properly designed Wi-Fi networks.

Recommendations include:

* Use dedicated display access points when practical.
* Connect the sequencing computer or show player by Ethernet whenever possible.
* Use fixed or reserved IP addresses.
* Keep controllers within reliable Wi-Fi coverage.
* Avoid unnecessary network congestion.

Many distributed ESP8266 and ESP32 controller installations successfully use DDP.

== DDP Over Ethernet ==

DDP also works well over wired Ethernet.

Advantages include:

* Excellent reliability
* Low latency
* High throughput
* Simple controller configuration
* Easy expansion

Ethernet remains the preferred choice for very large displays or commercial installations.

== DDP vs. E1.31 ==

{| class="wikitable"
! Feature
! DDP
! E1.31
|-
| Universe based
| No
| Yes
|-
| Continuous pixel offsets
| Yes
| No
|-
| DMX compatible
| No
| Yes
|-
| Protocol overhead
| Lower
| Higher
|-
| Large pixel props
| Excellent
| Good
|-
| Professional stage lighting
| Limited
| Excellent
|}

== Supported Software ==

DDP is supported by several popular Christmas-lighting applications, including:

* [[xLights]]
* [[Falcon Player (FPP)]]
* [[WLED]]
* [[ESPixelStick]]

Support varies depending on firmware version and controller capabilities.

== Common Configuration Problems ==

Typical DDP configuration issues include:

* Incorrect pixel offsets
* Incorrect pixel counts
* Duplicate IP addresses
* Incorrect controller IP address
* Network congestion
* Controller firmware not configured for DDP
* Pixel counts that exceed controller capability

Most problems are easier to diagnose than universe-mapping errors because DDP uses continuous pixel numbering.

== Advantages ==

* Very simple configuration
* No universe calculations
* Lower protocol overhead
* Efficient network utilization
* Excellent for pixels
* Good Wi-Fi performance
* Easy expansion
* Scales well to large displays

== Limitations ==

* Primarily intended for pixel controllers
* Less common in professional entertainment lighting
* Requires controller firmware that supports DDP
* Not designed as a replacement for physical DMX512 systems

== Christmas Display Recommendations ==

DDP is an excellent choice when:

* Using modern pixel controllers
* Building large pixel displays
* Using Wi-Fi controllers
* Using WLED or ESPixelStick
* Minimizing configuration complexity
* Expanding existing pixel displays

If both DDP and E1.31 are supported by the sequencing software and controller, many hobbyists choose DDP for pixel displays because of its simpler configuration and reduced protocol overhead.

== Related Articles ==

* [[E1.31]]
* [[DMX]]
* [[Renard]]
* [[Pixel Controllers]]
* [[Smart Pixels]]
* [[ESP Controllers]]
* [[ESP8266 Overview]]
* [[ESP32 Overview]]
* [[WLED]]
* [[ESPixelStick]]
* [[xLights]]
* [[Falcon Player (FPP)]]
* [[Ethernet]]
* [[Wi-Fi]]

DDP - Revision history

ErnieHorning: Created DDP protocol page