pw_grpc

pw_rpc over gRPC

Unstable C++17 C++20

pw_grpc is an implementation of the gRPC over HTTP2 protocol that utilizes pw_rpc for code generation and service hosting. It provides classes that map between pw_rpc packets and gRPC HTTP2 frames, allowing pw_rpc services to be exposed as gRPC services.

Overview

The Connection class implements the gRPC HTTP2 protocol on top of a socket like stream. Create a new instance every time a new connection is established. It will notify when new RPC calls are started, data is received, the call is cancelled, and when the connection stream should be closed.

The PwRpcHandler class is what maps gRPC events provided by Connection instances to pw_rpc packets. It takes a pw::rpc::RpcPacketProcessor to forward packets to.

The GrpcChannelOutput class is what handles mapping outgoing pw_rpc packets back to the Connection send methods, which will translate to gRPC responses.

Refer to the test_pw_rpc_server.cc file for detailed usage example of how to integrate into a pw_rpc network.