All of lore.kernel.org
 help / color / mirror / Atom feed
From: Drew Fustini <drew@beagleboard.org>
To: "Grygorii Strashko" <grygorii.strashko@ti.com>,
	"Benoît Cousson" <bcousson@baylibre.com>,
	"Tony Lindgren" <tony@atomide.com>,
	"Rob Herring" <robh+dt@kernel.org>,
	linux-omap@vger.kernel.org, devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	"Jason Kridner" <jkridner@beagleboard.org>,
	"Robert Nelson" <robertcnelson@beagleboard.org>
Subject: [PATCH] arm: dts: am33xx-bone-common: add gpio-line-names
Date: Fri, 8 May 2020 18:58:21 +0200	[thread overview]
Message-ID: <20200508165821.GA14555@x1> (raw)

Add gpio-line-names properties to the gpio controller nodes.
BeagleBone boards have P8 and P9 headers [0] which expose many the
AM3358 SoC balls to stacking expansion boards called "capes", or to
other external connections like jumper wires to a breadboard.

Many of the P8/P9 header pins can muxed to a gpio line.  The
gpio-line-names describe which P8/P9 pin that line goes to and the
default mux for that P8/P9 pin.  Some lines are not routed to the
P8/P9 headers, but instead are dedicated to some functionality such as
status LEDs.  The line name will indicate this.  Some line names are
left empty as the corresponding AM3358 balls are not connected.

The goal is to make it easier for a user viewing the output of gpioinfo
to determine which P8/P9 pin is connected to a line.  The output of
gpioinfo on a BeagleBone Black will now look like this:

gpiochip0 - 32 lines:
	line   0:   "ethernet"       unused   input  active-high
	line   1:   "ethernet"       unused   input  active-high
	line   2: "P9_22 spi0_sclk" unused input active-high
	line   3: "P9_21 spi0_d0" unused input active-high
	line   4: "P9_18 spi0_d1" unused input active-high
	line   5: "P9_17 spi0_cs0" unused input active-high
	line   6:    "sd card"         "cd"   input   active-low [used]
	line   7: "P9_42A ecappwm0" unused input active-high
	line   8: "P8_35 hdmi"       unused   input  active-high
	line   9: "P8_33 hdmi"       unused   input  active-high
	line  10: "P8_31 hdmi"       unused   input  active-high
	line  11: "P8_32 hdmi"       unused   input  active-high
	line  12: "P9_20 i2c2_sda" unused input active-high
	line  13: "P9_19 i2c2_scl" unused input active-high
	line  14: "P9_26 uart1_rxd" unused input active-high
	line  15: "P9_24 uart1_txd" unused input active-high
	line  16:   "ethernet"       unused   input  active-high
	line  17:   "ethernet"       unused   input  active-high
	line  18:        "usb"       unused   input  active-high
	line  19:       "hdmi"       unused   input  active-high
	line  20: "P9_41B gpio" unused input active-high
	line  21:   "ethernet"       unused   input  active-high
	line  22: "P8_19 ehrpwm2a" unused input active-high
	line  23: "P8_13 ehrpwm2b" unused input active-high
	line  24:      unnamed       unused   input  active-high
	line  25:      unnamed       unused   input  active-high
	line  26: "P8_14 gpio"       unused   input  active-high
	line  27: "P8_17 gpio"       unused   input  active-high
	line  28:   "ethernet"       unused   input  active-high
	line  29:   "ethernet"       unused   input  active-high
	line  30: "P9_11 uart4_rxd" unused input active-high
	line  31: "P9_13 uart4_txd" unused input active-high
