Hissələr · 13 dəq oxu

nRF24L01 Arduino ilə istifadə: simsiz əlaqə və pult

nRF24L01 Arduino qoşulması, 3,3 V və 10 µF kondensator, RF24 ötürücü/qəbuledici kodu, PA+LNA ilə 1 km məsafə, coystikli pult, ESP32, Pico və xəta həlləri.

nRF24L01 Arduino cütü iki plata arasında naqil çəkmədən veri göndərmənin ən ucuz və ən praktik yoludur. Dırnaq boyda bu modul 2,4 GHz diapazonunda işləyir, saniyədə 2 meqabitə qədər veri daşıyır və həm ötürücü, həm qəbuledici kimi istifadə oluna bilər. Uzaqdan idarə olunan maşın, simsiz coystik, bağçadakı sensordan evə veri daşıyan stansiya və ya bir-birinə xəbər verən siqnalizasiya düyünləri üçün idealdır. Standart versiya açıq sahədə 100 metrə, antenli nRF24L01+PA+LNA versiyası isə əlverişli şəraitdə 1 kilometrə qədər çata bilər.

Bu bələdçidə modulun necə işlədiyini, SPI pinlərini, niyə mütləq 3,3 V ilə qidalanmalı olduğunu və ən çox rast gəlinən problemin həlli olan 10 µF kondensatoru öyrənəcəksən. Sonra RF24 kitabxanası ilə ötürücü və qəbuledici kodu yazacaq, ünvan və kanal ayarlarını anlayacaq, coystikli uzaqdan idarə pultu hazırlayacaq, modulu ESP32-yə və Raspberry Pi Pico-ya qoşacaq və nəhayət "radio.begin() false" və "veri gəlmir" problemlərini addım-addım həll edəcəksən.

nRF24L01 2,4 GHz simsiz əlaqə modulu
Standart nRF24L01+ modulu: platanın ucundakı ziqzaq izi PCB antendir; 8 pinli konnektordan SPI ilə qoşulur.

nRF24L01 nədir, necə işləyir?

nRF24L01 Nordic Semiconductor şirkətinin istehsal etdiyi 2,4 GHz radio qəbuledici-ötürücü (transceiver) çipidir; bu gün satılan modulların demək olar ki, hamısında təkmilləşdirilmiş nRF24L01+ versiyası və ya onunla uyğun klon çip olur. Modul Arduino ilə SPI üzərindən danışır: Arduino ayarları və göndəriləcək veriləni SPI ilə yazır, qalanını çip özü edir. Nordic-in Enhanced ShockBurst adlandırdığı aparat protokolu hər paketi ünvan və CRC (xəta yoxlaması) ilə paketləyir. Qəbuledici paketi düzgün aldıqda ötürücüyə avtomatik təsdiq (ACK) göndərir; təsdiq gəlməsə, ötürücü paketi özü yenidən göndərir. Yəni kodunda yalnız "göndər" deyirsən, təkrar cəhd və xəta yoxlaması aparatda həyata keçirilir.

Bir paketdə ən çox 32 bayt veri daşınır. Bu az görünsə də, coystikin iki oxu, bir neçə düymə və bir neçə sensor dəyəri rahatlıqla sığır. Modul 126 kanaldan birini istifadə edir və kanal tezliyi 2400 + kanal nömrəsi (MHz) düsturu ilə tapılır; məsələn, 76-cı kanal 2476 MHz-dir. Bir qəbuledici eyni anda 6 fərqli ünvanı (pipe, yəni boru) dinləyə bilər; beləliklə, tək mərkəz altı ötürücüdən veri toplaya bilər.

XüsusiyyətDəyər
Tezlik2,400–2,525 GHz (126 kanal, 1 MHz aralıq)
Ötürmə sürəti250 kbps, 1 Mbps, 2 Mbps
Qida gərginliyi1,9–3,6 V (praktikada 3,3 V)
Giriş pinləri5 V-a davamlı (CE, CSN, SCK, MOSI)
Çıxış gücü0, −6, −12, −18 dBm
Cərəyan (göndərəndə, 0 dBm)Təxminən 11,3 mA
Cərəyan (dinləyəndə, 2 Mbps)Təxminən 13,5 mA
Yuxu (power down)Təxminən 900 nA
Qəbuledicinin həssaslığı−94 dBm (250 kbps), −85 dBm (1 Mbps), −82 dBm (2 Mbps)
Paket ölçüsü1–32 bayt
İnterfeysSPI, ən çox 10 MHz
Boru (pipe) sayı6

nRF24L01 ilə nRF24L01+PA+LNA fərqi

Bazarda iki tip modul görəcəksən. Standart modulun anteni platanın üzərinə çəkilmiş ziqzaq mis izdir. nRF24L01+PA+LNA versiyasında isə eyni çipin qarşısına RF ön uc çipi əlavə olunub: PA (Power Amplifier, güc gücləndiricisi) çıxan siqnalı gücləndirir, LNA (Low Noise Amplifier, aşağı küylü gücləndirici) gələn zəif siqnalı çipə çatmazdan əvvəl böyüdür. Üzərinə vintlə SMA konnektorlu xarici antena taxılır. İki modulun pin düzülüşü və kodu eynidir, bir-biri ilə problemsiz əlaqə qurur; fərq məsafədə və cərəyan ehtiyacındadır. Aşağıdakı dəyərlər təxminidir və mühitə görə dəyişir.

Antenli nRF24L01+PA+LNA RF modulu
nRF24L01+PA+LNA: güc və qəbul gücləndiricisi olan, SMA antenli versiya. Eyni kodla işləyir, amma xeyli çox cərəyan çəkir.
XüsusiyyətnRF24L01+ (PCB antena)nRF24L01+PA+LNA
AntenaPlatanın üzərinə çəkilibXarici SMA antena
Çıxış gücüƏn çox 0 dBm (1 mW)Modelə görə +20 dBm-ə (100 mW) qədər
Göndərəndə pik cərəyanTəxminən 12 mA115 mA-a qədər
Dinləyəndə pik cərəyanTəxminən 13,5 mA45 mA-a qədər
Açıq sahədə məsafə (250 kbps)50–100 m800–1100 m
Bina daxilində məsafə10–30 m, 1–2 divarBir neçə mərtəbə və onlarla metr
Qidalanma tövsiyəsi3,3 V pin + 10 µF kondensatorAyrıca 3,3 V stabilizator + kondensator

