Google Git
Sign in
pigweed / gonk / 40f98602915c484651d462bcaf1a64f752f717a2
commit40f98602915c484651d462bcaf1a64f752f717a2[log] [tgz]
authorpigweed-roller <pigweed-roller@pigweed-service-accounts.iam.gserviceaccount.com>Wed Jun 19 09:38:28 2024 +0000
committerCQ Bot Account <pigweed-scoped@luci-project-accounts.iam.gserviceaccount.com>Wed Jun 19 09:38:28 2024 +0000
tree0be5e3e4a8c3c0ad5479e276fc532db193639d23
parent5e5421ce30a85eb03c36365042bc319e05d7de31 [diff]
roll: third_party/pigweed 14 commits

c6f3a9eeb718be6 rp2040: Add interrupt and freertos backends
cfcc5533808a58b rp2040: Add flash main target
8e4ae345f623819 docs: Add OWNERS
67b6c47a019a9ca pw_build_info: Add git_build_info.h header for emb
2c8b44aa6836dd3 python: Add python targets for pw_i2c, pw_digital_
0af21c49fa7f692 pw_ide: Run commands from PW_PROJECT_ROOT dir
49d5876907ba804 pw_grpc: Avoid buffer overflow when processing cor
9650f5fcbae1ea3 docs: Add Bazel installation guide
c4f8c47ed2a739c pw_build: Move host_backend_alias (part 2)
a78709c948aa0d3 rp2040: Add rp2040_binary transition
2ae7586e1ca9644 bazel: Stop using deprecated pw_facade aliases, v3
42504afa03234e3 pw_docgen: Add bug Docutils role
3c319b21bb978db OWNERS: Add gwsq
67ea3940b6d3c0e pw_multibuf: Fix Android build

https://pigweed.googlesource.com/pigweed/pigweed
third_party/pigweed Rolled-Commits: 3a1996034e63dea..c6f3a9eeb718be6
Roller-URL: https://ci.chromium.org/b/8744712457268348001
GitWatcher: ignore
CQ-Do-Not-Cancel-Tryjobs: true
Change-Id: I7ea508f02242383806bf166d274969934726516b
Reviewed-on: https://pigweed-review.googlesource.com/c/gonk/+/216830
Commit-Queue: Pigweed Roller <pigweed-roller@pigweed-service-accounts.iam.gserviceaccount.com>
Bot-Commit: Pigweed Roller <pigweed-roller@pigweed-service-accounts.iam.gserviceaccount.com>
Lint: Lint 🤖 <android-build-ayeaye@system.gserviceaccount.com>
1 file changed
tree: 0be5e3e4a8c3c0ad5479e276fc532db193639d23
  1. applications/
  2. build_overrides/
  3. fpga/
  4. lib/
  5. pcb/
  6. scripts/
  7. targets/
  8. third_party/
  9. tools/
  10. activate.sh ⇨ bootstrap.sh
  11. .gitignore
  12. .gitmodules
  13. .gn
  14. banner.txt
  15. bootstrap.sh
  16. BUILD.gn
  17. BUILDCONFIG.gn
  18. OWNERS
  19. pigweed.json
  20. README.md
README.md

Gonk

Getting Started

  1. Clone the repo

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

  2. Source bootstrap.sh to download all compilers and tooling into the environment directory:

    . ./bootstrap.sh

    This should init all git submodules for you.

  3. From here on the Pigweed environment is activated. You can activate the environment in a new shell without re-running bootstrap by sourcing activate.sh

    . ./activate.sh

Compile:

Build for the host and device by running:

pw build

This is mostly a shortcut with nice output for running gn gen out/gn and ninja -C out/gn.

The build commands are defined in: //tools/gonk_tools/build_project.py.

Gonk Verilog:

The Verilog build requires the following to be installed on Linux:

sudo apt install fpga-icestorm nextpnr-ice40 yosys

Run this to compile:

pw build

