1 /** @file
2   ACPI Serial Port Console Redirection Table as defined by Microsoft in
3   http://www.microsoft.com/whdc/system/platform/server/spcr.mspx
4 
5   Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>
6   (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>
7   Copyright (c) 2014 - 2016, ARM Limited. All rights reserved.<BR>
8   SPDX-License-Identifier: BSD-2-Clause-Patent
9 **/
10 
11 #ifndef _SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_H_
12 #define _SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_H_
13 
14 
15 #include <IndustryStandard/Acpi.h>
16 
17 //
18 // Ensure proper structure formats
19 //
20 #pragma pack(1)
21 
22 ///
23 /// SPCR Revision (defined in spec)
24 ///
25 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_REVISION 0x02
26 
27 ///
28 /// Serial Port Console Redirection Table Format
29 ///
30 typedef struct {
31   EFI_ACPI_DESCRIPTION_HEADER             Header;
32   UINT8                                   InterfaceType;
33   UINT8                                   Reserved1[3];
34   EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  BaseAddress;
35   UINT8                                   InterruptType;
36   UINT8                                   Irq;
37   UINT32                                  GlobalSystemInterrupt;
38   UINT8                                   BaudRate;
39   UINT8                                   Parity;
40   UINT8                                   StopBits;
41   UINT8                                   FlowControl;
42   UINT8                                   TerminalType;
43   UINT8                                   Reserved2;
44   UINT16                                  PciDeviceId;
45   UINT16                                  PciVendorId;
46   UINT8                                   PciBusNumber;
47   UINT8                                   PciDeviceNumber;
48   UINT8                                   PciFunctionNumber;
49   UINT32                                  PciFlags;
50   UINT8                                   PciSegment;
51   UINT32                                  Reserved3;
52 } EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE;
53 
54 #pragma pack()
55 
56 //
57 // SPCR Definitions
58 //
59 
60 //
61 // Interface Type
62 //
63 
64 ///
65 /// Full 16550 interface
66 ///
67 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERFACE_TYPE_16550                     0
68 ///
69 /// Full 16450 interface
70 ///
71 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERFACE_TYPE_16450                     1
72 
73 
74 //
75 // The Serial Port Subtypes for ARM are documented in Table 3 of the DBG2 Specification
76 //
77 
78 ///
79 /// ARM PL011 UART
80 ///
81 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERFACE_TYPE_ARM_PL011_UART            0x03
82 
83 ///
84 /// ARM SBSA Generic UART (2.x) supporting 32-bit only accesses [deprecated]
85 ///
86 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERFACE_TYPE_ARM_SBSA_GENERIC_UART_2X  0x0d
87 
88 ///
89 /// ARM SBSA Generic UART
90 ///
91 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERFACE_TYPE_ARM_SBSA_GENERIC_UART     0x0e
92 
93 //
94 // Interrupt Type
95 //
96 
97 ///
98 /// PC-AT-compatible dual-8259 IRQ interrupt
99 ///
100 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERRUPT_TYPE_8259    0x1
101 ///
102 /// I/O APIC interrupt (Global System Interrupt)
103 ///
104 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERRUPT_TYPE_APIC    0x2
105 ///
106 /// I/O SAPIC interrupt (Global System Interrupt)
107 ///
108 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERRUPT_TYPE_SAPIC   0x4
109 ///
110 /// ARMH GIC interrupt (Global System Interrupt)
111 ///
112 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_INTERRUPT_TYPE_GIC     0x8
113 
114 //
115 // Baud Rate
116 //
117 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_BAUD_RATE_9600         3
118 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_BAUD_RATE_19200        4
119 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_BAUD_RATE_57600        6
120 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_BAUD_RATE_115200       7
121 
122 //
123 // Parity
124 //
125 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_PARITY_NO_PARITY       0
126 
127 //
128 // Stop Bits
129 //
130 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_STOP_BITS_1            1
131 
132 //
133 // Flow Control
134 //
135 
136 ///
137 /// DCD required for transmit
138 ///
139 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_FLOW_CONTROL_DCD       0x1
140 ///
141 /// RTS/CTS hardware flow control
142 ///
143 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_FLOW_CONTROL_RTS_CTS   0x2
144 ///
145 ///  XON/XOFF software control
146 ///
147 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_FLOW_CONTROL_XON_XOFF  0x4
148 
149 //
150 // Terminal Type
151 //
152 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_TERMINAL_TYPE_VT100      0
153 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_TERMINAL_TYPE_VT100_PLUS 1
154 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_TERMINAL_TYPE_VT_UTF8    2
155 #define EFI_ACPI_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_TERMINAL_TYPE_ANSI       3
156 
157 #endif
158