ZerotoQuad

Draft reference — under review

Betaflight bench reference

A draft reference for setup terms, command-line examples, failsafe behaviour and on-screen display settings. Checks against the specified equipment and software are still incomplete. Do not treat this page as a tested setup procedure or a ready-to-use print reference.

Versions referenced in the draft — not yet tested together.
Firmware: Betaflight 2025.12.5 (documentary baseline; hardware qualification pending).
App: Betaflight App 2025.12.2 (browser-installed PWA, not legacy native installer).
Web App version note: 2025.12.2 source baseline; verify the actual served App build.

A release-line address or installed PWA does not freeze the App patch. Record the actual board/revision, FC firmware/target/build options and App/browser/OS, and preserve the received configuration. If they differ, review the differences before changing settings; do not flash merely to match this page. Genuine screenshots, full settings verification and hardware tests remain pending. Read the version-specific official documentation alongside the book, not as proof that a test has happened.

Configuration areas — not a test sequence

Setup
With props removed, check that the 3D model matches the real quad. Record exact arming flags using the version's supported diagnostic view; an OSD warning can assist diagnosis but is not proof of motor or failsafe acceptance. For selected Build Two, use Chapter11's Prepare ordinary Angle for the first outdoor hover for detected ACC, orientation, calibration and saved readback.
Ports
Match the exact board's pads, reserved services and peripheral plan. Kakute H7 V1.5 uses UART3 for ELRS, UART1 for O4 Pro and reserves UART2 for Bluetooth. GOKU F722 Pro Mini V2 uses UART2 for ELRS and UART3 for Avatar Pro. MSP plus VTX (MSP + DisplayPort) can share the same HD UART; unrelated devices cannot. A UART number does not specify a power rail. For selected Build Two video commissioning, follow Chapter 11's Build Two protected video preparation; a saved Ports row alone does not establish camera or FC-overlay delivery.
Configuration
Board/sensor alignment, accelerometer and other supported feature settings, arming-angle and beeper configuration. Preserve the accepted arming limit; do not increase it to clear ANGLE. ESC protocol belongs in Motors in App 2025.12.2, not this tab. Ordinary two-axis Angle preparation is required for the selected first-hover lesson, not a tuning step or proof of flight readiness. Recovery starts with the Chapter 6 (Build One) or Chapter 9/10 (Build Two) exact device, supply, control and installation record. Normal GPIO needs an active sounder; motor beacons and backup finders are separate routes. Read back event masks and mute; a configured output alone does not prove sound. Backup charge/enable/stop behavior is model-specific. Selected Build Two Finder 2 uses the separate no-video timed-preparation lesson, not an extended sound check: full selected 4S or storage selected 6S, ShortSaver 1 A, FC USB monitoring and the owner's early-stop/finish rules. Never full 25.2 V 6S. The analog Matrix reference cart has no wired finder; do not transfer this charging method to it. Timing is not capacity or a passed function test.
Power & Battery
Voltage/current source and source-specific calibration; detected or deliberately forced cell count; separate warning/critical policy. Verify the exact pack and readings before flight. Alarm settings do not calibrate voltage, and available current/mAh is not automatically reliable. Chapter 11 owns the selected voltage-only comparison/count/warning lesson, including non-draining LOW/LAND checks and restoration to the adopted normal baseline. Keep unqualified consumption fields/alarms excluded; retain actual results in notes/battery-checks.txt. Its optional five-inch charger-relative consumption comparison is separate from absolute-current/range/load-coverage qualification and supplies no flight-reserve guarantee. It is not a prerequisite of the voltage-only route. This reference is not a live test recipe.
Failsafe
Record actual fallback settings and Stage 2 procedure. Use Chapter 11's complete Normal-radio arm/disarm and low-throttle DROP check, both sessions with props off, operator direct view and helper live-FC observation. Keep the owner's preparation, direct-pack/no-USB/final-load entry and bounded observations; this reference is not a live recipe. Retain the configured-state record with actual FC/all-four results, timing and ARM-off recovery limits. Failed, inconclusive or unperformed required checks mean no flight.
PID Tuning
P, I, D and feedforward per axis, plus rates; Anti-Gravity and VBAT sag compensation controls. Read back actual values; Chapter 12 owns tuning changes.
PID Tuning / Filter Settings
Filter Settings is a subtab within PID Tuning in the pinned App source, not a separate top-level Filters tab. Gyro and D-term filters, dynamic notch and RPM filter belong to Chapter 12; this location is not a tested UI workflow.
Receiver
Start with Chapter 11's completed radio-only flight-model record and Chapter 8's compatible endpoint/pairing record, not SIM-USB's button map. UART ELRS uses Serial (via UART) and CRSF; SPI ELRS is a separate receiver mode. Verify each labelled axis, direction, centre and endpoint. Keep RSSI Channel Disabled and RSSI ADC off for ordinary CRSF link stats. The standard Arm using CH5 route puts ARM on CH5 / AUX1. Telemetry enablement is here; verify actual radio reception separately.
Modes
Join the recorded physical controls and radio outputs to observed AUX values; the radio-only model check does not write FC modes. Standard ARM is CH5 / AUX1; optional PREARM uses a separate verified control. A highlighted range is not proof of arming. Selected no-GPS builds leave GPS RESCUE unassigned; optional crash-flip and other modes need their own checks. BEEPER uses a deliberate verified non-ARM control and later qualified props-off audible/stop checks. DISARMING is a state-change tone; DISARM_REPEAT depends on stick arming, not an arm switch left off. Follow the separate ordinary-Angle preparation for the complete saved range/ link set and actual switch observations. Never edit during powered receiver observation or mistake a range highlight for actual flight behavior.
Adjustments
Optional in-flight knob tweaks. Default empty.
Motors
Mixer, ESC protocol, bidirectional DShot and motor-pole controls are here. Read back the exact FC/ESC protocol, loop and bidirectional-DShot combination before any motor command; DShot300 and DShot600 are not interchangeable defaults. Props off, always. This override can command motors while disarmed; it is not normal-radio arming. Use the exact qualified battery/USB arrangement, one serial tool and zero commands before power/tool transitions. Test every motor's physical number, direction, startup and stop. On a verified RPM-capable ESC path, also require live RPM while turning and no more than 1% telemetry error on all four motors. Both selected ESCs use AM32 but have different exact targets; no old J-H-40/Bluejay migration applies. Until the RPM checks pass, do not enable RPM-dependent filtering. Change direction only with supported tooling for the firmware actually installed.
OSD
Plan a readable layout, then verify actual FC data and needed native warnings. The selected Build Two protected-video owner saves the mapped MSP/DisplayPort row, required MSP/HD settings and active OSD profile, then checks camera and advancing FC fields on a protected cold return. Its small commissioning layout does not replace the later flight/warning layout. Optional debug-only canvas CLI names may be absent; that alone is not failure or a reason to flash. A preview does not prove live delivery, warning timing or flight readability.
LED Strip
Optional. Off by default; the book leaves it off.
GPS
Neither selected build includes GPS. An added module needs its exact power/UART/protocol and navigation-state record; GPS Rescue requires separate versioned configuration and practical qualification.
Sensors
Read-only. Verify the gyro and accelerometer produce reasonable values with the quad still.
Logging / Blackbox
Read back device, mode, sampling fraction and enabled fields. The named Kakute H7 V1.5 uses SDCARD: select a separate 16GB microSDHC/FAT32 card (documented support SDSC/SDHC 1–32GB, FAT16/FAT32; not SDXC). GOKU Mini V2 uses 16MB SPIFLASH. Copy the Kakute card after log closure and full safe isolation; use the supported flash-transfer route for GOKU. In firmware 2025.12.5 the sample-rate values are fractions such as 1/4, not the integer 2. The resulting frequency depends on the actual PID loop. NORMAL is arming-based; an unarmed Motors-tab test does not automatically produce that log.
Presets
Optional configuration changes, not required setup. Preserve the last accepted state; check exact preset source/revision, firmware, hardware, options and previewed changes before applying. Save, reboot, read back and repeat affected acceptance checks. Keeping an accepted stock setup is a valid choice.
CLI
Keep complete unmodified diff all and dump all exports with exact board/target/firmware/build and active-profile records. A same-context restore also needs error checks, persisted readback and renewed acceptance; neither export backs up ESC or radio settings. Save writes FC configuration and reboots; exit is not an undo for every command.

