Antenna Deployer

[ineskhou]

Summary

This pull request introduces a new AntennaDeployer component to the system, enabling automated antenna deployment with burnwire activation and distance sensor feedback. The implementation includes the component code, interface definition, documentation, build integration, and system wiring. The most important changes are grouped below:

Component Implementation & Interface

• Added new files: AntennaDeployer.cpp, AntennaDeployer.hpp, and AntennaDeployer.fpp, implementing the deployment logic, command handlers, state machine, distance validation, and F Prime interface for the antenna deployment process. [1] [2] [3]

System Integration

• Registered the AntennaDeployer as part of the build by updating Components/CMakeLists.txt and adding its own CMake configuration. [1] [2]
• Added a new instance of AntennaDeployer to the deployment topology and instance files, and connected its ports to the rate group and burnwire component. [1] [2] [3] [4]

Telemetry & Monitoring

• Defined a new telemetry packet for antenna deployment status, including DeployCount and LastDistance channels.

Documentation

• Added a new system design document (docs/sdd.md) detailing requirements, usage, states, commands, events, telemetry, and parameters for the AntennaDeployer component.

Minor Updates

• Minor formatting and whitespace changes in instances.fpp.

This Summary was written by Copilot AI

[ineskhou]

@yudataguy I did the merge so it should be up to date with main! Right now there is an sdd you probably want to review adn start on the fpp. lmk if you have any questions

[yudataguy]

@ineskhou can i bump the MAX_PACKETIZER_PACKETS to 8? Since it was set to 6, and with antenna packet, it exceeds the limit

[ineskhou]

@yudataguy Yes, increasing the packet size to 8 is perfect, you'll be changing things in the config all the time!

[ineskhou]

works great on Hardware!

[Copilot]

Pull Request Overview

This PR adds an Antenna Deployer component that automates antenna deployment via a burnwire mechanism. The deployer manages the deployment lifecycle through a state machine, monitors distance sensor feedback to confirm deployment, and supports retry logic with configurable timing parameters.

• Introduces AntennaDeployer component with commands, telemetry, events, and timing parameters
• Integrates the new component into the ReferenceDeployment topology
• Adds integration tests with reduced timing constants for faster test execution

Reviewed Changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
FprimeZephyrReference/test/int/burnwire_test.py	Increased timeout for burnwire state assertion from 10 to 15 seconds
FprimeZephyrReference/test/int/antenna_deployer_test.py	New integration test suite verifying deployment without distance sensor feedback
FprimeZephyrReference/project/config/TlmPacketizerCfg.hpp	Increased max packetizer packets from 7 to 8 to accommodate new telemetry
FprimeZephyrReference/ReferenceDeployment/Top/topology.fpp	Added antennaDeployer instance to topology with connections to rate group and burnwire
FprimeZephyrReference/ReferenceDeployment/Top/instances.fpp	Declared antennaDeployer instance with base ID 0x10029000
FprimeZephyrReference/ReferenceDeployment/Top/ReferenceDeploymentPackets.fppi	Added Antenna packet definition with deployment telemetry
FprimeZephyrReference/Components/CMakeLists.txt	Added AntennaDeployer subdirectory to build system
FprimeZephyrReference/Components/AntennaDeployer/docs/sdd.md	Added software design document with requirements, usage, and API documentation
FprimeZephyrReference/Components/AntennaDeployer/CMakeLists.txt	CMake configuration for AntennaDeployer component library
FprimeZephyrReference/Components/AntennaDeployer/AntennaDeployer.hpp	Header file defining component class with state machine and helper methods
FprimeZephyrReference/Components/AntennaDeployer/AntennaDeployer.fpp	FPP specification defining commands, events, telemetry, ports, and parameters
FprimeZephyrReference/Components/AntennaDeployer/AntennaDeployer.cpp	Implementation of deployment state machine and command handlers

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[ineskhou]

Added some tests and sdd updates! sorry for al the pushed the local tests dont work on my computer

[Mikefly123]

Hey @ineskhou just a small tweak, I think we should change the naming of the DeployCount telemetry to be more clear.

I can stick copilot on making this change if that is alright with you.

[Mikefly123]

I think we should tweak the name for this to make it more clear what this piece of telemetry is:

Suggested change

	telemetry DeployCount: U32
	telemetry DeployAttemptCount: U32

[ineskhou]

sounds like a plan!

[Mikefly123]

@copilot can you address the change requested in this review? Modify all of the DeployCount names to be DeployAttemptCount instead!

[Mikefly123]

LGTM! Thanks for the hard work on this @ineskhou and @yudataguy