How pigweed-project/pigweed works
Pigweed is a collection of embedded-targeted C++ and other-language modules, not one application with a single end-to-end runtime. An engineer selects modules to build firmware or supporting services; the resulting behavior depends on that selection. The map highlights major library domains and the RPC query workflow visible in sampled sources. Most module interactions are intentionally not connected because the available evidence does not establish calls between them; the repository-wide capability map is necessarily selective.
Main entry points: server.h RPC server · credit_based_flow_control_rx_engine.cc Bluetooth proxy · status.h Status · query_service.cc RPC query service
Components 20
Core primitives
- Preprocessor
pw_preprocessor/public/pw_preprocessor/compiler.h - Span
pw_span/public/pw_span/span.h - Status
pw_status/public/pw_status/status.h - Result
pw_result/public/pw_result/result.h - Containers
pw_containers/public/pw_containers/vector.h
Runtime and concurrency
- Async tasks
pw_async2/public/pw_async2/task.h - Futures
pw_async2/public/pw_async2/future.h - Synchronization
pw_sync/public/pw_sync/lock_annotations.h
Memory and storage
- Allocators
pw_allocator/public/pw_allocator/allocator.h - Deallocation
pw_allocator/public/pw_allocator/deallocator.h - Blob store
pw_blob_store/blob_store.cc
Communications
- RPC server
pw_rpc/public/pw_rpc/server.h - RPC query service
pw_rpc/pwpb/query_service.cc - Data transfer
pw_transfer/client_context.cc - Bluetooth APIs
pw_bluetooth/public/pw_bluetooth/emboss_util.h - Bluetooth proxy
pw_bluetooth_proxy/credit_based_flow_control_rx_engine.cc
Diagnostics
- Assertions
pw_assert/public/pw_assert/assert.h - Checks
pw_assert/public/pw_assert/check.h - Logging
pw_log/public/pw_log/log.h
Other components
- Firmware engineer
Connections 14
- Firmware engineer → Allocators: selects modules
README.md - Firmware engineer → Async tasks: selects modules
README.md - Firmware engineer → RPC server: selects modules
README.md - Firmware engineer → Bluetooth APIs: selects modules
README.md - RPC server → Containers: uses lists
pw_rpc/public/pw_rpc/server.h - RPC server → Span: uses spans
pw_rpc/public/pw_rpc/server.h - RPC server → Status: uses status
pw_rpc/public/pw_rpc/server.h - RPC query service → RPC server: registers and queries
pw_rpc/pwpb/query_service.cc - RPC query service → Status: returns status
pw_rpc/pwpb/query_service.cc - Bluetooth proxy → Bluetooth APIs: uses packet utilities
pw_bluetooth_proxy/credit_based_flow_control_rx_engine.cc - Bluetooth proxy → Assertions: checks conditions
pw_bluetooth_proxy/credit_based_flow_control_rx_engine.cc - Bluetooth proxy → Logging: logs events
pw_bluetooth_proxy/credit_based_flow_control_rx_engine.cc - Futures → Status: uses status
- Data transfer → RPC server: uses RPC