Command-line examples — not a setup script

These are not a batch to paste. Begin with Chapter 11's identity, complete raw-backup and read-only inspection gates. The bare serial and aux examples inspect assignments; setters and feature toggles change configuration. Read each qualification and preserve the separate error, saved-readback and affected physical checks.

feature

Top-level flags. Toggle one with `feature NAME` or `feature -NAME`.

feature TELEMETRY

serial

Read the actual port assignments. Function bits include 1 = MSP, 64 = Serial RX, 2048 = VTX SmartAudio and 8192 = VTX Tramp; these last two are different protocols, not interchangeable labels.

serial

Read-only query with no arguments. The printed baud fields are MSP, GPS, telemetry and Blackbox, not the CRSF receiver link rate. Match the exact board wiring; this query does not choose a UART for you.

aux

Mode and AUX assignments — aux N MODE AUX_CHANNEL RANGE_MIN RANGE_MAX MODE_LOGIC LINKED_MODE_ID. The last fields are OR/AND logic and a linked mode's permanent ID, not PID or rate-profile selection.

aux

Read-only query with no arguments. Match observed switch/channel behavior and the exact version's mode IDs before any assignment. AUX_CHANNEL is zero-based: 0 means AUX1 / channel 5. The pinned range includes its lower bound and excludes its upper bound.

