Povezivanje na vlastitu pločicu
Što prikazuje ovaj primjer
Korištenje biblioteke kad prijemnik nije povezan onako kako je povezan na ovoj pločici: drugi hardverski UART, drugi GPIO pinovi ili uopće nema RESET linije. Sva četiri parametra konstruktora neobavezna su i međusobno neovisna, pa nadjačavate samo one koji se razlikuju od vašeg povezivanja.
Na ovoj pločici to vam nije potrebno. Prijemnik je povezan na UART1 s pinovima IO17,
IO18 i IO21, a to su zadane vrijednosti biblioteke, pa je ADSBReceiver adsb;
dovoljno, kao u primjeru
Čitanje izvješća zrakoplova.
Ovu stranicu koristite kad Soldered modul prijemnika ugrađujete u vlastiti ESP32 dizajn.
Kod primjera
Ovo je 7_CustomBoardWiring.ino iz fiksirane verzije biblioteke, bez uvodnog
komentara datoteke. Tijelo skice je točno onakvo kakvo se isporučuje. Njezino primjer povezivanja je UART2
na IO4 i IO5 bez RESET pina.
#include "ADSB-Receiver-SOLDERED.h"
// Constructor parameters, in order:
// uartNum - which ESP32 hardware UART peripheral to use (avoid 0, that's usually the USB/console UART)
// rxPin - ESP32 GPIO wired to the module's TX pin
// txPin - ESP32 GPIO wired to the module's RX pin
// resetPin - ESP32 GPIO wired to the module's RESET pin, or -1 if not connected
//
// Example: module on UART2, using IO4/IO5, with no RESET pin wired at all.
ADSBReceiver adsb(2, 4, 5, -1);
// Called once per decoded aircraft update.
void onAircraft(const AdsbAircraft &ac)
{
Serial.print("ICAO ");
Serial.println(ac.icao);
}
void setup()
{
Serial.begin(115200);
// Open the UART link using the pins given to the constructor above.
adsb.begin(115200);
// Register the function to call whenever a decoded aircraft report arrives.
adsb.onAircraft(onAircraft);
}
void loop()
{
adsb.poll();
}
Na ovoj pločici prijemnik je povezan na IO17 i IO18, pa skica u izvornom obliku
(IO4 i IO5) osluškuje pinove koje prijemnik ne koristi i ne ispisuje ništa.
Promijenite konstruktor prema svom povezivanju ili za
ovu pločicu koristite ADSBReceiver adsb;.
Očekivani rezultat
Otvorite Tools → Serial Monitor, postavite baud rate na 115200 i resetirajte
pločicu. Kad je prijemnik povezan na pinove koje ste proslijedili konstruktoru i
kad je zrakoplov u dometu, skica ispisuje jedan redak za svako dekodirano ažuriranje zrakoplova:
ICAO, a zatim 24-bitna adresa zrakoplova u heksadecimalnom zapisu.
Adrese ovise o tome koji su zrakoplovi u dometu.
Korištene funkcije
ADSBReceiver(uint8_t uartNum, int8_t rxPin, int8_t txPin, int8_t resetPin)returns NoneStvara objekt prijemnika i određuje koji UART i pinove treba koristiti. Svi su parametri neobavezni; zadane vrijednosti odgovaraju povezivanju ove pločice. Biblioteka se može izgraditi samo za ESP32 obitelj, jer izravno upravlja jednim od hardverskih UART-ova čipa.
ReturnsKonstruktor; nema povratne vrijednosti.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint8_t | uartNum | ESP32 hardverski UART koji se koristi. Neobavezno, zadano 1. Izbjegavajte 0, koji je obično USB konzola. |
int8_t | rxPin | ESP32 GPIO povezan na TX pin modula. Neobavezno, zadano 17. |
int8_t | txPin | ESP32 GPIO povezan na RX pin modula. Neobavezno, zadano 18. |
int8_t | resetPin | ESP32 GPIO povezan na RESET pin modula. Neobavezno, zadano 21. Proslijedite -1 ako nije povezan, što ujedno onemogućuje hardwareReset(). |
begin(uint32_t initialBaud, size_t rxBufferSize)returns voidOtvara UART vezu na pinovima zadanima konstruktoru. Pozovite je jednom u setup().
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint32_t | initialBaud | Baud rate od kojeg se kreće. Neobavezno, zadano 115200. |
size_t | rxBufferSize | Veličina prijemnog međuspremnika UART-a u bajtovima. Neobavezno, zadano 4096. |
onAircraft(AircraftCallback cb)returns voidRegistrira funkciju koja se poziva za svako dekodirano izvješće zrakoplova koje prijemnik pošalje u CSV formatu.
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
void (*)(const AdsbAircraft &ac) | cb | Funkcija koja se poziva. ac.icao je ICAO adresa zrakoplova kao heksadecimalni niz znakova. Polja za koja prijemnik nije imao podataka ostaju na zadanim vrijednostima, a odgovarajuća has... zastavica je false. |
poll()returns voidČita svaki primljeni bajt, parsira potpune retke i aktivira registrirane povratne pozive. Ne blokira, pa je pozovite u svakom prolasku kroz loop().
ReturnsNišta.
Sastavljanje cjeline
Mijenja se samo redak konstruktora kad se vaše povezivanje razlikuje. Sve nakon njega,
begin(), onAircraft() i poll(), radi jednako kao na ovoj pločici. Prijemnik
i dalje mora biti postavljen na CSV izlaz, koji je njegova zadana postavka prema
tehničkom listu prijemnika za firmware prijemnika v2.89.28. Firmware na vašem
prijemniku nije provjeren u odnosu na njega.