gpiochip1 - 32 lines:
	line   0: "P8_25 emmc"       unused   input  active-high
	line   1:       "emmc"       unused   input  active-high
	line   2:  "P8_5 emmc"       unused   input  active-high
	line   3:  "P8_6 emmc"       unused   input  active-high
	line   4: "P8_23 emmc"       unused   input  active-high
	line   5: "P8_22 emmc"       unused   input  active-high
	line   6:  "P8_3 emmc"       unused   input  active-high
	line   7:  "P8_4 emmc"       unused   input  active-high
	line   8:      unnamed       unused   input  active-high
	line   9:      unnamed       unused   input  active-high
	line  10:      unnamed       unused   input  active-high
	line  11:      unnamed       unused   input  active-high
	line  12: "P8_12 gpio"       unused   input  active-high
	line  13: "P8_11 gpio"       unused   input  active-high
	line  14: "P8_16 gpio"       unused   input  active-high
	line  15: "P8_15 gpio"       unused   input  active-high
	line  16: "P9_15A gpio" unused input active-high
	line  17: "P9_23 gpio"       unused   input  active-high
	line  18: "P9_14 ehrpwm1a" unused input active-high
	line  19: "P9_16 ehrpwm1b" unused input active-high
	line  20:       "emmc"       unused   input  active-high
	line  21:   "usr0 led" "beaglebone:green:heart" output active-high [used]
	line  22:   "usr1 led" "beaglebone:green:mmc0" output active-high [used]
	line  23:   "usr2 led" "beaglebone:green:usr2" output active-high [used]
	line  24:   "usr3 led" "beaglebone:green:usr3" output active-high [used]
	line  25:       "hdmi"  "interrupt"   input  active-high [used]
	line  26:        "usb"       unused   input  active-high
	line  27: "hdmi audio"     "enable"  output  active-high [used]
	line  28: "P9_12 gpio"       unused   input  active-high
	line  29: "P8_26 gpio"       unused   input  active-high
	line  30: "P8_21 emmc"       unused   input  active-high
	line  31: "P8_20 emmc"       unused   input  active-high
gpiochip2 - 32 lines:
	line   0: "P9_15B gpio" unused input active-high
	line   1: "P8_18 gpio"       unused   input  active-high
	line   2:  "P8_7 gpio"       unused   input  active-high
	line   3:  "P8_8 gpio"       unused   input  active-high
	line   4: "P8_10 gpio"       unused   input  active-high
	line   5:  "P8_9 gpio"       unused   input  active-high
	line   6: "P8_45 hdmi"       unused   input  active-high
	line   7: "P8_46 hdmi"       unused   input  active-high
	line   8: "P8_43 hdmi"       unused   input  active-high
	line   9: "P8_44 hdmi"       unused   input  active-high
	line  10: "P8_41 hdmi"       unused   input  active-high
	line  11: "P8_42 hdmi"       unused   input  active-high
	line  12: "P8_39 hdmi"       unused   input  active-high
	line  13: "P8_40 hdmi"       unused   input  active-high
	line  14: "P8_37 hdmi"       unused   input  active-high
	line  15: "P8_38 hdmi"       unused   input  active-high
	line  16: "P8_36 hdmi"       unused   input  active-high
	line  17: "P8_34 hdmi"       unused   input  active-high
	line  18:   "ethernet"       unused   input  active-high
	line  19:   "ethernet"       unused   input  active-high
	line  20:   "ethernet"       unused   input  active-high
	line  21:   "ethernet"       unused   input  active-high
	line  22: "P8_27 hdmi"       unused   input  active-high
	line  23: "P8_29 hdmi"       unused   input  active-high
	line  24: "P8_28 hdmi"       unused   input  active-high
	line  25: "P8_30 hdmi"       unused   input  active-high
	line  26:       "emmc"       unused   input  active-high
	line  27:       "emmc"       unused   input  active-high
	line  28:       "emmc"       unused   input  active-high
	line  29:       "emmc"       unused   input  active-high
	line  30:       "emmc"       unused   input  active-high
	line  31:       "emmc"       unused   input  active-high
