Pelangi NeoPixel WS2812B di sebuah ESP32
Menengah
Atau lihat semua pelajaran.
- 526komponen di meja kerja
- 46board sedang berjalan
- 1.00xwaktu nyata, di semua board
LED WS2812B, dijual oleh Adafruit dengan nama NeoPixel, menaruh LED merah, hijau, dan biru serta kontroler kecil di setiap piksel, lalu merangkai semuanya lewat satu kabel data. Rangkaian di atas adalah enam belas di antaranya di GPIO 5 sebuah ESP32-C3, dengan roda warna yang meluncur di sepanjang strip. Ia berjalan sekarang, di ESP32-C3 simulasi yang menjalankan firmware hasil kompilasi, dan strip sedang mendekode pulsa nyata di pin datanya.
Buka di editor untuk mengubah jumlah LED, kecepatan, atau kecerahannya, lalu jalankan lagi.
Yang kamu butuhkan
- Board ESP32-C3 (di sini DevKitM-1)
- Strip, ring, atau matriks WS2812B
- Breadboard dan kabel jumper
Pengkabelan
| Komponen dan pin | Disambung ke | Catatan |
|---|---|---|
| Strip DIN | GPIO 5 | Jalur data ke LED pertama |
| Strip VDD | 5 V | Pada strip nyata yang panjang, catu daya 5 V terpisah |
| Strip VSS | GND | Digabung dengan board |
Satu kabel, tanpa clock
There is no clock line. Each bit is a high pulse whose length is the bit: about 0.4 microseconds for a nought and 0.8 for a one. Each LED takes the first 24 bits it receives, green first, then red, then blue, and passes the rest along to the next. When the line has been quiet for 50 microseconds, every LED takes up its new color at once.
Strip simulasi mendekode pulsa itu dari tepi pin itu sendiri, dengan jendela waktu dari datasheet. Pulsa yang terlalu pendek atau terlalu panjang ditolak, seperti strip sungguhan yang berhenti mengikuti aliran data yang tidak bisa dibacanya. Itulah sebabnya driver yang berhasil di sini punya timing yang benar.
Kode Adafruit_NeoPixel
Sketch tutorial Adafruit NeoPixel bisa dikompilasi langsung di board Arduino, keluarga ESP32, Pico, dan Uno R4. Header-nya milik Mokxi sendiri, di atas driver WS2812-nya, dengan setPixelColor(), Color(), ColorHSV(), fill(), clear(), setBrightness(), gamma32() dan rainbow(). Contoh rainbow bawaan memakai driver level bawah secara langsung, dengan roda warna bilangan bulatnya sendiri berukuran 1536 langkah di sekeliling tepi kubus RGB.
#include <Adafruit_NeoPixel.h>
Adafruit_NeoPixel pixels(8, 4, NEO_GRB + NEO_KHZ800);
void setup() {
pixels.begin();
}
void loop() {
pixels.clear();
pixels.setPixelColor(0, pixels.Color(0, 150, 0));
pixels.show();
delay(500);
}Buka sketch ini di editorKodenya saja: editor menempatkan board dan komponen yang bisa dibacanya dari sketch.
Kenapa tutorial ini memakai ESP32
On a real Arduino Uno, the Adafruit library drives WS2812s with hand-tuned assembly that counts every one of the 16 MHz clock’s cycles. In Mokxi, the WS2812 driver is a counted loop (assembly on the AVR boards, the core’s cycle counter on the ESP32, Pico and Uno R4), so the NeoPixel header builds on all of them and stops with a message on the boards with no driver. An ESP32 has more memory for large panels, which is why this circuit uses one.
Coba di editor
Open the circuit in the editor and change LEVEL from 40 to 255. The strip gets much brighter. On a real bench each pixel can draw up to sixty milliamps at full white, and the supply has to be sized for that, which is why the example runs at a sixth of full scale.
Then select the strip and change its layout property to ring. The same sixteen LEDs are drawn as a circle, with LED 0 at the top and the rest clockwise, which is how the rings you can buy are numbered. The sketch does not change at all, because electrically a ring is a strip.
Terakhir, ubah SPEED ke 1 untuk pergeseran warna yang lambat, atau ubah SPREAD agar seluruh strip menampilkan satu warna pada satu waktu.
Kesalahan umum
Kecerahan penuh di setiap LED. Setiap piksel bisa menarik sekitar 60 miliampere pada putih penuh, jadi strip 60 LED butuh lebih dari 3 ampere. Contoh ini berjalan pada sekitar seperenam skala penuh. Simulator tidak memodelkan arus catu daya, jadi rencanakan daya untuk rangkaian sungguhan sendiri.
Urutan warna yang salah. Strip WS2812B mengharapkan hijau dulu. Sketch yang mengirim merah dulu, dengan NEO_RGB, mendapat merah dan hijau tertukar, di sini maupun di meja kerja.
Tidak ada ground bersama antara board dan strip yang diberi daya terpisah. Jalur data diukur terhadap ground strip.
Jalur data 3,3 volt masuk ke strip 5 volt. Banyak strip sungguhan menerimanya, tapi tidak semua. Level shifter, atau piksel pertama yang dijalankan sedikit lebih rendah, memperbaikinya. Strip simulasi membaca data 3,3 volt tanpa masalah.
Lupa show(). Mengatur piksel hanya mengubah buffer di memori; tidak ada yang sampai ke strip sampai show() mengirimkannya.
Buka rangkaian ini di editor. ESP32-C3: rainbow WS2812B, dengan kabel seperti saat berjalan di bagian atas halaman ini. Ubah komponen atau nilai lalu jalankan lagi.
Buka rangkaian iniPertanyaan
Bisakah aku memakai ring atau matriks NeoPixel alih-alih strip?
Bisa. Secara listrik semuanya adalah strip. Komponen simulasi punya properti layout untuk strip, ring, dan matriks, termasuk matriks serpentine, dan penomorannya mengikuti produk sungguhan.
Berapa banyak NeoPixel yang bisa digerakkan satu pin?
Sebanyak yang muat di memori dan waktunya: tiga byte per piksel, dan sekitar 30 mikrodetik per LED untuk mengirim. Strip simulasi menampung hingga 1024 LED per komponen.
Apakah FastLED bisa dipakai?
Bisa. FastLED.h bisa dikompilasi di sini, begitu juga Adafruit_NeoPixel.h, di board AVR, keluarga ESP32, Pico, dan Uno R4.
Rakit versi nyatanya
Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.