Google Git
Sign in
pigweed / pigweed / experimental / f9cc7980495c66cfad8bb9782495423629601d85
commitf9cc7980495c66cfad8bb9782495423629601d85[log] [tgz]
authorChris Mumford <cmumford@google.com>Wed Dec 14 20:09:16 2022 +0000
committerCQ Bot Account <pigweed-scoped@luci-project-accounts.iam.gserviceaccount.com>Wed Dec 14 20:09:16 2022 +0000
tree8eedca135c70411c7c5d40f9ae72d82314968e4f
parentd99dd24336619b4569e544f9f8d23e8d15028e48 [diff]
Create app_common and unify most displays.

This change moves all platform specific code from pw_display
into a new module: app_common. This new module is responsible
for initializig GPIO, SPI, creating the framebuffers and the
display. This allows for a second big change which is moving
pw_display from a facade to a concrete class. This is made
possible by the fact that it no longer need worry about the
display type or any platform details. These are all handled
by pw_display_driver and app_common respectively.

All configuration data (display size, pin assignments, etc.)
are now in the targets and app_common is resposible for
passing these down to the implementation for use.

Bug: none
Change-Id: I2da6e9b1a24f8feb251e7610e460bfdb5008a76c
Reviewed-on: https://pigweed-review.googlesource.com/c/pigweed/experimental/+/120530
Commit-Queue: Chris Mumford <cmumford@google.com>
Reviewed-by: Anthony DiGirolamo <tonymd@google.com>
59 files changed
tree: 8eedca135c70411c7c5d40f9ae72d82314968e4f
  1. applications/
  2. build_overrides/
  3. infra/
  4. pw_board_led/
  5. pw_board_led_arduino/
  6. pw_board_led_host/
  7. pw_board_led_mimxrt595_evk/
  8. pw_board_led_pico/
  9. pw_board_led_stm32cube/
  10. pw_board_led_stm32f429i_disc1/
  11. pw_digital_io_arduino/
  12. pw_digital_io_null/
  13. pw_digital_io_pico/
  14. pw_digital_io_stm32cube/
  15. pw_display_driver/
  16. pw_display_driver_ili9341/
  17. pw_display_driver_imgui/
  18. pw_display_driver_null/
  19. pw_display_driver_st7789/
  20. pw_graphics/
  21. pw_spi_arduino/
  22. pw_spi_pico/
  23. pw_spi_stm32f429i_disc1_stm32cube/
  24. pw_spin_delay/
  25. pw_spin_delay_arduino/
  26. pw_spin_delay_host/
  27. pw_spin_delay_mcuxpresso/
  28. pw_spin_delay_pico/
  29. pw_spin_delay_stm32cube/
  30. pw_spin_delay_stm32f429i_disc1/
  31. targets/
  32. third_party/
  33. tools/
  34. .clang-format ⇨ third_party/pigweed/.clang-format
  35. activate.sh ⇨ bootstrap.sh
  36. .gitattributes
  37. .gitignore
  38. .gitmodules
  39. .gn
  40. activate.bat
  41. banner.txt
  42. bootstrap.bat
  43. bootstrap.sh
  44. BUILD.gn
  45. BUILDCONFIG.gn
  46. env_setup.json
  47. navbar.md
  48. OWNERS
  49. PW_PLUGINS
  50. README.md
README.md

Pigweed Experimental

This repository contains experimental pigweed modules.

Repository setup

Clone this repo with --recursive to get all required submodules.

git clone --recursive https://pigweed.googlesource.com/pigweed/experimental

This will pull the Pigweed source repository into third_party/pigweed. If you already cloned but forgot to --recursive run git submodule update --init to pull all submodules.

pw_graphics

The //pw_graphics folder contains some libraries for drawing to an RGB565 framebuffer and displaying it on various platforms.

The demo applications that make use of these libraries are:

Build instructions

First time setup:

git clone --recursive https://pigweed.googlesource.com/pigweed/experimental
cd experimental
. ./bootstrap.sh
pw package install imgui
pw package install glfw
pw package install stm32cube_f4
pw package install pico_sdk

STM32F429-DISC1

Compile:

gn gen out --export-compile-commands --args="
  dir_pw_third_party_stm32cube_f4=\"$PW_PROJECT_ROOT/environment/packages/stm32cube_f4\"
"
ninja -C out

Flash:

openocd -f third_party/pigweed/targets/stm32f429i_disc1/py/stm32f429i_disc1_utils/openocd_stm32f4xx.cfg -c "program out/stm32f429i_disc1_stm32cube_debug/obj/applications/terminal_display/bin/terminal_demo.elf verify reset exit"

Linux, Windows or Mac

Compile:

gn gen out --export-compile-commands --args="
  dir_pw_third_party_imgui=\"$PW_PROJECT_ROOT/environment/packages/imgui\"
  dir_pw_third_party_glfw=\"$PW_PROJECT_ROOT/environment/packages/glfw\"
"
ninja -C out

Run:

out/host_debug/obj/applications/terminal_display/bin/terminal_demo

Raspberry Pi Pico Connected to an external SPI display

Working displays:

Compile:

gn gen out --export-compile-commands --args="
  PICO_SRC_DIR=\"$PW_PROJECT_ROOT/environment/packages/pico_sdk\"
"
ninja -C out

Flash:

  • Using a uf2 file:

    ./out/host_debug/obj/targets/rp2040/bin/elf2uf2 ./out/rp2040/obj/applications/terminal_display/bin/terminal_demo.elf ./out/rp2040/obj/applications/terminal_display/bin/terminal_demo.uf2

    Copy ./out/rp2040/obj/applications/terminal_display/bin/terminal_demo.uf2 to your Pi Pico.

  • Using a Pico Probe and openocd:

    This requires installing the Raspberry Pi foundation's OpenOCD fork for the Pico probe. More details including how to connect the two Pico boards is available at Raspberry Pi Pico and RP2040 - C/C++ Part 2: Debugging with VS Code

    Install RaspberryPi's OpenOCD Fork:

    git clone https://github.com/raspberrypi/openocd.git \
  --branch picoprobe \
  --depth=1 \
  --no-single-branch \
  openocd-picoprobe

cd openocd-picoprobe

./bootstrap
./configure --enable-picoprobe --prefix=$HOME/apps/openocd --disable-werror
make -j2
make install

    Setup udev rules (Linux only):

    cat <<EOF > 49-picoprobe.rules
SUBSYSTEMS=="usb", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="0004", MODE:="0666"
KERNEL=="ttyACM*", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="0004", MODE:="0666"
EOF
sudo cp 49-picoprobe.rules /usr/lib/udev/rules.d/49-picoprobe.rules
sudo udevadm control --reload-rules

    Flash the Pico:

    ~/apps/openocd/bin/openocd -f ~/apps/openocd/share/openocd/scripts/interface/picoprobe.cfg -f ~/apps/openocd/share/openocd/scripts/target/rp2040.cfg -c 'program out/rp2040/obj/applications/terminal_display/bin/terminal_demo.elf verify reset exit'

MIMXRT595-EVK Connected to an external MIPI display

Setup NXP SDK:

  1. Build a NXP SDK
  2. Download SDK
  3. Extract SDK's zip file to //environment/SDK_2_12_1_EVK-MIMXRT595

Compile:

gn gen out --export-compile-commands --args="
  pw_MIMXRT595_EVK_SDK=\"//environment/SDK_2_12_1_EVK-MIMXRT595\"
  pw_target_mimxrt595_evk_MANIFEST=\"//environment/SDK_2_12_1_EVK-MIMXRT595/EVK-MIMXRT595_manifest_v3_10.xml\"
  pw_third_party_mcuxpresso_SDK=\"//targets/mimxrt595_evk:mimxrt595_sdk\"
"

ninja -C out

Flash the MIMXRT595-EVK:

Follow the instructions to flash the MIMXRT595-EVK with the SEGGER J-Link firmware and using arm-none-eabi-gdb at https://pigweed.dev/targets/mimxrt595_evk/target_docs.html#running-and-debugging.

Teensy 4.1

https://www.pjrc.com/teensy/loader_cli.html

brew install teensy_loader_cli

OBJCOPY=/Applications/Arduino.app/Contents/Java/hardware/tools/avr/bin/avr-objcopy
INFILE=out/arduino_debug/obj/applications/terminal_display/bin/terminal_demo.elf
OUTFILE=foo.hex
$OBJCOPY -O ihex -R .eeprom -R .fuse -R .lock -R .signature $INFILE $OUTFILE
teensy_loader_cli --mcu=TEENSY41 -w -v $OUTFILE