[PATCH 0/7] Add pin control driver for BCM2712 SoC
Rob Herring (Arm)
robh at kernel.org
Tue Jul 15 15:42:25 PDT 2025
On Tue, 15 Jul 2025 20:31:37 +0200, Andrea della Porta wrote:
> Hi,
>
> The following patches add a pin control driver for the BCM2712 SoC and few
> pin/gpio Devicetree nodes for Raspberry Pi 5.
>
> Device driver is follow up version on what Andrea posted in April [1].
>
> It is based on sources from here [2]. I just made few cosmetic changes
> and addressed review comments from earlier submission. I don't have
> documentation for this controller.
>
> Patch 4 wire up power button on RPi5.
>
> Patch 5 adds WiFi Devicetree node for RPi5.
>
> Patch 6 adds Bluetooth Devicetree node for RPi5.
>
> All this have been tested as kernel was directly booted RPi5 via
> kernel= config.txt option and cmdline.txt file with following content
> (Note I am using Tumbleweed RPi raw images)
>
> # cat /boot/efi/cmdline.txt
> root=/dev/mmcblk0p3 rootwait rw systemd.show_status=1 console=tty ignore_loglevel earlycon console=ttyAMA10,115200
>
> With all these patches Bluetooth and Wifi are working fine (tm) with
> firmware files provided by openSUSE Tumbleweed.
>
> All comments and suggestions are welcome!
>
> Happy hacking!
> Ivan and Andrea
>
> [1] https://lore.kernel.org/lkml/f6601f73-cb22-4ba3-88c5-241be8421fc3@broadcom.com/
> [2] https://github.com/raspberrypi/linux/blob/rpi-6.6.y/drivers/pinctrl/bcm/pinctrl-bcm2712.c
> [3] https://lore.kernel.org/lkml/20240605120712.3523290-1-florian.fainelli@broadcom.com/#t
> [4] https://lore.kernel.org/all/bfc60a7e-54d2-48a6-a288-4fe76d66507a@gmx.net/
>
>
> CHANGES in V2: (all patchset is based upon linux-next/master)
>
> --- PINCTRL DRIVER ---
>
> - dropped bcm2712_c0_aon_sgpio_pin_funcs[] and bcm2712_d0_aon_sgpio_pin_funcs[]
> struct array definitions since they are not used anywhere.
>
> - dropped 'arg' variable in brcmstb_pinconf_set() as it's not used.
>
> - updated copyright info at the top.
>
> - several changes in the declared macros. Renaming the macro name and the
> macro parameters to better reflect the semantic.
>
> - reworked MUX_BIT() macro to be more streamlined and easy to
> understand.
>
> - added PAD_BIT() macro to avoid code duplication.
>
> - renamed 'lock' variable to 'fsel_lock'.
>
> - added some comments about non-existent pins on D0 silicon revision pin
> declarations.
>
> - brcmstb_pinctrl_fsel_set(), brcmstb_pull_config_set() and
> brcmstb_pinconf_set() (and functions that call them) can now return -EINVAL
> as error.
>
> - added myself as MODULE_AUTHOR.
>
> - dropped the 'brcm,bcm2712-[aon-]pinctrl' fallback compatible. Only c0 or d0
> compatibles are permitted now.
>
>
> --- DTS ---
>
> - moved 'clock-frequency' property from (uarta) board dts node to SoC dtsi node.
>
> - added 'brcm,sdhci-brcmstb' compatible and 'clock-names' property to mmc node
> to avoid dt_binding_check errors.
>
> - added 'brcm,bcm7445-gpio' compatible to gpio node to avoid dt_binding_check
> errors.
>
> - renamed all pinctrl pin nodes as per yaml schema (*-state and *-pins).
>
> - changed 'brcm,bcm2712-*pinctrl' to 'brcm,bcm2712c0-*pinctrl' since the
> former was more of a fallback and does not reflect a real silicon revision.
>
> - moved status="okay" to the last entry in 'uarta' node.
>
> - removed 'local-*-address' property from everywhere.
>
> - dropped 'skip-init' property in 'uarta' node since it does not apply to
> linux kernel.
>
> - renamed 'pwr-button' node to 'gpio-keys' and 'pwr_key' node to
> 'power_button'.
>
> - dropped an userspace related 'brcm,gpio-direct' property from gpio node.
>
>
>
> --- DT BINDINGS ---
>
> - binding schema file renamed to 'brcm,bcm2712c0-pinctrl.yaml' to reflect the
> compatible name.
>
> - dropped the 'brcm,bcm2712-[aon-]pinctrl' fallback compatible. Only c0 or d0
> compatibles are permitted now.
>
> - added example section.
>
> - moved allOf: block at the beginning of the schema.
>
> - dropped some unnecessary new lines.
>
> - replaced current layout to describe the pin subnodes with patternProperties
> (nodes now end with -state and -pins).
>
> - expanded the schema description to give some context about STB family of pin
> controller and added some details about C0 and D0 silicon variants. This is
> also reflected in the commit message.
>
>
> --- MISC ---
>
> - enabled CONFIG_PINCTRL_BRCMSTB in arm64 defconfig.
>
>
> Andrea della Porta (1):
> arm64: defconfig: Enable BCM2712 on-chip pin controller driver
>
> Ivan T. Ivanov (6):
> dt-bindings: pinctrl: Add support for Broadcom STB pin controller
> pinctrl: bcm: Add STB family pin controller driver
> arm64: dts: broadcom: bcm2712: Add pin controller nodes
> arm64: dts: broadcom: bcm2712: Add one more GPIO node
> arm64: dts: broadcom: bcm2712: Add second SDHCI controller node
> arm64: dts: broadcom: bcm2712: Add UARTA controller node
>
> .../pinctrl/brcm,bcm2712c0-pinctrl.yaml | 123 ++
> .../dts/broadcom/bcm2712-rpi-5-b-ovl-rp1.dts | 134 ++
> arch/arm64/boot/dts/broadcom/bcm2712.dtsi | 48 +
> arch/arm64/configs/defconfig | 1 +
> drivers/pinctrl/bcm/Kconfig | 13 +
> drivers/pinctrl/bcm/Makefile | 1 +
> drivers/pinctrl/bcm/pinctrl-brcmstb.c | 1195 +++++++++++++++++
> 7 files changed, 1515 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/pinctrl/brcm,bcm2712c0-pinctrl.yaml
> create mode 100644 drivers/pinctrl/bcm/pinctrl-brcmstb.c
>
> --
> 2.35.3
>
>
>
My bot found new DTB warnings on the .dts files added or changed in this
series.
Some warnings may be from an existing SoC .dtsi. Or perhaps the warnings
are fixed by another series. Ultimately, it is up to the platform
maintainer whether these warnings are acceptable or not. No need to reply
unless the platform maintainer has comments.
If you already ran DT checks and didn't see these error(s), then
make sure dt-schema is up to date:
pip3 install dtschema --upgrade
This patch series was applied (using b4) to base:
Base: attempting to guess base-commit...
Base: tags/next-20250715 (exact match)
If this is not the correct base, please add 'base-commit' tag
(or use b4 which does this automatically)
New warnings running 'make CHECK_DTBS=y for arch/arm64/boot/dts/broadcom/' for cover.1752584387.git.andrea.porta at suse.com:
arch/arm64/boot/dts/broadcom/bcm2712-d-rpi-5-b.dtb: pinctrl at 7d504100 (brcm,bcm2712c0-pinctrl): emmc-sd-default-state: 'oneOf' conditional failed, one must be fixed:
'function' is a required property
'bias-pull-up', 'pins' do not match any of the regexes: '-pins$', '^pinctrl-[0-9]+$'
from schema $id: http://devicetree.org/schemas/pinctrl/brcm,brcmstb-pinctrl.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b-ovl-rp1.dtb: pinctrl at 7d504100 (brcm,bcm2712c0-pinctrl): emmc-sd-default-state: 'oneOf' conditional failed, one must be fixed:
'function' is a required property
'bias-pull-up', 'pins' do not match any of the regexes: '-pins$', '^pinctrl-[0-9]+$'
from schema $id: http://devicetree.org/schemas/pinctrl/brcm,brcmstb-pinctrl.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b-ovl-rp1.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'clocks' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b-ovl-rp1.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'clock-names' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b-ovl-rp1.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'interrupt-names' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b-ovl-rp1.dtb: serial at 7d50c000 (brcm,bcm7271-uart): Unevaluated properties are not allowed ('auto-flow-control', 'clock-frequency', 'reg-io-width', 'reg-shift' were unexpected)
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b-ovl-rp1.dtb: mmc at 1100000 (brcm,bcm2712-sdhci): Unevaluated properties are not allowed ('sdhci-caps', 'sdhci-caps-mask' were unexpected)
from schema $id: http://devicetree.org/schemas/mmc/brcm,sdhci-brcmstb.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-d-rpi-5-b.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'clocks' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-d-rpi-5-b.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'clock-names' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-d-rpi-5-b.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'interrupt-names' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-d-rpi-5-b.dtb: serial at 7d50c000 (brcm,bcm7271-uart): Unevaluated properties are not allowed ('auto-flow-control', 'clock-frequency', 'reg-io-width', 'reg-shift' were unexpected)
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-d-rpi-5-b.dtb: mmc at 1100000 (brcm,bcm2712-sdhci): Unevaluated properties are not allowed ('sdhci-caps', 'sdhci-caps-mask' were unexpected)
from schema $id: http://devicetree.org/schemas/mmc/brcm,sdhci-brcmstb.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b.dtb: pinctrl at 7d504100 (brcm,bcm2712c0-pinctrl): emmc-sd-default-state: 'oneOf' conditional failed, one must be fixed:
'function' is a required property
'bias-pull-up', 'pins' do not match any of the regexes: '-pins$', '^pinctrl-[0-9]+$'
from schema $id: http://devicetree.org/schemas/pinctrl/brcm,brcmstb-pinctrl.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'clocks' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'clock-names' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b.dtb: serial at 7d50c000 (brcm,bcm7271-uart): 'interrupt-names' is a required property
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b.dtb: serial at 7d50c000 (brcm,bcm7271-uart): Unevaluated properties are not allowed ('auto-flow-control', 'clock-frequency', 'reg-io-width', 'reg-shift' were unexpected)
from schema $id: http://devicetree.org/schemas/serial/brcm,bcm7271-uart.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b-ovl-rp1.dtb: hvs at 107c580000 (brcm,bcm2712-hvs): clocks: [[27, 4], [27, 16]] is too long
from schema $id: http://devicetree.org/schemas/display/brcm,bcm2835-hvs.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b.dtb: mmc at 1100000 (brcm,bcm2712-sdhci): Unevaluated properties are not allowed ('sdhci-caps', 'sdhci-caps-mask' were unexpected)
from schema $id: http://devicetree.org/schemas/mmc/brcm,sdhci-brcmstb.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-d-rpi-5-b.dtb: hvs at 107c580000 (brcm,bcm2712-hvs): clocks: [[27, 4], [27, 16]] is too long
from schema $id: http://devicetree.org/schemas/display/brcm,bcm2835-hvs.yaml#
arch/arm64/boot/dts/broadcom/bcm2712-rpi-5-b.dtb: hvs at 107c580000 (brcm,bcm2712-hvs): clocks: [[27, 4], [27, 16]] is too long
from schema $id: http://devicetree.org/schemas/display/brcm,bcm2835-hvs.yaml#
More information about the linux-arm-kernel
mailing list