What’s new in Pigweed

Talk to the team at Pigweed Live

Our next Pigweed Live is Mon May 05, 2025 1PM (PDT). Please join us to discuss what’s new in Pigweed and anything else Pigweed-related that’s on your mind. Join our mailing list to receive an invite to the next meeting.

Feb 6, 2025

Note

What’s new in Pigweed will be paused for 2 months. It will resume in April 2025.

Highlights (Jan 25, 2025 to Feb 6, 2025):

• Tokenization improvements in C++: The new pw::tokenizer::Detokenizer::FromCsv() C++ method constructs a detokenizer from a CSV file. Tokenization domains are now supported in C++.

• New global variables wrapper pw::RuntimeInitGlobal declares a global variable that is initialized at runtime. Its destructor is never run.

• Bazel-based docs build: pigweed.dev is now built with Bazel. See Pigweed Blog #8: Migrating pigweed.dev to Bazel.

Modules

pw_allocator

New features:

• pw::Allocator now has more overloads for customizing allocated array alignment. Commit: Add overloads to customize allocated array alignment.

Changes:

• pw::allocator::test::SynchronizedAllocatorForTest was removed. Commit: Remove SynchronizedAllocatorForTest.

pw_bluetooth

New features:

• pw_bluetooth now supports a snoop log for recording HCI RX/TX traffic. Commit: Add snoop log. Bug: b/389995204.

pw_bluetooth_proxy

New features:

• The new pw::bluetooth::proxy::AcquireGattNotifyChannel method returns a GATT Notify channel that supports sending notifications to a particular connection handle and attribute. Commit: Support acquire of gatt notify channels. Bugs: b/369709521, b/379337272.

pw_bluetooth_sapphire

New features:

• Using Zxdb: the Fuchsia debugger explains how to use Fuchsia’s kernel debugger. Commit: Document how to use the Zxdb Debugger.

pw_containers

New features:

• pw::Vector now has an explicit constexpr constructor. Using this constructor will place the entire object in .data by default, which will increase ROM size. Commit: Add explicit constexpr constructor for Vector.

Bug fixes:

• A bug was fixed where pw::Vector::insert was move assigning to destroyed objects. Commit: Do not move assign to destroyed objects in Vector::insert. Bug: b/381942905.

pw_crypto

New features:

• pw::crypto::aes_cmac::Cmac provides support for the AES-CMAC algorithm. Commit: Add Aes::Cmac.

pw_tokenizer

New features:

• The new pw::tokenizer::Detokenizer::FromCsv() C++ method constructs a detokenizer from a CSV file. Commit: Add support for CSV parsing in C++.

• Tokenization domains are now supported in C++. Commit: Add support for domains in C++.

pw_toolchain

New features:

• pw::RuntimeInitGlobal is a new wrapper for global variables. See Global variables: constant initialization and binary size. Commit: Introduce RuntimeInitGlobal.

• pw_toolchain has started to support a Zephyr toolchain. Commit: Add support for Zephyr toolchain.

• clang-tidy explains how to integrate Pigweed’s toolchain with clang-tidy. Commit: Document clang-tidy + Bazel. Bug: b/341723612.

pw_transfer

Bug fixes:

• In proto3, when a retry config option is 0, pw_transfer no longer attempts to set it. Commit: Ignore 0 retry values from config proto. Bug: b/357145010.

Build systems

Bazel

New features:

• The Pigweed Bazel build has started to support Zephyr’s toolchain. Commit: Add Zephyr toolchain CIPD repo.

Docs

New features:

• pigweed.dev/rustdoc now provides an index of all Pigweed Rust crates. Previously, that page would 404. Commit: Add index page to Rust API docs.

• When viewing the docs on a staging site, there’s now a banner at the top of the docs site to make it clear that you’re not viewing the official Pigweed docs. Commit: Present banner on staged docs. Bug: b/304835851.

• pigweed.dev is now built with Bazel. See Pigweed Blog #8: Migrating pigweed.dev to Bazel. Commit: Add Bazel migration blog post.

Jan 24, 2025

Highlights (Jan 10, 2025 to Jan 24, 2025):

• Thread creation API: The cross-platform thread creation API proposed in 0128: Abstracting Thread Creation has been implemented.

• Layering check: Upstream Pigweed toolchains now support layering check in Bazel. Including headers that aren’t in the hdrs of a cc_library you directly depend on becomes a compile-time error.

• Cortex-A support: pw_interrupt_cortex_a is a new pw_interrupt backend for Arm Cortex-A processors. pw_toolchain now supports Arm Cortex-A35.

• Atomic API: The new pw_atomic module provides software implementations of atomic operations.

Modules

pw_atomic

New features:

• The new pw_atomic module provides software implementations of atomic operations. Commit: Add module for atomic operations.

pw_bluetooth_proxy

New features:

• Clients of pw_bluetooth_proxy can now register a callback function for inspecting host-to-controller L2CAP basic channel packets. Commit: Add host to controller callback packet sniffing. Bug: b/390191420.

pw_cli

New features:

• The new pw_cli.git_repo.GitRepoFinder helper class efficiently finds Git repo roots. Commit: Add helper for efficiently finding git repo roots. Bug: b/326309165.

pw_digital_io_mcuxpresso

New features:

• pw::digital_io::McuxpressoDigitalInOutInterrupt now supports interrupt triggers on both edges. Commit: Emulate kBothEdges trigger via level interrupt. Bug: b/390456846.

pw_env_setup

Changes:

• All transitive Python dependencies are now pinned. Commit: Pin all transitive Python package dependencies. Bug: b/390257072.

pw_interrupt_cortex_a

New features:

• [Deprecated] pw_interrupt_cortex_a is a new pw_interrupt backend for Arm Cortex-A processors. Commit: Add pw_interrupt backend for A-profile processors.

pw_protobuf

Changes:

• The kMaxEncodedSizeBytes constant has been renamed to kMaxEncodedSizeBytesWithoutValues to reflect the fact that it sometimes doesn’t represent a message’s true maximum size. Commit: Disambiguate maximum size constants. Bug: b/379868242.

pw_rpc

Changes:

• Recent Java client call ID changes were reverted because they were causing RPC timeouts. Commit: Revert Java client call ID changes.

pw_sync

Changes:

• Time-related methods previously in pw::sync::Borrowable were moved to a new pw::sync::TimedBorrowable class so that projects can use Borrowable without depending on pw_chrono. Commit: Split TimedBorrowable from Borrowable.

pw_system

Changes:

• The //pw_system:config Bazel rule is now public to make it possible to reuse the same configurations when creating custom RPC servers or I/O backends outside of Pigweed. Commit: Make config library public in Bazel.

pw_tokenizer

New features:

• The new PW_NESTED_TOKEN_FMT macro is a format specifier for doubly nested token arguments. Commit: Create generic macro for a nested token format.

Changes:

• Token domains have been limited to certain characters. Commit: Limit token domains to certain characters.

pw_toolchain

New features:

• pw_toolchain now supports Arm Cortex-A35. Commit: Add toolchain config for Cortex-A35.

• Upstream Pigweed toolchains now support layering check. Commit: Document layering check. Bug: b/219091175.

pw_thread

New features:

• The cross-platform thread creation API proposed in 0128: Abstracting Thread Creation has been implemented. Commit: Generic thread creation. Bug: b/373524851.

Jan 9, 2025

Highlights (Dec 27, 2024 to Jan 9, 2025):

• Bazel 8: Pigweed now depends on Bazel 8.

• FuzzTest and CMake: FuzzTest is now supported in CMake projects.

• BoringSSL: pw_crypto now supports BoringSLL.

• pw_rpc Java improvements: The pw_rpc Java client now has better concurrent RPC request support.

Modules

pw_containers

New features:

• Intrusive lists now support move operations. Commit: Support moving intrusive lists.

pw_chrono

New features:

• pw_chrono snapshots now support optional clock names. Commit: Add support for clock names.

pw_crypto

New features:

• pw_crypto now supports BoringSSL. Commit: Add BoringSSL backend for AES.

Changes:

• micro_ecc support has been removed. Commit: Remove micro_ecc support. Bug: b/359924206.

pw_digital_io_mcuxpresso

New features:

• The new pw::digital_io::McuxpressoDigitalInOutInterrupt class supports interrupts on the GPIO interrupt block which enables using interrupts on more pins. Commit: Add McuxpressoDigitalInOutInterrupt support.

Changes:

• pw::digital_io::McuxpressoDigitalInInterrupt has been deprecated. pw::digital_io::McuxpressoPintInterrupt should be used instead. Commit: Introduce McuxpressoPintInterrupt. Bug: b/337927184.

pw_fuzzer

New features:

• FuzzTest can now be used in CMake projects. Commit: Make FuzzTest usable be external CMake projects. Bug: b/384978398.

pw_log_basic

Changes:

• The maximum length for the function name field has increased from 20 to 30 characters and is now left-aligned. Commit: Adjust field widths.

pw_protobuf

Changes:

• Regular callbacks now ignore fields with unset decode callbacks. Previously they caused DATA_LOSS errors. Commit: Allow unset callback fields in message structs.

pw_rpc

New features:

• The Java client now supports making multiple concurrent RPC requests to the same method. Commit: Increment call_ids for java client.

pw_span

New features:

• The new docs section pw::span as a function parameter explains why pw::span objects should be passed by value. Commit: Recommend passing pw::span objects by value. Bug: b/387107922.

pw_stream

New features:

• The new pw::stream::SocketStream::IsReady() method indicates whether the streaming socket connection is ready. Commit: Add ready method to socket stream.

pw_thread

Changes:

• It is now simpler to disable the join() function when it’s not supported. Commit: Simplify disabling join() function when not supported.

pw_toolchain

Changes:

• The float ABI configuration for Arm Cortex-M33 was changed from soft to softfp. Commit: Update m33 float-abi. Bug: b/388354690.

pw_toolchain_bazel

Changes:

• Most of pw_toolchain_bazel has been removed because it has been upstreamed to rules_cc. Commit: Remove contents. Bug: b/346388161.

pw_uart

Changes:

• It is no longer safe to call any pw_uart read or write methods from a pw::uart::UartNonBlocking::DoRead() callback context. Commit: Restrict UartNonBlocking::DoRead() callback. Bug: b/384966926.

pw_unit_test

Bug fixes:

• The buffer for expectation logs was increased in size to prevent expectation logs from getting cut off. Commit: Expectation buffer cleanup. Bug: b/387513166.

Build systems

Bazel

Changes:

• Pigweed now depends on Bazel 8.0.0. Commit: Update to Bazel 8.0.0. Bug: b/372510795.

Docs

New features:

• The Sense tutorial has been updated to cover all variations on the Raspberry Pi Pico. Commit: Refresh Sense tutorial.

• Pigweed Toolchain now has a homepage. Commit: Add toolchain homepage. Bug: b/373454866.

Dec 26, 2024

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

• TLSF allocator: pw_allocator has a new two-layer, segregated fit allocator.

• Checked arithmetic: pw_numeric has a suite of new arithmetic operations that check for overflows.

• Constant expression unit tests: pw_unit_test has a new constexpr unit test that runs at both compile-time and runtime.

• Bazel module integration guidance: Using a Pigweed module in an existing Bazel project now provides guidance on how to integrate Pigweed into projects that use Bazel modules.

Modules

pw_allocator

New features:

• The new pw::allocator::TlsfAllocator is a two-layer, segregated fit allocator. Its 2D array of buckets incurs overhead but it can satisfy requests quickly and has much better fragmentation performance than WorstFitAllocator. Commit: Add TLSF allocator.

pw_build

New features:

• The new pw_rust_crates_extension Bazel extension lets a project override the rust_crates repo when needed without requiring every project to define one. Commit: Add pw_rust_crates_extension. Bug: b/384536812.

pw_containers

New features:

• Queues and dequeues now have explicit constexpr constructors. Commit: Add explicit constexpr constructors for deques/queues.

pw_multibuf

Changes:

• pw::multibuf::MultiBufAllocator no longer supports async. pw::multibuf::MultiBufAllocatorAsync should be used instead. Commit: Move async to new MultiBufAllocatorAsync. Bug: b/384583239.

pw_numeric

New features:

• pw::CheckedAdd, pw::CheckedIncrement, pw::CheckedSub, pw::CheckedDecrement, and pw::CheckedMul are new arithmetic methods that check for overflows. Commit: Add checked_arithmetic.h. Bug: b/382262919.

pw_thread

New features:

• The new pw::ThreadPriority class is a generic priority class that can be used by any pw_thread backend. Commit: Thread priority class.

pw_toolchain

New features:

• pw_toolchain now supports Arm Cortex-M3. Commit: Add Cortex M3 support.

pw_unit_test

New features:

• PW_CONSTEXPR_TEST is a new unit test that is executed both at compile-time in a static_assert() and at runtime as a GoogleTest TEST(). Commit: Test framework for constexpr unit tests.

Docs

New features:

• Using a Pigweed module in an existing Bazel project has been updated to describe how to integrate Pigweed into projects that use Bazel modules (bzlmod). Commit: Bazel integration: bzlmod, Bazel versions.

Dec 11, 2024

Highlights (Nov 28, 2024 to Dec 11, 2024):

• New blog post: Pigweed Blog #6: Shaping a better future for Bazel C/C++ toolchains summarizes our journey to upstream modular toolchains in rules_cc.

• Customizable enum tokenization: The new PW_TOKENIZE_ENUM_CUSTOM macro lets you customize how enum values are tokenized.

• AES API in pw_crypto: pw_crypto now has an Mbed-TLS backend for AES.

Modules

pw_allocator

Bug fixes:

• A bug was fixed where the FirstFitAllocator incorrectly allocated from the front. Commit: Fix first-fit with threshold. Bug: b/382513957.

pw_assert

Changes:

• Error messages in constant expressions have been improved. Commit: Improve error messages in constant expressions. Bug: b/277821237.

pw_async2

New features:

• pw::async2::OnceReceiver can now be constructed with a value. Commit: Support value constructor for OnceReceiver.

pw_bluetooth_proxy

New features:

• The new pw::bluetooth::proxy::ProxyHost::SendAdditionalRxCredits() method lets you send additional RX credits when needed. Previously this logic was coupled with the L2CAP connection-oriented channel acquisition. Commit: Separate rx_additional_credits method. Bug: b/380076024.

• Transport type for pw::bluetooth::proxy::BasicL2capChannel can now be specified during channel creation. Commit: Un-hardcode transport type for BasicL2capChannel.

• A flow control mechanism for writes was added. When a channel’s write fails because there’s no space, and then space becomes available, the channel is now notified. Commit: Add write flow control mechanism. Bug: b/380299794.

• Proxies now reset after receiving HCI_Reset commands. Commit: Reset proxy on HCI_Reset. Bug: b/381902130.

• The new pw::bluetooth::proxy::L2capStatusDelegate class lets you receive connection/disconnection notifications for a particular L2CAP service. Commit: Add L2cap service listener API. Bug: b/379558046.

pw_build

New features:

• New guidance on pw_cc_binary was added. Commit: Document pw_cc_binary.

Changes:

• When a pw_python_venv targets has no source packages and no requirements, an empty Python venv is created and pip-compile is no longer used. Commit: Allow for empty Python build venvs. Bug: b/380293856.

pw_cli

New features:

• Specifying whether color should be enabled on an output is now more granular. Commit: Allow output-specific color checks.

Changes:

• The Python function pw_presubmit.tools.exclude_paths() was moved to the pw_cli.file_filter module. Commit: Move exclude_paths.

pw_containers

Bug fixes:

• A bug was fixed where pw::Vector was move-assigning to destroyed objects. Commit: Do not move assign to destroyed objects in Vector::erase. Bug: b/381942905.

pw_crypto

New features:

• pw_crypto now has an Mbed-TLS backend for AES. Commit: Implement Mbed-TLS backend for AES.

• The new pw::crypto::aes::backend::DoEncryptBlock() is an initial facade for AES. Commit: Add AES facade.

pw_grpc

New features:

• Data is now queued if a stream or connection has no available send window. Previously data was dropped in this case. The send queues are non-blocking. Commit: Implement per stream send queues and make sending non-blocking. Bug: b/382294674.

Bug fixes:

• A pw::multibuf::MultiBufAllocator is now required when creating a pw::grpc::Connection instance. Commit: Remove old constructor and make multibuf allocator required. Bug: b/382294674.

pw_presubmit

New features:

• A new guide for Pigweed contributors on managing the Bazel lockfile was published. Commit: Bazel lockfile check. Bug: b/383387420.

pw_rpc

Changes:

• The newly public internal_packet_proto library makes it possible to generate packet.proto code for non-supported languages. E.g. this makes it possible to write a Dart/Flutter RPC client. Commit: Make packet proto library public in Bazel.

pw_snapshot

New features:

• The new thread_processing_callback parameter of pw_snapshot.processor.process_snapshot() lets you do custom thread processing during snapshot decoding. Commit: Add per-thread processing callback for snapshot decoding.

pw_system

New features:

• In the Bazel build rpc_server is now a pw_facade which lets you swap out the default HDLC server with something else in your project. Commit: Add facade for rpc server in Bazel.

pw_thread

Changes:

• ThreadCore logic was moved out of pw::Thread. Commit: Move ThreadCore logic out of pw::Thread.

pw_tokenizer

New features:

• The new PW_TOKENIZE_ENUM_CUSTOM macro lets you customize how enum values are tokenized. Commit: Add macro for tokenizing enums with custom string.

pw_toolchain

New features:

• In the GN build it is now possible to completely move away from GNU libraries. Commit: Support replacing GNU libs for ARM. Bug: b/322360978.

Docs

New features:

• A new Bazel style guide was added. Commit: Add Bazel style guide. Bug: b/371564331.

• A new blog post on C/C++ Bazel toolchains was published. Commit: Shaping a better future for Bazel C/C++ toolchains.

Nov 27, 2024