nRF24L01 pinləri və Arduino-ya qoşulma

Modulun 2×4 düzülmüş 8 pini var. Kvadrat lehim pedli pin 1 nömrəlidir və GND-dir; elə yanında VCC yerləşir. CE (Chip Enable) modulu dinləmə və ya göndərmə rejiminə keçirir, CSN (Chip Select Not) isə SPI xəttində "indi səninlə danışıram" demək üçün LOW çəkilir. SCK, MOSI və MISO standart SPI xətləridir və platanın sabit SPI pinlərinə qoşulmalıdır; CE və CSN isə istədiyin rəqəmsal pinlərə qoşula bilər. IRQ pini ixtiyaridir, paket gələndə və ya göndərmə bitəndə LOW olur və kəsmə ilə işləmək istəsən istifadə olunur. SPI-nin məntiqi üçün SPI nədir yazısına, platanın bütün pin xəritəsi üçün Pinout alətinə baxa bilərsən.

nRF24L01 piniVəzifəsiArduino Uno / NanoArduino MegaESP32Raspberry Pi Pico
1 GNDTorpaqGNDGNDGNDGND
2 VCCQida (3,3 V)3.3V3.3V3V33V3(OUT)
3 CERejim seçimiD9D9GPIO 4GP6
4 CSNSPI seçimiD10D10GPIO 5GP5
5 SCKSPI saatD13D52GPIO 18GP2
6 MOSIPlatadan modula məlumatD11D51GPIO 23GP3
7 MISOModuldan plataya məlumatD12D50GPIO 19GP4
8 IRQKəsmə (ixtiyari)BoşBoşBoşBoş
VCC-ni heç vaxt 5 V-a qoşma. Çip ən çox 3,6 V-a davam edir; 5 V versən, həmişəlik xarab ola bilər. Siqnal pinləri 5 V-a davamlı olduğu üçün Uno-nun SPI pinlərinə birbaşa qoşula bilər, amma qida həmişə 3,3 V olmalıdır. Modulu breadboard-a da birbaşa taxma: 2×4 pin düzülüşü səbəbindən qarşılıqlı pinlər eyni zolağa düşür və qısa qapanma olur; dişi-erkək jumper naqil istifadə et.

Ən çox rast gəlinən xəta: qida və 10 µF kondensator

nRF24L01 problemlərinin böyük hissəsinin səbəbi kod deyil, qidadır. Modul göndərmə anında qısa, lakin sərt cərəyan impulsları çəkir. Uzun jumper naqillər və zəif 3,3 V mənbə bu impulslara çatmır; gərginlik bir anlığa düşür, çip paketi pozuq göndərir, təsdiqləri buraxır və ya özünü sıfırlayır. Arduino Uno-nun 3,3 V pini rəsmi sənədlərə görə ən çox 50 mA verir; standart modula bəs edir, amma 115 mA-a qədər çəkən PA+LNA versiyasına çatmır. Bəzi Nano klonlarında 3,3 V pini USB-serial çipindən gəlir və daha da zəifdir. Əlamətlər tanış gələcək: write() bəzən uğurlu, bəzən uğursuz olur, modula toxunanda daha yaxşı işləyir və ya məsafə bir neçə metrdə qalır.

  • 10 µF kondensator: Modulun VCC və GND pinlərinə, mümkün qədər yaxın bir 10 µF elektrolitik kondensator tax və ya lehimlə. Uzun ayaq (+) VCC-yə, zolaqlı tərəf (−) GND-yə gəlməlidir. 10–100 µF arası dəyərlər də işə yarayır; niyə işə yaradığını Kondensator nədir yazısında oxuya bilərsən.
  • 100 nF keramik kondensator: Elektrolitikə paralel əlavə olunan kiçik keramik kondensator (üzərində 104 yazılır) yüksək tezlikli küyü süzür. Kondensator üzərindəki kodları Kondensator kodu aləti ilə açıb oxuya bilərsən.
  • Soket adapteri: nRF24L01 üçün satılan 8 pinli adapter platalarında AMS1117-3.3 stabilizator və kondensatorlar hazır olur. Adapterin VCC-sinə 5 V verirsən, modula təmiz 3,3 V gedir.
  • Ayrıca stabilizator: PA+LNA versiyasını Arduino-nun 3,3 V pinindən yox, 5 V-dan qidalanan ayrıca AMS1117-3.3 stabilizatordan qidalandır və bütün GND-ləri birləşdir.
  • Qısa naqil: Jumper naqilləri mümkünsə 10 sm-dən qısa saxla; uzun və boş naqillər həm qidanı, həm SPI siqnallarını pozur.
AMS1117 3,3 V gərginlik stabilizatoru
AMS1117-3.3 stabilizator: 5 V-u 3,3 V-a endirir və PA+LNA modulunun göndərmə anındakı yüksək cərəyanını rahatlıqla təmin edir.

RF24 kitabxanasını quraşdırmaq

  1. Arduino IDE-də Tools › Manage Libraries menyusunu aç və ya soldakı kitabxana işarəsinə toxun.
  2. Axtarış qutusuna RF24 yaz və TMRh20 imzalı RF24 kitabxanasını quraşdır. RF24Network, RF24Mesh və RF24Ethernet ayrı kitabxanalardır, başlanğıc üçün lazım deyil.
  3. Quraşdırmadan sonra File › Examples › RF24 altında GettingStarted nümunəsini görəcəksən. Bu yazıdakı kodlar RF24-ün 1.5 və sonrakı versiyalarının yazılışı ilə hazırlanıb.
  4. Kitabxana quraşdırmaqda ilk dəfə çətinlik çəkirsənsə, Arduino kitabxana əlavə etmə yazısındakı addımlara bax.
