Skip to contentSkip to conversation

nios2: convert altera_jtag_uart to driver model

PATCH Superseded Thomas Chou 3 participants 18 messages Sep 15, 2015 – Sep 24, 2015 NIOS2 architecture

lore
Share & tools
lore
#0 lore raw

v3 cover nios2: convert altera_jtag_uart to driver model

Update the dts and convert altera_jtag_uart to driver model.

v2
add ioremap.
make the change to dts compatible with linux.

v3
use fdt address translation patch from Stefan Roese. fix watchdog and loop as Marek suggested.

Thomas Chou (2):
nios2: map physical address to uncached virtual address
nios2: convert altera_jtag_uart to driver model

 arch/nios2/cpu/interrupts.c       |   4 +-
 arch/nios2/dts/3c120_devboard.dts |   5 ++
 arch/nios2/include/asm/io.h       |   5 ++
 configs/nios2-generic_defconfig   |   3 +
 drivers/serial/Kconfig            |  13 +++++
 drivers/serial/altera_jtag_uart.c | 112 ++++++++++++++++++++++----------------
 include/configs/nios2-generic.h   |   3 -
 7 files changed, 93 insertions(+), 52 deletions(-)
Signature · 1 line
2.1.4
#1 lore raw

PATCH v3 1/2 nios2: map physical address to uncached virtual address

Add ioremap() to map physical address to uncached virtual address. We need this to convert the reg address from the device tree.

The order of headers inclusion in interrupts.c is changed because common.h will include board header that contains IO_REGION_BASE.

In the future, the IO_REGION_BASE should be decided from the device tree.
tree

---
 arch/nios2/cpu/interrupts.c | 4 ++--
 arch/nios2/include/asm/io.h | 5 +++++
 2 files changed, 7 insertions(+), 2 deletions(-)
arch/nios2/cpu/interrupts.c +2 -2
index 9d85eb0..1599674 100644
@@ -8,12 +8,12 @@
  * SPDX-License-Identifier:	GPL-2.0+
  */
 
+#include <common.h>
+#include <command.h>
 #include <asm/nios2.h>
 #include <asm/types.h>
 #include <asm/io.h>
 #include <asm/ptrace.h>
-#include <common.h>
-#include <command.h>
 
 /*************************************************************************/
 struct	irq_action {
arch/nios2/include/asm/io.h +5 -0
index 69ab23e..b4bd20f 100644
@@ -42,6 +42,11 @@ static inline phys_addr_t virt_to_phys(void * vaddr)
 	return (phys_addr_t)(vaddr);
 }
 
+static inline void *ioremap(unsigned long physaddr, unsigned long size)
+{
+	return (void *)(IO_REGION_BASE | physaddr);
+}
+
 extern unsigned char inb (unsigned char *port);
 extern unsigned short inw (unsigned short *port);
 extern unsigned inl (unsigned port);
Signature · 1 line
2.1.4
#2 lore raw

PATCH v3 1/2 nios2: map physical address to uncached virtual address

Quoted 12 lines · Thomas Chou

Add ioremap() to map physical address to uncached virtual address. We need this to convert the reg address from the device tree.

The order of headers inclusion in interrupts.c is changed because common.h will include board header that contains IO_REGION_BASE.

In the future, the IO_REGION_BASE should be decided from the device tree.
tree

Quoted 6 lines
---
  arch/nios2/cpu/interrupts.c | 4 ++--
  arch/nios2/include/asm/io.h | 5 +++++
  2 files changed, 7 insertions(+), 2 deletions(-)

This patch should not be bound with the jtag uart driver. Separate this from the series.

Applied to u-boot-nios.

#3 lore raw

PATCH v3 2/2 nios2: convert altera_jtag_uart to driver model

In reply to Thomas Chou

Convert altera_jtag_uart to driver model.

---
 arch/nios2/dts/3c120_devboard.dts |   5 ++
 configs/nios2-generic_defconfig   |   3 +
 drivers/serial/Kconfig            |  13 +++++
 drivers/serial/altera_jtag_uart.c | 112 ++++++++++++++++++++++----------------
 include/configs/nios2-generic.h   |   3 -
 5 files changed, 86 insertions(+), 50 deletions(-)
arch/nios2/dts/3c120_devboard.dts +5 -0
index 02524ab..7f76328 100644
@@ -93,6 +93,7 @@
 				reg = <0x00004d50 0x00000008>;
 				interrupt-parent = <&cpu>;
 				interrupts = <1>;
+				u-boot,dm-pre-reloc;
 			};
 
 			tse_mac: ethernet at 0x4000 {
@@ -147,6 +148,10 @@
 		};
 	};
 
+	aliases {
+		console = &jtag_uart;
+	};
+
 	chosen {
 		bootargs = "debug console=ttyJ0,115200";
 	};
configs/nios2-generic_defconfig +3 -0
index 9c1bec5..9dc6a72 100644
@@ -1,4 +1,5 @@
 CONFIG_NIOS2=y