Highlights (Nov 15, 2024 to Nov 27, 2024):

• pw_allocator updates: The Buckets class has been refactored to be more flexible and the block API has been refactored to support static polymorphism.

Modules

pw_allocator

Changes:

• BestFitBlockAllocator was renamed to BestFitAllocator and WorstFitBlockAllocator was renamed to WorstFitAllocator. These classes have been refactored to use buckets. Commit: Refactor best- and worst-fit allocators to use buckets.

• FirstFitBlockAllocator, LastFitBlockAllocator, and DualFirstFitBlockAllocator were merged into a single class: FirstFitAllocator. Commit: Refactor first fit allocators.

• The Buckets class has been refactored to be more flexible. Commit: Refactor Bucket.

• Metric calculation for blocks that shift bytes has changed. Commit: Fix metrics for blocks that shift bytes. Bug: b/378743727.

• pw::allocator::BlockAllocator now returns pw::allocator::BlockResult. Commit: Use BlockResult in BlockAllocator.

• The block API has been refactored to support static polymorphism. Commit: Add static polymorphism to Block.

pw_bytes

New features:

• The new pw::IsAlignedAs() utility functions make it easier to check alignment. Commit: Add utility for checking alignment.

pw_presubmit

New features:

• The new includes_presubmit_check verifies that cc_library Bazel targets don’t use the includes attribute. Commit: Add check for cc_library includes. Bug: b/380934893.

pw_protobuf

New features:

• Limitations now has more guidance around protobuf versioning and optional fields. Commit: Expand message structure limitations docs section.

pw_transfer

Changes:

• Warnings logs are now emitted when client or server streams close unexpectedly. Commit: Log when streams close unexpectedly.

• The window size on retried data now shrinks in an attempt to reduce network congestion. Commit: Shrink window size on retried data.

pw_unit_test

Changes:

• Successful expectations are no longer stringified by default. Commit: Stop stringifying successful expectations.

pw_rpc

Changes:

• A warning log is now emitted when a server receives a completion request but client completion callbacks have been disabled. Commit: Warn when client completion callback is disabled.

Nov 14, 2024

Highlights (Nov 1, 2024 to Nov 14, 2024):

• ELF API: The new pw::elf::ElfReader class is a basic reader for ELF files.

• Updated Bluetooth APIs: There’s a new low energy connection-oriented channels API and the pw_bluetooth API has been modernized.

• Updated SEED process: “Intent Approved” and “On Hold” statuses were added to the SEED lifecycle.

Modules

pw_allocator

Changes:

• pw::allocator::AsPmrAllocator was renamed to pw::allocator::PmrAllocator. Commit: Separate PMR from Allocator.

pw_async2

New features:

• The new operator for coroutines now accepts an optional alignment argument. Commit: Accept alignment in CoroPromiseType::operator new. Bug: b/378929156.

• The new PW_TRY_READY and PW_TRY_READY_ASSIGN helper macros reduce boilerplate in non-coroutine async code. Commit: Add PW_TRY_READY_* control flow macros.

pw_bluetooth

New features:

• The new pw::bluetooth::low_energy::Channel, pw::bluetooth::low_energy::ChannelListener, and pw::bluetooth::low_energy::ChannelListenerRegistry classes provide a low energy connection-oriented channels API. Commit: Add LE Connection-Oriented Channels API. Bug: b/357142749.

Changes:

• The pw_bluetooth API has been modernized. Commit: Modernize APIs. Bug: b/350994818.

pw_bluetooth_proxy

New features:

• pw::bluetooth::proxy::L2capCoc now supports reading. Commit: L2CAP CoC supports reading. Bug: b/360934032.

pw_channel

New features:

• The new pw::Channel::PendAllocateWriteBuffer() method simplifies the allocation of write buffers that need small modifications. Commit: Move to PendAllocateWriteBuffer.

Changes:

• The pw::channel::WriteToken method was removed. Commit: Remove WriteToken.

• pw_channel inheritance has been refactored to ensure that conversions between compatible variants are valid. Commit: Rework inheritance to avoid SiblingCast.

pw_elf

New features:

• The new pw::elf::ElfReader class is a basic reader for ELF files. Commit: Add ElfReader.

pw_i2c

Bug fixes:

• I2C flags are now correctly set for transactions that occur on an I3C bus. Commit: Set the i2c flags correctly for transactions on an i3c bus. Bug: b/373451623.

pw_metric

New features:

• pwpb now prioritizes the .pwpb_options for protobuf codegen. Commit: Add metrics_service.pwpb_options to BUILD.gn.

• The new PW_METRIC_TOKEN() makes it easier for tests to create tokens for metrics. Commit: Expose metric token format via PW_METRIC_TOKEN.

pw_protobuf

New features:

• The Find*() methods have been extended to support iterating over repeated fields. See Reading a single field. Commit: Extend Find() APIs to support repeated fields.

Changes:

• It’s no longer necessary to set a callback for every possible field in a message when you’re only interested in a few fields. Commit: Allow unset oneof callbacks.

pw_protobuf_compiler

Changes:

• pwpb_options files are now explicitly processed first, followed by regular .options files. Commit: Don’t rely on options file ordering.

pw_rpc

Changes:

• The Python client previously reused call IDs after 16384. The limit has been increased to 2097152. Commit: Allocate more call IDs in the Python client. Bug: b/375658481.

pw_rpc_transport

New features:

• The new pw::rpc::RpcIngress::num_total_packets method tracks how many packets an ingress RPC handler has received. Commit: Track number of RPC packets received. Bug: b/373449543.

pw_sensor

New features:

• The new extras key lets applications specify additional metadata that’s not supported or used by Pigweed. Commit: Add freeform extras field to sensor.yaml.

pw_spi

Changes:

• pw::spi::Initiator is now a non-virtual interface. Commit: Finalize non-Virtual interface on Initiator. Bug: b/308479791.

pw_spi_linux

Bug fixes:

• The pw::Spi::Initiator::DoWriteRead() method now correctly handles transfers where either the write buffer or the read buffer is empty. Commit: Fix read/write-only transfers.

pw_stream

New features:

• The new pw::stream::Stream::ReadExact() method reads exactly the number of bytes requested into a provided buffer, if supported. Commit: Add ReadExact() wrapper.

pw_tokenizer

New features:

• The new pw::tokenizer::Detokenizer::FromElfFile() method constructs a detokenizer from the .pw_tokenizer.entries section of an ELF binary. Commit: Add Detokenizer::FromElfFile. Bug: b/374367947.

Bug fixes:

• The Python detokenizer now correctly handles multiple nested tokens in one log string. Commit: Update regex for nested args.

SEEDs

New features:

• “Intent Approved” and “On Hold” statuses were added to the SEED lifecycle. Commit: (SEED-0001) Add “Intent Approved” and “On Hold” states to lifecycle.

Oct 31, 2024

Highlights (Oct 18, 2024 to Oct 31, 2024):

• The new PW_TEST_EXPECT_OK, PW_TEST_ASSERT_OK, and PW_TEST_ASSERT_OK_AND_ASSIGN macros provide test matchers for pw_status and pw_result values.

• The Sense tutorial has expanded guidance around handling crashes and viewing snapshots.

• The new pw::LinkerSymbol class represents a symbol provided by a linker.

• The new extra_frame_handlers parameter lets you add custom HDLC frame handlers when using the Python-based pw_system console.

Modules

pw_allocator

New features:

• The new PW_ALLOCATOR_ENABLE_PMR macro lets you disable the ability to use an allocator with the polymorphic versions of standard library containers. Commit: Make pw::Allocator::as_pmr optional.

Changes:

• Multiple methods were renamed or removed in preparation for upcoming work to split up pw::allocator::Block. Commit: Streamline Block API.

pw_assert

Changes:

• pw_assert now verifies whether PW_CHECK message arguments are valid, regardless of what pw_assert backend is being used. Commit: Verify PW_CHECK message arguments in the API.

pw_assert_tokenized

New features:

• pw_assert_HandleFailure is now supported. Commit: Support pw_assert_HandleFailure.

pw_async2

New features:

• pw::async2::Join lets you join several separate pendable values. Commit: Add Join combinator.

• The new pw::async2::TimeFuture::Reset() method resets a TimeFuture instance to expire at a specified time. Commit: Add TimerFuture::Reset.

Changes:

• Waker storage has moved to a macro-based API. See PW_ASYNC_STORE_WAKER and PW_ASYNC_CLONE_WAKER. Commit: Move to macro-based Waker API. Bug: b/376123061.

pw_bluetooth_proxy

New features:

• Bazel builds are now supported. Commit: Add bazel build support.

pw_build

New features:

• The new pw::LinkerSymbol class represents a symbol provided by a linker. Commit: Add LinkerSymbol.

pw_channel

Changes:

• pw::channel::AnyChannel::Write was renamed to pw::channel::AnyChannel::StageWrite() and pw::channel::AnyChannel::PendFlush was renamed to pw::channel::AnyChannel::PendWrite(). Commit: Rename {Write->StageWrite, PendFlush->PendWrite}.

pw_containers

New features:

• pw::IntrusiveSet is a new class like std::set<Key, Compare> that uses intrusive items as keys and pw::IntrusiveMultiSet is a new class like std::multiset<Key, Compare> that uses intrusive items. Commit: Add IntrusiveSet and IntrusiveMultiSet.

Changes:

• The erase methods of pw::containers::future::IntrusiveList, pw::IntrusiveMap, and pw::IntrusiveMultiMap have been overloaded to make them easier to use. Commit: Add methods to erase by item.

pw_log

Changes:

• The signature for PW_LOG macro changed. A verbosity level must now always be passed as the second argument when invoking PW_LOG. Commit: Explicitly pass verbosity to PW_LOG.

pw_multibuf

New features:

• The new pw::multibuf::FromSpan() function creates a multibuf from an existing span and a deleter callback. Commit: Add FromSpan. Bug: b/373725545.

pw_multisink

New features:

• The new pw::multisink::UnsafeDumpMultiSinkLogsFromEnd() utilitiy function dumps contents as a series of log entries. Commit: Add UnsafeForEachEntryFromEnd(). Bug: b/375653884.

pw_polyfill

Changes:

• PW_CONSTINIT now fails when used without compiler support. Commit: Make PW_CONSTINIT support mandatory.

pw_protobuf

Bug fixes:

• pw_protobuf now fails when the max_count or fixed_count options of pwpb are used on unsupported field types. Commit: Fail when a max count is set with an unsupported type.

Changes:

• Code generator options can now be specified in files ending with .pwpb_options. This is useful for projects that wish to strictly separate Nanopb and pw_protobuf options. Commit: Allow .pwpb_options as an options file extension.

pw_ring_buffer

New features:

• pw_ring_buffer readers now support the -- decrement operator. Commit: Add a decrement operator. Bug: b/375653884.

pw_system

New features:

• The new extra_frame_handlers parameter lets you add custom HDLC frame handlers when using the Python-based pw_system console. Commit: Make console support extra hdlc frame handlers.

Bug fixes:

• A bug was fixed where the latest logs were not being captured in crash snapshots. Commit: Ensure latest logs are captured in crash snapshot. Bug: b/375653884.

• The pw_system crash dump now includes a main stack thread backtrace. Commit: Add main stack thread backtrace capture to crash dump. Bug: b/354767156.

• The pw_system crash dump now includes FreeRTOS thread backtraces. Commit: Add freertos thread backtrace capture to crash dump. Bug: b/354767156.

pw_thread

Changes:

• The legacy thread::Id alias has been migrated to pw::Thread::id. Commit: Migrate to Thread::id. Bug: b/373524945.

pw_tokenizer

New features:

• PW_APPLY is a new general macro that supports macro expansion and makes tokenizing enums easier. Commit: Create generic macro for tokenizing enums. Bug: b/3627557773.

pw_toolchain

New features:

• pw_toolchain now supports the Arm Cortex-M55F GCC toolchain. Commit: Add ARM Cortex-M55F GCC toolchain. Bug: b/375562597.

pw_unit_test

New features:

• The new PW_TEST_EXPECT_OK, PW_TEST_ASSERT_OK, and PW_TEST_ASSERT_OK_AND_ASSIGN macros provide test matchers for pw_status and pw_result values. Commit: Define pw::Status matchers. Bugs: b/338094795, b/315370328.

Changes:

• RUN_ALL_TESTS() is now a function. Previously it was a macro. Commit: Use a function for RUN_ALL_TESTS().

pw_watch

New features:

• pw_watch can now be invoked through bazelisk. Commit: Bazel run support. Bug: b/360140397.

Docs

New features:

• The Sense tutorial has expanded guidance around handling crashes and viewing snapshots. Commit: Add crash handler section to sense tutorial. Bug: b/354767156.

Targets

RP2350

New features:

• MemManage, BusFault, and UsageFault exception handlers are now enabled on the RP2350 target. Commit: Add MemManage, BusFault & UsageFault exception handler. Bug: b/354767156.

Oct 17, 2024

Highlights (Oct 04, 2024 to Oct 17, 2024):

• Math module: The new pw_numeric module is a collection of mathematical utilities optimized for embedded systems.

• C++ Coroutines: The new Pigweed Blog #5: C++20 coroutines without heap allocation blog post discusses the nuances of using coroutines in embedded systems.

• New SEEDs: SEEDs 0103: pw_protobuf: Past, present, and future and 0128: Abstracting Thread Creation were accepted.

Modules

pw_allocator

New features:

• The new pw::Allocator::MakeUniqueArray() template function allows a UniquePtr to hold an array of elements. Commit: Add UniquePtr::MakeUniqueArray.

• The new pw::allocator::BlockResult class communicates the results and side effects of allocation requests. Commit: Add BlockResult.

Bug fixes:

• A data race was fixed. Commit: Fix data race. Bug: b/372446436.

pw_async2

New features:

• The new pw::async2::EnqueueHeapFunc() function heap-allocates space for a function and enqueues it to run on a dispatcher. Commit: Add EnqueueHeapFunc.

Changes:

• pw::async2::PendFuncTask now has a default template type of pw::Function. Commit: Provide default template type for PendFuncTask.

pw_build

New features:

• The newly relanded pw_copy_and_patch_file feature provides the ability to patch a file during a Bazel or GN build. Commit: Add pw_copy_and_patch_file.

pw_cli_analytics

New features:

• The new pw_cli_analytics module collects and transmits analytics on usage of the pw command line interface. Commit: Initial commit. Bug: b/319320838.

pw_console

Bug fixes:

• A divide-by-zero error in the pw_console progress bar was fixed. Commit: Fix progress bar division by zero.

pw_env_setup

Changes:

• //pw_env_setup/py/pw_env_setup/cipd_setup/black.json has been removed. Commit: Remove black.json.

• Python 2 support has been removed from pw_env_setup. Commit: Drop Python 2 support. Bug: b/373905972.

pw_numeric

New features:

• The new pw_numeric module is a collection of mathematical utilities optimized for embedded systems. Commit: New module for mathematical utilities.

• The new pw::IntegerDivisionRoundNearest() function performs integer division and rounds to the nearest integer. It gives the same result as std::round(static_cast<double>(dividend) / static_cast<double>(divisor)) but requires no floating point operations and is constexpr. Commit: Rounded integer division.

pw_protobuf

Changes:

• oneof protobuf fields can’t be inlined within a message structure. They must be encoded and decoded using callbacks. See Per-Field Writers and Readers. Commit: Force use of callbacks for oneof. Bug: b/373693434.

• The import_prefix parameter in the pw_protobuf.options.load_options Python function was replaced with an options_files parameter that lets you directly specify the location of .options files. Commit: Support directly specifying options file locations. Bug: b/253068333.

pw_rpc

Bug fixes:

• A bug was fixed where previously Call objects were not getting reinitialized correctly. Commit: Fix Call not getting reset on default constructor assignment. Bug: b/371211198.

pw_spi

Changes:

• pw::spi::Initiator now uses a non-virtual interface (NVI) pattern. Commit: Use non-virtual interface (NVI) pattern on pw::spi::Initiator. Bug: b/308479791.

pw_stream_uart_mcuxpresso

Changes:

• pw_stream_uart_mcuxpresso is being merged into pw_uart_mcuxpresso. Commit: Remove dma_stream. Bug: b/331617914.

pw_system

New features:

• The new --debugger-listen and --debugger-wait-for-client options make it easier to debug the pw_system console. Commit: Add `debugger-listen` and `debugger-wait-for-client` options.

pw_tokenizer

New features:

• All domains from ELF files are now loaded by default. Commit: Load all domains from ELF files by default. Bugs: b/364955916, b/265334753.

• CSV databases now include the token’s domain as the third column. Commit: Include the domain in CSV databases. Bug: b/364955916.

• Tokenizing enums is now supported. Commit: Add support for tokenizing enums. Bug: b/362753838.

Changes:

• When a domain is specified, any whitespace will be ignored in domain names and removed from the database. Commit: Ignore whitespace in domain values. Bug: b/362753840.

pw_toolchain

New features:

• The new Compiler-specific build logic documentation provides guidance on how to handle logic that differs between compilers. Commit: Add Bazel mechansim for clang/gcc-specific flags. Bug: b/361229275.

pw_uart

New features:

• The new pw::uart::UartStream class implements the pw::stream::NonSeekableReaderWriter interface on top of a UART device. Commit: Add pw::uart::UartStream. Bug: b/331603164.

• The new pw::uart::UartBlockingAdapter class provides a blocking UART interface on top of a pw::uart::UartNonBlocking device. Commit: Add UartBlockingAdapter. Bug: b/369679732.

• The new pw::uart::UartNonBlocking::FlushOutput() function ensures that all enqueued data has been transmitted. Commit: Add UartNonBlocking::FlushOutput(). Bug: b/370051726.

pw_web

Changes:

• The device RPC APIs now support creating request messages for RPCs and calling the device API with those request messages. Commit: Improvements to `device` RPC APIs.

Docs

New features:

• The new Pigweed Blog #5: C++20 coroutines without heap allocation blog post discusses the nuances of using coroutines in embedded systems. Commit: Add coroutine blog post.

Changes:

• Guides for contributing pigweed.dev documentation have been consolidated. Commit: Consolidate content for pigweed.dev contributors.

SEEDs

New features:

• SEED 0103: pw_protobuf: Past, present, and future was accepted. Commit: (SEED-0103) pw_protobuf: Past, present, and future.

• 0128: Abstracting Thread Creation was accepted. Commit: (SEED-0128) Abstracting thread creation.

Targets

RP2040

New features:

• A new helper, flash_rp2350, was added to //targets/rp2040/flash.bzl. Commit: Update `flash_rp2040` helper with –chip argument.

Oct 3, 2024

Highlights (Sep 20, 2024 to Oct 3, 2024):

• The pw_async2 and pw_containers docs now contain code examples that are built and tested alongside the rest of Pigweed, minimizing the chance that they bit rot over time.

• The new pw::async2::Dispatcher class is a single- threaded, cooperatively scheduled runtime for async tasks.

• The new pw::uart::UartBase class provides a common abstract base class for UART interfaces.

• pw::rpc::RawServerReaderWriter and pw::rpc::RawClientReaderWriter have new methods that let you directly serialize RPC payloads to the RPC system’s encoding buffer instead of requiring a copy from an externally managed buffer.

Modules

pw_allocator

New features:

• The new pw::allocator::CalculateFragmentation() method calculates a fragmentation metric. This should not be invoked on-device unless the device has robust floating-point support. Commit: Add MeasureFragmentation.

pw_async2

New features:

• The new pw::async2::Dispatcher class is a single- threaded, cooperatively scheduled runtime for async tasks. Commit: Refactor Dispatcher to raise top-level API out of CRTP. Bug: b/342000726.

• The pw_async2 docs now have examples. Commit: Expand docs with examples.

pw_boot

Changes:

• The main() function forward declaration has been moved out of an explicit extern C block to prevent pedantic warnings in newer Clang toolchains. Commit: Move main forward declaration out of extern “C” block. Bug: b/366374135.

pw_build

Changes:

• The rules that previously existed in //pw_build/pigweed.bzl have been split into separate files. If you relied on //pw_build/pigweed.bzl you may need to update some load() statements in your Bazel files. Commit: Break apart pigweed.bzl. Bug: b/370792896.

pw_chrono

New features:

• The new --stamp Bazel flag ensures that Bazel builds properly record the actual build time as opposed to a cached value. Commit: Properly stamp build time in Bazel. Bug: b/367739962.

pw_containers

New features:

• The pw_containers docs now provides examples on how to add intrusive items to multiple containers. See Example. Commit: Multiple container example.

• The pw_containers docs now have code examples that are built and tested as part of the normal upstream Pigweed build, which helps ensure that they don’t bit rot. Commit: Add examples.

Bug fixes:

• A bug was fixed where nodes in an AATreeItem could become orphaned. Commit: Fix tree rebalancing.

pw_log

Changes:

• The PW_MODULE_LOG_NAME_DEFINED macro has been removed. Commit: Remove unused macro PW_MODULE_LOG_NAME_DEFINED.

pw_metric

Bug fixes:

• A bug causing pw::metric::Metric::Dump() and pw::metric::Group::Dump() to log invalid JSON objects was fixed. Commit: Emit valid JSON from Metric::Dump.

pw_preprocessor

Changes:

• PW_MACRO_ARG_COUNT now supports up to 256 arguments. Commit: Expand PW_MACRO_ARG_COUNT to 256 arguments.

pw_presubmit

Bug fixes:

