Appendix C - Sample Configurations - Revision history

ErnieHorning at 12:16, 18 July 2026

2026-07-18T12:16:01Z

ErnieHorning at 11:45, 18 July 2026

2026-07-18T11:45:58Z

ErnieHorning at 22:43, 17 July 2026

2026-07-17T22:43:15Z

ErnieHorning: Created page with "'''Appendix C – Sample Configurations''' '''Version:''' 0.5 (Draft) '''Written for:''' ESPPixelStick Version 4.x '''Last Updated:''' July 2026 '''Author:''' Ernest Horni..."

2026-07-17T22:35:00Z

Created page with "'''Appendix C – Sample Configurations''' '''Version:''' 0.5 (Draft) '''Written for:''' ESPPixelStick Version 4.x '''Last Updated:''' July 2026 '''Author:''' Ernest Horni..."

New page

'''Appendix C – Sample Configurations'''

'''Version:''' 0.5 (Draft)

'''Written for:''' ESPPixelStick Version 4.x

'''Last Updated:''' July 2026

'''Author:''' Ernest Horning

'''Research & Technical Editing:''' ChatGPT

'''Appendix Summary'''

'''Purpose'''

This appendix presents several representative ESPPixelStick installations ranging from simple single-output controllers to larger multi-output systems.

The examples are intended to demonstrate typical design approaches rather than prescribe exact hardware.

Individual installations should always be adapted to local requirements.

'''Related Chapters'''

* Chapter 4 – Hardware Installation
* Chapter 5 – Firmware Installation
* Chapter 6 – Network Configuration
* Chapter 7 – Inputs, Outputs, and Interfaces
* Chapter 8 – Configuration
* Chapter 9 – Pixel Outputs and Wiring
* Appendix A – GPIO Reference Tables
* Appendix B – Controller Hardware Comparison

'''C.1 Introduction'''

No single controller configuration is ideal for every application.

The following examples illustrate common design approaches used successfully by hobbyists.

[[File:vertopal_333d4595b3e94d68bc11dd4ec431ddae/media/image1.png|624x374px]]'''Figure C-1-1 – Configuration Selection Guide'''

'''C.2 Example 1 – Single Yard Prop'''

A small yard prop may require only:

* One ESP8266 or ESP32 controller
* One pixel output
* One power supply
* Wi-Fi connection

Typical applications include:

* Candy canes
* Snowflakes
* Small singing faces
* Window outlines

'''Advantages'''

* Inexpensive
* Easy to troubleshoot
* Simple wiring
* Easy replacement

'''C.3 Example 2 – Medium Prop'''

A larger prop might include:

* ESP32 controller
* Several hundred pixels
* Multiple power-injection points
* One network connection

Typical applications:

* Large snowflakes
* Arches
* Roof outlines
* Medium matrices

[[File:vertopal_333d4595b3e94d68bc11dd4ec431ddae/media/image3.png|624x374px]]'''Figure C-3-1 – Medium Prop Example'''

'''C.4 Example 3 – Multi-Output Controller'''

Some installations benefit from several outputs on one controller.

Typical characteristics include:

* ESP32 processor
* Multiple pixel outputs
* Shared power distribution
* Central enclosure
* Organized wiring

Applications:

* Megatrees
* Matrixes
* Multiple nearby props

Advantages:

* Fewer controllers
* Central maintenance
* Reduced network traffic
* Simplified enclosure management

'''C.5 Example 4 – Distributed Wi-Fi Display'''

Instead of one large controller, many displays use numerous small controllers.

Typical characteristics:

* One controller per prop
* Short pixel cables
* Wi-Fi communication
* Small power supply at each prop

Applications:

* Yard displays
* Widely separated props
* Temporary installations

Advantages:

* Modular
* Easy expansion
* Easy replacement
* Minimal long pixel-data cables

[[File:vertopal_333d4595b3e94d68bc11dd4ec431ddae/media/image5.png|624x374px]]'''Figure C-5-1 – Distributed Display'''

'''C.6 Example 5 – Ethernet Installation'''

Where supported by the controller hardware, Ethernet may be preferred.

Typical applications:

* Large centralized controller cabinets
* Permanent installations
* Commercial displays

Advantages:

* Predictable communication
* No radio interference
* Dedicated network links

'''C.7 Example 6 – Differential Receivers'''

Large displays sometimes require long distances between the controller and the pixels.

A differential transmitter and receiver pair can extend data over longer cable runs than a direct pixel connection.

Typical applications:

* Large front yards
* Commercial displays
* Campus decorations
* Large matrices

[[File:vertopal_333d4595b3e94d68bc11dd4ec431ddae/media/image7.png|624x374px]]'''Figure C-7-1 – Differential Receiver Example'''

'''C.8 Example 7 – Stand-Alone Playback'''

Some ESP32-based systems support stand-alone operation.

A typical system may include:

* ESP32 controller
* Local storage (where supported)
* Power supply
* Pixel outputs

Typical applications:

* Demonstration displays
* Portable displays
* Independent props

'''C.9 Configuration Comparison'''