+CONFIG_DM_SERIAL=y
 CONFIG_TARGET_NIOS2_GENERIC=y
 CONFIG_DEFAULT_DEVICE_TREE="3c120_devboard"
 CONFIG_HUSH_PARSER=y
@@ -14,3 +15,5 @@ CONFIG_CMD_PING=y
 CONFIG_OF_CONTROL=y
 CONFIG_NET_RANDOM_ETHADDR=y
 CONFIG_DM=y
+CONFIG_ALTERA_JTAG_UART=y
+CONFIG_ALTERA_JTAG_UART_BYPASS=y
drivers/serial/Kconfig +13 -0
index ccb80d2..5a8cb3a 100644
@@ -109,6 +109,19 @@ config DEBUG_UART_SHIFT
 	  value. Use this value to specify the shift to use, where 0=byte
 	  registers, 2=32-bit word registers, etc.
 
+config ALTERA_JTAG_UART
+	bool "Altera JTAG UART support"
+	depends on NIOS2 && DM_SERIAL
+	help
+	  Select this to enable an JTAG UART for Altera devices.
+
+config ALTERA_JTAG_UART_BYPASS
+	bool "Bypass output when no connection"
+	depends on ALTERA_JTAG_UART
+	help
+	  Bypass console output and keep going even if there is no
+	  JTAG terminal connection with the host.
+
 config ROCKCHIP_SERIAL
 	bool "Rockchip on-chip UART support"
 	depends on ARCH_UNIPHIER && DM_SERIAL
drivers/serial/altera_jtag_uart.c +65 -47

163 lines not on this page · raw message

include/configs/nios2-generic.h +0 -3
index 66ad2f0..bd6d45c 100644
@@ -23,14 +23,11 @@
 /*
  * SERIAL
  */
-#define CONFIG_ALTERA_JTAG_UART
 #if defined(CONFIG_ALTERA_JTAG_UART)
-# define CONFIG_SYS_NIOS_CONSOLE	CONFIG_SYS_JTAG_UART_BASE
 #else
 # define CONFIG_SYS_NIOS_CONSOLE	CONFIG_SYS_UART_BASE
 #endif
 
-#define CONFIG_ALTERA_JTAG_UART_BYPASS
 #define CONFIG_SYS_NIOS_FIXEDBAUD
 #define CONFIG_BAUDRATE		CONFIG_SYS_UART_BAUD
 #define CONFIG_SYS_BAUDRATE_TABLE	{CONFIG_BAUDRATE}
Signature · 1 line
2.1.4
#4 lore raw

PATCH v4 1/1 nios2: convert altera_jtag_uart to driver model

In reply to Thomas Chou

Convert altera_jtag_uart to driver model.

---

v2
add ioremap.
make the change to dts compatible with linux.

v3
use fdt address translation patch from Stefan Roese. fix watchdog and loop as Marek suggested.

v4
add clear AC flag to probe().
remove polling loops and watchdog reset because they are
done in the serial-uclass.c.

 arch/nios2/dts/3c120_devboard.dts |   5 ++
 configs/nios2-generic_defconfig   |   3 +
 drivers/serial/Kconfig            |  13 ++++
 drivers/serial/altera_jtag_uart.c | 137 ++++++++++++++++++++++----------------
 include/configs/nios2-generic.h   |   3 -
 5 files changed, 102 insertions(+), 59 deletions(-)
arch/nios2/dts/3c120_devboard.dts +5 -0
index 02524ab..7f76328 100644
@@ -93,6 +93,7 @@
 				reg = <0x00004d50 0x00000008>;
 				interrupt-parent = <&cpu>;
 				interrupts = <1>;
+				u-boot,dm-pre-reloc;
 			};
 
 			tse_mac: ethernet at 0x4000 {
@@ -147,6 +148,10 @@
 		};
 	};
 
+	aliases {
+		console = &jtag_uart;
+	};
+
 	chosen {
 		bootargs = "debug console=ttyJ0,115200";
 	};
configs/nios2-generic_defconfig +3 -0
index 9c1bec5..9dc6a72 100644
@@ -1,4 +1,5 @@
 CONFIG_NIOS2=y
+CONFIG_DM_SERIAL=y
 CONFIG_TARGET_NIOS2_GENERIC=y
 CONFIG_DEFAULT_DEVICE_TREE="3c120_devboard"
 CONFIG_HUSH_PARSER=y
@@ -14,3 +15,5 @@ CONFIG_CMD_PING=y
 CONFIG_OF_CONTROL=y
 CONFIG_NET_RANDOM_ETHADDR=y
 CONFIG_DM=y
+CONFIG_ALTERA_JTAG_UART=y
+CONFIG_ALTERA_JTAG_UART_BYPASS=y
drivers/serial/Kconfig +13 -0
index ccb80d2..5a8cb3a 100644
@@ -109,6 +109,19 @@ config DEBUG_UART_SHIFT
 	  value. Use this value to specify the shift to use, where 0=byte
 	  registers, 2=32-bit word registers, etc.
 