İnternetdəki köhnə nümunələrdə radio.openWritingPipe(address) və ardınca radio.stopListening() görəcəksən. RF24 1.5 versiyasından bəri bunun əvəzinə tək sətirdə radio.stopListening(address) yazmaq tövsiyə olunur; köhnə yazılış hələ də kompilyasiya olunur, amma "deprecated" (istifadədən çıxır) xəbərdarlığı verə bilər. Bu yazıdakı kod kompilyasiya olunmursa, RF24 kitabxanasını yenilə.

Ünvan, kanal və ötürmə sürəti: iki modulun razılaşması

İki modulun bir-birini eşitməsi üçün bəzi ayarlar hər iki tərəfdə eyni olmalıdır. Bunu rasiya danışığına bənzədə bilərsən: eyni tezliyə (kanal), eyni danışıq sürətinə (ötürmə sürəti) və eyni çağırış koduna (ünvan) ayarlı deyilsənsə, qarşı tərəfi eşidə bilməzsən. Ünvan 5 baytlıq massivdir və kodda "00001" kimi 5 simvollu mətn şəklində yazmaq ən asandır. Ünvanı cihazın kimliyi kimi yox, iki cihaz arasındakı ortaq yol kimi düşün: ötürücü paketi həmin yola buraxır, o yolu dinləyən qəbuledici paketi alır. Paket ölçüsü də vacibdir; RF24 defolt olaraq sabit ölçülü paket istifadə edir və qəbuledici ötürücü ilə eyni ölçünü gözləmirsə, paketi heç görmür.

AyarRF24 funksiyasıBu yazıdakı dəyərQeyd
KanalsetChannel(76)76 (2476 MHz)0–125 arası; hər iki tərəfdə eyni olmalıdır
Ötürmə sürətisetDataRate(RF24_250KBPS)250 kbpsSürət azaldıqca məsafə artır
ÜnvanstopListening(ünvan) / openReadingPipe(1, ünvan)"00001"Ötürücünün hədəfi = qəbuledicinin borusu
Paket ölçüsüsetPayloadSize(sizeof(veri))32 bayt (coystik nümunəsində 5)Sabit ölçüdə iki tərəf bərabər olmalıdır
Çıxış gücüsetPALevel(RF24_PA_LOW)AşağıUyğun olmalı deyil, məsafəni müəyyən edir
Avtomatik təsdiq və CRCDefolt olaraq açıqdır16 bit CRCSöndürəcəksənsə, hər iki tərəfdə söndür

Ötürücü kodu (TX)

İlk sınaq üçün iki Arduino-nu iki ayrı USB portuna qoş və modulların arasında 1–2 metr məsafə burax. Birinə aşağıdakı ötürücü kodunu yüklə. Kod hər saniyə sayğaclı mətn göndərir və qəbuledicinin təsdiq verib-vermədiyini Serial Monitor-a yazır. Serial Monitor-u 115200 baud sürətinə ayarlamağı unutma.

C++ (Arduino IDE)
1#include <SPI.h>
2#include <RF24.h>
3
4RF24 radio(9, 10);                        // CE, CSN pinleri / CE, CSN pins
5const uint8_t address[6] = "00001";       // iki tarafta aynı adres / same address on both sides
6char message[32];                         // en fazla 32 bayt / 32 bytes max
7uint16_t counter = 0;
8
9void setup() {
10  Serial.begin(115200);
11  if (!radio.begin()) {                   // modül cevap vermiyor / module not responding
12    Serial.println(F("nRF24L01 bulunamadi, kablolari kontrol et!"));
13    while (true) {}
14  }
15  radio.setChannel(76);                   // kanal 76 = 2476 MHz / channel 76 = 2476 MHz
16  radio.setDataRate(RF24_250KBPS);        // en uzun menzil / longest range
17  radio.setPALevel(RF24_PA_LOW);          // masa testi için düşük güç / low power for desk tests
18  radio.setPayloadSize(sizeof(message));  // paket boyu 32 bayt / 32-byte payload
19  radio.stopListening(address);           // verici modu + hedef adres / TX mode + target address
20}
21
22void loop() {
23  snprintf(message, sizeof(message), "Merhaba BlueGrays #%u", counter++);
24  bool ok = radio.write(message, sizeof(message));   // onay (ACK) geldi mi? / was it acknowledged?
25  if (ok) {
26    Serial.print(F("Gonderildi: "));
27    Serial.println(message);
28  } else {
29    Serial.println(F("Onay gelmedi"));
30  }
31  delay(1000);
32}

Qəbuledici kodu (RX)

C++ (Arduino IDE)
1#include <SPI.h>
2#include <RF24.h>
3
4RF24 radio(9, 10);                        // CE, CSN pinleri / CE, CSN pins
5const uint8_t address[6] = "00001";       // vericiyle aynı adres / same address as the transmitter
6char message[32];
7
8void setup() {
9  Serial.begin(115200);
10  if (!radio.begin()) {
11    Serial.println(F("nRF24L01 bulunamadi, kablolari kontrol et!"));
12    while (true) {}
13  }
14  radio.setChannel(76);                   // ayarlar vericiyle aynı / settings match the transmitter
15  radio.setDataRate(RF24_250KBPS);
16  radio.setPALevel(RF24_PA_LOW);
17  radio.setPayloadSize(sizeof(message));
18  radio.openReadingPipe(1, address);      // 1 numaralı boruyu aç / open pipe 1
19  radio.startListening();                 // alıcı modu / RX mode
20}
21
22void loop() {
23  if (radio.available()) {                // paket geldi mi? / has a packet arrived?
24    radio.read(message, sizeof(message));
25    Serial.print(F("Gelen: "));
26    Serial.println(message);
27  }
28}

