Jak ustawić powrót GPS w Betaflight: moduł GPS, punkt startowy i testy powrotu

Wiki Betaflight określa domyślne ustawienia ratunku jako „mniej więcej właściwe” dla typowej piątki akrobacyjnej, więc problem rzadko leży w samych liczbach. Ratunek zwykle zawodzi gdzie indziej: słaby moduł GPS, brak punktu startowego, kurs, którego kontroler lotu jeszcze nie ustalił, albo gaz do zawisu tak niski, że dron opada, zanim regulator go złapie. Omawiam te przyczyny po kolei, a na końcu podaję testy, które warto przejść, zanim powrót naprawdę będzie ci potrzebny.

Powrót GPS to jedna z procedur etapu 2 trybu awaryjnego i zależy od poprawnie ustawionego etapu 1. Jeśli nie masz jeszcze skonfigurowanego trybu awaryjnego, najpierw przeczytaj artykuł o nim na tej stronie.

Co robi dron podczas ratunku

Powrót składa się z pięciu faz. Każda kończy się po spełnieniu określonego warunku, a w tle działają kontrole poprawności („sanity checks”), które wychwytują powrót skazany na niepowodzenie.

Faza (nazwa w oprogramowaniu)	Co się dzieje	Przechodzi dalej, gdy
Wznoszenie (ASCEND)	Włącza tryb poziomowania („Angle”), wznosi się z ustawioną prędkością, zaczyna obracać się w stronę domu	Osiągnie wysokość powrotu
Obrót (ROTATE)	Dalej obraca się w stronę domu	Błąd kursu spadnie poniżej 15°
Lot do domu (FLY HOME)	Pochyla się do przodu, żeby utrzymać ustawioną prędkość względem ziemi, dodaje przechył przeciw znoszeniu przez wiatr	Znajdzie się w odległości zniżania od domu
Zniżanie (DESCEND)	Zwalnia i opada, celując w punkt około 2 m od domu	Zejdzie poniżej wysokości lądowania
Lądowanie (LAND)	Opada z ustawioną prędkością przy zerowej docelowej prędkości do przodu	Wykryje uderzenie przy przyziemieniu, potem rozbraja

Przesunięcie o 2 m jest celowe. Celowanie w krawędź małego okręgu wokół domu zamiast w sam punkt ogranicza przestrzelenie, a przy wietrze dron zwykle ląduje po zawietrznej stronie. Betaflight włącza też na cały czas ratunku wykrywanie kraksy, nawet jeśli masz je wyłączone, więc mocne uderzenie w drodze powrotnej może rozbroić drona.

Wybierz moduł GPS, który utrzyma pozycję

Wybierz moduł, który obsługuje protokół UBlox, pracuje z częstotliwością 10 Hz i ma funkcję szybkiego startu z zapamiętanych danych. Betaflight obsługuje moduły UBlox od M6 do M10. Moduły NMEA często aktualizują dane raz na sekundę albo rzadziej, przez co ratunek jest tak szarpany, że prawie nie da się z niego korzystać. Wiki podaje 5 Hz jako minimum dla płynnego sterowania; 1 Hz nadaje się tylko do wyświetlania współrzędnych w OSD albo w zapisie lotu.

Nowy moduł przetestuj na dworze, na stole, z podłączonym Configuratorem. Według wiki dobry egzemplarz:

• przy zimnym starcie łapie około 20 satelitów w ciągu paru minut, z czego 10-12 jest używanych do ustalenia pozycji 3D;
• dodaje satelity stopniowo, zamiast je wymieniać;
• trzyma stałą pozycję na mapie, a nie wędruje o kilka metrów;
• stojąc w miejscu, pokazuje prędkość poniżej 10-20 cm/s (odrzuć taki, który stale pokazuje ponad 25 cm/s);
• nie gubi satelitów, kiedy przechylisz drona o 45°.

Test przechyłu najczęściej się pomija. Dron w drodze do domu leci pochylony do przodu, a słaby moduł, który gubi satelity pod kątem, daje chaotyczny albo nieudany ratunek. Fizycznie większe moduły zwykle radzą sobie lepiej niż malutkie, a moduł z bateryjką podtrzymującą szybciej odzyskuje satelity po ponownym włączeniu zasilania.

