also looking at this
fix: resolve source links through native drone docs
#40
56 files
+179
-159
| @@ -71,60 +71,60 @@ It uses the oldest heartbeat/position/battery receipt time for freshness. Physic | ||
| 71 | 71 | reports position health false and never transmits. SITL assumes the simulator's position estimator |
| 72 | 72 | is healthy; that assumption must never be carried into a physical adapter. |
| 73 | 73 | |
| 74 | The wire codec is an experimental subset. [Shared acknowledged microservices](https://github.com/stacksjs/drone/blob/main/docs/driver-protocols.md) add bounded command, parameter and waypoint transfers; serial/TCP and complete firmware coverage remain open. | |
| 75 | Both external stacks are optional drivers. The [owned-stack ADR](https://github.com/stacksjs/drone/blob/main/docs/adr/0001-owned-autonomy.md) and | |
| 76 | [feature roadmap](https://github.com/stacksjs/drone/blob/main/docs/roadmap/README.md) define the replacement path. A future physical adapter needs verified estimator status, source identity, sequence/replay handling, | |
| 74 | The wire codec is an experimental subset. [Shared acknowledged microservices](driver-protocols.md) add bounded command, parameter and waypoint transfers; serial/TCP and complete firmware coverage remain open. | |
| 75 | Both external stacks are optional drivers. The [owned-stack ADR](adr/0001-owned-autonomy.md) and | |
| 76 | [feature roadmap](roadmap/README.md) define the replacement path. A future physical adapter needs verified estimator status, source identity, sequence/replay handling, | |
| 77 | 77 | authenticated transport, link supervision, flight-controller configuration and hardware validation. |
| 78 | 78 | |
| 79 | 79 | ## Native runtime bench slice |
| 80 | 80 | |
| 81 | 81 | The owned kernel and Pico 2 HAL live in `firmware/runtime/`, with the explicit C++17 exception in |
| 82 | [ADR 2](https://github.com/stacksjs/drone/blob/main/docs/adr/0002-bench-runtime.md). Stacks owns the [CLI and protocol tools](https://github.com/stacksjs/drone/blob/main/docs/runtime.md) under | |
| 82 | [ADR 2](adr/0002-bench-runtime.md). Stacks owns the [CLI and protocol tools](runtime.md) under | |
| 83 | 83 | `resources/functions/drone/runtime/`. The first profile is synthetic-sensor and neutral-output |
| 84 | 84 | only. It has no physical flight command path and does not replace estimation or vehicle controls. |
| 85 | 85 | |
| 86 | 86 | |
| 87 | The optional [sensor bench profile](https://github.com/stacksjs/drone/blob/main/docs/sensors.md), recorded in [ADR 3](https://github.com/stacksjs/drone/blob/main/docs/adr/0003-sensor-bench.md), | |
| 87 | The optional [sensor bench profile](sensors.md), recorded in [ADR 3](adr/0003-sensor-bench.md), | |
| 88 | 88 | adds original SPI/I2C/UART acquisition and a receive-only DS stream. TypeScript applies units, |
| 89 | 89 | calibration, clock uncertainty and independent health checks. The same pipeline runs against |
| 90 | 90 | recordings on the simulator clock. Replay snapshots are diagnostic; estimator fusion is issue #4. |
| 91 | 91 | |
| 92 | The [owned estimator](https://github.com/stacksjs/drone/blob/main/docs/estimation.md), recorded in [ADR 4](https://github.com/stacksjs/drone/blob/main/docs/adr/0004-owned-estimator.md), consumes | |
| 92 | The [owned estimator](estimation.md), recorded in [ADR 4](adr/0004-owned-estimator.md), consumes | |
| 93 | 93 | qualified sensor events on their capture epochs. It exposes tilt/relative-yaw, GNSS local NED and |
| 94 | 94 | separate pressure height with health/reset counters. It is independent of both external autopilots |
| 95 | 95 | and remains separate from control telemetry until heading, fusion and hardware validation exist. |
| 96 | 96 | |
| 97 | The [owned control physics harness](https://github.com/stacksjs/drone/blob/main/docs/controls.md), recorded in [ADR 5](https://github.com/stacksjs/drone/blob/main/docs/adr/0005-simulated-multirotor-controls.md), | |
| 97 | The [owned control physics harness](controls.md), recorded in [ADR 5](adr/0005-simulated-multirotor-controls.md), | |
| 98 | 98 | feeds modeled raw sensor records through the existing sensor pipeline and estimator into bounded |
| 99 | 99 | quad-X control. It declares initial simulation heading alignment and has no physical transport. |
| 100 | 100 | Plant truth is retained only for sensor synthesis and independent response evaluation. |
| 101 | 101 | |
| 102 | The [owned authority supervisor](https://github.com/stacksjs/drone/blob/main/docs/authority.md), recorded in [ADR 6](https://github.com/stacksjs/drone/blob/main/docs/adr/0006-simulated-authority.md), | |
| 102 | The [owned authority supervisor](authority.md), recorded in [ADR 6](adr/0006-simulated-authority.md), | |
| 103 | 103 | adds explicit arm/engage, fault revocation and a separate modeled output watchdog above that same |
| 104 | 104 | control path. A host-loss run stops all host execution while the modeled board clock continues. |
| 105 | 105 | Physical firmware and external adapters remain separate from these simulation-only frames. |
| 106 | 106 | |
| 107 | [ADR 7](https://github.com/stacksjs/drone/blob/main/docs/adr/0007-driver-transactions.md) records shared external-driver transactions and the strict | |
| 107 | [ADR 7](adr/0007-driver-transactions.md) records shared external-driver transactions and the strict | |
| 108 | 108 | separation between scripted UDP conformance, firmware SITL and physical evidence. |
| 109 | 109 | |
| 110 | [ADR 8](https://github.com/stacksjs/drone/blob/main/docs/adr/0008-camera-payload-adapters.md) adds owned camera acquisition with bounded local IPC, | |
| 110 | [ADR 8](adr/0008-camera-payload-adapters.md) adds owned camera acquisition with bounded local IPC, | |
| 111 | 111 | per-command clock synchronization, no automatic shutter retry and capture-epoch pose association. |
| 112 | Native Stacks [payload commands](https://github.com/stacksjs/drone/blob/main/docs/payloads.md) expose replay and explicit Pi acquisition. Bus | |
| 112 | Native Stacks [payload commands](payloads.md) expose replay and explicit Pi acquisition. Bus | |
| 113 | 113 | contracts remain configuration only; payloads cannot bypass the flight authority supervisor. |
| 114 | 114 | |
| 115 | [ADR 9](https://github.com/stacksjs/drone/blob/main/docs/adr/0009-runtime-diagnostics.md) records bounded runtime-only journals with typed events, | |
| 115 | [ADR 9](adr/0009-runtime-diagnostics.md) records bounded runtime-only journals with typed events, | |
| 116 | 116 | provenance digests, loss accounting and crash-prefix recovery. Native Stacks commands and a local |
| 117 | [stx viewer](https://github.com/stacksjs/drone/blob/main/docs/diagnostics.md) share the pure verifier/replay projection. No replay path has a | |
| 117 | [stx viewer](diagnostics.md) share the pure verifier/replay projection. No replay path has a | |
| 118 | 118 | vehicle transport, update/flash capability or runtime authority. |
| 119 | 119 | |
| 120 | [ADR 10](https://github.com/stacksjs/drone/blob/main/docs/adr/0010-owned-missions.md) adds a versioned [owned mission engine](https://github.com/stacksjs/drone/blob/main/docs/missions.md) over | |
| 120 | [ADR 10](adr/0010-owned-missions.md) adds a versioned [owned mission engine](missions.md) over | |
| 121 | 121 | the estimator/control/authority physics pipeline. Validated graphs emit position targets, never |
| 122 | 122 | arm themselves, and recover recorded prefixes into a supervised paused state. Task events and |
| 123 | 123 | local-position traces stay separate from physical payload IO and runtime-only diagnostic journals. |
| 124 | 124 | |
| 125 | 125 | ## Shared owned vehicle execution |
| 126 | 126 | |
| 127 | The [vehicle runtime](https://github.com/stacksjs/drone/blob/main/docs/vehicles.md) extends owned raw sensor and estimator execution to aerodynamic | |
| 127 | The [vehicle runtime](vehicles.md) extends owned raw sensor and estimator execution to aerodynamic | |
| 128 | 128 | fixed-wing, differential ground and planar surface profiles. Explicit v2 missions share graph budgets, |
| 129 | 129 | replay, payload scope and authority lifecycle while each model owns its control and actuator units. |
| 130 | 130 | Fresh sessions isolate state. The common stx workspace inspects recorded estimated routes and |