• A bug was fixed that was causing Pigweed’s auto-generated rustdoc API references to not be built. rustdoc documentation at pigweed.dev/rustdoc/* should be working again. Commit: Have docs_build check rust docs. Bug: b/369864378.

pw_rpc

New features:

• pw::rpc::RawServerReaderWriter and pw::rpc::RawClientReaderWriter have new methods that let you directly serialize RPC payloads to the RPC system’s encoding buffer instead of requiring a copy from an externally managed buffer. Commit: Add callback writes to raw RPC call objects.

pw_spi

New features:

• operator!= is now implemented. Commit: Minor enhancements to pw::spi::Config.

Changes:

• operator(), operator==, and operator!= are now marked constexpr to enable compile-time equality checking. Commit: Minor enhancements to pw::spi::Config.

pw_spi_rp2040

Changes:

• spi_init() from the Pico SDK must be called before using the pw_spi initiator. Commit: Minor cleanup.

pw_thread

Changes:

• The old pw::Thread constructor that takes void(void*) has been removed from the public API. This is a breaking change. Constructor usage should be migrated to the new constructor that takes pw::Function<void()>. Commit: Make the deprecated Thread constructor private. Bug: b/367786892.

• The pw::thread::Thread class was renamed to pw::Thread. Commit: Migrate from pw::thread::Thread to pw::Thread.

• pw::thread::Id has been renamed to pw::Thread::id. Commit: Introduce pw::Thread and pw::Thread::id.

pw_tokenizer

New features:

• The new PW_TOKENIZER_DEFINE_TOKEN macro makes it easier to support tokenized enums and domains. Commit: Expose API to define new token entry. Bug: b/369881416.

Changes:

• CSV databases now have 4 columns: token, date removed, domain, and string. The domain column was added as part of 0105: Nested Tokens and Tokenized Log Arguments. Legacy databases that only support the other 3 columns continue to be supported. Tokens in legacy databases are always in the default domain "". Commit: Support CSV databases with the domain. Bug: b/364955916.

pw_toolchain

Changes:

• The pw_toolchain docs were refactored. Bazel-specific guidance is now in Bazel build system integrations and GN-specific guidance is now in GN build system integrations. Commit: Split out build-system specific docs.

• The Bazel rules at //pw_toolchain/args/BUILD.bazel moved to //pw_toolchain/cc/args/BUILD.bazel. If you rely on these rules you may need to update your load() statements. Commit: Move pw_toolchain/args to pw_toolchain/cc/args.

pw_transfer

Bug fixes:

• A bug was fixed where resumed transfers would send a window of 0 repeatedly. Commit: Fix offset receive transfer startup. Bug: b/368620868.

pw_uart

New features:

• The new pw::uart::UartBase class provides a common abstract base class for UART interfaces. Commit: Add UartBase class. Bug: b/369678735.

• The new pw::uart::Uart::ReadAtLeast() method reads data from the UART and blocks until at least the specified number of bytes have been received. The new pw::uart::Uart::ReadExactly() method reads data from the UART and blocks until the entire buffer has been filled. Commit: Add ReadAtLeast and ReadExactly methods. Bug: b/368149122.

• The new pw::uart::UartNonBlocking class provides a callback-based interface for performing non-blocking UART communication. It defines the interface that concrete UART implementations must adhere to. Commit: Add uart_non_blocking.h API. Bugs: b/341356437, b/331617095.

• The new pw::uart::Uart::SetFlowControl() method lets applications configure hardware flow control on UART devices. Commit: Add method to set flow control.

Changes:

• pw::uart::Uart::ConservativeReadAvailable() was moved to pw::uart::UartBase::ConservativeReadAvailable() and pw::uart::Uart::ClearPendingReceiveBytes() was moved to pw::uart::UartBase::ClearPendingReceiveBytes(). Commit: Move non-blocking methods from Uart to UartBase. Bug: b/369679732.

pw_uart_mcuxpresso

Bug fixes:

• A bug was fixed where the pw::uart::DmaUartMcuxpresso::Deinit() method didn’t clear an initialization flag, which caused the pw::uart::DmaUartMcuxpresso::Init() method to be skipped on subsequent enables. Commit: Fix disable bug.

Docs

New features:

• The Pigweed blog now has an RSS feed. Commit: Create RSS feed for blog. Bug: b/345857642.

• The new blog post Pigweed Blog #4: Fixed-point arithmetic as a replacement for soft floats outlines how replacing soft floats with fixed-point arithmetic can result in speed improvements and binary size reductions without sacrificing correctness. Commit: Add fixed point blog.

Bug fixes:

• When a Pigweed module is listed as supporting Rust in //docs/module_metadata.json, a link to that module’s rustdoc API reference is now auto-generated in the pigweed.dev site nav. Commit: Auto-link to Rust API references. Bug: b/328503976.

SEEDs

Changes:

• SEED-0123 was rejected because Pigweed ended up upstreaming the relevant APIs to rules_cc instead of sprouting them into a separate repo. Commit: (SEED-123) Reject the SEED.

Targets

• The main() forward declaration for emcraft_sf2_som, host_device_simulator, and stm32f429i_disc1_stm32cube are no longer explicitly marked extern C to prevent pedantic warnings in newer Clang toolchains. Commit: Remove implicit extern C. Bug: b/366374135.

Sep 19, 2024

Highlights (Sep 06, 2024 to Sep 19, 2024):

• New container classes: The new pw::IntrusiveMap and pw::IntrusiveMultiMap classes can be used for associative dictionaries, sorted lists, and more.

• Protobuf Editions: Initial support for Protobuf Editions was added for GN-based and CMake-based projects.

• Token domains: The Detokenizer now supports token domains.

Modules

pw_allocator

New features:

• The new PW_ALLOCATOR_STRICT_VALIDATION option lets you enable more expensive checks to aggressively enforce invariants when testing. The new PW_ALLOCATOR_BLOCK_POISON_INTERVAL option allows setting the poisoning rate more easily from the build rather than in code via template parameters. See Module configuration. Commit: Add module config.

Bug fixes:

• A bug was fixed where pw_allocator always split the first block even if there was not enough room for the first block to be split into two, which could cause heap corruption and crashes. Commit: Check for room to split the first block. Bug: b/366175024.

pw_assert

Changes:

• PW_CHECK_OK now accepts any expression that’s convertible to pw::Status. Commit: Update PW_CHECK_OK() to handle any expr convertible to Status. Bugs: b/357682413, b/365592494.

pw_async2

New features:

• The new pw::async2::SimulatedTimeProvider::AdvanceUntilNextExpiration() utility method is useful for advancing test time without random periods or endless iterations. Commit: Add more SimulatedTimeProvider utilities.

Changes:

• Coroutines now log the requested size when an allocation fails. Commit: Log size of failed coroutine allocations.

pw_build

Bug fixes:

• An issue was fixed where bootstrap failed when pw_rust_static_library was used. Commit: Fix Undefined identifier.

pw_bytes

New features:

• The new pw::PackedPtr template class provides a way to store extra data in the otherwise unused least significant bits of a pointer. Commit: Add PackedPtr.

pw_containers

New features:

• pw::IntrusiveList now has a size report. Commit: Add IntrusiveForwardList size report to the docs.

• The new pw::IntrusiveMap and pw::IntrusiveMultiMap classes can be used for associative dictionaries, sorted lists, and more. Commit: Add IntrusiveMap and IntrusiveMultiMap.

Changes:

• pw::IntrusiveList<T> was renamed to pw::IntrusiveForwardList<T> and a new doubly-linked intrusive list was added as pw::containers::future::IntrusiveList<T>. An alias, pw::IntrusiveList<T>, was added to maintain compatibility with existing code and will be removed in the future. The original implementation can still be temporarily enabled by setting PW_CONTAINERS_USE_LEGACY_INTRUSIVE_LIST. Commit: Add doubly linked list. Bug: b/362348318.

pw_env_setup

Changes:

• The Git submodule check is now skipped when no .git file or directory is detected. Commit: Add check for git in _check_submodule_presence. Bug: b/365557573.

pw_ide

Bug fixes:

• When clangd is not found, pw ide sync now cleanly handles the lack of clangd and successfully completes the rest of the sync. Commit: Don’t fail sync on missing clangd. Bug: b/349189723.

pw_protobuf

New features:

• Initial support for Protobuf Editions was added for GN-based and CMake-based projects. Commit: Basic edition support.

pw_spi_linux

Bug fixes:

• A performance issue was fixed where Configure() was being called on each pw::spi::Device::WriteRead() call. Commit: Avoid unnecessary ioctl()s in Configure(). Bug: b/366541694.

pw_spi_mcuxpresso

Changes:

• pw::spi::McuxpressoInitiator::DoConfigure() was renamed to pw::spi::McuxpressoInitiator::DoConfigureLocked(). Commit: Rename DoConfigure() to DoConfigureLocked().

pw_sys_io_stm32cube

Bug fixes:

• A bug was fixed where the GPIO mode of the UART RX GPIO pin on STM32F1XX devices was not being correctly set. Commit: Fix UART RX GPIO mode for f1xx family.

pw_system

New features:

• The console’s new timestamp_decoder constructor parameter lets applications provide custom timestamp parsers. Commit: Support timestamp parser as an argument. Bug: b/344606797.

Changes:

• The log library header (pw_system/log.h) of pw_system is now public and can be used outside of pw_system. Commit: Make log library header public.

pw_thread

Changes:

• pw::thread::Thread now takes pw::Function<void()>, which should be used in place of the void(void*) function pointer and void* argument. Commit: Mark legacy function* / void* constructor as deprecated. Bug: b/367786892.

pw_tokenizer

New features:

• The Detokenizer now supports token domains. Commit: Add token domain support to Detokenizer. Bug: b/362752722.

• pw_tokenizer.tokens.Database now supports token domains. Commit: Use domains in the Python tokens.Database class.

pw_toolchain

New features:

• WORKSPACE toolchain registration is now configurable so that downstream projects can manually control which toolchains get registered. Commit: Make toolchain registration configurable. Bug: b/346388161.

pw_transfer

Bug fixes:

• A bug was fixed where a handshake timeout was not set after START_ACK is processed. Commit: Bugfix for start handshake, and rate limit logs. Bug: b/361281209.

Changes:

• When a receiver receives a chunk of data it already has the receiver now sends a PARAMETERS_CONTINUE chunk instead of requesting retransmission. Commit: Send continue parameters for already received chunks.

• TX data chunk logs have been rate-limited to only send once every 3 seconds. Commit: Bugfix for start handshake, and rate limit logs. Bug: b/361281209.

pw_uart_mcuxpresso

New features:

• Flow control can now be configured. Commit: Add support for configuring flow control. Bug: b/368150004.

Changes:

• Flow control, parity mode, and stop bits now have default values. Commit: Add support for configuring flow control. Bug: b/368150004.

Build systems

Bazel

New features:

• The new do_not_build tag specifies targets that should be excluded from wildcard builds. The new do_not_run_test tag specifies test targets that should be built but not executed. Commit: Introduce do_not_build, do_no_run_test tags. Bug: b/353531487.

• Platform-based flags have been re-enabled. Commit: Re-enable platform-based flags. Bug: b/301334234.

Miscellaneous

Bug fixes:

• An issue was fixed where the Fuchsia SDK was always fetched during Bazel workspace initialization and caused unnecessary downloads. Commit: Use @fuchsia_clang as a cipd repository. Bug: b/346416385.

Sep 5, 2024

Note

This changelog update is shorter than previous ones because we’re experimenting with only showing user-facing new features, changes, and bug fixes. I.e. we’re omitting commits that don’t affect downstream Pigweed projects.

Highlights (Aug 24, 2024 to Sep 5, 2024):

• New backends: pw_async_fuchsia (a pw_async backend for Fuchsia that implements Task and FakeDispatcher), pw_log_fuchsia (a pw_log backend for Fuchsia that uses the fuchsia.logger.LogSink FIDL API to send logs), pw_random_fuchsia (a pw_random backend for Fuchsia that implements pw::random::RandomGenerator) and pw_uart_mcuxpresso (a pw_uart backend for NXP MCUXpresso devices).

• New theme: The underlying Sphinx theme powering pigweed.dev is now PyData. In addition to improving website usability, this theme should also reduce the pigweed.dev maintenance workload over time. See 0130: Update Sphinx theme for more information.

• Arm Cortex-M55 support: pw_toolchain and pw_system now support Arm Cortex-M55 cores.

• Bazel cloud demo: The new Bazel cloud features page in the Sense tutorial shows you how to use BuildBuddy to share logs and speed up builds with remote caching.

Modules

pw_async2

• The new pw::async2::TimeProvider class can be used to create timers in a dependency-injection-friendly way. Commit: Add TimeProvider

pw_async_fuchsia

• pw_async_fuchsia is a new pw_async backend for Fuchsia that implements Task and FakeDispatcher. Commit: Create pw_async Fuchsia backend

pw_chrono

• pw::chrono::VirtualClock is a new virtual base class for timers that enables writing timing-sensitive code that can be tested using simulated clocks such as pw::chrono::SimulatedSystemClock. Commit: Add VirtualClock

pw_cli

• The new pw_cli.git_repo.GitRepo.commit_date() method returns the datetime of a specified commit. Commit: Add in option to retrieve commit date

pw_digital_io_mcuxpresso

• The GPIO clock is now enabled even when GPIO is disabled. Commit: Enable gpio clock even when disabling gpio (issue #356689514)

pw_log_fuchsia

• pw_log_fuchsia is a new pw_log backend that uses the fuchsia.logger.LogSink FIDL API to send logs. Commit: Create pw_log Fuchsia backend

pw_log_rpc

• pw_log_rpc.LogStreamHandler.listen_to_logs() was renamed to pw_log_rpc.LogStreamHandler.start_logging(). Commit: Invoke pw.log.Logs.Listen() to restore prior behavior (issue #364421706)

pw_log_zephyr

• Use of shell printf macros within if blocks that don’t use braces no longer causes compile errors. Commit: Make shell printf macros safe for use in if/else blocks

pw_package

• picotool installation on macOS was fixed. Commit: Fix pictotool install on mac

pw_random_fuchsia

• pw_random_fuchsia provides an implementation of pw::random::RandomGenerator that uses Zircon. Commit: Create Fuchsia backend for pw_random

pw_rpc

• New documentation (Falling back to raw methods) was added that explains how to define a raw method within a non-raw service. Commit: Provide examples of raw methods in docs

• Many RPC-related classes were moved out of pw_hdlc and into pw_rpc or pw_stream. Commit: Relocate RPC classes from pw_hdlc (issues #330177657, #360178854)

pw_spi_mcuxpresso

• The new pw::spi::FifoErrorCheck enum lets you configure whether pw::spi::McuxpressoResponder instances should log FIFO errors. Commit: Add check_fifo_error to responder config

pw_stream_uart_linux

• The new pw::stream::UartStreamLinux::Config struct lets you configure baud rate and control flow. Commit: Add Config struct (issue #331871421)

pw_sync

• pw::sync::InterruptSpinLock::try_lock() and similar functions have been annotated with [[nodiscard]] which means that ignoring their return values will result in compiler warnings. Commit: [[nodiscard]] for try_lock() and similar functions

pw_system

• pw_system now supports Arm Cortex-M55 systems. Commit: Support ARM Cortex M55 system (issue #361691368)

pw_thread

• pw::thread::Options has moved to its own header (pw_thread/options.h) to make it possible to work with the class without relying on the thread facade. Commit: Move pw::thread::Options to its own header

pw_tokenizer

• In Python the detokenizer prefix is now set in the pw_tokenizer.detokenize.Detokenizer constructor. Commit: Set prefix in Detokenizer; fix typing issues

pw_toolchain

• Arm Cortex-M55 toolchain support was added. Commit: Add ARM Cortex-M55 toolchain (issue #361691368)

pw_uart_mcuxpresso

• The new pw_uart_mcuxpresso module is a pw_uart backend for NXP MCUXpresso devices. Commit: Introduce DMA UART backend for NXP devices

Docs

• New documentation (Logging) about logging best practices was added. Commit: Add logging recommendations

• The new Bazel cloud features page in the Sense tutorial shows you how to use BuildBuddy to share logs and speed up builds with remote caching. Commit: Add cloud build section to Sense tutorial (issue #363070027)

• Contributing guide now links to good first issues for people who want to contribute to upstream Pigweed. Commit: Add link to good first issue list

• pigweed.dev/live now links to the Pigweed Live meeting notes. Commit: Add shortlink for Pigweed Live notes

Targets

RP2350

• RP2350 crash snapshots now show the correct architecture. Commit: Fix architecture in crash snapshot (issue #362506213)

Aug 23, 2024

Highlights (Aug 8, 2024 to Aug 23, 2024):

• RP2350 Support: Pigweed now supports the new Raspberry Pi RP2350 MCU. Check out Google Pigweed comes to our new RP2350 on the Raspberry Pi blog for the full story and Sense: An interactive tour though Pigweed to try it out.

Build systems

Bazel

• Add missing counting_semaphore and thread_yield backends

Modules

pw_allocator

• Disable example spin_lock test on RP2 (issues #358411629, #361354335)

pw_async2

The new pw::async2::MakeOnceSenderAndReceiver() function template makes it easier to simultaneously create a sender and receiver for asynchronously sending values. The new pw::async2::MakeOnceSenderAndReceiver() function template works similarly but is used for references.

• Create OnceSender & OnceReceiver (issue #350994818)

• Remove accidental macro #undef

pw_bloat

The pw bloat CLI command now supports a --custom-config option to specify a custom Bloaty config file so that non-memory regions can be analyzed.

• Support custom bloaty configs in CLI command

pw_bluetooth

• Create more emboss event definitions (issue #42167863)

• Add create connection cancel return (issue #42167863)

• Add LEReadSupportedStates emboss event

• Add HCI Command OpCode definitions

• Add more emboss definitions (issue #42167863)

• Make SupportedCommands emboss struct more ergonomic

pw_bluetooth_proxy

• Release H4 buff on error

pw_bluetooth_sapphire

• Add common bt-host clang warnings (issue #345799180)

• Add new emboss compiler file ir_data_fields.py (issue #358665524, #335724776)

pw_build

The new glob_dirs() Starlark helper returns a list of directories matching the provided glob pattern. The new match_dir() Starlark helper returns a single directory that matches the provided glob pattern and fails if there’s more than one match.

• Add mod proc_macro to rust macro targets

• Remove output_name attr in rust_library

• Make pw_load_phase_test host only

• Add glob_dirs() Starlark helper

pw_channel

• Ensure that stream_channel_test resources live forever (issue #358078118)

pw_cpu_exception_cortex_m

• Fix cpu exception handler on armv8m (issue #323215726)

pw_display

The new pw_display experimental module provides graphic display support and framebuffer management.

• Color library (issue #359953386)

• Create module directory

pw_env_setup

• Get bazelisk instead of bazel (issue #355438774)

pw_grpc

When a frame with a payload has a stream-reset error, the payload is now skipped.

• Improve logging when receiving unknown RPC

• Skip HTTP2 frame payload for frames that result in stream reset

pw_i2c_rp2040

The clock_frequency field in pw::i2c::Rp2040Initiator::Config has been renamed to clock_frequency_hz.

• Include label in clock_frequency

pw_ide

pw_ide now searches all parent directories for the presence of a pigweed.json file to determine the root directory. The workspace root can be programmatically configured via the new pw_ide.settings.PigweedIdeSettings.workspace_root property. The pigweed.activateBazeliskInNewTerminals option in VS Code now defaults to false.

• Fix .pw_ide.yaml paths

• Support different workspace root

• Disable Bazelisk auto-activation by default (issue #358384211)

pw_kvs

References to pw::kvs::Key must be replaced with std::string_view.

• Remove unnecessary Key alias and test

• Pass EntryHeader by const reference (issue #254601862)

• Move inline variable definition to .cc file (issue #357162923)

pw_module

• Fix OWNERS file parsing

pw_multibuf

The pw::multibuf::MultiBuf::Chunks() method and pw::multibuf::MultiBuf::ChunkIterable class have been removed; use the new pw::multibuf::MultiBufChunks class instead.

• Restructure ChunkIterable

• Comment updates for consistency

pw_package

• Use bazel to build picotool package

pw_preprocessor

The new PW_MODIFY_DIAGNOSTIC_CLANG define lets you handle Clang-only warnings separately from other compilers.

• Test GCC/Clang diagnostic modification macros

• Introduce PW_MODIFY_DIAGNOSTIC_CLANG (issue #356935569)

• Expand comment for PW_PACKED

pw_rpc

Java client: The new PacketByteFactory Java class is a helper for creating request and response packets during testing.

Python client: The pw_rpc.console_tools.watchdog.Watchdog Python class has a new stop() method to stop the watchdog. The pw_rpc.callback_client.call.Call Python class now accepts a max_responses argument that lets you limit how many responses should be received after a streaming RPC call. The ignore_errors, cancel_duplicate_calls, and override_pending_options arguments previously available in some Python client methods have been removed.

TypeScript client: The invoke() method in the TypeScript client now accepts a maxResponses argument which lets you limit how many responses to a streaming RPC call should be stored.

• Avoid recompiling protos for every test (issue #360184800)

• Fix typing in unaryWait return value in TS client

• Create PacketByteFactory (issue #360174359)

• Add stop method to Watchdog (issue #350822543)

• Limit maximum stored responses in TypeScript client

• Add missing Bazel test rules

• Restore RpcIds for testing; move packet encoding to packets.py

• Limit maximum stored responses in Python client (issue #262749163)

• Remove deprecated / obsolete features

• Fix open in callback_client (issue #309159260)

• Merge PendingRpc and RpcIds

• Require an output function for channels

pw_spi_linux

• Remove linkage specification from cli main

pw_status

The StatusWithSize::size_or() method has been removed.

• Convert StatusWithSize to Doxygen

• Remove StatusWithSize::size_or()

pw_stream

• Disable mpsc_stream_test for Pi Pico (issue #361369435)

pw_system

The pw_system.device.Device class constructor now accepts an Iterable of proto libraries rather than a list.

• Add type annotation to pw_system.device.Device() write arg

• Update Device ctor to take Iterable of proto libraries

pw_thread

• Disable test_thread_context_facade_test on Pi Pico (issue #361369192)

pw_tokenizer

• Remove unsupported C++11 and C++14 code

pw_trace_tokenized

• Fix TokenizedTracer initialization (issue #357835484)

pw_transfer

Transfer handler registration and unregistration functions now return a boolean indicating success or failure. The C++ client now always includes a protocol version in the final chunk.

• Add return values to handler registrations

• Always set protocol version in final chunk

pw_unit_test

• Delete unsupported C++14 compatibility code

• Fix multi-line test macros

Docs

• Require unit tests to be in unnamed namespace

• Add structured data to Kudzu blog post (issue #360924425)

• Fix Pigweed Live CTA link (issue #357957451)

• Replace ‘bazel’ with ‘bazelisk’

• Update Sense flashing instructions

• Update RP2 family udev rules (issue #355291899)

• Update “Who’s using Pigweed” section

• Update Bazel quickstart mentions

• Launch Sense

Targets

rp2350

Pigweed now supports the new Raspberry Pi RP2350 MCU.

• Add support for RP2350 (issue #354942782)

rp2040

• Reset tty flags after successful flash on posix

• Remove references to b/261603269

• Add -fexceptions for the rp2040 PIO assembler

• Get Pico SDK and Picotool from BCR

Third-party software

Emboss

• Remove -Wdeprecated-copy from public_config (issue #345526399)

• Update emboss to v2024.0809.170004 (issue #345526399)

Fuchsia

• Update patch to ignore warnings in result.h

• Copybara import

Rolls

• fuchsia_infra: [roll] Roll fuchsia-infra-bazel-rules-bazel_sdk-ci

• fuchsia_infra 54 commits

• go

• rust

• go

• gn

• fuchsia_infra 27 commits

• rust

Miscellaneous

• Change typedef to using

• Handle ignored status comments (issues #357136096, #357139112)

Owners

• Add davidroth@

Aug 7, 2024

Highlights (Jul 26, 2024 to Aug 7, 2024):

• Tour of Pigweed: The new Tour of Pigweed is a hands-on, guided walkthrough of many key Pigweed features working together in a medium-complexity application.

• Easier pw_digital_io testing: The new pw::digital_io::DigitalInOutMock class is a mock implementation of pw:digital_io::DigitalInOut that can be used for testing.

• Code intelligence in VS Code: The new Code intelligence document provides guides on using the code intelligence features of the pw_ide extension for VS Code.

Build systems

Bazel

• Get picotool from the BCR (issue #354270165)

• Manage pw_ide deps via bzlmod (issue #258836641)

• Manage Java deps through bzlmod (issue #258836641)

• Provide symlink to clangd at root (issue #355655415)

• Partial revert of http://pwrev.dev/226007 (issue #352389854)

Modules

pw_allocator

• Fix bucketed block corruption (issue #345526413)

• Add missing include (issue #356667663)

pw_bluetooth

ReadLocalSupportedCommandsCommandCompleteEvent now provides both a raw bytes field (supported_commands_bytes) and a sub-struct (supported_commands) for easier access to command bits. You can use either SupportedCommandsOctet or SupportedCommands to parse a saved uint8_t[64].

• Improve ergonomics of emboss SupportedCommands

• Add more emboss definitions (issue #42167863)

pw_bluetooth_proxy

• Release active connections once zero

• Only log disconnect events for active connections

pw_bluetooth_sapphire

• Handle switch warning with pigweed (issue #355511476)

• Handle switch warning with pigweed (issue #355511476)

• Handle switch warning with pigweed (issue #355511476)

• Write Variable PIN Type for Legacy Pairing (issues #42173830, # b/342151162)

• Add LegacyPairingState to BrEdrConnectionRequest (issue #42173830)

• Create and implement LegacyPairingState class (issues #342150626, #42173830)

• Handle switch warning with pigweed (issue #355511476)

• Handle switch warning with pigweed (issue #355511476)

• Translate information & additional attributes (issue #327758656)

• Return registered services after bredr.Advertise (issue #327758656)

• Handle switch enum warning with pigweed (issue #355511476)

• Handle switch warning with pigweed (issue #355511476)

• Fix shadow variable warnings (issue #355511476)

• Add panic to EventTypeToString (issue #356388419)

• Switch over to pw::utf8 (issue #337305285)

• Remove unnecessary cast qual pragma (issue #355511476)

• Fix statement expression extension warnings (issue #355511476)

• Fix variadic macro warnings (issue #355511476)

• Add SetupDataPath FIDL handler (issue #311639690)

• Create abstract base for IsoStream

• Remove CommandPacketVariant (issue #42167863)

• Use emboss for setting ACL priority (issue #42167863)

• Add test for A2DP offloading (issue #330921787)

• Explicitly move WeakRef in GetWeakPtr (issue #354026910)

• Clean up some type sizes (issue #354057871)

• Use emboss for LELongTermKeyRequestReply (issue #42167863)

• Remove manufacturer list

pw_build

• Fix configs in pw_rust_executable (issue #343111481)

• Auto disable project builder progress bars

pw_chrono_stl

System clock and timer interfaces have been moved to separate directories so that you can pick up the backend of one of these without bringing in the other. This makes it possible to use a custom system timer with the STL system clock, for example.

• Move system clock and timer into separate directories

pw_clock_tree_mcuxpresso

The new pw::clock_tree::ClockMcuxpressoClockIp class lets you manage clock_ip_name_t clocks with the clock tree to save power when FSL_SDK_DISABLE_DRIVE_CLOCK_CONTROL is set.

• Introduce ClockMcuxpressoClockIp (issue #355486338)

pw_console

• Additional UI and code themes

• Bump version of console js, add titles to log panes

pw_digital_io

The new pw::digital_io::DigitalInOutMock class is a mock implementation of pw:digital_io::DigitalInOut that can be used for testing.

• Add Mock

pw_digital_io_linux

The default pw_log logging level changed from DEBUG to INFO.

• Set log level to INFO

pw_digital_io_rp2040

• Don’t discard status returns (issue #357090965)

pw_env_setup

• Update rust thumbv7m target

• Add rustc thumbv7m target (issue #343111481)

pw_hex_dump

• Add rule for pw_hex_dump/log_bytes.h (issue #357595992)

pw_ide

The Pigweed extension for VS Code will now immediately update the code analysis target if the pigweed.codeAnalysisTarget setting in settings.json is changed. The new pigweed.activateBazeliskInNewTerminals setting lets you specify whether the path to Bazelisk should be added when a VS Code terminal is launched. The new Code intelligence document provides guides on using the VS Code extension’s code intelligence features.

• VSC extension 1.3.2 release

• Show progress bar on manual refreshes

• Detect manual target change in settings

• Much faster VSC config parsing

• Automatically activate Bazelisk in new terminals

• Use stable clangd path (issue #355655415)

• Add inactive source file decoration

• VSC extension refactoring

pw_multibuf

• Add missing includes (issue #356667663)

pw_multisink

The new pw::multisink::Drain::GetUnreadEntriesCount() method is a thread-safe way to return the number of unread entries in a drain’s sink.

• Interface to read entries count (issue #355104976)

pw_presubmit

• Fix incl-lang when not at repo root

• Remove misc program (issue #356888002)

• Rename “misc” program to “sapphire” (issue #356888002)

• Add new presubmit steps (issue #356619766)

• Allow fxbug.dev and crbug.com TODOs

• Expose name of Bazel executable (issue #355438774)

pw_router

• Add missing includes (issue #356667663)

pw_rpc

• Fix TypeScript client streaming return type

• Add yield mode constraint_setting (issue #345199579)

pw_rust

The new pw_rust_USE_STD toolchain configuration option lets you control whether the “std” feature should be used when building executables.

• Add no_std build to basic_executable (issue #343111481)

• Rename host_executable (issue #343111481)

pw_spi_mcuxpresso

• Add SPI_RxError() and SPI_TxError()

pw_status

PW_STATUS_CFG_CHECK_IF_USED now defaults to true in Bazel projects, meaning that pw::Status objects returned from function calls must be used or else a compilation error is raised. See Unused result warnings.

• In Bazel, make Status nodiscard (issue #357090965)

• Don’t silently discard status returns (issue #357090965)

pw_symbolizer

• Add missing runfiles dep (issue #355527449)

• Get llvm-symbolizer path from Bazel (issue #355527449)

pw_system

The pw_system console now lets you control host log and device log levels separately via the new --host-log-level and --device-log-level arguments. The new echo(), reboot(), and crash() methods of pw_system.device.Device make it easier to access these common operations. Crash snapshots are now saved to /tmp (C:\\TEMP on Windows) by default. Crash detection logs are now printed across multiple lines to make them easier to spot.

• Separate host and device console log levels

• Don’t use implementation_deps (issues #304374970, #356667663)

• Add console device aliases for common RPCs

• Save snapshots to /tmp

• Make crash detection logs louder

pw_tokenizer

• decode_optionally_tokenized without a Detokenizer

pw_toolchain

• Clang support for Arm Cortex-M33 (issue #358108912)

• Register Cortex-M7 toolchain

• Use `crate_name` for GN rust targets

• proc_macro GN cross compile

• Rustc cross compile to qemu-clang (issue #343111481)

• Expose a symlink to clangd (issue #355655415)

pw_transfer

• Add a delay after opening a stream to delay transfer start (issue #355249134)

• Use initial timeout when resending start chunks

pw_web

The log viewer now defaults to using line wrapping in table cells. The new logViews property makes it easier to customize each individual log view. The severity field for controlling what types of logs to display has been renamed to level.

• Add resize handler to message col (issue #351901512)

• Change word-wrap to default true and save to state (issue #354283022)

• NPM version bump to 0.0.22

• Show REPL message at every run

• NPM version bump to 0.0.21

• Enable custom titles, log-view access (issue #355272099)

• Change severity to level (issue #354282161)

• Replace column menu with MWC components (issues #354712931, #342452087)

Docs

The new Tour of Pigweed is a hands-on, guided walkthrough of many key Pigweed features working together in a medium-complexity application.

• Start Sense tutorial

• Fix some bad links in the changelog

• Update changelog

Rolls

• gn

• fuchsia_infra 119 commits

• cmake

• rust

• Clang (issue #356689444)

• bazel_skylib

• rust

Third-party software

Emboss

• Append public_deps in GN template

ICU

• Remove ICU

STM32Cube

• bzlmod-friendly changes (issue #258836641)

Miscellaneous

• Run ‘pw format –fix’

Jul 25, 2024

Highlights (Jul 12, 2024 to Jul 25, 2024):

• Extensive Bazel support in the Pigweed extension for VS Code: See pw_ide for the full story.

• Bazel module support: Upstream Pigweed is now usable as a Bazel module dependency.

• Trapping backend for pw_assert: pw_assert_trap is a new backend for pw_assert that calls __builtin_trap() when an assert is triggered.

• Crash handling in async pw_system: Crash snapshots can be downloaded from pw_console by calling device.get_crash_snapshots() in the REPL.

Build systems

Bazel

Toolchain registration moved from WORKSPACE to MODULE.bazel, making it possible for downstream projects to use upstream Pigweed’s toolchains directly. Pigweed is now usable as a Bazel module dependency. Pigweed now provides an example .bazelrc at //pw_build/pigweed.bazelrc that downstream users can copy into their own projects.

• Remove @pigweed from bzl files (issue #352389854)

• Remove stray @pigweed in load statement (issue #352389854)

• Move toolchain registration to MODULE.bazel (issue #258836641)

• Enable bzlmod (issue #258836641)

• Remove sanitizers from default program (issue #301487567)

• Modernize pip deps style (2)

• Organize and document required flags (issue #353750350)

• Use Python toolchain in custom rules (issue #258836641)

• Use Python toolchain in custom rules (issue #258836641)

• Use Python toolchain in custom rules (issue #258836641)

• Modernize pip deps style (issue #258836641)

• Create separate “sanitizers” CI program (issue #301487567)

• Run under tsan, ubsan in presubmit (issue #301487567)

• Run tests with asan in CQ (issue #301487567)

Docs

The fonts on pigweed.dev have been updated.

• Prefer “change” to Google-specific “CL”

• Minor changelog update

• Update pigweed.dev fonts (issue #353530954)

• Minor updates

• Update changelog

Modules

pw_assert_trap

pw_assert_trap is a new backend for pw_assert that calls __builtin_trap() when an assert is triggered.

• Add a new assert backend which traps on assert (issues #351888988, #351886597)

pw_async2

The new pw::async2::CoroOrElseTask class lets you run a coroutine in a task and invokes a handler function on error. The new pw::async2::Task::IsRegistered() method checks if a task is currently registered with a dispatcher. The new pw::async2::Coro::Empty() method creates an empty, invalid coroutine object. The new pw::async2::Task::Deregister() method unlinks a task from a dispatcher and any associated waker values.

• Fix minor doc issues

• Add CoroOrElseTask

• Add Task::IsRegistered

• Add Coro::Empty

• Add Task::Deregister

pw_async2_epoll

• Fix block on racing wakeups

pw_bluetooth

• Generate emboss headers in Soong (issue #352364622)

• Add generic HCI command definition (issue #42167863)

pw_bluetooth_proxy

• Create Soong library for pw_bluetooth_proxy (issue #352393966)

• Update emboss deps

• Do not pass on NOCP events without credits (issue #353546115)

• Have functions handle passing on the packet (issue #353546115)

• Update tests to verify number of sent packets

• Remove debugging log (issue #353546115)

pw_bluetooth_sapphire

The latest pw_bluetooth_sapphire commits were brought into Pigweed from the Fuchsia repository.

• Reduce scope of security_manager (issue #337315598)

• Cleanup BrEdrConnectionManager test file

• Fix integer conversion warnings (issue #354057871)

• Cleanup WritePageScanType into shared test file

• Add missing optional include (issue #313665184)

• Remove unused method (issue #42167863)

• Remove variant from LE SendCommands (issue #42167863)

• Remove CommandPacketVariant (issue #42167863)

• Remove variant from QueueCommand (issue #42167863)

• Remove variant from QueueLeAsyncCommand (issue #42167863)

• Create IsoDataChannel (issue #311639040)

• Check legacy adv for rand addr in FakeController (issue #42161900)

• Use platform-independent format strings (issue #313665184)

• Processing of CIS Established event (issue #311639432)

• Use pw_bytes for endianness conversions (issue #313665184)

• Cleanup WritePageScanActivity

• Cleanup into shared test file

• Cleanup WriteLocalNameResponse to shared file

• Fix camel case for CIS acronym

• Cleanup Inquiry command packets into shared file

• Implement AcceptCis() (issue #311639432)

• Use pw_bytes for endianness conversions (issue #313665184)

• Use pw_bytes for endianness conversions (issue #313665184)

• Reorganize test_packets.h/.cc files

• Cleanup WriteInquiryScanActivity packets

• Use pw_bytes for endianness conversions (issue #313665184)

• Use pw_bytes for endianness conversions (issue #313665184)

• Use pw_bytes for endianness conversions (issue #313665184)

• Remove unneeded #include (issue #313665184)

• Use pw_bytes for endianness conversions (issue #313665184)

• Use pw_bytes for endianness conversions (issue #313665184)

• Use pw_bytes for endianness conversions (issue #313665184)

• Use pw_bytes for endianness conversions (issue #313665184)

• Rename link_initiated to outgoing_connection

• Cleanup WriteScanEnable packets into shared file

• Cleanup ReadScanEnable packets into shared file

• Remove alias for BrEdrConnectionRequest

• BrEdrConnectionRequest create HCI connection req

• Add connection role to fake controller (issue #311639432)

• Remove double std::move in PairingStateManager

• Fix BrEdrDynamicChannel crash (issue #42076625)

• Cleanup BrEdrConnectionRequest and Manager

• Implement IsoStreamServer (issue #311639275)

• Modernize fuchsia.hardware.bluetooth.Peer API (issue #330591131)

• Rename to secure_simple_pairing_state (issue #342150626)

• Use weak hci::BrEdrConnection pointer

• Create and use PairingStateManager class (issues #342150626, #42173830)

• Implement GetCodecLocalDelayRange (issue #311639690)

• Add Bazel rules for FIDL layer (issue #324105856)

• Refactor ScoConnection (issue #330590954)

• Fix max connection event length value (issue #323255182)

• Add AdvertisingData.ToString (issue #42157647)

• Make UUID string parsing optional (issue #339726884)

• Add Adapter::GetSupportedDelayRange (issue #311639690)

• Clean up legacy advertising report parsing API (issue #308500308)

• Add missing climits include (issue #338408169)

• Add Emboss support to SendCommand completion (issue #311639690)

• Improve naming of android namespace aliases (issue #335491380)

• Migrate emboss aliases to new names (issue #338068316)

• Add tests for LE Read Max. Adv. Data Length (issue #338058140)

• Ensure command is supported before issuing it (issue #338058140)

• Use duration_cast for constants (issue #337928450)

• Implement extended adv. pdus with fragmentation (issue #312898345, #309013696)

• Use `ull` constants for enums (issue #337928450)

• Update semantics of `bredr.Advertise` (issues #330590954, #327758656)

• Add the credit-based flow control RxEngine

• Migrate LEAdvertisingReportSubevent to Emboss (issue #86811)

• Lenient LEGetVendorCapabilitiesCommandComplete (issues #337947318, #332924521, #332924195)

• Migrate FIDL to bt::testing::TestLoopFixture (issue #324105856)

• Fix all available lint errors

• Move LinkKey simple constructors to the h file

• Add operator!= for LinkKey

• Add extra diagnostics

• Improve management of advertising modes (issue #309013696)

• Add Bazel rules for socket library (issue #324105856)

• Update LowEnergyAdvertiser to use std::vector (issue #312898345, #309013696)

• Add more values to LEEventMask

• Pass hci::AdvertisingIntervalRange as const

• Shorten pw::bluetooth::emboss to pwemb

• Pass extended_pdu booleans through the stack (issue #312898345, #309013696)

• Update AdvertisingHandleMap for extended PDUs (issue #312898345, #309013696)

• Update missing header (issue #331673100)

• Add the credit-based flow control TxEngine

• Prevent protected member access in TxEngine

• Add Bazel tests

• Fix conversions from iterators to raw pointers (issue #328282937)

• Add bt-host Bazel tests (issue #324105856)

• Low energy advertiser general cleanup

• Use using aliases for Emboss type references

• Add Bazel build files (issue #324105856)

pw_build

pw_py_binary is a new wrapper for py_binary that provides some defaults, such as marking all Python binaries as incompatible with MCUs.

• Introduce pw_py_binary (issue #258836641)

• Use incompatible_with_mcu in pw_py_test

pw_channel

The new pw::channel::StreamChannel adapter makes it easier for a channel to interact with an underlying reader and writer stream.

• Add StreamChannel adapter

pw_chrono_freertos

• Work around no std::unique_lock in baremetal libc++ (issue #353601672)

pw_chrono_stl

• Consolidate SystemTimer into a single thread

pw_console

Typing out RPCs to invoke from the web console REPL should now autocomplete as expected. The web console log viewer now has a default config, defined at //pw_console/py/pw_console/html/defaultconfig.json. A new boolean config option, recolor_log_lines_to_match_level, has been added to allow users to control whether log messages should be restyled to match their severity level.

• Fix RPC autocompletion in web kernel

• Set a default config for web console’s log viewer

• Pass rpc completions to web_kernel

• Add config option for log message recoloring

• Default WebHandler.kernel_params to an empty dictionary

• Handle web logging in a separate thread

• Cleanup web kernel on page close

• Replace placeholder page with real web console

pw_cpu_exception_cortex_m

The new PW_CPU_EXCEPTION_CORTEX_M_CRASH_ANALYSIS_INCLUDE_PC_LR option lets you control whether PC and LR register values are included in the AnalyzeCpuStateAndCrash() analysis.

• Make PC LR optional

• Fix assembly (issue #261603269)

• Temporarily disable tests on Cortex-M33 (issues #353533678, #323215726)

pw_crypto

• Don’t build micro-ecc (issue #261603269)

pw_env_setup

• Add luci-cv to environment

pw_grpc

• Fix shadowed variable warning

pw_ide

General updates: pw_ide now detects Bazel projects based on the presence of MODULE.bazel files. The pw_ide docs have been revamped. Shared VS Code settings can now be stored in .vscode/settings.shared.json. The extension no longer attempts to infer the working directory if a project root isn’t explicitly provided; instead it prompts users to manually specify the project root. The VS Code extension now has better support for Fish terminals.

VS Code extension updates related to code intelligence in Bazel-based projects: The new Pigweed: Select Code Analysis Target command controls which Bazel target in your project to use for code intelligence. The new Pigweed: Refresh Compile Commands command lets you manually refresh code intelligence data. There’s also a Pigweed: Refresh Compile Commands and Select Code Analysis Target that combines these two steps. In the VS Code status bar there’s a new icon to indicate whether clangd code intelligence is on or off. Code intelligence data compilation output is now streamed so that you can monitor the progress of the tool in real-time. The easiest way to access these logs is by running the new Pigweed: Open Output Panel command. The extension now supports a .clangd.shared file that can be used to control project-wide clangd settings.

VS Code extension updates related to other Bazel tools: The extension now bundles Bazelisk and Buildifier. These bundled versions get updated when the extension itself updates. The extension recommends users to use these bundled versions by default. You can use the new Activate Bazelisk in Terminal command to manually specify which Bazelisk version to use.

• Support bzlmod projects

• Block on spawned refresh process

• Status bar item for inactive file disabling

• Support disabling clangd for inactive files

• Update vendored tools on extension update

• Use vendored Bazelisk in recommended config

• Improve VSC settings interface

• Add shared settings management

• Associate target groups with active files

• Don’t unnecessarily infer working dir

• VSC extension 1.1.1 release

• Add missing command stubs

• Stream refresh compile commands output

• Update dev build configs

• Add fish to Bazelisk+VSC terminal

• VSC extension 1.1.0 release

• Patch Bazelisk into VSC terminal

• VSC extension 1.0.0 release

• Revise docs

• Update VSC extension packaging

• Add proto extension as dependency

• Fix VSC troubleshooting links

• Update compile commands tool version

• Don’t show root comp DB dir as target

• VSC status bar item for target selection

• Add IDE support refresh manager

• Integrate Bazelisk in VSC

• Bazel comp DB management in VSC

• VSC/JS project management

• Create VSC settings interface

• Use VSC output panel for logging

• VSC extension cleanup

pw_kvs

• Missing <string> includes (issue #298822102)

• Update bazel config

pw_libcxx

pw_libcxx now has support for the new operator.

• Actually implement operator delete

• Add operator new

pw_log

• Log decoder timestamp cleanup

• Fix log_decoder timestamp formatting (issue #351905996)

pw_multibuf

• Add more context on chunk regions

pw_presubmit

pw_presubmit.inclusive_language.check_file now accepts an optional check_path argument which controls whether to check the path for non-inclusive language.

• Add attributes to docstring

• Allow disabling checks in unit tests (issue #352515663)

• No copyright check in .vscodeignore

• Skip commit message check for merges

• Add test for inclusive language check (issue #352515663)

pw_result

• Fix docs.rst example

• Add missing header (issue #261603269)

• Missing <string> includes (issue #298822102)

pw_rpc

Soong proto building is now more flexible; genrules can now have protos from different sources. .option files can now be used in Soong genrules sources.

• Build proto path arg list for Soong

• Pass .proto files to compiler in Soong

pw_rpc_transport

• Don’t write empty header in StreamRpcFrameSender

pw_sensor

• Add units to sensor::channels final output (issue #293466822)

• Implement attributes, channels, triggers, and units (issue #293466822)

pw_stream

• Update bazel config

pw_stream_uart_mcuxpresso

• Check init state in Deinit()

pw_string

The new pw::utf8::ReadCodePoint(), pw::utf8::EncodeCodePoint(), and pw::utf8::WriteCodePoint() methods provide basic UTF-8 decoding and encoding.

• Add utf_codecs (issue #337305285)

• Disable wchar test for libcpp (issue #353604434)

pw_sync

The condition variable interface has been deprecated. See Condition Variables.

• Document that CV should not be used (issue #294395229)

pw_system

Async pw_system now supports a crash handling service. When a crash snapshot is available, pw_system now logs instructions on how to download it. The pw_system console API now accepts an optional device_connection object, allowing for more flexible connection management. Device class creation has been refactored to make it easier for Python scripts to setup connections to devices in the same way that the pw_system console does. As part of this refactor the --output and --proto-globs flags were removed from the pw_system console.

• Enable crash handler in async system

• Improve message when crash snapshot exists (issue #354767156)

• Add crash handling and device service (issue #350807773)

• Make pw_system_console work for rp2040 (issue #354203490)

• Console device connection override

• Add synchronization to pw::System allocator (issues #352592037, #352818465)

• Reusable DeviceConnection functionality

pw_target_runner

• Increase maximum message size for binaries

pw_thread

The new pw::thread::TestThreadContext() interface makes it easier to create threads for unit tests.

• Add TestThreadContext for FreeRTOS

pw_tokenizer

• Missing <string> includes (issue #298822102)

pw_toolchain

The new minimum_cxx_20() Bazel helper can be used with target_compatible_with attributes to express that a target requires C++20 or newer.

• Select Bazel C++ version with config_setting (issue #352379527)

• Hide toolchain path behind variable (issue #258836641)

• Add linux_sysroot.bzl (issue #258836641)

• Host clang toolchain for Bazel

• Pico Bazel build (issue #261603269)

• Add tsan support for host builds (issue #301487567)

• Add ubsan support for host builds

pw_trace_tokenized

• Fix bazel build (issues #260641850, #258071921)

pw_transfer

The new PW_TRANSFER_EVENT_PROCESSING_TIMEOUT_MS lets you control how long incoming transfer events should block on the previous event being processed before dropping the new event.

• Don’t block indefinitely on events

• Fix initial timeout and missing start chunk

pw_unit_test

• Removed duplicate from forwarded variables list in pw_test

• Update logging_main compatibility

• Missing <string> includes (issue #298822102)

• Introduce googtest_platform (issue #352808542)

pw_web

The REPL in the web console now provides a welcome message that lists commonly used keyboard shortcuts. The log viewer UI is now more dense. The REPL is now positioned on the left by default. Pressing Shift+Enter in the REPL now goes to a new line rather than evaluating.

• Add icon for info (issue #354282161)

• Fix keyboard shortcut in repl.rst

• Add repl intro message and title param (issue #354283703)

• Increase default log viewer density (issues # 354282977, # 342451299)

• Move REPL to left, reduce default division to 40%

• Fix bug in code editor to not eval empty snippet

• NPM version bump to 0.0.20

• Change repl keybinding to eval

• Bundle console.ts, fix log source handlers

• Save state on input change and adjust filter logs logic (issue #235253336)

• Add filter field buttons and placeholder

Third-party software

Emboss

Emboss was updated to v2024.0718.173957. Emboss build steps that involve Python now use an optimized version of Python, resulting in a 15% speedup.

• Disable using pw_python_action (issue #354195492)

• Update emboss repo to v2024.0718.173957 (issue #354195492)

• Run python with optimization on (issue #354195492)

• Make emboss_runner_py Soong target (issue #352364622)

• Remove -Wno-format-invalid-specifier

• Update emboss repo to v2024.0716.040724 (issue #353533164)

Go

• Create a Pigweed-wide go.mod file (issue #258836641)

Miscellaneous

Rolls

FreeRTOS was updated to version 10.5.1.bcr.2. CMake was bumped to version 3@3.30.1.chromium.8. Rust was updated to Git revision 73a228116ae8c8ce73e309eee8c730ce90feac78.

• FreeRTOS for upstream (issue #355203454)

• FreeRTOS

• cmake

• rust

• rules_python (issue #258836641)

• Fuchsia SDK (issues #258836641, #353749536)

• 310, 311

Targets

RP2040

• Add pw_libcxx as dep for system_async_example

• Import statement fix (issue #258836641)

• Enhance on-device testing instructions

• Fix assert basic termination behavior

Jul 11, 2024

Highlights (Jun 28, 2024 to Jul 11, 2024):

• Bazel 8 pre-release: Upstream Pigweed is now using a pre-release version of Bazel 8, the first version to include platform-based flags.

• ARMv6-M support: pw_cpu_exception_cortex_m now supports ARMv6-M cores.

• Browser-based pw_system console: The new --browser option lets you start a pw_system console in a web browser rather than the default Python-based terminal console.

• Updated pw_rpc docs: The pw_rpc docs have been revamped to make getting started easier and to provide more Bazel guidance.

Build systems

Bazel

Pigweed is now using version 8.0.0-pre.20240618.2 of Bazel, the first version to include platform-based flags. Some backend collection targets are now being provided as dictionaries to enable downstream projects to use the pattern described in Provide default backend collections as dicts. The incompatible_with_mcu Bazel helper has been introduced to help express whether a target is only compatible with platforms that have a full-featured OS.

• Run all tests with googletest backend in CI (issue #352584464)

• Add missing dependencies (issue #352584464)

• Don’t propagate flags to exec config (issues #234877642, #315871648)

• Provide backend collections as dicts (issue #344654805)

• Roll out incompatible_with_mcu (issue #348008794)

• Introduce incompatible_with_mcu (issue #348008794, #343481391)

• Add back to CI some building targets (issue #261603269)

Docs

• Fix shortlink URL

• Add shortlink to pw_enviro draft

• Update changelog

Modules

pw_allocator

A bug was fixed that caused builds to break when -Wmissing-template-arg-list-after-template-kw is turned on.

• Remove unnecessary template

pw_assert

Downstream projects using Bazel now need to set the new backend label flags @pigweed//pw_assert:check_backend and @pigweed//pw_assert:check_backend_impl and include them in their link deps.

• Split up Bazel assert backend, part 2 (issue #350585010)

• Split up Bazel assert backend, part 1 (issue #350585010)

pw_async2

• Add missing thread_stl dependency

pw_async2_epoll

• Use unordered_map; silence persistent warnings

pw_async_basic

• Fix size report build error (issue #350780546)

pw_bluetooth

• Format emboss files

pw_bluetooth_proxy

pw::bluetooth::proxy::sendGattNotify() (lowercase first letter) has been removed; use pw::bluetooth::proxy::SendGattNotify() (uppercase first letter) instead. The new pw::bluetooth::proxy::GetNumSimultaneousAclSendsSupported() function returns the max number of LE ACL sends that can be in-flight at one time. The new pw::bluetooth::proxy::AclDataChannel::Reset() and pw::bluetooth::proxy::ProxyHost::Reset() methods let you reset the internal state of those classes.

• Delete “sendGattNotify” (issue #350106534)

• Include <optional> in proxy_host.h

• ProxyHost supports multiple sends (issues #348680331, #326499764)

• Remove unneeded PW_EXCLUSIVE_LOCKS_REQUIRED (issue #350106534)

• Soft transition to SendGattNotify (issue #350106534)

• Add ProxyHost/AclDataChannel::Reset() (issue #350497803)

• Dedup NOCP construction in tests

• Document which events are expected (issue #326499764)

• Adjust const for pw::span (issue #326497489)

• Remove use of <mutex> (issue #350009505)

• Prevent crash in GattNotifyTest

pw_bluetooth_sapphire

• Remove modulo operator from asserts

• Add Bazel build files to lib/ packages

• Use pwemb namespace alias in FakeController

• Unmask LE Connection Complete

• Implement ExtendedLowEnergyConnector (issue #305976440)

• Enable bt-host component (issues #303116559, # b/324109634, #326079781, # b/325142183)

• Support ISO Channel FIDL Protocol in Drivers (issue #328457492, issue # b/328459391)

• Add ISO support to controllers (issue #311639690)

• Tag integration test (issue #344654806)

• Implement ExtendedLowEnergyScanner (issue #305975969)

• Add packet filtering consts to vendor protocol

• Update LEAdvertisers to use EmbossCommandPacket (issue #312896684)

• Use Emboss for android vendor exts multi advert (issue #312896673)

• Use Emboss versions of a2dp offload structs

• Refactor LowEnergyScanResult to its own class

• Refactor TxEngine to allow queueing SDUs

• Add incoming CIS request handler

• Add IsoStreamManager class

• Add CIS events and commands (issue #311639432)

• Retrieve sleep clock accuracy for peers (issue #311639272)

• Fix LowEnergyScanner crash (issue #323098126)

• Remove unused include

• Add infrastructure for SCA operations (issue #311639272)

• Use Write instead of UncheckedWrite

• Remove now unnecessary use of std::optional

• Expose connection role to le handle (issue #311639432)

• Disambiguate comment

• Fix typo in comment

pw_build

The new macros in //pw_build:merge_flags.bzl help with using platform-based flags.

• Add flags_from_dict (issue #301334234)

pw_cli

pw_cli has increased support for letting users select from interactive prompts. The RP2040 flasher utility uses the new interactive prompting features to let users select which detected device to flash.

• Interactive user index prompt

pw_console

• Headless mode with web/ws server running

pw_cpu_exception

• Remove multiplexers (issue #347998044)

pw_cpu_exception_cortex_m

pw_cpu_exception_cortex_m now supports ARMv6-M cores.

• Add armv6-m support (issues #350747553, #350747562)

pw_digital_io_rp2040

The new enable_pull_up and enable_pull_down fields in the pw::digital_io::Rp2040Config struct let you configure whether resistors should be pulled up or down.

• Add pull up/down resistors to Rp2040Config

• Remove manual tags (issue #261603269)

pw_env_setup

• Use full paths for proj action imports

pw_function

• Dynamic allocation for upstream host

pw_log_string

• Require backend_impl to be set explicitly

pw_malloc_freertos

• Fix typo (issue #351945325)

pw_presubmit

• Narrow copyright notice exclusions (issue #347062591)

• Add copyright notice to some test data (issue #347062591)

• Exclude test_data from bazel_lint

• Exclude files from copyright

• Don’t automatically use exclusions (issue #347274642)

pw_rpc

The pw_rpc docs have been revamped to make getting started easier and to provide more Bazel guidance.

• Expand comment for internal::ClientServerTestComment

• Update docs (issue #349832019)

pw_stream_uart_mcuxpresso

• Clean up dma stream comments

pw_sys_io

• Remove multiplexer, constraints (issue #347998044)

pw_sys_io_baremetal_stm32f429

Bazel projects should now set the --@pigweed//pw_sys_io:backend label flag to @pigweed//pw_sys_io_baremetal_stm32f429 and add the @pigweed//pw_sys_io_baremetal_stm32f429:compatible constraint to their platform to indicate that the platform is compatible with pw_sys_io_baremetal_stm32f429.

• Add constraint (issue #347998044)

pw_sys_io_stm32cube

• Remove target_compatible_with (issue #347998044)

pw_system

The new --browser option lets you start a browser-based pw_system console instead of a terminal-based one.Thread stack sizes for the new async version of pw_system can now be configured with PW_SYSTEM_ASYNC_LOG_THREAD_STACK_SIZE_BYTES, PW_SYSTEM_ASYNC_RPC_THREAD_STACK_SIZE_BYTES, PW_SYSTEM_ASYNC_TRANSFER_THREAD_STACK_SIZE_BYTES, and PW_SYSTEM_ASYNC_DISPATCHER_THREAD_STACK_SIZE_BYTES. The new pw::system::AsyncCore::RunOnce() method provides a way to run a function once on a separate thread. The --ipython option has been removed from the pw_system console. See Embeddeding other interpreters for guidance on how to embed IPython.

• Add web console option

• Add missing work queue thread

• Clean up pw_system/threads.cc

• Configurable thread stack sizes

• RunOnce function for work queue functionality

• Remove IPython from pw_system console

• Organize pw_system:async build targets

pw_thread

• Remove backend multiplexers (issue #347998044)

pw_thread_stl

The pw::thread::Thread::native_handle() method now returns a pointer to the underlying thread object instead of a reference and the docs have been updated to make it clear that using this is inherently non-portable.

• Change NativeThreadHandle to ptr (issue #350349092)

pw_toolchain

Go binaries have been updated to no longer link with position-independent executables (PIE) on Linux.

• Disable PIE for Golang (issue #347708308)

pw_toolchain_bazel

• Add native binary for clang-tidy (issue #352343585)

pw_trace

• Remove backend multiplexer (issue #347998044)

pw_transfer

• Don’t assert on resource status responder

pw_unit_test

• Fix CMake test runner argument forwarding

pw_web

Upstream Pigweed protos are now provided alongside downstream project protos.

• Include core .proto files in the npm bundle

• Add newlines, separators, and clear for output (issue #348650028)

• Set min width for message (issue #351901512)

• Implement console-level split panels (issue #348649945)

• Update REPL styles (issue #348650028)

• Repl kernel interface and litjs component for repl

• Fix columns on first load (issue #346869281)

• Debounce grid template calc on resize (issues #346596380, #342450728)

Rolls

Pigweed is now using version 8.0.0-pre.20240618.2 of Bazel, the first version to include platform-based flags. Go was updated to version 3@1.22.5. CMake was updated to version 3@3.30.0.chromium.8.

• Update Bazel to 8.0 rolling release (issue #344013743)

• Update Bazel to 7.2 (issue #347708308)

• go

• cmake

• 310, 311

Targets

RP2040

The RP2040 flasher now provides more feedback when a board has been successfully flashed.

• Fix FreeRTOS tick rate (issue #351906735)

• Log on successful flash (issue #352052013)

• Fix build command in docs

Third-party software

Emboss

Emboss was updated to version 2024.0702.215418.

• Add missing ir_data_utils.py to GN build (issue #350970460)

• Update emboss to v2024.0702.215418 (issue #350970460)

FreeRTOS

• Add missing CM33_NTZ header

GoogleTest

• Fix the docs (issue #352584464)

ICU

• Update Bazel rules for dependent headers

• Add Bazel build rules (issue #321300565)

Mbed TLS

• Remove old build file

• Rename build file

Miscellaneous

GitHub

• Add copyright notice (issue #347062591)

dotfiles

• Add copyright notice (issue #347062591)

Jun 27, 2024

Highlights (Jun 14, 2024 to Jun 27, 2024):

• RP2040 implementation for pw_channel: pw::channel::Rp2StdioChannelInit() is a new pw_channel implementation that reads from and writes to RP2040’s stdio.

• Bazel compatibility patterns guide: The new Bazel build compatibility patterns guide describes the Bazel patterns that Pigweed uses to express that a build target is compatible with a platform.

• Hex dump helper: The new pw::dump::LogBytes() helper makes it easier to log binary data as human-readable hex dumps. The number of input bytes to display per line can be configured via the kBytesPerLine template parameter.

Build systems

Bazel

The obsolete testonly_freertos platform has been removed.

• Encapsulate rp2040 WORKSPACE deps into deps.bazl

• Update pin for rules_libusb

• Update TODO in bazelrc (issue #347317581)

• Stop using deprecated pw_facade aliases, v3 (issue #328679085)

• Stop using deprecated pw_facade aliases, v2 (issue #328679085)

• Remove testonly_freertos platform

• Remove unnecessary @pigweed references

• Add clippy to CI (issue #268087116)

Docs

The new Bazel installation guide provides Pigweed’s recommendations on how to install Bazel. The Set up GitHub Actions for a Pigweed project guide was updated. The new Bazel build compatibility patterns guide describes the Bazel patterns that Pigweed uses to express that a build target is compatible with a platform.

• Add emboss to packages installed for build_docs

• Remove mention of multiplexers (issue #344654805)

• Add OWNERS

• Add Bazel installation guide

• Update GitHub actions tutorial

• Update Pigweed Live schedule (issue #347677570)

• Bazel compatibility patterns (issue #344654805)

• Update changelog

Modules

pw_allocator

The //pw_allocator:block_allocator target has been removed. Consumers are now expected to depend on and include individual block allocator targets.

• Use specific block allocator headers and targets

• Fix Android build

• Clean up Block interface (issue #326509341)

pw_assert

• Remove backend multiplexer (issue #347998044)

pw_bluetooth

New Emboss structs added: NumberOfCompletedPacketsEvent, WritePinTypeCommandCompleteEvent, PinCodeRequestNegativeReplyCommandCompleteEvent, ReadPinTypeCommandCompleteEvent, PinCodeRequestEvent, PinCodeRequestReplyCommandCompleteEvent, WritePinTypeCommand, ReadPinTypeCommand, PinCodeRequestNegativeReplyCommand, PinCodeRequestReplyCommand.

• Add NumberOfCompletedPacketsEvent (issue #326499764)

• Add AttNotifyOverAcl to att.emb

• Add PinCodeRequestEvent (issue #342151162)

• Add IoCapability enum field

• Add ACL & L2CAP B-frame Emboss definitions (issue #326499764)

• Add att.emb (issue #326499764)

• Add WritePinTypeCommandCompleteEvent Emboss struct (issue #342151162)

• Add ReadPinTypeCommandCompleteEvent Emboss struct (issue #342151162)

• Add PinCodeRequestNegativeReplyCommandCompleteEvent Emboss (issue #342151162)

• Add PinCodeRequestReplyCommandCompleteEvent Emboss struct (issue #342151162)

• Add WritePinTypeCommand Emboss struct (issue #342151162)

• Add ReadPinTypeCommand Emboss struct (issue #342151162)

• Add PinCodeRequestNegativeReplyCommand Emboss struct (issue #342151162)

• Add PinCodeRequestReplyCommand Emboss struct (issue #342151162)

• Add PinType enum (issue #342151162)

pw_bluetooth_proxy

The new pw::bluetooth::proxy::AclDataChannel::ProcessDisconnectionCompleteEvent() method frees up resources when a connection is removed. The new pw::bluetooth::proxy::AclDataChannel::ProcessNumberOfCompletedPacketsEvent() method removes completed packets as necessary to reclaim LE ACL credits. The new pw::bluetooth::proxy::ProxyHost::sendGattNotify() method is a simple implementation of sending a GATT notification to a connected peer.

• Process Disconnection_Complete event (issue #326499764)

• Implement basic ACL credit tracking (issue #326499764)

• Implement sendGattNotify (issue #326499764)

• Have release_fn take buffer* (issue #326499764)

• Add GetH4Span (issue #326499764)

• Add release_fn to H4PacketWithH4 (issue #326499764)

• Fix case style for some test variables (issue #326499764)

• Move to-controller flow to using h4-based packets (issue #326499764)

• Add H4PacketWithH4 ctor that takes type (issue #326499764)

• Move H4Packet to using move semantics (issue #326499764)

• Fix naming of SetH4Type (issue #326499764)

• Move to using H4Packet wrapper classes (issues #326499764, #326497489)

pw_bluetooth_sapphire

• Move LegacyLowEnergyScanner impl to base class

• Add spec reference to comment (issue #311639040)

pw_boot

• Remove backend multiplexer (issue #347998044)

pw_build

The BuildCommand Python class now has an optional working_dir argument that allows you to specify the working directory in which a build command should be executed. The new boolean_constraint_value syntactic sugar macro makes it easier to declare a constraint setting with just two possible constraint values.

• Add optional working directory arg to BuildCommand (issue #328083083)

• Introduce boolean_constraint_value (issue #344654805)

• Move host_backend_alias (part 2) (issue #344654805)

pw_build_android

Dynamic allocation for pw::Function is now always enabled in Android builds to allow pw::Function to exceed the inline size limit.

• Enable function dynamic alloc (issue #349352849)

pw_build_info

The new //pw_build_info:git_build_info Bazel rule lets you embed which Git commit your binary was built from.

• Add git_build_info.h header for embedding git info

pw_build_mcuxpresso

The type for the include parameter in the pw_build_mcuxpresso.components.Project Python class constructor changed from list[str] to Collection[str] and the type for the exclude parameter changed from list[str] to Container[str]. pw_build_mcuxpresso.bazel.bazel_output() now accepts an optional extra_args argument, which is a dictionary of additional arguments to be added to the generated Bazel target.

• Fix bug in create_project()

• Add extra_args to bazel.bazel_output()

pw_channel

pw::channel::Rp2StdioChannelInit() is a new pw_channel implementation that reads from and writes to RP2040’s stdio.

• Add Rp2StdioChannel

• Cleanup redundant checks in epoll_channel

pw_chrono

The new pw_targets_FREERTOS_BACKEND_GROUP GN rule sets FreeRTOS backends for pw_chrono, pw_sync, and pw_thread in one go. Each backend can be individually overridden if needed.

• Add docs metadata

• Group common backends in the GN build

pw_cli

• Add missing modules to Bazel build

• Improve messaging for GitErrors

pw_clock_tree

The new pw::clock_tree::ClockTree::AcquireWith() method lets you acquire a clock tree element while enabling another one.

• Introduce ClockTree AcquireWith method (issue #331672574)

pw_clock_tree_mcuxpresso

AcquireWith() should now be used when enabling clock tree elements that are sourced from the audio PLL or SYS PLL.

• Use AcquireWith for audio PLL (issue #331672574)

pw_cpu_exception_cortex_m

• rm backend multiplexer (issue #347998044)

pw_docgen

• Add bug Docutils role

pw_emu

pw_emu now supports Bazel.

• Add bazel python build

pw_env_setup

The version of cffi that pw_env_setup uses was updated to 1.16.0 to fix Windows failures. The “fatal error” that pw_env_setup used to log when running from a directory that’s outside of a Git repo has been suppressed.

• Update cffi (issue #348697900)

• Suppress error message when running outside git repo

pw_format

• Fix and enable disabled Rust tests

pw_grpc

The C++ module now handles corrupt frames more gracefully.

• Avoid buffer overflow when processing corrupt frames

pw_hex_dump

The pw_log_bytes target has been renamed to log_bytes. The new pw::dump::LogBytes() helper makes it easier to log binary data as human-readable hex dumps. The number of input bytes to display per line can be configured via the kBytesPerLine template parameter.

• Remove pw prefix from log_bytes

• Add LogBytes helper

pw_i2c

• Handle unaligned buffer reads in register_device_test (issue #325509758)

pw_ide

A --process-files (-P) flag was added to pw ide cpp to process compilation databases at the provided paths. Bazel support for pw_ide has started. pw_ide now explicitly runs all commands from the PW_PROJECT_ROOT directory.

• Point to compile commands extractor fork

• Add option to process comp DBs by path

• Add Bazel dependencies wrapper

• Bazelify

• Run commands from PW_PROJECT_ROOT dir

pw_log

• Remove backend multiplexer (issue #347998044)

pw_malloc

• Add docs metadata

pw_multibuf

• Fix Android build

pw_preprocessor

• Add docs metadata

pw_presubmit

• Add check for rp2040_binary transition

• Build STM32F429i baremetal in CI

pw_rpc

• Restructure Channel / internal::Channel

pw_rust

• Static Library Linking

pw_spi_mcuxpresso

• Separate Bazel build targets

• Fix unused parameter warning (issue #348512572)

pw_sync

The new pw_targets_FREERTOS_BACKEND_GROUP GN rule sets FreeRTOS backends for pw_chrono, pw_sync, and pw_thread in one go. Each backend can be individually overridden if needed.

• Remove multiplexers (issue #347998044)

• Group common backends in the GN build

pw_system

pw_system:async is a new version of pw_system based on pw_async2. The pw_system console now has a --device-tracing flag to turn device tracing on or off.

• pw_system:async

• Async packet processing component

• Rename target_io.cc

• Allow disabling of DeviceTracing RPC calls

pw_target_runner

The pw_target_runner client in Go now supports a server_suggestion flag, which allows specifying a command to suggest to the user if the server is unavailable. The Go client’s RunBinary method can now accept a binary as a byte array instead of a file path.

• Add suggested server command

• Send test binaries over gRPC

pw_thread

The new pw_targets_FREERTOS_BACKEND_GROUP GN rule sets FreeRTOS backends for pw_chrono, pw_sync, and pw_thread in one go. Each backend can be individually overridden if needed.

• Group common backends in the GN build

pw_toolchain

Compiler diagnostics colors are now enabled in Bazel.

• Color diagnostics in Bazel

• Closer align the bazel arm-gcc flags with GN

• Add clippy-driver to rust toolchains (issue #268087116)

pw_transfer

• Java style fixes; remove unused variable and dependencies

pw_watch

pw_watch now ignores bazel-* directories.

• Do not watch bazel-* symlinks

pw_web

The function signature for createLogViewer changed to createLogViewer(logSource, root, { columnOrder }). The columnOrder field in the optional third parameter lets you control the ordering of columns in the log viewer.The new useShoelaceFeatures boolean lets you control whether the log viewer uses Shoelace components. The log viewer’s toolbar is now responsive.

• Add optional parameters to createLogViewer (issue #333537914)

• Add Shoelace component flag (issue #347966938)

• Implement responsive toolbar behavior (issue #309650360)

Languages

Python

• Add python targets for pw_i2c, pw_digital_io protos

Rust

• Fix clippy lints

Miscellaneous

OWNERS

• Add gwsq

Targets

References to configGENERATE_RUN_TIME_STATS have been removed because the implementations are incomplete.

• Remove configGENERATE_RUN_TIME_STATS functions

RP2040

The new flash_rp2040 rule makes it easier to flash Raspberry Pi RP2040s in Bazel.The new flash Bazel rule makes it easier to flash RP2040s from a Python script.

• Add pw_system_async example

• Mark rp2040_binary as a non-executable target for host

• Update docs

• Add debugprobe version detection and warning

• Switch to use upstream develop branch of Pico SDK

• Add IFTT to keep the rp2040 transition and config in sync

• Add missing backends

• Unify board selection cmdline args (issue #348067379)

• Add a bazel rule for flashing

• Add interrupt and freertos backends

• Add flash main target

• Add rp2040_binary transition

• Refactor test runner and extract flashing

Third-party

FreeRTOS

configUSE_MALLOC_FAILED_HOOK can now be enabled to detect out-of-memory errors when using FreeRTOS’s heap implementation.

• Add failed malloc hook to support lib

• Fix Bazel build

Nanopb

• Import proto module

Pico SDK

• Fix exception names in GN build (issue #347355069)

Jun 13, 2024

Highlights (May 30, 2024 to Jun 13, 2024):

• pw_allocator support in pw_mallc: pw_malloc now supports pw_allocator-based backends.

• New pw_build Bazel rules: pw_py_test rule wraps py_test, pw_elf_to_dump takes a binary executable and produces a text file containing the full binary layout, and pw_elf_to_bin rule takes a binary executable and produces a file with all ELF headers removed.

• Improved Fish shell support: The pw and pw build commands now support Fish shell completion. The new bootstrap.fish script demonstrates how to bootstrap a Pigweed project from a Fish shell and makes it easier for Fish users to contribute to upstream Pigweed.

• More informative modules index: The modules index now shoes useful metadata for each module, such as a summary of the module’s purpose and the programming languages that the module supports.

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::Layout constructor is now marked explicit to ensure that functions that take Layout instances as arguments don’t silently accept and convert other types. The pw::allocator::FreeList and pw::allocator::FreeListHeap interfaces have been removed.

• Make Layout constructor explicit

• Remove FreeList and FreeListHeap (issue #328076428)

• Refactor Bucket chunk list (issue #345526413)

pw_analog

• Add module metadata (issue #339741960)

pw_android_toolchain

• Add module metadata (issue #339741960)

pw_arduino_build

• Add module metadata (issue #339741960)

pw_assert

• Add module metadata (issue #339741960)

pw_async

• Add module metadata (issue #339741960)

pw_async2

• Fix location of backends in sitenav (issue #339741960)

pw_base64

• Add module metadata (issue #339741960)

pw_bloat

• Build and run `pw bloat` CLI command in Bazel

• Add module metadata (issue #339741960)

pw_blob_store

• Add module metadata (issue #339741960)

pw_bluetooth

• Add module metadata (issue #339741960)

• Add HCI StatusCode values

pw_bluetooth_hci

• Add module metadata (issue #339741960)

pw_bluetooth_profiles

• Add module metadata (issue #339741960)

pw_bluetooth_proxy

The new pw::bluetooth::proxy::HasSendAclCapability() function indicates whether the proxy has the capability to send ACL packets.

• Remove H4HciPacketSendFn alias (issue #326499764)

• Fix const on sendGattNotify param (issue #326499764)

• Mark unused parameters with [[maybe_unused]] (issue #345526399)

• Add maybe_unused to make downstream happy (issue #344031126)

• Add ProxyHost::HasSendAclCapability() (issue #344030724)

• Update H4HciPacket construction

• Add sendGattNotify stub (issue #344031126)

• Fix compilation errors

• Pass H4 as event type plus an HCI span (issue #326499611)

• Tweak CreateNonInteractingToHostBuffer to take array (issue #326499611)

pw_boot_cortex_m

• Add module metadata

pw_build

The new pw_py_test rule wraps py_test and defaults to setting target_compatible_with to host only. The new pw_elf_to_dump rule takes a binary executable and produces a text file containing the full binary layout. The new pw_elf_to_bin rule takes a binary executable and produces a file with all ELF headers removed.

• Move host_backend_alias (part 1) (issue #344654805)

• Add python.install into the default GN group

• Introduce pw_py_test to bazel

• Add module metadata (issue #339741960)

• Clarify docs on pw_elf_to_bin

• Update intro (issue #339741960)

• Add pw_elf_to_dump rule

• Add pw_elf_to_bin rule

• Populate executable field in return from link_cc utility

pw_build_info

• Add module metadata

pw_build_mcuxpresso

• Add module metadata (issue #339741960)

pw_bytes

• Add module metadata (issue #339741960)

pw_channel

• Add module metadata (issue #339741960)

• Update function documentation

• Remove manual registration from epoll channel

pw_checksum

• Add module metadata (issue #339741960)

pw_chre

• Add module metadata (issue #339741960)

pw_chrono

libc time wrappers are now provided to improve compatibility with software not written for embedded systems that depends on gettimeofday and time from POSIX.

• Group common backends in the GN build

• Introduce SystemClock backed link time wrappers

pw_cli

The pw and pw build commands now support Fish shell completion.

• Fish shell completion

pw_clock_tree

The new pw::clock_tree::ClockSourceNoOp class can be used to satisfy the dependency of a source clock tree element for other clock source classes. The new pw::clock_tree::ElementController class provides easier integration of optional clock tree logic into existing drivers.

• Introduce ClockSourceNoOp class (issue #331672574)

• Introduce ElementController class (issue #331672574)

• Fix source set name and visibility (issue #331672574)

pw_clock_tree_mcuxpresso

• Comment clean up (issue #331672574)

• Add ClockMcuxpressoRtc support (issue #331672574)

• Remove unnecessary pw:: (issue #331672574)

• Add ClockMcuxpressoAudioPll support (issue #331672574)

• Configure ClkIn as source for osc_clk (issue #331672574)

• Make Mclk and ClkIn dependent elements (issue #331672574)

• Move example code out of docs (issue #331672574)

• Fix source set name and visibility (issue #331672574)

pw_console

Theme colors are now correctly applied when running pw console with the --config-file option.

• Reload theme when using a config-file

pw_containers

The pw::Vector::at() function signature was changed to take size_t instead of size_type. The new pw::InlineVarLenEntryQueue::try_push() function is similar to pw::InlineVarLenEntryQueue::push_overwrite() but it drops entries instead of overwriting old ones. The new pw::InlineVarLenEntryQueue::max_size() function returns the maximum number of empty entries.

• Make Vector::at() use size_t

• Disallow deletion from InlineVarLenEntryQueue base

• InlineVarLenEntryQueue::try_push() function

pw_digital_io

• Remove invalid digital_io_controller reference

pw_digital_io_linux

pw_digital_io_linux now supports input interrupts. The new watch command in the CLI tool configures a GPIO line as an input and watches for interrupt events.

• Add trigger option to CLI watch command

• Add “watch” command

• Add support for input interrupts

• Move examples out to compiled source files

• Update mock_vfs

• Add log_errno.h

pw_docgen

• Update module metadata status badge colors (issue #339741960)

• Add module metadata (issue #339741960)

• Fix search results increasing in width

pw_env_setup

The new bootstrap.fish script demonstrates how to bootstrap a Pigweed project from a Fish shell and makes it easier for Fish users to contribute to upstream Pigweed.

• Update clang next version

• Bootstrap fish-shell support

pw_grpc

• Remove send queue timeout (issue #345088816)

pw_ide

• Add module metadata

• Preserve modified editor settings (issue #344681641)

• Fix constant Pylance crashes (issue #338607100)

pw_log

• Add module metadata (issue #339741960)

• Cast log level to int32_t (issue #343518613)

pw_log_string

• Introduce link time assert() wrapper for newlib

• Set default log backend

pw_malloc

pw_malloc now supports pw_allocator-based backends.

• Add allocator backends

pw_multibuf

The new pw::multibuf::MultiBuf::IsContiguous() method checks if a multibuf is contiguous and the new pw::multibuf::MultiBuf::ContiguousSpan() method provides a way to access contiguous data as a span. The new CopyTo(), CopyFrom(), and CopyFromAndTruncate() methods also simplify interactions with contiguous byte spans.

• Contiguous span functions

• Functions for copying into and out of a MultiBuf

• Truncate after an iterator

• AdvanceToData in iterator constructor

• Fix Truncate(0) on empty MultiBuf

• SimpleAllocatorForTest

pw_multisink

The new pw::multisink::MultiSink::GetUnreadEntriesSize() and pw::multisink::MultiSink::UnsafeGetUnreadEntriesSize() methods implement 0124: Interfaces for Retrieving Size Information from Multisink. The new PW_MULTISINK_CONFIG_LOCK_TYPE macro configures the underlying lock that’s used to guard multisink reads or writes.

• Add GetUnreadEntriesSize to Drain

• Add option to inject a user defined lock

pw_presubmit

• Add –fresh to cmake presubmits

• Add coverage of rp2040 build (issue #342638018)

• Add module metadata (issue #339741960)

• Remove shellcheck from lintformat program

pw_protobuf

• Add module metadata (issue #339741960)

pw_ring_buffer

• Add EntriesSize API to Reader (issue #337150071)

pw_router

• Add module metadata (issue #339741960)

pw_rpc

The Python client API now uses positional-only arguments.

• Use positional-only arguments in Python client API

• Add module metadata (issue #339741960)

• Fix hyperlink

pw_sensor

• Add Bazel support for Python package

pw_spi

• Fix sitenav location for RP2040 backend (issue #339741960)

pw_spi_rp2040

• Add module metadata (issue #339741960)

pw_stream

• Fix include in mpsc_stream

pw_stream_uart_mcuxpresso

• Make dma_stream Write of size 0 succeed

• InterruptSafeWriter example (issue #343773769)

• Stream example (issue #343773769)

• Use clock tree (issue #331672574)

• DMA stream example (issue #343773769)

pw_sync

The new pw_targets_FREERTOS_BACKEND_GROUP GN rule sets up multiple modules to use FreeRTOS backends.

• Group common backends in the GN build

pw_system

pw-system-console now connects to the first detected port if --device isn’t provided and only one port is detected or it shows an interactive prompt if multiple ports are detected. Building and running the demo now shows how to run pw-system-console with host_device_simulator in Bazel-based projects.

• Console interactive serial port selection (issue #343949763)

• Host device simulator entrypoint

• Move config variables to config.h

• Mention that extra libs need alwayslink

• Add host_device_simulator transitions

pw_target_runner

• Switch to Bazel build

• Add module metadata (issue #339741960)

pw_thread

• Group common backends in the GN build

pw_thread_freertos

• Expand comment to help when debugging linker errors

pw_toolchain

• Enable PIC on host

• Add bazel toolchain for cortex-m0plus (issue #346609655)

• Add module metadata (issue #339741960)

• Add IOKit and Security headers to mac toolchains

pw_toolchain_bazel

• Add cortex-a32 mcpu value (issue #342510882)

pw_transfer

• Remove unused imports

• Fix ConcurrentModificationException in handleTimeouts() (issue #322919275)

• Always terminate transfers on stream reopen

pw_uart

• Add module metadata (issue #339741960)

pw_varint

• Add module metadata (issue #339741960)

pw_watch

Watching now works in directories other than PW_ROOT.

• Enable watching from non-PW_ROOT (issue #328083083)

pw_web

• Get icon fonts via Google Fonts URL (issue #332587834)

• Fix last column filling space in log table

Build systems

Bazel

• Stop using deprecated pw_facade aliases (issue #328679085)

• Don’t use llvm_toolchain for fuchsia_clang (issue #346354914)

• Fix reference to nonexistent file

• Roll latest rules_libusb

• No integration tests in wildcard build (issue #344654806)

• Move integration build config in-repo (issue #344654806)

Hardware targets

host_device_simulator

• Make host_device_simulator_binary `bazel run`-able

rp2040

• Add bazel picotool support

• Add bazel support for rp2040_utils pylib (issue #342634966)

• Support running tests using the debug probe

• Add pico/debug probe filtering flags

• Temporarily disable remaining failing rp2040 tests

• Fix test runner scripts to correct check if args are specified

• Support bazel wildcard build on rp2040 (issue #343467774)

stm32f429i

• Add baremetal bazel build support (issue #344661765)

OS support

Zephyr

• Fix typo

FreeRTOS

FreeRTOS application function implementations like vApplicationStackOverflowHook() are now shared between multiple hardware targets.

• Share common FreeRTOS function implementations

Docs

The modules index now includes metadata for each module such as a summary of each module and what languages each module supports. The pigweed.dev sitenav was simplified. Pigweed Blog #2: Feature flags in Bazel builds was published. A “skip to main content” accessibility feature was added to pigweed.dev.

• Fix Python package dependencies for sphinx

• Auto-generate modules index from metadata (issue #339741960)

• Update sitenav

• Update homepage tagline

• Add “skip to main content” a11y feature (issue #344643289)

• blog: Bazel feature flags

• Update changelog

Third-party software support

• Add @libusb to bazel workspace

• Symlink probe-rs binary into common location

• Add probe-rs

mimxrt595

• Upgrade to SDK_2_14_0_EVK-MIMXRT59 (issue #343775421)

GitHub

• Fix step name

io_bazel_rules_go

• Update to fork which disables warnings

pigweed.json

• Add config for Bazel builders (issue #275107504)

May 30, 2024

Highlights (May 17, 2024 to May 30, 2024):

• Clock management: The new pw_clock_tree module manages generic clock tree elements such as clocks, clock selectors, and clock dividers.

• GitHub Actions: The new Set up GitHub Actions for a Pigweed project guide shows you how to set up GitHub Actions to build and test a Bazel-based Pigweed project when a pull request is received.

• pw_system and Bazel: pw_system usage in Bazel has been simplified by gathering all required pw_system components into one target and providing label flags that can set platform-dependent dependencies.

• Channels and Linux Epoll: The new pw::channel::EpollChannel class sends and receives data through a file descriptor, with read and write notifications backed by Linux’s epoll system.

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 BlockAllocator::MeasureFragmentation

• Fix Android build

• Refactor optional Allocator methods

• Make Init methods infallible (issue #338389412)

• Reduce Block fragmentation (issue #328831791)

• Fix #if PW_HAVE_FEATURE(__cpp_rtti) (issue #341975367)

• Track requested sizes in blocks

• Fix Android build (issue #A)

• Move large values to test fixtures

• Add AsPmrAllocator

pw_assert

• Add missing dep in Android.bp

pw_build

The new PW_MUST_PLACE macro ensures that linker script inputs are non-zero sized.

• Introduce PW_MUST_PLACE linker script macro

• Add deps support to pw_linker_script (issue #331927492)

pw_channel

The new pw::channel::EpollChannel class sends and receives data through a file descriptor, with read and write notifications backed by Linux’s epoll system.

• Only open read/write if channel is readable/writable

• Add EpollChannel

• Consistent datagram/byte channel aliases

pw_chre

• Update CHRE revision (issue #341137451)

pw_clock_tree

The new pw_clock_tree module manages generic clock tree elements such as clocks, clock selectors, and clock dividers.

• Introduce new ClockDivider class (issue #331672574)

• ClockTree support Element ops (issue #331672574)

• Introduce Element may_block() (issue #331672574)

• Generic clock tree management (issue #331672574)

pw_clock_tree_mcuxpresso

The new pw_clock_tree_mcuxpresso module is an NXP MCUXPresso backend for pw_clock_tree.

• Mcuxpresso module (issue #331672574)

pw_config_loader

• Remove unnecessary dep

pw_cpu_exception_cortex_m

The new crash analysis API provides data about CPU state during exceptions. See Crash Facade Setup.

• Add crash analysis API

• Fix incorrect inputs to util_test

• Fix checks for ARMv8

pw_emu

• Exclude tests module from the Pigweed Python package

pw_env_setup

• PyPI version bump to 0.0.16

• Build an extra example pypi distribution

• Remove f-strings from github_visitor

pw_grpc

• Fix warnings in format strings

pw_hex_dump

• Add Android.bp

pw_libcxx

• Only enable in clang builds

pw_log_basic

• Fixing sign conversion error for logging

pw_multisink

• Fix compiler warnings for tests (issue #343480404)

pw_preprocessor

• Remove PW_HAVE_FEATURE (issue #341975367)

pw_rpc

• Include FakeChannelOutput in soong target (issue #340350973)

pw_spi_mcuxpresso

• Remove unnecessary debug messages

pw_stream_uart_mcuxpresso

• Fix unused parameter warnings

pw_system

pw_system usage in Bazel has been simplified by gathering all required pw_system components into one target and providing label flags that can set platform-dependent dependencies.

• Simplify pw_system usage in Bazel (issue #341144405)

pw_thread

• Fix thread snapshot service test

pw_toolchain

• Add manual tag to Rust toolchains (issue #342695883)

• Add clang-apply-replacements plugin (issue #339294894)

pw_transfer

• Fix transfer_thread_test initialization order

• End active transfers when RPC stream changes

pw_uart

• Add pw_uart to CMakeLists

pw_unit_test

• Don’t execute multiple test suites at the same time

• Ensure alignment of test fixtures

pw_web

• Move shoelace split panel import

• Add split/resize view guide in docs

• Implement split log views with resize (issue #333891204)

Build

Bazel

Clang’s AddressSanitizer is now supported. See Clang sanitizers.

• Support asan in Bazel (issue #301487567)

• Update rules_rust to 0.45.1 (issue #342673389)

• Explicitly load rules_python in BUILD.bazel files

Targets

rp2040

• Additional bazel build file coverage (issue #303255049, issue #305746219)

• Enable thread high water accounting

• Update docs to add missing picotool dependency

• Save test run log files

• Increase RPC thread stack size to 16K

• Allow using rp2040 devices in bootloader mode

• Refresh target docs

• Update openocd flashing instructions

• Increase device_detector verbosity

• Add upstream Bazel platform definition

• Renable tests that pass with larger stack frames

• Raise minimal stack size to 1KB

• Replace exceptions with logging

OS support

freertos

• Clarify Bazel documentation

Docs

The new Set up GitHub Actions for a Pigweed project guide shows you how to set up GitHub Actions to build and test a Pigweed project when a pull request is received.

• Add notes about GitHub Actions (issue #338083578)

• Instructions for freertos.BUILD.bazel

• Create files in current directory

• Update changelog

Miscellaneous

• Fix typo succesfully->successfully

• Update Android.bp after GetAlignedSubspan move

• Add link to format

May 16, 2024

Highlights (May 2, 2024 to May 16, 2024):

• Coroutines: You can now create asynchronous tasks using C++20 coroutines.

• Rust with Bazel: The Rust toolchain can now be used by downstream projects using Bazel.

• More MCUXpresso support: Several modules have additional support for projects built using the NXP MCUXpresso SDK, including multiple core support in pw_build_mcuxpresso, a new initiator in pw_i2c_mcuxpresso, a new responder in pw_spi_mcuxpresso, and a new pw_dma_mcuxpresso module.

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

• Fix data race (issue #333386065)

• Add BucketBlockAllocator

• Improve namespacing

• Use singletons for stateless allocators

pw_assert

• Ensure condition does not contain stray % (issue #337268540)

pw_async2

C++20 users can now define asynchronous tasks using Coroutines.

• Move PW_CO_TRY functions

• Add Coro<T> coroutine API

pw_bloat

Padding is now included as part of utilization in code size reports. This allows developers to monitor changes in application size that smaller than the used space alignment defined in the linker script.

• Add padding to utilization (issue #276370736)

pw_bluetooth

• Add a constant for max controller delay

• Put cmake tests in modules group

• Disable emboss enum traits (issue #339029458)

• Remove hci_vendor (issue #338269786)

pw_bluetooth_proxy

• Also support V2 of LE read buffer event (issue #326499611)

• Use LE read buffer event (issue #326499611)

• Removing trailing comma in PW_LOG call (issue #326499611)

• Allow setting the # of credits to reserve (issue #326499611)

• Add cmake build rules (issue #326499611)

• Update tests to remove RVNO assumptions (issue #326499611)

• Reserve ACL LE slots from host (issue #326499611)

pw_boot_cortex_m

• Emit pw_boot_Entry without prologue (issue #339107121)

pw_build

• pw_cc_test.lib fixup (issue #307825072, issue #341109859)

• Fix type hint (issue #338462905)

pw_build_mcuxpresso

pw_build_mcuxpresso now can support multiple device cores.

• Support multiple cores

pw_config_loader

• Add missing types dep

pw_cpu_exception_cortex_m

• Add error flag masks

• Fix PSP unit test

pw_digital_io_linux

• Add test_utils.h for ASSERT_OK and friends

• Minor updates to OwnedFd

• Refactor test

pw_dma_mcuxpresso

pw_dma_mcuxpresso is a new module for working with an MCUXpresso DMA controller.

• Module for working with NXP DMA controller

pw_docs

• Add inline search to sidebar

pw_env_setup

• Remove f-strings from github_visitor

• Change Bazel library name (issue #340328100)

• Add GitHub environment visitor (issue #340900493)

• Bazel support for config_file (issue #340328100)

pw_format

• Add Rust support for field width and zero padding

• Add Rust support for formatting integers in hex

• Add test for escaped curly brackets

• Refactor format string parsing for better core::fmt support

pw_i2c

• Update OWNERS

pw_i2c_mcuxpresso

The new I3cMcuxpressoInitiator implements the pw_i2c initiator interface using the MCUXpresso I3C driver, allowing normal I2C API’s to work after setup.

• Fix Clang compilation

• Add i3c initiator

• Remove swatiwagh from OWNERS

pw_ide

• Add .pw_ide.user.yaml to .gitignore

• Raise specific error on bad settings file (issue #336799314)

pw_libcxx

Added initial support for using LLVM’s libcxx as a standard C++ library implementation.

• Minimal implementation

pw_log

Logging messages with untyped string arguments is now supported in the Rust implementation.

• Make TODO actionable

• Add core::fmt style format string support to Rust API

• Rename Rust logging API to be less verbose

• Add Rust support for untyped strings

pw_multibuf

• Remove deprecated Chunk::DiscardFront

pw_package

• Suppress package progress messages

pw_presubmit

• Auto fix unsorted-dict-items (issue #340637744)

• Fix missing pico-sdk for docs_build

• Add repo tool API

• Exclude all OWNERS from copyright

pw_proto

• Create genrule for raw rpc with prefix (issue #340749161)

pw_protobuf

• Build common.proto with Nanopb+Soong (issue #340350973)

pw_protobuf_compiler

• Disable layering check less (issue #323749176)

• Fix name collisions

• Disable layering_check (issue #339280821)

• Fix bazel failure if proto dir is empty (issue #328311416)

• Add a no_prefix test (issue #328311416)

• Tests fail to build under cmake (issue #338622044)

pw_result

• Fix typo in template member (issue #339794389)

pw_rpc

• Include FakeChannelOutput in soong target (issue #340350973)

• Update docs for channel ID remapping

• Build compatibility fixes

• Fix macro name in docs and comments

pw_spi_mcuxpresso

The pw_spi_mcuxpresso module now includes an McuxpressoResponder useing the SPI and DMA drivers from the NXP MCUXpresso SDK.

• Add responder implementation

pw_stm32cube_build

• Fix a label flag name in documentation

pw_sys_io_rp2040

• Bazel build file update (issue #261603269, issue #300318025)

pw_sys_io_stdio

• Expand allowed uses beyond host

pw_sys_io_stm32cube

• Fix build for f1xx family

pw_tokenizer

• Clean up rust docs

pw_toolchain

Pigweed’s Rust toolchain can now be used by downstream projects.

• Fix typos in newlib_os_interface_stubs.cc

• Add clang-apply-replacements plugin (issue #339294894)

• Support Rust toolchains in downstream projects

• Add clang-apply-replacements plugin (issue #339294894)

• Fix CMake build on macOS

• Add no-canonical-system-headers (issue #319665090)

pw_trace_tokenized

• Build compatibility fixes

pw_transfer

The transfer service now ends active transfers when the underlying stream changes, avoiding a case where a transfer could become stuck.

• End active transfers when RPC stream changes

• Add tests for GetResourceStatus

• Add py_proto_library target for update_bundle_proto

• GetResoureStatus fix missing return

• Lock resource_responder_ access

pw_unit_test

• Add missing :config dependency for gtest backend

Build

bazel

• Ignore reformatting change in git blame (issue #340637744)

• Fix unsorted-dict-items instances (issue #340637744)

• Remove unnecessary .bazelrc flag (issue #319665090)

• Re-enable sandbox_hermetic_tmp (issue #319665090)

Targets

targets/rp2040

• pre_init and freertos config (issue #261603269, 300318025)

Docs

• Update changelog

SEEDs

SEED-0116

• Set status to On Hold

Third party

third_party/emboss

• Use absolute paths in source dependencies (issue #339467547)

• Update emboss repo to tag v2024.0501.215421 (issue #338675057)

• Add additional owners for emboss

third_party/freertos

• Add CM3 support to Bazel build

third_party/perfetto

• Rename proto targets

• Add third party perfetto repo

• Copybara import

Miscellaneous

• Run clang-format

• Add roller as WORKSPACE owner (issue #245397913)

May 1, 2024

Highlights (Apr 19, 2024 to May 1, 2024):

• Thread kickoff via pw::Function: Revamped the Thread API to use pw::Function. The original Thread API was created before pw::Function was stable; this change modernizes and increases usability of the Thread API.

• Thread creation SEED: Creating threads in Pigweed is difficult due to our strict adherence to portability. We’re considering creating an additional API that is more usable but less portable than the current approach.

• Transfer: Adaptive windowing got a Java implementation, and improvements to adaptive windowing in C++.

• Bluetooth: Initial CLs towards a Bluetooth proxy.

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

Added two new allocators: BuddyAlloctor and BumpAllocator (also known as an arena allocator). Various cleanups and fixes, including splitting the Block-based allocators to their own files.

• Add missing return statement (issue #337761967)

• Remove conflict marker

• Move FallbackAllocator implementation

• Clean up LibCAllocatorTest

• Move block allocators to separate files

• Add BuddyAllocator

• Make AllMetrics internal

• Fix SynchonizedAllocator data race (issue #333386065)

• Add BumpAllocator

pw_assert

• Fix support for print_and_abort in Bazel (issue #337271435)

pw_async

• Add missing dispatcher facades to CMake (issue #335866562)

pw_bluetooth

Continue filling out Bluetooth packet definitions; as well as some API extensions for e.g. RSSI control.

• Add header alias in command complete events (issue #326499611)

• Add Event Codes to emboss (issue #338068316)

• Add opcode_enum to command and response event (issue #338068316)

• Sync with recent APCF changes (issue #336608891)

• Define Common Data Types (issue #336608891)

• Add LoopbackCommandEvent (issue #336579564)

• Support Read RSSI command and event (issue #336566041)

• Comment why we include all emboss headers in emboss_test (issue #326499611)

• Correct emboss path in doc example (issue #326499650)

pw_bluetooth_*

• Formatting fixes

pw_bluetooth_proxy

Start building the Bluetooth proxy subsystem.

• Rename ProcessH4 to HandleH4 (issue #326499611)

• Rename passthrough_test.cc to proxy_host_test.cc (issue #326499611)

• Move ProxyHost methods to .cc (issue #326499611)

• Rename HciProxy to ProxyHost (issue #326499611)

• Delete policies functionality (issue #326499611)

• Add some emboss helper functions (issue #326499611)

• Template test emboss packet creation (issue #326499611)

• Fix ordering of TEST arguments (issue #326499611)

pw_build

• Add a `test_main param to pw_cc_test <https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/206851>`__ (issue #337277617)

• Fix using pw_cc_blob_library target in external repos

pw_build_info

• Make the python module importable

pw_cli

New SEED creation tool reduces the burden to create SEEDs. This will open the door to more contributors creating SEEDs for Pigweed changes and enhancements.

• Add SEED creation to CLI tool

• Handle custom arguments in tools

• Add git_repo.py and test to Bazel build

pw_containers

• Omit size on FlatMap construction

pw_cpu_exception_cortex_m

• Add util_test to tests

pw_digital_io_linux

• Move OwnedFd to its own header file

pw_env_setup

• Update default sysroot version (issue #335438711)

pw_format

• Better explain core::fmt whitespace parsing in ccomments

• Add support for core::fmt style format strings

pw_grpc

• Support fragmented gRPC messages if an allocator is provided (issue #323924487)

pw_module

• Include :authors: in generated SEED file

pw_presubmit

• Separate ‘bazel info’ stderr (issue #332357274)

• Save ‘bazel info output_base’

• Remove –verbose_explanations flag

• Use _LOG global for logging

• RST format updates

• Allow disabling hook creation

• Drop ‘.’ from Bazel symlinks (issue #332357274)

pw_protobuf

• Fix support for import_prefix on protos with options

pw_rpc

Enhancements in pw_rpc to better integrate with pw_grpc.

• Add private method for sending internal::Packet directly (issue #319162657)

pw_rust

• Build examples in presubmit (issue #337951363)

• Fix Rust tokenized logging example

pw_sensors

Sensors subsystem continues moving along; note that most of the discussion and development is happening in the SEEDs.

• Add support for triggers (issue #293466822)

pw_snapshot

• Add python processor tests

• Fix Bazel builds

pw_spi_mcuxpresso

• Rename flexspi to flexio_spi

• Fix Bazel build

pw_stream_uart_mcuxpresso

• Add interrupt safe write-only UART stream

pw_string

• Add ToString for iterables

• Add missing array include

pw_thread

API change to bring pw_thread up to date with pw::Function; see overview.

• Use pw::Function to start threads (issue #243018475)

• Fix pw_thread_zephyr compilability

pw_thread_threadx

• Remove unused dependency

pw_tls_client

• Add CMake facades (issue #335878898)

pw_tokenizer

Enhance the C++ host-side decoder to better handle the full suite of capabilities, in particulaur, recursive decoding; also some build fixes.

• Add DecodeOptionallyTokenizedData

• Switch detokenize.h docs to Doxygen

• Support arbitrary recursion in C++ detokenizer

• Add missing CMake dep

pw_toolchain

• Add clang-tidy suggestion

pw_transfer

Adaptive windowing improvements, including C++ enhancementsn to better handle small window sizes, as well as adding a Java implementation.

• Add resource_id to all GetResourceStatus responses (issue #336364832)

• Assume a minimum window size when reserving space

• Attempt to recover when receiving invalid size

• Implement adaptive windowing in Java

pw_unit_test

• Add support for a test_main in CMake (issue #335865646)

• Standardize ASSERT_OK_AND_ASSIGN

• Clarify status macros are gunit-only

• Add IWYU export/private pragmas (issue #335291547)

pw_web

• Fix icons in packaged version

• Fix text download format

• NPM version bump to 0.0.19

• Add user guide page for features and filter syntax (issue #307560371)

Docs

docs

• Mention @deprecated in the Doxygen style guide

• Update module docs contributor guidelines

• Add GitHub pull request template

• Require Bazel+GN+CMake for new contributions

• Update changelog

SEEDs

• SEED-0124: Getting Used Size from Multisink (issue #326854807) landed

• SEED-0128: Easier thread creation started

• SEED-0129: Support PW_ASSERT with non-argument message started

Miscellaneous

• Run clang-format

• Remove remaining usages of legacy thread entry

• Replace `string_view& with string_view <https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/204591>`__

.bazelversion

• Add file (issue #336617748)

Third party

• boringssl: Add CMake integration (issue #335880025)

• emboss: Update emboss repo to tag v2024.0419.155605 (issue #335724776)

• emboss: Use COMPILE_LANGUAGE:CXX (issue #336267050)

• fuchsia: Add defer.h to Bazel build defs (issue #337275846)

• npm: Update package-lock.json

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, issue #321267476)

pw_build

• Disable deprecated pragma warnings (issue #333448202, issue #333448202)

• Iterators (issue #333448202, issue #335024633, 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 Try it out!.

• 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 Try it out!.

• 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 Try it out!.

• 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 overridden

• 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 review guidelines 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 review guidelines 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 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 Visual Studio Code.

• 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 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)