+config ALTERA_JTAG_UART
+	bool "Altera JTAG UART support"
+	depends on NIOS2 && DM_SERIAL
+	help
+	  Select this to enable an JTAG UART for Altera devices.
+
+config ALTERA_JTAG_UART_BYPASS
+	bool "Bypass output when no connection"
+	depends on ALTERA_JTAG_UART
+	help
+	  Bypass console output and keep going even if there is no
+	  JTAG terminal connection with the host.
+
 config ROCKCHIP_SERIAL
 	bool "Rockchip on-chip UART support"
 	depends on ARCH_UNIPHIER && DM_SERIAL
drivers/serial/altera_jtag_uart.c +81 -56

179 lines not on this page · raw message

include/configs/nios2-generic.h +0 -3
index 66ad2f0..bd6d45c 100644
@@ -23,14 +23,11 @@
 /*
  * SERIAL
  */
-#define CONFIG_ALTERA_JTAG_UART
 #if defined(CONFIG_ALTERA_JTAG_UART)
-# define CONFIG_SYS_NIOS_CONSOLE	CONFIG_SYS_JTAG_UART_BASE
 #else
 # define CONFIG_SYS_NIOS_CONSOLE	CONFIG_SYS_UART_BASE
 #endif
 
-#define CONFIG_ALTERA_JTAG_UART_BYPASS
 #define CONFIG_SYS_NIOS_FIXEDBAUD
 #define CONFIG_BAUDRATE		CONFIG_SYS_UART_BAUD
 #define CONFIG_SYS_BAUDRATE_TABLE	{CONFIG_BAUDRATE}
Signature · 1 line
2.1.4
#5 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

In reply to Thomas Chou

Convert altera_jtag_uart to driver model.

---

v2
add ioremap.
make the change to dts compatible with linux.

v3
use fdt address translation patch from Stefan Roese. fix watchdog and loop as Marek suggested.

v4
add clear AC flag to probe().
remove polling loops and watchdog reset because they are
done in the serial-uclass.c.

v5
fix coding style as Marek suggested to altera_uart.

 arch/nios2/dts/3c120_devboard.dts |   5 ++
 configs/nios2-generic_defconfig   |   3 +
 drivers/serial/Kconfig            |  13 ++++
 drivers/serial/altera_jtag_uart.c | 145 ++++++++++++++++++++++----------------
 include/configs/nios2-generic.h   |   3 -
 5 files changed, 106 insertions(+), 63 deletions(-)
arch/nios2/dts/3c120_devboard.dts +5 -0
index 02524ab..7f76328 100644
@@ -93,6 +93,7 @@
 				reg = <0x00004d50 0x00000008>;
 				interrupt-parent = <&cpu>;
 				interrupts = <1>;
+				u-boot,dm-pre-reloc;
 			};
 
 			tse_mac: ethernet at 0x4000 {
@@ -147,6 +148,10 @@
 		};
 	};
 
+	aliases {
+		console = &jtag_uart;
+	};
+
 	chosen {
 		bootargs = "debug console=ttyJ0,115200";
 	};
configs/nios2-generic_defconfig +3 -0
index 9c1bec5..9dc6a72 100644
@@ -1,4 +1,5 @@
 CONFIG_NIOS2=y
+CONFIG_DM_SERIAL=y
 CONFIG_TARGET_NIOS2_GENERIC=y
 CONFIG_DEFAULT_DEVICE_TREE="3c120_devboard"
 CONFIG_HUSH_PARSER=y
@@ -14,3 +15,5 @@ CONFIG_CMD_PING=y
 CONFIG_OF_CONTROL=y
 CONFIG_NET_RANDOM_ETHADDR=y
 CONFIG_DM=y
+CONFIG_ALTERA_JTAG_UART=y
+CONFIG_ALTERA_JTAG_UART_BYPASS=y
drivers/serial/Kconfig +13 -0
index ccb80d2..5a8cb3a 100644
@@ -109,6 +109,19 @@ config DEBUG_UART_SHIFT
 	  value. Use this value to specify the shift to use, where 0=byte
 	  registers, 2=32-bit word registers, etc.
 
+config ALTERA_JTAG_UART
+	bool "Altera JTAG UART support"
+	depends on NIOS2 && DM_SERIAL
+	help
+	  Select this to enable an JTAG UART for Altera devices.
+
+config ALTERA_JTAG_UART_BYPASS
+	bool "Bypass output when no connection"
+	depends on ALTERA_JTAG_UART
+	help
+	  Bypass console output and keep going even if there is no
+	  JTAG terminal connection with the host.
+
 config ROCKCHIP_SERIAL
 	bool "Rockchip on-chip UART support"
 	depends on ARCH_UNIPHIER && DM_SERIAL
drivers/serial/altera_jtag_uart.c +85 -60

183 lines not on this page · raw message

include/configs/nios2-generic.h +0 -3
index 66ad2f0..bd6d45c 100644
@@ -23,14 +23,11 @@
 /*
  * SERIAL
  */
-#define CONFIG_ALTERA_JTAG_UART
 #if defined(CONFIG_ALTERA_JTAG_UART)