{|
!width="26%"| '''Configuration'''
!width="22%"| '''Typical Size'''
!width="26%"| '''Network'''
!width="24%"| '''Complexity'''
|-
| Single Prop
| Small
| Wi-Fi
| Low
|-
| Medium Prop
| Medium
| Wi-Fi
| Low-Medium
|-
| Multi-Output
| Large
| Wi-Fi/Ethernet
| Medium
|-
| Distributed
| Large
| Wi-Fi
| Medium
|-
| Ethernet
| Large
| Ethernet
| Medium
|-
| Differential
| Very Large
| Wi-Fi/Ethernet
| High
|-
| Stand-Alone
| Small-Large
| Optional
| Medium
|}

'''C.10 Choosing a Configuration'''

Consider:

* Number of props
* Pixel count
* Cable distances
* Power distribution
* Maintenance
* Future expansion
* Network coverage
* Budget

'''Engineering Recommendation'''

Design for next year's display as well as this year's.

Many hobby displays expand every season.

Leaving room for future outputs often saves significant rewiring.

'''C.11 Engineering Recommendations'''

✔ Keep controllers close to the pixels.

✔ Keep power cables as short as practical.

✔ Label everything.

✔ Test one configuration before duplicating it.

✔ Document IP addresses and GPIO assignments.

✔ Build modular systems whenever practical.

'''C.12 Open Research Items'''

{|
!width="13%"| '''Status'''
!width="86%"| '''Item'''
|-
| 🟨
| Additional Ethernet examples
|-
| 🟨
| Expanded stand-alone playback examples
|-
| 🟨
| Differential receiver hardware examples
|-
| 🟨
| Future multi-controller synchronization examples
|}

'''References'''

This appendix is based upon:

* ESPPixelStick documentation
* General pixel-controller design practices
* Community experience documented on DoItYourselfChristmas.com

'''Revision History'''

{|
!width="8%"| '''Version'''
!width="9%"| '''Date'''
!width="81%"| '''Description'''
|-
| 0.1
| July 2026
| Initial appendix
|-
| 0.5
| July 2026
| Expanded example configurations, comparison table, and engineering recommendations.
|}

@@ Line 3: / Line 3: @@
 '''Version:''' 0.1 (Draft)
-'''Written for:''' ESPPixelStick Version 4.x
+'''Written for:''' ESPixelStick Version 4.x
 '''Last Updated:''' July 2026
@@ Line 15: / Line 15: @@
 '''Purpose'''
-This appendix presents several representative ESPPixelStick installations ranging from simple single-output controllers to larger multi-output systems.
+This appendix presents several representative ESPixelStick installations ranging from simple single-output controllers to larger multi-output systems.
 The examples are intended to demonstrate typical design approaches rather than prescribe exact hardware.
@@ Line 282: / Line 282: @@
 This appendix is based upon:
-* ESPPixelStick documentation
+* ESPixelStick documentation
 * General pixel-controller design practices
 * Community experience documented on DoItYourselfChristmas.com

@@ Line 38: / Line 38: @@
 The following examples illustrate common design approaches used successfully by hobbyists.
-[[File:vertopal_333d4595b3e94d68bc11dd4ec431ddae/media/image1.png|624x374px]]'''Figure C-1-1 – Configuration Selection Guide'''
+[[File:Figure_C-01-01_Configuration_Guide.png|thumb|none|600px|'''Figure C-1-1 – Configuration Selection Guide''']]
 '''C.2 Example 1 – Single Yard Prop'''
@@ Line 79: / Line 79: @@
 * Medium matrices
-[[File:vertopal_333d4595b3e94d68bc11dd4ec431ddae/media/image3.png|624x374px]]'''Figure C-3-1 – Medium Prop Example'''
+[[File:Figure_C-03-01_Medium_Controller.png|thumb|none|600px|'''Figure C-3-1 – Medium Prop Example''']]
 '''C.4 Example 3 – Multi-Output Controller'''
@@ Line 130: / Line 130: @@
 * Minimal long pixel-data cables
-[[File:vertopal_333d4595b3e94d68bc11dd4ec431ddae/media/image5.png|624x374px]]'''Figure C-5-1 – Distributed Display'''
+[[File:Figure_C-05-01_Distributed_Display.png|thumb|none|600px|'''Figure C-5-1 – Distributed Display''']]
 '''C.6 Example 5 – Ethernet Installation'''
@@ Line 161: / Line 161: @@
 * Large matrices
-[[File:vertopal_333d4595b3e94d68bc11dd4ec431ddae/media/image7.png|624x374px]]'''Figure C-7-1 – Differential Receiver Example'''
+[[File:Figure_C-07-01_Differential_Example.png|thumb|none|600px|'''Figure C-7-1 – Differential Receiver Example''']]
 '''C.8 Example 7 – Stand-Alone Playback'''
@@ Line 297: / Line 297: @@
 | Initial appendix
 |-
 |}

@@ Line 1: / Line 1: @@
 '''Appendix C – Sample Configurations'''
-'''Version:''' 0.5 (Draft)
+'''Version:''' 0.1 (Draft)
 '''Written for:''' ESPPixelStick Version 4.x