Logo FlySpark
Betaflight logoBetaflightHướng dẫn cài đặt Betaflight

Betaflight thiết lập giữ vị trí và giữ độ cao

FlySpark's tab giữ vị trí là màn hình Betaflight cho giữ độ cao, giữ vị trí và các số chế độ autopilot mà các chế độ đó chia sẻ với GPS Rescue. Nó đọc các biến CLI khớp nhau với một khung lấy và ghi mỗi thay đổi một cách đặt tên = giá trị. Các điều khiển xuất hiện khi bo mạch Betaflight và báo cáo MSP API 1.47 hoặc mới hơn, tức là Betaflight 2025.12. Firmware cũ hơn, bao gồm bản demo trong trình duyệt, sẽ nhận được một thẻ giải thích thay vì các trường này.

Kết nối bằng Chrome hoặc Edge qua USB hoặc Bluetooth. Ứng dụng Android cũng kết nối qua USB OTG hoặc Wi-Fi. Ứng dụng iPhone kết nối qua Bluetooth hoặc Wi-Fi. iPhone không có máy chủ USB, vì vậy nó không bao giờ nhìn thấy bộ điều khiển chuyến bay qua USB, và một trang trình duyệt không thể mở Wi-Fi của máy bay. Tháo cánh quạt trước khi bạn thử giữ. GPS và đường trả về GPS Rescue nằm trên GPS page. Gán ALTHOLD và POSHOLD trên Modes tab.

Miễn phí. Kết nối phần cứng cần Chrome hoặc Edge trên máy tính; trên điện thoại hãy dùng ứng dụng FlySpark.

  • Miễn phí
  • Không cần cài đặt
  • Demo không cần phần cứng

Tóm tắt

Betaflight giữ vị trí, giữ độ cao và các số liệu tự lái chia sẻ hiển thị trực tiếp trên tab Giữ vị trí trong FlySpark. Tab này cần Betaflight 2025.12 (MSP API 1.47). Bản demo trên trình duyệt là Betaflight 4.5 (API 1.46) và cho thấy firmware này cũ hơn.

Sự kiện chính

  • Việc giữ vị trí cần Betaflight 2025.12, báo cáo MSP API 1.47.
  • Phiên bản trình duyệt demo là Betaflight 4.5 (API 1.46) và chỉ hiển thị rằng phần mềm nhúng cũ hơn.
  • ALTHOLD giữ chiều cao ở chế độ Góc. POSHOLD được chỉ định trên tab Chế độ.
  • Cho phép khi la bàn tắt trừ khi bạn bật nó. Hướng sau đó có thể trôi.
  • Độ ga khi bay lơ lửng là 1100 đến 1700 µs. Giữ độ cao, giữ vị trí và GPS Rescue bắt đầu từ đó.
  • Góc tối đa, từ 10 đến 70 độ, xuất hiện khi bo mạch báo MSP API 1.48.
  • Betaflight logoBetaflight
  • INAV logoINAV
  • ArduPilot logoArduPilot
  • PX4 logoPX4
  • BLHeli_S
  • Bluejay logoBluejay
  • AM32 logoAM32
  • ExpressLRS logoExpressLRS
  • EdgeTX logoEdgeTX
  • DroneCAN logoDroneCAN
  • MAVLink logoMAVLink

Betaflight

