[PATCH v2 0/7] pinctrl: airoha: add AN7589 support

From: John Crispin

Date: Thu Nov 12 2026 - 15:11:13 EST


The Airoha AN7589 has a GPIO controller like the EN7581 one, with a
third bank for 74 GPIOs in total. Its pin functions are selected
differently: a separate IOMUX block holds a 4 bit mode field per pin,
eight pins per register, and mode 0 makes any pin a GPIO.

The first four patches prepare the shared driver and change nothing
for the SoCs it serves today:

1. The GPIO register layout moves into the match data, so a SoC can
describe more than 64 pins.
2. A function group can carry one IOMUX mode per pin. A SoC
describes its IOMUX in the match data: the width of the mode
field and, from patch 4, the mode that makes a pin a GPIO.
3. The chip SCU becomes optional, as the AN7589 needs none.
4. A pin requested by gpiolib is put into GPIO mode through the
IOMUX, so no per pin gpio function is needed.

Patch 5 adds the bindings for the pin controller and the GPIO system
controller it sits under. Patch 6 moves the GPIO register offsets to
the common header, so the AN7589 data can describe its own register
table, with no functional change. Patch 7 adds the AN7589 pin data.

The series applies to next-20261105 and has no dependencies.

Changes in v2:
- Patch 3: look up the airoha,chip-scu phandle before the check for
a chip SCU compatible (Lorenzo).
- Patch 5: one function per block type (uart, i2c, spi, pcm, mdio,
pcie, pon, sgpio, jtag), with the group selecting the instance, as
in the other Airoha pin controller bindings. List the valid groups
for the groups property (Conor).
- Patch 7: the function table follows the binding. Name the match
data, the OF match table and the platform driver after the AN7589
(Lorenzo).
- Link to v1: https://lore.kernel.org/r/20261110173941.301478-1-john@xxxxxxxxxxx

John Crispin (7):
pinctrl: airoha: make gpio register layout per SoC
pinctrl: airoha: add per pin mode field mux
pinctrl: airoha: make the chip SCU optional
pinctrl: airoha: mux a requested GPIO through the IOMUX
dt-bindings: pinctrl: airoha: add AN7589
pinctrl: airoha: move the GPIO register offsets to the common header
pinctrl: airoha: add support of an7589 SoC

.../mfd/airoha,an7589-gpio-sysctl.yaml | 66 ++
.../devicetree/bindings/mfd/syscon.yaml | 1 +
.../pinctrl/airoha,an7589-pinctrl.yaml | 354 ++++++++++
MAINTAINERS | 3 +
drivers/pinctrl/airoha/Kconfig | 11 +
drivers/pinctrl/airoha/Makefile | 1 +
drivers/pinctrl/airoha/airoha-common.h | 41 +-
drivers/pinctrl/airoha/pinctrl-airoha.c | 119 +++-
drivers/pinctrl/airoha/pinctrl-an7563.c | 1 +
drivers/pinctrl/airoha/pinctrl-an7581.c | 1 +
drivers/pinctrl/airoha/pinctrl-an7583.c | 1 +
drivers/pinctrl/airoha/pinctrl-an7589.c | 623 ++++++++++++++++++
drivers/pinctrl/airoha/pinctrl-en7523.c | 1 +
drivers/pinctrl/airoha/pinctrl-en7528.c | 1 +
14 files changed, 1192 insertions(+), 32 deletions(-)
create mode 100644 Documentation/devicetree/bindings/mfd/airoha,an7589-gpio-sysctl.yaml
create mode 100644 Documentation/devicetree/bindings/pinctrl/airoha,an7589-pinctrl.yaml
create mode 100644 drivers/pinctrl/airoha/pinctrl-an7589.c


base-commit: ddfe51b0a0f5dc9e415cc2c8ad8db17532dd426b
--
2.34.1