radio.write() paketi göndərir və qəbuledici təsdiq edərsə true qaytarır; təsdiq gəlməzsə, defolt ayarda təxminən 1,5 ms fasilə ilə 15 dəfə yenidən cəhd edir, sonra false qaytarır. Qəbuledicidə openReadingPipe(1, address) 1 nömrəli borunu ötürücünün ünvanına tənzimləyir, startListening() modulu dinləmə rejiminə keçirir, available() gözləyən paket olub-olmadığını bildirir, read() isə paketi dəyişənə kopyalayır. Qəbuledicinin ekranında "Gelen: Merhaba BlueGrays #0", "#1", "#2" kimi artan sətirlər görürsənsə, əlaqən işləyir deməkdir.

Modulları sınayanda yan-yana qoyma və gücü aşağı saxla. Xüsusilə PA+LNA modullar bir neçə santimetr aralıqla tam güclə işləyəndə bir-birinin qəbuledicisini doydurur və paketlər itir; bu da sanki nasazlıq varmış kimi görünür. Qısa məsafədə RF24_PA_LOW və ya RF24_PA_MIN istifadə et, real məsafədə gücü artır.

Məsafə: 100 metrdən 1 kilometrə

Məsafəni üç şey müəyyən edir: çıxış gücü, qəbuledicinin həssaslığı və mühit. Ötürmə sürəti azaldıqca qəbuledici daha zəif siqnalları oxuya bilir; 250 kbps-də həssaslıq −94 dBm, 2 Mbps-də isə −82 dBm-dir. Arada 12 dB fərq açıq sahədə təxminən 4 qat məsafə deməkdir. Divarlar, ağaclar, insan bədəni və metal səthlər 2,4 GHz siqnalını ciddi şəkildə zəiflədir; Wi-Fi modemləri, Bluetooth cihazları və mikrodalğalı sobalar da eyni diapazonu bölüşür.

Ötürmə sürətiQəbuledicinin həssaslığıNisbi məsafəNə vaxt?
250 kbps−94 dBmƏn uzunPult, uzaq sensor
1 Mbps−85 dBmOrtaÜmumi istifadə (RF24 defoltu)
2 Mbps−82 dBmƏn qısaYüksək sürət, qısa məsafə

Kanal seçimi də vacibdir. Geniş istifadə olunan 1, 6 və 11-ci Wi-Fi kanalları təxminən 2401–2473 MHz aralığını əhatə edir; nRF24L01-in 74–83 arası kanalları bunun üstündə qalır və yaxında 12-ci və ya 13-cü kanalı istifadə edən modem yoxdursa, daha sakitdir. Avropada lisenziyasız 2,4 GHz diapazonu 2400–2483,5 MHz olduğu üçün 83-dən yuxarı kanalları istifadə etmə; internetdəki bəzi nümunələrdə görünən 100 və yuxarı kanallar bu diapazondan kənardadır. Məsafəni artırmaq üçün bunları sına:

  • 250 kbps istifadə et: Pult və sensor verisi üçün yüksək sürət lazım deyil, aşağı sürətlə məsafə qazanırsan.
  • Əvvəlcə qidanı düzəlt, sonra gücü artır: RF24_PA_MAX yalnız sabit 3,3 V və kondensatorla məna kəsb edir; zəif qidada gücü artırmaq işləri pisləşdirir.
  • Antenaları hündürə və eyni istiqamətə qoy: Yerdən 1–2 metr hündürlük və hər iki antenanın eyni istiqamətdə dik durması məsafəni nəzərəçarpacaq dərəcədə artırır.
  • Metaldan uzaq saxla: Modulu metal qutunun içinə və ya böyük batareya paketinin elə yanına qoyma.
  • Ekransız PA+LNA platasını sar: Metal qapağı olmayan PA+LNA modulunu elektrik lenti ilə sarıb üstündən alüminium folqa keçirmək özünün yaratdığı maneəni azaldır; folqa heç bir pinə və antena konnektoruna toxunmamalıdır.
  • Antenasız göndərmə: PA+LNA modulunu antena taxılı olmayanda tam güclə işlətmək güc gücləndiricisini zorlayır.

Coystiklə simsiz uzaqdan idarə pultu

İndi real layihə quraq: bir Arduino-ya qoşulu coystiklə ikinci Arduino-dakı servo mühərriki və LED-i simsiz idarə edək. Ötürücü tərəfdə coystikin VRx ucu A0-a, VRy ucu A1-ə, düymə (SW) ucu D2-yə qoşulur; ətraflı məlumat Coystik modulu yazısındadır. Qəbuledici tərəfdə servonun siqnal naqili D3-ə, LED isə 220 Ω rezistorla D4-ə qoşulur. İki tərəfdəki nRF24L01 qoşulması yuxarıdakı cədvəllə eynidir.

Bir neçə dəyəri tək paketdə göndərməyin ən təmiz yolu struct (struktur) istifadə etməkdir. Burada vacib bir detal var: dəyişən tiplərini int16_t və uint8_t kimi sabit ölçülü yazmalısan. Arduino Uno-da int 2 bayt, ESP32-də 4 baytdır; bundan başqa, ESP32 kompilyatoru strukturun sonuna hizalanma üçün boş baytlar əlavə edir. Eyni struktur Uno-da 5, ESP32-də 6 bayt olarsa, paket ölçüləri uyğun gəlmir və veri heç gəlmir. __attribute__((packed)) bu boşluqları aradan qaldırır və strukturu hər platada 5 bayt edir. Əvvəlcə ötürücü:

C++ (Arduino IDE)
1#include <SPI.h>
2#include <RF24.h>
3
4struct __attribute__((packed)) JoystickData {   // her kartta 5 bayt / 5 bytes on every board
5  int16_t x;
6  int16_t y;
7  uint8_t button;
8};
9
10RF24 radio(9, 10);                        // CE, CSN pinleri / CE, CSN pins
11const uint8_t address[6] = "JOY01";       // kumanda adresi / remote address
12JoystickData data;
13
14void setup() {
15  pinMode(2, INPUT_PULLUP);               // joystick butonu (SW) / joystick button (SW)
16  if (!radio.begin()) {
17    while (true) {}                       // modül yok / no module
18  }
19  radio.setChannel(76);
20  radio.setDataRate(RF24_250KBPS);
21  radio.setPALevel(RF24_PA_HIGH);         // orta-yüksek güç / medium-high power
22  radio.setPayloadSize(sizeof(data));
23  radio.stopListening(address);           // verici modu / TX mode
24}
25
26void loop() {
27  data.x = analogRead(A0);                // VRx ekseni 0-1023 / VRx axis 0-1023
28  data.y = analogRead(A1);                // VRy ekseni 0-1023 / VRy axis 0-1023
29  data.button = (digitalRead(2) == LOW);  // basılıysa 1 / 1 when pressed
30  radio.write(&data, sizeof(data));
31  delay(50);                              // saniyede 20 paket / 20 packets per second
32}

Sonra servonu və LED-i idarə edən qəbuledici:

C++ (Arduino IDE)
1#include <SPI.h>
2#include <RF24.h>
3#include <Servo.h>
4
5struct __attribute__((packed)) JoystickData {   // vericiyle birebir aynı / identical to the transmitter
6  int16_t x;
7  int16_t y;
8  uint8_t button;
9};
10
11RF24 radio(9, 10);                        // CE, CSN pinleri / CE, CSN pins
12const uint8_t address[6] = "JOY01";       // vericiyle aynı / same as the transmitter
13JoystickData data;
14Servo servo;
15unsigned long lastPacket = 0;
16
17void setup() {
18  pinMode(4, OUTPUT);                     // LED çıkışı / LED output
19  servo.attach(3);                        // servo sinyal pini / servo signal pin
20  if (!radio.begin()) {
21    while (true) {}
22  }
23  radio.setChannel(76);
24  radio.setDataRate(RF24_250KBPS);
25  radio.setPALevel(RF24_PA_HIGH);
26  radio.setPayloadSize(sizeof(data));
27  radio.openReadingPipe(1, address);
28  radio.startListening();                 // alıcı modu / RX mode
29}
30
31void loop() {
32  if (radio.available()) {
33    radio.read(&data, sizeof(data));
34    servo.write(map(data.x, 0, 1023, 0, 180));   // X ekseni -> servo açısı / X axis -> servo angle
35    digitalWrite(4, data.button ? HIGH : LOW);   // buton LED'i yakar / button lights the LED
36    lastPacket = millis();
37  }
38  if (millis() - lastPacket > 500) {      // 0,5 sn paket yok: güvenli konum / no packet for 0.5 s: failsafe
39    servo.write(90);
40    digitalWrite(4, LOW);
41  }
42}

Ötürücü saniyədə 20 paket göndərir; qəbuledici hər paketdə X oxunu 0–180 dərəcəyə çevirib servoya yazır. Qəbuledicidəki təhlükəsiz vəziyyət (failsafe) hissəsi çox vacibdir: pultun batareyası bitərsə və ya məsafədən kənara çıxarsan, son komanda sonsuza qədər icra olunmur, 0,5 saniyə paket gəlməsə, servo ortalanır və LED sönür. Robot maşın qurursansa, eyni yerdə mühərrikləri dayandırmalısan. Servonu Arduino-nun 5 V pinindən yox, ayrıca 5 V mənbədən qidalandırmaq servonun çəkdiyi cərəyan impulslarının nRF24L01-ə mane olmasının da qarşısını alır. Y oxunu L298N mühərrik sürücüsünə qoşaraq simsiz robot maşın hazırlaya bilərsən; servo haqqında ətraflı məlumat üçün Servo mühərrik nədir yazısına baxa bilərsən.

İkitərəfli əlaqə və bir neçə ötürücü

nRF24L01 eyni anda həm göndərib həm dinləyə bilməz, amma ikitərəfli rabitənin asan bir yolu var: ACK payload, yəni təsdiq paketinin içində məlumat göndərmək. Qəbuledici writeAckPayload() ilə növbəti təsdiqə əlavə edəcəyi məlumatı (məsələn, batareya gərginliyi və ya sensor dəyəri) əvvəlcədən hazırlayır; ötürücü write() uğurlu olduqdan sonra available() və read() ilə bu cavabı oxuyur. Bunun üçün hər iki tərəfdə enableDynamicPayloads() və enableAckPayload() çağırılmalıdır. Birdən çox ötürücü üçün qəbuledicinin 6 borusu var: 0 və 1-ci borular tam 5 baytlıq ünvan qəbul edir, 2–5-ci borular isə 1-ci borunun ünvanı ilə eyni gövdəni paylaşır və yalnız bir baytda fərqlənir. RF24-də bu bayt ünvan massivinin ilk simvoludur; buna görə "1Node", "2Node", "3Node" kimi yalnız ilk simvolu fərqli olan ünvanlar istifadə olunur. Daha böyük şəbəkələr üçün RF24Network və RF24Mesh kitabxanaları var.

ESP32 ilə nRF24L01 qoşulması

ESP32-də RF24 kitabxanası olduğu kimi işləyir və radio.begin() defolt VSPI xəttini istifadə edir: SCK = GPIO 18, MISO = GPIO 19, MOSI = GPIO 23. CSN üçün GPIO 5, CE üçün GPIO 4 yaxşı seçimdir. ESP32 DevKit platalarındakı 3,3 V stabilizator Uno-nunkundan güclüdür, yenə də 10 µF kondensatoru atlama. ESP32-C3 və ya ESP32-S3 kimi modellərdə defolt SPI pinləri fərqlidir, platanın pin xəritəsinə baxmalısan. ESP32-nin Wi-Fi-ı da 2,4 GHz-də işlədiyi üçün ikisini birlikdə istifadə edirsənsə, nRF24L01 kanalını modemin Wi-Fi kanalından uzaq seç. Aşağıdakı kod coystik ötürücüsündən gələn paketləri ESP32-də oxuyur; eyni quruluşla ESP32-ni nRF24L01 düyünlərindən gələn veriləni internetə ötürən şlüz kimi istifadə edə bilərsən. ESP32 platası sənə yenidirsə, ESP32 nədir yazısı ilə başla.