Tính năng

  • 01

    Ba CLI nhóm

    Các tên bắt đầu bằng alt_hold_, pos_hold_, autopilot_ hoặc ap_ được nhóm thành Giữ cao độ, Giữ vị trí và Tự động lái. Một tên được ghi lại sẽ có nhãn, đơn vị và trợ giúp. Bất kỳ khớp nào khác sẽ được hiển thị dưới dạng tên CLI và giá trị thô của nó.

  • 02

    Cổng firmware

    Dưới MSP API 1.47, thẻ nói Cần Betaflight 2025.12 hoặc mới hơn. Phần thân nói giữ độ cao, giữ vị trí và hệ thống lái tự động đã được trang bị với MSP API 1.47, sau đó in ra API mà bo mạch báo cáo.

  • 03

    Xây dựng mà không có cài đặt

    Một API đủ mới nhưng không có các biến alt_hold, pos_hold hoặc autopilot sẽ báo Không có trong bản firmware này, và yêu cầu bạn xây dựng Betaflight với giữ độ cao và vị trí (GPS và một cảm biến áp suất).

  • 04

    Công tắc và số nguyên

    Các giá trị cho phép chính xác là OFF và ON trở thành một công tắc được gắn nhãn Off và On. Các số khác sẽ sử dụng dấu trừ và dấu cộng, kẹp vào phạm vi mà bo mạch báo cáo, và gửi một số nguyên. Gợi ý kết thúc với tên CLI và mặc định.

  • 05

    Đã chia sẻ với GPS Rescue

    Chân trang Autopilot cho biết khối được chia sẻ bởi giữ độ cao, giữ vị trí và GPS Rescue. Ga treo, giới hạn ga, lợi ích độ cao và vị trí, và độ cao hạ cánh nằm ở đây.

  • 06

    Giới hạn góc trên API 1.48

    Góc tối đa không có trên API 1.47 và có trên API 1.48. Đây là góc nghiêng lớn nhất, tính bằng độ, được sử dụng khi giữ vị trí hoặc bay GPS Rescue. Phạm vi từ 10 đến 70, mặc định là 50.

  • 07

    Demo vẫn ở 4.5

    Bảng mô phỏng trong trình duyệt là Betaflight 4.5 và báo cáo MSP API 1.46. Tab sau đó hiển thị thẻ firmware mới hơn. Các trường giữ không có trong bản demo đó.

Những gì bạn thấy trước các điều khiển

Nếu bo mạch là Betaflight và API phụ của nó dưới 47, FlySpark sẽ không truy vấn các biến giữ. Thẻ được đặt tên là Giữ độ cao và vị trí. Hàng là Cần Betaflight 2025.12 hoặc mới hơn. Phụ đề nói giữ độ cao, giữ vị trí và autopilot đi kèm với MSP API 1.47, sau đó là API mà bo mạch đã báo cáo. Bản demo trong trình duyệt báo 1.46 vì firmware đó là Betaflight 4.5. Thẻ là toàn bộ tab: không có tốc độ leo, deadband hoặc ga treo, và màn hình đó chỉ là thông báo firmware cũ.

Trên API 1.47 hoặc mới hơn, các truy vấn được đóng khung CLI cho alt_hold, pos_hold, autopilot và ap_ giữ tên với các tiền tố đó. Kết quả trống có nghĩa là Không có trong bản firmware này: bo mạch không báo cáo cài đặt alt_hold, pos_hold hoặc autopilot, và việc sử dụng chúng đồng nghĩa với một bản build có giữ độ cao và vị trí (GPS và một cảm biến áp kế). Tên được ghi chép xuất hiện trước. Các kết quả khớp khác theo tên, dưới dạng một hàng bình thường với giá trị thô.

Giữ độ cao và giữ vị trí

Chế độ giữ độ cao cần một thiết bị đo khí áp hoặc độ cao GPS. Gán ALTHOLD trong tab Chế độ. Phần chân trang ghi rằng máy bay bay ở chế độ Góc khi giữ độ cao. Tốc độ leo cao là alt_hold_climb_rate, đơn vị cm/s, phạm vi cho phép từ 1 đến 200, mặc định 50. Đây là tốc độ leo lên hoặc hạ xuống khi cần lái ga được đẩy lên hoàn toàn hoặc hạ xuống hoàn toàn. Độ cao được giữ khi cần lái ở vị trí tâm. Vùng chết ga là alt_hold_deadband, đơn vị %, phạm vi từ 5 đến 70, mặc định 20. Đây là vùng xung quanh vị trí trung tâm của cần ga, tính theo phần trăm dải cần, nơi độ cao được giữ. Bên ngoài vùng này, cần ga điều khiển việc leo hoặc hạ. Phần trăm vùng chết này là điều khiển Betaflight. Vùng chết độ cao của INAV là một cài đặt khác của điểm cần trong INAV configurator.