gpiochip3 - 32 lines:
	line   0:   "ethernet"       unused   input  active-high
	line   1:   "ethernet"       unused   input  active-high
	line   2:   "ethernet"       unused   input  active-high
	line   3:   "ethernet"       unused   input  active-high
	line   4:   "ethernet"       unused   input  active-high
	line   5:       "i2c0"       unused   input  active-high
	line   6:       "i2c0"       unused   input  active-high
	line   7:        "emu"       unused   input  active-high
	line   8:        "emu"       unused   input  active-high
	line   9:   "ethernet"       unused   input  active-high
	line  10:   "ethernet"       unused   input  active-high
	line  11:      unnamed       unused   input  active-high
	line  12:      unnamed       unused   input  active-high
	line  13:        "usb"       unused   input  active-high
	line  14: "P9_31 spi1_sclk" unused input active-high
	line  15: "P9_29 spi1_d0" unused input active-high
	line  16: "P9_30 spi1_d1" unused input active-high
	line  17: "P9_28 spi1_cs0" unused input active-high
	line  18: "P9_42B ecappwm0" unused input active-high
	line  19: "P9_27 gpio"       unused   input  active-high
	line  20: "P9_41A gpio" unused input active-high
	line  21: "P9_25 gpio"       unused   input  active-high
	line  22:      unnamed       unused   input  active-high
	line  23:      unnamed       unused   input  active-high
	line  24:      unnamed       unused   input  active-high
	line  25:      unnamed       unused   input  active-high
	line  26:      unnamed       unused   input  active-high
	line  27:      unnamed       unused   input  active-high
	line  28:      unnamed       unused   input  active-high
	line  29:      unnamed       unused   input  active-high
	line  30:      unnamed       unused   input  active-high
	line  31:      unnamed       unused   input  active-high

[0] https://beagleboard.org/Support/bone101
[1] https://beagleboard.org/capes

Reviewed-by: Jason Kridner <jason@beagleboard.org>
Reviewed-by: Robert Nelson <robertcnelson@gmail.com>
Signed-off-by: Drew Fustini <drew@beagleboard.org>
---
 arch/arm/boot/dts/am335x-bone-common.dtsi | 144 ++++++++++++++++++++++
 1 file changed, 144 insertions(+)

diff --git a/arch/arm/boot/dts/am335x-bone-common.dtsi b/arch/arm/boot/dts/am335x-bone-common.dtsi
index 6c9187bc0f17..defdf68edb58 100644
--- a/arch/arm/boot/dts/am335x-bone-common.dtsi
+++ b/arch/arm/boot/dts/am335x-bone-common.dtsi
@@ -397,3 +397,147 @@
 	clocks = <&clk_32768_ck>, <&clk_24mhz_clkctrl AM3_CLK_24MHZ_CLKDIV32K_CLKCTRL 0>;
 	clock-names = "ext-clk", "int-clk";
 };