-# define CONFIG_SYS_NIOS_CONSOLE	CONFIG_SYS_JTAG_UART_BASE
 #else
 # define CONFIG_SYS_NIOS_CONSOLE	CONFIG_SYS_UART_BASE
 #endif
 
-#define CONFIG_ALTERA_JTAG_UART_BYPASS
 #define CONFIG_SYS_NIOS_FIXEDBAUD
 #define CONFIG_BAUDRATE		CONFIG_SYS_UART_BAUD
 #define CONFIG_SYS_BAUDRATE_TABLE	{CONFIG_BAUDRATE}
Signature · 1 line
2.1.4
#7 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

Hi Marek,

Quoted 2 lines · Marek Vasut

btw I wonder if the ALTERA_JTAG_UART_BYPASS shouldn't be configured from DT instead now. What do you think ?

This feature is more like a switch between production and development. We would turn off the bypass to see every message the console output during development/debug. And turn on the bypass when there is no jtag connected in production. I would think a Kconfig option might better fit and keep the DT intact.

Best regards,
Thomas Chou

#8 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

Quoted 1 line · Thomas Chou

Hi Marek,

Hi,

Quoted 9 lines · Marek Vasut
Quoted 2 lines

btw I wonder if the ALTERA_JTAG_UART_BYPASS shouldn't be configured from DT instead now. What do you think ?

This feature is more like a switch between production and development. We would turn off the bypass to see every message the console output during development/debug. And turn on the bypass when there is no jtag connected in production. I would think a Kconfig option might better fit and keep the DT intact.

Well if there's no JTAG connected in production, why enable the device in DT at all ?

Best regards,
Marek Vasut

#9 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

Hi Marek,

Quoted 2 lines · Marek Vasut

Well if there's no JTAG connected in production, why enable the device in DT at all ?

Usually, it will be used for after service.

Best regards,
Thomas Chou

#10 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

Quoted 7 lines · Thomas Chou

Hi Marek,

Quoted 2 lines · Marek Vasut

Well if there's no JTAG connected in production, why enable the device in DT at all ?

Usually, it will be used for after service.

I see, thanks for clarifying :)

Best regards,
Marek Vasut

#11 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

In reply to Thomas Chou

Hi Thomas,

Quoted 22 lines · Thomas Chou

Convert altera_jtag_uart to driver model.

---

v2
add ioremap.
make the change to dts compatible with linux.

v3
use fdt address translation patch from Stefan Roese. fix watchdog and loop as Marek suggested.

v4
add clear AC flag to probe().
remove polling loops and watchdog reset because they are
done in the serial-uclass.c.

v5
fix coding style as Marek suggested to altera_uart.

Quoted 6 lines
 arch/nios2/dts/3c120_devboard.dts |   5 ++
 configs/nios2-generic_defconfig   |   3 +
 drivers/serial/Kconfig            |  13 ++++
 drivers/serial/altera_jtag_uart.c | 145 ++++++++++++++++++++++----------------
 include/configs/nios2-generic.h   |   3 -
 5 files changed, 106 insertions(+), 63 deletions(-)

This looks right to me but I have some comments below.

Quoted 14 lines
arch/nios2/dts/3c120_devboard.dts +1 -0
index 02524ab..7f76328 100644
@@ -93,6 +93,7 @@
                                reg = <0x00004d50 0x00000008>;
                                interrupt-parent = <&cpu>;
                                interrupts = <1>;
+                               u-boot,dm-pre-reloc;
                        };
 
                        tse_mac: ethernet at 0x4000 {

arch/nios2/dts/3c120_devboard.dts line 152

Quoted 5 lines
arch/nios2/dts/3c120_devboard.dts +2 -0
@@ -147,6 +148,10 @@
                };
        };
 
+       aliases {
+               console = &jtag_uart;

The normal way is to put this into the 'chosen' node, with the property name stdout-path.

Quoted 26 lines
arch/nios2/dts/3c120_devboard.dts +2 -0
+       };
+
        chosen {
                bootargs = "debug console=ttyJ0,115200";
        };
configs/nios2-generic_defconfig +3 -0
index 9c1bec5..9dc6a72 100644
@@ -1,4 +1,5 @@
 CONFIG_NIOS2=y
+CONFIG_DM_SERIAL=y
 CONFIG_TARGET_NIOS2_GENERIC=y
 CONFIG_DEFAULT_DEVICE_TREE="3c120_devboard"
 CONFIG_HUSH_PARSER=y
@@ -14,3 +15,5 @@ CONFIG_CMD_PING=y
 CONFIG_OF_CONTROL=y
 CONFIG_NET_RANDOM_ETHADDR=y
 CONFIG_DM=y
+CONFIG_ALTERA_JTAG_UART=y
+CONFIG_ALTERA_JTAG_UART_BYPASS=y
drivers/serial/Kconfig +0 -0
index ccb80d2..5a8cb3a 100644

drivers/serial/Kconfig config DEBUG_UART_SHIFT · line 116

