serial: Add MMIO & SPCR support
v2 cover serial: Add MMIO & SPCR support
This series adds support for MMIO serial ports and auto-configuration via ACPI SPCR.
This is necessary for the serial port to work on AWS EC2 "metal" x86 systems.
An MMIO serial port can be specified explicitely using the "mmio," prefix for the --port argument to the 'serial' command, the register access size can also be specified via a suffix, and when 'serial' is used without arguments, it will try to use an ACPI SPCR entry (if any) to add the default port and configure it appropriately (speed, parity etc...)
This was tested using SPCR on an actual c5.metal instance, and using explicit instanciation via serial -p mmioXXXXXXXX on a modified qemu hacked to create MMIO PCI serial ports and to create a SPCR ACPI table.
The insipiration was an original implementation by Matthias Lange ! matthias.lange at kernkonzept.com However, the code was rewritten pretty much from scratch.
v2: This version (hopefully) addresses all the review commments and has been rebased on the latest master branch.
PATCH v2 1/8 acpi: Export a generic grub_acpi_find_table
And convert grub_acpi_find_fadt to use it
--- grub-core/kern/acpi.c | 43 +++++++++++++++++++++++++------------------ include/grub/acpi.h | 3 +++ 2 files changed, 28 insertions(+), 18 deletions(-)
grub-core/kern/acpi.c +25 -18
@@ -85,35 +85,42 @@ grub_acpi_xsdt_find_table (struct grub_acpi_table_header *xsdt, const char *sig)return 0 ; } -struct grub_acpi_fadt * -grub_acpi_find_fadt (void ) +void * +grub_acpi_find_table (const char *sig) { -struct grub_acpi_fadt *fadt =0 ; +struct grub_acpi_fadt *r =0 ;struct grub_acpi_rsdp_v10 *rsdpv1;struct grub_acpi_rsdp_v20 *rsdpv2; + rsdpv1 =grub_machine_acpi_get_rsdpv1 ();if (rsdpv1) - fadt =grub_acpi_rsdt_find_table ((struct grub_acpi_table_header *) - (grub_addr_t ) rsdpv1->rsdt_addr, -GRUB_ACPI_FADT_SIGNATURE ); -if (fadt) -return fadt; + r =grub_acpi_rsdt_find_table ((struct grub_acpi_table_header *) + (grub_addr_t ) rsdpv1->rsdt_addr, + sig); +if (r) +return r; rsdpv2 =grub_machine_acpi_get_rsdpv2 ();if (rsdpv2) - fadt =grub_acpi_rsdt_find_table ((struct grub_acpi_table_header *) - (grub_addr_t ) rsdpv2->rsdpv1.rsdt_addr, -GRUB_ACPI_FADT_SIGNATURE ); -if (fadt) -return fadt; + r =grub_acpi_rsdt_find_table ((struct grub_acpi_table_header *) + (grub_addr_t ) rsdpv2->rsdpv1.rsdt_addr, + sig); +if (r) +return r;if (rsdpv2 #if GRUB_CPU_SIZEOF_VOID_P != 8 && !(rsdpv2->xsdt_addr >>32 ) #endif ) - fadt =grub_acpi_xsdt_find_table ((struct grub_acpi_table_header *) - (grub_addr_t ) rsdpv2->xsdt_addr, -GRUB_ACPI_FADT_SIGNATURE ); -if (fadt) -return fadt; + r =grub_acpi_xsdt_find_table ((struct grub_acpi_table_header *) + (grub_addr_t ) rsdpv2->xsdt_addr, + sig); +if (r) +return r;return 0 ; } + +struct grub_acpi_fadt * +grub_acpi_find_fadt (void ) +{ +return grub_acpi_find_table (GRUB_ACPI_FADT_SIGNATURE ); +}
include/grub/acpi.h +3 -0
@@ -244,4 +244,7 @@ enumstruct grub_acpi_fadt *EXPORT_FUNC (grub_acpi_find_fadt ) (void ); +void * +EXPORT_FUNC (grub_acpi_find_table ) (const char *sig); +#endif /* ! GRUB_ACPI_HEADER */
Signature · 1 line
2.34.1
PATCH v2 2/8 acpi: Add SPCR and generic address definitions
In reply to Benjamin HerrenschmidtThis adds the definition of the two ACPI tables according to the spec.
--- include/grub/acpi.h | 51 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+)
include/grub/acpi.h +51 -0
@@ -179,6 +179,57 @@ enumGRUB_ACPI_MADT_ENTRY_SAPIC_FLAGS_ENABLED =1 }; +struct grub_acpi_genaddr { +grub_uint8_t space_id; +#define GRUB_ACPI_GENADDR_MEM_SPACE 0x00 +#define GRUB_ACPI_GENADDR_IO_SPACE 0x01 +grub_uint8_t bit_width; +grub_uint8_t bit_offset; +grub_uint8_t access_size; +#define GRUB_ACPI_GENADDR_SIZE_LGCY 0x00 +#define GRUB_ACPI_GENADDR_SIZE_BYTE 0x01 +#define GRUB_ACPI_GENADDR_SIZE_WORD 0x02 +#define GRUB_ACPI_GENADDR_SIZE_DWORD 0x03 +#define GRUB_ACPI_GENADDR_SIZE_QWORD 0x04 +grub_uint64_t addr; +}GRUB_PACKED ; + +#define GRUB_ACPI_SPCR_SIGNATURE "SPCR" + +struct grub_acpi_spcr { +struct grub_acpi_table_header hdr; +grub_uint8_t intf_type; +#define GRUB_ACPI_SPCR_INTF_TYPE_16550 0x00 +#define GRUB_ACPI_SPCR_INTF_TYPE_16550X 0x01 +grub_uint8_t reserved_0[3 ]; +struct grub_acpi_genaddr base_addr; +grub_uint8_t interrupt_type; +grub_uint8_t irq; +grub_uint32_t gsi; +grub_uint8_t baud_rate; +#define GRUB_ACPI_SPCR_BAUD_CURRENT 0x00 +#define GRUB_ACPI_SPCR_BAUD_9600 0x03 +#define GRUB_ACPI_SPCR_BAUD_19200 0x04 +#define GRUB_ACPI_SPCR_BAUD_57600 0x06 +#define GRUB_ACPI_SPCR_BAUD_115200 0x07 +grub_uint8_t parity; +grub_uint8_t stop_bits; +grub_uint8_t flow_control; +#define GRUB_ACPI_SPCR_FC_DCD_TX (1 << 0) +#define GRUB_ACPI_SPCR_FC_RTSCTS (1 << 1) +#define GRUB_ACPI_SPCR_FC_XONXOFF (1 << 2) +grub_uint8_t terminal_type; +grub_uint8_t language; +grub_uint16_t pci_device_id; +grub_uint16_t pci_vendor_id; +grub_uint8_t pci_bus; +grub_uint8_t pci_device; +grub_uint8_t pci_function; +grub_uint32_t pci_flags; +grub_uint8_t pci_segment; +grub_uint32_t reserved_1; +}GRUB_PACKED ; +#ifndef GRUB_DSDT_TEST struct grub_acpi_rsdp_v10 *grub_acpi_get_rsdpv1 (void );struct grub_acpi_rsdp_v20 *grub_acpi_get_rsdpv2 (void );
Signature · 1 line
2.34.1
PATCH v2 3/8 ns8250: Add base support for MMIO UARTs
In reply to Benjamin HerrenschmidtFrom: Benjamin Herrenschmidt <[email protected]>
This adds the ability for the driver to access UARTs via MMIO instead of PIO selectively at runtime, and exposes a new function to add an MMIO port.
In an ideal world, MMIO accessors would be generic and have architecture specific memory barriers. However, existing drivers don't have them and most of those "bare metal" drivers tend to be for x86 which doesn't need them. If necessary, those can be added later.
--- grub-core/term/ns8250.c | 80 ++++++++++++++++++++++++++++++++--------- grub-core/term/serial.c | 8 +++-- include/grub/serial.h | 11 +++++- 3 files changed, 80 insertions(+), 19 deletions(-)
grub-core/term/ns8250.c +64 -16
@@ -43,6 +43,24 @@ static int dead_ports = 0;#define DEFAULT_BASE_CLOCK 115200#endif +static grub_uint8_t +ns8250_reg_read (struct grub_serial_port *port,grub_addr_t reg) +{ + asmvolatile ("" : : :"memory" ); +if (port->mmio) +return *((volatile grub_uint8_t *) (port->mmio_base + reg)); +return grub_inb (port->port + reg); +} + +static void +ns8250_reg_write (struct grub_serial_port *port,grub_uint8_t ,grub_addr_t reg) +{ + asmvolatile ("" : : :"memory" ); +if (port->mmio) + *((volatile grub_uint8_t *) (port->mmio_base + reg)) = value; +else +grub_outb (value, port->port + reg); +}/* Convert speed to divisor. */ static unsigned short
@@ -93,43 +111,42 @@ do_real_config (struct grub_serial_port *port) divisor =serial_get_divisor (port, &port->config);/* Turn off the interrupt. */ -grub_outb (0 , port->port +UART_IER ); +ns8250_reg_write (port,0 ,UART_IER );/* Set DLAB. */ -grub_outb (UART_DLAB , port->port +UART_LCR ); +ns8250_reg_write (port,UART_DLAB ,UART_LCR ); -/* Set the baud rate. */ -grub_outb (divisor &0xFF , port->port +UART_DLL ); -grub_outb (divisor >>8 , port->port +UART_DLH ); +ns8250_reg_write (port, divisor &0xFF ,UART_DLL ); +ns8250_reg_write (port, divisor >>8 ,UART_DLH );/* Set the line status. */ status |= (parities[port->config.parity] | (port->config.word_len -5 ) | stop_bits[port->config.stop_bits]); -grub_outb (status, port->port +UART_LCR ); +ns8250_reg_write (port, status,UART_LCR );if (port->config.rtscts) {/* Enable the FIFO. */ -grub_outb (UART_ENABLE_FIFO_TRIGGER1 , port->port +UART_FCR ); +ns8250_reg_write (port,UART_ENABLE_FIFO_TRIGGER1 ,UART_FCR );/* Turn on DTR and RTS. */ -grub_outb (UART_ENABLE_DTRRTS , port->port +UART_MCR ); +ns8250_reg_write (port,UART_ENABLE_DTRRTS ,UART_MCR ); }else {/* Enable the FIFO. */ -grub_outb (UART_ENABLE_FIFO_TRIGGER14 , port->port +UART_FCR ); +ns8250_reg_write (port,UART_ENABLE_FIFO_TRIGGER14 ,UART_FCR );/* Turn on DTR, RTS, and OUT2. */ -grub_outb (UART_ENABLE_DTRRTS |UART_ENABLE_OUT2 , port->port +UART_MCR ); +ns8250_reg_write (port,UART_ENABLE_DTRRTS |UART_ENABLE_OUT2 ,UART_MCR ); }/* Drain the input buffer. */ endtime =grub_get_time_ms () +1000 ; -while (grub_inb (port->port +UART_LSR ) &UART_DATA_READY ) +while (ns8250_reg_read (port,UART_LSR ) &UART_DATA_READY ) { -grub_inb (port->port +UART_RX ); +ns8250_reg_read (port,UART_RX );if (grub_get_time_ms () > endtime) { port->broken =1 ;
@@ -145,8 +162,8 @@ static int serial_hw_fetch (struct grub_serial_port *port) {do_real_config (port); -if (grub_inb (port->port +UART_LSR ) &UART_DATA_READY ) -return grub_inb (port->port +UART_RX ); +if (ns8250_reg_read (port,UART_LSR ) &UART_DATA_READY ) +return ns8250_reg_read (port,UART_RX );return -1 ; }
@@ -166,7 +183,7 @@ serial_hw_put (struct grub_serial_port *port, const int c)else endtime =grub_get_time_ms () +200 ;/* Wait until the transmitter holding register is empty. */ -while ((grub_inb (port->port +UART_LSR ) &UART_EMPTY_TRANSMITTER ) ==0 ) +while ((ns8250_reg_read (port,UART_LSR ) &UART_EMPTY_TRANSMITTER ) ==0 ) {if (grub_get_time_ms () > endtime) {
@@ -179,7 +196,7 @@ serial_hw_put (struct grub_serial_port *port, const int c)if (port->broken) port->broken--; -grub_outb (c, port->port +UART_TX ); +ns8250_reg_write (port, c,UART_TX ); }/* Initialize a serial device. PORT is the port number for a serial device.
@@ -262,6 +279,7 @@ grub_ns8250_init (void) com_ports[i].name = com_names[i]; com_ports[i].driver = &grub_ns8250_driver; com_ports[i].port = serial_hw_io_addr[i]; + com_ports[i].mmio = false; err =grub_serial_config_defaults (&com_ports[i]);if (err)grub_print_error ();
@@ -289,6 +307,7 @@ grub_serial_ns8250_add_port (grub_port_t port) {struct grub_serial_port *p;unsigned i; +for (i =0 ; i <GRUB_SERIAL_PORT_NUM ; i++)if (com_ports[i].port == port) {
@@ -316,8 +335,37 @@ grub_serial_ns8250_add_port (grub_port_t port) } p->driver = &grub_ns8250_driver;grub_serial_config_defaults (p); + p->mmio = false; p->port = port;grub_serial_register (p);return p->name; } + +char * +grub_serial_ns8250_add_mmio (grub_addr_t addr) +{ +struct grub_serial_port *p; +unsigned i; + +for (i =0 ; i <GRUB_SERIAL_PORT_NUM ; i++) +if (com_ports[i].mmio && com_ports[i].mmio_base == addr) +return com_names[i]; + + p =grub_malloc (sizeof (*p)); +if (p ==NULL ) +return NULL ; + p->name =grub_xasprintf ("mmio,%llx" , (unsigned long long ) addr); +if (p->name ==NULL ) + { +grub_free (p); +return NULL ; + } + p->driver = &grub_ns8250_driver; +grub_serial_config_defaults (p); + p->mmio = true; + p->mmio_base = addr; +grub_serial_register (p); + +return p->name; +}
grub-core/term/serial.c +6 -2
@@ -201,8 +201,12 @@ grub_cmd_serial (grub_extcmd_context_t ctxt, int argc, char **args)if (state[OPTION_PORT ].set) { -grub_snprintf (pname,sizeof (pname),"port%lx" , -grub_strtoul (state[1 ].arg,0 ,0 )); +if (grub_memcmp (state[OPTION_PORT ].arg,"mmio" ,4 ) ==0 ) +grub_snprintf (pname,sizeof (pname),"%s" , state[1 ].arg); +else +grub_snprintf (pname,sizeof (pname),"port%lx" , +grub_strtoul (state[1 ].arg,0 ,0 )); + name = pname; }
include/grub/serial.h +10 -1
@@ -86,9 +86,17 @@ struct grub_serial_port*/ union { +struct + { +bool mmio; +union + {#if defined(__mips__) || defined (__i386__) || defined (__x86_64__) -grub_port_t port; +grub_port_t port;#endif +grub_addr_t mmio_base; + }; + };struct {grub_usb_device_t usbdev;
@@ -178,6 +186,7 @@ grub_serial_config_defaults (struct grub_serial_port *port)#if defined(__mips__) || defined (__i386__) || defined (__x86_64__)void grub_ns8250_init (void );char *grub_serial_ns8250_add_port (grub_port_t port); +char *grub_serial_ns8250_add_mmio (grub_addr_t addr);#endif #ifdef GRUB_MACHINE_IEEE1275 void grub_ofserial_init (void );
Signature · 1 line
2.34.1
PATCH v2 4/8 ns8250: Move base clock definition to a header
In reply to Benjamin HerrenschmidtAnd while at it, unify it as clock frequency in HZ, to match the value in "struct grub_serial_config" and do the division by 16 in one common place.
This will simplify adding SPCR support.
--- grub-core/term/ns8250.c | 15 ++++++++------- include/grub/ns8250.h | 13 +++++++++++++ 2 files changed, 21 insertions(+), 7 deletions(-)
grub-core/term/ns8250.c +8 -7
@@ -37,12 +37,6 @@ static const grub_port_t serial_hw_io_addr[] = GRUB_MACHINE_SERIAL_PORTS;static int dead_ports =0 ; -#ifdef GRUB_MACHINE_MIPS_LOONGSON -#define DEFAULT_BASE_CLOCK (2 * 115200) -#else -#define DEFAULT_BASE_CLOCK 115200 -#endif -static grub_uint8_t ns8250_reg_read (struct grub_serial_port *port,grub_addr_t reg) {
@@ -71,7 +65,14 @@ serial_get_divisor (const struct grub_serial_port *port __attribute__ ((unused))grub_uint32_t divisor;grub_uint32_t actual_speed, error; - base_clock = config->base_clock ? (config->base_clock >>4 ) :DEFAULT_BASE_CLOCK ; +/* Get the UART input clock frequency */ + base_clock = config->base_clock ? config->base_clock :UART_DEFAULT_BASE_CLOCK ; + +/* +* The UART uses 16 times oversampling for the BRG, so adjust the value +* accordingly to calculate the divisor. +*/ + base_clock >>=4 ; divisor = (base_clock + (config->speed /2 )) / config->speed;if (config->speed ==0 )
include/grub/ns8250.h +13 -0
@@ -70,6 +70,19 @@/* Turn on DTR, RTS, and OUT2. */ #define UART_ENABLE_OUT2 0x08 +/* +* Default clock input of the UART (feeds the baud rate generator) +* +* The standard value here is 1.8432 Mhz, which corresponds to +* 115200 bauds * 16 (16 times oversampling). +* +*/ +#ifdef GRUB_MACHINE_MIPS_LOONGSON +#define UART_DEFAULT_BASE_CLOCK ((2 * 115200) << 4) +#else +#define UART_DEFAULT_BASE_CLOCK (115200 << 4) +#endif +#ifndef ASM_FILE #include <grub/cpu/io.h>
Signature · 1 line
2.34.1
PATCH v2 5/8 ns8250: Add configuration parameter when adding ports
In reply to Benjamin HerrenschmidtFrom: Benjamin Herrenschmidt <[email protected]>
This will allow ports to be added with a pre-set configuration
--- grub-core/term/ns8250.c | 27 ++++++++++++++++++++------- grub-core/term/serial.c | 2 +- include/grub/serial.h | 4 ++-- 3 files changed, 23 insertions(+), 10 deletions(-)
grub-core/term/ns8250.c +20 -7
@@ -304,7 +304,7 @@ grub_ns8250_hw_get_port (const unsigned int unit) }char * -grub_serial_ns8250_add_port (grub_port_t port) +grub_serial_ns8250_add_port (grub_port_t port,struct grub_serial_config *config) {struct grub_serial_port *p;unsigned i;
@@ -314,6 +314,9 @@ grub_serial_ns8250_add_port (grub_port_t port) {if (dead_ports & (1 << i))return NULL ; +/* give the opportunity for SPCR to configure a default com port */ +if (config !=NULL ) +grub_serial_port_configure (&com_ports[i], config);return com_names[i]; }
@@ -326,32 +329,39 @@ grub_serial_ns8250_add_port (grub_port_t port)return NULL ; p =grub_malloc (sizeof (*p)); -if (!p) +if (p ==NULL )return NULL ; p->name =grub_xasprintf ("port%lx" , (unsigned long ) port); -if (!p->name) +if (p->name ==NULL ) {grub_free (p);return NULL ; } p->driver = &grub_ns8250_driver; -grub_serial_config_defaults (p); p->mmio = false; p->port = port; +if (config !=NULL ) +grub_serial_port_configure (p, config); +else +grub_serial_config_defaults (p);grub_serial_register (p);return p->name; }char * -grub_serial_ns8250_add_mmio (grub_addr_t addr) +grub_serial_ns8250_add_mmio (grub_addr_t addr,struct grub_serial_config *config) {struct grub_serial_port *p;unsigned i;for (i =0 ; i <GRUB_SERIAL_PORT_NUM ; i++)if (com_ports[i].mmio && com_ports[i].mmio_base == addr) -return com_names[i]; + { +if (config !=NULL ) +grub_serial_port_configure (&com_ports[i], config); +return com_names[i]; + } p =grub_malloc (sizeof (*p));if (p ==NULL )
@@ -363,9 +373,12 @@ grub_serial_ns8250_add_mmio (grub_addr_t addr)return NULL ; } p->driver = &grub_ns8250_driver; -grub_serial_config_defaults (p); p->mmio = true; p->mmio_base = addr; +if (config !=NULL ) +grub_serial_port_configure (p, config); +else +grub_serial_config_defaults (p);grub_serial_register (p);return p->name;
grub-core/term/serial.c +1 -1
@@ -156,7 +156,7 @@ grub_serial_find (const char *name) && grub_isxdigit (name [sizeof ("port") - 1])) { name =grub_serial_ns8250_add_port (grub_strtoul (&name[sizeof ("port" ) -1 ], -0 ,16 )); +0 ,16 ),NULL );if (!name)return NULL ;
include/grub/serial.h +2 -2
@@ -185,8 +185,8 @@ grub_serial_config_defaults (struct grub_serial_port *port)#if defined(__mips__) || defined (__i386__) || defined (__x86_64__)void grub_ns8250_init (void ); -char *grub_serial_ns8250_add_port (grub_port_t port); -char *grub_serial_ns8250_add_mmio (grub_addr_t addr); +char *grub_serial_ns8250_add_port (grub_port_t port,struct grub_serial_config *config); +char *grub_serial_ns8250_add_mmio (grub_addr_t addr,struct grub_serial_config *config);#endif #ifdef GRUB_MACHINE_IEEE1275 void grub_ofserial_init (void );
Signature · 1 line
2.34.1
PATCH v2 6/8 ns8250: Use ACPI SPCR table when available to configure serial
In reply to Benjamin HerrenschmidtFrom: Benjamin Herrenschmidt <[email protected]>
"serial auto" is now equivalent to just "serial" and will use the SPCR to discover the port if present, otherwise defaults to "com0" as before.
This allows to support MMIO ports specified by ACPI which is needed on AWS EC2 "metal" instances, and will enable GRUB to pickup the port configuration specified by ACPI in other cases.
--- docs/grub.texi | 9 ++++ grub-core/Makefile.core.def | 1 + grub-core/term/ns8250-spcr.c | 83 ++++++++++++++++++++++++++++++++++++ grub-core/term/serial.c | 21 ++++++--- include/grub/serial.h | 1 + 5 files changed, 110 insertions(+), 5 deletions(-) create mode 100644 grub-core/term/ns8250-spcr.c
docs/grub.texi +9 -0
@@ -2719,6 +2719,10 @@ you want to use COM2, you must specify @samp{--unit=1} instead. This command accepts many other options, so please refer to @ref{serial}, for more details. +Without argument or with @samp{--port=auto}, GRUB will attempt to use +ACPI when available to auto-detect the default serial port and its +configuration. + The commands @command{terminal_input} (@pxref{terminal_input}) and @command{terminal_output} (@pxref{terminal_output}) choose which type of terminal you want to use. In the case above, the terminal will be a
@@ -4172,6 +4176,11 @@ be in the range 5-8 and stop bits must be 1 or 2. Default is 8 data bits and one stop bit. @var{parity} is one of @samp{no}, @samp{odd}, @samp{even} and defaults to @samp{no}. +If passed no @var{unit} nor @var{port}, or if @var{port} is set to +@samp{auto} then GRUB will attempt to use ACPI to automatically detect +the system default serial port and its configuration. If this information +is not available, it will default to @var{unit} 0. + The serial port is not used as a communication channel unless the @command{terminal_input} or @command{terminal_output} command is used (@pxref{terminal_input}, @pxref{terminal_output}).
grub-core/Makefile.core.def +1 -0
@@ -2048,6 +2048,7 @@ module = { name = serial; common = term/serial.c; x86 = term/ns8250.c; + x86 = term/ns8250-spcr.c; ieee1275 = term/ieee1275/serial.c; mips_arc = term/arc/serial.c; efi = term/efi/serial.c;
grub-core/term/ns8250-spcr.c new file +83 -0
83 lines not on this page · raw message
grub-core/term/serial.c +16 -5
@@ -157,12 +157,23 @@ grub_serial_find (const char *name) { name =grub_serial_ns8250_add_port (grub_strtoul (&name[sizeof ("port" ) -1 ],0 ,16 ),NULL ); -if (!name) -return NULL ; +if (name ==NULL ) +return NULL ; FOR_SERIAL_PORTS (port) - if (grub_strcmp (port->name, name) == 0) - break; + if (grub_strcmp (port->name, name) == 0) + break; + } +if (!port &&grub_strcmp (name,"auto" ) ==0 ) + { +/* Look for an SPCR if any. If not, default to com0 */ + name =grub_ns8250_spcr_init (); +if (name ==NULL ) + name ="com0" ; + + FOR_SERIAL_PORTS (port) + if (grub_strcmp (port->name, name) == 0) + break; }#endif
@@ -214,7 +225,7 @@ grub_cmd_serial (grub_extcmd_context_t ctxt, int argc, char **args) name = args[0 ];if (!name) - name ="com0" ; + name ="auto" ; port =grub_serial_find (name);if (!port)
include/grub/serial.h +1 -0
@@ -185,6 +185,7 @@ grub_serial_config_defaults (struct grub_serial_port *port)#if defined(__mips__) || defined (__i386__) || defined (__x86_64__)void grub_ns8250_init (void ); +char *grub_ns8250_spcr_init (void );char *grub_serial_ns8250_add_port (grub_port_t port,struct grub_serial_config *config);char *grub_serial_ns8250_add_mmio (grub_addr_t addr,struct grub_serial_config *config);#endif
Signature · 1 line
2.34.1
PATCH v2 7/8 ns8250: Support more MMIO access sizes
In reply to Benjamin HerrenschmidtFrom: Benjamin Herrenschmidt <[email protected]>
It is common for PCI based UARTs to use larger than one byte access sizes. This adds support for this and uses the information present in SPCR accordingly.
--- grub-core/term/ns8250-spcr.c | 3 +- grub-core/term/ns8250.c | 67 ++++++++++++++++++++++++++++++------ include/grub/serial.h | 10 ++++-- 3 files changed, 67 insertions(+), 13 deletions(-)
grub-core/term/ns8250-spcr.c +2 -1
@@ -74,7 +74,8 @@ grub_ns8250_spcr_init (void)switch (spcr->base_addr.space_id) {case GRUB_ACPI_GENADDR_MEM_SPACE : -return grub_serial_ns8250_add_mmio (spcr->base_addr.addr, &config); +return grub_serial_ns8250_add_mmio (spcr->base_addr.addr, + spcr->base_addr.access_size, &config);case GRUB_ACPI_GENADDR_IO_SPACE :return grub_serial_ns8250_add_port (spcr->base_addr.addr, &config);default :
grub-core/term/ns8250.c +57 -10
110 lines not on this page · raw message
include/grub/serial.h +8 -2
@@ -94,7 +94,12 @@ struct grub_serial_port#if defined(__mips__) || defined (__i386__) || defined (__x86_64__)grub_port_t port;#endif -grub_addr_t mmio_base; +struct + { +grub_addr_t mmio_base; +/* Access size uses ACPI definition */ +grub_uint8_t access_size; + }; }; }; struct
@@ -187,7 +192,8 @@ grub_serial_config_defaults (struct grub_serial_port *port)void grub_ns8250_init (void );char *grub_ns8250_spcr_init (void );char *grub_serial_ns8250_add_port (grub_port_t port,struct grub_serial_config *config); -char *grub_serial_ns8250_add_mmio (grub_addr_t addr,struct grub_serial_config *config); +char *grub_serial_ns8250_add_mmio (grub_addr_t addr,unsigned int acc_size, +struct grub_serial_config *config);#endif #ifdef GRUB_MACHINE_IEEE1275 void grub_ofserial_init (void );
Signature · 1 line
2.34.1
PATCH v2 8/8 serial: Add ability to specify MMIO ports via 'serial'
In reply to Benjamin HerrenschmidtFrom: Benjamin Herrenschmidt <[email protected]>
This adds the ability to explicitely add an MMIO based serial port via the 'serial' command. The syntax is:
serial --port=mmio,<hex_address>{.b,.w,.l,.q}
--- docs/grub.texi | 26 ++++++++++++++++++-- grub-core/term/serial.c | 53 +++++++++++++++++++++++++++++++++++++---- 2 files changed, 72 insertions(+), 7 deletions(-)
docs/grub.texi +24 -2
@@ -4168,8 +4168,24 @@ Commands usable anywhere in the menu and in the command-line. @deffn Command serial [@option{--unit=unit}] [@option{--port=port}] [@option{--speed=speed}] [@option{--word=word}] [@option{--parity=parity}] [@option{--stop=stop}] Initialize a serial device. @var{unit} is a number in the range 0-3 specifying which serial port to use; default is 0, which corresponds to -the port often called COM1. @var{port} is the I/O port where the UART -is to be found; if specified it takes precedence over @var{unit}. +the port often called COM1. + +@var{port} is the I/O port where the UART is to be found or, if prefixed +with @samp{mmio,}, the MMIO address of the UART. If specified it takes +precedence over @var{unit}. + +Additionally, an MMIO address can be suffixed with: +@itemize @bullet +@item +@samp{.b} for bytes access (default) +@item +@samp{.w} for 16-bit word access +@item +@samp{.l} for 32-bit long word access or +@item +@samp{.q} for 64-bit long long word access +@end itemize + @var{speed} is the transmission speed; default is 9600. @var{word} and @var{stop} are the number of data bits and stop bits. Data bits must be in the range 5-8 and stop bits must be 1 or 2. Default is 8 data
@@ -4185,6 +4201,12 @@ The serial port is not used as a communication channel unless the @command{terminal_input} or @command{terminal_output} command is used (@pxref{terminal_input}, @pxref{terminal_output}). +Examples: +@example +serial --port=3f8 --speed=9600 +serial --port=mmio,fefb0000.l --speed=115200 +@end example + See also @ref{Serial terminal}. @end deffn
grub-core/term/serial.c +48 -5
78 lines not on this page · raw message
Signature · 1 line
2.34.1
Re: [PATCH v2 8/8] serial: Add ability to specify MMIO ports via 'serial'
Thank you for quick turn around!
Now patches looks much better but...
Quoted 62 lines · Benjamin Herrenschmidt
From: Benjamin Herrenschmidt <[email protected]>
This adds the ability to explicitely add an MMIO based serial port via the 'serial' command. The syntax is:
serial --port=mmio,<hex_address>{.b,.w,.l,.q}
Signed-off-by Benjamin Herrenschmidt <[email protected]>--- docs/grub.texi | 26 ++++++++++++++++++-- grub-core/term/serial.c | 53 +++++++++++++++++++++++++++++++++++++---- 2 files changed, 72 insertions(+), 7 deletions(-)docs/grub.texi +24
-2@@ -4168,8 +4168,24 @@ Commands usable anywhere in the menu and in the command-line. @deffn Command serial [@option{--unit=unit}] [@option{--port=port}] [@option{--speed=speed}] [@option{--word=word}] [@option{--parity=parity}] [@option{--stop=stop}] Initialize a serial device. @var{unit} is a number in the range 0-3 specifying which serial port to use; default is 0, which corresponds to -the port often called COM1. @var{port} is the I/O port where the UART -is to be found; if specified it takes precedence over @var{unit}. +the port often called COM1. + +@var{port} is the I/O port where the UART is to be found or, if prefixed +with @samp{mmio,}, the MMIO address of the UART. If specified it takes +precedence over @var{unit}. + +Additionally, an MMIO address can be suffixed with: +@itemize @bullet +@item +@samp{.b} for bytes access (default) +@item +@samp{.w} for 16-bit word access +@item +@samp{.l} for 32-bit long word access or +@item +@samp{.q} for 64-bit long long word access +@end itemize + @var{speed} is the transmission speed; default is 9600. @var{word} and @var{stop} are the number of data bits and stop bits. Data bits must be in the range 5-8 and stop bits must be 1 or 2. Default is 8 data@@ -4185,6 +4201,12 @@ The serial port is not used as a communication channel unless the @command{terminal_input} or @command{terminal_output} command is used (@pxref{terminal_input}, @pxref{terminal_output}). +Examples: +@example +serial --port=3f8 --speed=9600 +serial --port=mmio,fefb0000.l --speed=115200 +@end example + See also @ref{Serial terminal}. @end deffngrub-core/term/serial.c +0
-0
grub-core/term/serial.c grub_serial_find (const char *name) · line 155
Quoted 6 lines
grub-core/term/serial.c +1
-2@@ -152,8 +152,8 @@ grub_serial_find (const char *name)break ;#if (defined(__mips__) || defined (__i386__) || defined (__x86_64__)) && !defined(GRUB_MACHINE_EMU ) && !defined(GRUB_MACHINE_ARC ) -if (!port &&grub_memcmp (name,"port" ,sizeof ("port" ) -1 ) ==0 - &&grub_isxdigit (name [sizeof ("port" ) -1 ])) + if (!port && grub_strncmp (name, "port", grub_strlen ("port")) == 0
Maybe I was a bit imprecise but I was thinking about converting grub_memcmp() to grub_strncmp() in your patches/changes only. Sorry about that.
If you want still to do that I would prefer if you do this in separate patch. And please do not change "sizeof () - 1" to "grub_strlen ()".
In the worst case I am OK with a sentence in the commit message saying you change grub_memcmp() to grub_strncmp() on the occasion. Otherwise it is confusing to see such changes in the patch. Though separate patch is preferred way to do this...
And please replace grub_memcmp() with grub_strncmp() and 4 with 'sizeof ("mmio") - 1' in patch #3.
grub-core/term/serial.c grub_serial_find (const char *name) · line 170
Quoted 12 lines
grub-core/term/serial.c +5
-0+ && grub_isxdigit (name [grub_strlen ("port")])) { name =grub_serial_ns8250_add_port (grub_strtoul (&name[sizeof ("port" ) -1 ],0 ,16 ),NULL );@@ -164,6 +164,49 @@ grub_serial_find (const char *name)if (grub_strcmp (port->name, name) ==0 )break ; } +if (!port &&grub_strncmp (name,"mmio," ,grub_strlen ("mmio," )) ==0 + &&grub_isxdigit (name [grub_strlen ("mmio," )])) + { +const char *p1, *p = &name[grub_strlen ("mmio," )];
s/grub_strlen ("mmio,")/sizeof ("mmio,") - 1/
grub-core/term/serial.c grub_serial_find (const char *name) · line 176
Quoted 6 lines
grub-core/term/serial.c +6
-0+grub_addr_t addr =grub_strtoul (p, &p1,16 ); +unsigned int acc_size =1 ; +unsigned int nlen = p1 - p; + +/* Check address validity and general syntax */ +if (addr ==0 || (p1[0 ] !='\0' && p1[0 ] !='.' ))
This condition looks wrong. I think it should be
if (*p == '\0' || (*p1 != '.' && *p1 != '\0') || addr == 0)
I think the most important thing is lack of "*p == '\0'". Am I right? And I changed a logic a bit to make it more readable...
Additionally, maybe we should print an error here to give a hint to a user what is wrong. The grub_error(..., N_()) is your friend...
Quoted 37 lines
grub-core/term/serial.c +33
-0+return NULL ; +if (p1[0 ] =='.' ) +switch (p1[1 ]) + { +case 'w' : + acc_size =2 ; +break ; +case 'l' : + acc_size =3 ; +break ; +case 'q' : + acc_size =4 ; +break ; +case 'b' : + acc_size =1 ; +/* fallthrough */ +default : +/* +* Should we abort for an unknown size ? Let's just default +* to 1 byte, it would increase the chance that the user who +* did a typo can actually see the console. +*/ + acc_size =1 ; + } + name =grub_serial_ns8250_add_mmio (addr, acc_size,NULL ); +if (!name) +return NULL ; + +FOR_SERIAL_PORTS (port) + if (grub_strncmp (port->name, name, nlen) == 0) { +break ; + } + }if (!port &&grub_strcmp (name,"auto" ) ==0 ) {/* Look for an SPCR if any. If not, default to com0 */
grub-core/term/serial.c grub_serial_find (const char *name) · line 224
Quoted 5 lines
grub-core/term/serial.c +1
-1@@ -178,9 +221,9 @@ grub_serial_find (const char *name)#endif #ifdef GRUB_MACHINE_IEEE1275 -if (!port &&grub_memcmp (name,"ieee1275/" ,sizeof ("ieee1275/" ) -1 ) ==0 ) +if (!port &&grub_strncmp (name,"ieee1275/" ,grub_strlen ("ieee1275/" )) ==0 )
Ditto.
grub-core/term/serial.c grub_cmd_serial (grub_extcmd_context_t ctxt, int argc, char **args) · line 258
Quoted 12 lines
grub-core/term/serial.c +2
-2{ - name =grub_ofserial_add_port (&name[sizeof ("ieee1275/" ) -1 ]); + name =grub_ofserial_add_port (&name[grub_strlen ("ieee1275/" )]);if (!name)return NULL ;@@ -212,7 +255,7 @@ grub_cmd_serial (grub_extcmd_context_t ctxt, int argc, char **args)if (state[OPTION_PORT ].set) { -if (grub_memcmp (state[OPTION_PORT ].arg,"mmio" ,4 ) ==0 ) +if (grub_strncmp (state[OPTION_PORT ].arg,"mmio," ,grub_strlen ("mmio," )) ==0 )
Ditto.
And if you fix this please fix coding style in grub_le_to_cpu*()/grub_cpu_to_le*() calls in patch #7 too.
I hope I did not miss other issues this time...
Daniel
Re: [PATCH v2 8/8] serial: Add ability to specify MMIO ports via 'serial'
Quoted 3 lines · Daniel Kiper
Thank you for quick turn around!
Now patches looks much better but...
Hehe :-)
Quoted 9 lines
Quoted 5 lines
#if (
defined(__mips__)|| defined (__i386__) || defined (__x86_64__)) && !defined(GRUB_MACHINE_EMU) && !defined(GRUB_MACHINE_ARC) - if (!port &&grub_memcmp(name, "port", sizeof ("port") - 1) == 0
- &&grub_isxdigit(name [sizeof ("port") - 1]))
+ if (!port &&grub_strncmp(name, "port",grub_strlen("port")) == 0Maybe I was a bit imprecise but I was thinking about converting
grub_memcmp()togrub_strncmp()in your patches/changes only. Sorry about that.
Ok, that's fine, I wasn't sure what you wanted, it's easy enough for me to respin and re-test.
Quoted 2 lines
If you want still to do that I would prefer if you do this in separate patch. And please do not change "sizeof () - 1" to "
grub_strlen()".
I'll do a separate patch. I don't like sizeof () - 1 but it's indeed more efficient at this point because grub_strlen() doesn't exploit gcc's __builtin_strlen() (which would evaluate to a constant). So I'll put them back in for now, but we should look at using more gcc builtin's imho down the line.
Quoted 4 lines
In the worst case I am OK with a sentence in the commit message saying you change
grub_memcmp()togrub_strncmp()on the occasion. Otherwise it is confusing to see such changes in the patch. Though separate patch is preferred way to do this...
Nah, I'll do a separate patch. I'll put it in the same series though.
Quoted 2 lines
And please replace
grub_memcmp()withgrub_strncmp()and 4 with 'sizeof ("mmio") - 1' in patch #3.
Ah I missed that one, thanks.
Quoted 15 lines
grub-core/term/serial.c grub_serial_find (const char *name) · line 170
Quoted 13 lines
+ &&
grub_isxdigit(name [grub_strlen("port")]))
{
name =grub_serial_ns8250_add_port(grub_strtoul(&name[sizeof ("port") - 1], 0, 16), NULL);grub-core/term/serial.c +4
-0@@ -164,6 +164,49 @@ grub_serial_find (const char *name) if (grub_strcmp (port->name, name) == 0) break; } + if (!port && grub_strncmp (name, "mmio,", grub_strlen ("mmio,")) == 0 + && grub_isxdigit (name [grub_strlen ("mmio,")])) + { + const char *p1, *p = &name[grub_strlen ("mmio,")];s/grub_strlen ("mmio,")/sizeof ("mmio,") - 1/
Ack.
Quoted 7 lines
grub-core/term/serial.c grub_serial_find (const char *name) · line 176
Quoted 6 lines
grub-core/term/serial.c +6
-0+ grub_addr_t addr = grub_strtoul (p, &p1, 16); + unsigned int acc_size = 1; + unsigned int nlen = p1 - p; + + /* Check address validity and general syntax */ + if (addr == 0 || (p1[0] != '\0' && p1[0] != '.'))
Quoted 6 lines
This condition looks wrong. I think it should be
if (*p == '\0' || (*p1 != '.' && *p1 != '\0') || addr == 0)
I think the most important thing is lack of "*p == '\0'". Am I right? And I changed a logic a bit to make it more readable...
if *p is '\0' then addr is 0 (and *p1 is '\0'). But we wouldn't get there in the first place because of the grub_isxdigit() in the previous test. So we know *p is a digit at this point. In fact I don't even need to test addr == 0, there could be universes where it's a valid MMIO address :-) (not kidding, I've seen it, though nowhere we run grub these days).
So the only thing we really care about at this point is the first non- digit character which is *p1. It's either a dot or a '\0' for things to be valild.
Quoted 2 lines
Additionally, maybe we should print an error here to give a hint to a user what is wrong. The
grub_error(..., N_())is your friend...
Right, it would go to whatever console is still active at this point (probably BIOS console) which is probably not going to be terribly useful for people who are tyring to use a serial port (for a reason .. :-) but it won't hurt either.
Quoted 39 lines
Quoted 39 lines
grub-core/term/serial.c +33
-0+ return NULL; + if (p1[0] == '.') + switch(p1[1]) + { + case 'w': + acc_size = 2; + break; + case 'l': + acc_size = 3; + break; + case 'q': + acc_size = 4; + break; + case 'b': + acc_size = 1; + /* fallthrough */ + default: + /* + * Should we abort for an unknown size ? Let's just default + * to 1 byte, it would increase the chance that the user who + * did a typo can actually see the console. + */ + acc_size = 1; + } + name = grub_serial_ns8250_add_mmio (addr, acc_size, NULL); + if (!name) + return NULL; + + FOR_SERIAL_PORTS (port) + if (grub_strncmp (port->name, name, nlen) == 0) { + break; + } + } if (!port && grub_strcmp (name, "auto") == 0) { /* Look for an SPCR if any. If not, default to com0 */@@ -178,9 +221,9 @@ grub_serial_find (const char *name) #endif
Quoted 5 lines
grub-core/term/serial.c grub_serial_find (const char *name) · line 224
Quoted 3 lines
grub-core/term/serial.c +1
-1#ifdef GRUB_MACHINE_IEEE1275 - if (!port && grub_memcmp (name, "ieee1275/", sizeof ("ieee1275/") - 1) == 0) + if (!port && grub_strncmp (name, "ieee1275/", grub_strlen ("ieee1275/")) == 0)Ditto.
Ack. I'll move the memcmp/strcmp change to a separate patch and leave the sizeof alone
Quoted 15 lines
grub-core/term/serial.c grub_cmd_serial (grub_extcmd_context_t ctxt, int argc, char **args) · line 258
Quoted 12 lines
grub-core/term/serial.c +2
-2{ - name = grub_ofserial_add_port (&name[sizeof ("ieee1275/") - 1]); + name = grub_ofserial_add_port (&name[grub_strlen ("ieee1275/")]); if (!name) return NULL;@@ -212,7 +255,7 @@ grub_cmd_serial (grub_extcmd_context_t ctxt, int argc, char **args) if (state[OPTION_PORT].set) { - if (grub_memcmp (state[OPTION_PORT].arg, "mmio", 4) == 0) + if (grub_strncmp (state[OPTION_PORT].arg, "mmio,", grub_strlen ("mmio,")) == 0)Ditto.
Quoted 2 lines
And if you fix this please fix coding style in grub_le_to_cpu*()/grub_cpu_to_le*() calls in patch #7 too.
Oops :-)
Quoted 1 line
I hope I did not miss other issues this time...
No worries, I don't mind respinning. At least there is movement now :-)
I'll have new patches later today hopefully.
Cheers,
Ben.