+
+&gpio0 {
+	gpio-line-names =
+		"ethernet",
+		"ethernet",
+		"P9_22 spi0_sclk",
+		"P9_21 spi0_d0",
+		"P9_18 spi0_d1",
+		"P9_17 spi0_cs0",
+		"sd card",
+		"P9_42A ecappwm0",
+		"P8_35 hdmi",
+		"P8_33 hdmi",
+		"P8_31 hdmi",
+		"P8_32 hdmi",
+		"P9_20 i2c2_sda",
+		"P9_19 i2c2_scl",
+		"P9_26 uart1_rxd",
+		"P9_24 uart1_txd",
+		"ethernet",
+		"ethernet",
+		"usb",
+		"hdmi",
+		"P9_41B gpio",
+		"ethernet",
+		"P8_19 ehrpwm2a",
+		"P8_13 ehrpwm2b",
+		"",
+		"",
+		"P8_14 gpio",
+		"P8_17 gpio",
+		"ethernet",
+		"ethernet",
+		"P9_11 uart4_rxd",
+		"P9_13 uart4_txd";
+};
+
+&gpio1 {
+	gpio-line-names =
+		"P8_25 emmc",
+		"emmc",
+		"P8_5 emmc",
+		"P8_6 emmc",
+		"P8_23 emmc",
+		"P8_22 emmc",
+		"P8_3 emmc",
+		"P8_4 emmc",
+		"",
+		"",
+		"",
+		"",
+		"P8_12 gpio",
+		"P8_11 gpio",
+		"P8_16 gpio",
+		"P8_15 gpio",
+		"P9_15A gpio",
+		"P9_23 gpio",
+		"P9_14 ehrpwm1a",
+		"P9_16 ehrpwm1b",
+		"emmc",
+		"usr0 led",
+		"usr1 led",
+		"usr2 led",
+		"usr3 led",
+		"hdmi",
+		"usb",
+		"hdmi audio",
+		"P9_12 gpio",
+		"P8_26 gpio",
+		"P8_21 emmc",
+		"P8_20 emmc";
+};
+
+&gpio2 {
+	gpio-line-names =
+		"P9_15B gpio",
+		"P8_18 gpio",
+		"P8_7 gpio",
+		"P8_8 gpio",
+		"P8_10 gpio",
+		"P8_9 gpio",
+		"P8_45 hdmi",
+		"P8_46 hdmi",
+		"P8_43 hdmi",
+		"P8_44 hdmi",
+		"P8_41 hdmi",
+		"P8_42 hdmi",
+		"P8_39 hdmi",
+		"P8_40 hdmi",
+		"P8_37 hdmi",
+		"P8_38 hdmi",
+		"P8_36 hdmi",
+		"P8_34 hdmi",
+		"ethernet",
+		"ethernet",
+		"ethernet",
+		"ethernet",
+		"P8_27 hdmi",
+		"P8_29 hdmi",
+		"P8_28 hdmi",
+		"P8_30 hdmi",
+		"emmc",
+		"emmc",
+		"emmc",
+		"emmc",
+		"emmc",
+		"emmc";
+};
+
+&gpio3 {
+	gpio-line-names =
+		"ethernet",
+		"ethernet",
+		"ethernet",
+		"ethernet",
+		"ethernet",
+		"i2c0",
+		"i2c0",
+		"emu",
+		"emu",
+		"ethernet",
+		"ethernet",
+		"",
+		"",
+		"usb",
+		"P9_31 spi1_sclk",
+		"P9_29 spi1_d0",
+		"P9_30 spi1_d1",
+		"P9_28 spi1_cs0",
+		"P9_42B ecappwm0",
+		"P9_27 gpio",
+		"P9_41A gpio",
+		"P9_25 gpio",
+		"",
+		"",
+		"",
+		"",
+		"",
+		"",
+		"",
+		"",
+		"",
+		"";
+};
-- 
2.20.1


             reply	other threads:[~2020-05-08 16:57 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-05-08 16:58 Drew Fustini [this message]
2020-05-12 13:52 ` [PATCH] arm: dts: am33xx-bone-common: add gpio-line-names Tony Lindgren
2020-05-18  7:11 ` Linus Walleij
2020-05-18  8:18   ` Felipe Balbi
2020-05-18  8:41     ` Linus Walleij
2020-05-18 12:34       ` Felipe Balbi
2020-05-18 14:24         ` Drew Fustini
2020-05-18 14:18   ` Drew Fustini
2020-05-20 22:02     ` Drew Fustini
2020-05-25  9:23       ` Linus Walleij
2020-05-25 12:07         ` Drew Fustini
2020-05-25 13:03           ` Linus Walleij

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200508165821.GA14555@x1 \
    --to=drew@beagleboard.org \
    --cc=bcousson@baylibre.com \
    --cc=devicetree@vger.kernel.org \
    --cc=grygorii.strashko@ti.com \
    --cc=jkridner@beagleboard.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-omap@vger.kernel.org \
    --cc=robertcnelson@beagleboard.org \
    --cc=robh+dt@kernel.org \
    --cc=tony@atomide.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.