Arduino makroi: Potpuni vodič za njihovo savladavanje s primjerima

  • Makroi u Arduinu vam omogućavaju da optimizirate kod i memoriju prije kompajliranja.
  • Korištenje #define vam omogućava da kreirate prilagodljive funkcije, konstante i strukture.
  • Napredni makroi vam omogućavaju da povežete identifikatore i pristupite PROGMEM-u.
  • Disciplinirano korištenje makronaredbi poboljšava efikasnost bez žrtvovanja čitljivosti.
Isaac

5 minuta

Arduino Cores Zephyr OS beta-1

Arduino je napravio revoluciju u svijetu elektronike zahvaljujući lakoći s kojom se mogu kreirati funkcionalni prototipovi i projekti. Međutim, za one koji žele napraviti korak dalje u svom programiranju i optimizirati resurse, održati kod čistim i postići efikasnost, makroi postati ključni alat.

U ovom članku ćemo zaroniti duboko u upotrebu makroi u Arduinu: šta su, kako se koriste, njihove prednosti i ograničenja. A mi ćemo to učiniti tako što ćemo prikupiti najsveobuhvatnije i najkorisnije informacije iz najboljih izvora dostupnih na mreži, prepisane na jasan i moderan način da budu zaista praktični.

Šta su makroi u Arduinu?

Makroi su direktive pretprocesora u C/C++ koji vam omogućavaju zamjenu teksta prije kompajliranja koda. Umjesto izvršavanja instrukcija poput tradicionalne funkcije, makro funkcionira zamjenom dijelova izvornog teksta, koji ima direktan utjecaj na to kako se generira konačni binarni kod.

Pretprocesor Pokreće se prije stvarne kompilacije i odgovoran je za primjenu ovih zamjena. U Arduinu to dozvoljava od definisati konstante, uslovno uključiti datoteke ili čak kreirati male online funkcije koji štede vreme i memoriju.

Osnovni primjer: definicija kao #define LED_PIN 13 uzrokuje da se sav kod automatski zamijeni LED_PIN por 13 prije kompajliranja.

Ovo može izgledati trivijalno, ali nudi a moćan način za pisanje fleksibilnijeg koda koji se može održavati.

Prednosti korištenja makroa

Implementacija makroa u Arduino projekte može ponuditi niz specifičnih prednosti:

  • Poboljšajte čitljivost koda: Ponovnom upotrebom simboličkih imena, lakše je razumjeti svrhu svakog elementa.
  • Optimizirajte performanse: Ako ne generišu pozive funkcija, makroi mogu brže izvršavati operacije.
  • Smanjite upotrebu RAM-a: posebno korisno na pločama s ograničenim resursima, kao što su Arduino UNO.
  • Omogućava uslovne adaptacije: Moguće je kompajlirati različite fragmente koda ovisno o vrsti Arduino ploče koja se koristi.

Osnovni makroi: Upotreba #define

Direktiva #define Najviše se koristi. Koristi se za oboje definirati konstantne vrijednosti kao za kreirajte ubrizgane automatske funkcije u vrijeme prije kompilacije.

Primjer 1: Definirajte pin

#define PINLED 13

void setup() {
  pinMode(PINLED, OUTPUT);
}

void loop() {
  digitalWrite(PINLED, HIGH);
  delay(500);
  digitalWrite(PINLED, LOW);
  delay(500);
}

Primjer 2: Makro kao inline funkcija

int itemCounter = 0;
#define COUNT_ITEM() do { itemCounter++; } while(0)

void setup() {
  Serial.begin(9600);
  COUNT_ITEM();
  COUNT_ITEM();
}

void loop() {
  Serial.println(itemCounter);
}

Kao što vidite, upotreba uzorka uradi { … } dok(0) osigurava da se makro sigurno ponaša čak i ako se koristi unutar uvjetnih struktura.

## operator i makro konkatenacija

Operator ## je moćan alat za pretprocesor. koji dozvoljava spajanje identifikatora. Ovo je vrlo korisno kada želite dinamički generirati imena varijabli.

Praktični primjer:

#define GENERAR_VARIABLE(no) \
  int var##no = no;

void setup() {
  GENERAR_VARIABLE(3); // crea int var3 = 3
}

Važno upozorenje: Ovaj operater nije podjednako kompatibilan sa svim modelima Arduino ploča. Na primjer, može dobro raditi na Uno ili Esplori, ali neće uspjeti na Mega. Također, ne možete ugniježditi kreiranje makroa unutar drugih makroa koristeći ## direktno.

Makroi i ušteda memorije

Jedna od ključnih prednosti korištenja makroa u Arduinu je ušteda RAM-a. Arduino ima ograničen kapacitet, tako da učitavanje tekstualnih nizova direktno u RAM može postati značajan problem.