Chế độ giữ vị trí cần một GPS với sửa lỗi 3D, và một la bàn trừ khi được phép không có. Gán POSHOLD trên Modes tab. Cho phép không có la bàn là pos_hold_without_mag, các giá trị OFF và ON, vì vậy nó là một công tắc. Mặc định là Off. Dòng hướng dẫn nói rằng nó cho phép Position Hold kích hoạt mà không cần la bàn hoạt động, hướng có thể bị trôi nên chế độ giữ có thể lạc chỗ, và các chế độ giữ nên giữ trong thời gian ngắn với việc tránh xoay (yaw). Deadband của cần là pos_hold_deadband, tính theo phần trăm, phạm vi từ 0 đến 50, mặc định 5. Đây là dải lăn và nghiêng mà vị trí được giữ. Vượt qua phạm vi này, thiết bị sẽ bay giống như chế độ Góc (Angle mode), và một điểm giữ mới sẽ được lấy khi cần trở về. Giá trị 0 bỏ qua cần. Gợi ý bao gồm tên CLI và mặc định, chẳng hạn như pos_hold_deadband, mặc định 5.

Số liệu Autopilot được chia sẻ với GPS Rescue

Chân trang Autopilot cho biết khối này được chia sẻ bởi giữ độ cao, giữ vị trí và GPS Rescue. GPS Rescue là đường dẫn trả lại của Betaflight, được thiết lập trên tab Failsafe và được mô tả trên GPS page. Những hệ số này tách biệt với bảng cuộn, nghiêng và yaw trên PID tab.

Độ cao hạ cánh là autopilot_landing_altitude_m, từ 1 đến 15 m, mặc định là 4. Đây là độ cao so với vị trí home nơi GPS Rescue và chế độ hạ cánh tự động bắt đầu giảm tốc độ cuối cùng. Bướm ga bay giữ vị trí là autopilot_hover_throttle, từ 1100 đến 1700 µs, mặc định 1275. Giữ độ cao, giữ vị trí và GPS Rescue bắt đầu từ giá trị này, vì vậy hãy đặt nó gần với độ cao bay giữ thực tế. Bướm ga tối thiểu là autopilot_throttle_min, từ 1050 đến 1400 µs, mặc định 1100, là giá trị thấp nhất mà bộ điều khiển độ cao có thể ra lệnh. Bướm ga tối đa là autopilot_throttle_max, từ 1400 đến 2000 µs, mặc định 1700, là giá trị cao nhất mà bộ điều khiển có thể ra lệnh.

Các thông số P, I, D và feedforward cho độ cao (autopilot_altitude_P, _I, _D và _F) mỗi thông số có giá trị từ 0 đến 200, mặc định là 15. P điều chỉnh sai số độ cao: quá cao sẽ nảy lên, quá thấp sẽ tụt xuống. I loại bỏ sai số ổn định như tụt khi pin cạn kiệt. D làm giảm tốc độ theo phương thẳng đứng để việc leo hoặc hạ xuống dừng lại mà không vượt quá điểm mong muốn. Feedforward gửi trực tiếp tốc độ leo yêu cầu tới ga. Các thông số P, I, D và gia tốc cho vị trí (autopilot_position_P, _I, _D và _A) mỗi thông số có giá trị từ 0 đến 255, mặc định là 30. P kéo trở lại điểm giữ vị trí. I loại bỏ sự trôi ổn định, ví dụ như do gió. D làm giảm tốc độ so với điểm giữ vị trí. Gia tốc làm giảm thay đổi tốc độ và làm mượt nhiễu GPS. Điểm cắt bộ lọc vị trí là autopilot_position_cutoff, từ 10 đến 250, mặc định 80, là bộ lọc thông thấp cho các thông số tốc độ và gia tốc. Giá trị thấp hơn mượt hơn và phản hồi chậm hơn.

Góc tối đa là autopilot_max_angle, tính theo độ, chỉ khi bo mạch báo cáo MSP API 1.48. Phạm vi là từ 10 đến 70, mặc định là 50. Đây là độ nghiêng lớn nhất mà bộ tự lái có thể sử dụng khi giữ vị trí hoặc bay GPS Rescue. Trên API 1.47, dòng này không có. Lưu sẽ gửi mỗi chỉnh sửa dưới dạng một bộ CLI có số nguyên, sau đó lưu nó cùng với các chỉnh sửa khác.

