projects / mirror_edk2.git / blame
| Commit | Line | Data |
|---|---|---|
| 18b144ea | 1 | ## @file SourceLevelDebugPkg.dec\r |
| 2 | #\r | |
| 3 | # This package provides target side modules to support source level debug.\r | |
| 4 | # The target side components includes the Debug Agent Library instance\r | |
| 5 | # to communicate with host side modules, Debug Communication Library and\r | |
| 6 | # instances to provide the communication I/O functions between Debug Agent\r | |
| 7 | # and host, PeCoffExtraActionLib instance to report symbol path information,\r | |
| 8 | # etc.\r | |
| 9 | #\r | |
| 4d92c224 | 10 | # Copyright (c) 2010 - 2014, Intel Corporation. All rights reserved.<BR>\r |
| 18b144ea | 11 | # This program and the accompanying materials are licensed and made available under \r |
| 12 | # the terms and conditions of the BSD License that accompanies this distribution. \r | |
| 13 | # The full text of the license may be found at\r | |
| 14 | # http://opensource.org/licenses/bsd-license.php. \r | |
| 15 | # \r | |
| 16 | # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r | |
| 17 | # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r | |
| 18 | #\r | |
| 19 | ##\r | |
| 20 | \r | |
| 21 | [Defines]\r | |
| 22 | DEC_SPECIFICATION = 0x00010005\r | |
| 894c9c6e | 23 | PACKAGE_NAME = SourceLevelDebugPkg\r |
| 865ef843 | 24 | PACKAGE_UNI_FILE = SourceLevelDebugPkg.uni\r |
| 18b144ea | 25 | PACKAGE_GUID = DBF00C27-D8D7-443d-918B-4E85CDA1373B\r |
| 4d92c224 | 26 | PACKAGE_VERSION = 0.86\r |
| 18b144ea | 27 | \r |
| 28 | [Includes]\r | |
| 29 | Include\r | |
| 30 | \r | |
| 31 | [Includes.IA32]\r | |
| 32 | Include/Ia32\r | |
| 33 | \r | |
| 34 | [Includes.X64]\r | |
| 35 | Include/Ia32\r | |
| 36 | \r | |
| 37 | [LibraryClasses]\r | |
| 38 | ## @libraryclass Provides communication I/O functions between Debug Agent and HOST.\r | |
| 39 | ##\r | |
| 40 | DebugCommunicationLib|Include/Library/DebugCommunicationLib.h\r | |
| 41 | \r | |
| 42 | [Guids]\r | |
| 43 | ## MdeModule package token space guid\r | |
| 44 | # Include/Guid/DebugAgentGuid.h\r | |
| 45 | gEfiDebugAgentGuid = {0x865a5a9b, 0xb85d, 0x474c, { 0x84, 0x55, 0x65, 0xd1, 0xbe, 0x84, 0x4b, 0xe2 }}\r | |
| 46 | gEfiSourceLevelDebugPkgTokenSpaceGuid = {0x865a5aab, 0xb85d, 0x474c, { 0x84, 0x55, 0x65, 0xd1, 0xbe, 0x84, 0x4b, 0xe2 }}\r | |
| 47 | \r | |
| 865ef843 LG |
48 | #\r |
| 49 | # [Error.gEfiSourceLevelDebugPkgTokenSpaceGuid]\r | |
| 50 | # 0x80000001 | Invalid value provided.\r | |
| 51 | #\r | |
| 52 | \r | |
| 18b144ea | 53 | [PcdsFixedAtBuild, PcdsPatchableInModule]\r |
| 54 | ## The memory BAR of usb debug port, it may be different with the memory bar of ehci host controller.\r | |
| 865ef843 LG |
55 | # Note that the memory BAR address is only used before Pci bus resource allocation.\r |
| 56 | # @Prompt Configure usb debug port memory BAR.\r | |
| 18b144ea | 57 | gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbDebugPortMemorySpaceBase|0xd0000000|UINT32|0x00000001\r |
| 58 | \r | |
| 59 | ## The memory BAR of ehci host controller, in which usb debug feature is enabled.\r | |
| 865ef843 LG |
60 | # Note that the memory BAR address is only used before Pci bus resource allocation.\r |
| 61 | # @Prompt Configure ehci host controller memory BAR.\r | |
| 18b144ea | 62 | gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbEhciMemorySpaceBase|0xd0000000|UINT32|0x00000002\r |
| 63 | \r | |
| 64 | ## The pci address of ehci host controller, in which usb debug feature is enabled.\r | |
| 865ef843 LG |
65 | # The format of pci address is :<BR>\r |
| 66 | # -----------------------------------------------------------------------<BR>\r | |
| 67 | # | Bits 28..31 | Bits 20..27 | Bits 15..19 | Bits 12..14 | Bits 00..11 |<BR>\r | |
| 68 | # -----------------------------------------------------------------------<BR>\r | |
| 69 | # | 0 | Bus | Device | Function | 0 |<BR>\r | |
| 70 | # -----------------------------------------------------------------------<BR>\r | |
| 71 | # For the value 0x000EF000, it means the pci address at bus 0x0, device 0x1D, function 0x7.\r | |
| 72 | # @Prompt Configure ehci host controller pci address.\r | |
| 73 | # @Expression 0x80000001 | (gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbEhciPciAddress & 0xF0000FFF) == 0\r | |
| 18b144ea | 74 | gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdUsbEhciPciAddress|0x000EF000|UINT32|0x00000003\r |
| 75 | \r | |
| 76 | ## The mask of exception numbers whose handlers would be ignored and cannot be replaced or \r | |
| 865ef843 LG |
77 | # hooked by Debug Agent Library. Masking INT1/INT3 is invalid.\r |
| 78 | # @Prompt Configure exception numbers not to be hooked by Debug Agent.\r | |
| 79 | # @Expression 0x80000001 | (gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdExceptionsIgnoredByDebugger & 0xA) == 0\r | |
| 18b144ea | 80 | gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdExceptionsIgnoredByDebugger|0x00000000|UINT32|0x00000004\r |
| 81 | \r | |
| 865ef843 LG |
82 | ## The method to issue break point to Debug Agent Library when Loading/UnLoading image.<BR><BR>\r |
| 83 | # 1: Use I/O Port 84 to issue hardware break point<BR>\r | |
| 84 | # 2: Use INT3 to issue software break point<BR>\r | |
| 85 | # @Prompt Configure Loading/UnLoading image break method.\r | |
| 86 | # @ValidRange 0x80000001 | 1 - 2\r | |
| 18b144ea | 87 | gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugLoadImageMethod|0x1|UINT8|0x00000005\r |
| b422b62c | 88 | \r |
| 865ef843 LG |
89 | ## The data buffer size used by debug port in debug communication library instances.\r |
| 90 | # Its value is not suggested to be changed in platform DSC file.\r | |
| 91 | # @Prompt Assign debug port buffer size.\r | |
| b422b62c | 92 | gEfiSourceLevelDebugPkgTokenSpaceGuid.PcdDebugPortHandleBufferSize|0x0|UINT16|0x00000006\r |
| 93 | \r | |
| 865ef843 LG |
94 | [UserExtensions.TianoCore."ExtraFiles"]\r |
| 95 | SourceLevelDebugPkgExtra.uni\r |