[third_party/pigweed] Roll 18 commits

581056821fdab2f pw_alignment: Follow the new docs guidelines
54f1045f7e197ac pw_toolchain_bazel: Rename build file templates pa
46b27ea29968182 pw_transfer: Update integration test documentation
410973b058ad4b9 pw_toolchain_bazel: Rename build file templates pa
dd123c8a613483f pw_log: Add initial Rust API
0dadd2e68996d7a pw_tokenizer: Move entry header to a separate stru
2c0b7c88b3daa6d pw_tokenizer: Catch accidental use of test macro
a071b2bf63eddec pw_bluetooth_sapphire: Use pw_test_group for fuzze
a40f262a595caff bazel: Add simple module configuration mechanism
5e64e119af0a5d7 pw_toolchain: Add Bazel toolchain registration hel
6f8d8b1cedcd376 pw_bluetooth_sapphire: Use pw_fuzzer_group
e002e507dd1b9d4 pw_multibuf: Remove unused GN dep
4d128fea5db2a9e bazel: Tidy up WORKSPACE
c6a478ddc4d8374 pw_bluetooth_sapphire: Add sales pitch & roadmap d
583b47ec7ced635 pw_presubmit: Allow full issues.pigweed.dev urls i
4dc48c800711258 pw_multibuf: Remove dep on external gtest
b7dfabebf739ad3 pw_transfer: Set clients to transfer_v2
c943a7e9789d83f pw_bluetooth: Add LE Set Host Feature command

https://pigweed.googlesource.com/pigweed/pigweed
third_party/pigweed Rolled-Commits: b4e82abda1f7785..581056821fdab2f
Roller-URL: https://ci.chromium.org/b/8762924022324492385
GitWatcher: ignore
CQ-Do-Not-Cancel-Tryjobs: true
Change-Id: If4a35b3fc923f9c1f07d0a8023f701e2f7dbfc40
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/kudzu/+/183229
Bot-Commit: Pigweed Roller <pigweed-roller@pigweed-service-accounts.iam.gserviceaccount.com>
Commit-Queue: Pigweed Roller <pigweed-roller@pigweed-service-accounts.iam.gserviceaccount.com>
1 file changed
tree: ff21f46a5669055945c7779a778339e1287ece25
  1. applications/
  2. build_overrides/
  3. lib/
  4. pcb/
  5. targets/
  6. third_party/
  7. tools/
  8. .gitignore
  9. .gitmodules
  10. .gn
  11. activate.bat
  12. banner.txt
  13. bootstrap.bat
  14. bootstrap.sh
  15. BUILD.gn
  16. BUILDCONFIG.gn
  17. OWNERS
  18. pigweed.json
  19. README.md
README.md

Kudzu

Getting Started

Make sure you've set up Pigweed's prerequisites.

If you're on Windows, you can automate the initial setup by downloading the first-time setup script from cmd.exe:

curl https://pigweed.googlesource.com/pigweed/sample_project/+/main/tools/setup_windows_prerequisites.bat?format=TEXT > setup_pigweed_prerequisites.b64 && certutil -decode -f setup_pigweed_prerequisites.b64 setup_pigweed_prerequisites.bat && del setup_pigweed_prerequisites.b64

Then you can run the script with the following command in cmd.exe:

setup_pigweed_prerequisites.bat

Note: You may see a few UAC prompts as the script installs Git, Python, and enables developer mode.

Once that is done, you can clone this project with the following command:

git clone https://pigweed.googlesource.com/pigweed/kudzu

Environment setup

Pigweed uses a local development environment for most of its tools. This means tools are not installed to your machine, and are instead stored in a directory inside your project (Note: git ignores this directory). The tools are temporarily added to the PATH of the current shell session.

To make sure the latest tooling has been fetched and set up, run the bootstrap command for your operating system:

Windows

bootstrap.bat

Linux & Mac

source ./bootstrap.sh

After tooling updates, you might need to run bootstrap again to ensure the latest tools.

After the initial bootstrap, you can use use the activate scripts to configure the current shell for development without doing a full update.

Windows

activate.bat

Linux & Mac

source ./activate.sh

Device tools setup

Install the pico SDK and tool to flash the device.

pw package install pico_sdk
pw package install picotool

These packages will be built and added to the path automatically. There is no need to add these to the gn arguments.

Linux Setup

GLFW Dependency:

Install the GLFW OpenGL library

sudo apt install libglfw3-dev libglfw3

Udev Rules:

Put the following into /usr/lib/udev/rules.d/49-picoprobe.rules

# Pico app mode
SUBSYSTEMS=="usb", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="000a", MODE:="0666"
KERNEL=="ttyACM*", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="000a", MODE:="0666", SYMLINK+="rp2040"

# RP2 Boot
SUBSYSTEMS=="usb", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="0003", MODE:="0666"
KERNEL=="ttyACM*", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="0003", MODE:="0666", SYMLINK+="rp2040"

# Picoprobe
SUBSYSTEMS=="usb", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="0004", MODE:="0666"
KERNEL=="ttyACM*", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="0004", MODE:="0666", SYMLINK+="picoprobe"

This will also symlink /dev/picoprobe and /dev/rp2040 to the respective vendor and product ids.

Apply the above rules with:

sudo udevadm control --reload-rules
sudo udevadm trigger

Compile:

pw build

Run:

Host

Run the host app and connect to it via pw-system-console:

./out/gn/host_device_simulator.speed_optimized/obj/applications/badge/bin/badge & \
  pw-system-console --socket-addr default \
    --proto-globs third_party/pigweed/pw_rpc/echo.proto ; \
  killall badge

Kudzu

export ELF=./out/gn/rp2040.size_optimized/obj/applications/badge/bin/badge.elf

picotool reboot -f -u && \
  sleep 3 && \
  picotool load -x $ELF

Connect with pw-system-console:

pw-system-console --verbose \
  --baudrate 115200 \
  --proto-globs third_party/pigweed/pw_rpc/echo.proto \
  --token-databases ./out/gn/rp2040.size_optimized/obj/applications/badge/bin/badge.elf \
  --device /dev/rp2040