Quoted 8 lines
drivers/serial/Kconfig +5 -0
@@ -109,6 +109,19 @@ config DEBUG_UART_SHIFT
          value. Use this value to specify the shift to use, where 0=byte
          registers, 2=32-bit word registers, etc.
 
+config ALTERA_JTAG_UART
+       bool "Altera JTAG UART support"
+       depends on NIOS2 && DM_SERIAL
+       help
+         Select this to enable an JTAG UART for Altera devices.

a JTAG UART

Is there anything else to say about it? Perhaps how it works? A link to instructions on how to set it up?

Quoted 64 lines
drivers/serial/Kconfig +8 -0
+
+config ALTERA_JTAG_UART_BYPASS
+       bool "Bypass output when no connection"
+       depends on ALTERA_JTAG_UART
+       help
+         Bypass console output and keep going even if there is no
+         JTAG terminal connection with the host.
+
 config ROCKCHIP_SERIAL
        bool "Rockchip on-chip UART support"
        depends on ARCH_UNIPHIER && DM_SERIAL
drivers/serial/altera_jtag_uart.c +12 -18
index 9a81402..2c025bc 100644
@@ -6,98 +6,123 @@
  */
 
 #include <common.h>
-#include <watchdog.h>
+#include <dm.h>
+#include <errno.h>
 #include <asm/io.h>
 #include <linux/compiler.h>
 #include <serial.h>
 
-typedef volatile struct {
-       unsigned        data;                   /* Data register */
-       unsigned        control;                /* Control register */
-} nios_jtag_t;
+struct altera_jtaguart_regs {
+       u32     data;                   /* Data register */
+       u32     control;                /* Control register */
+};
+
+struct altera_jtaguart_platdata {
+       struct altera_jtaguart_regs *reg;
+};
 
 /* data register */
 #define NIOS_JTAG_RVALID       (1<<15)         /* Read valid */
-#define NIOS_JTAG_DATA(d)      ((d)&0x0ff)     /* Read data */
-#define NIOS_JTAG_RAVAIL(d)    ((d)>>16)       /* Read space avail */
 
 /* control register */
-#define NIOS_JTAG_RE           (1 << 0)        /* read intr enable */
-#define NIOS_JTAG_WE           (1 << 1)        /* write intr enable */
-#define NIOS_JTAG_RI           (1 << 8)        /* read intr pending */
-#define NIOS_JTAG_WI           (1 << 9)        /* write intr pending*/
 #define NIOS_JTAG_AC           (1 << 10)       /* activity indicator */
 #define NIOS_JTAG_RRDY         (1 << 12)       /* read available */
 #define NIOS_JTAG_WSPACE(d)    ((d)>>16)       /* Write space avail */
+/* Write fifo size. FIXME: this should be extracted with sopc2dts */
+#define NIOS_JTAG_WRITE_DEPTH  64
 
 DECLARE_GLOBAL_DATA_PTR;
 
-/*------------------------------------------------------------------
- * JTAG acts as the serial port
- *-----------------------------------------------------------------*/
-static nios_jtag_t *jtag = (nios_jtag_t *)CONFIG_SYS_NIOS_CONSOLE;
-
-static void altera_jtag_serial_setbrg(void)
-{

drivers/serial/altera_jtag_uart.c line 41

Quoted 10 lines
drivers/serial/altera_jtag_uart.c +2 -4
-}
-
-static int altera_jtag_serial_init(void)
+static int altera_jtaguart_setbrg(struct udevice *dev, int baudrate)
 {
        return 0;
 }
 
-static void altera_jtag_serial_putc(char c)
+static int altera_jtaguart_putc(struct udevice *dev, const char c)

While you are here, how abouve 'ch' instead of 'c' as it is easier to spot.

drivers/serial/altera_jtag_uart.c line 47

Quoted 10 lines
drivers/serial/altera_jtag_uart.c +4 -4
 {
-       while (1) {
-               unsigned st = readl(&jtag->control);
-               if (NIOS_JTAG_WSPACE(st))
-                       break;
+       struct altera_jtaguart_platdata *plat = dev->platdata;
+       struct altera_jtaguart_regs *const regs = plat->reg;
+       u32 st = readl(&regs->control);
+
 #ifdef CONFIG_ALTERA_JTAG_UART_BYPASS

It seems odd that you return this error when writing a character. Don't you know whether the connection is valid in the probe() method? Or are you trying to avoid an error at that stage?

Quoted 17 lines
drivers/serial/altera_jtag_uart.c +9 -5
-               if (!(st & NIOS_JTAG_AC)) /* no connection */
-                       return;
+       if (!(st & NIOS_JTAG_AC)) /* no connection */
+               return -ENETUNREACH;
 #endif
-               WATCHDOG_RESET();
-       }
-       writel ((unsigned char)c, &jtag->data);
+
+       if (NIOS_JTAG_WSPACE(st) == 0)
+               return -EAGAIN;
+
+       writel(c, &regs->data);
+
+       return 0;
 }
 

drivers/serial/altera_jtag_uart.c line 67