Chế độ, GPS và nơi kết nối

Các thẻ giữ không tự gán công tắc. Đặt ALTHOLD và POSHOLD trên tab Chế độ và lật mỗi công tắc để đèn phạm vi kênh sáng, giống như ARM hoặc ANGLE trên Modes page. Một sửa lỗi 3D GPS là một phần của chân trang giữ vị trí. La bàn vẫn bắt buộc cho đến khi Cho phép không cần la bàn được bật. Các cổng hàng ngày và các tab khác nằm trong Betaflight configurator. Giữ vị trí INAV và trở về nhà là một phần mềm khác. Mở INAV configurator cho những cái đó.

Trong trình duyệt, sử dụng Chrome hoặc Edge. USB và Bluetooth hoạt động ở đó. Wi-Fi đến cầu nối ESP serial hoặc một trình mô phỏng là các ứng dụng Android và iPhone. Safari và Firefox giữ ở chế độ demo, và demo đó là bo Betaflight 4.5 báo cáo API 1.46.

Nhìn nhanh

Phạm vi giữ vị trí được báo cáo trên tab

Phần mềm cơ sởBetaflight 2025.12 (MSP API 1.47) hoặc mới hơn. Góc tối đa cần API 1.48. Bản demo trình duyệt là 4.5 (API 1.46).
Giữ độ caoTốc độ leo từ 1 đến 200 cm/s, mặc định 50. Vùng chết ga từ 5 đến 70 phần trăm, mặc định 20.
Giữ vị tríCho phép không cần la bàn BẬT hoặc TẮT, mặc định TẮT. Vùng chết cần điều khiển từ 0 đến 50 phần trăm, mặc định 5.
Bướm gaĐiểm treo 1100 đến 1700 µs, mặc định 1275. Tối thiểu 1050 đến 1400 µs, mặc định 1100. Tối đa 1400 đến 2000 µs, mặc định 1700.
Lợi íchĐộ cao P, I, D và feedforward mỗi giá trị từ 0 đến 200, mặc định 15. Vị trí P, I, D và gia tốc mỗi giá trị từ 0 đến 255, mặc định 30. Ngưỡng cắt từ 10 đến 250, mặc định 80. Độ cao hạ cánh từ 1 đến 15 m, mặc định 4. Góc tối đa từ 10 đến 70 độ, mặc định 50, trên API 1.48.
Kết nốiChrome hoặc Edge qua USB hoặc Bluetooth. Android: USB, Bluetooth hoặc Wi-Fi. iPhone: Bluetooth hoặc Wi-Fi. iPhone không có USB host.

Betaflight

Cách thiết lập giữ vị trí Betaflight trong FlySpark

  1. Xác nhận phần mềm cơ sở

    Kết nối bộ điều khiển chuyến bay. Nếu tab hiển thị Cần Betaflight 2025.12 hoặc mới hơn, bảng mạch cũ hơn MSP API 1.47. Bản demo trong trình duyệt báo 1.46 và dừng lại trên thẻ đó. Ghi 2025.12 hoặc mới hơn lên phần cứng trước khi các trường xuất hiện.

  2. Kiểm tra bản dựng

    Nếu tab hiển thị Không có trong bản dựng firmware này, API đủ mới nhưng không có biến alt_hold, pos_hold hoặc autopilot nào trả về. Sử dụng một bản dựng bao gồm giữ độ cao và vị trí, điều này cần GPS và một áp kế.

  3. Đặt hai giữ

    Đặt tốc độ leo từ 1 đến 200 cm/s (mặc định 50) và vùng chết ga từ 5 đến 70 phần trăm (mặc định 20). Giữ Allow without compass tắt trừ khi bạn chấp nhận hướng bay không ổn định. Đặt vùng chết của cần điều khiển từ 0 đến 50 phần trăm (mặc định 5). Gán ALTHOLD và POSHOLD trong tab Modes.

  4. Thiết lập các giá trị lái tự động chung

    Đặt ga lơ lửng gần mức lơ lửng thực, trong khoảng 1100 đến 1700 µs (mặc định 1275). Giữ ga tối thiểu trong khoảng 1050 đến 1400 µs và ga tối đa trong khoảng 1400 đến 2000 µs. Đặt độ cao hạ cánh từ 1 đến 15 m. Trên API 1.48, đặt Góc tối đa từ 10 đến 70 độ.

  5. Lưu và thử nghiệm

    Lưu ghi lại mỗi biến được chỉnh sửa dưới dạng một bộ CLI có khung và lưu lại nó. Gợi ý trên một hàng hiển thị tên CLI và mặc định mà bảng đã báo cáo. Thử nghiệm với cánh quạt tắt, sau đó với một bản sửa GPS, trước khi tin tưởng vào việc giữ.

