[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Xen-devel] [RFC PATCH] xen/arm: Add MVEBU UART driver for Armada 3700 SoC
Hi,
On 03/10/2018 04:44 PM, Amit Singh Tomar wrote:
This patch adds driver for UART controller found on Armada 3700 SoC.
OOI, do you have any plan for adding earlyprintk support for that platform?
There is no reference manuals available for 3700 SoC in public and this
driver is derived by looking at Linux driver.
Please give a link to the Linux driver. This would help me for reviewing
and also for future reference.
For now, see below for some generic comments regarding the code.
Signed-off-by: Amit Singh Tomar <amittomer25@xxxxxxxxx>
---
xen/drivers/char/Kconfig | 8 ++
xen/drivers/char/Makefile | 1 +
xen/drivers/char/mvebu-uart.c | 315 ++++++++++++++++++++++++++++++++++++++++++
This is part of xen/drivers/char/* so even if the driver if only for ARM
hardware, you likely want to CC "THE REST" maintainers as this is under
drivers/char. scripts/get_maintainers.pl can help you to find relevant
maintainers to CC on each patch.
Regarding the maintenance after it is merged, I think it should fold
under "ARM" as for all the other arch specific UART driver (PL011 & co).
3 files changed, 324 insertions(+)
create mode 100644 xen/drivers/char/mvebu-uart.c
diff --git a/xen/drivers/char/Kconfig b/xen/drivers/char/Kconfig
index fb53dd8..690eda6 100644
--- a/xen/drivers/char/Kconfig
+++ b/xen/drivers/char/Kconfig
@@ -12,6 +12,14 @@ config HAS_CADENCE_UART
This selects the Xilinx Zynq Cadence UART. If you have a Xilinx Zynq
based board, say Y.
+config HAS_MVEBU
+ bool
+ default y
+ depends on ARM_64
+ help
+ This selects the Marvell MVEBU UART. if you have an ARMADA 3700
+ based board, say Y.
+
config HAS_PL011
bool
default y
diff --git a/xen/drivers/char/Makefile b/xen/drivers/char/Makefile
index 0d48b16..b68c330 100644
--- a/xen/drivers/char/Makefile
+++ b/xen/drivers/char/Makefile
@@ -3,6 +3,7 @@ obj-$(CONFIG_HAS_NS16550) += ns16550.o
obj-$(CONFIG_HAS_CADENCE_UART) += cadence-uart.o
obj-$(CONFIG_HAS_PL011) += pl011.o
obj-$(CONFIG_HAS_EXYNOS4210) += exynos4210-uart.o
+obj-$(CONFIG_HAS_MVEBU) += mvebu-uart.o
obj-$(CONFIG_HAS_OMAP) += omap-uart.o
obj-$(CONFIG_HAS_SCIF) += scif-uart.o
obj-$(CONFIG_HAS_EHCI) += ehci-dbgp.o
diff --git a/xen/drivers/char/mvebu-uart.c b/xen/drivers/char/mvebu-uart.c
new file mode 100644
index 0000000..fdcc153
--- /dev/null
+++ b/xen/drivers/char/mvebu-uart.c
@@ -0,0 +1,315 @@
+/*
+ * xen/drivers/char/mvebu3700-uart.c
+ *
+ * Driver for Marvell MVEBU UART.
+ *
+ * Amit Singh Tomar<amittomer25@xxxxxxxxx>
NIT: space before <.
+ * Copyright (c) 2018.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ */
+
+#include <asm/device.h>
+#include <asm/io.h>
<xen/*> include should be first, then <asm/*>.
+#include <xen/console.h>
+#include <xen/errno.h>
+#include <xen/init.h>
+#include <xen/irq.h>
+#include <xen/mm.h>
+#include <xen/serial.h>
+#include <xen/serial.h>
xen/serial.h is mentioned twice.
+#include <xen/vmap.h>
+
+#define UART_RX_REG 0x00
+#define RBR_BRK_DET BIT(15)
+#define RBR_FRM_ERR_DET BIT(14)
+#define RBR_PAR_ERR_DET BIT(13)
+#define RBR_OVR_ERR_DET BIT(12)
+
+#define UART_TX_REG 0x04
+
+#define UART_CTRL_REG 0x08
+#define CTRL_SOFT_RST BIT(31)
+#define CTRL_TXFIFO_RST BIT(15)
+#define CTRL_RXFIFO_RST BIT(14)
+#define CTRL_ST_MIRR_EN BIT(13)
+#define CTRL_LPBK_EN BIT(12)
+#define CTRL_SND_BRK_SEQ BIT(11)
+#define CTRL_PAR_EN BIT(10)
+#define CTRL_TWO_STOP BIT(9)
+#define CTRL_TX_HFL_INT BIT(8)
+#define CTRL_RX_HFL_INT BIT(7)
+#define CTRL_TX_EMP_INT BIT(6)
+#define CTRL_TX_RDY_INT BIT(5)
+#define CTRL_RX_RDY_INT BIT(4)
+#define CTRL_BRK_DET_INT BIT(3)
+#define CTRL_FRM_ERR_INT BIT(2)
+#define CTRL_PAR_ERR_INT BIT(1)
+#define CTRL_OVR_ERR_INT BIT(0)
+#define CTRL_RX_INT (CTRL_BRK_DET_INT | CTRL_FRM_ERR_INT | \
+ CTRL_PAR_ERR_INT | CTRL_OVR_ERR_INT)
+
+#define UART_STATUS_REG 0x0c
+#define STATUS_TXFIFO_EMP BIT(13)
+#define STATUS_RXFIFO_EMP BIT(12)
+#define STATUS_TXFIFO_FUL BIT(11)
+#define STATUS_TXFIFO_HFL BIT(10)
+#define STATUS_RX_TOGL BIT(9)
+#define STATUS_RXFIFO_FUL BIT(8)
+#define STATUS_RXFIFO_HFL BIT(7)
+#define STATUS_TX_EMP BIT(6)
+#define STATUS_TX_RDY BIT(5)
+#define STATUS_RX_RDY BIT(4)
+#define STATUS_BRK_DET BIT(3)
+#define STATUS_FRM_ERR BIT(2)
+#define STATUS_PAR_ERR BIT(1)
+#define STATUS_OVR_ERR BIT(0)
+#define STATUS_BRK_ERR (STATUS_BRK_DET | STATUS_FRM_ERR | \
+ STATUS_PAR_ERR | STATUS_OVR_ERR)
+
+#define UART_BAUD_REG 0x10
+#define UART_POSSR_REG 0x14
Can you please only define only registers/bits used in the code?
+
+#define TX_FIFO_SIZE 32
+#define RX_FIFO_SIZE 64
+
+static struct mvebu3700_uart {
+ unsigned int baud, data_bits, parity, stop_bits;
Are all those fields necessary? For instance, you always set baud but
never read it.
+ unsigned int irq;
+ void __iomem *regs;
+ struct irqaction irqaction;
+ struct vuart_info vuart;
+} mvebu3700_com = {0};
+
+#define PARITY_NONE (0)
+
+#define mvebu3700_read(uart, off) readl((uart)->regs + off)
+#define mvebu3700_write(uart, off, val) writel(val, (uart->regs) + off)
+
+static void mvebu3700_uart_interrupt(int irq, void *data, struct
+cpu_user_regs *regs)
The indentation looks wrong here.
+{
+ struct serial_port *port = data;
+ struct mvebu3700_uart *uart = port->uart;
+ unsigned int st = mvebu3700_read(uart, UART_STATUS_REG);
+
+ if ( st & STATUS_TX_RDY )
+ serial_tx_interrupt(port, regs);
+
+ if ( st & (STATUS_RX_RDY | STATUS_OVR_ERR | STATUS_FRM_ERR |
STATUS_BRK_DET) )
+ serial_rx_interrupt(port, regs);
+}
+
+static void __init mvebu3700_uart_init_preirq(struct serial_port *port)
+{
+ struct mvebu3700_uart *uart = port->uart;
+ unsigned ret;
'ret' is a bit confusion. I would expect to be the return value of the
function but it is used a temporary variable for reading/write reg. You
might want to rename to 'reg' for more clarity.
But as this is a register value (i.e specific size), please use uint32_t.
+
+ ret = mvebu3700_read(uart, UART_CTRL_REG);
+ ret |= (CTRL_TXFIFO_RST | CTRL_RXFIFO_RST);
+ mvebu3700_write(uart, UART_CTRL_REG, ret);
+
+ /* Before we make IRQ request, Clear the error bits of state register */
s/Clear/clear/ and missing full stop.
+ ret = mvebu3700_read(uart, UART_STATUS_REG);
+ ret |= STATUS_BRK_ERR;
+ mvebu3700_write(uart, UART_STATUS_REG, ret);
+
+ /* Clear error interrupts */
+ mvebu3700_write(uart, UART_CTRL_REG, CTRL_RX_INT);
+
+ /* Disable Rx/Tx interrupts */
+ ret = mvebu3700_read(uart, UART_CTRL_REG);
+ ret &= ~(CTRL_RX_RDY_INT | CTRL_TX_RDY_INT);
+ mvebu3700_write(uart, UART_CTRL_REG, ret);
+}
+
+static void __init mvebu3700_uart_init_postirq(struct serial_port *port)
+{
+ struct mvebu3700_uart *uart = port->uart;
+ int ret;
+
+ if ( uart->irq > 0 )
+ {
+ uart->irqaction.handler = mvebu3700_uart_interrupt;
+ uart->irqaction.name = "mvebu3700_uart";
+ uart->irqaction.dev_id = port;
+ }
+
+ if ( (ret = setup_irq(uart->irq, 0, &uart->irqaction)) != 0 )
Why do you set 'ret' here?
+ dprintk(XENLOG_ERR, "Failed to allocated mvebu3700_uart IRQ %d\n",
+ uart->irq);
dprintk will only be used in debug build. I think this should be printk
here.
+
+ /* Make sure Rx/Tx interrupts are enabled now */
+ ret = mvebu3700_read(uart, UART_CTRL_REG);
ret is an int. This is usually a pretty bad idea to use signed value for
register. Furthermore, I would highly recommend to specific the size in
the variable type (e.g uint32_t).
+ ret |= (CTRL_RX_RDY_INT | CTRL_TX_RDY_INT);
+ mvebu3700_write(uart, UART_CTRL_REG, ret);
+}
+
+static void mvebu3700_uart_suspend(struct serial_port *port)
+{
+ BUG();
+}
+
+static void mvebu3700_uart_resume(struct serial_port *port)
+{
+ BUG();
+}
+
+static void mvebu3700_uart_putc(struct serial_port *port, char c)
+{
+ struct mvebu3700_uart *uart = port->uart;
+
+ mvebu3700_write(uart, UART_TX_REG, c);
+}
+
+static int mvebu3700_uart_getc(struct serial_port *port, char *c)
+{
+ struct mvebu3700_uart *uart = port->uart;
+
+ if ( !(mvebu3700_read(uart, UART_STATUS_REG) & STATUS_RX_RDY) )
+ return 0;
+
+ *c = mvebu3700_read(uart, UART_RX_REG) & 0xff;
+
+ return 1;
+}
+
+static int __init mvebu3700_irq(struct serial_port *port)
+{
+ struct mvebu3700_uart *uart = port->uart;
+
+ return ( (uart->irq > 0) ? uart->irq : -1 );
+}
+
+static const struct vuart_info *mvebu3700_vuart_info(struct serial_port *port)
+{
+ struct mvebu3700_uart *uart = port->uart;
+
+ return &uart->vuart;
+}
+
+static void mvebu3700_uart_stop_tx(struct serial_port *port)
+{
+ struct mvebu3700_uart *uart = port->uart;
+ unsigned int ctl;
s/unsigned int/uint32_t/.
+
+ ctl = mvebu3700_read(uart, UART_CTRL_REG);
+ ctl &= ~CTRL_TX_RDY_INT;
+ mvebu3700_write(uart, UART_CTRL_REG, ctl);
+}
+
+static void mvebu3700_uart_start_tx(struct serial_port *port)
+{
+ struct mvebu3700_uart *uart = port->uart;
+ unsigned int ctl;
+
+ ctl = mvebu3700_read(uart, UART_CTRL_REG);
+ ctl |= CTRL_TX_RDY_INT;
+ mvebu3700_write(uart, UART_CTRL_REG, ctl);
+}
+
+static int mvebu3700_uart_tx_ready(struct serial_port *port)
+{
+ struct mvebu3700_uart *uart = port->uart;
+
+ return ( mvebu3700_read(uart, UART_STATUS_REG) & STATUS_TXFIFO_EMP ?
+ TX_FIFO_SIZE : 0 );
This is not so nice to read. Can you introduce a temporary variable to
read the register?
+}
+
+static struct uart_driver __read_mostly mvebu3700_uart_driver = {
+ .init_preirq = mvebu3700_uart_init_preirq,
+ .init_postirq = mvebu3700_uart_init_postirq,
+ .endboot = NULL,
+ .suspend = mvebu3700_uart_suspend,
+ .resume = mvebu3700_uart_resume,
+ .putc = mvebu3700_uart_putc,
+ .getc = mvebu3700_uart_getc,
+ .tx_ready = mvebu3700_uart_tx_ready,
+ .stop_tx = mvebu3700_uart_stop_tx,
+ .start_tx = mvebu3700_uart_start_tx,
+ .irq = mvebu3700_irq,
+ .vuart_info = mvebu3700_vuart_info,
+};
+
+static int __init mvebu_uart_init(struct dt_device_node *dev,
+ const void *data)
+{
+ const char *config = data;
+ struct mvebu3700_uart *uart;
+ int res;
+ u64 addr, size;
+
+ if ( strcmp(config, "") )
+ printk("WARNING: UART configuration is not supported\n");
+
+ uart = &mvebu3700_com;
+
+ res = dt_device_get_address(dev, 0, &addr, &size);
+ if ( res )
+ {
+ printk("mvebu3700: Unable to retrieve the base"
+ " address of the UART\n");
Please don't split message (unless there are a newline in it). This is
more difficult to grep in the code. This is one place where we accept
line greater than 80 characters.
+ return res;
+ }
+
+ res = platform_get_irq(dev, 0);
+ if ( res < 0 )
+ {
+ printk("mvebu3700: Unable to retrieve the IRQ\n");
+ return -EINVAL;
+ }
+
+ uart->irq = res;
+ uart->baud = BAUD_AUTO;
+ uart->data_bits = 8;
+ uart->parity = PARITY_NONE;
+ uart->stop_bits = 1;
+
+ uart->regs = ioremap_nocache(addr, size);
+ if ( !uart->regs )
+ {
+ printk("mvebu3700: Unable to map the UART memory\n");
+ return -ENOMEM;
+ }
+
+ uart->vuart.base_addr = addr;
+ uart->vuart.size = size;
+ uart->vuart.data_off = UART_CTRL_REG;
+ uart->vuart.status_off = UART_STATUS_REG;
+ uart->vuart.status = STATUS_TX_RDY | STATUS_RX_RDY;
+
+ /* Register with generic serial driver. */
+ serial_register_uart(SERHND_DTUART, &mvebu3700_uart_driver, uart);
+
+ dt_device_set_used_by(dev, DOMID_XEN);
+
+ return 0;
+}
+
+static const struct dt_device_match mvebu_dt_match[] __initconst =
+{
+ DT_MATCH_COMPATIBLE("marvell,armada-3700-uart"),
+ { /* sentinel */ },
+};
+
+DT_DEVICE_START(mvebu, "Marvell Armada-3700 UART", DEVICE_SERIAL)
+ .dt_match = mvebu_dt_match,
+ .init = mvebu_uart_init,
+DT_DEVICE_END
+
+/*
+ * Local variables:
+ * mode: C
+ * c-file-style: "BSD"
+ * c-basic-offset: 4
+ * indent-tabs-mode: nil
+ * End:
+ */
Cheers,
--
Julien Grall
_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxxx
https://lists.xenproject.org/mailman/listinfo/xen-devel
|
