• Home
/
• What’s New In Pigweed

What’s New In Pigweed

Talk to the team at Pigweed Live

Our next Pigweed Live is Mon May 06, 2024 1PM (PDT). Please join us to discuss what’s new in Pigweed and anything else Pigweed-related.

Apr 18, 2024

Highlights (Apr 4, 2024 to Apr 18, 2024):

• The Python and C++ interfaces of pw_transfer now support adaptive windowing.

• SEED 0117: I3C was accepted.

• The new Zephyr quickstart shows you how to set up a C++-based Zephyr project that’s ready to use Pigweed.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_allocator

The new pw::allocator::TypedPool class is a slab allocator that can allocate a specific object with very low overhead. pw::allocator::TypedPool is implemented using the new pw::allocator::Pool interface. pw::allocator::TrackingAllocatorImpl was renamed to pw::allocator::TrackingAllocator.

• Add missing soong deps

• Add Pool

• Update OWNERS

• Rename TrackingAllocatorImpl (issue #326509341)

pw_async2

The new pw::async2::PendableAsTask class is a Task that delegates to a type with a Pend method.

• Add PendableAsTask

pw_blob_store

The pw_add_library() call for the pw_blob_store target now compiles as STATIC instead of INTERFACE to be more in line with the Bazel build.

• Fix CMakeLists.txt pw_add_library()

pw_bluetooth

• Formatting fixes

• LEGetVendorCapabilitiesCommandCompleteEvent v1.04 fields

• Add versions - LEGetVendorCapabilitiesCommandCompleteEvent (issue #332924521)

• Add EventMask and temp field in SetEventMaskCommand (issue #42068631)

• Store length max in virtual field

• Define LEReadMaximumAdvertisingDataLengthCommandComplete (issue #312898345)

pw_bluetooth_sapphire

In CIPD bt-host artifacts are now uploaded to fuchsia/prebuilt/bt-host.

• Iterators (issue #333448202)

• Change CIPD upload path (issue #321267610)

• Bump @fuchsia_sdk (issue #329933586, 321267476)

pw_build

• Disable deprecated pragma warnings (issue #333448202)

• Iterators (issue #335021928)

• Collect wheel fix

• Disable C23 extension warnings (issue #333712899)

pw_build_android

• Update module guidance

• Update cc_defaults guidance

• Make Common Backends static (issue #331458726)

pw_build_info

• Add missing header file for cmake

pw_cli

The following interfaces were moved from pw_presubmit to pw_cli to make them more widely available: pw_cli.file_filter.FileFilter, pw_cli.git_repo, and pw_cli.tool_runner.ToolRunner. The new pw_cli.decorators.deprecated() decorator emits a deprecation warning when the annotated function is used.

• Fix argument handling for GitRepo.has_uncommitted_changes()

• Fix subprocess runner arg concatenation

• Move FileFilter

• Fix commit fallback handling for GitRepo.list_files()

• Move git_repo to pw_cli

• Add Python deprecation decorator

• Update ToolRunner type hints

• Move ToolRunner

pw_containers

• Iterators (issue #335021928)

pw_cpu_exception_risc_v

The new pw_cpu_exception_risc_v backend lays the foundation for RISC-V CPU exception handling.

• Add initial backend structure

pw_env_setup

• clang (issue #333448202)

pw_hdlc

• Iterators (issue #335021928)

pw_ide

• Fixes to support changing working_dir (issue #335628872)

• Enable cmake.format.allowOptionalArgumentIndentation

pw_kvs

• Make Key an alias for string_view

• Depend on libraries for fake flash and store tests for Bazel

• Add libraries to reuse partition and store tests for Bazel

pw_log_zephyr

• Tokenize Zephyr shell fprintf

pw_presubmit

The following interfaces were moved from pw_presubmit to pw_cli to make them more widely available: pw_cli.file_filter.FileFilter, pw_cli.git_repo, and pw_cli.tool_runner.ToolRunner.

• Move FileFilter

• Add bthost_package step (issue #332357274)

• Don’t overwrite Bazel stdout files (issue #332357274)

• Remove cmake_clang from quick presubmit

• Move git_repo to pw_cli

• Fix copy/paste bug in _value()

• Move ToolRunner

pw_protobuf

• Access raw proto values; change RPC packet channel ID

pw_rpc

The new pw::rpc::ChangeEncodedChannelId() function lets you rewrite an encoded packet’s channel ID in place. See Remapping channels.

• Access raw proto values; change RPC packet channel ID

• Iterators (issue #335021928)

pw_rpc_transport

• Soong lib names now follow style

pw_sensor

The new pw_sensor module is the start of the implementation of SEED 0119: Sensors.

• Fix Python install

• Add attribute support to sensor-desc CLI (issue #293466822)

• Create a sensor-desc CLI (issue #293466822)

• Update validator schema to JSON schema (issue #293466822)

• Provide a validator (issue #293466822)

• Add module stub (issue #293466822)

pw_snapshot

• Process snapshots based on CPU architecture

pw_spi_linux

pw_spi_linux now has a basic Command-line interface that lets you read from and write to devices.

• Add pw_spi_linux_cli

pw_thread_freertos

• Use TCB for running stack pointer

pw_tls_client

• Only include <sys/time.h> if available

pw_transfer

The Python and C++ interfaces now support adaptive windowing.

• Iterators (issue #335021928)

• Implement adaptive windowing in Python

• Implement adaptive windowing in C++

• Convert arguments to std::fstream constructors (issue #333957637)

pw_web

• Support creating client without using proto descriptor

• NPM version bump to 0.0.18

• Fix string manipulation in download logs (issue #331480903)

• Use existing col data when adding new View (issue #331439176)

• Enable column order on init (issue #329712468)

• Fix test format of log-source.test (issue #333379333)

Build

Bazel

• Use remote cache in infra (issue #312215590)

Docs

The new Zephyr quickstart shows you how to set up a C++-based Zephyr project that’s ready to use Pigweed. The API references for all functions or methods that return a set of pw_status codes have been refactored for consistency. The Doxygen style guide has been revamped.

• Add pw_status table for API references

• Revamp Doxygen style guide

• Add Zephyr quickstart

• Update changelog

SEEDs

• (SEED-0117) pw_i3c

Miscellaneous

• (clang) Fix `std::array` iterators (issue #333448202)

• (emboss) Loosen Emboss cmake dependency tracking (issue #333735460)

• (many) Move maxDiff to be a class attribute

Apr 4, 2024

Highlights (Mar 21, 2024 to Apr 4, 2024):

• New modules: pw_i2c_rp2040 is a Pico SDK implementation of the pw_i2c interface, pw_async2_epoll is an epoll-based backend for pw_async2, pw_spi_linux is a Linux backend for pw_spi, pw_uart provides core methods for UART communication, and pw_bluetooth_proxy provides a lightweight proxy host that can be placed between a Bluetooth host and a Bluetooth controller to add functionality or inspection.

• Docs updates: Pigweed’s main docs builder now builds the examples repo; the examples will be available at https://pigweed.dev/examples. An experimental complete Doxygen API reference is now being published to https://pigweed.dev/doxygen. The pw_i2c docs, reStructuredText style guide, and docs contributors homepage have been revamped.

• Android platform updates: Many modules were refactored to follow the guidance in pw_build_android to make it easier to build them in Soong.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_allocator

The new Capabilities API lets derived allocators describe what optional features they support. pw::Allocator::GetLayout() has begun to be deprecated and replaced by pw::Allocator::GetRequestedLayout, pw::Allocator::GetUsableLayout(), and pw::Allocator::GetAllocatedLayout() to make it easier to distinguish between requested memory, usable memory, and already used memory. Methods that took Layout arguments, such as pw::Allocator::GetRequestedLayout(), have been deprecated.

• Restore DoDeallocate with Layout (issue #332510307)

• Move Layout and UniquePtr to their own header files

• Remove Layout from Deallocate and Resize

• Add allocation detail storage to TrackingAllocator

• Distinguish between requested, usable, and allocated sizes

• Add Capabilities

pw_assert_log

• Follow Soong guidelines (issue #328503970)

pw_async2

The new pw::async2::PendFuncTask class delegates a task to a provided function.

• Add Poll::Readiness helper

• Fix TSAN for dispatcher_thread_test

• Add PendFuncTask

pw_async2_epoll

The new pw_async2_epoll module is an epoll-based backend for pw_async2.

• Epoll-backed async2 dispatcher

pw_bluetooth

The Usage section now shows CMake usage and the new Contributing section shows how to contribute Emboss code.

• Define LEReadMaximumAdvertisingDataLengthCommandComplete (issue #312898345)

• Add more opcodes

• Add example of using to_underlying (issue #326499650)

• Emboss formatting tweak (issue #331195584)

• Add cmake to usage guide (issue #326499587)

• Add opcode_full field to emboss HCI headers (issue #326499650)

• Add enum for opcodes (issue #326499650)

• Update cmake targets to be consistent (issue #326499587)

• Update build files to be consistent (issue #326499587)

• Add emboss ReadBufferSize v1 event (issue #326499650)

• Add emboss contributing section to docs.rst (issue #331195584)

• protocol.h comments tweak (issue #326499650)

pw_bluetooth_proxy

The new pw_bluetooth_proxy module provides a lightweight proxy host that can be placed between a Bluetooth host and a Bluetooth controller to add functionality or inspection.

• Move to cpp23::to_underlying (issue #331281133)

• Use emboss OpCode enum (issue #326499611)

• Bluetooth proxy module and initial classes (issue #326496952)

pw_bluetooth_sapphire

pw_bluetooth_sapphire now supports emulation, Fuchsia unit testing, and ARM64 build targets.

• Add arm64 release variant (issue #332928957)

• Stub bt-host CIPD manifest (issue #332357274, 321267610)

• Fuchsia testing support (issue #331692493, 42178254)

• Add emulator start workflow (issue #321267689)

pw_build

Modules can now be nested in subdirectories, which paves the way for refactoring how modules are organized in the upstream Pigweed repo. Project Builder is a new lightweight build command for projects that need to run multiple commands to perform a build.

• Allow nesting Pigweed modules in subdirectories

• Add alwayslink option to pw_cc_blob_library

• ProjectBuilder documentation

• BuildRecipe auto_create_build_dir option

• Defer build directory existence check

pw_build_android

• Define rule with static libs (issue #331458726)

pw_build_info

The new pw::build_info::LogBuildId() function lets you print a GNU build ID as hex.

• Add log function of GNU build ID

• Fix Bazel baremetal compatibility

pw_bytes

• Add example to docs of using _b suffix

pw_channel

The new pw::channel::LoopbackDatagramChannel and pw::channel::LoopbackByteChannel aliases provide channel implementations that read their own writes. The new pw::channel::ForwardingChannelPair class lets you connect two subsystems with datagram channels without implementing a custom channel.

• Return status from PollReadyToWrite

• Rename methods to Pend prefix

• Add loopback channel

• Split open bits for read and write

• Seek is not async

• Set closed bit on FAILED_PRECONDITION

• Respect sibling closure

• Introduce forwarding channels

pw_chrono

• Update OWNERS

• Follow Soong guidelines (issue #328503970)

pw_cli

The new pw_cli.alias Python module lets you create pw subcommands that are effectively command line aliases. See Defining a simple alias.

• Move plural()

• Move status_reporter to pw_cli

• Add pw ffx alias (issue #329933586)

pw_digital_io

• Update OWNERS

pw_emu

• Fix a TypeError in TemporaryEmulator (issue #316080297)

pw_env_setup

• Run npm log viewer setup script after install

pw_function

• Define as cc_static_library (issue #328503970)

pw_hdlc

The new pw::hdlc::Router class is an experimental async HDLC router that uses pw_channel.

• Document members of router

• Add async router

• Fix sitenav

pw_i2c

The pw_i2c docs have been revamped.

• Revamp docs

• Update OWNERS

• Update OWNERS

pw_i2c_rp2040

The new pw_i2c_rp2040 module implements the pw_i2c interface using the Raspberry Pi Pico SDK.

• Initiator implementation (issue #303255049)

pw_ide

pw_ide.settings.PigweedIdeSettings.compdb_searchpaths() now accepts globs. The new pw_ide.settings.PigweedIdeSettings.targets_exclude() method lets you specify a list of GN targets that code analysis should ignore.

• Support comp DB search path globs

• Move status_reporter to pw_cli

• Support including and/or excluding targets

pw_libc

• Include strncpy (issue #316936782)

pw_log

• Follow Soong guidelines (issue #328503970)

pw_log_basic

• Fix Soong definitions (issue #328503970)

pw_log_null

• Define as cc_static_library (issue #328503970)

pw_log_tokenized

• Define as cc_static_library (issue #328503970)

pw_minimal_cpp_stdlib

• Clarify purpose

pw_module

• Jinja template refactor

• Overwrite prompt with diff display

• Allow nesting Pigweed modules in subdirectories

• Add OWNERS file during module creation

pw_multibuf

• Replace Mutex with ISL

• Define as cc_static_library (issue #328503970)

pw_polyfill

• Define as cc_static_library (issue #328503970)

• Simplify backported features table

pw_preprocessor

• Define as cc_static_library (issue #328503970)

pw_presubmit

Pigweed’s main docs builder now builds the examples repo; the examples will be available at https://pigweed.dev/examples. An experimental complete Doxygen API reference is now being published to https://pigweed.dev/doxygen.

• Include examples repo docs in docs_builder (issue #300317433)

• Move plural()

• Include doxygen html in docs_build

• Refactor Python Black formatter support

• Refactor Bazel formatter support

• Refactor GN formatting support (issue #326309165)

• Make ToolRunner capture stdout/stderr by default

• Update buildifier invocation

• Switch format test data to importlib

• Skip gn_teensy_build on mac-arm64

pw_protobuf

• Support full java protos (issue #329445249)

pw_python

• Update setup.sh requirements

pw_result

• Avoid duplicate symbols with Soong (issue #331458726)

• Define as cc_static_library (issue #328503970)

pw_router

• Define as cc_static_library (issue #328503970)

• Add Android common backends as dep (issue #328503970)

pw_rpc

• List dependencies directly (issue #331226283)

pw_rpc_transport

• Define as cc_static_library (issue #328503970)

pw_span

• Define as cc_static_library (issue #328503970)

pw_spi

• Update OWNERS

• Update OWNERS

pw_spi_linux

Linux functionality that was previously in pw_spi has been moved to its own module, pw_spi_linux.

• Move linux_spi from pw_spi to its own module

pw_status

The new pw::StatusWithSize::size_or() convenience method lets you return a default size in place of pw::StatusWithSize::size() when the status is not OK.

• Add StatusWithSize::size_or

pw_stream_shmem_mcuxpresso

• Fix interrupt pending check (issue #330225861)

pw_sync

• Follow Soong guidelines (issue #328503970)

pw_sys_io

• Update OWNERS

• Fix Soong definitions (issue #328503970)

pw_thread

• Follow Soong guidance (issue #328503970)

pw_toolchain

• Fix Rust GN host build

• Define as cc_static_library (issue #328503970)

• Remove unusued source set (issue #331260098)

• LLVM compiler-rt builtins

pw_trace_tokenized

• Fix static initialization

pw_transfer

New pw_transfer macros: PW_TRANSFER_LOG_DEFAULT_CHUNKS_BEFORE_RATE_LIMIT, PW_TRANSFER_LOG_DEFAULT_RATE_PERIOD_MS, PW_TRANSFER_CONFIG_LOG_LEVEL, and PW_TRANSFER_CONFIG_DEBUG_DATA_CHUNKS.

• Make numerous logging adjustments

pw_uart

The new pw_uart module defines core methods for UART communication.

• Create OWNERS

• Added UART interface

pw_unit_test

• Add failing results test record

pw_web

• NPM version bump to 0.0.17

• Fix logs not appearing in pw_console server (issue #331483789)

Build

Bazel

• Add missing Python deps (issue #331267896)

• Localize remaining backend label flags (issue #329441699)

Docs

• Mention that Windows flow needs admin rights

• Update reST style guide

• Organize the documentation style guides

• Update references to quickstart/bazel (issue #325472122)

• Simplify module creation docs using script

• Generate doxygen html output locally

• Update changelog

SEEDs

• (SEED-0117) Update status to Last Call

• (SEED-0126) Claim SEED number

• (SEED-0127) Reading sensor data

Third party

• (Emboss) Assume newer emboss version 2/2 (issue #329872338)

• (FreeRTOS) Fix typo in docs

• (Fuchsia) Copybara import (issue #331281133)

Miscellaneous

• Delete move constructors of buffer wrappers

• (Soong) Remove _headers from lib names (issue #328503970)

• (mbedtls) Avoid the use of unsupported libc functions (issue #316936782)

• (nanopb) Fix nanopb_pb2.py generation

Mar 22, 2024

Highlights (Mar 7, 2024 to Mar 22, 2024):

• Pigweed’s minimum supported Python version was changed to 3.10.

• Setting the new pw_build_TEST_TRANSITIVE_PYTHON_DEPS flag to false in your project’s .gn file turns off testing and linting of transitive dependencies in pw_python_package rules, which can speed up build times significantly.

• The new pw_log_android module is a pw_log backend for Android and the new pw_build_android module provides tools to help build Pigweed in Android platform applications.

• 0120: Sensor Configuration introduces pw_sensor, a module that will handle Pigweed’s upcoming sensor framework.

• The new PW_LOG_EVERY_N and PW_LOG_EVERY_N_DURATION macros provide rate-limited logging.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_allocator

The pw_allocator docs have been revamped. Code examples from the docs are now extracted from complete examples that are built and tested alongside the rest of the main Pigweed repo; see //pw_allocator/examples.

• Improve size report accuracy

• Add buffer utilities

• Improve UniquePtr ergonomics

• Various API modifications

• Add IsEqual

• Soft-deprecate heap_viewer.py (issue #328648868)

• Move code snippets from docs to examples (issue #328076428)

• Clean up sources files

• Remove erroneous quotes around tagline

• Refactor code size reports

• Remove metrics.cc (issue #277108894)

• Fix move semantics for UniquePtr

• Refactor docs (issue #328076428)

• Make metrics configurable (issue #326509341)

pw_assert

• Add keep_dep tags to backend_impl (issue #329441699)

• Introduce :backend, :backend_impl (issue #329441699)

• Apply formatting fixes

pw_assert_basic

• Fix BUILD.bazel file (issue #328679085)

pw_bluetooth

• Add command complete event (issue #311639690)

• Add command complete event (issue #311639690)

• Add H4 packet indicators in emboss (issue #326499682)

• Reformat l2cap_frames.emb

pw_bluetooth_sapphire

• Use amd64 SDK (issue #330214852)

• Fuchsia SDK example (issue #42178254)

pw_build

Setting the new pw_build_TEST_TRANSITIVE_PYTHON_DEPS flag to false in your project’s .gn file turns off testing and linting of transitive dependencies in pw_python_package rules, which can speed up build times significantly.

• Option to not transitively run py .tests and .lint deps

pw_build_android

The new pw_build_android module provides tools to help build Pigweed in Android platform applications.

• Add new utils module (issue #328503970)

pw_bytes

The new pw::bytes::ExtractBits() helper extracts bits between specified left bit and right bit positions. New Rust helpers were added; see Crate pw_bytes.

• Add ExtractBits template (issue #329435173)

• Add Rust helpers for contcatenating const slices and strs

pw_channel

Datagram-to-byte conversions must now be explicit.

• Enable GetWriteAllocator function

• Require explicit datagram-to-byte conversions

• Remove max_bytes argument from ReadPoll

• Support datagram-to-byte conversions

• Handle closed channels in base

pw_checksum

• Add missing #include <array> (issue #329594026)

pw_chre

• Remove unused files

pw_containers

• ConstexprSort in FlatMap takes an iterator (issue #330072104)

• Add move constructors to queues

pw_digital_io_linux

The new pw_digital_io_linux CLI tool lets you configure a GPIO line as an input and gets its value, or configure a line as an output and set its value.

• Add Android.bp

• Add test CLI

pw_docgen

• Single-source the module metadata (issue #292582625)

pw_env_setup

Pigweed’s minimum supported Python version was changed to 3.10.

• Update min Python version to 3.10 (issue #248257406)

• Update CIPD rust version

• Use amd64 SDK (issue #330214852)

• Fuchsia SDK example (issue #42178254)

pw_format

Initital support for untyped specifiers (%v) was added.

• Enhance Rust tests to check for arguments (issue #329507809)

• Add initial support for untyped specifiers

pw_hdlc

The newly public pw::hdlc::Encoder class supports gradually encoding frames without ever holding an entire frame in memory at once.

• Expose Encoder

pw_hex_dump

CMake support was added.

• Add CMake support

pw_json

• Move examples outside of the pw namespace

pw_libc

• Define LIBC_FAST_MATH for the faster integral fixed point sqrt (issue #323425639)

• Add uksqrtui to stdfix (issue #323425639)

• Include sqrtur and expk in stdfix (issue #323425639)

pw_log

The new PW_LOG_EVERY_N and PW_LOG_EVERY_N_DURATION macros provide rate-limited logging.

• Add rate limit log statements

• Add keep_dep tags to backend_impl (issue #329441699)

• Introduce localized backend label flags (issue #329441699)

• Run bpfmt on all Android.bp (issue #277108894)

pw_log_android

The new pw_log_android module is a pw_log backend for Android.

• Fix Soong build

• Add pw_log_android_stderr (issue #328281789)

• Add module documentation

pw_malloc

• Add backend label flags (issue #329441699)

pw_multibuf

pw::multibuf::Stream is a new multibuf-backed pw_stream implementation that can read from and write to a multibuf. pw::multibuf::SimpleAllocator is a simple, first-fit variant of pw::multibuf::MultiBufAllocator.

• Add stream implementation

• Add empty() function

• Pass reference instead of pointer

• Add SimpleAllocator

pw_package

• Match Emboss version used by Bazel (issue #329872338)

pw_polyfill

• Update __cplusplus macro for C++23; support C

• Remove PW_INLINE_VARIABLE

• Detect C23 (issue #326499611)

pw_presubmit

• Suppress stdout option for rst_format

• Begin formatter modularization (issue #326309165)

• Switch default formatter to black (issue #261025545)

• Fuchsia SDK example (issue #42178254)

pw_rpc

• Support full java protos (issue #329445249)

• Move some headers from srcs to hdrs (issue #323749176)

• Add TryFinish API for pw_rpc stream (issue #328462705)

• Remove deprecated functions from Java client

pw_rust

• Tweak docs for Rust tokenized logging example

pw_sensor

0120: Sensor Configuration introduces pw_sensor, a module that will handle Pigweed’s upcoming sensor framework.

• Add configuration SEED

pw_spi

• Update Android.bp to conform with new style

pw_stream_shmem_mcuxpresso

• Fix interrupt pending check (issue #330225861)

pw_sync_stl

• Android.bp: Add missing dependency on pw_sync_headers

pw_sys_io

• Add backend label flags (issue #329441699)

pw_sys_io_rp2040

• Use callbacks to block on input (issue #324633376)

pw_sys_io_stm32cube

• Fix build for f0xx, f1xx and f3xx families

pw_thread_zephyr

• Apply formatting fixes

pw_tokenizer

The Rust library’s hashing code was updated to support multi-input hashing.

• Refactor Rust hash code to allow multi-input hashing

pw_transfer

The TypeScript client now has an abort() method for ending a transfer without a completion chunk and a terminate() method for ending a transfer with a completion chunk.

• Inline TRANSFER_CLIENT_DEPS

• Support full java protos (issue #329445249)

• Add abort() and terminate() apis

• Update the proxy to only consider transfer chunks

• Fix Java client timeouts in terminating state

pw_unit_test

The new pw::unit_test::TestRecordEventHandler class is a predefined event handler that outputs a test summary in Chromium JSON Test Results format.

• Flag to disable cmake pw_add_test calls (issue #330205620)

• Add duplicate test case

• Localize the label flags (issue #329441699)

• Add test record event handler

• Adding googletest_handler_adapter to cmake

pw_watch

Changes to Emboss files now trigger rebuilds.

• Add emboss files to default watch patterns

pw_web

• NPM version bump to 0.0.16

• Update createLogViewer to use union types (issue #330564978)

• Include file information in browser logs (issue #329680229)

• NPM version bump to 0.0.15

Build

Bazel

The new pw_facade Bazel macro makes it easier to create a facade.

• Remove the deprecated pw_cc_facade macro (issue #328679085)

• Treat Rust warnings as errors (issue #329685244)

• Localize backend label flags (issue #329441699)

• Use pw_facade (issue #328679085)

• Introduce pw_facade (issue #328679085)

• Fix bazel query

Language support

Python

• Use future annotations

• Use future annotations

• Remove PathOrStr variables

• Switch from typing.Optional[…] to “… | None” (issue #248257406)

• Switch from typing.Union to “|” (issue #248257406)

• Use argparse.BooleanOptionalAction (issue #248257406)

• Use pathlib.Path.is_relative_to() (issue #248257406)

• Switch from typing.Dict to dict (issue #248257406)

• Switch from typing.Tuple to tuple (issue #248257406)

• Switch from typing.List to list (issue #248257406)

OS support

Zephyr

• Add action for installing Zephyr SDK

Docs

The new CLI style guide outlines how CLI utilities in upstream Pigweed should behave.

• Add CLI style guide (issue #329532962)

• Move TODO style guide

• Fix redirect paths (issue #324241028)

• Fix code-block indentation

• Add redirects infrastructure and docs contributor section (issue #324241028)

• Fix some incorrect target names (issue #329441699)

• Fix mentions of sample_project (issue #322859039)

• TOC entry for API documentation from source

• Update changelog

Third party

• Minor build file formatting fixes

• (Emboss) Assume newer emboss version 1/2 (issue #329872338)

• (STM32Cube) Fix bazel hal driver build

Mar 7, 2024

Highlights (Feb 22, 2024 to Mar 7, 2024):

• The new pw_digital_io_linux module is a pw_digital_io backend for Linux userspace.

• pw::multibuf::MultiBufAllocator class is a new interface for allocating pw::multibuf::MultiBuf objects.

• The pw_web log viewer now captures browser console logs. It also now supports creating log stores and downloading logs from stores.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_allocator

• Remove split_free_list_allocator.cc from Android.bp

• Add missing dep

• Use BlockAllocator instead of alternatives

• Make TrackingAllocator correct by construction

pw_assert_log

• Depend on pw_log_headers in Android.bp

• Fix PW_HANDLE_CRASH to handle 0 args (issue #327201811)

pw_async2

• Address post-submit comments

• Add converting constructors to Poll

pw_blob_store

• Set module name to BLOB

pw_bluetooth

• Add hci_data.emb (issue #311639690)

• Add ISO feature bit to controllers

• Add ISO definitions to Controller

pw_build

• Remove FUZZTEST_OPTS

• Fix ProjectBuilder recipe percentage

pw_config_loader

• Support custom overloading rules

pw_containers

• Rename VariableLengthEntryQueue

• Rename VariableLengthEntryQueue files

• VariableLengthEntryQueue C++ API

pw_digital_io_linux

The new pw_digital_io_linux module is a pw_digital_io backend for Linux userspace.

• Introduce new module

pw_json

• Update example; fix typo and declaration order

pw_libc

• Add stdfix target (issue #323425639)

• Facilitate next llvm-libc roll

pw_log

• Fix stdout race in println_backend_test_test (issue #328498798)

• Add tests for Rust printf and println backends

• Show child docs in site nav

• Fix the Pigweed Soong build (issue #277108894)

pw_module

• Remove README.md check (issue #328265397)

pw_multibuf

The new pw::multibuf::MultiBufAllocator class is an interface for allocating pw::multibuf::MultiBuf objects.

• Add MultiBufAllocator interface

• Deduplicate const+non_const iterators

• Clean up API (issue #327673957)

• Add +=N and +n operators to iterator

• Add slicing operations to MultiBuf

pw_presubmit

• Remove unused presubmit step

pw_proto_compiler

• strip_import_prefix + options (issue #328311416)

pw_result

• Add constructor deduction guide

pw_rpc

The newly public pw::rpc::CloseAndWaitForCallbacks function abandons an RPC and blocks on the completion of any running callbacks.

• Expose CloseAndWaitForCallbacks in client call API

pw_rpc_transport

• Add log for no packet available

pw_rust

• Add Rust tokenized logging example

pw_stream_uart_mcuxpresso

pw_stream_uart_mcuxpresso now supports direct memory access reads and writes.

• Fix code examples in docs

• Implement DoRead DMA (issue #325514698)

• Implement DoWrite DMA (issue #325514698)

• Implement init / deinit (issue #325514698)

• USART DMA scaffolding (issue #325514698)

pw_string

pw::InlineByteString is a new alias of pw::InlineBasicString<std::byte> that can be used as a simple and efficient byte container.

• Add ToString for Result and Poll

• Support InlineBasicString<std::byte>; InlineByteString alias (issue #327497061)

pw_sync

• Allow implict conversion when moving BorrowedPointer

pw_tokenizer

• Fix missing bazel filegroup

• Add Detokenizer constructor with elf binary section

• Add code size optimization to Rust implementation

pw_toolchain_bazel

• Apply more common attrs to cc_toolchain targets

• Support Windows in toolchain template build files

pw_transfer

• Respect user-specified resource size

• Temporarily disable broken integration test

• Only request a single chunk in test (issue #323386167)

• Fix WindowPacketDropper proxy filter (issue #322497823)

pw_unit_test

The pw_unit_test docs have been revamped. Using the full upstream GoogleTest backend with simple_printing_main in Bazel has been fixed.

• Update docs

• Fix googletest backend (issue #324116813)

pw_watch

pw_watch now rebuilds when Bazel files are changed.

• Add bazel files to default watch patterns (issue #328619290)

pw_web

The pw_web log viewer now captures browser console logs. It also now supports creating log stores and downloading logs from stores.

• Capture browser logs in the log viewer (issue #325096768)

• Create log store and enable download logs from it (issue #316966729)

Bazel

• Update rust_crates in Bazel WORKSPACE

• Mark more targets testonly (issue #324116813)

Docs

The new protobuf style guide describes how protobufs should be styled throughout Pigweed.

• Add protobuf style guide (issue #232867615)

• Clarify that Pigweed doesn’t support msan (issue #234876100)

• Clarify rvalue docs

• Reorder tocdepth and title

• Prefer rvalue references

• Update changelog

Third party

• Android.bp: Export fuchsia_sdk_lib_stdcompat headers

• (Emboss) Support latest version of Emboss in GN

• (Emboss) Add CMake support for emboss (issue #326500136)

• (FreeRTOS) Tidy up Bazel build (issue #326625641)

• (FreeRTOS) Create Bazel build template (issue #326625641)

• (STM32Cube) Build template formatting fixes

Miscellaneous

• Unrecommendify

• Clean up Python proto imports (issue #241456982)

Feb 23, 2024

Highlights (Feb 9, 2024 to Feb 23, 2024):

• The new pw_json module provides classes for serializing JSON.

• Raspberry Pi RP2040 support was expanded, including a new pw::digital_io::Rp2040Config struct enables you to configure polarity for RP2040 GPIO pins, and a new pw::spi::Rp2040Initiator class which is a Pico SDK userspace implementation of Pigweed’s SPI Initiator class.

• The new pw::spi::DigitalOutChipSelector class sets the state of a pw_digital_io output when activated.

• The pw_kvs docs were overhauled.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_allocator

• Remove total_bytes metric

• Expose TrackingAllocator’s initialization state

pw_assert

• Apply formatting changes

pw_assert_log

• Fix Soong rules (issue #324266698)

• Fix missing lib in soong rule

pw_bluetooth

• Add Emboss rules to BUILD.bazel

• Update emboss imports to match Bazel rule

pw_build

• Silence warnings from linker script test

pw_bytes

• Add missing export in soong rule

pw_chrono_rp2040

• Minor tweaks to documentation and test (issue #303297807)

pw_cli

• Add exit codes

pw_config_loader

The new skip_files__without_sections option enables you to just move on to the next file rather than raise an exception if a relevant section doesn’t exist in a config file.

• Allow skipping files

pw_containers

• Add default move operator for FilteredView

• Add move constructor to FiltertedView

pw_digital_io_rp2040

The new pw::digital_io::Rp2040Config struct enables you to configure polarity for RP2040 GPIO pins.

• Config with polarity (issue #303255049)

pw_env_setup

• Use amd64 host tools on arm64 (issue #325498131)

pw_function

The new //third_party/fuchsia:fit label flag enables Bazel-based projects to provide an alternate implementation for fit() when needed.

• //third_party/fuchsia:fit label_flag

pw_fuzzer

• Fix Bazel example, add presubmit test (issue #324617297)

pw_grpc

• Fix some minor bugs

pw_hdlc

• Add android_library targets (issue #321155919)

pw_i2c

The API reference for pw::i2c::RegisterDevice is now published on pigweed.dev.

• Doxygenify RegisterDevice

pw_ide

• Fix environment inference

pw_json

The new pw_json module provides classes for serializing JSON.

• Classes for serializing JSON

pw_kvs

The pw_kvs docs were overhauled.

• Follow new module docs guidelines

pw_log

• Add android_library targets (issue #321155919)

pw_log_android

• Fix missing libs in soong rule

pw_metric

• Fix Bazel build (issue #258078909)

pw_module

• Add exit codes

pw_multibuf

• Fix soong support (issue #325320103)

pw_package

• Update GoogleTest

• Remove capture_output=True

pw_preprocessor

The pw_preprocessor reference is now being generated via Doxygen.

• Do not check for __VA_OPT__ on older compilers (issue #326135018)

• Switch to Doxygen

• Use __VA_OPT__ when available

pw_presubmit

• Allow markdown style TODOs and adjust rustdocs (issue #315389119)

• Log format –fix output

• Fix formatting of typescript code

• Disallow FIXME and recommend TODO

• Allow pwbug.dev in TODOs

• Allow Bazel issues in TODOs

pw_rpc

pw_rpc clients will once again accept unsolicited responses from pw_rpc servers that were built prior to September 2022. Unsolicited responses, also known as “open” requests, let a server send a message to a client prior to the client sending a request. This change fixed an incompatibility in which pw_rpc clients built after September 2022 would not accept unsolicited responses from servers built before September 2022 (specifically, change #109077).

• Remove use of deprecated Python API (issue #306195999)

• Add android_library targets (issue #321155919)

• Support legacy unsolicited responses

pw_software_update

• Add java build objects

pw_spi

The new pw::spi::DigitalOutChipSelector class is an implementation of pw::spi::ChipSelector that sets the state of a pw_digital_io output when activated.

• Add Android.bp (issue #316067629)

• DigitalOutChipSelector (issue #303255049)

• Correct full-duplex behavior of linux_spi (issue #316067628)

pw_spi_rp2040

The new pw::spi::Rp2040Initiator class is a Pico SDK userspace implementation of Pigweed’s SPI Initiator class.

• Initiator implementation (issue #303255049)

pw_stream

• Fix Pigweed build after sync (issue #277108894)

pw_string

Debug error messages for assertions containing std::optional types have been improved.

• Add ToString for std::optional

pw_sync

• Add missing lib in soong rule

pw_tokenizer

The pw_tokenizer and pw_snapshot Python libraries can now be used from Bazel as a result of the proto migration. See issue #322850978).

• Fix link breakage on linux (issue #321306079)

• Proto migration stage 5/5 (issue #322850978)

• Proto migration stage 3/5 (issue #322850978)

• Proto migration stage 1.5/5 (issue #322850978)

• Proto migration stage 1/5 (issue #322850978)

pw_toolchain

• Add missing #include

• Rename `action_config_flag_sets to flag_sets <https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/192911>`__

• Simplify macOS -nostdlib++ usage

• Remove unnecessary toolchain arguments

• Add missing macOS cxx_builtin_include_directories (issue #324652164)

pw_toolchain_bazel

• Use llvm-libtool-darwin on macOS (issue #297413805)

• Explicitly depend on rules_cc

pw_transfer

• Add an android_library for the Java client

• Change class to parser

• Fix integration test START packet issue (issue #322497491)

• Add GetResourceStatus method

• Limit test to sending a single chunk

• Remove/hide deprecated handle interfaces

pw_watch

• Add exit codes

pw_web

The log viewer now supports multiple log sources.

• NPM version bump to 0.0.14

• Enable multiple log sources (issue #325096310)

Build

• Fix docs build on mac-arm64

• Use correct host_cpu when disabling docs on Arm Macs

• Remove docs from default build on Arm Macs (issue #315998985)

• Build for Java 11

Bazel

• Remove shallow_since attributes

• Upgrade protobuf to 4.24.4 (issue #319717451)

Targets

• (rp2040) Replace rp2040 target with rp2040_pw_system

• (rp2040) Custom libusb backend

OS support

• (Zephyr) Change the pinned Zephyr commit

• (Zephyr) Add zephyr’s west CLI

Docs

Breadcrumbs are now shown at the top of all docs pages except the homepage.

• Add breadcrumbs

• Fix incorrect module name in changelog

• Fix canonical URLs for all */docs.html pages

• Fix typo in facades documentation

• Fix 404s (issue #325086274)

SEEDs

• (SEED-0125) Claim SEED number

• Mark legacy Sensor SEED as Rejected

Third party

• Roll FuzzTest and Abseil

Miscellaneous

• Disable tests incompatible with rp2040 (issue #260624583)

• Fix uses of std::chrono literals

• (pigweed.json) Disallow Rosetta (issue #315998985)

• (renode) Update renode to latest daily build

Feb 9, 2024

Highlights (Jan 26, 2024 to Feb 9, 2024):

• The new pw_grpc module provides classes that map between pw_rpc packets and HTTP/2 gRPC frames, allowing pw_rpc services to be exposed as gRPC services.

• A lot of the remaining pw_toolchain_bazel feature work from 0113: Add modular Bazel C/C++ toolchain API was finished and rough edges were polished up.

• The new generic pw::allocator::BlockAllocator interface supported several derived types that enable fine-grained control over how a block satisfies an allocation request.

• pw_transfer now supports resumable transfers.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_alignment

• Add CMake & Soong support

pw_allocator

The new generic pw::allocator::BlockAllocator interface supports several derived types that enable fine-grained control over how a block satisfies an allocation request. The new pw::allocator::GetLayout() method retrieves the layout that was used to allocate a given pointer. The new pw::allocator::AllocatorSyncProxy interface synchronizes access to another allocator, allowing it to be used by multiple threads.

• Refactor metric collection for tests

• Add Allocator::GetLayout

• Add BlockAllocator

• Fix SynchronizedAllocator typo

• Streamline Block and improve testing

• Separate metrics from Fallback-, MultiplexAllocator

• Make TrackingAllocator::Init optional

• Check for integer overflow in Layout

• Add additional metrics

• Rename AllocatorMetricProxy to TrackingAllocator

• Add SynchronizedAllocator

• Fix typo

• Fix Allocator::Reallocate

pw_assert

• Break out compatibility backend target (issue #322057191)

pw_async_basic

• Remove unneeded locks from test

• Test flake fix (issue #323251704)

• Fix data race in newly added test

• Fix ordering of tasks posted at same time

pw_bloat

The new boolean argument ignore_unused_labels for pw_size_report() enables you to remove labels from the JSON size report that have a size of 0.

• Allow removal of zero sized labels (issue #282057969)

pw_bluetooth

• Add l2cap_frames.emb

• Fix typo in SbcAllocationMethod

pw_boot

• Update status and general doc cleanup

pw_build

The new PW_USE_COLOR, NO_COLOR, and CLICOLOR_FORCE OS environment variables enable you to control whether output in CI/CQ is color formatted.

• Add Fuchsia to TARGET_COMPATIBLE_WITH_HOST_SELECT

• Enable fixed point types for clang builds (issue #323425639)

• Support disabling colors (issue #323056074)

pw_bytes

• Check for integer overflow

pw_channel

The initial pw::channel::Channel class from 0114: Channels has been introduced but it is experimental and should not be used yet.

• Docs fix

• Module for async data exchange with minimal copying

pw_cli

• Add json_config_loader_mixin

pw_compilation_testing

• Do not expand regexes

• Minor improvements

pw_config_loader

The code from pw_cli related to looking up user-specific configuration files has been moved to this separate module.

• Add support for nested keys

• Add tests

• Initial commit

pw_cpu_exception_cortex_m

• Handle ARM v8.1 case (issue #311766664)

pw_digital_io

• [[nodiscard]] on as() conversion functions

• Use pw::internal::SiblingCast

pw_env_setup

• Roll cipd (issue #315378787)

• Make npm actions more robust (issues #323378974, #322437881, #323378974)

• Only add mingw to PATH once (issue #322437881)

pw_format

• Fix safe buildifier warnings (issue #242181811)

pw_function

• Follow new docs guidelines

pw_fuzzer

• Fix Bazel run target instructions

pw_grpc

The new pw_grpc module is an implementation of the gRPC HTTP/2 protocol. It provides classes that map between pw_rpc packets and pw_grpc HTTP/2 frames, allowing pw_rpc services to be exposed as gRPC services.

• Fix off-by-one error when handling DATA frames (issue #323924487)

• Add new module

pw_ide

• Disable Python terminal activation in VSC

• Remove terminal env vars from VSC settings

• VSC extension 0.1.4 release

pw_presubmit

Color formatting in CI/CQ has been improved for readability.

• Simplify ‘gn gen’ color logic

• Use color logic in gn gen call

• Apply color logic in more cases

• Support disabling colors (issue #323056074)

pw_protobuf

• Use pw::internal::SiblingCast

pw_random

• Clean up build files

pw_result

• Add missing libs in Soong blueprint

pw_rpc

• Avoid undefined behavior when casting to rpc::Writer

pw_stream

• Use pw::internal::SiblingCast

pw_target_runner

• Remove .dev from path name

pw_thread

• Incease the sleep duration in tests (issue #321832803)

pw_tokenizer

Troubleshooting docs were added that explain how to workaround GCC’s template function tokenization bug in GCC releases prior to 14.

• Mention GCC template bug in the docs

pw_toolchain

• Disable unstable features in rust toolchains

• Fix divergent configuration in arm_clang M0+ toolchain

• Use less generic names for B1-B5

• Use LLVM compiler-rt builtins

• Internal wrapper for casting between siblings (issue #319144706)

• Small docs update (issue #300471936)

pw_toolchain_bazel

A lot of the remaining pw_toolchain_bazel feature work from 0113: Add modular Bazel C/C++ toolchain API was finished and rough edges were polished up.

• Remove support for *_files (issue #323448214)

• Add support for setting environment variables (issue #322872628)

• Implement per-action files (issue #322872628)

• Migrate to PwToolInfo (issue #322872628)

• Pull file collection into config rule (issue #322872628)

• Implement pw_cc_provides (issue #320177248)

• Implement PwActionConfigInfo (issue #322872628)

• Create temporary variable (issue #322872628)

• Add a concept of well-known features (issue #320177248)

• Implement requires_any_of for flag sets (issue #320177248)

• Migrate to custom PwFeatureInfo (issue #320177248)

• Add custom PwFlagSetInfo (issue #322872628)

• Replace bazel_tools providers with PW providers (issue #322872628)

• Support regular binaries as tools (issue #322872628)

pw_transfer

pw_transfer now supports resumable transfers.

• Account for remaining_bytes in payload buffer

• Rename TransferHandle -> Handle

• Add resumeable transfers

• Make cancellation a method on handles

• Allow setting a transfer resource size in C++ (issue #319731837)

pw_unit_test

• Remove obsolete label flag

Build

• (Bazel) Update clang version

OS support

• (Zephyr) Fix default logging in chromium CQ

Docs

• Nest backends under respective facades in sitenav

• Add doxygengroup to the style guide

• Update homepage

• Update README links

• Fix module homepage canonical URLs (issue #323077749)

• Update Bazel quickstart output sample (issue #300471936)

SEEDs

• (SEED-0122) Update status, add bug reference

• Fix pw_seed_index template deps

• Add authors to SEED document headers

• (SEED-0119) Add sensors SEED

Miscellaneous

• Update the bootstrap script to have start/end guards

• Migrate bug numbers (issue #298074672)

• Upgrade mbedtls to 3.5.0 (issue #319289775)

• Fix clang-format findings

Jan 26, 2024

Highlights (Jan 12, 2024 to Jan 26, 2024):

• The new Using a Pigweed module in an existing Bazel project guide shows you how to integrate a single Pigweed module into an existing Bazel project.

• Initial support for pw_cc_feature has been added, which completes the initial set of rules required for building toolchains with pw_toolchain_bazel.

• A longstanding GCC bug that caused tokenized logging within a function template to not work has been fixed.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_allocator

• Add SplifFreeListAllocator fuzzer

pw_bluetooth

• Add advertising packet content filter emboss definitions

• Add android multiple advertising emboss structures

• Add a2dp remaining offload emboss structures

• Move emboss structures from hci_commands to hci_common

• Reorganize hci_vendor.emb

• Add new event definitions (issue #311639432)

pw_build

The new pw_cc_binary_with_map Bazel rule enables you to generate a .map file when building a binary.

• Add pw_cc_binary variant to generate .map files (issue #319746242)

pw_bytes

The pw::ByteBuilder API reference is now being auto-generated via Doxygen. The new pw::bytes::SignExtend() template enables expanding the nth bit to the left up to the size of the destination type.

• Fix compilation error occured with Werror=all

• Update documentation

• SignExtend template (issue #321114167)

• Make _b literals error on values >255

pw_compilation_testing

• Skip tests excluded by the preprocessor (issue #321088147)

pw_console

• Upgrade to ptpython 3.0.25 (issue #320509105)

pw_containers

The destructors for pw::InlineQueue, pw::InlineDeque, and pw::Vector are now protected to prevent use with delete or std::unique_ptr and to prevent unusable declarations.

• Protected InlineQueue/Deque<T> destructor

• Make Vector<T> destructor protected

pw_digital_io

The private virtual API requirements for pw::digital_io::DigitalIoOptional are now documented because they are needed when implementing concrete backends for pw_digital_io.

• Document the private virtual API requirements

• Remove conditional interrupt disabling requirements

pw_doctor

• Update expected tools on POSIX (issue #315998985)

pw_env_setup

• Retrieve qemu on ARM Macs (issue #315998985)

pw_hdlc

• Remove unused targets

• Remove unused rpc packet processor target

pw_ide

• Fix typo

• Launch activated terminals in VSC (issue #318583596)

• VSC extension 0.1.3 release

pw_kvs

The new pw::kvs::FlashMemory::EndOfWrittenData() method returns the first byte of erased flash that has no more written bytes.

• Add EndOfWrittenData()

pw_persistent_ram

• Add more tests to PersistentBuffer (issue #320538351)

pw_polyfill

pw_polyfill/static_assert.h now provides a C23-style static_assert(). See static_assert.

• Remove _Static_assert workaround

• Provide static_assert polyfill for C

pw_preprocessor

The new PW_ADD_OVERFLOW, PW_SUB_OVERFLOW, and PW_MUL_OVERFLOW macros can be used to check for integer overflows.

• Add integer-overflow macros

pw_presubmit

• Add more info to todo summary

• Trim paths in ninja summary

• No copyright for MODULE.bazel.lock

• Exclude docs on Mac ARM hosts (issue #315998985)

pw_protobuf

• Fix another &*nullptr in test

• Fix undefined pointer deref in fuzz test

• Fix out-of-range read (issue #314803709)

pw_thread

• Add missing include

pw_tokenizer

A longstanding GCC bug that caused tokenized logging within a function template to not work has been fixed.

• Compensate for GCC template bug (issue #321306079)

• Allow use of static_assert in C99 test

• Adjust rustdocs deps to only be in std environments

pw_tool

This incomplete module has been deleted.

• Delete module

pw_toolchain_bazel

The //pw_toolchain_bazel directory is now configured to be compiled as a standalone Bazel module. Initial support for pw_cc_feature has been added, which completes the initial set of rules required for building toolchains with pw_toolchain_bazel.

• Remove deprecated action names (issue #320177248)

• Migrate to type-safe action names (issue #320177248)

• Require action labels in providers (issue #320177248)

• Define actions names as labels (issue #320177248)

• Make the pw_toolchain repository into a bazel module (issue #320177248)

• Add pw_cc_feature (issue #309533028)

• Set exec_transition_for_inputs to False (issue #321268080)

• Remove check_deps_provide (issue #320177248)

pw_transfer

The C++ client for pw_transfer now uses handles for cancellation.

• Remove duplicated Builder call

• Use handles for cancellation in C++ client (issue #272840682)

pw_web

• Init. improvements to resize performance (issue #320475138)

Build

• Use Python 3.11 (issue #310293060)

• Use pre-release of rules_python (issue #310293060)

• Use rules_python in Bazel build files

Targets

host_device_simulator

• Update docs

Docs

• How to use a single Pigweed module in Bazel

• Add pre-reqs for non-Debian Linux distros (issue #320519800)

• Auto-generate module source code and issues URLs

• Minor updates to the FAQ

• Update changelog

SEEDs

• (SEED-0123) Claim SEED number

• (SEED-0124) Claim SEED number

Miscellaneous

• Remove module-level README.md files

• Fix how we ignore bazel- directories

Jan 12, 2024

Highlights (Dec 29, 2023 to Jan 12, 2024):

• pw_allocator added parameter to make it easier to work with allocation metadata in a block’s header and made it easier to omit flag-related code for blocks.

• pw_cc_library has been replaced with the Bazel-native cc_library.

• pw_thread_stl disallowed std::thread::detach() on Windows because it’s known to randomly hang indefinitely.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_allocator

A new template parameter, kNumExtraBytes, was added to Block. This parameter reserves space in the block’s header for storing and fetching allocation metadata.

The kMaxSize parameter was removed from Block and replaced by kNumFlags to make it easier to omit flag-related code when not needed and define fewer block types rather than one for each allocation pool size.

• Fix source file list in soong rule

• Fix MulitplexAllocator’s deps

• Add extra bytes to Block

• Add initializing constructors

• Add note to AllocatorMetricProxy tests

pw_bluetooth_sapphire

• Advertise FCS Option (issue #318002648)

• Refactor method and variable names (issue #312645622)

• Revert commits to get to a known working state

pw_containers

• Remove DestructorHelper from vector (issue #301329862)

pw_doctor

• Fix overridden package check

pw_emu

• Remove psutil dependency (issue #316080297)

pw_env_setup

• Update ref to bazel version file

• Drop reference to rust version file

• Use correct arch for cipd in Bazel (issue #234879770)

• Switch to Fuchsia ninja CIPD package (issue #311711323)

• Prevent NPM output from interrupting bootstrap

pw_ide

The new pigweed.enforceExtensionRecommendations configuration option for VS Code makes extension recommendation enforcement optional. When you set this flag to true in your project’s extension.json, recommended extensions will need to be installed and non-recommended extensions will need to be disabled.

You can now submit Pigweed issues through VS Code. Open the Command Palette and type Pigweed: File Bug.

• Add Jest testing to VSC extension

• Make VSC extension enforcement an option

• Support alternate `clangd` paths (issue #318413766)

• VSC extension 0.1.2 release

• Fix CLI command docs

• Allow submitting bugs from VSC

• Document `compdb_gen_cmd`

• Improve VSC extension UX

pw_log

The Python API of the log decoder now accepts a logging.Logger or logging.LoggerAdapter instance as the default device logger. Previously it only accepted logging.Logger.

• Let Device accept logger adapter

pw_log_zephyr

• Add missing include for tokenized logging

pw_multibuf

• Add soong support

pw_protobuf

• Fix bool overflow (issue #318732334)

• Fix nullptr dereference in fuzz test (issue #314829525)

• Don’t crash on invalid field number (issue #314803709)

• Fix conflict in messages with fields named ‘other’

• Properly fuzz nested encoders/decoders (issue #314803709)

• Fully qualify message namespace

pw_rpc

The new PW_RPC_METHOD_STORES_TYPE config option provides a way at runtime to determine a method’s type. This is useful when implementing a translation layer from another RPC system. Most Pigweed projects won’t need this feature so it’s disabled by default.

• Have Method optionally store it’s MethodType

• Run tests with completion callback config enabled

• Add some missing deps in Bazel targets (issue #318850523)

pw_stream

• Make stream adapters use reinterpret_cast (issue #314829006)

pw_system

See pw_log.

• Let Device accept logger adapter

pw_thread_stl

Using std::thread::detach() on Windows has been disallowed. When compiling with MinGW on Windows, std::thread::detach() is known to randomly hang indefinitely.

• Don’t allow std::thread::detach() on Windows (issue #317922402)

pw_tokenizer

• Fix undefined dereference in fuzz test (issue #314829057)

• Make Rust hashing function const

pw_toolchain

pw_toolchain now adds -fno-ms-compatibility to cflags on Windows. When building with clang on Windows targeting msvc, clang previously enabled a ms-compatibility mode that broke Pigweed’s macro magic.

• Remove duplicate config from Cortex-A32 toolchain

• Add -fno-ms-compatibility to cflags on Windows (issue #297542996)

pw_unit_test

• Fix sanitize(r) directive

pw_web

• Fix autoscroll when window is resized (issue #305022742)

Build

Bazel

All modules now support the injection of module configuration via label_flags.

pw_cc_library has been replaced with the Bazel-native cc_library.

• Update to Bazel 7.0.0 release version

• Add module configuration support (issue #234872811)

• Remove pw_cc_library (issue #267498492)

• Remove references to pw_cc_library (issue #267498492)

• Replace pw_cc_library with cc_library (issue #267498492)

OS support

Zephyr

You can now enable the pw_thread/sleep.h library in your Zephyr project by setting CONFIG_PIGWEED_THREAD_SLEEP=Y in your Kconfig.

• Link pw_thread.sleep with appropriate kConfig

Docs

• Add example of conditionally enabling code based on module config

• Mention pw format tool

• Update changelog

• Rework first-time setup

• Add troubleshooting section to Bazel quickstart

SEEDs

• (SEED-0001) Fix typo and formatting

• (SEED-0114) Fix Compiler Explorer link

• (SEED-0122) Claim SEED number

Dec 29, 2023

Highlights (Dec 15, 2023 to Dec 29, 2023):

• The new pw::allocator::MultiplexAllocator abstract class makes it easier to dispatch between allocators depending on an app-specific request type ID.

• pw_base64 now has initial Rust support.

• pw_malloc_freertos, a new FreeRTOS backend for pw_malloc, was added.

• The new pw::digital_io::Polarity helper enum makes it easier for backends to map logical levels to physical levels.

• The Rust macro tokenize_to_buffer! in the pw_tokenizer Rust crate now supports concatenation of format strings via the PW_FMT_CONCAT operator.

• The pw_hdlc and pw_result docs were updated to follow our latest Module docs contributor guidelines.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_allocator

The new pw::allocator::MultiplexAllocator abstract class makes it easier to dispatch between allocators depending on an app-specific request type ID.

• Add MultiplexAllocator

• Add WithMetrics interface

• Split up test utilities

pw_base64

pw_base64 now has initial Rust support. See Crate pw_base64.

• Add initial Rust support

pw_containers

• Remove DestructorHelper from queues (issue #301329862)

pw_digital_io

pw::digital_io::Polarity was added to make it easier for backends to map logical levels to physical levels.

• Add helper Polarity enum

pw_emu

• Use code-block instead of code

pw_hdlc

• Follow new module docs guidelines

pw_malloc

pw_malloc_freertos, a FreeRTOS backend for pw_malloc was added.

• Require specifying a backend in bazel build

• Add freertos backend

pw_presubmit

• Use local prettier + eslint versions

pw_result

• Rework docs to new standard

pw_rpc

• Adjust alarm_timer_test (issue #317990451)

pw_snapshot

• Clean up RISCV CpuArchitecture

• Add RISCV CpuArchitecture to metadata

pw_thread_stl

• Disable Bazel tests failing on Windows (issue #317922402)

• Disable tests failing on Windows (issue #317922402)

pw_tokenizer

The Rust macro tokenize_to_buffer! now supports concatenation of format strings via the PW_FMT_CONCAT operator.

• Support `PW_FMT_CONCAT` in `tokenize_to_buffer!`

pw_toolchain

The need to provide an unknown value for various pw_cc_toolchain fields has been removed.

• Remove “unknown” from various fields (issue #315206506)

pw_transfer

• Improve Python stream reopening and closing

pw_unit_test

• Silence ASAN error in TestInfo

pw_watch

• Build directory exclude list handling (issue #317241320)

pw_web

• Add state UI unit tests (issue #316218222)

SEEDs

• Add facilitators to metadata and generated table

• (SEED-0105) Use code-block instead of code

Dec 15, 2023

Highlights (Dec 1, 2023 to Dec 15, 2023):

• We started implementing our new async API, pw_async2.

• We deprecated the use of gtest/gtest.h header paths for tests intended to build against pw_unit_test. See pw_unit_test for details.

  Note

  All the commits titled Use unit test framework in the Dec 15, 2023 update are related to this change.

• The pw_alignment and pw_emu docs have been updated to follow our latest Module docs contributor guidelines.

• pw_system now supports an extra logging channel.

• pw_toolchain_bazel has a new get started guide.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_alignment

• Follow the new docs guidelines

pw_allocator

• Fix metric disabling

• Add support for fuzzing Allocator implementations

• Use unit test framework

pw_analog

• Use unit test framework

pw_async2

We started implementing our new async API, pw_async2.

• Implement initial async API

pw_base64

• Use unit test framework

pw_blob_store

• Use unit test framework

pw_bluetooth

• Add LE Read Buffer Size [v2] command complete event (issue #311639040)

• Use unit test framework

• Fix LEExtendedCreateConnectionCommandV1 data interleaving (issue #305976440)

• Fix ExtendedCreateConnectionV1 (issue #305976440)

• Add new HCI definition (issue #311639690)

• Re-format emboss files

pw_bluetooth_sapphire

• Read ISO data buffer info on startup (issue #311639040)

• LE Read Buffer Size [v2] (issue #311639040)

• Add LE Set Host Feature (issue #311639040)

• Update name of ISO host support bit (issue #311639040)

• Fix BrEdrConnectionManager.Inspect test (issue #42086629)

pw_build

• Fix use of TARGET_COMPATIBLE_WITH_HOST_SELECT in external repo

pw_bytes

• Use unit test framework

pw_checksum

• Use unit test framework

pw_chrono

• Use unit test framework

pw_cli

You can now disable the printing of the banner by setting PW_ENVSETUP_QUIET or PW_ENVSETUP_NO_BANNER.

• Allow banner to be suppressed

pw_console

• Disable private attr auto-completion

pw_containers

• Fix missing include

• Fix IntrusiveList::Item move assignment test (issue #303634979)

• Add missing dep for IntrusiveList test

pw_digital_io

• Use unit test framework

pw_docgen

We updated the docs server to use native hot reloading.

• Update Pigweed Live schedule

• Add new docs server

pw_emu

We’re handling QEMU startup errors more gracefully now.

• Better handling for startup errors (issue #315868463)

• qemu: Improve the QMP handshake handling (issue #315516286)

• Link all the docs to each other

• Update docs to follow new guidelines

pw_env_setup

The upstream Pigweed bootstrap script now runs npm install. We worked on native macOS support that doesn’t rely on Rosetta. Use the --disable-rosetta flag to try it out. Note that the work isn’t complete yet.

• Run npm install on bootstrap

• Remove “untested” warning

• Use ARM protoc version on ARM Macs (issue #315998985)

• Fix typo in error message

• Add flag to disable Rosetta (issue #315998985)

• Retrieve armgcc for ARM Macs (issue #315998985)

• Change case of armgcc version (issue #315998985)

• Roll cipd client

• Bump executing Python package

pw_file

• Use unit test framework

pw_format

Format strings can now be built by macros at compile-time by specifying the format string as a set of string literals separated by the custom PW_FMT_CONCAT keyword.

• Allow format strings to be composed at compile time

pw_fuzzer

• Fix ambiguous reference to ContainerOf

pw_hdlc

• Use unit test framework

pw_hex_dump

• Use unit test framework

pw_i2c

• Use unit test framework

pw_ide

pw_ide now handles additional clang toolchains if your project specifies one that’s different from the one provided by Pigweed. We also shipped several UX improvements to the Visual Studio Code extension.

• Add command to build VSC extension

• Remove VSIX installation stuff

• Don’t warn on missing extensions.json

• Alpha-sort the list of targets in VSC

• Auto-run build system command

• Update VSC Python config

• Fix condition for Windows platform

• Fix for clang installed to project dir (issue #314693384)

pw_kvs

• Use unit test framework

pw_libc

• Use unit test framework

pw_log

• Use unit test framework

pw_malloc

• Use unit test framework

pw_metric

• Use unit test framework

pw_perf_test

• Refactor event handler types

• Use unit test framework

pw_presubmit

• Add LUCI_CONTEXT to ctx

• Merge some of the “misc” checks

• Better support downstream GnGenNinja use (issue #314818274)

• Automatically compute trim_prefix (issue #282164634)

pw_random

• Use unit test framework

pw_result

• Use unit test framework

pw_rust

• Remove excess newline in doc command line

pw_snapshot

• Use unit test framework

pw_status

• Docs tweak

pw_string

• Fix string_test build error under new clang revision (issue #315190328)

• Add missing include (issue #314130408)

pw_symbolizer

• Fix symbolizer_test (issue #315190328)

pw_system

We added an extra logging channel.

• Support extra logging channel (issue #315540660)

pw_thread

• Use unit test framework

pw_tls_client

• Use unit test framework

pw_tokenizer

• Mark `pw_tokenizer_core` as `no_std`

pw_toolchain

The Arm GCC toolchain now uses pw_toolchain_bazel.

• Move ARM toolchain to new API (issue #309533028)

• Use action configs from LLVM tool repo (issue #311257445)

pw_toolchain_bazel

Support for additional_files was added to reduce *_files boilerplate. We added a new get started guide.

• Fix naming in docs

• Add misc_files group (issue #305737273)

• Add automagic toolchain file collection (issue #305737273)

• Add getting started guide (issue #309533028)

• Remove legacy tool API

• Remove deprecated API (issue #309533028)

• Rename build file templates part 2/2

pw_trace

• Use unit test framework

pw_transfer

We added support for setting different timeouts for clients and servers. See PW_TRANSFER_DEFAULT_MAX_CLIENT_RETRIES and PW_TRANSFER_DEFAULT_MAX_SERVER_RETRIES in Module Configuration Options.

• Remove small hardcoded timeout in proxy_test (issue #315459788)

• Allow setting different timeouts for client and server

• Update integration test documentation (issue #250947749)

pw_unit_test

We deprecated use of gtest/gtest.h header paths for tests intended to build against pw_unit_test. Historically, we supported using the gtest/gtest.h include path to support compiling a test as either a pw_unit_test or with the full GoogleTest on larger targets like desktop. However, this created a problem since pw_unit_test only implements a subset of the GoogleTest API. With the new approach, we require tests that are intended to compile on devices to directly include pw_unit_test/framework.h. In cases where GoogleTest is available, that header will redirect to GoogleTest.

• Add compatibility in bazel (issue #309665550)

• Use googletest backend as a dep (issue #315351886)

• Fix building fuzztests with cmake

• Use unit test framework

• Create facade’s header (issue #309665550)

pw_varint

• Use unit test framework

pw_web

• Handle unrequested responses after call_id changes

• Add support for call_id in RPC calls

• Add Mocha and Jest global vars to ESLint

• Switch to pre-made subset of icon fonts (issue #287270736)

Build

• Set Zephyr toolchain to llvm in presubmit

Targets

• Point deprecated flag to new backend

• (stm32f429i_disc1) Fix test runner

Language support

• (Python) Remove references to non-existing setup.py

OS support

• (Zephyr) Remove unecessary toolchain downloads & filter invalid targets

Docs

• Remove inaccurate #include statements (issue #295023422)

• Add Bazel code coverage TODO (issue #304833225)

• Add sort by alignment to size optimizations

• Fix build command typo

• Update changelog

SEEDs

• Always use build metadata titles in index table

• (SEED-0001) Add section about SEEDs & code changes

• (SEED-0001) Update number selection guidance

• SEED-0117) Open for comments

• (SEED-0121) Claim SEED number

Miscellaneous

• Fix formatting after clang roll

Dec 1, 2023

Highlights (Nov 17, 2023 to Dec 1, 2023):

• We now have an auto-generated SEED Index that shows you the current status of all SEEDs.

• We’ve started implementing a Rust API for pw_log.

• The pw_alignment, pw_perf_test, and pw_status docs were refactored to follow our latest Module docs contributor guidelines.

Active SEEDs

Help shape the future of Pigweed! Please visit SEED Index and leave feedback on the RFCs (i.e. SEEDs) marked Open for Comments.

Modules

pw_alignment

The docs were updated to follow our new Module docs contributor guidelines.

• Follow the new docs guidelines

pw_allocator

Utilities were added that make it easier to write tests for custom allocator implementations. The metric collection API was refactored. CMake support for heap poisoning was added.

• Fix use-after-free in ~AllocatorForTest

• Add AllocationTestHarness

• Add AllocationTestHarness

• Refactor metric collection

• Improve heap poisoning configuration

pw_bluetooth

• Add LE Set Host Feature command (issue #311639040)

• LE Request Peer SCA Complete event (issue #311639272)

• Fix LEExtendedAdvertisingReportData tx_power to be an Int

pw_bluetooth_sapphire

Migration of pw_bluetooth_sapphire into Pigweed has begun.

• Use pw_test_group for fuzzers target (issue #307951383)

• Use pw_fuzzer_group (issue #307951383)

• Add sales pitch & roadmap docs (issue #312287470)

• Add testonly to testing targets (issue #136961)

• Revert commits to get to a known working state

• Use Write instead of UncheckedWrite

• Remove now unnecessary use of std::optional (issue #311256496)

• Move LegacyLowEnergyScanner impl to base class (issue #305975969)

• Create new LowEnergyScanner polymorphic methods (issue #305975969)

• Extended scanning support, Fake(Controller|Peer) (issue #305975969)

• Remove fidl fuzzer from build (issue #307951383)

• Use explicit constructor for SmartTask

• Follow pigweed style for test files

• Add OWNERS file

• Delete unused build file (issue #307951383)

• Fix pragma_once lint (issue #307951383)

• Fix linter errors (issue #307951383)

• Fix bazel formatting (issue #307951383)

• Remove ICU from bazel build (issue #311449154)

• Refactor pw_bluetooth_sapphire & fix errors (issue #42051324)

• Update copyright headers

pw_build_info

• Fix relative paths in Python tests

pw_containers

A warning was added about pw::Vector being unsafe with non-trivially-destructible, self-referencing types. See b/313899658.

• Warn about unsafe Vector usage (issue #313899658)

pw_format

A core::fmt macro helper was added.

• Add core::fmt macro helper

pw_log

An initial Rust API has been added.

• Add initial Rust API

pw_multibuf

• Remove unused GN dep

• Remove dep on external gtest

• Make HeaderChunkRegionTracket public

• Fix cmake build file

pw_package

• Add ICU package (issue #311449154)

pw_perf_test

The docs have been refactored.

• Rename logging event handler files

• Rework docs

pw_presubmit

• Automatically compute trim_prefix (issue #282164634)

• Allow full issues.pigweed.dev urls in TODO links

• Fix TestTodoCheck.test_one_bug_legacy()

• No coverage upload for shadow builds (issue #282164634)

• Remove some unused constants

• Add is_shadow/is_prod members to context

• Refactor the coverage options (issue #282164634)

• Show diffs when parser tests fail

• Trim paths in Bazel summaries

• Correct the codesearch_host (issue #261779031)

• Correct host in coverage presubmit (issue #261779031)

• Fix coverage options (issue #261779031)

• Add Fuchsia style to todo_check_with_exceptions (issue #307951383)

• Create Sapphire presubmit step (issue #42051324)

pw_protobuf

• Add common_py_pb2 target (issue #309351244)

pw_rpc

• Initialize serde_ members to nullptr

pw_rpc_transport

• Unblock sockets when stopping (issue #309680612)

pw_sensor

• Reserve SEED for configuring sensors

• Claim SEED number for high level view

pw_status

The docs have been refactored to follow our latest Module docs contributor guidelines.

• Adopt latest docs standard

pw_string

• Add missing include

pw_system

• Load all domain tokens

• Style fixes to Python scripts

• Add missing dependency on pw_trace

pw_tokenizer

• Move entry header to a separate struct

• Catch accidental use of test macro

• Fix NULL dereference in fuzz harness

• Move ReadUint32

pw_toolchain

The Arm toolchain has been updated to use the new toolchain specified in 0113: Add modular Bazel C/C++ toolchain API. A helper for registering C/C++ toolchains in Bazel was added to enable upstream Pigweed to make changes without needing to manually update downstream projects. See Upstream Pigweed Toolchains.

• Move ARM toolchain to new API (issue #309533028)

• Use action configs from LLVM tool repo (issue #311257445)

• Add Bazel toolchain registration helper (issue #301336229)

• Merge host toolchains

• Expose non-hermetic toolchain (issue #299151946)

• Only fetch compatible Rust toolchains

pw_toolchain/arm_clang

• Reduce binary size (issue #254541584)

pw_toolchain_bazel

Support for binding tools to toolchains was added. See pw_cc_tool and pw_cc_action_config. Support for featureless sysroots was added. See pw_cc_toolchain.builtin_sysroot and pw_cc_toolchain.cxx_builtin_include_directories.

• Remove deprecated API (issue #309533028)

• Rename build file templates part 2/2

• Rename build file templates part 1/2

• Add LLVM clang tool template (issue #311257445)

• Add ARM GCC toolchain template (issue #309533028)

• Support featureless sysroots (issue #309533028)

• Mirror features to be flag sets (issue #309533028)

• Add initial pw_cc_action_config support (issue #309533028)

pw_transfer

Commands in the integration test docs were updated and docs were added that explain how to run more than one instance of tests in parallel.

• Update integration test documentation

• Set clients to transfer_v2 (issue #309686987)

• Limit to sending a single chunk in tests (issue #295037376)

• Don’t “block-network” by default (issue #311297881)

• Use StatusCode in integration tests

• Make integration_test_server testonly, fix fx roller (issue #312493408)

• Tag integration tests block-network (issue #311297881)

pw_unit_test

• Skip googletest tests if not set

pw_web

• Install Web Test Runner and dependencies

Build

Bazel

More Bazel information has been added to Module Structure.

• Add simple module configuration mechanism (issue #234872811)

• Tidy up WORKSPACE

• Rename Python toolchains (issue #310293060)

• Remove py_proto_library wrapper (issue #266950138)

• Use py_proto_library from rules_python

• Partial pw_system_console fix (issue #310307709)

Docs

The tool that we use to semi-automate these changelog updates has been added to the main Pigweed repository. Try out the tool on Changelog updates and see //docs/_static/js/changelog.js to view its implementation.

• Gerrit code coverage documentation (issue #282164634)

• Move copyright header info to style guide

• Document the Test footer

• Add changelog update instructions and tool

• Update changelog

SEEDs

We now have an auto-generated SEED Index that shows you the current status of all SEEDs.

• Generate the SEED index table

• (SEED-0114) Update status; format header in table

• (SEED-0114) Channels

• (SEED-0118) Claim SEED number

• (SEED-0118) Claim SEED number

Third party

• Add GN rules for ICU (issue #311449154)

Nov 15, 2023

Highlights (Nov 02, 2023 to Nov 15, 2023):

• The API for writing proc macros with pw_format was simplified.

• pw_emu added a command for resuming the execution of paused emulators and now has limited support for inserting environment variables into configuration entries.

• pw_ide can now output logs to files.

• pw_unit_test added support for GoogleTest’s ASSERT_OK_AND_ASSIGN, StatusIs, and IsOkAndHolds.

• Pigweed’s Mission & Philosophies are now documented.

Active SEEDs

Help shape the future of Pigweed! Please leave feedback on the following active RFCs (SEEDs):

• SEED-0114: Channels

• SEED-0115: Sensors

• SEED-0116: Sockets

Modules

pw_allocator

The ...Unchecked methods have been removed from the pw::allocator::Allocator interface and the NVI-style Do... methods have been modified to take Layout parameters.

• Update interface based on final SEED-0110 design

• Refactor test support and example allocator (issue #306686936)

pw_analog

• Mark libs as test only in bazel (issue #309665550)

pw_console

SocketClient has been updated to support both IPv4 and IPv6 addresses in addition to Unix sockets.

• Add docs banner

• Improve SocketClient addressing

pw_emu

There is now limited supported for inserting environment variable values into configuration entries. A command for resuming the execution of a paused emulator was added.

• Add support for substitutions in config entries (issue #308793747)

• Add resume command to CLI (issue #308793747)

• Fix CLI gdb and load commands (issue #308793747)

pw_env_setup

• Make pigweed_environment.gni content gni-relative

• Update Bazel to 7.0.0 pre-release

pw_format

The API for writing proc macros that take format strings and arguments was simplified.

• Add tests for macro helpers

• Generalize format macro handling

pw_fuzzer

• Move `Domain` from fuzztest::internal to fuzztest

• Switch oss-fuzz build to Bazel

pw_i2c

• Mark libs as test only in bazel (issue #309665550)

pw_ide

Logs can now be output to files.

• Set 3-space tabs in VS Code

• Support output to logs

• Remove redundant licence

• Remove clangd auto-restart

• Make Sphinx extensions upstream-only

• VSC extension 0.1.1 release

pw_perf_test

• Reogranize source files

pw_presubmit

• Create new fuzz program (issue #311215681)

• Add examples showing how to create formatters

• Correct coverage ref (issue #279161371)

pw_stream

• Fix use of shutdown on Windows (issue #309680612)

pw_system

• Add tracing to the demo system

pw_system_demo

• Add clang to default stm32f4 build (issue #301079199)

pw_tokenizer

• Add Java to supported languages list

pw_toolchain

• Set alwayslink = 1 when using –wrap

• Add objdump

pw_toolchain_bazel

Core building blocks from the 0113: Add modular Bazel C/C++ toolchain API plan were implemented: pw_cc_flag_set and pw_cc_flag_group.

• Introduce pw_cc_flag_set and pw_cc_flag_group (issue #309533028)

pw_trace_tokenized

• Add a transfer based trace service

pw_transfer

There’s been a concerted effort to reduce pw_transfer test flakiness.

• Limit data sent in handler clear test (issue #297355578)

• Limit data sent in manual cancel test

• Use project-absolute imports for test fixture (issue #310038737)

• Prevent accidental timeouts in unit tests

pw_unit_test

The Expectations and Assertions APIs were documented. Support for GoogleTest’s ASSERT_OK_AND_ASSIGN, StatusIs, and IsOkAndHolds was added.

• Document ASSERT_ and EXPECT_ macros

• Include the right gmock header (issue #309665550)

• Mark libs as test only in bazel (issue #309665550)

• Support *_NEAR, *_FLOAT_EQ, *_DOUBLE_EQ

• Allow googletest_test_matchers_test to run

• Add more googletest test matchers

• Add googletest test matchers

pw_watch

Support for httpwatcher was removed because it’s not supported on modern versions of Python.

• Remove httpwatcher support (issue #304603192)

pw_web

The log viewer has been polished and testing has been enhanced.

• Fix LogViewControls responsive behavior (issue #308993282)

• Resume autoscroll with clear logs event

• Fix clear logs due to error thrown handling input text

• Add manual testing page in docs (issue #288587657)

Build

• Update the default C++ standard

Bazel

• Upgrade nanopb version

• Update comment

• Set –incompatible_default_to_explicit_init_py (issue #266950138)

• Make pw_cc_library an alias for cc_library (issue #267498492)

• Don’t disable use_header_modules (issue #267498492)

Targets

• (stm32f429i_disc1_stm32cube) Update TODO

Language support

• (Python) Update constraint.list

• (Python) Upgrade parameterized package

Docs

A document about Pigweed’s Mission & Philosophies was added. The style guide was split into multiple pages.

• Update Pigweed Live dates

• Add mission & philosophies

• Add Contribution Standards section

• Add details to codependent docs

• Update changelog (issue #292247409)

• Split the style guide: Doxygen & Sphinx

• Split the style guide: C++

• Split the style guide: commit style

SEEDs

• (SEED-0110) Correct status

• (SEED-0110) Memory Allocation Interfaces

• (SEED-0113) Add modular Bazel C/C++ toolchain API

Nov 3, 2023

Highlights (Oct 19, 2023 to Nov 3, 2023):

• A lot more of the pw::multibuf::Chunk API was implemented.

• pw_format is a new module dedicated to Rust format string parsing.

• The tokenizer prefix is now configurable via PW_TOKENIZER_NESTED_PREFIX_STR.

• References to C++14 have been removed throughout the codebase. Pigweed no longer supports C++14; C++17 or newer is required.

• The upstream Pigweed GN build is now more isolated so that downstream projects have less conflicts when importing Pigweed into their existing GN build.

• Build configuration is moving away from Bazel macros like pw_cc_library and towards the toolchain configuration so that downstream projects can have full control over how Pigweed libraries are built.

• New guidelines for authoring module docs have been published at Module docs contributor guidelines. pw_string is now an example of a “golden” module docs set that follows the new guidelines. Please leave feedback on the new guidelines (and module docs updated to follow the guidelines) in issue #309123039.

Active SEEDs

Help shape the future of Pigweed! Please leave feedback on the following active RFCs (SEEDs):

• SEED-0103: pw_protobuf Object Model

• SEED-0106: Project Template

• SEED-0110: Memory Allocation Interfaces

• SEED-0113: Modular Bazel C/C++ Toolchain API

• SEED-0114: Channels

• SEED-0115: Sensors

• SEED-0116: Sockets

Modules

pw_allocator

The docs now have an auto-generated size report. pw::allocator::SplitFreeListAllocator has a new blocks() method for getting the range of blocks being tracked. The class was also refactored to use the existing Block API. The Block API itself was refactored to encode offsets and flags into fields.

• Add size reporting

• Return Range from SplitFreeListAllocator

• Refactor SplitFreeListAllocator to use Block

• Refactor Block to use encoded offsets

pw_arduino_build

• STM32 Core fixes

pw_assert

• Update print_and_abort backend formatting

pw_bluetooth

More Emboss definitions were added.

• Add TODO for issue 308794058 (issue #308794058)

• Remove anonymous entry in LEPeerAddressTypeNoAnon

• Separate LEAddressType and LEExtendedAddressType

• Define LEExtendedCreateConnectionV1 Emboss structure (issue #305976440)

• Define LEEnhancedConnectionCompleteSubeventV1 (issue #305976440)

• Remove padding from Emboss command definitions

pw_build

Pigweed used to inject a selection of recommended configs into every pw_* C/C++ target in the GN build. These were previously only possible to remove with the remove_configs argument. These configs are now bundled with toolchains instead, and if you don’t use a Pigweed-style toolchain you’ll no longer need to find ways to strip the default configs from Pigweed build rules. More importantly, this changes makes Pigweed’s recommended configs behave identically to other toolchain configs, and they’re now more clearly part of GN toolchain definitions. This change is transparent to most projects, but some Pigweed customers have been asking for this for a while.

The empty_cc_library Bazel utility was added.

• Add empty_cc_library

• Remove pw_build_default_configs_in_toolchain

• Apply pigweed_default_configs in toolchain (issue #260111641)

• Fix blob attribute ordering

• Only use -Wextra-semi on C++ files with GCC (issues #301262374, #301262374)

• Silence Windows-specific warnings

pw_bytes

A new _b literal was added to make it easier to create bytes for tests and constants.

• Add _b suffix for byte literals

pw_containers

The reference docs for the variable length entry queue API in C and Python were updated.

• Update VariableLengthEntryQueue size functions; cleanup

pw_digital_io_mcuxpresso

• Remove RT595 size def

pw_doctor

• Trivial linter fixes

pw_emu

• renode: Show more details when failing to connect (issue #307736513)

pw_env_setup

pip has been pinned to 23.2.1 and pip-tools to 7.3.0 to prevent dependency resolution problems.

• Pin pip and pip-tools

• Update protoc to 2@24.4 (issue #306461552)

pw_format

pw_format is a new module dedicated to Rust format string parsing.

• Correct crate name in docs

• Move Rust format string parsing into its own module

pw_fuzzer

• Inline NonOkStatus()

• Fix instrumentation config

pw_hdlc

Using read callbacks in RpcClient is no longer accepted and the use of CancellableReader is now enforced because it provides a safe and clean shutdown process.

• Enforce use of CancellableReader (issue #301496598)

pw_libcxx

pw_libcxx is a new module that provides libcxx symbols and will eventually facilitate pulling in headers as well.

• Add pw_libcxx library

pw_log

A Bazel label flag was added to Bazel to avoid circular dependencies.

• Enable sandboxing for pigweed genrules (issue #307824623)

• Introduce backend_impl label flag (issue #234877642)

pw_multibuf

A lot more of the pw::multibuf::Chunk API was implemented.

• Add basic MultiBuf operations

• Add Chunk::Merge

• Fix TrackingAllocatorWithMemory UAF

• Add module and Chunk implementation

pw_package

• Use mirror for stm32cube (issue #278914999)

• Fix Zephyr URL

pw_presubmit

A CSS formatter was added.

• Add basic CSS formatter (issue #308948504)

• Kalypsi-based coverage upload (issue #279161371)

• Handle missing upstream better (issue #282808936)

• Trivial linter fixes

pw_protobuf

• Enable sandboxing for pigweed genrules (issue #307824623)

pw_rpc

pw::rpc::SynchronousCallFor() now supports DynamicClient.

• Update Java service error with tip (issue #293361955)

• Support DynamicClient with SynchronousCallFor API

pw_string

The docs were updated to match the new Module docs contributor guidelines.

• Docs tweaks

pw_sys_io

Backends that depend on default_putget_bytes were updated to express the dependency.

• Fix Bazel backends

pw_system

See pw_hdlc for an explanation of the CancellableReader change.

• Enforce use of CancellableReader (issue #301496598)

pw_tls_client

• Update to new boringssl API

pw_tokenizer

The tokenizer prefix is now configurable via PW_TOKENIZER_NESTED_PREFIX_STR.

• Enable sandboxing for pigweed genrules (issue #307824623)

• Let tokenizer prefix be configurable

pw_toolchain

You can now set the dir_pw_third_party_builtins GN var to your compiler-rt/builtins checkout to enable buildings LLVM builtins from source instead of relying on a shipped libgcc.

• Apply pigweed_default_configs in toolchain (issue #260111641)

• Build compiler-rt builtins to replace libgcc

pw_unit_test

• Pass verbose flag to TestRunner

pw_web

• Limit component rerendering (issue #307559191)

Build

References to C++14 have been removed throughout the codebase. Pigweed no longer supports C++14; C++17 or newer is required.

• Drop C++14 compatibility from the build and docs

Bazel

Build configuration is moving away from Bazel macros like pw_cc_library and towards the toolchain configuration so that downstream projects can have full control over how Pigweed libraries are built.

• Move Kythe copts to toolchain configuration (issue #267498492)

• Move warnings to toolchain configuration (issue #240466562)

• Silence warnings from external code (issue #300330623)

• stm32cube support

• Remove most copts from pw_cc_library macro (issue #267498492)

Targets

pw_assert_BACKEND for host was set to print_and_abort_check_backend to enable compatibility with GoogleTest death tests.

• (host) Change pw_assert_BACKEND

OS support

• (zephyr) Update checkout to v3.5

Docs

New guidelines for authoring module docs have been published at Module docs contributor guidelines. pw_string is now an example of a “golden” module docs set that follows the new guidelines. Please leave feedback on the new guidelines (and module docs updated to follow the guidelines) in issue #309123039.

There’s now a definition for Facade in the glossary.

• Update module docs authoring guidelines

• Fix nav and main content scrolling (issue #303261476)

• Add udev instructions to Bazel Get Started

• Add information on the experimental repo to contributing.rst

• Mention command for updating Py dep hashes

• Define facade in glossary

• Remove symlinks to files that were removed

• Mention upstream development guide in contributor guidelines

• Move all images out of the repo

• Update changelog (issue #292247409)

• Move CoC to Contributors section of sitenav

SEEDs

• (SEED-0107) Update SEED references; fix typo

• (SEED-0112) Async Poll Model

• (SEED-0115) Fix link

• (SEED-0116) Claim SEED number

Third party

• (nanopb) Detect protoc updates

Oct 20, 2023

Highlights (Oct 5, 2023 to Oct 20, 2023):

• pw_emu has launched! Check out pw_emu to get started. See 0108: Emulators Frontend for background.

• Tokenized log arguments are now supported. See 0105: Nested Tokens and Tokenized Log Arguments for background.

• The new pw::allocator::UniquePtr class offers a safer, simpler RAII API for allocating individual values within an allocator.

• A few SEEDs were accepted: 0105: Nested Tokens and Tokenized Log Arguments, 0109: Communication Buffers, and 0111: Make Bazel Pigweed’s Primary Build System.

• Lots of new docs, including a guide for getting started with Bazel, a conceptual explanation of facades and backends, and an eng blog post detailing Kudzu, an electronic badge that the Pigweed team made for Maker Faire 2023.

Active SEEDs

Help shape the future of Pigweed! Please leave feedback on the following active RFCs (SEEDs):

• SEED-0103: pw_protobuf Object Model

• SEED-0106: Project Template

• SEED-0110: Memory Allocation Interfaces

• SEED-0113: Modular Bazel C/C++ Toolchain API

• SEED-0114: Channels

• SEED-0115: Sensors

Modules

pw_allocator

The new pw::allocator::UniquePtr class offers a safer, simpler RAII API for allocating individual values within an allocator.

• Fix SplitFreeListAllocator region alignment

• Add UniquePtr<T>

pw_async

• Add CMake support

pw_async_basic

• Add missing include

• Fix build error when using pw_async:heap_dispatcher

pw_bluetooth

• Define LEChannelSelectionAlgorithmSubevent

• Define LEScanTimeoutSubevent (issue #265052417)

• Use $size_in_bits instead of hardcoding size

• Switch from parameterized value to determining at run time (issue #305975969)

• Fix size reports

pw_build

pw_linker_script now describes how to work with linker scripts.

• Update pw_linker_script docs

• Move pw_linker_script rule definition

pw_chre

• Remove TODOs for CHRE MacOS support

pw_cli

• Honor NO_COLOR and CLICOLOR_FORCE

• Use typing.Literal

pw_digital_io

• Add Android.bp for proto/rpc

pw_emu

The module has launched! Check out pw_emu to get started.

• renode: Increase start timeout to 120s

• Fix pid file race condition

• mock_emu: start listening before making the port available (issue #306155313)

• qemu: Force using IPv4 (issue #305810466)

• Add renode support

• Add QEMU support

• core: Let the OS terminate foreground emulator processes

• Add user APIs and the command line interface

• Add core components

• Add Emulators Frontend module boilerplate

pw_env_setup

• Allow disabling CIPD cache

• Add prpc

pw_function

• Move pw_function_CONFIG to .gni

pw_hdlc

RPC now has much more information on how to use pw_hdlc for RPC in Python.

• Update Python RPC documents

pw_i2c

• Fix accidental c++2a

• Add Android.bp for i2c proto/rpc

pw_kvs

The new FlashPartitionWithLogicalSectors variant of FlashPartition supports combining multiple physical FlashMemory sectors into a single logical FlashPartition sector.

• Add FlashPartitionWithLogicalSectors

pw_log_tokenized

Tokenized log arguments are now supported. See 0105: Nested Tokens and Tokenized Log Arguments for background.

• Add tokenized string args support to log backend

pw_log_zephyr

• Clean-up unused dependencies from TOKENIZED_LIB

pw_minimal_cpp_stdlib

• Support additional libraries

• Add Zephyr Kconfig to enable include path

pw_package

• Update boringssl commit & skip clang-tidy

• Update Emboss commit

pw_presubmit

Presubmit checks has more guidance on when to use --base and --full.

• Add note about –full and –base

pw_snapshot

• More detokenization tests

pw_spi

• Fix cmake integration

pw_sync_zephyr

• Add TimedThreadNotification::try_acquire_until

pw_system

The Device class’s constructor now accepts a logger argument that enables you to specify which logger should be used.

• Add option to pass logger to Device

pw_third_party_freertos

• Add arm_cm7_not_r0p1

pw_thread

• More detokenization tests

pw_thread_freertos

• Fix extra wakeups when detaching threads (issue #303885539)

pw_tokenizer

Integrating with Bazel / GN / CMake projects has new guidance around configuring linker scripts in Bazel.

• Expose linker_script in BUILD.bazel

pw_toolchain

• Exclude googletest from static analysis

pw_transfer

• Start the API reference (issue #299147635)

pw_web

• Reduce table cell padding (issue #305022558)

• Fix invisible jump button

• Enable manual color scheme setting (issue #301498553)

Build

• Fix pw_BUILD_BROKEN_GROUPS

• Update Android.bp (issue #277108894)

Bazel

• Don’t autodetect C++ toolchain (issue #304880653)

• Add O2 to arm_gcc toolchain (issue #299994234)

Targets

• (rp2040_pw_system) Enable time slicing

OS support

• (zephyr) Allow direct CMake inclusions

Docs

• Move CoC to Contributors section of sitenav

• Create concepts section in sitenav

• Add facades and backends page

• Add Bazel getting started tutorial

• Remove css class on Kudzu image captions

• Kudzu photos

• Refactor the getting started section

• Add sitemap

• Add hat tip for pixel doubling technique

• Start eng blog and add Kudzu page

• Add Pigweed Live directive

• Add builder viz to CI/CQ intro (issue #302680656)

• Fix link (issue #302680656)

• Add changelog highlight

• Update changelog

SEEDs

A few SEEDs were accepted and a few more started.

• (SEED-0105) Add nested tokens to pw_tokenizer and pw_log

• (SEED-0109) Communication Buffers

• (SEED-0111) Update status, add link to SEED-0113

• (SEED-0111) Make Bazel Pigweed’s Primary Build System

• (SEED-0113) Claim SEED number (Modular Bazel C/C++ Toolchain API)

• (SEED-0114) Claim SEED number (Channels)

• (SEED-0115) Clain SEED number (Sensors)

Third party

• (boringssl) Remove crypto_sysrand.cc

• (fuchsia) Copybara import

• (fuchsia) Update copybara with fit/defer.h

Miscellaneous

• Update formatting for new clang version

• Use C++20 everywhere (issue #303371098)

• (revert) Use .test convention”

• Add generated Emboss code

Oct 6, 2023

Highlights (Sep 21, 2023 to Oct 6, 2023):

• We expanded our RP2040 support. See the new pw_chrono_rp2040 and pw_digital_io_rp2040 modules.

• The new CancellableReader class in pw_hdlc is an interface for receiving RPC packets that guarantees its read process can be stopped.

• pw_rpc now automatically generates a new DynamicClient interface when dynamic allocation is enabled.

• The Python backend for pw_tokenizer now supports tokenizing strings as arguments.

• The pigweed_config mechanism in Bazel is now officially retired.

Active SEEDs

Help shape the future of Pigweed! Please leave feedback on the following active RFCs (SEEDs):

• SEED-0103: pw_protobuf Object Model

• SEED-0105: Add nested tokens and tokenized args to pw_tokenizer and pw_log

• SEED-0106: Project Template

• SEED-0109: Communication Buffers

• SEED-0110: Memory Allocation Interfaces

• SEED-0111: Make Bazel Pigweed’s Primary Build System

• SEED-0112: Async Poll Model

Modules

pw_allocator

We added a bunch of new allocator APIs! AllocatorMetricProxy is a wrapper for Allocator that tracks the number and total of current memory allocations as well as peak memory usage. LibCAllocator is an allocator that uses malloc() and free(). NullAllocator is an allocator that always fails which is useful for disallowing memory allocations under certain circumstances. SplitFreeListAllocator uses a free list to reduce fragmentation. FallbackAllocator enables you to specify primary and secondary allocators.

• Add Android.bp

• Add pool accessors

• Move Resize assertion

• Add AllocatorMetricProxy

• Add LibCAllocator

• Add NullAllocator

• Add SplitFreeListAllocator

• Add FallbackAllocator

• Generic interface for allocators

pw_analog

• Migrate MicrovoltInput to Doxygen (issue #299147635)

pw_async

• Add OWNERS file

pw_bloat

pw_size_report() has a new json_key_prefix argument which is an optional prefix for key names in JSON size reports and a new full_json_summary argument which provides more control over how much detail is provided in a JSON size report.

• Update API to allow verbose json content (issue #282057969)

pw_bluetooth

• Format Emboss files

• Update comments in HCI event defs (issue #265052417)

pw_build

• Fix path in Bazel pw_linker_script

• Expose pw_linker_script in Bazel (issue #303482154)

• Define empty configs

• Add bazel implementation of pw_cc_blob_library (issue #238339027)

• Clean up build_target.gni (issue #260111641)

• Allow add_global_link_deps to be overriden

• Expose pigweed_default_configs (issue #260111641)

• Apply -Wextra-semi to C code as well as C++

pw_chre

• Update bug numbers

pw_chrono

• Add clarification to is_nmi_safe

pw_chrono_rp2040

This module is a new pw::chrono::SystemClock backend for RP2040.

• System clock backend

pw_cli

• Update requires script

• Narrow logic around colors

pw_containers

There’s a new C implementation for VariableLengthEntryDeque which is a double-ended queue buffer that stores variable-length entries inline in a circular (ring) buffer. The old VariableLengthEntryDeque was renamed to VariableLengthEntryQueue.

• Add missing <utility> include for std::move

• Rename to VariableLengthEntryQueue

• Rename files to variable_length_entry_queue

• VariableLengthEntryDeque Entry struct

• VariableLengthEntryDeque C implementation

pw_digital_io_rp2040

This module is a new RP2040 backend for pw_digital_io.

• Implementation (issue #303255049)

pw_env_setup

We made the Pigweed bootstrap process on Windows more robust.

• Fix double bootstrap.bat failures on Windows (issue #300992566)

• Better highlight bootstrap failure

• Fix double bootstrap.bat failures on Windows (issue #300992566)

pw_hdlc

The new CancellableReader class is a new interface for receiving RPC packets that guarantees its read process can be stopped.

• Add CancellableReader (issue #294858483)

pw_i2c

• Fix docs to use MakeExpectedTransactionArray

• Add cmake integration

pw_kvs

The new FlashPartitionWithLogicalSectors C++ class supports combining multiple physical FlashMemory sectors into a single logical FlashPartition sector.

• Add FlashPartitionWithLogicalSectors

pw_libc

• Don’t implicitly link against global link_deps

pw_metric

• Make constructors constexpr

pw_minimal_cpp_stdlib

• Update to compile with stdcompat

• Namespace public/internal to module

pw_perf_test

• Gate on pw_chrono_SYSTEM_TIMER_BACKEND

pw_presubmit

• Allow dots in module part of commit message

• Use autodoc for context classes

• Allow passing kwargs to build.bazel (issue #302045722)

• No env_with_clang_vars with bazel

pw_ring_buffer

• Minor build and docs updates

pw_rpc

If dynamic allocation is enabled via PW_RPC_DYNAMIC_ALLOCATION a new DynamicClient is now generated which dynamically allocates the call object with PW_RPC_MAKE_UNIQUE_PTR.

• Generate DynamicClient that dynamically allocates call objects

• Add CancellableReader (issue #294858483)

pw_rpc_transport

• Add a test loopback service registry (issue #300663813)

pw_stream

pw_stream now has initial support for winsock2.

• Add Windows socket support

pw_sys_io_rp2040

• Renamed from pw_sys_io_pico

pw_tokenizer

The Python backend now supports nested hashing tokenization. See Tokenize nested arguments.

• Support nested hashing tokenization (python backend) (issue #278890205)

• Test for C99 support

pw_toolchain

• Add libc stub for gettimeofday, update visibility rules

• Link against pw_libc for host clang toolchains

pw_transfer

• Start the API reference (issue #299147635)

• Remove old test server (issue #234875234)

pw_unit_test

• Do not print contents of unknown objects

• Add more pw_unit_test_TESTONLY args (issue #234873207)

• Add pw_unit_test_TESTONLY build arg (issue #234873207)

pw_watch

• Add link to served docs

pw_web

• Make ongoing transfers accessible downstream

• TypeScript workarounds for disambiguation errors

• Throw error as an Error type

• Remove need for Buffer package in pw_hdlc

• Remove date-fns

Build

• Fix extended default group (issue #279161371)

• Fix `all` target in GN build

• Add an extended default group

Bazel

• Retire pigweed_config (part 3)

• Retire pigweed_config (part 2) (issue #291106264)

Docs

We started a glossary and added new docs about rollers and CI/CQ.

• Add docs on rollers (issue #302680656)

• Remove redundant auto-submit section (issue #302680656)

• Reformat CI/CQ Intro (issue #302680656)

• Move CI/CQ Intro to infra/ (issue #302680656)

• Address comments on CI/CQ intro (issue #302680656)

• Tidy up build system docs

• Fix typo

• Add CI/CQ Intro (issue #302680656)

• Add policy on incomplete docs changes

• Start the glossary

• Update changelog (issue #292247409)

• Add Doxygen @endcode guidance

SEEDs

• (SEED-0112) Fix link

Miscellaneous

pigweed.json

• Exclude patches.json from formatting (issue #232234662)

Sep 22, 2023

Highlights (Sep 07, 2023 to Sep 22, 2023):

• pw_tokenizer has new C++ methods for detokenizing Base64-encoded strings and new C functions for manually encoding tokenized messages that contain integers.

• pw::rpc::SynchronousCall now supports the use of custom response message classes.

• The C API for pw_varint got lots of ergonomic improvements.

• The new Code Reviews document outlines the upstream Pigweed code review process.

Active SEEDs

Help shape the future of Pigweed! Please leave feedback on the following active RFCs (SEEDs):

• SEED-0103: pw_protobuf Object Model

• SEED-0105: Add nested tokens and tokenized args to pw_tokenizer and pw_log

• SEED-0106: Project Template

• SEED-0109: Communication Buffers

• SEED-0110: Memory Allocation Interfaces

• SEED-0111: Future of Pigweed build systems

• SEED-0112: Async Poll Model

Modules

pw function

• Sign conversion fixes (issue #301079199)

pw perf_test

• Sign conversion fixes (issue #301079199)

pw_analog

• Migrate AnalogInput to Doxygen (issue #299147635)

pw_async

The Run*() methods of FakeDispatcher now return a boolean that indicates whether any tasks were invoked.

• Return bool from FakeDispatcher Run*() methods

pw_async_basic

release() is now only called outside of locked contexts to prevent an issue where the thread wakes up and then immediately goes back to sleep. An unnecessary 5-second wakeup has been removed from BasicDispatcher.

• release outside of lock context

• Remove unnecessary 5-second wakeup

pw_base64

The new pw::base64::IsValidChar() method can help you determine if a character is valid Base64.

• Add base64 detokenizer handler

pw_bluetooth

More Emboss definitions were added.

• Add ReadLocalSupportedCommandsCommandCompleteEvent Emboss

• Add LEReadLocalSupportedFeaturesCommandCompleteEvent

• Add ReadBufferSizeCommandComplete Emboss definition

• Add ReadBdAddrCommandCompleteEvent Emboss definition

• Add ReadLocalVersionInfoCommandCompleteEvent Emboss def

• Add LELongTermKeyRequestSubevent Emboss definition

• Add UserPasskeyNotificationEvent Emboss definition

pw_build

• Apply -Wextra-semi to C code as well as C++

pw_bytes

The AlignDown(), AlignUp(), and Padding() methods of pw_kvs have moved to pw_bytes to enable pw_allocator to use them without taking a dependency on pw_kvs.

• Move Align functions from pw_kvs

pw_checksum

• Sign conversion fixes (issue #301079199)

pw_chre

The implementation of a module that will enable to work more seamlessly with Android’s Context Hub Runtime Environment has begun.

• Update bug numbers

• Minor fixes (issue #301079509)

• Fix build rules to use paramertized paths (issue #298474212)

• Split out shared_platform

• Write our own version.cc (issue #300633363)

• Add barebones CHRE (issue #294106526)

pw_console

When invoking pw_console directly from Python, you can now provide arguments through an argparse.Namespace instead of messing with sys.argv or forking another process.

• Allow injecting args via Python call

pw_containers

MemorySanitizer has been disabled in some of the InlineDeque implementation to prevent some false positive detections of uninitialized memory reads.

• Silence MSAN false positives

pw_env_setup

Work continues on making the Windows bootstrap process more robust.

• Better highlight bootstrap failure

• Fix double bootstrap.bat failures on Windows (issue #300992566)

• Enable overriding Clang CIPD version

• PyPI version bump to 0.0.15

• Add relative_pigweed_root to pigweed.json (issue #300632028)

• Roll cipd to 0f08b927516

pw_function

The documentation has been updated for accuracy.

• Update config.h comments

• Add configurable Allocator default

• Update example to match guidelines for parameters

• Add Allocator injection

pw_fuzzer

Conditional logic around fuzzing support has been refactored to allow for dedicated targets based on specific conditions and to make it clearer exactly what configurations and dependencies are being used.

• Refactor conditional GN targets

pw_ide

• Reformat json files

• Fix clangd path on Windows

• Move VSC extension into npm package dir

pw_libc

The initial implementation work continues.

• Pull in ‘abort’

• Use .test convention

• Use underscore prefixed variables

• Add documentation for pw_libc_source_set

• Pull in ‘gmtime’

• Fix printf for newer llvm-libc commits

• Fix llvm-libc after internal assert changes

pw_log

The implementation work continues to enable an Android component to read logs from a component running the pw_log_rpc service.

• Update Android.bp to generate RPC header files (issue #298693458)

pw_log_string

• Fix the default impl to handle zero length va args

pw_package

Mirrors are now being used for various third-party dependencies.

• Use mirror for zephyrproject-rtos/zephyr (issue #278914999)

• Use Pigweed mirror for google/emboss (issue #278914999)

• Use mirror for raspberrypi/picotool (issue #278914999)

pw_polyfill

• Increase __GNUC__ for __constinit (issue #300478321)

pw_presubmit

A new JSON formatting check has been added. The missing newline check has been made more robust.

• Add JSON formatter

• Better handling of missing newlines (issue #301315329)

• Expand Bazel parser to tests

• Remove now-unnecessary flag (issue #271299438)

• Additional functions for handling gn args

• Include bazel_build in full program

pw_protobuf

• Fix “Casting…” heading level

pw_rpc

pw::rpc::SynchronousCall now supports the use of custom response message classes that set field callbacks in their constructor. See Client synchronous call wrappers.

• Refer to bug in TODO and fix format

• Support custom response messages in SynchronousCall (issue #299920227)

• Add fuzz tests

pw_stream

• Add Windows socket support

pw_string

• Fix signed integer overflow

pw_system

• Add arm_none_eabi_gcc_support

pw_thread

• Fix small typo in docs

pw_tokenizer

pw::tokenizer::Detokenizer has new DetokenizeBase64Message() and DetokenizeBase64() methods for detokenizing Base64-encoded strings. The new pw_tokenizer_EncodeInt() and pw_tokenizer_EncodeInt64() functions in the C API make it easier to manually encode tokenized messages with integers from C.

• C++ Base64 detokenization improvements

• Add base64 detokenizer handler

• C functions for encoding arguments

pw_toolchain

arm_gcc now supports Cortex-M33.

• Add missing objcopy tool to bazel toolchains (issue #301004620)

• Add cpu flags to asmopts as well

• Add cortex-m33 support to arm_gcc

pw_toolchain_bazel

• Support ar opts in pw_toolchain_features

• Add cortex-m7 constraint_value (issue #300467616)

pw_varint

The C encoding functions now have an output size argument, making them much easier to use. There’s a new macro for calculating the encoded size of an integer in a C constant expression. Incremental versions of the encode and decode functions have been exposed to support in-place encoding and decoding with non-contiguous buffers.

• C API updates

pw_web

The ProgressStats and ProgressCallback types are now exported. Styling and scrolling behavior in the log viewer has been improved.

• Remove need for Buffer package in pw_hdlc

• Remove date-fns

• Export ProgressStats, ProgressCallback types

• Add back ‘buffer’ dependency

• NPM version bump to 0.0.13

• Improve scrolling behavior (issue #298097109)

• Fix leading white spaces, scrollbar size, and filters in quotes

• NPM version bump to 0.0.12

• Fix column sizing & toggling, update UI

• Replace Map() with object in proto collection

pw_work_queue

• Don’t lock around work_notification_

• Migrate API reference to Doxygen (issue #299147635)

Build

• Update Android.bp

Bazel

• Add platform-printing aspect

• Retire pigweed_config (part 2) (issue #291106264)

• Retire pigweed_config (part 1) (issue #291106264)

• Remove -Wno-private-header from copts (issue #240466562)

• Remove bazelembedded dependency (issue #297239780)

• Move cxxopts out of bazelrc (issue #269195628)

• Use the same clang version as in GN

• Arm gcc configuration (issue #297239780)

Targets

• Fix pico_sdk elf2uf2 on Windows

• Add pw_strict_host_clang_debug_dynamic_allocation tc

Docs

The new Code Reviews document outlines the upstream Pigweed code review process.

• Add Doxygen @endcode guidance

• Clean up remaining instances of code:: (issue #300317685)

• Document code review process

• Add link to in-progress hardware targets

• Fix link title for pw_log

• Update changelog (issue #292247409)

SEEDs

• Update process document

• (SEED-0104) Display Support

• (SEED-0109) Make link externally accessible

• (SEED-0110) Claim SEED number

• (SEED-0111) Claim SEED number

• (SEED-0112) Claim SEED number

Third party

• Add public configs for FuzzTest deps

third_party/fuchsia

• Copybara import

• Update patch script and patch

• Update patch

• Support specifying the Fuchsia repo to use

third_party/pico_sdk

• Selectively disable elf2uf2 warnings (issue #300474559)

• Fix multicore source filename

Miscellaneous

• Use new TODO style

• Add toolchain team members

• Fix double bootstrap.bat failures on Windows” (issue #300992566)

Sep 8, 2023

Highlights (Aug 25, 2023 to Sep 8, 2023):

• SEED 0107: Pigweed Communications has been approved! Pigweed will adopt a new sockets API as its primary networking abstraction. The sockets API will be backed by a new, lightweight embedded-focused network protocol stack inspired by TCP/IP.

• SEED 0108: Emulators Frontend has also been approved! Coming soon, the new pw_emu module will make it easier to work with emulators.

Active SEEDs

Help shape the future of Pigweed! Please leave feedback on the following active RFCs (SEEDs):

• SEED-0103: pw_protobuf Object Model

• SEED-0104: display support

• SEED-0105: Add nested tokens and tokenized args to pw_tokenizer and pw_log

• SEED-0106: Project Template

• SEED-0109: Communication Buffers

Modules

pw_assert

We fixed circular dependencies in Bazel.

• Remove placeholder target

• Fix Bazel circular deps (issue #234877642)

• Introduce pw_assert_backend_impl (issue #234877642)

pw_bluetooth

We added Emboss definitions.

• Add SimplePairingCompleteEvent Emboss definition

• Add UserPasskeyRequestEvent Emboss definition

• Add UserConfirmationRequestEvent Emboss definition

• Use hci.LinkKey in LinkKeyNotificationEvent.link_key

• Add IoCapabilityResponseEvent Emboss definition

• Add IoCapabilityRequestEvent Emboss definition

• Add EncryptionKeyRefreshCompleteEvent Emboss definition

• Add ExtendedInquiryResultEvent Emboss definition

pw_build

• Force watch and default recipe names

pw_build_mcuxpresso

• Output formatted bazel target

pw_cpu_exception

We added Bazel support.

• bazel build support (issue #242183021)

pw_crypto

The complete pw_crypto API reference is now documented on pw_crypto.

• Add API reference (issue #299147635)

pw_env_setup

Banners should not print correctly on Windows.

• Add i2c protos to python deps

• Fix banner printing on Windows (issue #289008307)

pw_file

• Add pw_file python package

pw_function

The pw::bind_member() template is now exposed in the public API. bind_member() is useful for binding the this argument of a callable. We added a section to the docs explaining why pw::Function is not a literal.

• Explain non-literal design rationale

• Expose `bind_member`

pw_fuzzer

We refactored pw_fuzzer logic to be more robust and expanded the pw_fuzzer: Using OSS-Fuzz doc.

• Refactor OSS-Fuzz support (issue #56955)

pw_i2c

• Use new k{FieldName}MaxSize constants to get buffer size

pw_kvs

We are discouraging the use of the shorter macros because they collide with Abseil’s logging API.

• Remove usage of pw_log/shorter.h API (issue #299520256)

pw_libc

snprintf() support was added.

• Import LLVM libc’s snprintf

pw_log_string

We added more detail to pw_log_string.

• Fix the default impl to handle zero length va args

• Provide more detail in the getting started docs (issue #298124226)

pw_log_zephyr

It’s now possible to define pw_log_tokenized_HandleLog() outside of Pigweed so that Zephyr projects have more flexibility around how they capture tokenized logs.

• Split tokenize handler into its own config

pw_package

• Handle failed cipd acl checks

pw_persistent_ram

• Add persistent_buffer flat_file_system_entry

pw_presubmit

We added a reStructuredText formatter.

• Make builds_from_previous_iteration ints (issue #299336222)

• Move colorize_diff to tools

• RST formatting

pw_protobuf

max_size and max_count are now exposed in generated headers. The new proto_message_field_props() helper function makes it easier to iterate through a messages fields and properties.

• Expose max_size, max_count in generated header file (issue #297364973)

• Introduce proto_message_field_props()

• Change PROTO_FIELD_PROPERTIES to a dict of classes

• Rename ‘node’ to ‘message’ in forward_declare()

• Simplify unnecessary Tuple return type

pw_random

We’re now auto-generating the XorShiftStarRng64 API reference via Doxygen.

• Doxygenify xor_shift.h

pw_rpc

The new request_completion() method in Python enables you to send a completion packet for server streaming calls.

• Add request_completion to ServerStreamingCall python API

pw_spi

• Fix Responder.SetCompletionHandler() signature

pw_symbolizer

The LlvmSymbolizer Python class has a new close() method to deterministically close the background process.

• LlvmSymbolizer tool improvement

pw_sync

We added GenericBasicLockable.

• Add GenericBasicLockable

pw_system

pw_system now supports different channels for primary and logging RPC.

• Multi-channel configuration (issue #297076185)

pw_thread_freertos

• Add missing dep to library

pw_tokenizer

We added PW_TOKENIZE_FORMAT_STRING_ANY_ARG_COUNT and PW_TOKENIZER_REPLACE_FORMAT_STRING. We refactored the docs so that you don’t have to jump around the docs as much when learning about key topics like tokenization and token databases. Database loads now happen in a separate thread to avoid blocking the main thread. Change detection for directory databases now works more as expected. The config API is now exposed in the API reference.

• Remove some unused deps

• Simplify implementing a custom tokenization macro

• Refactor the docs to be task-focused

• Reload database in dedicated thread

• Combine duplicated docs sections

• Support change detection for directory dbs

• Move config value check to .cc file

pw_unit_test

We added testing::Test::HasFailure(), FRIEND_TEST, and << messages to improve gTest compatibility.

• Add testing::Test::HasFailure()

• Add FRIEND_TEST

• Allow <<-style messages in test expectations

pw_varint

pw_varint now has a C-only API.

• Add C-only implementation; cleanup

pw_web

Logs can now be downloaded as plaintext.

• Fix TypeScript errors in Device files

• Json Log Source example

• Enable downloading logs as plain text

• Fix UI/state bugs

• NPM version bump to 0.0.11

• Add basic bundling tests for log viewer bundle

Build

Bazel

• Fix alwayslink support in MacOS host_clang (issue #297413805)

• Fix lint issues after roll

Docs

• Fix broken links (issue #299181944)

• Recommend enabling long file paths on Windows

• Update Windows command for git hook

• Fix main content scrolling (issue #297384789)

• Update changelog (issue #292247409)

• Use code-block:: instead of code:: everywhere

• Add function signature line breaks

• Cleanup indentation

SEEDs

• SEED-0108: Emulators Frontend

Third party

• Add public configs for FuzzTest deps

• Reconfigure deps & add cflags to config

Miscellaneous

• Fix formatting with new clang version

mimxrt595_evk_freertos

• Use config_assert helper

Aug 25, 2023

Highlights (Aug 11, 2023 to Aug 25, 2023):

• pw_tokenizer now has Rust support.

• The pw_web log viewer now has advanced filtering and a jump-to-bottom button.

• The run_tests() method of pw_unit_test now returns a new TestRecord dataclass which provides more detailed information about the test run.

• A new Ambiq Apollo4 target that uses the Ambiq Suite SDK and FreeRTOS has been added.

Active SEEDs

Help shape the future of Pigweed! Please leave feedback on the following active RFCs (SEEDs):

• SEED-0103: pw_protobuf Object Model

• SEED-0104: display support

• SEED-0105: Add nested tokens and tokenized args to pw_tokenizer and pw_log

• SEED-0106: Project Template

• SEED-0108: Emulators Frontend

Modules

pw_bloat

• Fix typo in method name

pw_bluetooth

The Emboss files were refactored.

• Add SynchronousConnectionCompleteEvent Emboss definition

• Add all Emboss headers/deps to emboss_test & fix errors

• Add InquiryResultWithRssiEvent Emboss definition

• Add DataBufferOverflowEvent Emboss definition

• Add LinkKeyNotificationEvent Emboss definition

• Add LinkKeyRequestEvent emboss definition

• Remove unused hci emboss files

• Add RoleChangeEvent emboss definition

• Add missing test dependency

• Add new hci subset files

pw_build

The pw_build docs were split up so that each build system has its own page now. The new output_logs flag enables you to not output logs for pw_python_venv.

• Handle read-only files when deleting venvs

• Split build system docs into separate pages

• Use pw_toolchain_clang_tools

• Add missing pw_linker_script flag (issue #296928739)

• Fix output_logs_ unused warning (issue #295524695)

• Don’t include compile cmds when preprocessing ldscripts

• Add pw_python_venv.output_logs (issue #295524695)

• Increase size of test linker script memory region

• Add integration test metadata

pw_cli

• Default change pw_protobuf default (issue #266298474)

pw_console

• Update web viewer to use pigweedjs

pw_containers

• Silence MSAN false positive in pw::Vector

pw_docgen

Docs builds should be faster now because Sphinx has been configured to use all available cores.

• Remove top nav bar

• Parallelize Sphinx

pw_env_setup

Sphinx was updated from v5.3.0 to v7.1.2. We switched back to the upstream Furo theme and updated to v2023.8.19. The content of pigweed_environment.gni now gets logged. There was an update to ensure that arm-none-eabi-gdb errors propagate correctly. There is now a way to override Bazel build files for CIPD repos.

• Upgrade sphinx and dependencies for docs

• Upgrade sphinx-design

• Copy pigweed_environment.gni to logs

• arm-gdb: propagate errors

• arm-gdb: exclude %VIRTUAL_ENV%Scripts from search paths

• Add ability to override bazel BUILD file for CIPD repos

pw_function

• Rename template parameter

pw_fuzzer

• Add test metadata

pw_hdlc

A new close() method was added to HdlcRpcClient to signal to the thread to stop.

• Use explicit logger name

• Mitigate errors on Python background thread (issue #293595266)

pw_ide

A new --install-editable flag was added to install Pigweed Python modules in editable mode so that code changes are instantly realized.

• Add cmd to install Py packages as editable

• Make VSC extension run on older versions

pw_perf_test

• Add test metadata

pw_presubmit

pw_presubmit now has an ESLint check for linting and a Prettier check for formatting JavaScript and TypeScript files.

• Add msan to OTHER_CHECKS (issue #234876100)

• Upstream constraint file output fix

• JavaScript and TypeScript lint check

• Apply TypeScript formatting

• Use prettier for JS and TS files

pw_rpc

A request_completion() method was added to the ServerStreamingCall Python API. A bug was fixed related to encoding failures when dynamic buffers are enabled.

• Add request_completion to ServerStreamingCall python API

• Various small enhancements

• Remove deprecated method from Service

• Prevent encoding failure when dynamic buffer enabled (issue #269633514)

pw_rpc_transport

• Add simple_framing Soong rule

pw_rust

• Update rules_rust to 0.26.0

pw_stm32cube_build

• Windows path fixes

pw_stream

Error codes were updated to be more accurate and descriptive.

• Use more appropriate error codes for Cursor

pw_stream_uart_linux

Common baud rates such as 9600, 19200, and so on are now supported.

• Add support for baud rates other than 115200

pw_sync

Tests were added to make sure that pw::sync::Borrowable works with lock annotations.

• Test Borrowable with Mutex, TimedMutex, and InterruptSpinLock (issue #261078330)

pw_system

The pw_system.device.Device Python class can now be used as a context manager.

• Make pw_system.device.Device a context manager

pw_tokenizer

pw_tokenizer now has Rust support. The pw_tokenizer C++ config API is now documented at Configuration and the C++ token database API is now documented at Token databases. When creating a token database, parent directories are now automatically created if they don’t already exist. PrefixedMessageDecoder has been renamed to NestedMessageDecoder.

• Move config value check to .cc file

• Create parent directory as needed

• Rework pw_tokenizer.detokenize.PrefixedMessageDecoder

• Minor binary database improvements

• Update binary DB docs and convert to Doxygen

• Deprecate tokenizer buffer size config

• Fix instance of -Wconstant-logical-operand

• Add Rust support

pw_toolchain

A new Linux host toolchain built using pw_toolchain_bazel has been started. CIPD-provided Rust toolchains are now being used.

• Link against system libraries using libs not ldflags

• Use %package% for cxx_builtin_include_directories

• Extend documentation for tool prefixes

• Add Linux host toolchain (issue #269204725)

• Use CIPD provided Rust toolchains

• Switch macOS to use builtin_sysroot

• Add cmake helpers for getting clang compile+link flags

pw_unit_test

run_tests() now returns the new TestRecord dataclass which provides more detailed information about the test run. SetUpTestSuit() and TearDownTestSuite() were added to improve GoogleTest compatibility.

• Add TestRecord of Test Results

• Reset static value before running tests (issue #296157327)

• Add per-fixture setup/teardown

pw_web

Log viewers are now drawn every 100 milliseconds at most to prevent crashes when many logs arrive simultaneously. The log viewer now has a jump-to-bottom button. Advanced filtering has been added.

• NPM version bump to 0.0.11

• Add basic bundling tests for log viewer bundle

• Limit LogViewer redraws to 100ms

• Add jump to bottom button, fix UI bugs and fix state bugs

• Implement advanced filtering

• Remove object-path dependency from Device API

• Log viewer toolbar button toggle style

• Log-viewer line wrap toggle

Targets

targets

A new Ambiq Apollo4 target that uses the Ambiq Suite SDK and FreeRTOS has been added.

• Ambiq Apollo4 support

Language support

Python

• Upgrade mypy to 1.5.0

• Upgrade pylint to 2.17.5

Docs

Doxygen-generated function signatures now present each argument on a separate line. Tabbed content looks visually different than before.

• Use code-block:: instead of code:: everywhere

• Add function signature line breaks

• Cleanup indentation

• Remove unused myst-parser

• Use sphinx-design for tabbed content

• Update changelog

SEEDs

SEED-0107 (Pigweed Communications) was accepted and SEED-0109 (Communication Buffers) was started.

• Update protobuf SEED title in index

• Update status to Accepted

• Pigweed communications

• Claim SEED number

Miscellaneous

Build

• Make it possible to run MSAN in GN

soong

• Remove host/vendor properties from defaults

Aug 11, 2023

Highlights (Jul 27, 2023 to Aug 11, 2023):

• We’re prototyping a Pigweed extension for VS Code. Learn more at Code Editor Support.

• We added pw_toolchain_bazel, a new LLVM toolchain for building with Bazel on macOS.

• We are working on many docs improvements in parallel: auto-generating rustdocs for modules that support Rust (example), refactoring the pw_tokenizer docs, migrating API references to Doxygen, fixing longstanding docs site UI issues, and more.

Active SEEDs

Help shape the future of Pigweed! Please leave feedback on the following active RFCs (SEEDs):

• SEED-0103: pw_protobuf Object Model

• SEED-0104: display support

• SEED-0105: Add nested tokens and tokenized args to pw_tokenizer and pw_log

• SEED-0106: Project Template

• SEED-0107: Pigweed communications

• SEED-0108: Emulators Frontend

Modules

pw_alignment

• Fix typos

pw_analog

Long-term, all of our API references will be generated from header comments via Doxygen. Short-term, we are starting to show header files directly within the docs as a stopgap solution for helping Pigweed users get a sense of each module’s API. See pw_analog for an example.

• Include header files as stopgap API reference (issue #293895312)

pw_base64

We finished migrating the pw_random API reference to Doxygen.

• Finish Doxygenifying the API reference

• Doxygenify the Encode() functions

pw_boot_cortex_m

• Allow explict target name

pw_build

We added a log_build_steps option to ProjectBuilder that enables you to log all build step lines to your screen and logfiles.

• Handle ProcessLookupError exceptions

• ProjectBuilder log build steps option

• Fix progress bar clear

pw_cli

We polished tab completion support.

• Zsh shell completion autoload

• Make pw_cli tab completion reusable

pw_console

We made copy-to-clipboard functionality more robust when running pw_console over SSH.

• Set clipboard fallback methods

pw_containers

We updated filteredview constructors and migrated the FilteredView API reference to Doxygen.

• Doxygenify pw::containers::FilteredView

• Support copying the FilteredView predicate

pw_docgen

At the top of pages like pw_tokenizer there is a UI widget that provides information about the module. Previously, this UI widget had links to all the module’s docs. This is no longer needed now that the site nav automatically scrolls to the page you’re on, which allows you to see the module’s other docs.

• Remove the navbar from the module docs header widget (issue #292273650)

pw_env_setup

We made Python setup more flexible.

• Add clang_next.json (issue #295020927)

• Pip installs from CIPD

• Include Python packages from CIPD

• Remove unused pep517 package

• Use more available Python 3.9 (issue #292278707)

• Update Bazel to 2@6.3.0.6

pw_ide

We are prototyping a pw_ide extension for VS Code.

• Restore stable clangd settings link

• Add command to install prototype extension

• Prototype VS Code extension

pw_interrupt

We added a backend for Xtensa processors.

• Add backend for xtensa processors

• Tidy up target compatibility (issue #272090220)

pw_log_zephyr

We encoded tokenized messages to pw::InlineString so that the output is always null-terminated.

• Fix null termination of Base64 messages

pw_presubmit

We increased LUCI support and updated the #pragma once check to look for matching #ifndef and #define lines.

• Fix overeager format_code matches

• Exclude vsix files from copyright

• Clarify unicode errors

• Upload coverage json to zoss (issue #279161371)

• Add to context tests

• Add patchset to LuciTrigger

• Add helpers to LuciContext

• Update Python vendor wheel dir

• Add summaries to guard checks (issue #287529705)

• Copy Python packages

• Add ifndef/define check (issue #287529705)

pw_protobuf_compiler

We continued work to ensure that the Python environment in Bazel is hermetic.

• Use hermetic protoc (issue #294284927)

• Move reference to python interpreter (issue #294414535)

• Make nanopb hermetic (issue #293792686)

pw_python

We fixed bugs related to requirements.txt files not getting found.

• setup.sh requirements arg fix path

• setup.sh arg spaces bug

pw_random

We continued migrating the pw_random API reference to Doxygen.

• Doxygenify random.h

pw_rpc

We made the Java client more robust.

• Java client backwards compatibility

• Avoid reflection in Java client (issue #293361955)

• Use hermetic protoc (issue #294284927)

• Improve Java client error message for missing parser() method

pw_spi

We continued work on implementing a SPI responder interface.

• Responder interface definition

pw_status

We fixed the nesting on a documentation section.

• Promote Zephyr heading to h2

pw_stream

We added remaining(), len(), and position() methods to the Cursor wrapping in Rust.

• Add infalible methods to Rust Cursor

pw_stream_shmem_mcuxpresso

We added the pw_stream_shmem_mcuxpresso backend for pw_stream.

• Add shared memory stream for NXP MCU cores (issue #294406620)

pw_sync_freertos

• Fix ODR violation in tests

pw_thread

• Fix test_thread_context typo and presubmit

pw_tokenizer

We added support for unaligned token databases and continued the 0102: Consistent Module Documentation update of the pw_tokenizer docs.

• Separate API reference and how-to guide content

• Polish the sales pitch

• Support unaligned databases

• Move the basic overview into getting started

• Move the case study to guides.rst

• Restore info that get lost during the SEED-0102 migration

• Use the same tagline on every doc

• Replace savings table with flowchart

• Ignore string nonliteral warnings

pw_toolchain

We fixed a regression that made it harder to use Pigweed in an environment where pw_env_setup has not been run and fixed a bug related to incorrect Clang linking.

• Optionally depend on pw_env_setup_CIPD_PIGWEED (issue #294886611)

• Prefer start-group over whole-archive (issue #285357895)

pw_toolchain_bazel

We added a an LLVM toolchain for building with Bazel on macOS.

• LLVM toolchain for macOS Bazel build (issue #291795899)

pw_trace_tokenized

We made tracing more robust.

• Replace trace callback singletons with dep injection

pw_transfer

We made integration tests more robust.

• Fix use-after-destroy in integration test client (issue #294101325)

• Fix legacy binary path (issue #294284927)

• Mark linux-only Bazel tests (issue #294101325)

pw_web

We added support for storing user preferences in localStorage.

• Fix TypeScript warnings in web_serial_transport.ts

• Add state for view number, search string, and columns visible

• Fix TypeScript warnings in transfer.ts

• Fix TypeScript warnings

• Remove dependency on ‘crc’ and ‘buffer’ NPM packages

Build

We made the Bazel system more hermetic and fixed an error related to not finding the Java runtime.

• Do not allow PATH leakage into Bazel build (issue #294284927)

• Use remote Java runtime for Bazel build (issue #291791485)

Docs

We created a new doc (Code Editor Support) that explains how to improve Pigweed support in various IDEs. We standardized how we present call-to-action buttons on module homepages. See pw_tokenizer for an example. We fixed a longstanding UI issue around the site nav not scrolling to the page that you’re currently on.

• Add call-to-action buttons

• Update module items in site nav

• Add editor support doc

• Delay nav scrolling to fix main content scrolling (issue #292273650)

• Suggest editor configuration

• Scroll to the current page in the site nav (issue #292273650)

• Add changelog (issue #292247409)

SEEDs

We created a UI widget to standardize how we present SEED status information. See the start of 0102: Consistent Module Documentation for an example.

• Create Sphinx directive for metadata

Third party

third_party/mbedtls

• 3.3.0 compatibility (issue #293612945)

Miscellaneous

OWNERS

• Add kayce@

Jul 28, 2023

Highlights (Jul 13, 2023 to Jul 28, 2023):

• SEED-0107: Pigweed Communications, a proposal for an embedded-focused network protocol stack, is under discussion. Please review and provide your input!

• pw_cli now supports tab completion!

• A new UART Linux backend for pw_stream was added (pw_stream_uart_linux).

Active SEEDs

• SEED-0103: pw_protobuf Object Model

• SEED-0104: display support

• SEED-0105: Add nested tokens and tokenized args to pw_tokenizer and pw_log

• SEED-0106: Project Template

• SEED-0107: Pigweed communications

• SEED-0108: Emulators Frontend

Modules

pw_allocator

We started migrating the pw_allocator API reference to Doxygen.

• Doxygenify the freelist chunk methods

pw_async

We increased Bazel support.

• Fill in bazel build rules

pw_async_basic

We reduced logging noisiness.

• Remove debug logging

pw_base64

We continued migrating the pw_base64 API reference to Doxygen.

• Doxygenify MaxDecodedSize()

pw_bloat

We improved the performance of label creation. One benchmark moved from 120 seconds to 0.02 seconds!

• Cache and optimize label production

pw_bluetooth

Support for 3 events was added.

• Add 3 Event packets & format hci.emb

pw_build

• Fix progress bar clear

• Upstream build script fixes

• Add pw_test_info

• Upstream build script & presubmit runner

• pw_watch: Redraw interval and bazel steps

• Avoid extra newlines for docs in generate_3p_gn

• pip install GN args (issue #240701682)

• pw_python_venv generate_hashes option (issue #292098416)

pw_build_mcuxpresso

Some H3 elements in the pw_build_mcuxpresso docs were being incorrectly rendered as H2.

• Fix doc headings

pw_chrono_freertos

We investigated what appeared to be a race condition but turned out to be an unreliable FreeRTOS variable.

• Update SystemTimer comments (issue #291346908)

• Remove false callback precondition (issue #291346908)

pw_cli

pw_cli now supports tab completion!

• Zsh shell completion autoload

• Make pw_cli tab completion reusable

• Print tab completions for pw commands

• Fix logging msec timestamp format

pw_console

Communication errors are now handled more gracefully.

• Detect comms errors in Python

pw_containers

The flat map implementation and docs have been improved.

• Doxygenify pw::containers::FilteredView

• Support copying the FilteredView predicate

• Improve FlatMap algorithm and filtered_view support

• Improve FlatMap doc example

• Update FlatMap doc example so it compiles

pw_digital_io

We continued migrating the API reference to Doxygen. An RPC service was added.

• Doxygenify the interrupt handler methods

• Doxygenify Enable() and Disable()

• Add digital_io rpc service

pw_digital_io_mcuxpresso

We continued migrating the API reference to Doxygen. Support for a new RPC service was added.

• Remove unneeded constraints

pw_docgen

Support for auto-linking to Rust docs (when available) was added. We also explained how to debug Pigweed’s Sphinx extensions.

• Add rustdoc linking support to pigweed-module tag

• Add extension debugging instructions

pw_env_setup

There were lots of updates around how the Pigweed environment uses Python.

• pw_build: Disable pip version check

• Add docstrings to visitors

• Sort pigweed_environment.gni lines

• Mac and Windows Python requirements (issue #292098416)

• Add more Python versions (issue #292278707)

• Remove python.json from Bazel CIPD (issue #292585791)

• Redirect variables from empty dirs (issue #292278707)

• Split Python constraints per OS (issue #292278707)

• Add –additional-cipd-file argument (issue #292280529)

• Upgrade Python cryptography to 41.0.2

• Upgrade ipython to 8.12.2

• Upgrade PyYAML to 6.0.1

• Add Python constraints with hashes (issue #287302102)

• Bump pip and pip-tools

• Add coverage utilities (issue #279161371)

pw_fuzzer

A fuzzer example was updated to more closely follow Pigweed code conventions.

• Update fuzzers to use Pigweed domains

pw_hdlc

Communication errors are now handled more gracefully.

• Detect comms errors in Python

• Add target to Bazel build

pw_i2c

An RPC service was added. Docs and code comments were updated to use responder and initiator terminology consistently.

• Standardize naming on initiator/responder

• Add i2c rpc service

pw_i2c_mcuxpresso

• Allow for static initialization of initiator

• Add test to ensure compilation of module

pw_ide

• Support multiple comp DB search paths (issue #280363633)

pw_interrupt

Work continued on how facade backend selection works in Bazel.

• Add backend for xtensa processors

• Tidy up target compatibility (issue #272090220)

• Remove cpu-based backend selection (issue #272090220)

• Add backend constraint setting (issue #272090220)

• Remove redundant Bazel targets (issue #290359233)

pw_log_rpc

A docs section was added that explains how pw_log, pw_log_tokenized, and pw_log_rpc interact with each other.

• Explain relation to pw_log and pw_log_tokenized

pw_package

Raspberry Pi Pico and Zephyr support improved.

• Add picotool package installer

• Handle windows Zephyr SDK setup

• Run Zephyr SDK setup.sh after syncing from CIPD

pw_perf_test

• Remove redundant Bazel targets (issue #290359233)

pw_presubmit

• Add ifndef/define check (issue #287529705)

• Remove deprecated gn_docs_build step

• Fix issues with running docs_build twice

• Add Rust docs to docs site

pw_protobuf_compiler

• Disable legacy namespace

• Transition to our own proto compiler rules (issue #234874064)

• Allow external usage of macros

pw_ring_buffer

pw_ring_buffer now builds with -Wconversion enabled.

• Conversion warning cleanups (issue #259746255)

pw_rpc

• Create client call hook in Python client

• Provide way to populate response callbacks during tests

• Add Soong rule for pwpb echo service

pw_rpc_transport

• Add more Soong rules

pw_rust

We are preparing pigweed.dev to automatically link to auto-generated Rust module documentation when available.

• Add combined Rust doc support

• Update @rust_crates sha

pw_spi

We updated docs and code comments to use initiator and responder terminology consistently.

• Standardize naming on initiator/responder

pw_status

• Add Clone and Copy to Rust Error enum

pw_stream

We continued work on Rust support.

• Fix Doxygen typo

• Add read_exact() an write_all() to Rust Read and Write traits

• Clean up rustdoc warnings

• Add Rust varint reading and writing support

• Refactor Rust cursor to reduce monomorphization

• Add Rust integer reading support

• Move Rust Cursor to it’s own sub-module

pw_stream_uart_linux

A new UART Linux backend for pw_stream was added.

• Add stream for UART on Linux

pw_sync

C++ lock traits were added and used.

• Improve Borrowable lock traits and annotations (issue #261078330)

• Add lock traits

pw_sync_freertos

• Fix ODR violation in tests

pw_sys_io

• Add android to alias as host system (issue #272090220)

• Add chromiumos to alias as host system (issue #272090220)

pw_system

• Update IPython init API

• Remove redundant Bazel targets (issue #290359233)

pw_tokenizer

We refactored the pw_tokenizer docs to adhere to 0102: Consistent Module Documentation.

• Update tagline, restore missing info, move sections

• Migrate the proto docs (SEED-0102)

• Remove stub sections and add guides link (SEED-0102)

• Migrate the custom macro example (SEED-0102)

• Migrate the Base64 docs (SEED-0102)

• Migrate token collision docs (SEED-0102)

• Migrate detokenization docs (SEED-0102)

• Migrate masking docs (SEED-0102)

pw_toolchain

The build system was modified to use relative paths to avoid unintentionally relying on the path environment variable. Map file generation is now optional to avoid generating potentially large map files when they’re not needed.

• Test trivially destructible class

• Make tools use relative paths (issue #290848929)

• Support conditionally creating mapfiles

pw_trace_tokenized

• Replace singletons with dependency injection

• Remove redundant Bazel targets (issue #290359233)

pw_unit_test

• Update metadata test type for unit tests

pw_varint

• Update Rust API to return number of bytes written

pw_watch

We fixed an issue where builds were getting triggered when files were opened or closed without modication.

• Trigger build only on file modifications

pw_web

• Remove dependency on ‘crc’ and ‘buffer’ NPM packages

• Update theme token values and usage

• Add disconnect() method to WebSerialTransport

• Add docs section for log viewer component

Build

bazel

• Add host_backend_alias macro (issue #272090220)

• Fix missing deps in some modules

• Support user bazelrc files

• Update rules_python to 0.24.0 (issue #266950138)

build

• Use remote Java runtime for Bazel build (issue #291791485)

• Add Rust toolchain to Bazel macOS build (issue #291749888)

• Mark linux-only Bazel build targets

Targets

targets/rp2040_pw_system

Some of the Pico docs incorrectly referred to another hardware platform.

• Fix references to STM32 (issue #286652309)

Language support

python

• Remove setup.py files

rust

• Add rustdoc links for existing crates

OS support

zephyr

• Add project name to unit test root

• Add pigweed root as module

• Fix setup.sh call

Docs

We added a feature grid to the homepage and fixed outdated info in various docs.

• pigweed.dev feature grid

• Mention SEED-0102 in module_structure.rst (issue #286477675)

• Remove outdated Homebrew info in getting_started.rst (issue #287528787)

• Fix “gn args” examples which reference pw_env_setup_PACKAGE_ROOT

• Consolidate contributing docs in site nav

SEEDs

SEED-0107

• Claim SEED number

SEED-0108

• Claim SEED number

Third party

third_party

• Remove now unused rules_proto_grpc

third_party/mbedtls

• 3.3.0 compatibility (issue #293612945)