Google Git
Sign in
pigweed / pigweed / kudzu / 05a945a70143787dd03fd1c417f8ada4f4251a08
commit05a945a70143787dd03fd1c417f8ada4f4251a08[log] [tgz]
authorpigweed-roller <pigweed-roller@pigweed-service-accounts.iam.gserviceaccount.com>Thu Jan 04 09:11:39 2024 +0000
committerCQ Bot Account <pigweed-scoped@luci-project-accounts.iam.gserviceaccount.com>Thu Jan 04 09:11:39 2024 +0000
tree3c6c5ee273f080f6bc81bbe313c29a09b9dd3dea
parent97890607fe613136d1e1c24c09dafce9fe080c6a [diff]
[third_party/pigweed] Roll 8 commits

3887ec9bd906adf pw_ide: Support alternate `clangd` paths
77dbd41823c7ae3 bazel: Replace pw_cc_library with cc_library
9fb521d2c89fad9 pw_ide: VSC extension 0.1.2 release
788d6b60eb323a9 pw_ide: Fix CLI command docs
5a1bf6af624961d docs: Update changelog
96de184564d918e pw_ide: Allow submitting bugs from VSC
a65bd44de1de9a1 pw_ide: Document `compdb_gen_cmd`
84e2bf6f82c9527 pw_unit_test: Fix sanitize(r) directive

https://pigweed.googlesource.com/pigweed/pigweed
third_party/pigweed Rolled-Commits: cbe50f75e2ca9de..3887ec9bd906adf
Roller-URL: https://ci.chromium.org/b/8759843722266913649
GitWatcher: ignore
CQ-Do-Not-Cancel-Tryjobs: true
Change-Id: I40e4f6a16e708833bcca4e23fc6208fda5ea4967
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/kudzu/+/186790
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: 3c6c5ee273f080f6bc81bbe313c29a09b9dd3dea
  1. applications/
  2. build_overrides/
  3. lib/
  4. pcb/
  5. targets/
  6. third_party/
  7. tools/
  8. .clang-format ⇨ third_party/pigweed/.clang-format
  9. activate.sh ⇨ bootstrap.sh
  10. .gitignore
  11. .gitmodules
  12. .gn
  13. activate.bat
  14. banner.txt
  15. bootstrap.bat
  16. bootstrap.sh
  17. BUILD.gn
  18. BUILDCONFIG.gn
  19. OWNERS
  20. pigweed.json
  21. 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