autoware_agnocast_wrapper

The purpose of this package is to integrate Agnocast, a zero-copy middleware, into each topic in Autoware with minimal side effects. Agnocast is a library designed to work alongside ROS 2, enabling true zero-copy publish/subscribe communication for all ROS 2 message types, including unsized message types.

• Agnocast Repository: https://github.com/autowarefoundation/agnocast
• Agnocast Documentation: https://autowarefoundation.github.io/agnocast_doc/main/
• Discussion on Agnocast Integration into Autoware: https://github.com/orgs/autowarefoundation/discussions/5835
• Review Guide for Agnocast Wrapper PRs

This package provides macros that wrap functions for publish/subscribe operations and smart pointer types for handling ROS 2 messages. When Autoware is built using the default build command, Agnocast is not enabled. However, setting the environment variable ENABLE_AGNOCAST=1 enables Agnocast and results in a build that includes its integration. This design ensures backward compatibility for users who are unaware of Agnocast, minimizing disruption.

Two Integration Approaches

This package provides two approaches for integrating Agnocast. Both will coexist for the foreseeable future.

1. Node Wrapper (agnocast_wrapper::Node)

Use this when you want the entire node to transparently switch between rclcpp::Node and agnocast::Node at runtime. The node wrapper automatically selects the correct underlying implementation based on the ENABLE_AGNOCAST environment variable.

agnocast_wrapper::Node does not publicly derive from rclcpp::Node. It exposes a curated subset of the rclcpp::Node surface and forwards each member to the underlying implementation (rclcpp::Node or agnocast::Node). The member names and argument lists are identical in both builds (ENABLE_AGNOCAST=0 and =1), so a node written against it compiles unchanged either way — provided you spell the handle, options and message types with the AUTOWARE_* macros (see Type spellings). If you need an API that is not listed below, extend the wrapper, or reach the underlying node via get_rclcpp_node() (declared in both builds, but it throws when the node is in Agnocast mode — see the build-modes table).

Supported API surface

The following members / free functions are provided. Unless noted, signatures mirror their rclcpp::Node counterparts.

OnSetParametersCallbackType is aliased in this namespace and resolves to the correct rclcpp type for both Humble (rclcpp 16.x) and Jazzy (rclcpp 28+).

Polling subscribers are not a Node member. Use the free function polling::create_polling_subscriber<MessageT>(node, topic, qos) — see Polling Subscriber.

Type spellings

The member names and argument lists above are the same in both builds, but the handle, options and message types they use are not the same C++ types. Always spell them with the AUTOWARE_* macros so the same source compiles in both builds:

AUTOWARE_CLIENT_PTR(S) / AUTOWARE_SERVICE_PTR(S) and the AUTOWARE_CLIENT_*FUTURE* macros resolve to the wrapper’s own Client<S> / Service<S> types in both builds, so client and service code needs no per-build spelling. See Key Macros for the full macro list.

Build modes: agnocast-disabled vs agnocast-enabled

Which of the two Node class definitions is compiled is a build-time choice, selected by the USE_AGNOCAST_ENABLED preprocessor macro. The API surface above is identical in both, so this choice only affects the backend and the underlying-node accessors below.

This is a separate axis from the runtime backend selection: in the agnocast-enabled build, each node instance additionally picks rclcpp::Node vs agnocast::Node at construction from the ENABLE_AGNOCAST environment variable read at runtime (use_agnocast()), fixed for the node’s lifetime. The runtime value selects the backend; it does not change which Node definition was compiled or which methods are declared — e.g. get_agnocast_node() is declared in every agnocast-enabled build and instead throws at runtime when the node is not in Agnocast mode.

In both builds agnocast_wrapper::Node does not derive from rclcpp::Node, so hand it to an executor or utility via get_node_base_interface() (e.g. executor.add_node(node->get_node_base_interface())).

```cpp #include <autoware/agnocast_wrapper/node.hpp>

File truncated at 100 lines see the full file

Changelog for package autoware_agnocast_wrapper

1.9.0 (2026-06-24)

• Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base

• refactor(autoware_agnocast_wrapper): split service ptr macros into server/client variants (#1205)

  * refactor(autoware_agnocast_wrapper): split service ptr macros into server/client variants

  • Apply feedback review

  * Remove const from is_shared_ptr_service_callback_v ---------

• feat(autoware_agnocast_wrapper): add overload for service (#1203)

  • add create_service overload
  • add assert

  * fix copilot review ---------

• feat(autoware_agnocast_wrapper): add service and client support (#1074)

  • Add service and client support to agnocast wrapper
  • Mark service and client support as experimental in README
  • Add missing macros
  • Fix colcon flag typo in README
  • fix
  • style(pre-commit): autofix
  • fix
  • style(pre-commit): autofix
  • Add a comment
  • Adjust create_service/create_client calls depending on rclcpp version
  • fix cpplint errors
  • style(pre-commit): autofix
  • Fix type deduction in create_client and create_service
  • Add functional header
  • Fix cpplint errors
  • Remove experimental tag
  • Add RCLCPP version check for client and service macros

  * Propagate exception in client async callbacks ---------Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com> Co-authored-by: Koichi Imai <<koichi.imai.2@tier4.jp>> Co-authored-by: Koichi Imai <<45482193+Koichi98@users.noreply.github.com>>

• feat(autoware_agnocast_wrapper): support more args for synchronizer (#1104) support 8 args

• feat(autoware_agnocast_wrapper): adopt glog to agnocast main templete (#1180) feat(autoware_agnocast_wrapper): use glog (#88)

  • feat: use glog
  • fix: tag name
  • feat: link glog
  • fix

  * fix: add ament auto library ---------

• fix(autoware_agnocast_wrapper): get_name,namespace,get_fully_qualified_name (#1178) fix get_name,namespace,get_fully_qualified_name

• feat(autoware_agnocast_wrapper): spawn agnocast_discovery_agent from launch wrapper (#1084) Spawn exactly one agnocast_discovery_agent per ros2 launch tree from agnocast_env.launch.{py,xml} when ENABLE_AGNOCAST=1, deduplicated tree-wide via the LaunchContext globals and pinned to namespace="/".

• feat(autoware_agnocast_wrapper): add ON_NODE macros (#1170)

• feat(autoware_agnocast_wrapper): update [agnocast_env.launch]{.title-ref} to enable override [use_agnocast]{.title-ref} (#1123)

  • update agnocast_env.launch to override use_agnocast
  • style(pre-commit): autofix

  * more description in README ---------Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

File truncated at 100 lines see the full file