W większości konstrukcji zostaw kompas wyłączony. Wiki pisze, że w większości piątek i mniejszych dronów magnetometr jest zbyt zaszumiony, żeby się przydać, a źle skalibrowany pogarsza ratunek. Włącz go dopiero wtedy, gdy zapis z dokładnie wylatanego kwadratu pokazuje czyste zmiany kursu o 90°.

Jak zamontować i podłączyć GPS

Płaska antena ceramiczna musi patrzeć w niebo i nic nie może jej zasłaniać od góry. Karbon, metal i przewody osłabiają sygnał. Poradnik iFlight proponuje tył ramy, jak najdalej od nadajnika wideo. Oscar Liang dopisuje do listy rzeczy, od których trzeba trzymać GPS z daleka, anteny odbiornika i nadajnika wideo oraz kamery HD, które nie zawsze są dobrze ekranowane.

GPS podłączasz do zwykłego UART-u: TX GPS-a do RX kontrolera, RX GPS-a do TX kontrolera, do tego 5 V i masa. Nie podłączaj GPS-a do UART-u odbiornika. Zasilaj go z pola lutowniczego, na którym napięcie pojawia się razem z kontrolerem lotu. Betaflight poprawnie wykrywa i konfiguruje moduł tylko wtedy, gdy oba dostają zasilanie w tej samej chwili.

Ustaw Betaflighta

1. Wgraj oprogramowanie skompilowane w chmurze z obsługą GPS. Jeśli GPS po każdym ponownym uruchomieniu sam się wyłącza, w tej kompilacji może go brakować.
2. W zakładce portów („Ports”) ustaw UART GPS-a jako wejście czujnika GPS. Wiki zaleca 57600 bodów przy domyślnej częstotliwości 10 Hz. 115200 przy 10 Hz niewiele daje, zabiera więcej czasu procesora i jest bardziej wrażliwe na zakłócenia elektryczne.
3. W zakładce konfiguracji („Configuration”) włącz GPS.
4. W zakładce GPS wybierz UBLOX i zostaw włączoną automatyczną konfigurację („Auto Config”; moduły M10 wymagają Betaflighta 4.5 lub nowszego). Włącz korzystanie z satelitów Galileo („Use Galileo”). Domyślnie ta opcja jest wyłączona, ale dokumentacja zakładki GPS mówi, że większość użytkowników powinna je włączyć.
5. Zapisz, uruchom ponownie i na dworze sprawdź zakładkę GPS: pozycję 3D, liczbę satelitów, pozycję, która stoi w miejscu, i niskie PDOP.

Informacje o wydaniu 4.5 ostrzegają przed przenoszeniem ustawień powrotu GPS i trybów poziomowania („Angle”, „Horizon”) ze starszego oprogramowania. Zacznij od domyślnych ustawień 4.5. Ratunek mocno obciąża też procesor, dlatego wiki zaleca żyroskop 8 kHz z pętlą PID 4 kHz zamiast 8 kHz i 8 kHz. Jeśli moduł nie chce się połączyć, polecenie status w wierszu poleceń (CLI) pokaże żądaną i zwróconą prędkość transmisji, a dla UBloxa także typ modułu.

Przed każdym lotem: punkt startowy i kurs

Kiedy powrót GPS jest skonfigurowany, Betaflight nie pozwoli uzbroić drona bez ustalonej pozycji 3D i co najmniej gps_rescue_min_sats satelitów. Domyślnie to 8, a wiki woli 10. Zostaw gps_rescue_allow_arming_without_fix wyłączone. Dron uzbrojony bez punktu startowego nie ma dokąd wracać: po rozpoczęciu ratunku przez 20 sekund wisi w stanie bezczynności („do nothing”), a potem się rozbraja.

Przed startem sprawdź OSD, a nie tylko migającą diodę na module. Dioda pokazuje ustaloną pozycję, a to nie to samo co zapisany punkt startowy. Po uzbrojeniu poszukaj ikony domu i odległości do domu. Jeśli prędkość i wysokość wciąż skaczą, poczekaj jeszcze 30-60 sekund. PDOP bliskie 1,0 albo niższe oznacza pewnie ustaloną pozycję.

Potem zdecyduj, czy włączyć zapisywanie punktu startowego tylko raz („Set Home Point Once”). Gdy jest wyłączona (domyślnie), każde uzbrojenie zapisuje nowy punkt startowy. W zwykłej sesji to nie przeszkadza, ale jeśli rozbroisz drona w połowie lotu i uzbroisz go ponownie 2 km dalej, powrót GPS zabierze drona właśnie tam. Gdy jest włączona, liczy się tylko pierwsze uzbrojenie po podłączeniu akumulatora, więc to pierwsze uzbrojenie musi nastąpić tam, dokąd dron ma wracać. Oscar Liang w swoim poradniku ją włącza.