C++ (Arduino IDE)
1#include <SPI.h>
2#include <RF24.h>
3
4struct __attribute__((packed)) JoystickData {   // packed olmasa 6 bayt olurdu / 6 bytes without packed
5  int16_t x;
6  int16_t y;
7  uint8_t button;
8};
9
10RF24 radio(4, 5);                         // CE = GPIO 4, CSN = GPIO 5 pinleri / CE = GPIO 4, CSN = GPIO 5 pins
11const uint8_t address[6] = "JOY01";
12JoystickData data;
13
14void setup() {
15  Serial.begin(115200);
16  if (!radio.begin()) {                   // varsayılan VSPI: SCK 18, MISO 19, MOSI 23 / default VSPI pins
17    Serial.println("nRF24L01 bulunamadi!");
18    while (true) delay(1000);
19  }
20  radio.setChannel(76);
21  radio.setDataRate(RF24_250KBPS);
22  radio.setPALevel(RF24_PA_HIGH);
23  radio.setPayloadSize(sizeof(data));     // packed sayesinde 5 bayt / 5 bytes thanks to packed
24  radio.openReadingPipe(1, address);
25  radio.startListening();
26}
27
28void loop() {
29  if (radio.available()) {
30    radio.read(&data, sizeof(data));
31    Serial.printf("X=%d  Y=%d  Buton=%d\n", data.x, data.y, data.button);
32  }
33}

Yalnız ESP32 platalarının arasında əlaqə quracaqsansa, əlavə modul tələb etməyən ESP-NOW da yaxşı seçimdir; nRF24L01-in üstünlüyü isə Uno, Nano, Pro Mini kimi ucuz və az enerji sərf edən platalarla da işləməsidir.

Raspberry Pi Pico və MicroPython ilə nRF24L01

Pico-da MicroPython üçün rəsmi micropython-lib depozitindəki nrf24l01.py sürücüsü istifadə olunur. Faylı Thonny ilə Pico-ya köçürə və ya kompüterində mpremote mip install nrf24l01 əmri ilə quraşdıra bilərsən. Qoşulma SPI0 üzərindəndir: SCK = GP2, MOSI = GP3, MISO = GP4, CSN = GP5, CE = GP6 və VCC = 3V3(OUT). Sürücünün defoltları RF24-dən fərqlidir (kanal 46, paket ölçüsü 16 bayt), buna görə Arduino ilə danışmaq üçün kanalı, ötürmə sürətini və paket ölçüsünü kodda açıq şəkildə bərabərləşdiririk. Aşağıdakı kod coystik ötürücüsünün paketlərini Pico-da açır:

MicroPython
1from machine import Pin, SPI
2import struct
3import utime
4from nrf24l01 import NRF24L01, POWER_2, SPEED_250K
5
6spi = SPI(0, sck=Pin(2), mosi=Pin(3), miso=Pin(4))   # SPI0 pinleri / SPI0 pins
7csn = Pin(5, mode=Pin.OUT, value=1)                  # CSN pini GP5 / CSN pin GP5
8ce = Pin(6, mode=Pin.OUT, value=0)                   # CE pini GP6 / CE pin GP6
9
10nrf = NRF24L01(spi, csn, ce, channel=76, payload_size=5)   # Arduino ile aynı / same as the Arduino
11nrf.set_power_speed(POWER_2, SPEED_250K)             # -6 dBm güç, 250 kbps / -6 dBm power, 250 kbps
12nrf.open_rx_pipe(1, b"JOY01")                        # vericinin adresi / transmitter address
13nrf.start_listening()                                # alıcı modu / RX mode
14print("Dinleniyor... / Listening...")
15
16while True:
17    if nrf.any():                                    # paket geldi mi? / packet waiting?
18        x, y, button = struct.unpack("<hhB", nrf.recv())   # 2 + 2 + 1 bayt / 2 + 2 + 1 bytes
19        print("X:", x, "Y:", y, "Buton:", button)
20    utime.sleep_ms(5)

struct.unpack("<hhB") ifadəsi gələn 5 baytı iki ədəd 16 bitlik işarəli ədədə və bir bayta çevirir; əvvəldəki "<" işarəsi AVR və ESP32-nin istifadə etdiyi little-endian bayt sırasını bildirir. Modul tapılmasa, sürücü "nRF24L01+ Hardware not responding" xətası verir; bu, Arduino-da begin() funksiyasının false qaytarmasının MicroPython qarşılığıdır. Pico-ya yeni başlayırsansa, əvvəlcə Raspberry Pi Pico nədir yazısına bax.

radio.begin() false qaytarır: addım-addım həll

Serial Monitor-da "nRF24L01 bulunamadi" və ya RF24 nümunələrindəki "radio hardware is not responding!!" mesajını görürsənsə, Arduino modulla SPI üzərindən heç danışa bilmir deməkdir. Bu halda problem demək olar ki, həmişə naqil bağlantısında və ya qidada olur, kodda yox. Əvvəlcə aşağıdakı diaqnostika kodunu yüklə; modulun bütün ayarlarını oxunaqlı şəkildə çap edir.

