Informacije o uređaju
Što prikazuje ovaj primjer
Upit ugrađenom TT-SC1 prijemniku tko je on. Skica prebacuje prijemnik u stanje CONFIGURATION, ispisuje njegov serijski broj, verziju firmwarea i tip uređaja, provodi test veze, ispisuje sve postavke i ugrađeni tekst pomoći prijemnika, a zatim prijemnik vraća na uobičajeno praćenje zrakoplova.
Primjer koda
Ovo je 2_DeviceInfo.ino iz fiksirane (pinned) biblioteke, bez zaglavnog komentara datoteke. Tijelo skice je točno onakvo kakvo se isporučuje. Zadano ožičenje biblioteke (UART1 na IO17 i IO18, reset na IO21) odgovara ovoj pločici, pa konstruktor ne treba argumente.
#include "ADSB-Receiver-SOLDERED.h"
// Create an instance of the ADS-B object
ADSBReceiver adsb;
void setup()
{
Serial.begin(115200);
adsb.begin(115200);
// Print every raw line the module sends, useful to see what is really happening.
adsb.onLine([](const String &line) {
Serial.print("[module] ");
Serial.println(line);
});
// Only in CONFIGURATION state can settings be read or written.
Serial.println("Entering CONFIGURATION state...");
if (!adsb.enterConfiguration())
{
Serial.println("Failed to enter CONFIGURATION state.");
return;
}
String value;
// Read the module's serial number.
if (adsb.getSerialNumber(value))
{
Serial.print("Serial number: ");
Serial.println(value);
}
// Read the currently installed firmware version.
if (adsb.getFirmwareVersion(value))
{
Serial.print("Firmware version: ");
Serial.println(value);
}
// Read the device type string reported by the module.
if (adsb.getDeviceType(value))
{
Serial.print("Device type: ");
Serial.println(value);
}
// Simple connectivity check, the module should always answer AT+OK.
Serial.print("Connection test (AT+TEST): ");
Serial.println(adsb.test() ? "OK" : "FAILED");
// Ask the module to list every setting and its current value.
Serial.println();
Serial.println("--- AT+SETTINGS? ---");
String settings;
if (adsb.getAllSettings(settings))
Serial.println(settings);
// Ask the module for its full built-in help text.
Serial.println();
Serial.println("--- AT+HELP ---");
String help;
if (adsb.getFullHelp(help))
Serial.println(help);
// Leave CONFIGURATION and resume normal aircraft tracking.
Serial.println();
Serial.println("Returning to RUN state...");
adsb.exitConfiguration(115200); // must match the BAUDRATE setting printed above
}
void loop()
{
}
Očekivani rezultat
Otvorite Tools → Serial Monitor, postavite brzinu prijenosa (baud rate) na 115200 i resetirajte pločicu. Skica se izvršava jednom u setup(), a loop() ostaje prazan, pa se ispis pojavi jednom i zatim staje.
Retci dolaze ovim redoslijedom: Entering CONFIGURATION state..., zatim retci sa serijskim brojem, verzijom firmwarea i tipom uređaja, potom redak testa veze (OK ili FAILED), blok --- AT+SETTINGS? ---, blok --- AT+HELP --- i na kraju Returning to RUN state.... Svaki odgovor koji modul pošalje dok skica komunicira s njim također se ispisuje, počevši s [module] , jer je onLine() registriran prije prve naredbe. Odgovor na test veze nalazi se u istom retku kao njegova oznaka Connection test (AT+TEST): , jer skica ispisuje oznaku prije slanja naredbe.
Entering CONFIGURATION state...
[module] AT+OK
[module] AT+CONFIG=1
[module] AT+SERIAL_NUMBER=33-0004127
Serial number: 33-0004127
[module] AT+FIRMWARE_VERSION=2.89.28.0
Firmware version: 2.89.28.0
[module] AT+DEVICE=TT-SC1
Device type: TT-SC1
Connection test (AT+TEST): [module] AT+OK
OK
--- AT+SETTINGS? ---
[module] AT+BAUDRATE=0
[module] AT+BOOT=0
[module] AT+CONFIG=1
[module] AT+DEVICE=TT-SC1
[module] AT+FIRMWARE_VERSION=2.89.28.0
[module] AT+LOCK=0
[module] AT+SERIAL_NUMBER=33-0004127
[module] AT+SYSTEM_LOG=0
[module] AT+SYSTEM_STATISTICS=0
[module] AT+ADSB_RX_PROTOCOL_DECODED=CSV
[module] AT+ADSB_RX_PROTOCOL_INC=0
[module] AT+ADSB_STATISTICS=CSV
AT+BAUDRATE=0
AT+BOOT=0
AT+CONFIG=1
AT+DEVICE=TT-SC1
AT+FIRMWARE_VERSION=2.89.28.0
AT+LOCK=0
AT+SERIAL_NUMBER=33-0004127
AT+SYSTEM_LOG=0
AT+SYSTEM_STATISTICS=0
AT+ADSB_RX_PROTOCOL_DECODED=CSV
AT+ADSB_RX_PROTOCOL_INC=0
AT+ADSB_STATISTICS=CSV
--- AT+HELP ---
[module] SETTINGS:
[module] SYSTEM:
[module] AT+BAUDRATE=0
[module] AT+BOOT=0
[module] AT+CONFIG=1
[module] AT+DEVICE=TT-SC1
[module] AT+FIRMWARE_VERSION=2.89.28.0
[module] AT+LOCK=0
[module] AT+SERIAL_NUMBER=33-0004127
[module] AT+SYSTEM_LOG=0
[module] AT+SYSTEM_STATISTICS=0
[module] ADSB:
[module] AT+ADSB_RX_PROTOCOL_DECODED=CSV
[module] AT+ADSB_RX_PROTOCOL_INC=0
[module] AT+ADSB_STATISTICS=CSV
[module] COMMANDS:
[module] AT+HELP
[module] AT+REBOOT
[module] AT+REBOOT_BOOTLOADER
[module] AT+SETTINGS_DEFAULT
[module] AT+TEST
AT+BAUDRATE=0
AT+BOOT=0
AT+CONFIG=1
AT+DEVICE=TT-SC1
AT+FIRMWARE_VERSION=2.89.28.0
AT+LOCK=0
AT+SERIAL_NUMBER=33-0004127
AT+SYSTEM_LOG=0
AT+SYSTEM_STATISTICS=0
AT+ADSB_RX_PROTOCOL_DECODED=CSV
AT+ADSB_RX_PROTOCOL_INC=0
AT+ADSB_STATISTICS=CSV
AT+HELP
AT+REBOOT
AT+REBOOT_BOOTLOADER
AT+SETTINGS_DEFAULT
AT+TEST
Returning to RUN state...
[module] AT+OK
[module] AT+CONFIG=0
Korištene funkcije
ADSBReceiver()returns NoneStvara objekt prijemnika. Bez argumenata koristi zadane vrijednosti biblioteke za pločicu: hardverski UART 1, IO17 za TX liniju prijemnika, IO18 za njegovu RX liniju i IO21 za njegovu RESET liniju, što odgovara ožičenju ove pločice.
ReturnsKonstruktor; nema povratne vrijednosti.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint8_t | uartNum | Hardverski UART ESP32 koji se koristi. Neobavezno, zadano 1. Izbjegavajte 0, koji je obično USB konzola. |
int8_t | rxPin | GPIO ESP32 spojen na TX pin modula. Neobavezno, zadano 17. |
int8_t | txPin | GPIO ESP32 spojen na RX pin modula. Neobavezno, zadano 18. |
int8_t | resetPin | GPIO ESP32 spojen na RESET pin modula. Neobavezno, zadano 21. Proslijedite -1 ako nije spojen. |
begin(uint32_t initialBaud, size_t rxBufferSize)returns voidOtvara UART vezu s prijemnikom. Pozovite je jednom u setup(). Također pretvara RESET pin u ulaz visoke impedancije, pa se pin pobuđuje samo tijekom hardwareReset().
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint32_t | initialBaud | Brzina prijenosa (baud rate) s kojom se započinje. Neobavezno, zadano 115200. Koristite 115200 osim ako je postavka BAUDRATE modula ranije promijenjena. |
size_t | rxBufferSize | Veličina UART prijemnog međuspremnika u bajtovima. Neobavezno, zadano 4096, što je više od 256 bajtova u jezgri ESP32 pa se promet velikog intenziteta ne skraćuje. |
onLine(LineCallback cb)returns voidRegistrira funkciju koja se poziva za svaki cjelovit redak koji prijemnik pošalje, prije nego što se redak obradi, uključujući AT odgovore na naredbe koje šaljete. Primjer je koristi za ispis svakog retka s prefiksom [module].
ReturnsNišta.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
void (*)(const String &line) | cb | Funkcija koja se poziva, a dobiva redak bez oznake kraja retka. Radi i lambda koja ništa ne hvata, kao u primjeru. |
enterConfiguration()returns boolPrebacuje prijemnik iz stanja RUN u stanje CONFIGURATION. Šalje AT+CONFIG=1, prebacuje lokalni UART na 115200 (fiksna brzina prijenosa prijemnika u stanju CONFIGURATION) i zatim potvrđuje novo stanje pomoću AT+CONFIG?. Čitanje i pisanje postavki radi samo u ovom stanju.
Returnstrue ako prijemnik javi da je u stanju CONFIGURATION, inače false.
getSerialNumber(String &out)returns boolČita serijski broj prijemnika pomoću AT+SERIAL_NUMBER?.
Returnstrue ako je prijemnik odgovorio, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
String & | out | Prima serijski broj. |
getFirmwareVersion(String &out)returns boolČita verziju firmwarea prijemnika pomoću AT+FIRMWARE_VERSION?.
Returnstrue ako je prijemnik odgovorio, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
String & | out | Prima verziju firmwarea. |
getDeviceType(String &out)returns boolČita niz s tipom uređaja koji prijemnik javlja, pomoću AT+DEVICE?.
Returnstrue ako je prijemnik odgovorio, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
String & | out | Prima tip uređaja. |
test()returns boolŠalje AT+TEST, jednostavnu provjeru veze. Ispravan prijemnik odgovara s AT+OK.
Returnstrue ako odgovor sadrži AT+OK, inače false.
getAllSettings(String &out)returns boolOd prijemnika traži sve postavke i njihove trenutne vrijednosti pomoću AT+SETTINGS?. Odgovor ima više redaka, pa funkcija nastavlja čitati dok prijemnik 150 ms ne utihne, najviše 1500 ms.
Returnstrue ako je stigao barem jedan redak, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
String & | out | Prima retke odgovora, spojene znakovima novog retka. |
getFullHelp(String &out)returns boolOd prijemnika traži ugrađeni tekst pomoći pomoću AT+HELP. Višeretčani odgovor čita na isti način kao getAllSettings().
Returnstrue ako je stigao barem jedan redak, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
String & | out | Prima tekst pomoći, spojen znakovima novog retka. |
exitConfiguration(uint32_t runBaud)returns boolVraća prijemnik iz stanja CONFIGURATION u stanje RUN. Šalje AT+CONFIG=0, prebacuje lokalni UART na runBaud i potvrđuje novo stanje pomoću AT+CONFIG?.
Returnstrue ako prijemnik javi da je u stanju RUN, inače false.
Parametri
| Tip | Naziv | Opis |
|---|---|---|
uint32_t | runBaud | Brzina prijenosa (baud rate) za stanje RUN. Neobavezno, zadano 115200. Mora odgovarati pohranjenoj postavci BAUDRATE prijemnika, zbog čega komentar u primjeru upućuje na ispis postavki. |
Sve zajedno
Prijemnik mora biti u stanju CONFIGURATION za pozive dohvaćanja i postavki, pa enterConfiguration() dolazi prvi, a
exitConfiguration() ga zatvara. Svaka funkcija za dohvaćanje popunjava String koji joj proslijedite i vraća true kad je prijemnik odgovorio, pa primjer ispisuje redak samo za odgovore koje je dobio.
Skica nikada ne poziva poll(), pa ne dekodira izvješća o zrakoplovima. To je jednokratna provjera ispravnosti, a ne tracker. Za ispis podataka o zrakoplovima koristite skicu
Čitanje izvješća o zrakoplovima.