set serialrx_provider

UART receiver protocol. CRSF for the selected UART ELRS route; SPI ELRS uses a different receiver mode, not this setting.

set serialrx_provider = CRSF

set motor_pwm_protocol + set dshot_bidir

Motor output. The book's baseline is DSHOT300. Bidirectional DShot is allowed ONLY after exact ESC-firmware support and live RPM while turning with no more than 1% error on all four motors are proved. The selected AM32 Tekko32 and G45M targets are different; preserve per-ESC readback and do not flash to fit this example. A non-RPM route needs its own accepted filter setup.

set motor_pwm_protocol = DSHOT300
set dshot_bidir = OFF

Verified RPM path only — set dshot_bidir = ON

set failsafe_procedure

Stage 2 action. The firmware 2025.12.5 literal CLI values are DROP, AUTO-LAND and GPS-RESCUE. Selected no-GPS beginner builds stay on DROP. Adding GPS does not authorize GPS-RESCUE; its equipment-specific setup and validation remain separately pending. AUTO-LAND is outside this route.

set failsafe_procedure = DROP

set blackbox_device

Inspect with get blackbox first. Kakute H7 V1.5 uses SDCARD and a separate compatible microSDHC card; GOKU Mini V2 uses onboard SPIFLASH. Select only the actual board's detected supported device, never both alternatives. Firmware 2025.12.5 accepts sampling fractions 1/1, 1/2, 1/4, 1/8 and 1/16; its default is 1/4. These example settings are not an installed readback or a complete logging/flight qualification.

get blackbox_device
set blackbox_mode = NORMAL
set blackbox_sample_rate = 1/4

