]>
Commit | Line | Data |
---|---|---|
1 | # | |
2 | # Copyright (c) 2011-2012, ARM Limited. All rights reserved. | |
3 | # | |
4 | # This program and the accompanying materials | |
5 | # are licensed and made available under the terms and conditions of the BSD License | |
6 | # which accompanies this distribution. The full text of the license may be found at | |
7 | # http://opensource.org/licenses/bsd-license.php | |
8 | # | |
9 | # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, | |
10 | # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. | |
11 | # | |
12 | ||
13 | import os | |
14 | ||
15 | import firmware_volume | |
16 | import build_report | |
17 | import system_table | |
18 | ||
19 | # Reload external classes | |
20 | reload(firmware_volume) | |
21 | reload(build_report) | |
22 | reload(system_table) | |
23 | ||
24 | def readMem32(executionContext, address): | |
25 | bytes = executionContext.getMemoryService().read(address, 4, 32) | |
26 | return struct.unpack('<I',bytes)[0] | |
27 | ||
28 | def dump_fv(ec, fv_base, fv_size): | |
29 | fv = firmware_volume.FirmwareVolume(ec, | |
30 | int(build.PCDs['gArmTokenSpaceGuid']['PcdFvBaseAddress'][0],16), | |
31 | int(build.PCDs['gArmTokenSpaceGuid']['PcdFvSize'][0],16)) | |
32 | ||
33 | ffs = fv.get_next_ffs() | |
34 | while ffs != None: | |
35 | print "# %s" % ffs | |
36 | ||
37 | section = ffs.get_next_section() | |
38 | while section != None: | |
39 | print "\t%s" % section | |
40 | try: | |
41 | print "\t\t- %s" % section.get_debug_filepath() | |
42 | except Exception: | |
43 | pass | |
44 | section = ffs.get_next_section(section) | |
45 | ||
46 | ffs = fv.get_next_ffs(ffs) | |
47 | ||
48 | def dump_system_table(ec, mem_base, mem_size): | |
49 | st = system_table.SystemTable(ec, mem_base, mem_size) | |
50 | ||
51 | debug_info_table_base = st.get_configuration_table(system_table.DebugInfoTable.CONST_DEBUG_INFO_TABLE_GUID) | |
52 | ||
53 | debug_info_table = system_table.DebugInfoTable(ec, debug_info_table_base) | |
54 | debug_info_table.dump() | |
55 | ||
56 | def load_symbol_from_file(ec, filename, address): | |
57 | try: | |
58 | ec.executeDSCommand("discard-symbol-file \'%s\'" % filename) | |
59 | except: | |
60 | pass | |
61 | ec.executeDSCommand("add-symbol-file \'%s\' 0x%X" % (filename, address)) | |
62 | ||
63 | class ArmPlatform: | |
64 | def __init__(self, sysmembase=None, sysmemsize=None, fvs={}): | |
65 | self.sysmembase = sysmembase | |
66 | self.sysmemsize = sysmemsize | |
67 | self.fvs = fvs | |
68 | ||
69 | class ArmPlatformDebugger: | |
70 | system_table = None | |
71 | firmware_volumes = {} | |
72 | ||
73 | REGION_TYPE_SYSMEM = 1 | |
74 | REGION_TYPE_ROM = 2 | |
75 | REGION_TYPE_FV = 3 | |
76 | ||
77 | def __init__(self, ec, report_log, regions): | |
78 | self.ec = ec | |
79 | fvs = [] | |
80 | sysmem_base = None | |
81 | sysmem_size = None | |
82 | ||
83 | if report_log and os.path.isfile(report_log): | |
84 | try: | |
85 | self.build = build_report.BuildReport(report_log) | |
86 | except IOError: | |
87 | raise IOError(2, 'Report \'%s\' isnot valid' % report_log) | |
88 | ||
89 | # Generate list of supported Firmware Volumes | |
90 | if self.build.PCDs['gArmTokenSpaceGuid'].has_key('PcdFvSize') and int(self.build.PCDs['gArmTokenSpaceGuid']['PcdFvSize'][0],16) != 0: | |
91 | fvs.append((int(self.build.PCDs['gArmTokenSpaceGuid']['PcdFvBaseAddress'][0],16),int(self.build.PCDs['gArmTokenSpaceGuid']['PcdFvSize'][0],16))) | |
92 | if self.build.PCDs['gArmTokenSpaceGuid'].has_key('PcdSecureFvSize') and int(self.build.PCDs['gArmTokenSpaceGuid']['PcdSecureFvSize'][0],16) != 0: | |
93 | fvs.append((int(self.build.PCDs['gArmTokenSpaceGuid']['PcdSecureFvBaseAddress'][0],16),int(self.build.PCDs['gArmTokenSpaceGuid']['PcdSecureFvSize'][0],16))) | |
94 | if self.build.PCDs['gArmTokenSpaceGuid'].has_key('PcdHypFvSize') and int(self.build.PCDs['gArmTokenSpaceGuid']['PcdHypFvSize'][0],16) != 0: | |
95 | fvs.append((int(self.build.PCDs['gArmTokenSpaceGuid']['PcdHypFvBaseAddress'][0],16),int(self.build.PCDs['gArmTokenSpaceGuid']['PcdHypFvSize'][0],16))) | |
96 | ||
97 | sysmem_base = int(self.build.PCDs['gArmTokenSpaceGuid']['PcdSystemMemoryBase'][0],16) | |
98 | sysmem_size = int(self.build.PCDs['gArmTokenSpaceGuid']['PcdSystemMemorySize'][0],16) | |
99 | else: | |
100 | for region in regions: | |
101 | if region[0] == ArmPlatformDebugger.REGION_TYPE_SYSMEM: | |
102 | sysmem_base = region[1] | |
103 | sysmem_size = region[2] | |
104 | elif region[0] == ArmPlatformDebugger.REGION_TYPE_FV: | |
105 | fvs.append((region[1],region[2])) | |
106 | elif region[0] == ArmPlatformDebugger.REGION_TYPE_ROM: | |
107 | for base in xrange(region[1], region[1] + region[2], 0x400000): | |
108 | signature = struct.unpack("cccc", self.ec.getMemoryService().read(base, 4, 32)) | |
109 | if signature == FirmwareVolume.CONST_FV_SIGNATURE: | |
110 | fvs.append((base,0)) | |
111 | else: | |
112 | print "Region type '%d' Not Supported" % region[0] | |
113 | ||
114 | self.platform = ArmPlatform(sysmem_base, sysmem_size, fvs) | |
115 | ||
116 | def in_sysmem(self, addr): | |
117 | return (self.platform.sysmembase is not None) and (self.platform.sysmembase <= addr) and (addr < self.platform.sysmembase + self.platform.sysmemsize) | |
118 | ||
119 | def in_fv(self, addr): | |
120 | return (self.get_fv_at(addr) != None) | |
121 | ||
122 | def get_fv_at(self, addr): | |
123 | for fv in self.platform.fvs: | |
124 | if (fv[0] <= addr) and (addr < fv[0] + fv[1]): | |
125 | return fv | |
126 | return None | |
127 | ||
128 | def load_current_symbols(self): | |
129 | pc = int(self.ec.getRegisterService().getValue('PC')) & 0xFFFFFFFF | |
130 | if self.in_fv(pc): | |
131 | debug_infos = [] | |
132 | ||
133 | (fv_base, fv_size) = self.get_fv_at(pc) | |
134 | ||
135 | if self.firmware_volumes.has_key(fv_base) == False: | |
136 | self.firmware_volumes[fv_base] = firmware_volume.FirmwareVolume(self.ec, fv_base, fv_size) | |
137 | ||
138 | stack_frame = self.ec.getTopLevelStackFrame() | |
139 | info = self.firmware_volumes[fv_base].load_symbols_at(int(stack_frame.getRegisterService().getValue('PC')) & 0xFFFFFFFF) | |
140 | debug_infos.append(info) | |
141 | while stack_frame.next() is not None: | |
142 | stack_frame = stack_frame.next() | |
143 | ||
144 | # Stack frame attached to 'PC' | |
145 | pc = int(stack_frame.getRegisterService().getValue('PC')) & 0xFFFFFFFF | |
146 | ||
147 | # Check if the symbols for this stack frame have already been loaded | |
148 | found = False | |
149 | for debug_info in debug_infos: | |
150 | if (pc >= debug_info[0]) and (pc < debug_info[0] + debug_info[1]): | |
151 | found = True | |
152 | if found == False: | |
153 | info = self.firmware_volumes[fv_base].load_symbols_at(pc) | |
154 | debug_infos.append(info) | |
155 | ||
156 | #self.firmware_volumes[fv_base].load_symbols_at(pc) | |
157 | elif self.in_sysmem(pc): | |
158 | debug_infos = [] | |
159 | ||
160 | if self.system_table is None: | |
161 | # Find the System Table | |
162 | self.system_table = system_table.SystemTable(self.ec, self.platform.sysmembase, self.platform.sysmemsize) | |
163 | ||
164 | # Find the Debug Info Table | |
165 | debug_info_table_base = self.system_table.get_configuration_table(system_table.DebugInfoTable.CONST_DEBUG_INFO_TABLE_GUID) | |
166 | self.debug_info_table = system_table.DebugInfoTable(self.ec, debug_info_table_base) | |
167 | ||
168 | stack_frame = self.ec.getTopLevelStackFrame() | |
169 | info = self.debug_info_table.load_symbols_at(int(stack_frame.getRegisterService().getValue('PC')) & 0xFFFFFFFF) | |
170 | debug_infos.append(info) | |
171 | while stack_frame.next() is not None: | |
172 | stack_frame = stack_frame.next() | |
173 | ||
174 | # Stack frame attached to 'PC' | |
175 | pc = int(stack_frame.getRegisterService().getValue('PC')) & 0xFFFFFFFF | |
176 | ||
177 | # Check if the symbols for this stack frame have already been loaded | |
178 | found = False | |
179 | for debug_info in debug_infos: | |
180 | if (pc >= debug_info[0]) and (pc < debug_info[0] + debug_info[1]): | |
181 | found = True | |
182 | if found == False: | |
183 | info = self.debug_info_table.load_symbols_at(pc) | |
184 | debug_infos.append(info) | |
185 | ||
186 | #self.debug_info_table.load_symbols_at(pc) | |
187 | else: | |
188 | raise Exception('ArmPlatformDebugger', "Not supported region") | |
189 | ||
190 | def load_all_symbols(self): | |
191 | # Load all the XIP symbols attached to the Firmware Volume | |
192 | for (fv_base, fv_size) in self.platform.fvs: | |
193 | if self.firmware_volumes.has_key(fv_base) == False: | |
194 | self.firmware_volumes[fv_base] = firmware_volume.FirmwareVolume(self.ec, fv_base, fv_size) | |
195 | self.firmware_volumes[fv_base].load_all_symbols() | |
196 | ||
197 | try: | |
198 | # Load all symbols of module loaded into System Memory | |
199 | if self.system_table is None: | |
200 | # Find the System Table | |
201 | self.system_table = system_table.SystemTable(self.ec, self.platform.sysmembase, self.platform.sysmemsize) | |
202 | ||
203 | ||
204 | # Find the Debug Info Table | |
205 | debug_info_table_base = self.system_table.get_configuration_table(system_table.DebugInfoTable.CONST_DEBUG_INFO_TABLE_GUID) | |
206 | self.debug_info_table = system_table.DebugInfoTable(self.ec, debug_info_table_base) | |
207 | ||
208 | self.debug_info_table.load_all_symbols() | |
209 | except: | |
210 | # Debugger exception could be excepted if DRAM has not been initialized or if we have not started to run from DRAM yet | |
211 | print "Note: no symbols have been found in System Memory (possible cause: the UEFI permanent memory has been installed yet)" | |
212 | pass |