From 6cf0398460ad7038ac67a92f0085821efd97d3e9 Mon Sep 17 00:00:00 2001 From: chrisboross Date: Sat, 17 Aug 2024 19:14:32 -0700 Subject: [PATCH 1/4] Update README.md @kilograham A few proposed changes to the readme: - Remove some early access copy - Call out which examples are RP235x only - Fix link the HSTX example Could you review the first paragraph of build instructions too? --- README.md | 21 ++++++++------------- 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 7170139fe..1692981fa 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,4 @@ -# Raspberry Pi RP2350 Pico SDK Examples - Early Access - -## RP2350 Instructions - -Everything below this section is from the stock pico-examples, so ignore URLs etc., but generally instructions are the same. +# Raspberry Pi Pico SDK Examples The Pico SDK default continues to be to build for RP2040 (PICO_PLATFORM=rp2040), so to build for RP2350, you need to pass `-DPICO_PLATFORM=rp2350` to CMake (or `-DPICO_PLATFORM=rp2350-riscv` for RISC-V). @@ -11,7 +7,6 @@ Most, but not all examples, currently work on RP2350 however you should be able For RISC-V compilation, you should take a compiler from here: https://www.embecosm.com/resources/tool-chain-downloads/#riscv-stable -# Original pico-examples docs ## Getting started @@ -40,7 +35,7 @@ App|Description [dma_capture](adc/dma_capture) | Use the DMA to capture many samples from the ADC. [read_vsys](adc/read_vsys) | Demonstrates how to read VSYS to get the voltage of the power supply. -### Bootloaders (RP2350 Only) +### Bootloaders (RP235x Only) App|Description ---|--- [enc_bootloader](bootloaders/encrypted) | A bootloader which decrypts binaries from flash into SRAM. See the separate [README](bootloaders/encrypted/README.md) for more information @@ -60,7 +55,7 @@ App|Description ---|--- [build_variants](cmake/build_variants) | Builds two version of the same app with different configurations -### DCP +### DCP (RP235x Only) App|Description ---|--- @@ -75,11 +70,11 @@ App|Description [channel_irq](dma/channel_irq) | Use an IRQ handler to reconfigure a DMA channel, in order to continuously drive data through a PIO state machine. [sniff_crc](dma/sniff_crc) | Use the DMA engine's 'sniff' capability to calculate a CRC32 on a data buffer. -### HSTX +### HSTX (RP235x Only) App|Description ---|--- -[dvi_out_hstx_encoder](dvi_out_hstx_encoder) `RP2350`| Use the HSTX to output a DVI signal with 3:3:2 RGB +[dvi_out_hstx_encoder](hstx/dvi_out_hstx_encoder) | Use the HSTX to output a DVI signal with 3:3:2 RGB ### Flash @@ -149,11 +144,11 @@ App|Description [multicore_runner](multicore/multicore_runner) | Set up the second core to accept, and run, any function pointer pushed into its mailbox FIFO. Push in a few pieces of code and get answers back. [multicore_doorbell](multicore/multicore_doorbell) | Claims two doorbells for signaling between the cores. Counts how many doorbell IRQs occur on the second core and uses doorbells to coordinate exit. -### OTP +### OTP (RP235x Only) App|Description ---|--- -[hello_otp](otp/hello_otp) | Demonstrate reading and writing from the OTP on RP2350, along with some of the features of OTP (error correction and page locking). +[hello_otp](otp/hello_otp) | Demonstrate reading and writing from the OTP on RP235x, along with some of the features of OTP (error correction and page locking). ### Pico Board @@ -316,7 +311,7 @@ App|Description [rtc_alarm](rtc/rtc_alarm) | Set an alarm on the RTC to trigger an interrupt at a date/time 5 seconds into the future. [rtc_alarm_repeat](rtc/rtc_alarm_repeat) | Trigger an RTC interrupt once per minute. -### SHA-256 +### SHA-256 (RP235x Only) App|Description ---|--- From 1f4ccd0ffcda1dea6cc315cf51eb26109b407704 Mon Sep 17 00:00:00 2001 From: Graham Sanderson Date: Thu, 5 Dec 2024 09:36:03 -0600 Subject: [PATCH 2/4] Update README.md Co-authored-by: nate contino --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1692981fa..9cee59ace 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Raspberry Pi Pico SDK Examples -The Pico SDK default continues to be to build for RP2040 (PICO_PLATFORM=rp2040), so to build for RP2350, you need to pass +By default, the Pico SDK targets builds for RP2040 (PICO_PLATFORM=rp2040). To build for RP2350 instead, pass `-DPICO_PLATFORM=rp2350` to CMake (or `-DPICO_PLATFORM=rp2350-riscv` for RISC-V). Most, but not all examples, currently work on RP2350 however you should be able to do a full build with any of the above platforms (PICO_PLATFORM=host however currently fails on some examples) From 65e1be7f22d3c36d1da99e63f5dd0f182ae4ff69 Mon Sep 17 00:00:00 2001 From: Graham Sanderson Date: Thu, 6 Feb 2025 09:20:36 -0600 Subject: [PATCH 3/4] feedback fix --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b7eb64f9a..e82009e4a 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,8 @@ # Raspberry Pi Pico SDK Examples By default, the Pico SDK targets builds for RP2040 (PICO_PLATFORM=rp2040). To build for RP2350 instead, pass -`-DPICO_PLATFORM=rp2350` to CMake (or `-DPICO_PLATFORM=rp2350-riscv` for RISC-V). +`-DPICO_PLATFORM=rp2350` to CMake (or `-DPICO_PLATFORM=rp2350-riscv` for RISC-V). Alternatively, in many cases, you can rely +on the board configuration to set the platform for you. For example, passing `-DPICO_BOARD=pico2` will automatically select RP2350. Most, but not all examples, currently work on RP2350 however you should be able to do a full build with any of the above platforms (PICO_PLATFORM=host however currently fails on some examples) From 5bfcdb3330baf07c64b4a124b8050127ce7e5006 Mon Sep 17 00:00:00 2001 From: Graham Sanderson Date: Thu, 13 Feb 2025 10:53:48 -0600 Subject: [PATCH 4/4] Better handle previous merge --- README.md | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 82ba2a9fd..c77341d76 100644 --- a/README.md +++ b/README.md @@ -12,10 +12,15 @@ however certain examples that use chip-specific functionality will only build on Similarly, Wi-Fi and Bluetooth examples will only build on a board that includes Wi-Fi and Bluetooth support. Platform and board information are passed to the CMake build via the `PICO_PLATFORM` and `PICO_BOARD` variables. + +By default, the Pico SDK targets builds for RP2040 (`PICO_PLATFORM=rp2040`). To build for RP2350 instead, pass +`-DPICO_PLATFORM=rp2350` to CMake (or `-DPICO_PLATFORM=rp2350-riscv` for RISC-V). Alternatively, in many cases, you can rely +on the board configuration to set the platform for you. For example, passing `-DPICO_BOARD=pico2` will automatically select `PICO_PLATFORM=rp2350`. + For more information see the "Platform and Board Configuration" chapter of -the [Raspberry Pi Pico-series C/C++ SDK](https://rptl.io/pico-c-sdk) book +the [Raspberry Pi Pico-series C/C++ SDK](https://rptl.io/pico-c-sdk) book. -Information on which examples are not being built is output during the CMake configuration step. +Information on which examples are not being built is displayed during the CMake configuration step. ### First Examples