At an actual 4 kHz PID loop, 1/4 schedules 1 kHz nominal main-frame sampling; verify the saved log header, fields and timing. Preserve existing logs before erasing flash or formatting a card. A screenshot or used-space counter is not proof of a usable log; export and open the raw recording in the recorded Explorer version. MOTOR_TEST is a separate, temporary test mode.

  • Save complete raw exports before changes; keep annotations separate. Received, accepted and rejected states are different records.
  • Restore only an exact compatible, last-accepted state; check errors and persisted readback, then repeat affected physical checks.
  • save writes FC configuration and reboots. Some commands act immediately; exit is not a universal undo.
  • For battery changes, inspect one assignment response and its current-value query before the next. Compare the full intended state before a separately entered save, then reconnect and verify persistence. Plain exit cannot undo an earlier saved warning test; restore the adopted baseline, not received or temporary settings.
  • A board replacement is a new configuration: neither diff nor dump is a portable motor/resource map.

What failsafe actually does

  1. Signal validation

    Observe the actual receiver and FC loss behavior; do not equate an OSD flag or a nominal threshold with motor-stop latency.

  2. Stage 1

    Inspect the saved fallback values and delay. Normal firmware 2025.12.5 defaults to 1.5 s, not a guaranteed end-to-end interval. Low throttle is not disarm.

  3. Stage 2

    One of three procedures, set with `set failsafe_procedure`.

    • DROPBeginner route; disarms when reached, but the falling aircraft remains hazardous
    • AUTO-LANDSeparate fixed-throttle landing procedure, not DROP or controlled hover; outside the beginner test route
    • GPS-RESCUESeparate GPS-equipped route, not authorized merely by fitting GPS; qualification remains pending. Selected no-GPS builds stay on DROP.

Complete Chapter 11's two-session, props-off normal-radio owner before any first flight and repeat affected checks after change/repair. Its startup stays disarmed until FC On time is at least 00:06 and advancing; throttle remains low. Record actual FC states/all-four idle and stop, observed RF-loss sequence and recovery with ARM already off, not an ARM-high interlock or in-flight proof. Preserve its stated observation ceilings, recorder-safe ordinary finish or emergency abort and radio restart/readback. This summary and a quick session card do not replace the complete preparation and method.

Plan and verify the OSD

Core layout — verify the actual display

  • Battery voltageVerify source and cell count; qualify warnings separately in Power & Battery. Average-cell voltage is not individual-cell monitoring.
  • Flight timerRecord the selected source. On-time, total armed time and last-armed time differ; none automatically proves airtime or battery reserve.
  • Link qualityELRS 4.1.0, 2.4 GHz LoRa 250 Hz: percentage of recent receive periods with a valid uplink packet, including sync/data rather than only RC commands. Repetition modes can account differently. High LQ proves neither FC control delivery nor signal margin. The ELRS prefix is a version-specific RF mode ID, not Hz.
  • RSSI dBmReceived signal power. Compare with the exact mode's sensitivity limit; their difference is margin in dB, not LQ percent. No universal flight threshold.
  • Warnings bannerEnable applicable warnings and verify actual visibility; a placed preview is not proof of delivery.
  • Flight modeA prioritized FC-state label, not simple AUX readback or arming proof; AIR can appear instead of ACRO.

Only for a separately qualified GPS-equipped route

  • Home arrowDirection back to home
  • Distance to homeIn metres
  • Satellite countRecord fix/home status as well; a minimum satellite count alone does not qualify GPS Rescue.

This is a flight-layout starting point, not a tested display. Match the exact video hardware/firmware and supported character layout; retain any dimensions actually exposed by a supported interface. Chapter 11's Build Two protected video preparation owns the selected camera/changing-FC-data and cold-readback sequence; debug-only canvas CLI absence does not block that route. Verify needed labels, units and FC warnings on the actual output under the appropriate procedure. Retain necessary native alerts, and do not induce a hazardous state for an illustration. The separate Build Two first outdoor lift, hover and landing lesson owns the direct-view pilot/display-reader flight arrangement, current-startup pack/average/ count consistency and actual ANGL/warning/link/native-video observations. This bench reference is not another flight checklist or a requirement for prior flight.