# ni/grpc-labview architecture

> Architecture diagram of the GitHub repository ni/grpc-labview, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ni/grpc-labview
- Repository: https://github.com/ni/grpc-labview

## Overview

This repository provides C++ support for LabVIEW gRPC clients and servers, plus a .proto-based LabVIEW code generator. The principal workflow is to generate or adapt LabVIEW client/server code, exchange protobuf messages over gRPC, and translate those messages to and from LabVIEW data structures. Reflection and TLS are documented server capabilities; message conversion, metadata, and LabVIEW interop form the internal runtime layer. Several source files are unsampled, so the graph limits implementation links to relationships visible in excerpts or documented in the README.

Main entry points: [`src/grpc_server.cc`](https://github.com/ni/grpc-labview/blob/master/src/grpc_server.cc) (gRPC server), [`src/proto_parser.cc`](https://github.com/ni/grpc-labview/blob/master/src/proto_parser.cc) (Proto parser), [`src/grpc_client.cc`](https://github.com/ni/grpc-labview/blob/master/src/grpc_client.cc) (gRPC client), [`src/message_metadata.cc`](https://github.com/ni/grpc-labview/blob/master/src/message_metadata.cc) (Message metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_generation["Code generation"]
  node_generator["Proto parser<br/>[proto_parser.cc]"]
  node_generated["Generated LabVIEW code"]
end

subgraph group_rpc["gRPC runtime"]
  node_client["gRPC client<br/>[grpc_client.cc]"]
  node_server["gRPC server<br/>[grpc_server.cc]"]
  node_reflection_plugin["Reflection plugin"]
  node_reflection_service["Reflection service"]
end

subgraph group_conversion["Message conversion"]
  node_interop["LabVIEW interop<br/>[lv_interop.cc]"]
  node_metadata["Message metadata"]
  node_messages["Message conversion<br/>[lv_message.cc]"]
  node_efficient_messages["Efficient conversion"]
  node_message_values["Message values"]
  node_well_known["Well-known types"]
  node_cluster_copy["Cluster copying<br/>[cluster_copier.cc]"]
  node_any_support["Any support<br/>[any_support.cc]"]
  node_unpacked_fields["Unpacked fields<br/>[unpacked_fields.cc]"]
end

subgraph group_support["Runtime support"]
  node_feature_config["Feature toggles<br/>[feature_toggles.cc]"]
  node_path_support["Path support<br/>[path_support.cc]"]
  node_event_data["Event data<br/>[event_data.cc]"]
  node_grpc_interop["gRPC interop<br/>[grpc_interop.cc]"]
end

node_developer(("LabVIEW developer"))
node_proto[".proto definition"]
node_grpc_peer(("gRPC peer"))

node_developer -->|"defines schema"| node_proto
node_developer -->|"generates code"| node_generator
node_proto -->|"parses schema"| node_generator
node_generator -->|"generates VIs"| node_generated
node_developer -->|"adapts code"| node_generated
node_developer -->|"runs client"| node_client
node_developer -->|"runs server"| node_server
node_client -.->|"calls remotely"| node_grpc_peer
node_server -.->|"serves RPCs"| node_grpc_peer
node_server -->|"initializes reflection"| node_reflection_plugin
node_reflection_plugin -.->|"registers service"| node_reflection_service
node_metadata -->|"reads LabVIEW values"| node_interop
node_metadata -->|"checks type mappings"| node_well_known
node_developer -.->|"uses TLS"| node_client
node_developer -.->|"configures TLS"| node_server

click node_generator "https://github.com/ni/grpc-labview/blob/master/src/proto_parser.cc"
click node_client "https://github.com/ni/grpc-labview/blob/master/src/grpc_client.cc"
click node_server "https://github.com/ni/grpc-labview/blob/master/src/grpc_server.cc"
click node_reflection_plugin "https://github.com/ni/grpc-labview/blob/master/src/lv_proto_server_reflection_plugin.cc"
click node_reflection_service "https://github.com/ni/grpc-labview/blob/master/src/lv_proto_server_reflection_service.cc"
click node_interop "https://github.com/ni/grpc-labview/blob/master/src/lv_interop.cc"
click node_metadata "https://github.com/ni/grpc-labview/blob/master/src/message_metadata.cc"
click node_messages "https://github.com/ni/grpc-labview/blob/master/src/lv_message.cc"
click node_efficient_messages "https://github.com/ni/grpc-labview/blob/master/src/lv_message_efficient.cc"
click node_message_values "https://github.com/ni/grpc-labview/blob/master/src/lv_message_value.cc"
click node_well_known "https://github.com/ni/grpc-labview/blob/master/src/well_known_messages.cc"
click node_cluster_copy "https://github.com/ni/grpc-labview/blob/master/src/cluster_copier.cc"
click node_any_support "https://github.com/ni/grpc-labview/blob/master/src/any_support.cc"
click node_unpacked_fields "https://github.com/ni/grpc-labview/blob/master/src/unpacked_fields.cc"
click node_feature_config "https://github.com/ni/grpc-labview/blob/master/src/feature_toggles.cc"
click node_path_support "https://github.com/ni/grpc-labview/blob/master/src/path_support.cc"
click node_event_data "https://github.com/ni/grpc-labview/blob/master/src/event_data.cc"
click node_grpc_interop "https://github.com/ni/grpc-labview/blob/master/src/grpc_interop.cc"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_generator,node_generated,node_developer toneBlue
class node_client,node_server,node_reflection_plugin,node_reflection_service toneAmber
class node_interop,node_metadata,node_messages,node_efficient_messages,node_message_values,node_well_known,node_cluster_copy,node_any_support,node_unpacked_fields toneMint
class node_feature_config,node_path_support,node_event_data,node_grpc_interop toneRose
class node_proto,node_grpc_peer toneIndigo
```

## Components

### Code generation

- [Proto parser](https://github.com/ni/grpc-labview/blob/master/src/proto_parser.cc): `src/proto_parser.cc`
- **Generated LabVIEW code**

### gRPC runtime

- [gRPC client](https://github.com/ni/grpc-labview/blob/master/src/grpc_client.cc): `src/grpc_client.cc`
- [gRPC server](https://github.com/ni/grpc-labview/blob/master/src/grpc_server.cc): `src/grpc_server.cc`
- [Reflection plugin](https://github.com/ni/grpc-labview/blob/master/src/lv_proto_server_reflection_plugin.cc): `src/lv_proto_server_reflection_plugin.cc`
- [Reflection service](https://github.com/ni/grpc-labview/blob/master/src/lv_proto_server_reflection_service.cc): `src/lv_proto_server_reflection_service.cc`

### Message conversion

- [LabVIEW interop](https://github.com/ni/grpc-labview/blob/master/src/lv_interop.cc): `src/lv_interop.cc`
- [Message metadata](https://github.com/ni/grpc-labview/blob/master/src/message_metadata.cc): `src/message_metadata.cc`
- [Message conversion](https://github.com/ni/grpc-labview/blob/master/src/lv_message.cc): `src/lv_message.cc`
- [Efficient conversion](https://github.com/ni/grpc-labview/blob/master/src/lv_message_efficient.cc): `src/lv_message_efficient.cc`
- [Message values](https://github.com/ni/grpc-labview/blob/master/src/lv_message_value.cc): `src/lv_message_value.cc`
- [Well-known types](https://github.com/ni/grpc-labview/blob/master/src/well_known_messages.cc): `src/well_known_messages.cc`
- [Cluster copying](https://github.com/ni/grpc-labview/blob/master/src/cluster_copier.cc): `src/cluster_copier.cc`
- [Any support](https://github.com/ni/grpc-labview/blob/master/src/any_support.cc): `src/any_support.cc`
- [Unpacked fields](https://github.com/ni/grpc-labview/blob/master/src/unpacked_fields.cc): `src/unpacked_fields.cc`

### Runtime support

- [Feature toggles](https://github.com/ni/grpc-labview/blob/master/src/feature_toggles.cc): `src/feature_toggles.cc`
- [Path support](https://github.com/ni/grpc-labview/blob/master/src/path_support.cc): `src/path_support.cc`
- [Event data](https://github.com/ni/grpc-labview/blob/master/src/event_data.cc): `src/event_data.cc`
- [gRPC interop](https://github.com/ni/grpc-labview/blob/master/src/grpc_interop.cc): `src/grpc_interop.cc`

### Other components

- **LabVIEW developer**
- **.proto definition**
- **gRPC peer**

## Connections

- LabVIEW developer → .proto definition: defines schema (evidence: `README.md`)
- LabVIEW developer → Proto parser: generates code (evidence: `README.md`)
- .proto definition → Proto parser: parses schema (evidence: `README.md`)
- Proto parser → Generated LabVIEW code: generates VIs (evidence: `README.md`)
- LabVIEW developer → Generated LabVIEW code: adapts code (evidence: `README.md`)
- LabVIEW developer → gRPC client: runs client (evidence: `README.md`)
- LabVIEW developer → gRPC server: runs server (evidence: `README.md`)
- gRPC client → gRPC peer: calls remotely
- gRPC server → gRPC peer: serves RPCs
- gRPC server → Reflection plugin: initializes reflection (evidence: `src/grpc_server.cc`)
- Reflection plugin → Reflection service: registers service
- Message metadata → LabVIEW interop: reads LabVIEW values (evidence: `src/message_metadata.cc`)
- Message metadata → Well-known types: checks type mappings (evidence: `src/message_metadata.cc`)
- LabVIEW developer → gRPC client: uses TLS (evidence: `README.md`)
- LabVIEW developer → gRPC server: configures TLS (evidence: `README.md`)
