1/* 2 * Copyright (c) 1999, 2000 3 * Intel Corporation. 4 * All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 13 * 2. Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in the 15 * documentation and/or other materials provided with the distribution. 16 * 17 * 3. All advertising materials mentioning features or use of this software 18 * must display the following acknowledgement: 19 * 20 * This product includes software developed by Intel Corporation and 21 * its contributors. 22 * 23 * 4. Neither the name of Intel Corporation or its contributors may be 24 * used to endorse or promote products derived from this software 25 * without specific prior written permission. 26 * 27 * THIS SOFTWARE IS PROVIDED BY INTEL CORPORATION AND CONTRIBUTORS ``AS IS'' 28 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 29 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 30 * ARE DISCLAIMED. IN NO EVENT SHALL INTEL CORPORATION OR CONTRIBUTORS BE 31 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 32 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 33 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 34 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 35 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 36 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 37 * THE POSSIBILITY OF SUCH DAMAGE. 38 * 39 */ 40 41 42#ifndef _EFIDBG_H_ 43#define _EFIDBG_H_ 44 45#include "eficontext.h" 46#include "efiser.h" 47 48typedef struct _DEBUGPORT_16550_CONFIG_DATA { 49 UINT32 PortAddress; 50 UINT64 BaudRate; 51 UINT32 ReceiveFifoDepth; 52 UINT32 Timeout; 53 UINT8 Parity; 54 UINT8 DataBits; 55 UINT8 StopBits; 56 UINT32 ControlMask; 57 BOOLEAN RtsCtsEnable; // RTS, CTS control 58} DEBUGPORT_16550_CONFIG_DATA; 59 60typedef struct _DEBUGPORT_16550_DEVICE_PATH { 61 EFI_DEVICE_PATH Header; 62 DEBUGPORT_16550_CONFIG_DATA ConfigData; 63} DEBUGPORT_16550_DEVICE_PATH; 64 65typedef union { 66 EFI_DEVICE_PATH DevPath; 67 DEBUGPORT_16550_DEVICE_PATH Uart; 68 // add new types of debugport device paths to this union... 69} DEBUGPORT_DEV_PATH; 70 71 72// 73// Debug Support protocol {2755590C-6F3C-42FA-9EA4-A3BA543CDA25} 74// 75 76#define DEBUG_SUPPORT_PROTOCOL \ 77{ 0x2755590C, 0x6F3C, 0x42fa, 0x9E, 0xA4, 0xA3, 0xBA, 0x54, 0x3C, 0xDA, 0x25 } 78 79 80typedef UINTN EXCEPTION_TYPE; 81 82typedef 83VOID 84(*EXCEPTION_HANDLER) ( 85 IN EXCEPTION_TYPE ExceptionType, 86 IN SYSTEM_CONTEXT *SystemContext 87 ); 88 89typedef 90EFI_STATUS 91(EFIAPI *EFI_REGISTER_TIMER_TICK_CALLBACK) ( 92 IN struct _EFI_DEBUG_SUPPORT_INTERFACE *This, 93 IN EXCEPTION_HANDLER TimerTickCallback 94 ); 95 96typedef 97EFI_STATUS 98(EFIAPI *EFI_REGISTER_EXCEPTION_HANDLER) ( 99 IN struct _EFI_DEBUG_SUPPORT_INTERFACE *This, 100 IN EXCEPTION_HANDLER ExceptionHandler, 101 IN EXCEPTION_TYPE ExceptionType 102 ); 103 104typedef 105EFI_STATUS 106(EFIAPI *EFI_IP_CALL_TRACE) ( 107 IN struct _EFI_DEBUG_SUPPORT_INTERFACE *This 108 ); 109 110 111#define EFI_DEBUG_SUPPORT_INTERFACE_REVISION 0x00010000 112 113typedef struct _EFI_DEBUG_SUPPORT_INTERFACE { 114 UINT32 Revision; 115 EFI_REGISTER_TIMER_TICK_CALLBACK RegisterTimerTickCallback; 116 EFI_REGISTER_EXCEPTION_HANDLER RegisterExceptionHandler; 117 EFI_IP_CALL_TRACE IpCallTrace; 118} EFI_DEBUG_SUPPORT_INTERFACE; 119 120 121// 122// Debugport io protocol {EBA4E8D2-3858-41EC-A281-2647BA9660D0} 123// 124 125#define DEBUGPORT_IO_PROTOCOL \ 126{ 0XEBA4E8D2, 0X3858, 0X41EC, 0XA2, 0X81, 0X26, 0X47, 0XBA, 0X96, 0X60, 0XD0 } 127 128 129typedef 130EFI_STATUS 131(EFIAPI *EFI_DEBUGPORT_IO_RESET) ( 132 IN struct _EFI_DEBUGPORT_IO_INTERFACE *This 133 ); 134 135typedef 136EFI_STATUS 137(EFIAPI *EFI_DEBUGPORT_IO_READ) ( 138 IN struct _EFI_DEBUGPORT_IO_INTERFACE *This, 139 IN OUT UINTN *BufferSize, 140 OUT VOID *Buffer 141 ); 142 143typedef 144EFI_STATUS 145(EFIAPI *EFI_DEBUGPORT_IO_WRITE) ( 146 IN struct _EFI_DEBUGPORT_IO_INTERFACE *This, 147 IN OUT UINTN *BufferSize, 148 IN VOID *Buffer 149 ); 150 151#define EFI_DEBUGPORT_IO_INTERFACE_REVISION 0x00010000 152 153typedef struct _EFI_DEBUGPORT_IO_INTERFACE { 154 UINT32 Revision; 155 EFI_DEBUGPORT_IO_READ Read; 156 EFI_DEBUGPORT_IO_WRITE Write; 157 EFI_DEBUGPORT_IO_RESET Reset; 158} EFI_DEBUGPORT_IO_INTERFACE; 159 160 161// 162// Debugport UART16550 control protocol {628EA978-4C26-4605-BC02-A42A496917DD} 163// 164 165#define DEBUGPORT_UART16550_CONTROL_PROTOCOL \ 166{ 0X628EA978, 0X4C26, 0X4605, 0XBC, 0X2, 0XA4, 0X2A, 0X49, 0X69, 0X17, 0XDD } 167 168// Note: The definitions for EFI_PARITY_TYPE, EFI_STOP_BITS_TYPE, and 169// SERIAL_IO_MODE are included from efiser.h 170 171typedef 172EFI_STATUS 173(EFIAPI *EFI_UART16550_SET_ATTRIBUTES) ( 174 IN struct _EFI_DEBUGPORT_UART16550_CONTROL_INTERFACE *This, 175 IN UINT64 BaudRate, 176 IN UINT32 ReceiveFifoDepth, 177 IN UINT32 Timeout, 178 IN EFI_PARITY_TYPE Parity, 179 IN UINT8 DataBits, 180 IN EFI_STOP_BITS_TYPE StopBits 181 ); 182 183typedef 184EFI_STATUS 185(EFIAPI *EFI_UART16550_SET_CONTROL_BITS) ( 186 IN struct _EFI_DEBUGPORT_UART16550_CONTROL_INTERFACE *This, 187 IN UINT32 Control 188 ); 189 190typedef 191EFI_STATUS 192(EFIAPI *EFI_UART16550_GET_CONTROL_BITS) ( 193 IN struct _EFI_DEBUGPORT_UART16550_CONTROL_INTERFACE *This, 194 OUT UINT32 *Control 195 ); 196 197#define EFI_DEBUGPORT_UART16550_CONTROL_INTERFACE_REVISION 0x00010000 198 199typedef struct _EFI_DEBUGPORT_UART16550_CONTROL_INTERFACE { 200 UINT32 Revision; 201 EFI_UART16550_SET_ATTRIBUTES SetAttributes; 202 EFI_UART16550_SET_CONTROL_BITS SetControl; 203 EFI_UART16550_GET_CONTROL_BITS GetControl; 204 DEBUGPORT_16550_CONFIG_DATA *Mode; 205} EFI_DEBUGPORT_UART16550_CONTROL_INTERFACE; 206 207 208#define DEVICE_PATH_DEBUGPORT DEBUGPORT_IO_PROTOCOL 209 210#endif /* _EFIDBG_H_ */ 211