Raspberry Pi Pico 2 (BBE)

Overview

This is a set of Bridle’s board extensions (BBE) to the original Zephyr upstream board Raspberry Pi Pico 2 with some adaptions and improvement on Twister, Kconfig and Devicetree level.

List of extensions

Board YAML

add the missing features that this board supports and that Twister tests might depends on:
- rpipico_gpio
- rpipico_i2c
- rpipico_spi
- rpipico_serial
- usb_device
- usb_cdc

Kconfig

deactivate self powered USB explicitly and set the maximum of electrical current consumption to 500㎃:

Raspberry Pi Pico 2 and Pico 2W

Kconfig.defconfig

config CDC_ACM_SERIAL_SELF_POWERED
	default n
	depends on USB_DEVICE_STACK_NEXT && USBD_CDC_ACM_CLASS

config CDC_ACM_SERIAL_MAX_POWER
	default 250 if BOARD_RPI_PICO2		# 500mA
	depends on USB_DEVICE_STACK_NEXT && USBD_CDC_ACM_CLASS

change log level only in case of use the native USB device port raspberrypi,pico-usbd with CDC-ACM UART zephyr,cdc-acm-uart as Zephyr console:

Raspberry Pi Pico 2 and Pico 2W

Kconfig.defconfig

# Workaround for not being able to have commas in macro arguments
DT_CHOSEN_Z_CONSOLE := zephyr,console
DT_COMPAT_Z_CDC_ACM_UART := zephyr,cdc-acm-uart
DT_COMPAT_RPIPICO_USB := raspberrypi,pico-usbd

# Macros to shorten Kconfig expressions
DT_CHOSEN_CONSOLE_NODE := $(dt_chosen_path,$(DT_CHOSEN_Z_CONSOLE))
DT_CHOSEN_CONSOLE_PARENT := $(dt_node_parent,$(DT_CHOSEN_CONSOLE_NODE))

if BOARD_RPI_PICO2 && \
	$(dt_chosen_enabled,$(DT_CHOSEN_Z_CONSOLE)) && \
	$(dt_compat_on_bus,$(DT_COMPAT_Z_CDC_ACM_UART),usb) && \
	$(dt_node_has_compat,$(DT_CHOSEN_CONSOLE_PARENT),$(DT_COMPAT_RPIPICO_USB))

# Logger cannot use itself to log
choice USBD_CDC_ACM_LOG_LEVEL_CHOICE
	default USBD_CDC_ACM_LOG_LEVEL_OFF
	depends on LOG && USB_DEVICE_STACK_NEXT && USBD_CDC_ACM_CLASS
endchoice

# Set USB log level to error only
choice USBD_LOG_LEVEL_CHOICE
	default USBD_LOG_LEVEL_ERR
	depends on LOG && USB_DEVICE_STACK_NEXT && USBD_CDC_ACM_CLASS
endchoice

# Set UDC driver log level to error only
choice UDC_DRIVER_LOG_LEVEL_CHOICE
	default UDC_DRIVER_LOG_LEVEL_ERR
	depends on LOG && USB_DEVICE_STACK_NEXT && USBD_CDC_ACM_CLASS
endchoice

endif # zephyr,cdc-acm-uart

Devicetree

set default entries for model and compatible of the boards:

Raspberry Pi Pico 2

rpi_pico2_rp2350a_m33_bbe.dts

/ {
	model = "Raspberry Pi Pico 2 (Cortex-M33) @ UART Concole (BBE)";
	compatible = "raspberrypi,rpi-pico2",
		     "raspberrypi,rpi-pico2-bbe",
		     "raspberrypi,rpi-pico2-uartcons",
		     "raspberrypi,rpi-pico2-uartcons-bbe";

};

rpi_pico2_rp2350a_hazard3_bbe.dts

/ {
	model = "Raspberry Pi Pico 2 (Hazard3) @ UART Concole (BBE)";
	compatible = "raspberrypi,rpi-pico2",
		     "raspberrypi,rpi-pico2-bbe",
		     "raspberrypi,rpi-pico2-uartcons",
		     "raspberrypi,rpi-pico2-uartcons-bbe";

};

Raspberry Pi Pico 2 - MCUboot

rpi_pico2_rp2350a_m33_mcuboot_bbe.dts

/ {
	model = "Raspberry Pi Pico 2 (Cortex-M33) - MCUboot @ UART Concole (BBE)";
	compatible = "raspberrypi,rpi-pico2-mcuboot",
		     "raspberrypi,rpi-pico2-mcuboot-bbe",
		     "raspberrypi,rpi-pico2-mcuboot-uartcons",
		     "raspberrypi,rpi-pico2-mcuboot-uartcons-bbe";

};

Raspberry Pi Pico 2W

rpi_pico2_rp2350a_m33_w_bbe.dts

