boards: waveshare: Add RP2350 Zero board support #97628

cetola · 2025-10-15T13:26:10Z

Add initial support for the Waveshare RP2350-Zero, a low-cost, high-performance Pico-like development board based on the Raspberry Pi RP2350A microcontroller.

This commit introduces the board definition, devicetree files, pin control configuration, Kconfig options, and board documentation.

The RP2350-Zero’s Arm and RISC-V cores are supported with this port. Basic peripherals (GPIO, UART, I2C) are configured and tested. Verified by building and running the Zephyr "hello_world" sample on the RP2350-Zero / RP2350-One boards, and manually testing the GPIO, I2C, PIO, and RGB LED.

github-actions · 2025-10-15T13:26:50Z

Hello @cetola, and thank you very much for your first pull request to the Zephyr project!
Our Continuous Integration pipeline will execute a series of checks on your Pull Request commit messages and code, and you are expected to address any failures by updating the PR. Please take a look at our commit message guidelines to find out how to format your commit messages, and at our contribution workflow to understand how to update your Pull Request. If you haven't already, please make sure to review the project's Contributor Expectations and update (by amending and force-pushing the commits) your pull request if necessary.
If you are stuck or need help please join us on Discord and ask your question there. Additionally, you can escalate the review when applicable. 😊

dsseng

Thank you for your contribution! Please find some suggestions attached

dsseng · 2025-10-15T20:04:35Z

boards/waveshare/rp2350_zero/board.cmake

+board_runner_args(openocd --cmd-pre-init "source [find interface/${RPI_PICO_DEBUG_ADAPTER}.cfg]")
+board_runner_args(openocd --cmd-pre-init "source [find target/rp2350.cfg]")
+
+# The adapter speed is expected to be set by interface configuration.


It's safe to assume probe-rs also works for this target, please consider adding it by copying from other files, like here: https://github.com/zephyrproject-rtos/zephyr/pull/94542/files

Sounds good, added this. I'll see if I can get a probe-rs debug probe and test this out as well.

dsseng · 2025-10-15T20:05:28Z

boards/waveshare/rp2350_zero/doc/index.rst

+
+  west flash
+
+In alternative you can locate the generated file at ``build/zephyr/zephyr.uf2 file`` and simply drag-and-drop to the device after entreing the UF2 flashing mode.


Suggested change

In alternative you can locate the generated file at ``build/zephyr/zephyr.uf2 file`` and simply drag-and-drop to the device after entreing the UF2 flashing mode.

Alternatively, you can locate the generated file at ``build/zephyr/zephyr.uf2 file`` and simply drag-and-drop to the device after entering the UF2 flashing mode.

dsseng · 2025-10-15T20:08:27Z

boards/waveshare/rp2350_zero/doc/index.rst

+   :goals: build
+   :compact:
+
+You must flash the RP2350-Zero with an UF2 file. One option is to use West (Zephyr’s meta-tool). To enter the UF2 flashing mode just keep the ``BOOT`` button pressed while you connect the USB port, it will appear on the host as a mass storage device. In alternative with the board already connected via USB you can keep the ``RESET`` button pressed, press and release ``BOOT``, release ``RESET``. At this point you can flash the image file by running:


uf2 isn't the must option, I'm pretty sure picotool can load elf as well. Also, it seems the button press order should be different:

Suggested change

You must flash the RP2350-Zero with an UF2 file. One option is to use West (Zephyr’s meta-tool). To enter the UF2 flashing mode just keep the ``BOOT`` button pressed while you connect the USB port, it will appear on the host as a mass storage device. In alternative with the board already connected via USB you can keep the ``RESET`` button pressed, press and release ``BOOT``, release ``RESET``. At this point you can flash the image file by running:

You can flash the RP2350-Zero with an UF2 file. One option is to use West (Zephyr’s meta-tool). To enter the UF2 flashing mode just keep the ``BOOT`` button pressed while you connect the USB port, it will appear on the host as a mass storage device. In alternative with the board already connected via USB you can keep the ``BOOT`` button pressed, press and release ``RUN``, release ``BOOT``. At this point you can flash the image file by running:

kartben · 2025-10-16T09:16:32Z

boards/waveshare/rp2350_zero/doc/img/rp2350_zero.jpg

please use this one (it has transparent bg, is cropped to avoid unnecessary white space, and webp so size is smaller)

kartben · 2025-10-16T09:19:40Z

boards/waveshare/rp2350_zero/doc/img/rp2350_zero_pinout.jpg

cwebp rp2350_zero_pinout.jpg -q 50 -o rp2350_zero_pinout.webp -m 6 -af

but fwiw I would rather you link to the product webpage rather than unnecessarily cluttering the Zehpyr git repo with this file

Updated the PR with a link to the product webpage.

Sorry, pushed the wrong rst file. Should be updated now.

nordicjm · 2025-10-16T10:36:24Z