Quoted 10 lines
drivers/serial/altera_jtag_uart.c +7 -2
-static int altera_jtag_serial_tstc(void)
+static int altera_jtaguart_pending(struct udevice *dev, bool input)
 {
-       return ( readl (&jtag->control) & NIOS_JTAG_RRDY);
+       struct altera_jtaguart_platdata *plat = dev->platdata;
+       struct altera_jtaguart_regs *const regs = plat->reg;
+       u32 st = readl(&regs->control);
+
+       if (input)
+               return st & NIOS_JTAG_RRDY;

I think this should be:

               return st & NIOS_JTAG_RRDY ? 1 : 0;
Quoted 52 lines
drivers/serial/altera_jtag_uart.c +21 -25
+       else
+               return !(NIOS_JTAG_WSPACE(st) == NIOS_JTAG_WRITE_DEPTH);
 }
 
-static int altera_jtag_serial_getc(void)
+static int altera_jtaguart_getc(struct udevice *dev)
 {
-       int c;
-       unsigned val;
-
-       while (1) {
-               WATCHDOG_RESET ();
-               val = readl (&jtag->data);
-               if (val & NIOS_JTAG_RVALID)
-                       break;
-       }
-       c = val & 0x0ff;
-       return (c);
-}
+       struct altera_jtaguart_platdata *plat = dev->platdata;
+       struct altera_jtaguart_regs *const regs = plat->reg;
+       u32 val;
 
-static struct serial_device altera_jtag_serial_drv = {
-       .name   = "altera_jtag_uart",
-       .start  = altera_jtag_serial_init,
-       .stop   = NULL,
-       .setbrg = altera_jtag_serial_setbrg,
-       .putc   = altera_jtag_serial_putc,
-       .puts   = default_serial_puts,
-       .getc   = altera_jtag_serial_getc,
-       .tstc   = altera_jtag_serial_tstc,
-};
+       val = readl(&regs->data);
+
+       if (!(val & NIOS_JTAG_RVALID))
+               return -EAGAIN;
 
-void altera_jtag_serial_initialize(void)
+       return val & 0xff;
+}
+
+static int altera_jtaguart_probe(struct udevice *dev)
 {
-       serial_register(&altera_jtag_serial_drv);
+       struct altera_jtaguart_platdata *plat = dev->platdata;
+       struct altera_jtaguart_regs *const regs = plat->reg;
+
+#ifdef CONFIG_ALTERA_JTAG_UART_BYPASS
+       writel(NIOS_JTAG_AC, &regs->control); /* clear AC flag */
+#endif
+       return 0;

drivers/serial/altera_jtag_uart.c line 102

Quoted 10 lines
drivers/serial/altera_jtag_uart.c +5 -2
 }
 
-__weak struct serial_device *default_serial_console(void)
+static int altera_jtaguart_ofdata_to_platdata(struct udevice *dev)
 {
-       return &altera_jtag_serial_drv;
+       struct altera_jtaguart_platdata *plat = dev_get_platdata(dev);
+
+       plat->reg = ioremap(dev_get_addr(dev),
+               sizeof(struct altera_jtaguart_regs));

What is the ioremap() for? Is this because we don't support ranges properly yet? If so, perhaps we can assume that will be fixed before this is applied?

Quoted 46 lines
drivers/serial/altera_jtag_uart.c +25 -0
+
+       return 0;
 }
+
+static const struct dm_serial_ops altera_jtaguart_ops = {
+       .putc = altera_jtaguart_putc,
+       .pending = altera_jtaguart_pending,
+       .getc = altera_jtaguart_getc,
+       .setbrg = altera_jtaguart_setbrg,
+};
+
+static const struct udevice_id altera_jtaguart_ids[] = {
+       { .compatible = "altr,juart-1.0", },
+       { }
+};
+
+U_BOOT_DRIVER(altera_jtaguart) = {
+       .name   = "altera_jtaguart",
+       .id     = UCLASS_SERIAL,
+       .of_match = altera_jtaguart_ids,
+       .ofdata_to_platdata = altera_jtaguart_ofdata_to_platdata,
+       .platdata_auto_alloc_size = sizeof(struct altera_jtaguart_platdata),
+       .probe = altera_jtaguart_probe,
+       .ops    = &altera_jtaguart_ops,
+       .flags = DM_FLAG_PRE_RELOC,
+};
include/configs/nios2-generic.h +0 -4
index 66ad2f0..bd6d45c 100644
@@ -23,14 +23,11 @@
 /*
  * SERIAL
  */
-#define CONFIG_ALTERA_JTAG_UART
 #if defined(CONFIG_ALTERA_JTAG_UART)
-# define CONFIG_SYS_NIOS_CONSOLE       CONFIG_SYS_JTAG_UART_BASE
 #else
 # define CONFIG_SYS_NIOS_CONSOLE       CONFIG_SYS_UART_BASE
 #endif
 
-#define CONFIG_ALTERA_JTAG_UART_BYPASS
 #define CONFIG_SYS_NIOS_FIXEDBAUD
 #define CONFIG_BAUDRATE                CONFIG_SYS_UART_BAUD
 #define CONFIG_SYS_BAUDRATE_TABLE      {CONFIG_BAUDRATE}
