從閃爍到呼吸，從流水到追逐，一文掌握所有LED特效技巧

本文將帶領大家從零開始，使用ESP32-S3開發板實現多種單色LED效果控制。無論你是剛入門的小白，還是有一定經驗的開發者，都能輕松復刻這些炫酷的效果。

材料準備

1×ESP32-S3開發板

1×USB 轉 TypeC 線

1×165x55x10mm面包板

若干15cm杜邦線

若干5mm單色LED

本教程ESP32-S3開發板采用啟明云端WT9932S3-NANO開發板進行演示，它搭載了ESP32-S3R8 雙核芯片。

安裝【led_effect】庫

要控制 LED，使用我們封裝好的led_effect會更加簡單：從 GitHub 獲取【led_effect】庫文件

把【led_effect】文件夾，粘貼到「文檔→Arduino→libraries」路徑下

打開 Arduino IDE，在「文件→示例」里，就能看到【led_effect】庫的所有現成例程

LED 單燈閃爍例程

在 “文件→示例” 中找到【led_effect】庫，選擇【blink】例程

按以下對應關系連接 LED 與開發板通過傳入 GPIO 序號和公共端電平創建 Led 對象，調用開關控制方法并配合延時函數

點擊燒錄，燒錄程序后，LED 將規律閃爍

LED 單燈呼吸例程

在 “文件→示例” 中找到【led_effect】庫，選擇【breath】例程

2. 接線方式和 “單燈閃爍” 一致

先傳入 GPIO 序號和公共端電平創建 Led 對象

循環調用 LED 亮度設置方法，配合延時函數，即可實現呼吸燈效果

LED燈帶閃爍例程

在“文件→示例”中找到【led_effect】庫，選擇【blinkAll】例程

按圖表上的連接方式，將五個LED與開發板完成連接

先創建燈帶對象（led_strip），再通過addLed方法逐一添加各LED對象，接著調用setBlinkTimes設置LED的亮、滅時長，最后在loop循環中調用blinkAll方法

燒錄程序后，所有LED將同步規律閃爍

LED燈帶呼吸燈例程

在“文件→示例”中找到【led_effect】庫，選擇【breathingRunningLight】例程

接線方式和 “燈帶閃爍” 一致

先創建燈帶對象（led_strip）

通過addLed方法添加各LED對象

調用setBreathPeriod設置呼吸周期

通過setBreathBrightnessRange設定亮度變化范圍

在loop循環中調用breathingRunningLight方法

燒錄程序后，LED燈帶將呈現依次漸變的呼吸效果

【LED 流水燈】例程

在 “文件→示例” 中找到【led_effect】庫，選擇【runningLight】例程

接線方式與 “LED 燈帶閃爍” 一致

創建燈帶對象（led_strip），通過 addLed 方法添加各 LED 對象

調用 setRunningHoldTime 設置單個 LED 的持續點亮時間

通過 setRunningFade 設置是否啟用漸亮漸暗模式（僅 PWM 模式支持）

調用 setRunningBounce 可開啟往返流動模式
在 loop 循環中調用 runningLight 方法

燒錄程序后，LED 將呈現循環流動的流水燈效果

【LED 追逐燈】例程

在 “文件→示例” 中找到【led_effect】庫，選擇【stripChase】例程。

接線方式與 “LED 燈帶閃爍” 一致

創建燈帶對象（led_strip），通過 addLed 方法添加各 LED 對象

接著調用 setChaseBrightness 設置主、從 LED 的亮度

通過 setChaseSpacing 設置主從 LED 的間距

調用 setChaseSlaveCount 設置從 LED 的數量
利用 setChaseDelay 設置追趕延遲時間

在 loop 循環中調用 stripChase 方法

燒錄程序后，LED 將呈現循環追逐的動態效果

【LED 跑馬燈】例程

1.在 “文件→示例” 中找到【led_effect】庫，選擇【stripMarquee】例程

2. 接線方式與 “LED 燈帶閃爍” 一致

先創建燈帶對象（led_strip），通過 addLed 方法添加各 LED 對象

接著調用 setMarqueeTailDecay 設置拖影亮度衰減程度

通過 setMarqueeTailDuration 設置拖影持續時間

調用 setMarqueeHoldPrevious 設置前燈是否保持常亮

利用 setMarqueeBounce 開啟彈跳模式

最后在 loop 循環中調用 stripMarquee 方法

3. 燒錄程序后，LED 將呈現帶拖影效果的循環跑馬燈動態

本教程所有代碼，已在 GitHub 同步更新，感興趣的朋友可以按照如下指令在“啟明云端科技”公眾號后臺私信，獲取本教程所有配套資料：

【ESP32S3NANO單色LED】獲取單色LED燈多效果控制相關資料

【Arduino】獲取Arduino安裝包

注意：直接復制粘貼不容易出錯哦~