The bitstream files will be written with the .bin extenson under ./out/gn/obj/fpga/*/*.bin along with log output files.

For example:

$ ls ./out/gn/obj/fpga/toplevel/
nextpnr-log.txt
toplevel.asc
toplevel.bin
toplevel.json
toplevel_timing_report.json
toplevel_timing_report.txt
yosys-log.txt

Gonk fpga config Example

Flash the stm32f7 and launch the write_fpga.py script on a bitstream file.

Flash via DFU

  1. Unplug gonk from USB and replug with MODE button held down.

  2. Run gonk-flash on the MCU binary. This uses pyfu-usb.

    gonk-flash ./out/gn/arduino_size_optimized/obj/applications/fpga_config/fpga_config.bin

Write the FPGA bitstream

  1. Write an FPGA bitstream with the write_fpga.py script:

    gonk \
  --bitstream-file ./out/gn/obj/fpga/toplevel/toplevel.bin
  --database ./out/gn/arduino_size_optimized/obj/applications/fpga_config/bin/fpga_config.elf \
  --log-to-stderr

    You can redirect host and device logs to separate files with:

    gonk \
  --bitstream-file ./out/gn/obj/fpga/toplevel/toplevel.bin
  --database ./out/gn/arduino_size_optimized/obj/applications/fpga_config/bin/fpga_config.elf \
  --host-logfile gonk-host-logs.txt \
  --device-logfile gonk-device-logs.txt

Alternative: Flash with BlackMagic Probe

./scripts/flash-with-blackmagic-probe.sh ./out/gn/arduino_size_optimized/obj/applications/spi_flash_test/bin/spi_flash_test.elf

Generating the Gonk Python Bundle

On Linux with the FPGA toolchain available run:

pw build

The zip file containing all the dependencies for the gonk python tooling is located in:

out/gn/obj/gonk_bundle.zip

Inside are the Python wheels for gonk_dist, gonk_firmware, and all third_party dependencies.

gonk_bundle
├── python_wheels
│   ├── appdirs-1.4.4-py2.py3-none-any.whl
│   ├── astroid-3.0.1-py3-none-any.whl
│   ├── ...
│   ├── gonk_dist-0.0.1+20240305140627-py3-none-any.whl
│   ├── gonk_firmware-0.0.1+20240305140542-py3-none-any.whl
│   ├── ...
│   └── wheel-0.40.0-py3-none-any.whl
├── requirements.txt
├── setup.bat
└── setup.sh

pw_system Example

Run on Host

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

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

Run on Device

Flashing

openocd -s $PW_PIGWEED_CIPD_INSTALL_DIR/share/openocd/scripts \
  -f $GONK_ROOT/targets/stm32f769i_disc0_stm32cube/openocd_stm32f7xx.cfg \
  -c "program out/gn/stm32f769i_disc0_stm32cube.size_optimized/obj/applications/system_example/bin/system_example.elf reset exit"

Updating STM32Cube

Checkout the desired commits in each of these submodules:

third_party/stm32cube_f7/cmsis_core
third_party/stm32cube_f7/cmsis_device
third_party/stm32cube_f7/hal_driver

Then run from Gonk root:

python -m pw_stm32cube_build gen_file_list third_party/stm32cube_f7

Pin Map

Misc

NetSTM32 PinSTM32 FunctionFunction
STATUSPB13GPIO_OutputSTAT LED

SPI Flash Connection

NetFPGA IO#STM32 PinSTM32 FunctionFlash Pin
ICE_SPI_SS71PD2GPIO_OutputS#
ICE_SPI_MISO68PB4SPI1_MISODQ1
ICE_SPI_MOSI67PB5SPI1_MOSIDQ0
ICE_SPI_SCK70PB3SPI1_SCKC
FLASH_HOLD63PC11GPIO_OutputHOLD#/DQ3
FLASH_WP64PC12GPIO_OutputW#/VPP/DQ2

FPGA Connection

NetFunctionFPGA IO#STM32 PinSTM32 FunctionNotes
FPGA_IO_SPARE_0_2rst_i135PA0GPIO_OutputActive high
FPGA_IO_SPARE_0_0mode_i137PB11GPIO_OutputFPGA operation mode
DSPI_CSvalid_o75PB6GPIO_OutputData/Transfer Valid
FPGA_IO_SPARE_1_1miso_i101PC2SPI1_MISO
FPGA_IO_SPARE_1_0mosi_i99PC3SPI1_MOSI
I2C_O_SDAcs_n79PB9SPI1_NSS
FPGA_IO_SPARE_0_1sclk_i136PB10SPI1_SCK
FPGA_IO_SPARE_2_049PA7
FPGA_IO_SPARE_2_148PA6
FPGA_IO_SPARE_2_247PA5
FPGA_IO_SPARE_2_345PA4

Capture ADC samples and plot

  1. First bootstrap, run pw build and flash gonk using DFU.

    . ./bootstrap.sh

    pw build

    Unplug gonk from USB and replug with MODE button held down.

    Run gonk-flash on the MCU binary. This uses pyfu-usb.

    gonk-flash ./out/gn/arduino_size_optimized/obj/applications/fpga_config/fpga_config.bin

  2. Start capturing ADC samples with:

    python tools/gonk_tools/write_fpga.py \
  --bitstream-file ./out/gn/obj/fpga/toplevel/toplevel.bin \
  --database ./out/gn/arduino_size_optimized/obj/applications/fpga_config/bin/fpga_config.elf \
  --host-logfile gonk-host-logs.txt \
  --device-logfile gonk-device-logs.txt \
  --log-to-stderr
    • Press Enter to stop or start ADC continuous updates. It will begin automatically on startup.
    • Press ctrl-c to quit.

  3. Plot the logs from gonk-device-logs.txt with:

    python tools/gonk_tools/plot.py -i gonk-device-logs.txt -o plot.svg