Xử lý sự cố

Sự cố thường gặp và cách xử lý

  • Sự cố

    Tab hiển thị Cần Betaflight 2025.12 hoặc mới hơn

    Cách xử lý

    Ban điều hành đã báo cáo một API MSP cũ hơn 1.47. Phụ đề in ra API yêu cầu và API được báo cáo. Bản demo trên trình duyệt báo cáo 1.46 vì nó là Betaflight 4.5. Cập nhật một bo mạch thực sự lên 2025.12 hoặc mới hơn. Các trường chỉ xuất hiện sau khi kiểm tra đó vượt qua.

  • Sự cố

    Tab hiển thị Không có trong bản firmware này

    Cách xử lý

    API là 1.47 hoặc mới hơn, nhưng không có tên nào bắt đầu bằng alt_hold_, pos_hold_, autopilot_ hoặc ap_. Sử dụng một bản dựng bao gồm giữ độ cao và giữ vị trí (GPS và một máy đo áp suất).

  • Sự cố

    Giữ vị trí bị lạc hoặc cần điều khiển không có tác dụng

    Cách xử lý

    Cho phép không có la bàn Bật có nghĩa là hướng có thể bị trôi. Tắt nó khi đã gắn la bàn. Chân trang cũng yêu cầu GPS định vị 3D. Thanh chết 0 bỏ qua các thanh điều khiển. Mặc định là 5 phần trăm, trong khoảng từ 0 đến 50.

  • Sự cố

    Độ cao giảm, nhảy, hoặc ga giật

    Cách xử lý

    Đặt ga bay lơ lửng gần mức bay lơ lửng thực, trong khoảng 1100 đến 1700 µs. Ga tối thiểu là 1050 đến 1400 µs và ga tối đa là 1400 đến 2000 µs. Hệ số P độ cao quá cao sẽ nẩy và quá thấp sẽ sụt, trong khoảng 0 đến 200. Tốc độ leo chỉ chạy từ 1 đến 200 cm/s.

  • Sự cố

    Góc tối đa bị thiếu, hoặc giá trị đã nhập sẽ không được lưu

    Cách xử lý

    Góc tối đa xuất hiện với MSP API 1.48, phạm vi từ 10 đến 70 độ, mặc định là 50. Các hàng số được giới hạn trong phạm vi cho phép và gửi một số nguyên. Gợi ý hiển thị tên CLI và giá trị mặc định. OFF và ON trở thành một công tắc. Bất kỳ tra cứu khác là một danh sách lựa chọn, với các tên như GPS_ONLY viết theo kiểu câu.

Thuật ngữ

Bảng thuật ngữ

ALTHOLD
Chế độ được đặt tên trên chân trang Giữ độ cao. Gán nó trên tab Chế độ. Nó bay ở chế độ Góc trong khi giữ độ cao, và cần một áp kế hoặc độ cao GPS.
POSHOLD
Chế độ được đặt tên trên chân trang Giữ vị trí. Gán nó trong tab Chế độ. Nó cần một GPS sửa chữa 3D và một la bàn trừ khi Cho phép không cần la bàn được bật.
GPS Rescue
Đường dẫn quay về của Betaflight. Chân trang Autopilot nói rằng ga duy trì, giới hạn ga, hệ số tăng và độ cao hạ cánh được chia sẻ với nó. Độ cao quay về thì nằm ở tab Failsafe.
MSP API 1.47
API FlySpark yêu cầu trước khi nó đọc các biến CLI này. Tab liên kết API đó với Betaflight 2025.12. Bản demo 4.5 báo cáo 1.46.
Được đóng khung CLI
Kênh mà tab này sử dụng. Nó chạy lệnh get cho mỗi tiền tố tên và ghi set name = value, sau đó lưu chỉnh sửa cùng với các cài đặt đã lưu khác.

