|author||Wyatt Hepler <email@example.com>||Tue Feb 04 07:36:45 2020 -0800|
|committer||Wyatt Hepler <firstname.lastname@example.org>||Tue Feb 04 16:35:40 2020 -0800|
pw_kvs: Get checksums working; enable test - Allow checksums to verify data larger than their internal state. This facilitates using a CRC16 in a uint32_t. - Move checksum functions to the EntryHeader class, since it ultimately stores the checksums and is included with it. - Enable one checksum test. Further tests are needed. - Make some tweaks to the Get overload for objects. Change-Id: I989b72905e140794f75c8f8619aaab1623f6f195
Pigweed is a collection of embedded-focused libraries, called “modules”. These modules are designed for small-footprint MMU-less microcontrollers like the ST Micro STM32L452 or the Nordic NRF82832. The modules are designed to facilitate easy integration into existing codebases.
Some Pigweed modules have been used in the development of Google’s first-party devices, including the Stadia Controller and Pixel Buds.
Pigweed is in the early stages of development, and should be considered experimental. We’re continuing to evolve the platform and add new modules. We value developer feedback along the way.
Pigweed is an open source project with a code of conduct that we expect everyone who interacts with the project to respect.
$ git clone sso://pigweed.googlesource.com/pigweed/pigweed ~/pigweed $ cd ~/pigweed $ env_setup/cipd/wrapper.py auth-login # Once per machine. $ . env_setup/bootstrap.sh
You can use
. env_setup/env_setup.sh in place of
. env_setup/bootstrap.sh. Both should work every time, but
bootstrap.sh tends to remove and reinstall things at the expense of time whereas
env_setup.sh tends to do basic checks to see if time can be saved by skipping expensive operations.
If you‘re using Homebrew and you get an error saying
module 'http.client' has no attribute 'HTTPSConnection' then your Homebrew Python was not set up to support SSL. Ensure it’s installed with
brew install openssl and then run
brew uninstall python && brew install python. After that things should work.
The environment setup script will pull down the versions of tools necessary to build Pigweed and add them to your environment. You can then build with GN, CMake, or Bazel. You can also confirm you're getting the right versions of tools—they should be installed under
Build for the host with GN
$ which gn ~/pigweed/.cipd/pigweed.ensure/gn $ gn gen out/host $ ninja -C out/host
Build for the host with CMake
$ which cmake ~/pigweed/.cipd/pigweed.ensure/bin/cmake $ cmake -B out/cmake-host -S . -G Ninja $ ninja -C out/cmake-host
Build for the host with Bazel
$ which bazel ~/pigweed/.cipd/pigweed.ensure/bazel $ bazel test //...
Build for the STM32F429 Discovery board
$ gn gen --args='pw_target_config = "//targets/stm32f429i-disc1/target_config.gni"' out/disco $ ninja -C out/disco $ pw test --root out/disco/ --runner stm32f429i_disc1_unit_test_runner
The CMake and Bazel builds do not yet support building for hardware.
To flash firmware to an STM32 Discovery development board (and run
pw test) from macOS, you need to install OpenOCD. Install Homebrew using the latest instructions at https://brew.sh/, then install OpenOCD with
brew install openocd.
If any of this doesn't work please file a bug.