--
Quoted 2 lines

2.1.4

Regards,
Simon

#12 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

Hi,

Quoted 32 lines · Simon Glass

Hi Thomas,

Quoted 22 lines · Thomas Chou

Convert altera_jtag_uart to driver model.

---

v2
add ioremap.
make the change to dts compatible with linux.

v3
use fdt address translation patch from Stefan Roese. fix watchdog and loop as Marek suggested.

v4
add clear AC flag to probe().
remove polling loops and watchdog reset because they are
done in the serial-uclass.c.

v5
fix coding style as Marek suggested to altera_uart.

Quoted 6 lines
 arch/nios2/dts/3c120_devboard.dts |   5 ++
 configs/nios2-generic_defconfig   |   3 +
 drivers/serial/Kconfig            |  13 ++++
 drivers/serial/altera_jtag_uart.c | 145 ++++++++++++++++++++++----------------
 include/configs/nios2-generic.h   |   3 -
 5 files changed, 106 insertions(+), 63 deletions(-)
Quoted 3 lines

This looks right to me but I have some comments below.

Actually I have one more comment - consider implementing CONFIG_DEBUG_UART in this driver. That way you can have UART output before driver model is ready.

Regards,
Simon

#13 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

Hi Simon,

Quoted 3 lines · Simon Glass

Actually I have one more comment - consider implementing
CONFIG_DEBUG_UART in this driver. That way you can have UART output before driver model is ready.

Thanks a lot for your helpful reviews and suggestions. I will add the early debug to both altera jtag uart and uart.

Best regards,
Thomas Chou

#14 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

Hi Simon,

Quoted 9 lines · Thomas Chou

Hi Simon,

Quoted 3 lines · Simon Glass

Actually I have one more comment - consider implementing
CONFIG_DEBUG_UART in this driver. That way you can have UART output before driver model is ready.

Thanks a lot for your helpful reviews and suggestions. I will add the early debug to both altera jtag uart and uart.

I added the early debug uart. But how can I test it?
Is there a DEBUG definition that I can test the output of early debug?

Best regards,
Thomas Chou

#15 lore raw

PATCH v5 1/1 nios2: convert altera_jtag_uart to driver model

In reply to Simon Glass

Hi Simon,

Quoted 11 lines · Simon Glass

drivers/serial/altera_jtag_uart.c line 47