FAQ

Câu hỏi thường gặp

Phiên bản Betaflight nào có giữ vị trí?

Betaflight 2025.12, MSP API 1.47, là API đầu tiên mà tab chấp nhận. Văn bản nói giữ độ cao, giữ vị trí và bộ tự lái đến với MSP API 1.47. Góc tối đa xuất hiện khi bo mạch báo API 1.48.

Vị trí bay của bản demo FlySpark có giữ được không?

Bản demo trên trình duyệt được mô phỏng Betaflight 4.5 và báo cáo MSP API 1.46. Tab hiển thị Cần Betaflight 2025.12 hoặc mới hơn và API đã báo cáo đó. Các trường giữ không có trên bản demo đó.

Sự khác biệt giữa ALTHOLD và POSHOLD là gì?

ALTHOLD bay trong chế độ Góc trong khi giữ độ cao, và cần một áp kế hoặc GPS độ cao. POSHOLD cần một GPS định vị 3D và một la bàn trừ khi Cho phép không có la bàn được bật. Cả hai đều được gán trong tab Chế độ.

Có thể xác định vị trí mà không cần la bàn không?

Chỉ khi cho phép Không cần la bàn (pos_hold_without_mag) Bật. Mặc định là Tắt. Dòng trợ giúp nói rằng hướng có thể trôi, việc giữ vị trí có thể lạc, và việc giữ vị trí nên được giữ ngắn với việc tránh xoay quỹ đạo.

Một khoảng chết của cần điều khiển là 0 có nghĩa là gì?

Đường dây trợ giúp nói 0 bỏ qua các cần điều khiển. Phạm vi là từ 0 đến 50%, mặc định là 5. Vượt qua vùng chết, máy bay bay như chế độ Angle, và một điểm giữ mới được lấy khi cần điều khiển trở về.

Tại sao điều khiển ga khi di chuột lại ở tab này?

Nó nằm trong nhóm Autopilot. Giữ độ cao, giữ vị trí và GPS Rescue bắt đầu từ nó. Phạm vi là 1100 đến 1700 µs, mặc định 1275. Đặt nó gần với tay ga thực sự tạo độ bay lơ lửng.

Những con số này có giống với tab PID không?

Các giá trị thu được ở đây là autopilot_altitude_P đến autopilot_position_cutoff. PID tab là roll, pitch và yaw. Khối này được sử dụng chung bởi chế độ giữ độ cao, giữ vị trí và GPS Rescue.

GPS Rescue được cấu hình ở đâu?

Tab này chứa độ cao hạ cánh chung, ga giữ vị trí, giới hạn ga, các thông số điều chỉnh và, trên API 1.48, độ nghiêng tối đa. Độ cao quay về và kiểm tra hợp lý nằm trên tab Failsafe, được đề cập trong GPS page.

Một vị trí iPhone có thể giữ được trên USB không?

Một iPhone không có USB máy chủ. Ứng dụng iPhone sử dụng Bluetooth hoặc Wi-Fi. USB là Chrome hoặc Edge, và ứng dụng Android. Wi-Fi là các ứng dụng, vì trình duyệt không thể mở địa chỉ Wi-Fi của thiết bị.

Tham khảo

Nguồn

Tài liệu chính thức đứng sau các sự kiện trên trang này.

  1. Position Hold (2025.12)Betaflight · betaflight.com
  2. Betaflight wikiBetaflight · betaflight.com
  3. NavigationINAV · github.com

Công cụ

Xem mọi công cụ FlySpark

Sẵn sàng dùng thử?

Miễn phí. Kết nối phần cứng cần Chrome hoặc Edge trên máy tính; trên điện thoại hãy dùng ứng dụng FlySpark.