Betaflight ustawienie utrzymania pozycji i utrzymania wysokości
Zakładka utrzymania pozycji FlySpark to ekran Betaflight dla utrzymania wysokości, utrzymania pozycji oraz autopilota, które mają te same tryby co GPS Rescue. Odczytuje pasujące zmienne CLI za pomocą opakowanego pobrania i zapisuje każdą zmianę jako set name = value. Kontrolki pojawiają się, gdy płytka jest Betaflight i zgłasza MSP API 1.47 lub nowsze, co odpowiada Betaflight 2025.12. Starsze oprogramowanie, w tym demonstracja w przeglądarce, otrzymuje zamiast pól kartę wyjaśniającą.
Połącz się w Chrome lub Edge przez USB lub Bluetooth. Aplikacja Android również łączy się przez USB OTG lub Wi-Fi. Aplikacja iPhone łączy się przez Bluetooth lub Wi-Fi. iPhone nie ma hosta USB, więc nigdy nie widzi kontrolera lotu przez USB, a strona przeglądarki nie może otworzyć Wi-Fi pojazdu. Zdejmij śmigła przed sprawdzeniem stabilizacji. GPS i ścieżka powrotu GPS Rescue są na GPS page. Przypisz ALTHOLD i POSHOLD na Modes tab.
Za darmo. Do połączenia ze sprzętem potrzebujesz Chrome lub Edge na komputerze; na telefonie użyj aplikacji FlySpark.
- Za darmo
- Bez instalacji
- Demo bez sprzętu
W skrócie
Betaflight utrzymanie pozycji, utrzymanie wysokości i wspólne numery autopilota znajdują się na karcie Utrzymanie pozycji w FlySpark. Karta wymaga Betaflight 2025.12 (MSP API 1.47). Demo w przeglądarce to Betaflight 4.5 (API 1.46) i pokazuje, że to oprogramowanie sprzętowe jest starsze.
Kluczowe fakty
- Pozycja do utrzymania wymaga Betaflight 2025.12, który raportuje MSP API 1.47.
- Demo przeglądarki to Betaflight 4,5 (API 1,46) i pokazuje tylko, że oprogramowanie sprzętowe jest starsze.
- ALTHOLD utrzymuje wysokość w trybie Angle. POSHOLD jest przypisany na karcie Tryby.
- Pozwól bez kompasu jest wyłączone, chyba że go włączysz. Kierunek może wtedy dryfować.
- Prędkość powietrza przy zawisie wynosi 1100 do 1700 µs. Utrzymanie wysokości, utrzymanie pozycji i GPS Ratunek zaczynają się od niej.
- Maksymalny kąt, od 10 do 70 stopni, pojawia się, gdy płyta zgłasza MSP API 1.48.
Betaflight
INAV
ArduPilot
PX4- BLHeli_S
Bluejay
AM32
ExpressLRS
EdgeTX
DroneCAN
MAVLink
Betaflight
Funkcje
- 01
Trzy CLI grupy
Nazwy zaczynające się od alt_hold_, pos_hold_, autopilot_ lub ap_ są grupowane jako Utrzymanie wysokości, Utrzymanie pozycji i Autopilot. Udokumentowana nazwa otrzymuje etykietę, jednostkę i pomoc. Każde inne dopasowanie jest wyświetlane jako nazwa CLI i jej surowa wartość.
- 02
Bramka oprogramowania układowego
Poniżej MSP API 1.47 karta mówi, że wymaga Betaflight 2025.12 lub nowszego. W treści znajduje się tryb utrzymania wysokości, utrzymania pozycji, a autopilot został dostarczony z MSP API 1.47, następnie drukuje API zgłoszone przez płytę.
- 03
Zbuduj bez ustawień
Nowe API bez zmiennych alt_hold, pos_hold ani autopilota mówi 'Nie w tej wersji oprogramowania' i mówi, aby zbudować Betaflight z utrzymaniem wysokości i pozycji (GPS i barometr).
- 04
Przełączniki i liczby całkowite
Dozwolone wartości dokładnie OFF i ON stają się przełącznikiem oznaczonym Off i On. Inne liczby używają minus i plus, mieszczą się w zakresie zgłoszonym przez płytę i wysyłają liczbę całkowitą. Podpowiedź kończy się nazwą CLI i wartością domyślną.
- 05
Udostępniono z GPS Rescue
Stopka autopilota mówi, że blok jest współdzielony przez utrzymanie wysokości, utrzymanie pozycji i GPS Ratunkowe. Tutaj znajdują się przepustnica do zawisu, limity przepustnicy, wzmocnienia wysokości i pozycji oraz wysokość lądowania.
- 06
Limit kąta w API 1.48
Maksymalny kąt jest nieobecny w API 1.47, a obecny w API 1.48. Jest to największe odchylenie w stopniach, używane podczas utrzymywania pozycji lub lotu GPS Rescue. Zakres wynosi od 10 do 70, domyślnie 50.
- 07
Demo pozostaje na 4.5
Symulowana płytka w przeglądarce to Betaflight 4,5 i zgłasza MSP API 1,46. Następnie karta pokazuje nowsze oprogramowanie sprzętowe. Pola przytrzymania nie są w tej demonstracji.
To, co widzisz przed kontrolkami
Jeśli płyta główna to Betaflight, a jej wersja API jest niższa niż 47, FlySpark nie odpyta zmiennych zatrzymania. Karta nosi tytuł Utrzymanie wysokości i pozycji. Wiersz to Wymaga Betaflight 2025.12 lub nowszej. Podtytuł mówi utrzymanie wysokości, utrzymanie pozycji, a autopilot przyszedł z MSP API 1.47, następnie API zgłoszone przez płytę. Demo w przeglądarce raportuje 1.46, ponieważ to oprogramowanie układowe to Betaflight 4.5. Karta obejmuje całą zakładkę: brak prędkości wznoszenia, strefy martwej ani przepustnicy do zawisu, a ekran ten wyświetla tylko powiadomienie o starszym oprogramowaniu układowym.
W API 1.47 lub nowszym, zapytania z ramką CLI dla alt_hold, pos_hold, autopilot i ap_ zachowują nazwy z tymi przedrostkami. Pusty wynik oznacza Nie w tej wersji oprogramowania układowego: płytka nie raportuje żadnych ustawień alt_hold, pos_hold ani autopilot, a ich użycie wymaga wersji z funkcją utrzymania wysokości i pozycji (GPS i barometr). Najpierw podawane są nazwy udokumentowane. Inne dopasowania pojawiają się według nazwy, jako zwykły wiersz z surową wartością.
Utrzymanie wysokości i utrzymanie pozycji
Funkcja utrzymania wysokości wymaga barometru lub GPS wysokości. Przypisz ALTHOLD na karcie Tryby. Nagłówek informuje, że dron leci w trybie Kąt podczas utrzymywania wysokości. Prędkość wznoszenia to alt_hold_climb_rate, w cm/s, dopuszczalny zakres 1 do 200, domyślnie 50. Jest to prędkość wznoszenia lub opadania przy całkowicie wychylonym drążku gazu w górę lub w dół. Wysokość jest utrzymywana przy wyśrodkowanym drążku. Martwa strefa gazu to alt_hold_deadband, w procentach, zakres 5 do 70, domyślnie 20. Jest to strefa wokół wyśrodkowanego gazu, jako procent zakresu drążka, w której utrzymywana jest wysokość. Poza nią, gaz steruje wznoszeniem lub opadaniem. Ten procent martwej strefy to Betaflight sterowanie. Martwa strefa wysokości INAV to inne ustawienie punktu drążka w INAV configurator.
Tryb utrzymania pozycji wymaga GPS z fixem 3D oraz kompasu, chyba że dozwolone jest bez niego. Przypisz POSHOLD na Modes tab. Pozwolenie bez kompasu to pos_hold_without_mag, wartości OFF i ON, więc jest to przełącznik. Domyślnie jest Wyłączony. Linia pomocy mówi, że umożliwia włączenie utrzymania pozycji bez działającego kompasu, kierunek może dryfować, więc utrzymanie pozycji może się przemieszczać, i że utrzymania powinny być krótkie, z unikaniem obrotu wokół osi yaw. Martwa strefa drążków to pos_hold_deadband, w procentach, zakres 0 do 50, domyślnie 5. Jest to strefa przechyłu i pochylenia, w której pozycja jest utrzymywana. Po jej przekroczeniu pojazd lata jak w trybie Angle, a nowy punkt utrzymania jest brany, gdy drążki wracają. Wartość 0 ignoruje drążki. Wskazówka obejmuje nazwę CLI i wartość domyślną, na przykład pos_hold_deadband, domyślnie 5.
Numery autopilota udostępniono GPS Ratunek
Stopka Autopilota mówi, że blok jest udostępniany przez utrzymanie wysokości, utrzymanie pozycji i GPS Ratunek. GPS Ratunek to ścieżka powrotu Betaflight, ustawiona na karcie Failsafe i opisana na GPS page. Te wzmocnienia są oddzielne od tabeli przechyłu, pochylenia i odchylenia na PID tab.
Wysokość lądowania to autopilot_landing_altitude_m, 1 do 15 m, domyślnie 4. Jest to wysokość nad miejscem startu, przy której GPS Ratunkowe i lądowania autopilota rozpoczynają powolny końcowy zjazd. Ciśnienie silnika w czasie zawisu to autopilot_hover_throttle, 1100 do 1700 µs, domyślnie 1275. Tryb utrzymania wysokości, utrzymania pozycji i GPS Ratunkowe startują z tej wysokości, więc ustaw je blisko rzeczywistego zawisu. Minimalne ciśnienie silnika to autopilot_throttle_min, 1050 do 1400 µs, domyślnie 1100, najniższe, jakie może wydawać kontroler wysokości. Maksymalne ciśnienie silnika to autopilot_throttle_max, 1400 do 2000 µs, domyślnie 1700, najwyższe, jakie może wydawać.
Wysokość P, I, D i feedforward (autopilot_altitude_P, _I, _D i _F) każda w zakresie od 0 do 200, domyślnie 15. P koryguje błąd wysokości: zbyt wysoko - odbicia, zbyt nisko - opadanie. I usuwa stały błąd, taki jak opadanie w miarę rozładowywania się baterii. D tłumi prędkość pionową, dzięki czemu wznoszenie i opadanie zatrzymują się bez przeregulowania. Feedforward wysyła żądaną prędkość wznoszenia bezpośrednio do przepustnicy. Pozycja P, I, D i przyspieszenie (autopilot_position_P, _I, _D i _A) każda w zakresie od 0 do 255, domyślnie 30. P przyciąga z powrotem do punktu przytrzymania. I usuwa stały dryf, na przykład spowodowany wiatrem. D tłumi prędkość względem punktu przytrzymania. Przyspieszenie tłumi zmiany prędkości i wygładza szum GPS. Odcięcie filtra pozycji to autopilot_position_cutoff, 10 do 250, domyślnie 80, filtr dolnoprzepustowy dla składników prędkości i przyspieszenia. Niższa wartość oznacza większe wygładzenie i późniejszą reakcję.
Maksymalny kąt to autopilot_max_angle, w stopniach, tylko gdy płytka raportuje MSP API 1.48. Zakres wynosi od 10 do 70, domyślnie 50. Jest to największe przechylenie, jakiego autopilot może użyć podczas utrzymywania pozycji lub lotu GPS Rescue. W API 1.47 wiersz jest nieobecny. Zapis wysyła każdą edycję jako ramkowany CLI zestaw liczby całkowitej, a następnie zapisuje ją wraz z innymi edycjami.
Tryby, GPS i gdzie podłączyć
Karty utrzymania nie przypisują przełącznika same. Umieść ALTHOLD i POSHOLD na karcie Tryby i przestaw każdy przełącznik, aby świeciły się zakresy kanałów, w ten sam sposób jak ARM lub ANGLE na Modes page. GPS poprawka 3D jest częścią stopki utrzymania pozycji. Kompas pozostaje wymagany, dopóki Opcja bez kompasu nie jest włączona. Codzienne porty i inne karty znajdują się w Betaflight configurator. INAV utrzymanie pozycji i powrót do domu to inne oprogramowanie układowe. Otwórz INAV configurator dla tych funkcji.
W przeglądarce użyj Chrome lub Edge. USB i Bluetooth działają tam. Wi-Fi do mostka szeregowego ESP lub symulatora to aplikacje Android i iPhone. Safari i Firefox pozostają na demonstracji, a ta demonstracja to płyta Betaflight 4.5 raportująca API 1.46.
W skrócie
Zakresy utrzymania pozycji zgłaszane na kartę
| Oprogramowanie układowe | Betaflight 2025.12 (MSP API 1.47) lub nowszy. Maksymalny kąt wymaga API 1.48. Demo w przeglądarce to 4.5 (API 1.46). |
|---|---|
| Utrzymanie wysokości | Prędkość wznoszenia 1 do 200 cm/s, domyślnie 50. Martwa strefa przepustnicy 5 do 70 procent, domyślnie 20. |
| Utrzymanie pozycji | Zezwalaj bez kompasu WYŁ. lub WŁ., domyślnie WYŁ. Martwa strefa drążków 0 do 50 procent, domyślnie 5. |
| Przepustnica | Unoszenie 1100 do 1700 µs, domyślnie 1275. Minimalne 1050 do 1400 µs, domyślnie 1100. Maksymalne 1400 do 2000 µs, domyślnie 1700. |
| Zyski | Wysokość P, I, D oraz przewidywanie każdy od 0 do 200, domyślnie 15. Pozycja P, I, D oraz przyspieszenie każdy od 0 do 255, domyślnie 30. Próg 10 do 250, domyślnie 80. Wysokość lądowania 1 do 15 m, domyślnie 4. Maksymalny kąt 10 do 70 stopni, domyślnie 50, w API 1.48. |
| Połączenie | Chrome lub Edge nad USB lub Bluetooth. Android: USB, Bluetooth lub Wi-Fi. iPhone: Bluetooth lub Wi-Fi. iPhone nie ma USB gospodarza. |
Betaflight
Jak ustawić utrzymanie pozycji Betaflight w FlySpark
Potwierdź oprogramowanie układowe
Podłącz kontroler lotu. Jeśli zakładka pokazuje Potrzebuje Betaflight 2025.12 lub nowszego, płyta jest starsza niż MSP API 1.47. Demo w przeglądarce wyświetla 1.46 i zatrzymuje się na tej karcie. Wgraj 2025.12 lub nowsze na sprzęt, zanim pojawią się pola.
Sprawdź build
Jeśli karta wskazuje Brak w tej wersji firmware, API jest wystarczająco nowy, ale nie wróciła żadna zmienna alt_hold, pos_hold ani autopilot. Użyj wersji zawierającej utrzymanie wysokości i pozycji, co wymaga GPS i barometru.
Ustaw dwa uchwyty
Ustaw prędkość wznoszenia od 1 do 200 cm/s (domyślnie 50) oraz martwą strefę przepustnicy od 5 do 70 procent (domyślnie 20). Pozostaw opcję Zezwalaj bez kompasu wyłączoną, chyba że akceptujesz dryfowanie kursu. Ustaw martwą strefę drążka od 0 do 50 procent (domyślnie 5). Przypisz ALTHOLD i POSHOLD na karcie Tryby.
Ustaw wspólne wartości autopilota
Ustaw przepustnicę hover blisko rzeczywistego hovera, w zakresie 1100 do 1700 µs (domyślnie 1275). Utrzymuj minimalną przepustnicę w zakresie 1050 do 1400 µs, a maksymalną przepustnicę w zakresie 1400 do 2000 µs. Ustaw wysokość lądowania od 1 do 15 m. W API 1.48, ustaw maksymalny kąt od 10 do 70 stopni.
Zapisz i przetestuj
Zapisuje każdą edytowaną zmienną jako osadzony zestaw CLI i przechowuje go. Podpowiedź w wierszu pokazuje nazwę CLI i domyślną wartość zgłoszoną przez płytę. Przetestuj najpierw przy wyłączonych śmigłach, potem z naprawą GPS, zanim zaufasz utrzymaniu.
Rozwiązywanie problemów
Częste problemy i poprawki
Problem
Zakładka pokazuje Wymaga Betaflight 2025.12 lub nowszej
Poprawka
Płyta zgłosiła MSP API starsze niż 1.47. Podtytuł wyświetla wymaganą wersję API i zgłoszoną. Demo w przeglądarce raportuje 1.46, ponieważ jest Betaflight 4.5. Zaktualizuj prawdziwą płytę do wersji 2025.12 lub nowszej. Pola pojawiają się dopiero po przejściu tej kontroli.
Problem
Zakładka mówi Nie w tej wersji oprogramowania
Poprawka
API jest w wersji 1.47 lub nowszej, ale żadna nazwa nie zaczyna się od alt_hold_, pos_hold_, autopilot_ ani ap_. Użyj kompilacji, która zawiera utrzymanie wysokości i pozycji (GPS oraz barometr).
Problem
Pozycja dryfuje lub drążki nic nie robią
Poprawka
Pozwól bez kompasu Włączone oznacza, że kurs może się przesuwać. Wyłącz, gdy zainstalowany jest kompas. Stopka wymaga również GPS naprawy 3D. Martwa strefa drążków 0 ignoruje drążki. Domyślnie jest 5 procent, w zakresie od 0 do 50.
Problem
Wysokość spada, odbija się lub przepustnica szuka
Poprawka
Ustaw przepustnicę Hover w pobliżu rzeczywistego hovera, w zakresie 1100 do 1700 µs. Minimalna przepustnica wynosi 1050 do 1400 µs, a maksymalna 1400 do 2000 µs. Współczynnik P wysokości jest zbyt wysoki, powoduje odbijanie, a zbyt niski opadanie, w zakresie 0 do 200. Prędkość wznoszenia działa tylko w zakresie 1 do 200 cm/s.
Problem
Brakuje maksymalnego kąta lub wprowadzona wartość nie zostanie zapamiętana
Poprawka
Maksymalny kąt pojawia się z MSP API 1.48, zakres 10 do 70 stopni, domyślnie 50. Wiersze liczb są ograniczone do dozwolonego zakresu i wysyłają liczbę całkowitą. Podpowiedź pokazuje nazwę CLI i wartość domyślną. OFF i ON stają się przełącznikiem. Każde inne wyszukiwanie to lista wyboru, z nazwami takimi jak GPS_ONLY w formacie zdania.
Słownik
Słownik pojęć
- ALTTRZYMAĆ
- Tryb nazwany w stopce utrzymania wysokości. Przypisz go na karcie Tryby. Lata w trybie Kąt podczas utrzymywania wysokości i wymaga barometru lub GPS wysokości.
- POSHOLD
- Tryb wymieniony w stopce Position hold. Przypisz go na karcie Tryby. Wymaga on GPS naprawy 3D i kompasu, chyba że włączona jest opcja Pozwól bez kompasu.
- GPS Ratunek
- Ścieżka powrotna Betaflight. Stopka Autopilota mówi, że podtrzymywanie w powietrzu, ograniczenia przepustnicy, wzmocnienia i wysokość lądowania są z nim współdzielone. Sama wysokość powrotu znajduje się na karcie Failsafe.
- MSP API 1.47
- API FlySpark wymaga tego, zanim odczyta te CLI zmienne. Karta łączy to API z Betaflight 2025.12. Demo 4.5 raportuje 1.46.
- Oprawiony CLI
- Kanał, którego używa ta karta. Wykonuje get dla każdego prefiksu nazwy i zapisuje set name = value, a następnie zapisuje edycję razem z innymi zapisanymi ustawieniami.
FAQ
Najczęstsze pytania
Która wersja Betaflight ma funkcję utrzymywania pozycji?
Betaflight 2025.12, MSP API 1.47, jest to pierwszy API, który karta akceptuje. Tekst mówi o utrzymaniu wysokości, utrzymaniu pozycji, a autopilot pojawił się z MSP API 1.47. Maksymalny kąt pojawia się, gdy płyta zgłasza API 1.48.
Czy pozycja lotu dema FlySpark jest aktualna?
Demo w przeglądarce jest symulowane Betaflight 4.5 i raportuje MSP API 1.46. Zakładka pokazuje, że wymaga Betaflight 2025.12 lub nowszej wersji oraz wskazanego API. Pola hold nie znajdują się w tym demo.
Jaka jest różnica między ALTHOLD a POSHOLD?
ALTHOLD lata w trybie Angle utrzymując wysokość i wymaga barometru lub GPS wysokości. POSHOLD wymaga GPS fix 3D i kompasu, chyba że opcja Zezwalaj bez kompasu jest włączona. Oba są przypisane na karcie Tryby.
Czy określanie pozycji może działać bez kompasu?
Tylko przy włączonym Allow without compass (pos_hold_without_mag). Domyślnie jest wyłączone. Linia pomocy mówi, że kierunek może dryfować, pozycja może się przesuwać, a utrzymanie pozycji powinno być krótkie, a skręcanie należy unikać.
Co robi martwa strefa drążka ustawiona na 0?
Linia pomocy mówi, że 0 ignoruje drążki. Zakres wynosi od 0 do 50 procent, domyślnie 5. Po przekroczeniu martwej strefy statek lata jak w trybie Angle, a nowy punkt zatrzymania jest ustalany, gdy drążki wracają.
Dlaczego na tej karcie jest przepustnica unoszenia?
Jest w grupie Autopilot. Podtrzymywanie wysokości, podtrzymywanie pozycji i GPS Rozpoczęcie ratunku zaczynają się od niego. Zakres wynosi od 1100 do 1700 µs, domyślnie 1275. Ustaw go blisko przepustnicy, która faktycznie utrzymuje zawis.
Czy to te same liczby co na karcie PID?
Wzmocnienia tutaj to autopilot_altitude_P poprzez autopilot_position_cutoff. PID tab to przechylenie, pochylenie i odchylenie. Ten blok jest współdzielony przez utrzymanie wysokości, utrzymanie pozycji i GPS Rescue.
Gdzie skonfigurowano GPS Rescue?
Ta zakładka zawiera wspólną wysokość podejścia, przepustnicę w trybie zawisu, ograniczenia przepustnicy, wzmocnienia oraz, w API 1.48, maksymalne nachylenie. Wysokość powrotna i kontrole poprawności znajdują się na zakładce Failsafe, omówione w GPS page.
Czy pozycja iPhone może utrzymać się nad USB?
iPhone nie ma USB hosta. Aplikacja iPhone używa Bluetooth lub Wi-Fi. USB to Chrome lub Edge, a aplikacja Android. Wi-Fi to aplikacje, ponieważ przeglądarka nie może otworzyć Wi-Fi adresu urządzenia.
Odnośniki
Źródła
Oficjalna dokumentacja stojąca za faktami na tej stronie.
- Position Hold (2025.12)Betaflight · betaflight.com
- Betaflight wikiBetaflight · betaflight.com
- NavigationINAV · github.com