Quoted 10 lines
  {
drivers/serial/altera_jtag_uart.c +4 -4
-       while (1) {
-               unsigned st = readl(&jtag->control);
-               if (NIOS_JTAG_WSPACE(st))
-                       break;
+       struct altera_jtaguart_platdata *plat = dev->platdata;
+       struct altera_jtaguart_regs *const regs = plat->reg;
+       u32 st = readl(&regs->control);
+
  #ifdef CONFIG_ALTERA_JTAG_UART_BYPASS
Quoted 3 lines

It seems odd that you return this error when writing a character. Don't you know whether the connection is valid in the probe() method? Or are you trying to avoid an error at that stage?

The console output will resume once the JTAG terminal is connected. Before that the output is skipped.

Without the bypass, the console output will wait forever until a JTAG terminal is connected. You will see every message the console output.

Quoted 6 lines

drivers/serial/altera_jtag_uart.c line 102

Quoted 2 lines
drivers/serial/altera_jtag_uart.c +2 -0
+       plat->reg = ioremap(dev_get_addr(dev),
+               sizeof(struct altera_jtaguart_regs));

What is the ioremap() for? Is this because we don't support ranges properly yet? If so, perhaps we can assume that will be fixed before this is applied?

The reg address in dts file for nios2 linux is physical address. We will need to map it to uncached virtual address for the peripherals.

Most linux drivers use ioremap(), though it is rare on u-boot.

We do need the range translation, as there may be bridges to the peripherals.

Best regards,
Thomas Chou

#16 lore raw

PATCH v6 1/1 nios2: convert altera_jtag_uart to driver model

In reply to Thomas Chou

Convert altera_jtag_uart to driver model.

---
v2
add ioremap.
make the change to dts compatible with linux.

v3
use fdt address translation patch from Stefan Roese. fix watchdog and loop as Marek suggested.

v4
add clear AC flag to probe().
remove polling loops and watchdog reset because they are
done in the serial-uclass.c.

v5
fix coding style as Marek suggested to altera_uart.

v6
add early debug uart.
use chosen stdout-path to assign console.
fix coding style as Simon suggested.

 arch/nios2/dts/3c120_devboard.dts |   2 +
 configs/nios2-generic_defconfig   |   3 +
 drivers/serial/Kconfig            |  26 ++++++
 drivers/serial/altera_jtag_uart.c | 171 +++++++++++++++++++++++++-------------
 include/configs/nios2-generic.h   |   3 -
 5 files changed, 142 insertions(+), 63 deletions(-)
arch/nios2/dts/3c120_devboard.dts +2 -0
index 02524ab..07bec69 100644
@@ -93,6 +93,7 @@
 				reg = <0x00004d50 0x00000008>;
 				interrupt-parent = <&cpu>;
 				interrupts = <1>;
+				u-boot,dm-pre-reloc;
 			};
 
 			tse_mac: ethernet at 0x4000 {
@@ -149,5 +150,6 @@
 
 	chosen {
 		bootargs = "debug console=ttyJ0,115200";
+		stdout-path = &jtag_uart;
 	};
 };
configs/nios2-generic_defconfig +3 -0
index 9c1bec5..9dc6a72 100644
@@ -1,4 +1,5 @@
 CONFIG_NIOS2=y
+CONFIG_DM_SERIAL=y
 CONFIG_TARGET_NIOS2_GENERIC=y
 CONFIG_DEFAULT_DEVICE_TREE="3c120_devboard"
 CONFIG_HUSH_PARSER=y
@@ -14,3 +15,5 @@ CONFIG_CMD_PING=y
 CONFIG_OF_CONTROL=y
 CONFIG_NET_RANDOM_ETHADDR=y
 CONFIG_DM=y
+CONFIG_ALTERA_JTAG_UART=y
+CONFIG_ALTERA_JTAG_UART_BYPASS=y
drivers/serial/Kconfig +26 -0
index ccb80d2..10505dc 100644
@@ -54,6 +54,13 @@ choice
 	prompt "Select which UART will provide the debug UART"
 	depends on DEBUG_UART
 
+config DEBUG_UART_ALTERA_JTAGUART
+	bool "Altera JTAG UART"
+	help
+	  Select this to enable a debug UART using the altera_jtag_uart driver.
+	  You will need to provide parameters to make this work. The driver will
+	  be available until the real driver model serial is running.
+
 config DEBUG_UART_NS16550
 	bool "ns16550"
 	help
@@ -109,6 +116,25 @@ config DEBUG_UART_SHIFT
 	  value. Use this value to specify the shift to use, where 0=byte
 	  registers, 2=32-bit word registers, etc.
 
+config ALTERA_JTAG_UART
+	bool "Altera JTAG UART support"
+	depends on DM_SERIAL
+	help
+	  Select this to enable an JTAG UART for Altera devices.The JTAG UART
+	  core implements a method to communicate serial character streams
+	  between a host PC and a Qsys system on an Altera FPGA. Please find
+	  details on the "Embedded Peripherals IP User Guide" of Altera.
+
+config ALTERA_JTAG_UART_BYPASS
+	bool "Bypass output when no connection"
+	depends on ALTERA_JTAG_UART
+	help
+	  Bypass console output and keep going even if there is no JTAG
+	  terminal connection with the host. The console output will resume
+	  once the JTAG terminal is connected. Without the bypass, the console
+	  output will wait forever until a JTAG terminal is connected. If you
+	  not are sure, say Y.
+
 config ROCKCHIP_SERIAL
 	bool "Rockchip on-chip UART support"
 	depends on ARCH_UNIPHIER && DM_SERIAL
drivers/serial/altera_jtag_uart.c +111 -60

209 lines not on this page · raw message

include/configs/nios2-generic.h +0 -3
index 66ad2f0..bd6d45c 100644
@@ -23,14 +23,11 @@
 /*
  * SERIAL
  */
-#define CONFIG_ALTERA_JTAG_UART
 #if defined(CONFIG_ALTERA_JTAG_UART)
-# define CONFIG_SYS_NIOS_CONSOLE	CONFIG_SYS_JTAG_UART_BASE
 #else
 # define CONFIG_SYS_NIOS_CONSOLE	CONFIG_SYS_UART_BASE
 #endif
 
-#define CONFIG_ALTERA_JTAG_UART_BYPASS
 #define CONFIG_SYS_NIOS_FIXEDBAUD
 #define CONFIG_BAUDRATE		CONFIG_SYS_UART_BAUD
 #define CONFIG_SYS_BAUDRATE_TABLE	{CONFIG_BAUDRATE}
Signature · 1 line
2.1.4
#17 lore raw

PATCH v6 1/1 nios2: convert altera_jtag_uart to driver model

Quoted 27 lines · Thomas Chou

Convert altera_jtag_uart to driver model.

---
v2
add ioremap.
make the change to dts compatible with linux.

v3
use fdt address translation patch from Stefan Roese. fix watchdog and loop as Marek suggested.

v4
add clear AC flag to probe().
remove polling loops and watchdog reset because they are
done in the serial-uclass.c.

v5
fix coding style as Marek suggested to altera_uart.

v6
add early debug uart.
use chosen stdout-path to assign console.
fix coding style as Simon suggested.

Quoted 6 lines
  arch/nios2/dts/3c120_devboard.dts |   2 +
  configs/nios2-generic_defconfig   |   3 +
  drivers/serial/Kconfig            |  26 ++++++
  drivers/serial/altera_jtag_uart.c | 171 +++++++++++++++++++++++++-------------
  include/configs/nios2-generic.h   |   3 -
  5 files changed, 142 insertions(+), 63 deletions(-)

Applied to u-boot-nios.