No version for distro humble showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

No version for distro kilted showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

No version for distro lyrical showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

No version for distro rolling showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

No version for distro github showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

No version for distro galactic showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

No version for distro iron showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

No version for distro melodic showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange

No version for distro noetic showing jazzy. Known supported distros are highlighted in the buttons above.
Package symbol

cl_px4_mr package from SMACC2 repo

smacc2 cl_foundation_pose cl_gcalcli cl_generic_sensor cl_http cl_keyboard cl_lifecycle_node cl_mission_tracker cl_modbus_tcp_relay cl_moveit2z cl_nav2z backward_global_planner backward_local_planner forward_global_planner forward_local_planner nav2z_planners_common pure_spinning_local_planner undo_path_global_planner cl_px4_mr cl_ros2_timer eg_conditional_generator eg_random_generator smacc2_msgs sm_atomic_performance_trace_1 sm_atomic_subscribers_performance_test sm_coretest_action_client_1 sm_coretest_callback_rate_1 sm_coretest_exceptions_1 sm_coretest_features_1 sm_coretest_forced_finish_1 sm_coretest_idle_load_1 sm_coretest_object_churn_1 sm_coretest_poll_shutdown_1 sm_coretest_post_during_exit_1 sm_coretest_reactor_order_1 sm_coretest_signal_key_1 sm_coretest_timer_handoff_1 sm_coretest_transition_speed_1 sm_advanced_recovery_1 sm_atomic sm_atomic_http sm_atomic_lifecycle sm_atomic_mode_states sm_branching sm_cl_gcalcli_test_1 sm_cl_keyboard_unit_test_1 sm_cl_px4_mr_test_1 sm_cl_px4_mr_test_2 sm_cl_px4_mr_test_3 sm_cl_px4_mr_test_4 sm_cl_px4_mr_test_5 sm_cl_ros2_timer_unit_test_1 sm_data_sharing_1 sm_data_sharing_2 sm_modbus_tcp_relay_test_1 sm_mode_state_behavior_1 sm_multi_stage_1 sm_multithread_test_1 sm_nav2_gazebo_test_1 sm_nav2_gazebo_test_2 sm_nav2_gazebo_test_3 sm_pack_ml sm_panda_cl_moveit2z_cb_inventory sm_panda_cl_moveit2z_cb_inventory_isaacsim sm_retry_logic_1 sm_simple_action_client sm_three_some sr_all_events_go sr_conditional sr_event_countdown

ROS Distro
jazzy

Package Summary

Version 3.1.0
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Description
Checkout URI https://github.com/robosoft-ai/SMACC2.git
VCS Type git
VCS Version jazzy
Last Updated 2026-11-15
Dev Status DEVELOPED
Released RELEASED
Contributing Help Wanted (-)
Good First Issues (-)
Pull Requests to Review (-)

Package Description

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS

Maintainers

  • Brett Aldrich

Authors

No additional authors.

PX4 Multirotor Client (cl_px4_mr)

SMACC2 client library for PX4 multirotor control via ROS 2 XRCE-DDS.

Architecture

The cl_px4_mr follows a pure component-based architecture where the client orchestrates seven specialized components:

ClPx4Mr (Client - Orchestrator)
├── CpVehicleCommand        - Sends vehicle commands (arm, disarm, mode, land, takeoff)
├── CpVehicleStatus         - Monitors arming state, landing, and nav mode
├── CpVehicleLocalPosition  - Tracks vehicle position in NED frame
├── CpTrajectorySetpoint    - Publishes position setpoints for offboard control
├── CpOffboardKeepAlive     - Maintains offboard mode via periodic heartbeat
├── CpVehicleCommandAck     - Monitors command acknowledgement responses
└── CpGoalChecker           - Detects when vehicle reaches target position

Components

CpVehicleCommand

Responsibility: Sends PX4 vehicle commands via /fmu/in/vehicle_command

  • arm() / forceArm() / disarm() - Vehicle arming control
  • setOffboardMode() - Switch to offboard control mode
  • takeoff(altitude) / land() - Flight commands
  • sendCommand(...) - Generic 7-parameter command interface

Signals: None

CpVehicleStatus

Responsibility: Monitors vehicle state from /fmu/out/vehicle_status_v1

  • Tracks arming state and navigation mode transitions
  • Detects armed/disarmed and landed state changes

Signals: onArmed_, onDisarmed_, onModeChanged_, onLanded_

CpVehicleLocalPosition

Responsibility: Tracks position from /fmu/out/vehicle_local_position

  • Provides NED position (x, y, z) and heading
  • Thread-safe accessors with validity checking

Signals: onPositionReceived_

CpTrajectorySetpoint

Responsibility: Publishes position commands to /fmu/in/trajectory_setpoint

  • setPositionNED(x, y, z, yaw) - Set target position
  • hold() - Hold current position
  • republishLast() - Re-send last setpoint
  • Thread-safe with cached last setpoint

Signals: None

CpOffboardKeepAlive

Responsibility: Publishes offboard control mode heartbeat to /fmu/in/offboard_control_mode

  • Inherits from ISmaccUpdatable for periodic ~20Hz updates
  • enable() / disable() - Toggle heartbeat publishing
  • PX4 requires continuous offboard heartbeat to stay in offboard mode

Signals: None

CpVehicleCommandAck

Responsibility: Monitors command responses from /fmu/out/vehicle_command_ack

  • Tracks last command ID and result code

Signals: onAckReceived_

CpGoalChecker

Responsibility: Monitors position and fires when goal is reached

  • Inherits from ISmaccUpdatable for periodic distance checking
  • setGoal(x, y, z, xy_tolerance, z_tolerance) - Set target with tolerances
  • clearGoal() - Deactivate goal checking
  • Default tolerances: 0.5m XY, 0.3m Z

Signals: onGoalReached_

CpTfBroadcaster (opt-in)

Responsibility: Publishes PX4’s state estimate as a ROS TF tree so sensors on the airframe can be placed in RViz: map -> base_link (translation from CpVehicleLocalPosition, rotation from /fmu/out/vehicle_attitude, converted NED/FRD -> ENU/FLU), a translation-only map -> base_link_follow (an RViz orbit target that does not spin with yaw) and a static base_link -> lidar_link from TfBroadcasterParams. Not created by ClPx4Mr; an orthogonal adds it with createClient<ClPx4Mr>()->createComponent<CpTfBroadcaster>(params). map is the FMU’s local NED origin expressed ENU (x east, y north, z up).

Signals: None

CpForwardObstacleGuard

Responsibility: Watches a sensor_msgs/PointCloud2 (from a CpTopicSubscriber<PointCloud2> on the same client, e.g. cl_generic_sensor::ClGenericSensor<PointCloud2>) for returns inside a forward cone about the sensor +x axis and raises / clears an obstacle flag with hysteresis (ForwardObstacleGuardParams: half angle, trigger / clear ranges, hit count, cloud debounce).

File truncated at 100 lines see the full file

CHANGELOG
No CHANGELOG found.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged cl_px4_mr at Robotics Stack Exchange