Skip to content
nflyernz edited this page Oct 19, 2026 · 2 revisions

Events

Purpose: Present a chronological timeline of supported recorded events inside every detected flight window in one ArduPlane DataFlash BIN.

← Wiki Home

What you need

  • One ArduPlane DataFlash .bin or .BIN log.
  • At least one detected flight window for a flight timeline.
  • Supported MSG, MODE or LAND records if you expect timeline entries.
  • The APT desktop GUI. See the README installation instructions if needed.

Run Event Timeline

  1. Click Choose BIN… beside Source BIN:.
  2. Select the aircraft BIN.
  3. Open Events from Overview or select the Events tab.
  4. Click Analyse.
  5. Review each detected flight timeline in the report panel.
  6. Click Docs for the in-app description and glossary.

The GUI processes every detected flight in order. The terminal workflow instead lets you select one flight when a BIN contains several.

Read the report

Each flight remains a separate section. Its header shows:

  • Flight number.
  • Source-log filename.
  • Detected flight-window start and end times.
  • Number of supported events retained in that window.

Times are log-relative values derived from DataFlash TimeUS, not local clock times.

Supported timeline entries

The current timeline merges three sources:

  • MSG — firmware text recorded in the DataFlash log.
  • MODE — each logged flight-mode record, displayed with its known mode name.
  • LAND_STAGE — changes in the landing-controller stage, including retained flare-height (fh) and slope diagnostic values.

LAND telemetry is continuous, so APT emits an event only when the stage changes. It does not repeat every unchanged sample.

Time ordering

Events from the three sources are merged and sorted chronologically. When records share a timestamp, the extractor preserves a deterministic retained order. This makes the timeline useful for examining the sequence around mode changes, firmware messages and landing-stage transitions.

Events timeline with MSG, MODE and LAND stage records in time order

The single flight timeline merges firmware messages, mode records and changed landing stages by log-relative time while preserving each event's source detail.

Empty results

  • No flights found means the selected BIN contained no detected flight windows.
  • No events found means that flight window contained no supported MSG, MODE or changed LAND stage records.

Neither message proves that nothing happened onboard. Logging configuration, message availability and the current extractor's supported sources determine what appears.

Limitations

Events is a focused recorded-event timeline, not a reconstruction of every vehicle state or physical event. It currently does not include every DataFlash message type, unchanged controller samples or inferred unlogged events.

A firmware message or mode record reports logged state. It does not necessarily prove the aircraft's physical response. Missing events remain absent rather than being inferred.

Related information

Clone this wiki locally