roll: pigweed pw_containers: Add pw::Hash functor This change introduces `pw::Hash`, a general-purpose hashing framework. This framework consists of two main components: - `pw::Hash`: A functor that computes the hash of a given value. - `pw::HashState`: A stateful object that allows combining multiple values into a single hash. Hashing is implemented with a clear precedence: 1. A `PwHashValue` ADL-descoverable friend function for custom types. 2. Built-in support for pointers and enums. 3. A fallback to `std::hash` for standard library and other compatible types. This design allows types to be made hashable by either providing a `PwHashValue` overload or a `std::hash` specialization. Unit tests are included to cover basic types, pointers, enums, and the custom type hashing mechanisms. Original-Bug: 464156130 Original-Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/pigweed/+/355592 Original-Revision: 5dbeba6c9b4e7e9a55cd01a994f38916d50fd2ff Rolled-Repo: https://pigweed.googlesource.com/pigweed/pigweed Rolled-Commits: ea07decce2ea96..5dbeba6c9b4e7e Roll-Count: 1 Roller-URL: https://cr-buildbucket.appspot.com/build/8691008948896851105 GitWatcher: ignore CQ-Do-Not-Cancel-Tryjobs: true Change-Id: Ie90c243f7bb0c0842a7a1242b0a0e5fed0e3e44c Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/quickstart/bazel/+/370473 Bot-Commit: Pigweed Roller <pigweed-roller@pigweed-service-accounts.iam.gserviceaccount.com> Commit-Queue: Pigweed Roller <pigweed-roller@pigweed-service-accounts.iam.gserviceaccount.com> Lint: Lint 🤖 <android-build-ayeaye@system.gserviceaccount.com>
This repository contains a minimal example of a Bazel-based Pigweed project. It is a LED-blinking service (featuring RPC control!) for the Raspberry Pi Pico. It can also be run on any computer using the included simulator.
git clone https://pigweed.googlesource.com/pigweed/quickstart/bazel pw_bazel_quickstart cd pw_bazel_quickstart
The only dependency that must be installed is Bazelisk.
Bazelisk is a launcher for the Bazel build system that allows for easy management of multiple Bazel versions.
Instructions for installing Bazelisk can be found here.
To run the simulator, type: bazelisk run //apps/blinky:simulator_blinky Then, in a new console, connect to the simulator using: bazelisk run //apps/blinky:simulator_console
To start, connect a Raspberry Pi Pico, Pico 2, or debug probe via USB.
To run on the Raspberry Pi Pico, type: bazelisk run //apps/blinky:flash_rp2040 Then, in a new console, connect to the device using: bazelisk run //apps/blinky:rp2040_console
Once connected with a console, RPCs can be sent to control the LED. Try running:
device.set_led(True) device.set_led(False) device.toggle_led() device.blink(blink_count=3)
bazelisk test //... will run the unit tests defined in this project, such as the ones in modules/blinky/blinky_test.cc.
bazelisk run @pigweed//targets/rp2040/py:unit_test_server in one console followed by bazelisk test //... --config=rp2040 will also allow running the unit tests on-device.
Try poking around the codebase for inspiration about how Pigweed projects can be organized. Most of the relevant code in this quickstart (including RPC definitions) is inside modules/blinky, with some client-side Python code in tools/console.py.