Bez kompasu kontroler lotu ustala kurs na podstawie kierunku ruchu nad ziemią z GPS-a. Potrzebuje do tego co najmniej 2 m/s czystego lotu nosem do przodu przez kilka sekund. Po starcie leć idealnie prosto, a przy wietrze prosto pod wiatr albo z wiatrem, i obserwuj strzałkę do domu. Powinna wskazywać dom po 5-10 sekundach, czyli po 50-80 m. Jeśli nie wskazuje, wyląduj, podłącz akumulator od nowa i spróbuj jeszcze raz. Jeśli ratunek ruszy, zanim kontroler pozna kurs, dron może polecieć 50-80 m w złą stronę i dopiero wtedy zawrócić.

Ustawienia ratunku, które warto znać

Poniższe wartości domyślne są takie same w kodzie Betaflighta 4.5, 2025.12 i 2026.6.

Ustawienie (CLI)	Domyślnie	Co reguluje
gps_rescue_alt_mode	MAX_ALT	Sposób wyboru wysokości powrotu
gps_rescue_initial_climb	10 m	Dodatkowe wznoszenie ponad wysokość maksymalną albo bieżącą
gps_rescue_return_alt	30 m	Wysokość powrotu w trybie FIXED_ALT
gps_rescue_ascend_rate	750 cm/s	Prędkość wznoszenia
gps_rescue_ground_speed	750 cm/s	Prędkość w stronę domu
gps_rescue_descent_dist	20 m	Odległość od domu, w której zaczyna się zniżanie
gps_rescue_descend_rate	150 cm/s	Prędkość opadania (do dwóch razy więcej przy starcie z dużej wysokości)
gps_rescue_min_start_dist	15 m	Bliżej niż tyle dron od razu przechodzi do lądowania
gps_rescue_min_sats	8	Liczba satelitów potrzebna do zapisania punktu startowego i uzbrojenia
gps_rescue_sanity_checks	RESCUE_SANITY_FS_ONLY	Co się dzieje z ratunkiem, który się nie udaje

Najwięcej namysłu wymaga tryb wysokości. W trybie MAX_ALT dron wznosi się do najwyższego punktu osiągniętego od uzbrojenia plus wznoszenie początkowe (gps_rescue_initial_climb). To działa, jeśli w którymś momencie byłeś nad wszystkimi przeszkodami na trasie. W FIXED_ALT wraca na ustalonej wysokości nad punktem startowym, co pasuje do niskiego latania między drzewami albo budynkami o znanej wysokości. W CURRENT_ALT wznosi się o wartość wznoszenia początkowego ponad wysokość, na której zaczął się ratunek; wiki proponuje ten tryb do testów i do przełącznika paniki.

Wiatr to najczęstszy powód, dla którego dobrze skonfigurowany ratunek i tak zawodzi. Silny wiatr czołowy w drodze powrotnej potrafi znosić drona na bok albo pchać go do tyłu. Dron potrzebuje wystarczającego kąta pochylenia i gazu, żeby posuwać się do przodu, a długi powrót pod wiatr zużywa sporo energii z akumulatora, więc pamiętaj o tym, zanim odlecisz daleko z wiatrem. Jeśli podczas testowego ratunku dron ledwo daje radę, zwiększ maksymalny kąt ratunku (gps_rescue_max_angle, domyślnie 45° w 4.5 i 2025.12) i sprawdź limit gazu.

W 2025.12 zmieniło się kilka nazw. Gaz do zawisu, limity gazu, wysokość lądowania i PID-y wysokości trafiły do wspólnych ustawień autopilota, z których korzysta też utrzymywanie wysokości („Altitude Hold”):

4.5	2025.12 i nowsze
gps_rescue_throttle_hover	ap_hover_throttle
gps_rescue_throttle_min / _max	ap_throttle_min / ap_throttle_max
gps_rescue_landing_alt	ap_landing_altitude_m
gps_rescue_throttle_p / _i / _d	ap_altitude_p / _i / _d