C++ (Arduino IDE)
1#include <SPI.h>
2#include <RF24.h>
3#include "printf.h"                       // RF24 ile gelir / ships with RF24
4
5RF24 radio(9, 10);                        // kendi CE, CSN pinlerin / your CE, CSN pins
6
7void setup() {
8  Serial.begin(115200);
9  printf_begin();                         // printPrettyDetails için / needed for printPrettyDetails
10  bool ok = radio.begin();
11  Serial.print(F("begin(): "));
12  Serial.println(ok ? "true" : "false");
13  Serial.print(F("isChipConnected(): "));
14  Serial.println(radio.isChipConnected() ? "true" : "false");
15  radio.printPrettyDetails();             // tüm ayarları yazdır / print every setting
16}
17
18void loop() {
19}
  1. MOSI və MISO-nu yoxla: Ən çox qarışdırılan iki naqildir. Uno və Nano-da MOSI = D11, MISO = D12, SCK = D13; Mega-da 51, 50 və 52 olmalıdır.
  2. CE və CSN koddakı ilə eynidirmi: RF24 radio(9, 10) yazmısansa, CE D9-a, CSN D10-a getməlidir. RF24-ün GettingStarted nümunəsi 7 və 8 nömrəli pinləri istifadə edir; nümunəni dəyişdirmədən sınayırsansa, naqilləri ona görə tax.
  3. Qida 3,3 V-dur? Multimetrlə VCC ilə GND arasını ölç, 3,0–3,6 V görməlisən. Modul əvvəllər 5 V-a qoşulubsa, xarab olmuş ola bilər.
  4. printPrettyDetails çıxışına bax: Ünvanlar və registr dəyərləri hər zaman 0x00 və ya 0xff görünürsə, SPI xətti işləmir. Dəyərlər məntiqlidirsə, amma əlaqə yoxdursa, problem CE pinində, ayarlarda və ya qidadadır.
  5. Naqilləri qısalt, SPI sürətini azalt: Uzun və ya boş naqillərdə RF24 radio(9, 10, 4000000) yazaraq SPI sürətini defolt 10 MHz-dən 4 MHz-ə endir.
  6. Modulu dəyiş: Hər şey düzgündürsə, ehtiyat modulla sına; ucuz çoxlu paketlərdə nasaz modul çıxa bilər.

Veri gəlmir və ya kəsik-kəsik gəlir: tez-tez rast gəlinən xətalar

ƏlamətEhtimal olunan səbəbHəll
begin() true-dur, amma qəbulediciyə heç veri gəlmirKanal, ötürmə sürəti, ünvan və ya paket ölçüsü iki tərəfdə fərqlidirDörd ayarı iki kodda yan-yana müqayisə et
Uno-dan ESP32-yə veri gəlmirStruktur ölçüsü fərqlidir (5 və 6 bayt)Sabit ölçülü tiplər və __attribute__((packed)) istifadə et
write() false-dur, amma qəbuledici veriləni alırQəbuledicinin təsdiqi ötürücüyə çatmır, çox vaxt qəbuledici tərəfin qidasıQəbuledici moduluna da 10 µF kondensator əlavə et
Ekranda daim boş və ya mənasız veriSPI naqili boşdur və ya MISO qopubNaqilləri yenilə, SPI sürətini 4 MHz-ə endir
Modullar yan-yana olanda işləmir, uzaqlaşanda düzəlirTam güclə qəbuledici doyursetPALevel(RF24_PA_LOW) və ya RF24_PA_MIN istifadə et
Toxunanda daha yaxşı işləyirQeyri-sabit qida və ya ekransız PA+LNAKondensator, ayrıca stabilizator və folqa ekran
Bir neçə metrdə əlaqə qırılır2 Mbps sürət, zəif qida və ya Wi-Fi maneəsi250 kbps, təmiz qida, 74–83 arası kanal
Problem axtararkən həmişə ən sadə quruluşa qayıt: iki modul 1–2 metr aralıqla, RF24_PA_LOW, 250 kbps, qısa naqillər və 10 µF kondensator. Bu quruluşda işləyən əlaqə qurduqdan sonra məsafəni, gücü və kodun mürəkkəbliyini addım-addım artır; beləliklə, problemin hansı addımda başladığını dərhal görürsən.

nRF24L01 ilə layihə ideyaları

  • Simsiz robot maşın pultu: İki coystikli pultla robot maşını onlarla metr kənardan sür.
  • Bağça sensor stansiyası: Torpaq rütubət sensoru və temperatur verisini batareya ilə işləyən ötürücüdən evdəki ekrana göndər. radio.powerDown() ilə modul yuxuda təxminən 900 nA çəkir; batareya ömrünü Batareya ömrü aləti ilə hesablaya bilərsən.
  • Simsiz qapı və hərəkət siqnalizasiyası: PIR sensoru və ya reed rele işə düşəndə mərkəzdəki buzzer-i səsləndir.
  • Çoxotaqlı temperatur şəbəkəsi: Altı otaqdakı sensorun məlumatını altı boru üzərindən tək bir qəbulediciyə topla.
  • ESP32 şlüzü: nRF24L01 düyünlərindən gələn veriləri ESP32 ilə internetə, telefona və ya izləmə panelinə ötür.
  • Simsiz xal lövhəsi: Düymələri olan pultlarla idman zalındakı 7 seqment lövhəni uzaqdan yenilə.

nRF24L01 əlverişli qiymətinə baxmayaraq Bluetooth-dan daha uzun məsafə, daha aşağı gecikmə və çoxlu cihaz dəstəyi təklif edir; yeganə şərti təmiz 3,3 V qida və iki tərəfdə uyğun gələn ayarlardır. Telefondan idarə istəyirsənsə, HC-05 Bluetooth modulu, kilometrlərlə məsafə lazımdırsa, LoRa daha uyğun ola bilər; seçimlərin müqayisəsi Arduino simsiz əlaqə modulları yazısındadır. BlueGrays tətbiqində iki Arduino arasında əlaqə, coystiklə servo və LED idarəsi və uzaqdan idarə olunan maşın kimi layihələri dövrə sxemləri və hazır kodları ilə addım-addım tapa bilərsən.

Tez-tez verilən suallar

nRF24L01-in məsafəsi neçə metrdir?

Standart PCB antenli nRF24L01+ açıq sahədə 250 kbps sürətlə təxminən 50–100 metrə, bina daxilində isə divarlardan asılı olaraq 10–30 metrə çatır. Antenli nRF24L01+PA+LNA versiyası açıq və maneəsiz sahədə 800–1100 metrə qədər çıxa bilər. Bu dəyərlər üçün təmiz 3,3 V qida, 10 µF kondensator və aşağı ötürmə sürəti lazımdır.

nRF24L01 5V ilə işləyirmi?

