Skip to main content

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.

ESP32S3 Dev Module
7_CustomBoardWiring.ino
#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 None

Stvara 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

TipNazivOpis
uint8_tuartNumESP32 hardverski UART koji se koristi. Neobavezno, zadano 1. Izbjegavajte 0, koji je obično USB konzola.
int8_trxPinESP32 GPIO povezan na TX pin modula. Neobavezno, zadano 17.
int8_ttxPinESP32 GPIO povezan na RX pin modula. Neobavezno, zadano 18.
int8_tresetPinESP32 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 void

Otvara UART vezu na pinovima zadanima konstruktoru. Pozovite je jednom u setup().

ReturnsNišta.

Parametri

TipNazivOpis
uint32_tinitialBaudBaud rate od kojeg se kreće. Neobavezno, zadano 115200.
size_trxBufferSizeVeličina prijemnog međuspremnika UART-a u bajtovima. Neobavezno, zadano 4096.
onAircraft(AircraftCallback cb)returns void

Registrira funkciju koja se poziva za svako dekodirano izvješće zrakoplova koje prijemnik pošalje u CSV formatu.

ReturnsNišta.

Parametri

TipNazivOpis
void (*)(const AdsbAircraft &ac)cbFunkcija 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.