drivers/tty/serial/8250: Make Aspeed VUART SIRQ polarity configurable
PATCH v3 1/3 drivers/tty/serial/8250: Make Aspeed VUART SIRQ polarity configurable
Make the SIRQ polarity for Aspeed AST24xx/25xx VUART configurable via sysfs. This setting need to be changed on specific host platforms depending on the selected host interface (LPC / eSPI).
The setting is configurable via sysfs rather than device-tree to stay in line with other related configurable settings.
On AST2500 the VUART SIRQ polarity can be auto-configured by reading a bit from a configuration register, e.g. the LPC/eSPI interface configuration bit.
Tested: Verified on TYAN S7106 mainboard.
--- .../ABI/stable/sysfs-driver-aspeed-vuart | 11 ++- drivers/tty/serial/8250/8250_aspeed_vuart.c | 84 +++++++++++++++++++ drivers/tty/serial/8250/Kconfig | 1 + 3 files changed, 95 insertions(+), 1 deletion(-)
Documentation/ABI/stable/sysfs-driver-aspeed-vuart +10 -1
@@ -6,10 +6,19 @@ Description: Configures which IO port the host side of the UART Users: OpenBMC. Proposed changes should be mailed to openbmc at lists.ozlabs.org -What: /sys/bus/platform/drivers/aspeed-vuart*/sirq +What: /sys/bus/platform/drivers/aspeed-vuart/*/sirq Date: April 2017 Contact: Jeremy Kerr <[email protected]> Description: Configures which interrupt number the host side of the UART will appear on the host <-> BMC LPC bus. Users: OpenBMC. Proposed changes should be mailed to openbmc at lists.ozlabs.org + +What: /sys/bus/platform/drivers/aspeed-vuart/*/sirq_polarity +Date: July 2019 +Contact: Oskar Senft <[email protected]> +Description: Configures the polarity of the serial interrupt to the + host via the BMC LPC bus. + Set to 0 for active-low or 1 for active-high. +Users: OpenBMC. Proposed changes should be mailed to + openbmc at lists.ozlabs.org
drivers/tty/serial/8250/8250_aspeed_vuart.c +84 -0
118 lines not on this page · raw message
drivers/tty/serial/8250/Kconfig +1 -0
@@ -243,6 +243,7 @@ config SERIAL_8250_ASPEED_VUART tristate "Aspeed Virtual UART" depends on SERIAL_8250 depends on OF + depends on REGMAP && MFD_SYSCON help If you want to use the virtual UART (VUART) device on Aspeed BMC platforms, enable this option. This enables the 16550A-
Signature · 1 line
2.23.0.187.g17f5b7556c-goog
PATCH v3 2/3 dt-bindings: serial: 8250: Add aspeed, sirq-polarity-sense.
Add documentation for 8250_aspeed_vuart's aspeed,sirq-polarity-sense property that enables to auto-configure the VUART's SIRQ polarity.
--- Documentation/devicetree/bindings/serial/8250.txt | 5 +++++ 1 file changed, 5 insertions(+)
Documentation/devicetree/bindings/serial/8250.txt +5 -0
@@ -56,6 +56,11 @@ Optional properties: - {rts,cts,dtr,dsr,rng,dcd}-gpios: specify a GPIO for RTS/CTS/DTR/DSR/RI/DCD line respectively. It will use specified GPIO instead of the peripheral function pin for the UART feature. If unsure, don't specify this property. +- aspeed,sirq-polarity-sense: Only applicable to aspeed,ast2500-vuart. + phandle to aspeed,ast2500-scu compatible syscon alongside register offset + and bit number to identify how the SIRQ polarity should be configured. + One possible data source is the LPC/eSPI mode bit. + Example: aspeed,sirq-polarity-sense = <&syscon 0x70 25> Note: * fsl,ns16550:
Signature · 1 line
2.23.0.187.g17f5b7556c-goog
Rob Herring
maintainerPATCH v3 2/3 dt-bindings: serial: 8250: Add aspeed,sirq-polarity-sense.
Quoted 8 lines · Oskar Senft
Add documentation for 8250_aspeed_vuart's aspeed,sirq-polarity-sense property that enables to auto-configure the VUART's SIRQ polarity.
Signed-off-by Oskar Senft <[email protected]>--- Documentation/devicetree/bindings/serial/8250.txt | 5 +++++ 1 file changed, 5 insertions(+)
PATCH v3 3/3 arm: dts: aspeed: Add vuart aspeed, sirq-polarity-sense to aspeed-g5.dtsi
In reply to Oskar SenftEnable auto-configuration of VUART SIRQ polarity on AST2500.
--- arch/arm/boot/dts/aspeed-g5.dtsi | 1 + 1 file changed, 1 insertion(+)
arch/arm/boot/dts/aspeed-g5.dtsi +1 -0
@@ -351,6 +351,7 @@ interrupts = <8>; clocks = <&syscon ASPEED_CLK_APB>; no-loopback-test; + aspeed,sirq-polarity-sense = <&syscon 0x70 25>; status = "disabled"; };
Signature · 1 line
2.23.0.187.g17f5b7556c-goog
Quoted 27 lines · Oskar Senft
Make the SIRQ polarity for Aspeed AST24xx/25xx VUART configurable via sysfs. This setting need to be changed on specific host platforms depending on the selected host interface (LPC / eSPI).
The setting is configurable via sysfs rather than device-tree to stay in line with other related configurable settings.
On AST2500 the VUART SIRQ polarity can be auto-configured by reading a bit from a configuration register, e.g. the LPC/eSPI interface configuration bit.
Tested: Verified on TYAN S7106 mainboard.
Signed-off-by Oskar Senft <[email protected]>--- .../ABI/stable/sysfs-driver-aspeed-vuart | 11 ++- drivers/tty/serial/8250/8250_aspeed_vuart.c | 84 +++++++++++++++++++ drivers/tty/serial/8250/Kconfig | 1 + 3 files changed, 95 insertions(+), 1 deletion(-)Documentation/ABI/stable/sysfs-driver-aspeed-vuart +0
-0@@ -6,10 +6,19 @@ Description: Configures which IO port the host sideof the UART
Users: OpenBMC. Proposed changes should be mailed to
Documentation/ABI/stable/sysfs-driver-aspeed-vuart Description: Configures which IO port the host side of the UART · line 9
Quoted 4 lines
Documentation/ABI/stable/sysfs-driver-aspeed-vuart +1
-1[email protected] -What: /sys/bus/platform/drivers/aspeed-vuart*/sirq +What: /sys/bus/platform/drivers/aspeed-vuart/*/sirq
Bit of a nit, but this is unrelated
Quoted 103 lines
Date: April 2017
Contact: Jeremy Kerr <[email protected]>
Description: Configures which interrupt number the host side ofDocumentation/ABI/stable/sysfs-driver-aspeed-vuart +9
-0the UART will appear on the host <-> BMC LPC bus. Users: OpenBMC. Proposed changes should be mailed to [email protected] + +What: /sys/bus/platform/drivers/aspeed-vuart/*/sirq_polarity +Date: July 2019 +Contact: Oskar Senft <[email protected]> +Description: Configures the polarity of the serial interrupt to the + host via the BMC LPC bus. + Set to 0 for active-low or 1 for active-high. +Users: OpenBMC. Proposed changes should be mailed to + [email protected]drivers/tty/serial/8250/8250_aspeed_vuart.c +48
-0@@ -14,6 +14,8 @@#include <linux/of_address.h> #include <linux/of_irq.h> #include <linux/of_platform.h> +#include <linux/regmap.h> +#include <linux/mfd/syscon.h> #include <linux/tty.h> #include <linux/tty_flip.h> #include <linux/clk.h> @@ -22,6 +24,7 @@#define ASPEED_VUART_GCRA 0x20#define ASPEED_VUART_GCRA_VUART_EN BIT(0) +#define ASPEED_VUART_GCRA_HOST_SIRQ_POLARITY BIT(1)#define ASPEED_VUART_GCRA_DISABLE_HOST_TX_DISCARD BIT(5)#define ASPEED_VUART_GCRB 0x24#define ASPEED_VUART_GCRB_HOST_SIRQ_MASK GENMASK(7, 4)@@ -131,8 +134,53 @@ static ssize_t sirq_store(struct device *dev,struct device_attribute *attr, static DEVICE_ATTR_RW(sirq); +static ssize_t sirq_polarity_show (struct device *dev, +struct device_attribute *attr,char *buf) +{ +struct aspeed_vuart *vuart =dev_get_drvdata (dev); +u8 reg; + + reg =readb (vuart->regs +ASPEED_VUART_GCRA ); + reg &=ASPEED_VUART_GCRA_HOST_SIRQ_POLARITY ; + +return snprintf (buf,PAGE_SIZE -1 ,"%u\n" , reg ?1 :0 ); +} + +static void aspeed_vuart_set_sirq_polarity (struct aspeed_vuart *vuart, +bool polarity) +{ +u8 reg =readb (vuart->regs +ASPEED_VUART_GCRA ); + +if (polarity) + reg |=ASPEED_VUART_GCRA_HOST_SIRQ_POLARITY ; +else + reg &= ~ASPEED_VUART_GCRA_HOST_SIRQ_POLARITY ; + +writeb (reg, vuart->regs +ASPEED_VUART_GCRA ); +} + +static ssize_t sirq_polarity_store (struct device *dev, +struct device_attribute *attr, +const char *buf,size_t count) +{ +struct aspeed_vuart *vuart =dev_get_drvdata (dev); +unsigned long val; +int err; + + err =kstrtoul (buf,0 , &val); +if (err) +return err; + +aspeed_vuart_set_sirq_polarity (vuart, val !=0 ); + +return count; +} + +static DEVICE_ATTR_RW (sirq_polarity); +static struct attribute *aspeed_vuart_attrs[] = { &dev_attr_sirq.attr, + &dev_attr_sirq_polarity.attr, &dev_attr_lpc_address.attr,NULL ,};
drivers/tty/serial/8250/8250_aspeed_vuart.c +7
-0@@ -302,8 +350,30 @@ static int aspeed_vuart_handle_irq(struct uart_port *port)return 1 ; } +static void aspeed_vuart_auto_configure_sirq_polarity ( +struct aspeed_vuart *vuart,struct device_node *syscon_np, +u32 reg_offset,u32 reg_mask) +{ +struct regmap *regmap; +u32 value; +
drivers/tty/serial/8250/8250_aspeed_vuart.c static int aspeed_vuart_handle_irq(struct uart_port *port) · line 369
Quoted 10 lines
drivers/tty/serial/8250/8250_aspeed_vuart.c +10
-0+ regmap =syscon_node_to_regmap (syscon_np); +if (IS_ERR (regmap)) { +dev_warn (vuart->dev, +"could not get regmap for aspeed,sirq-polarity-sense\n" ); +return ; + } +if (regmap_read (regmap, reg_offset, &value)) { +dev_warn (vuart->dev,"could not read hw strap table\n" ); +return ; + }
So in the couple of cases above we may have tried to auto-configure the IRQ polarity but failed. We print the messages, but there's no mention of the impact of the failure as it doesn't stop the driver from probing (void return).
I'm thinking it might be useful briefly describe the potential impact, and, given we have the sysfs interface suggest what might need to be done to configure the hardware so it works? Maybe something like:
dev_warn(vuart->dev, "SIRQ polarity auto-configuration failed, host console may misbehave\n"); dev_info(vuart->dev, "Configure SIRQ polarity via %s\n", sysfs_path); // If we have access to the path?
However, both are unlikely corner-cases as they imply either MMIO regmap failed or that the devicetree description was present but broken in some fashion (should be caught in testing), so I'm not hung up about this.
Aside from those nits it looks reasonable to me.
Andrew