Gaz do zawisu domyślnie wynosi 1275, a wysokość lądowania 4 m w obu wersjach. Górny limit gazu to 1700 w 4.5 i 2025.12 oraz 1900 w kodzie 2026.6. Polecenia get gps_rescue i get ap_ w CLI pokażą, jakich nazw używa wgrana wersja.

Gaz do zawisu, etap 1 i wyważenie poziomu

Te trzy ustawienia decydują o tym, jak pójdzie pierwsza sekunda ratunku.

Gaz do zawisu. Ratunek startuje od tej wartości, a regulator wysokości koryguje ją w górę albo w dół. Jeśli jest za niska, dron opada zaraz na początku. Sposób z wiki: ustaw przełącznik trybu awaryjnego tak, żeby od razu przechodził do etapu 2, jako procedurę etapu 2 wybierz lądowanie („Land”) i zmieniaj wartość gazu przy lądowaniu („Throttle value used while landing”), aż dron zacznie łagodnie opadać. Wpisz tę liczbę jako gaz do zawisu w ustawieniach powrotu GPS i jako zastępczą wartość gazu w etapie 1, a potem przestaw etap 2 z powrotem na powrót GPS. W razie wątpliwości daj trochę więcej. Dron, który wznosi się za szybko, to mniejszy kłopot niż taki, który spada jak kamień.

Etap 1. Kanałowi gazu w etapie 1 daj ręcznie ustawioną wartość gazu do zawisu, nigdy „Auto”, bo to ustawienie oznacza wyłączony gaz i dron spada. Ustaw też kanał trybu poziomowania tak, żeby włączał się w etapie 1. Dron wtedy wypoziomuje się i zwolni, zanim przejmie go ratunek. Nad wodą zbyt niski gaz w etapie 1 może wpakować drona do wody w tej jednej sekundzie, zanim ruszy powrót GPS.

Wyważenie poziomu. W trybie poziomowania dron musi wisieć płasko. Dron, który w tym trybie dryfuje na bok, w drodze do domu będzie ściągał w jedną stronę i dryfował przy lądowaniu. Akcelerometr da się skorygować w terenie. Dron musi być rozbrojony: włącz tryb poziomowania, daj gaz na maksimum i stukaj drążkiem pochylenia albo przechylenia w stronę przeciwną do dryfu, po 5-10 stuknięć naraz.

Trzy sposoby uruchomienia ratunku

• Prawdziwa utrata łącza. Etap 2 trybu awaryjnego masz ustawiony na powrót GPS. Kiedy łącze wróci, musisz wychylić drążek przechylenia albo pochylenia poza failsafe_stick_threshold (domyślnie 30%), żeby przejąć drona. Nie ruszaj drążków, dopóki obraz nie będzie stabilny, ostrzeżenie RXLOSS nie zniknie, a wskaźnik łącza nie będzie wyglądał normalnie. Jeśli złapiesz za drążki wcześniej, możesz przerwać ratunek, zanim cokolwiek zobaczysz.
• Przełącznik trybu awaryjnego. Tryb „FAILSAFE” przypisany do przełącznika AUX symuluje utratę łącza razem z etapem 1 albo, jeśli tak go ustawisz, od razu przechodzi do etapu 2. Przestawiasz przełącznik z powrotem i sterowanie wraca natychmiast, bez ruszania drążkami. Nie dziel tego zakresu kanału AUX z żadnym innym trybem.
• Przełącznik trybu powrotu GPS („GPS RESCUE”). Uruchamia ratunek natychmiast, bez opóźnienia etapu 1. Przydaje się przy utracie obrazu w dalekim locie albo przy utracie orientacji w locie w zasięgu wzroku. Przestawiasz przełącznik z powrotem i znowu sterujesz, choć bezwładność niesie drona jeszcze przez kilka sekund.

Wiki tłumaczy, dlaczego dwa ostatnie sposoby dobrze się uzupełniają: przełącznik trybu awaryjnego może zachować opóźnienie etapu 1, więc krótki zanik sygnału kończy się tylko napisem RXLOSS, a przełącznik powrotu GPS uruchamia powrót bez żadnej zwłoki. Jeśli po 20-30 sekundach ratunku uruchomionego przełącznikiem obraz nie wrócił, wiki radzi cofnąć przełącznik, rozbroić drona i iść go szukać. Dron zostaje wtedy blisko miejsca, w którym straciłeś obraz, a w akumulatorze zostaje trochę energii.

Testuj krok po kroku

