README.md

FastLED Cookbook

A practical guide to creating LED effects with FastLED.

This cookbook is organized into focused sections, each covering a specific aspect of LED programming with FastLED.

Table of Contents

Getting Started

Learn the basics to get your LED strip up and running.

• Installation and Setup
• Hardware Requirements
• Basic Concepts
• Your First Blink Example

Core Concepts

Understand the fundamental building blocks of LED programming.

• Understanding LED Data Structures
• Color Theory
• Timing and Frame Rate
• Power Considerations

Basic Patterns

Start creating your first LED animations and effects.

• Solid Colors
• Simple Animations
• Chases and Scanners
• Rainbow Effects

Classical LED Drawing

Learn fundamental pixel manipulation techniques.

• Direct pixel addressing: leds[i] = CRGB::Red
• Array-based control and LED mapping
• XY coordinate mapping for matrix layouts
• Basic drawing primitives for LED strips and grids

Intermediate Techniques

Level up with more advanced programming techniques.

• Color Palettes
• Noise and Perlin Noise
• Blending and Transitions
• Math and Mapping Functions

Advanced Effects

Create professional-grade LED installations and effects.

• 2D/Matrix Operations
• Multiple Strip Coordination
• Performance Optimization

Common Recipes

Copy-paste ready recipes for popular LED effects.

• Fire Effect
• Twinkle/Sparkle
• Breathing Effect
• Wave Patterns

Troubleshooting

Solve common problems and debug your LED setup.

• Common Issues and Solutions
• Debugging Tips
• Hardware Problems

Reference

Quick reference guides and configuration tables.

• API Quick Reference
• Pin Configurations by Platform
• Supported LED Types

---

Additional Resources

• FastLED Documentation: https://fastled.io
• GitHub Repository: https://github.com/FastLED/FastLED
• Community Wiki: https://github.com/FastLED/FastLED/wiki

---

Note: This cookbook is a living document. Contributions welcome!