Belajar

Arduino NeoPixels: pelangi WS2812B di sebuah Uno

Pemula

Atau lihat semua pelajaran.

  • 526komponen di meja kerja
  • 46board sedang berjalan
  • 1.00xwaktu nyata, di semua board
Arduino Uno: pelangi NeoPixellive0.000 s 0.00x
Klik untuk membukanya di editor
Twenty WS2812Bs on pin 6 and four on pin 5, on a simulated ATmega328P. The knob on A0 sets the speed.

Strip NeoPixel adalah deretan LED RGB kecil yang masing-masing punya chip kecil sendiri. Kamu mengirim warna lewat satu kabel data, dan setiap LED menyimpan warnanya sendiri sampai kamu mengirim yang baru. Adafruit menjualnya sebagai NeoPixel; chip di dalamnya adalah WS2812B, dan strip, ring, serta matriks murah semuanya memakai chip yang sama.

Rangkaian di atas adalah Arduino Uno yang menggerakkan dua strip: busur dengan dua puluh LED di pin 6 dan sebaris empat LED emas di pin 5. Pelangi mengalir di sepanjang busur, dan kenop pada A0 mengatur kecepatannya. Semuanya berjalan di browser kamu dengan sketch di bawah, dan setiap strip mendekode pulsa sungguhan di pin datanya, jadi kesalahan kabel di sini sama gelapnya dengan di meja kerja kamu.

Yang kamu butuhkan

  • Arduino Uno
  • Strip WS2812B (dua puluh LED di sini) dan strip pendek berisi empat LED
  • Dua resistor 330 ohm, satu untuk tiap jalur data
  • Potensiometer 10k untuk kecepatan
  • Breadboard setengah ukuran dan kabel jumper

Pengkabelan

Komponen dan pinDisambung keCatatan
DIN strip busurPin 6Melalui resistor 330 ohm
DIN strip emasPin 5Melalui resistor 330 ohm-nya sendiri
VDD (5V) kedua stripRel 5 VGunakan catu daya 5 V terpisah untuk strip yang panjang
VSS (GND) kedua stripRel GNDGround harus disambungkan ke Uno
Pin tengah potensiometerA0Kenop kecepatan
Pin luar potensiometer5 V dan GNDBoleh dibalik

Satu kabel, dan timingnya adalah datanya

There is no clock wire. Each bit is one high pulse, and the length of the pulse is the bit: about 0.4 microseconds for a 0 and 0.8 for a 1. Every LED takes 24 bits, eight each for green, red and blue, keeps the first 24 for itself and passes the rest down the strip. When the line goes quiet for 50 microseconds, every LED shows its new color at once.

Pulsa itu terlalu pendek untuk dibuat dengan digitalWrite(). Library Adafruit_NeoPixel mengatur waktunya untukmu, jadi sketch kamu hanya berurusan dengan warna. Di Uno, bit dihitung dengan assembly, satu clock cycle demi satu clock cycle.

Sketch-nya, langkah demi langkah

Setiap strip adalah satu objek: berapa banyak LED, pin mana, dan urutan warnanya. NEO_GRB + NEO_KHZ800 cocok untuk hampir semua WS2812B. begin() menyiapkan pin, dan setBrightness() menurunkan semua warna, yang menghemat daya dan matamu.

Di loop(), sketch membaca kenop dan mengubahnya menjadi kecepatan dari 32 sampai 1024. Nilai itu ditambahkan ke hue awal, lalu tiap LED diberi hue yang sedikit lebih jauh di roda warna. ColorHSV() menerima hue dari 0 sampai 65535 dan mengembalikan sebuah warna, dan gamma32() mengoreksinya agar perubahan warna terlihat rata di matamu. Tidak ada yang berubah di strip sampai show() mengirim seluruh frame.

Loop menunggu 20 milidetik, jadi pelangi bergerak sekitar lima puluh kali per detik. Setiap 200 frame kecepatan dicetak. Dengan kenop di tengah, baris pertama tertulis "Rainbow speed 528". Putar sampai paling bawah dan tertulis 32.