1. Wybierz otwarte pole z miękką trawą, z dala od ludzi i dróg. Zostaw ustawienia domyślne i lataj blisko.
2. Sprawdź, czy w trybie poziomowania dron wisi płasko i czy po prostym przelocie strzałka wskazuje dom.
3. Odleć dalej niż minimalne 15 m, zawiśnij i włącz powrót GPS przełącznikiem. Wypatruj wznoszenia, obrotu w stronę domu i równego podejścia. Przerwij, gdy tylko coś wygląda źle.
4. Powtarzaj, aż za każdym razem dron wzniesie się, obróci, wróci i wyląduje. Dopiero wtedy zwiększaj odległość.
5. Przetestuj uruchamianie przełącznikiem trybu awaryjnego, razem z etapem 1.
6. Dopiero potem sprawdź prawdziwą utratę łącza, wyłączając moduł nadawczy w menu aparatury. Nie wyłączaj całej aparatury. Większość aparatur chce przy włączaniu mieć wszystkie przełączniki w pozycji wyłączonej, więc po ponownym włączeniu przełącznik uzbrajania stoi w pozycji wyłączonej i dron od razu się rozbraja.

Jeśli podczas testu z przełącznikiem dron zaczyna pływać albo coś idzie źle, nie rozbrajaj w panice. Cofnij przełącznik, a sterowanie od razu wróci. Jeśli poczekasz dłużej niż około 15 sekund, dron może się rozbroić i spaść.

Przed lotem, w którym ratunek naprawdę może się przydać, zrób blisko siebie jeden krótki ratunek z przełącznika, sprawdź, czy dron obraca się w stronę domu, i przerwij go.

Kiedy ratunek się poddaje

Kontrole poprawności istnieją po to, żeby ratunek, który nie ma szans się udać, skończył się dronem na ziemi, a nie odlotem w nieznane, pustym akumulatorem albo spalonymi silnikami. Domyślny tryb RESCUE_SANITY_FS_ONLY reaguje ostro przy prawdziwej utracie łącza i daje więcej czasu na cofnięcie przełącznika podczas testu uruchomionego przełącznikiem. Wiki wymienia między innymi takie kontrole:

• liczba satelitów poniżej połowy gps_rescue_min_sats łącznie przez 10 sekund;
• prędkość w stronę domu poniżej połowy docelowej łącznie przez 15 sekund;
• wznoszenie albo opadanie wolniejsze niż połowa ustawionej prędkości łącznie przez 10 sekund, na przykład gdy dron utknął na drzewie;
• brak punktu startowego w chwili rozpoczęcia ratunku.

W zależności od kontroli i trybu dron albo od razu się rozbraja, albo przez 20 sekund wisi w stanie bezczynności, a potem się rozbraja. RESCUE_SANITY_OFF służy tylko do testów, a i wtedy Betaflight rozbraja drona po 20 sekundach niepowodzenia. Kontrole mają luki: nic nie sprawdza bezwzględnej wysokości w drodze do domu, a błędne dane GPS mogą wysłać drona w złą stronę, nie uruchamiając żadnej kontroli.

Szybka diagnostyka

Objaw	Prawdopodobna przyczyna
Nie da się uzbroić	Jeszcze za mało satelitów; poczekaj
Na początku na chwilę opada, potem łapie wysokość	Gaz w etapie 1 za niski albo nieustawiony
Opada sekundę po starcie i zostaje nisko	Za niski gaz do zawisu
Nie poziomuje się w pierwszej sekundzie	Tryb poziomowania nie włącza się w etapie 1
Na początku leci w złą stronę	Kurs nieustalony (za krótko leciał prosto powyżej 2 m/s) albo zły kompas
Ściąga na bok, dryfuje przy lądowaniu	Źle skorygowany akcelerometr
Duże skoki sterowania co sekundę	Moduł podaje dane raz na sekundę; jeśli to NMEA, przełącz na UBlox
Twardo ląduje i się nie rozbraja	Wysokość z GPS-a zdryfowała w dół; przed startem sprawdź, czy jest stabilna

Nawet jeśli zrobisz to wszystko, wiki wprost pisze, że powrót GPS może nie sprowadzić drona, a w trybie lotu odwróconego (3D) w ogóle nie działa. Skonfiguruj go, przetestuj, a mimo to lataj tylko tak daleko, jak naprawdę sięgają łącze radiowe i obraz.