Repository navigation
Firmware twins fly the official PX4 and ArduPilot firmware against Relay's
physics with a real aircraft's version and parameters, PX4 flight controllers
on USB run hardware in the loop, and the simulator gains frames, acro mode and
crashes that tumble.
Added
- Firmware twins (SITL). The desktop build of the official firmware, the
same version as the real aircraft and loaded with its parameters, runs as a
child process of Relay in lockstep with Relay's physics. To the rest of Relay
it is a simulator: claims, sticks, skills, plans, timelines, programs, the
stage and the arena work unchanged, with the firmware's own control loop,
arming checks and failsafes. The firmware only talks to Relay on loopback.- The pack's firmware on screen: Settings → Autopilot packs, an Add
simulator dialog with the fast simulator or a firmware twin, a firmware
block in the inspector (identity, Generate twin profile, Start twin) and a
twin inspector with the process, lockstep and parameter details. - Relay identifies a real aircraft's firmware (family, version, git hash,
board) and ranks the installed packs: exact, version, series, nearest. - Twin profiles capture an aircraft's whole parameter table; calibration,
device ids, serial ports and other hardware-specific parameters stay out,
each with its reason. - Frame presets
micro-120,small-250andlarge-450with adjustable
mass, wheelbase, propeller and battery; a twin hovers at the same throttle
as the real aircraft. - Without a real aircraft, a twin starts from any pack with its default
parameters and a baseline tuned to hover out of the box.
- The pack's firmware on screen: Settings → Autopilot packs, an Add
- Autopilot runtime packs ship with the installer: ArduCopter 4.7.2,
4.6.3, 4.5.7, 4.4.4 and 4.3.8, PX4 1.17.0, 1.16.2, 1.15.4 and 1.14.4 (PX4
not on Windows). 1.7 to 2.6 MB compressed per pack (Windows ArduCopter packs
about 4.4 MB with their Cygwin DLLs), 16 to 22 MB per installer.
Settings lists them and imports further packs. Format:
docs/autopilot-packs.md.- ArduPilot packs built from source bind SITL's RC input and the JSON
physics socket to 127.0.0.1 ("loopback": truein the manifest), so no
firmware socket listens on other interfaces. The linux-x64 ArduPilot packs
are now static builds from source; the official binary stays available as
a build option.
- ArduPilot packs built from source bind SITL's RC input and the JSON
- Hardware in the loop (PX4). Over a USB serial link Relay backs up the
flight controller's parameters, switches it to HITL, feeds it sensor data
from its physics while the firmware keeps the motors locked, and afterwards
restores and verifies every parameter. A step-by-step dialog in the
inspector shows each stage. ArduPilot removed HIL support; Relay explains
this and recommends a firmware twin.- Only
SYS_HITLandSYS_AUTOSTARTchange; the whole parameter table is
backed up first, and the restore reads every parameter back and compares
it with the backup (flight-time counters and the flight UUID excepted). - Starting needs the operator to type HITL, a disarmed aircraft and the
operator's possession. - If Relay quits during a session, the parameters are restored the next
time the board connects over USB, once it is disarmed. - The flow is tested against a scripted PX4 board on a pseudo-terminal; the
full flow on a real board is verified once the larger PX4 aircraft is
available.
- Only
- Serial link. Connect an aircraft over a USB serial port (the flight
controller's own USB socket or a USB-serial adapter) from the USB serial tab
of the Connect dialog; known flight-controller interfaces and USB-serial
adapters are marked and the baud rate is detected automatically. An
unplugged board goes delayed, lost and offline like a UDP aircraft and
reconnects when it comes back, also under a new device name. Needs pyserial
3.5, which ships with the backend. - Simulator physics.
- Rigid-body ground contact at the feet, propeller tips and top: a normal
landing stays upright, a crash bounces, rolls and comes to rest in its
final attitude. Reset restores it upright. - Acro mode in the fast simulator: the sticks set body rates with no
self-levelling or tilt limit, so it flips, rolls and flies inverted.
Timelines takemode: "acro". - Sensors with noise and bias for the twins and HITL: IMU, barometer,
magnetometer and GPS. - The stage interpolates attitude with quaternions, so flips and inverted
flight do not jump; twins and HITL aircraft carry an engine badge. - Reset simulator in the inspector, the fleet card menu, the command
palette and a prompt on the stage over a crashed simulator; holding
Circle on the gamepad also resets a crashed simulator. - Timelines arm with the throttle the mode needs: 0 on ArduPilot, 50 % on
PX4 in the hold modes.
- Rigid-body ground contact at the feet, propeller tips and top: a normal
- API:
GET /autopilots,POST /autopilots/import,DELETE /autopilots/{id},GET /vehicles/{id}/firmware,GET/POST /twins/profiles,GET/PUT/DELETE /twins/profiles/{pid},POST /sims
withengine,profile,pack,frameandhome,GET /sims/{id}/twin,
PUT /sims/{id}/frame,GET /serial/ports,POST /vehicleswithserial,
GET/POST /vehicles/{id}/hitl. Snapshot fieldstransport(udp,
serial,sim),serialandhitl. Eventstwin_started,twin_exited,
twin_start_failed,autopilot_pack_imported,hitl_started,
hitl_restored,hitl_failed. Errorspack_missing,pack_unsupported,
twin_start_failed,twin_limit,frame_unsupported,twin_unsupported,
profile_not_found,params_incomplete,hitl_unavailable,
hitl_restore_mismatch,serial_unavailable. - Copilot, MCP and SDK:
- Copilot and the flight MCP server:
relay_autopilots_list,
relay_firmware_identify,relay_twin_profiles_list,
relay_twin_profile_get,relay_twin_profile_capture,
relay_twin_start,relay_twin_statusandrelay_sim_frame, available
at both flight levels. The flight server now has 34 tools, 26 at the
sticks level. - Copilot and the app MCP server:
relay_hitl(status, start, stop; start
needsconfirm: "HITL"),relay_serial_ports, connecting over serial and
adding twins withengine: "sitl". The app server now has 67 tools. - Copilot asks the operator for every hardware-in-the-loop start and stop,
on any aircraft and also while Allow all is on; that approval card has
no Allow all button. - The SDK adds
autopilots(),firmware(),twin_profiles(),
twin_profile(),capture_twin_profile(),update_twin_profile(),
delete_twin_profile(),start_twin(),twin(),set_frame(),
serial_ports(),serial_ports_status(),connect()andhitl().
- Copilot and the flight MCP server:
Changed
- Resetting a firmware twin restarts its firmware with the same profile; as
before, a reset brings a crashed simulator back upright on the ground. The
Copilot and MCP reset tools say so.