Loop-nya, dari contoh pelangi
void loop() {
  int speed = map(analogRead(A0), 0, 1023, 32, 1024);
  start += speed;
  for (int i = 0; i < ARCH; i++) {
    uint16_t hue = start + (uint32_t)i * 65536 / ARCH;
    arch.setPixelColor(i, arch.gamma32(arch.ColorHSV(hue)));
  }
  for (int i = 0; i < POT; i++) {
    int glint = random(0, 10) == 0 ? 255 : random(140, 200);
    gold.setPixelColor(i, glint, glint * 3 / 5, 0);
  }
  arch.show();
  gold.show();
  frames++;
  if (frames % 200 == 1) {
    Serial.print("Rainbow speed ");
    Serial.println(speed);
  }
  delay(20);
}

Daya: hal yang tidak bisa diperingatkan simulator kepadamu

Tiap WS2812B bisa menarik sekitar 60 miliampere pada putih penuh. Dua puluh LED berarti lebih dari satu ampere, lebih dari yang seharusnya diberikan pin 5 V Uno. Untuk lebih dari segelintir LED, beri daya strip dari catu 5 V sendiri, sambungkan groundnya ke ground Uno, dan turunkan kecerahannya. Kapasitor 1000 mikrofarad pada kabel daya strip, seperti yang direkomendasikan Adafruit, melindungi LED pertama saat kamu menancapkannya.

Mokxi tidak memodelkan arus yang ditarik tiap LED, jadi strip panjang di sini tidak akan menurunkan daya board. Itu batasan nyata dari simulasi, dan itulah alasan bagian ini ada.

Coba di editor

Buat pelangi berjalan ke arah sebaliknya dengan mengubah start += speed menjadi start -= speed. Ubah ARCH menjadi 60 dan properti count pada strip menjadi 60 untuk busur yang lebih panjang. Beri kilau hijau pada strip emas dengan menukar angka pada pemanggilan setPixelColor()-nya.

Lalu hapus kabel ground ke busur dan tekan Jalankan. Busur tetap gelap, karena pulsa data tidak punya jalan untuk kembali. Pasang kembali dan pelanginya kembali.

Kesalahan umum

Tidak ada ground bersama. Strip dengan catu daya sendiri tetap perlu GND-nya disambung ke GND Uno, kalau tidak jalur data tidak berarti baginya.

Lupa memanggil show(). setPixelColor() hanya mengubah daftar di memori. Strip tidak berubah sampai show() mengirimkannya.

Urutan warna yang salah. WS2812B butuh NEO_GRB. Pakai NEO_RGB dan merah dengan hijau akan tertukar, di sini maupun di strip sungguhan.

Menyambung di ujung yang salah. Data masuk ke DIN. Panah yang tercetak di strip menunjuk menjauh dari input, menuju DOUT.

Menjalankan strip panjang dari pin 5 V Uno dengan kecerahan penuh. Lihat bagian daya di atas.

Buka rangkaian ini di editor. Arduino Uno: pelangi NeoPixel, dirangkai seperti yang berjalan di bagian atas halaman ini. Ubah komponen atau nilainya dan jalankan lagi.

Buka rangkaian ini

Pertanyaan

Pin mana yang sebaiknya kupakai untuk NeoPixel di Arduino Uno?

Pin digital mana pun bisa. Library mengatur waktu pulsa sendiri, jadi pin tidak perlu PWM. Contoh ini memakai pin 6 dan 5, masing-masing melalui resistor 330 ohm.

Bisakah aku memakai FastLED alih-alih Adafruit_NeoPixel?

Bisa. Kedua library terkompilasi di Mokxi, pada board AVR, keluarga ESP32, Pico, dan Uno R4. Pada board tanpa driver WS2812 di sini, seperti board STM32, headernya memberi tahu saat kamu build.

Berapa banyak NeoPixel yang bisa digerakkan sebuah Uno?

Library menyimpan tiga byte memori untuk tiap LED, dan Uno punya 2 KB RAM, jadi beberapa ratus adalah maksimumnya dalam praktik sebelum sketch-mu kehabisan ruang. Daya biasanya jadi batasan nyata terlebih dahulu. Di Mokxi, semua strip dalam satu sketch berbagi kumpulan tetap 1024 LED.

Apakah ini juga bekerja di ESP32?

Ya, dengan kode yang sama. Tutorial NeoPixel ESP32 menjalankan pelangi di ESP32-C3, dan menjelaskan bagaimana board itu mengatur waktu bitnya.

Rakit versi nyatanya

Buka editor, ubah sebuah nilai, dan lihat angkanya ikut berubah. Tidak ada yang perlu dipasang, dan tidak perlu akun.