/ {
	model = "Raspberry Pi Pico 2W (Cortex-M33) @ UART Concole";
	compatible = "raspberrypi,rpi-pico2-w",
		     "raspberrypi,rpi-pico2-w-bbe",
		     "raspberrypi,rpi-pico2-w-uartcons",
		     "raspberrypi,rpi-pico2-w-uartcons-bbe";

};

Raspberry Pi Pico 2W - MCUboot

rpi_pico2_rp2350a_m33_w_mcuboot_bbe.dts

/ {
	model = "Raspberry Pi Pico 2W (Cortex-M33) - MCUboot @ UART Concole";
	compatible = "raspberrypi,rpi-pico2-w-mcuboot",
		     "raspberrypi,rpi-pico2-w-mcuboot-bbe",
		     "raspberrypi,rpi-pico2-w-mcuboot-uartcons",
		     "raspberrypi,rpi-pico2-w-mcuboot-uartcons-bbe";

};

add the Bridle specific edge connecor binding raspberrypi,pico-header-r3

Raspberry Pi Pico 2 and Pico 2W

rpipico_r3_connector.dtsi

/ {
	rpipico_header: connector {
		compatible = "raspberrypi,pico-header-r3";
		#gpio-cells = <2>;
		gpio-map-mask = <0xffffffff 0xffffffc0>;
		gpio-map-pass-thru = <0 0x3f>;
		gpio-map = <0 0 &gpio0 0 0>,	/* GP0 */
			   <1 0 &gpio0 1 0>,	/* GP1 */
			   <2 0 &gpio0 2 0>,	/* GP2 */
			   <3 0 &gpio0 3 0>,	/* GP3 */
			   <4 0 &gpio0 4 0>,	/* GP4 */
			   <5 0 &gpio0 5 0>,	/* GP5 */
			   <6 0 &gpio0 6 0>,	/* GP6 */
			   <7 0 &gpio0 7 0>,	/* GP7 */
			   <8 0 &gpio0 8 0>,	/* GP8 */
			   <9 0 &gpio0 9 0>,	/* GP9 */
			   <10 0 &gpio0 10 0>,	/* GP10 */
			   <11 0 &gpio0 11 0>,	/* GP11 */
			   <12 0 &gpio0 12 0>,	/* GP12 */
			   <13 0 &gpio0 13 0>,	/* GP13 */
			   <14 0 &gpio0 14 0>,	/* GP14 */
			   <15 0 &gpio0 15 0>,	/* GP15 */
			   <16 0 &gpio0 16 0>,	/* GP16 */
			   <17 0 &gpio0 17 0>,	/* GP17 */
			   <18 0 &gpio0 18 0>,	/* GP18 */
			   <19 0 &gpio0 19 0>,	/* GP19 */
			   <20 0 &gpio0 20 0>,	/* GP20 */
			   <21 0 &gpio0 21 0>,	/* GP21 */
			   <22 0 &gpio0 22 0>,	/* GP22 */
			   <23 0 &gpio0 26 0>,	/* ADC0 / GP26 */
			   <24 0 &gpio0 27 0>,	/* ADC1 / GP27 */
			   <25 0 &gpio0 28 0>;	/* ADC2 / GP28 */
	};
};

add the Bridle specific interface labels:
- rpipico_serial: &pico_serial {};
- rpipico_spi: &pico_spi {};
- rpipico_spi0: &pico_spi0 {};
- rpipico_spi1: &pico_spi1 {};
- rpipico_i2c: &pico_i2c {};
- rpipico_i2c0: &pico_i2c0 {};
- rpipico_i2c1: &pico_i2c1 {};
enable the RP2350 SoC reset controller bindet as raspberrypi,pico-reset
Raspberry Pi Pico 2 and Pico 2W
rpipico_r3.dtsi

&reset { status = "okay"; };
disable the RP2350 SoC I2C1 controller bindet as raspberrypi,pico-spi and snps,designware-i2c
Raspberry Pi Pico 2 and Pico 2W
rpipico_r3.dtsi

&i2c1 { status = "disabled"; };
enable the RP2350 SoC SPI0 reset controller bindet as raspberrypi,pico-spi and arm,pl022
Raspberry Pi Pico 2 and Pico 2W
rpipico_r3.dtsi

&spi0 { status = "okay"; };

prepare the RP2350 SoC SPI1 controller bindet as raspberrypi,pico-spi with default raspberrypi,pico-pinctrl and clock-frequency = <DT_FREQ_M(8)>; properties, but explicitly set this to disabled status

Raspberry Pi Pico 2 and Pico 2W

rpipico_r3-spi1.dtsi

&spi1 {
	status = "disabled";
	pinctrl-0 = <&spi1_default>;
	pinctrl-names = "default";
	clock-frequency = <DT_FREQ_M(8)>;
};

rpipico_r3-pinctrl.dtsi

&pinctrl {
	spi1_default: spi1_default {
		group1 {
			pinmux = <SPI1_CSN_P9>, <SPI1_SCK_P10>, <SPI1_TX_P11>;
		};
		group2 {
			pinmux = <SPI1_RX_P12>;
			input-enable;
		};
	};
};