Napredna tehnika za izbjegavanje ovoga uključuje korištenje FORCE_INLINE i učitaj nizove iz programske memorije (PROGMEM):

#include <HardwareSerial.h>
#define MYSERIAL Serial
#define FORCE_INLINE __attribute__((always_inline)) inline

FORCE_INLINE void printFromFlash(const char *str) {
  char ch = pgm_read_byte(str);
  while (ch) {
    MYSERIAL.write(ch);
    ch = pgm_read_byte(++str);
  }
}

#define SERIAL_LOG(x) (MYSERIAL.print(x))
#define SERIAL_LOGLN(x) (MYSERIAL.println(x))

Korištenje ovih makroa može napraviti razliku između toga da projekt funkcionira ili ne, posebno u aplikacijama s ekranima ili više senzora.

Makroi u kombinaciji sa funkcijama

Makroi također mogu olakšati dinamičko pozivanje funkcija, na osnovu tipa proslijeđenog kao parametra. Jasan i prilično slikovit primjer je:

#define FUNC_LENTA(tipo) \
  { funcion_##tipo##_lenta(); }

#define FUNC_RAPIDA(tipo) \
  { funcion_##tipo##_rapida(); }

void funcion_caminar_lenta() {
  Serial.println("Andando despacio");
}

void funcion_caminar_rapida() {
  Serial.println("Andando rápido");
}

void setup() {
  Serial.begin(9600);
  FUNC_LENTA(caminar);
}

void loop() {
  FUNC_RAPIDA(caminar);
}

Zahvaljujući ## operatoru i makroima, možemo izbjeći ponavljanje struktura i centralizirati dinamičku logiku..

Makroi sa izlaznim parametrima

Također je moguće koristiti makroe za enkapsulaciju malih objekata ili konverzija:

#define BOOL_OUT() (bool){false}
#define NUM_OUT(a,b) (float){a+b}
#define STR_OUT(msg) (String){msg}

void loop() {
  Serial.println(BOOL_OUT());
  Serial.println(NUM_OUT(1.2, 3.4));
  Serial.println(STR_OUT("Mensaje"));
}

Dobre prakse i mjere opreza s makroima

Prekomjerno ili nemarno korištenje makronaredbi može dovesti do greške koje se teško otklanjaju. Na primjer, netačnim zamjenama ili definiranjem imena koja su u koliziji s imenima u vanjskim bibliotekama.

Neka osnovna pravila kako biste izbjegli probleme:

  • Izbjegavajte nepotrebne razmake ili prijelome redaka unutar makroa.
  • Nemojte uključivati ​​komentare unutar složenih makroa koji koriste više linija.
  • Koristite jedinstvena imena ili sa prefiksima (kao što je naziv projekta) kako bi se izbjegli sukobi.
  • Zamijenite makroe sa stvarnim konstantama ili funkcijama kad god je to moguće. Moderni C++ omogućava čistije, sigurnije alternative.

S druge strane, prekomjerna upotreba makroa može smanjiti jasnoću koda. Cilj bi trebao biti poboljšanje efikasnosti i modularnosti bez ugrožavanja mogućnosti održavanja.

Uslovne direktive i adaptivna kompilacija

Jedna od najpraktičnijih funkcionalnosti u skalabilnim projektima je korištenje makronaredbi za uslovno generisati kod, nešto vrlo korisno kada želite da ista skica radi na različitim pločama.

Tipičan primjer:

#ifdef ARDUINO_MEGA
  #define LEDPIN 53
#else
  #define LEDPIN 13
#endif

Takođe je korisno za kontrolu otklanjanja grešaka ili prikazivanje poruka kompajlera sa #pragma poruka ili čak generišu greške pod određenim uslovima sa #greška.

Makroi internog kompajlera

GCC predprocesor za AVR (koji se koristi u Arduinu) uključuje nekoliko specijalni makroi koji daju informacije o sistemu, veoma korisno tokom razvoja:

  • __LINE__: trenutni broj reda.
  • __FILE__: naziv trenutnog fajla.
  • __TIME__ i __DATE__: vrijeme i datum kompilacije.
  • __func__: naziv trenutne funkcije.

Oni omogućavaju kontrolu verzija, strukture dnevnika i olakšavaju održavanje i praćenje grešaka bez invazije na glavni kod.

Makroi nude moćan i fleksibilan način strukturiranja Arduino projekata. Oni vam omogućavaju da definišete konstante, uštedite memoriju, prilagodi kod ovisno o okruženju izvršenja i kreirajte blokove za višekratnu upotrebu bez dupliciranja linija. Naravno, zahtijevaju disciplinu, jasnoću i znanje kako bi se izbjegle suptilne greške ili gubitak čitljivosti. Kada se pravilno primjenjuju, oni su neprocjenjivo bogatstvo za srednje i napredne programere.


Dodaj kao preferirani izvor na Googleu