Skip to content

DummyDroneAdapter

Overview

The DummyDroneAdapter is a minimal implementation of the DroneAdapter abstract base class.

It is used as:

  • a testing stub
  • a development mock
  • a demonstration of dynamic adapter switching

It performs no real drone operations. All methods only log actions or return fixed values.

Purpose

This adapter exists to:

  • validate control flow without a simulator
  • test command routing logic
  • simulate a connected drone interface
  • support development when AirSim or Project AirSim is unavailable

DummyDroneAdapter Class

Class Definition

Implements:

  • DroneAdapter (abstract base class)

State

Internal variables

  • _connected: bool
  • tracks whether the adapter is logically connected

Connection Lifecycle

connect() -> bool

Attempts to mark the adapter as connected.

Behavior:

  • If already connected:
  • logs message

  • returns False

  • If not connected:

  • sets _connected = True
  • logs successful connection
  • returns True

disconnect() -> None

Marks the adapter as disconnected.

Behavior:

  • If already disconnected:

  • logs message and exits

  • If connected:

  • sets _connected = False
  • logs disconnection

Flight Commands

takeoff() -> None

Simulates drone takeoff.

Behavior:

  • logs: "DummyDroneAdapter took off"
  • no state change

land() -> None

Simulates landing operation.

Behavior:

  • requires connection via _assert_connected()
  • logs landing event

move(direction: CommandType, **kwargs) -> None

Simulates directional movement or rotation.

Parameters:

  • direction: CommandType
  • kwargs: optional movement parameters (ignored)

Behavior:

  • requires connection via _assert_connected()
  • logs movement command with direction name

hover() -> None

Not implemented.

Currently a no-op placeholder.

emergency_stop() -> None

Not implemented.

Currently a no-op placeholder.

Telemetry

get_telemetry() -> TelemetryData

Returns a fixed dummy telemetry snapshot.

Returned values

  • altitude_m: 1
  • speed_ms: 2
  • battery_pct: 300.0 (intentionally invalid for testing edge cases)
  • heading_deg: 0
  • is_flying: True
  • source: "dummy"

Connection Guard

_assert_connected()

Ensures the adapter is connected before executing commands.

Raises:

RuntimeError if:

  • _connected is False

Message:

  • "DummyDroneAdapter is not connected. Await connect() before issuing commands."

Notes

  • This adapter does not interact with any external system
  • It is safe to use in unit tests and CI pipelines
  • hover() and emergency_stop() are intentionally unimplemented placeholders