Xeyr, VCC pini 1,9–3,6 V arasında işləyir və 5 V çipi xarab edə bilər. Buna qarşı CE, CSN, SCK və MOSI giriş pinləri 5 V-a davamlıdır, buna görə Arduino Uno-nun SPI pinlərinə səviyyə çeviricisi olmadan qoşula bilər. Modulu 5 V-dan qidalandırmaq istəyirsənsə, AMS1117-3.3 stabilizatorlu soket adapteri istifadə et.

"radio hardware is not responding" xətası niyə çıxır?

Bu mesaj radio.begin() false qaytaranda yazılır və Arduino-nun modulla SPI üzərindən danışa bilmədiyini göstərir. Ən çox rast gəlinən səbəblər yeri dəyişmiş MOSI və MISO, koddakından fərqli CE və CSN pinləri, kifayət etməyən və ya 5 V-luq qida və boş jumper naqillərdir. Naqilləri yoxlayıb printPrettyDetails() çıxışına baxmaqla problemi daraldabilərsən.

nRF24L01, yoxsa HC-05 Bluetooth?

İki Arduino arasında uzun məsafə, aşağı gecikmə və bir neçə cihaz lazımdırsa, nRF24L01 daha yaxşıdır. Telefondan idarə edəcəksənsə, HC-05 kimi Bluetooth modulu və ya ESP32 seçməlisən, çünki telefonlar nRF24L01-in protokolu ilə danışmır. HC-05-in məsafəsi adətən 10 metr civarındadır, nRF24L01 isə oxşar qiymətə xeyli uzağa çatır.

Bir nRF24L01 qəbuledicisi neçə ötürücünü dinləyə bilər?

Bir qəbuledici eyni anda 6 boru (pipe) dinləyə bilər, yəni birbaşa 6 ötürücüdən veri toplaya bilər. 2–5 nömrəli borular 1-ci borunun ünvan gövdəsini bölüşür və yalnız bir baytda fərqlənir. Daha çox düyün üçün ötürücüləri növbə ilə sorğulaya və ya RF24Network və RF24Mesh kitabxanaları ilə xeyli böyük şəbəkələr qura bilərsən.

nRF24L01 telefona qoşula bilərmi?

Birbaşa qoşula bilməz; nRF24L01 eyni 2,4 GHz diapazonunda işləsə də, Wi-Fi və ya Bluetooth protokolundan istifadə etmir. Telefondan idarə istəyirsənsə, nRF24L01 şəbəkəsinin mərkəzinə ESP32 qoyub veriləni Wi-Fi və ya Bluetooth üzərindən telefona ötürə bilərsən. Beləliklə, uzaq düyünlər nRF24L01 ilə, telefon isə ESP32 ilə danışır.

Bütün layihələrə bax
2 Arduino ilə birtərəfli rabitə
AR-57Orta
Premium

2 Arduino ilə birtərəfli rabitə

İki Arduino-nu tək naqillə danışdırırsan: birindəki düyməyə basanda o birindəki LED yanır, bir daha basanda sönür.

4.4(37)
50
2 Arduino ilə ikitərəfli əlaqə
AR-58Orta
Premium

2 Arduino ilə ikitərəfli əlaqə

İki Arduino naqillə bir-birinə qoşulur və danışır: birinin düyməsinə basanda o birinin işığı yanır, yenidən basanda sönür.

4.5(20)
26
Coystiklə LED idarəsi
AR-59Orta
Premium

Coystiklə LED idarəsi

Coystikin kiçik çubuğunu hansı istiqamətə sonadək itələsən, həmin istiqamətdəki LED yanır: sağ, sol, yuxarı və aşağı üçün dörd fərqli rəng var. Çubuğu buraxanda ortaya qayıdır və bütün LED-lər sönür.

4.7(50)
67
Coystiklə servo idarəsi
AR-60Orta
Premium

Coystiklə servo idarəsi

Coystik çubuğu ilə iki mühərriki idarə et, sanki təhlükəsizlik kamerasını çevirirsən.

4.7(42)
58
L298N ilə Bluetooth idarəli maşın
AR-80Qabaqcıl
Premium

L298N ilə Bluetooth idarəli maşın

Telefonunu pultə çevirib öz robot maşınını sür. Arduino, Bluetooth modulu vasitəsilə telefondakı idarəetmə tətbiqindən gələn əmrləri alır və mühərrik sürücüsü ilə təkərləri fırladır; maşın irəli…

5.0(39)
66
Bluetooth ilə telefondan LED yandırma
AR-34Başlanğıc
Premium

Bluetooth ilə telefondan LED yandırma

Telefonundan otaqdakı işıqları yandırıb söndürməyin kiçik bir sınağı. Bluetooth modulu telefondan gələn hərfləri Arduino-ya ötürür; bir hərf qırmızı LED-i, başqa hərf yaşıl LED-i yandırır, eyni…

4.8(69)
91
IR qəbuledici və pultla LED yandırıb söndürmə
AR-17Orta
Premium

IR qəbuledici və pultla LED yandırıb söndürmə

Kreslodan qalxmadan üç ayrı lampanı idarə etmək kimi: pultun 1, 2 və 3 düymələri göy, qırmızı və yaşıl LED-i yandırır, 4, 5 və 6 düymələri eyni ardıcıllıqla söndürür.

4.7(45)
66
ESP32 IR universal pult (IR qəbuledici + pult + 3 LED + buzzer + OLED)
ES-39Qabaqcıl
Premium

ESP32 IR universal pult (IR qəbuledici + pult + 3 LED + buzzer + OLED)

ESP32 ilə hazır IR pultu oxuyub öz cihazını idarə edə bilərsən! İnfraqırmızı qəbuledici (NEC protokolu, 38kHz) 20 düymələ pultun siqnallarını tutur: 1/2/3 düymələri üç ayrı LED-i yandırıb söndürür, PWR düyməsi hamısını söndürür. Naməlum düyməyə basanda OLED-də HEX kod çıxır; beləcə öz pultunun düymələrini asanlıqla koda əlavə edə bilərsən.

4.5(9)
16