boards/waveshare/rp2350_zero/board.cmake

+# SPDX-License-Identifier: Apache-2.0
+
+if("${RPI_PICO_DEBUG_ADAPTER}" STREQUAL "")
+    set(RPI_PICO_DEBUG_ADAPTER "cmsis-dap")


cmake indent is 2 spaces

nordicjm · 2025-10-16T10:36:46Z

boards/waveshare/rp2350_zero/rp2350_zero-pinctrl.dtsi

+		group1 {
+			pinmux = <UART0_TX_P0>;
+		};
+		group2 {


newline gaps missing e.g. line 11, fix in whole PR

nordicjm · 2025-10-16T10:36:57Z

boards/waveshare/rp2350_zero/rp2350_zero.dtsi

+			<28 0 &gpio0 28 0>,	/* GP28 */
+			<29 0 &gpio0 29 0>;	/* GP29 */
+	};
+


Suggested change

nordicjm · 2025-10-16T10:37:23Z

boards/waveshare/rp2350_zero/rp2350_zero_rp2350a_hazard3_defconfig

+CONFIG_LED=y
+CONFIG_LED_STRIP=y
+CONFIG_WS2812_STRIP_RPI_PICO_PIO=y


Suggested change

CONFIG_LED=y

CONFIG_LED_STRIP=y

CONFIG_WS2812_STRIP_RPI_PICO_PIO=y

nordicjm · 2025-10-16T10:37:40Z

boards/waveshare/rp2350_zero/rp2350_zero_rp2350a_m33_defconfig

+CONFIG_LED=y
+CONFIG_LED_STRIP=y
+CONFIG_WS2812_STRIP_RPI_PICO_PIO=y


Suggested change

CONFIG_LED=y

CONFIG_LED_STRIP=y

CONFIG_WS2812_STRIP_RPI_PICO_PIO=y

PR updated to remove the LED. Is best practice here to keep the defconfig as minimal as possible?

Add initial support for the Waveshare RP2350-Zero, a low-cost, high-performance Pico-like development board based on the Raspberry Pi RP2350A microcontroller. This commit introduces the board definition, devicetree files, pin control configuration, Kconfig options, and board documentation. The RP2350-Zero’s Arm and RISC-V cores are supported with this port. Basic peripherals (GPIO, UART, I2C) are configured and tested. Verified by building and running the Zephyr "hello_world" sample on the RP2350-Zero / RP2350-One boards, and manually testing the GPIO, I2C, PIO, and RGB LED. Signed-off-by: Stephano Cetola <[email protected]>

sonarqubecloud · 2025-10-16T16:17:54Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

zephyrbot added the area: Boards/SoCs label Oct 15, 2025

cetola force-pushed the rp2350_zero branch 2 times, most recently from 0d202ba to b39093a Compare October 15, 2025 18:53

dsseng added area: Devicetree platform: Raspberry Pi Pico Raspberry Pi Pico (RPi Pico) labels Oct 15, 2025

dsseng self-requested a review October 15, 2025 19:57

dsseng reviewed Oct 15, 2025

View reviewed changes

dsseng requested review from ThreeEights, ajf58, nordicjm and soburi October 15, 2025 20:10

cetola force-pushed the rp2350_zero branch from b39093a to 54dac50 Compare October 15, 2025 20:40

kartben reviewed Oct 16, 2025

View reviewed changes

nordicjm requested changes Oct 16, 2025

View reviewed changes

cetola force-pushed the rp2350_zero branch 2 times, most recently from 1ad8943 to 76f7ae1 Compare October 16, 2025 13:32

cetola force-pushed the rp2350_zero branch from 76f7ae1 to 314aa51 Compare October 16, 2025 16:13


		west flash

		In alternative you can locate the generated file at ``build/zephyr/zephyr.uf2 file`` and simply drag-and-drop to the device after entreing the UF2 flashing mode.

	In alternative you can locate the generated file at ``build/zephyr/zephyr.uf2 file`` and simply drag-and-drop to the device after entreing the UF2 flashing mode.
	Alternatively, you can locate the generated file at ``build/zephyr/zephyr.uf2 file`` and simply drag-and-drop to the device after entering the UF2 flashing mode.

	CONFIG_LED=y
	CONFIG_LED_STRIP=y
	CONFIG_WS2812_STRIP_RPI_PICO_PIO=y

boards: waveshare: Add RP2350 Zero board support #97628

Are you sure you want to change the base?

boards: waveshare: Add RP2350 Zero board support #97628

Conversation

cetola commented Oct 15, 2025

Uh oh!

github-actions bot commented Oct 15, 2025

Uh oh!

dsseng left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cetola Oct 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

kartben Oct 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sonarqubecloud bot commented Oct 16, 2025

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

cetola Oct 15, 2025 •

edited

Loading

kartben Oct 16, 2025 •

edited

Loading