]>
Commit | Line | Data |
---|---|---|
18b144ea | 1 | /** @file\r |
2 | Commond Debug Agent library implementition. It mainly includes\r | |
3 | the first C function called by exception/interrupt handlers,\r | |
4 | read/write debug packet to communication with HOST based on transfer\r | |
5 | protocol.\r | |
6 | \r | |
7 | Copyright (c) 2010, Intel Corporation. All rights reserved.<BR>\r | |
8 | This program and the accompanying materials\r | |
9 | are licensed and made available under the terms and conditions of the BSD License\r | |
10 | which accompanies this distribution. The full text of the license may be found at\r | |
11 | http://opensource.org/licenses/bsd-license.php.\r | |
12 | \r | |
13 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r | |
14 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r | |
15 | \r | |
16 | **/\r | |
17 | \r | |
18 | #include "DebugAgent.h"\r | |
19 | #include "Ia32/DebugException.h"\r | |
20 | \r | |
21 | /**\r | |
22 | Check if HOST is connected based on Mailbox.\r | |
23 | \r | |
24 | @retval TRUE HOST is connected.\r | |
25 | @retval FALSE HOST is not connected.\r | |
26 | \r | |
27 | **/\r | |
28 | BOOLEAN\r | |
29 | IsHostConnected (\r | |
30 | VOID\r | |
31 | )\r | |
32 | {\r | |
33 | DEBUG_AGENT_MAILBOX *Mailbox;\r | |
34 | \r | |
35 | Mailbox = GetMailboxPointer ();\r | |
36 | \r | |
37 | if (Mailbox->DebugFlag.Bits.HostPresent == 1) {\r | |
38 | return TRUE;\r | |
39 | } else {\r | |
40 | return FALSE;\r | |
41 | }\r | |
42 | }\r | |
43 | \r | |
44 | /**\r | |
45 | Set HOST connect flag in Mailbox.\r | |
46 | \r | |
47 | **/\r | |
48 | VOID\r | |
49 | SetHostConnectedFlag (\r | |
50 | VOID\r | |
51 | )\r | |
52 | {\r | |
53 | DEBUG_AGENT_MAILBOX *Mailbox;\r | |
54 | \r | |
55 | Mailbox = GetMailboxPointer ();\r | |
56 | \r | |
57 | Mailbox->DebugFlag.Bits.HostPresent = 1;\r | |
58 | }\r | |
59 | \r | |
60 | /**\r | |
61 | Set debug flag of Debug Agent in Mailbox.\r | |
62 | \r | |
63 | @param DebugFlag Debug Flag defined by transfer protocol.\r | |
64 | \r | |
65 | **/\r | |
66 | VOID\r | |
67 | SetDebugFlag (\r | |
68 | IN UINT32 DebugFlag\r | |
69 | )\r | |
70 | {\r | |
71 | DEBUG_AGENT_MAILBOX *Mailbox;\r | |
72 | \r | |
73 | Mailbox = GetMailboxPointer ();\r | |
74 | \r | |
75 | if ((DebugFlag & SOFT_DEBUGGER_SETTING_SMM_ENTRY_BREAK) != 0) {\r | |
76 | Mailbox->DebugFlag.Bits.BreakOnNextSmi = 1;\r | |
77 | } else {\r | |
78 | Mailbox->DebugFlag.Bits.BreakOnNextSmi = 0;\r | |
79 | }\r | |
80 | }\r | |
81 | \r | |
82 | /**\r | |
83 | Exectue GO command.\r | |
84 | \r | |
85 | @param[in] CpuContext Pointer to saved CPU context.\r | |
86 | \r | |
87 | **/\r | |
88 | VOID\r | |
89 | CommandGo (\r | |
90 | IN DEBUG_CPU_CONTEXT *CpuContext\r | |
91 | )\r | |
92 | {\r | |
93 | IA32_EFLAGS32 *Eflags;\r | |
94 | \r | |
95 | Eflags = (IA32_EFLAGS32 *) &CpuContext->Eflags;\r | |
96 | Eflags->Bits.TF = 0;\r | |
97 | Eflags->Bits.RF = 1;\r | |
98 | }\r | |
99 | \r | |
100 | /**\r | |
101 | Exectue Stepping command.\r | |
102 | \r | |
103 | @param[in] CpuContext Pointer to saved CPU context.\r | |
104 | \r | |
105 | **/\r | |
106 | VOID\r | |
107 | CommandStepping (\r | |
108 | IN DEBUG_CPU_CONTEXT *CpuContext\r | |
109 | )\r | |
110 | {\r | |
111 | IA32_EFLAGS32 *Eflags;\r | |
112 | \r | |
113 | Eflags = (IA32_EFLAGS32 *) &CpuContext->Eflags;\r | |
114 | Eflags->Bits.TF = 1;\r | |
115 | Eflags->Bits.RF = 1;\r | |
116 | }\r | |
117 | \r | |
118 | /**\r | |
119 | Set debug register for hardware breakpoint.\r | |
120 | \r | |
121 | @param[in] CpuContext Pointer to saved CPU context.\r | |
122 | @param[in] SetHwBreakpoint Hardware breakpoint to be set.\r | |
123 | \r | |
124 | **/\r | |
125 | VOID\r | |
126 | SetDebugRegister (\r | |
127 | IN DEBUG_CPU_CONTEXT *CpuContext,\r | |
128 | IN DEBUG_DATA_SET_HW_BREAKPOINT *SetHwBreakpoint\r | |
129 | )\r | |
130 | {\r | |
131 | UINT8 RegisterIndex;\r | |
132 | UINTN Dr7Value;\r | |
133 | \r | |
134 | RegisterIndex = SetHwBreakpoint->Type.Index;\r | |
135 | \r | |
136 | //\r | |
137 | // Set debug address\r | |
138 | //\r | |
139 | * ((UINTN *) &CpuContext->Dr0 + RegisterIndex) = (UINTN) SetHwBreakpoint->Address;\r | |
140 | \r | |
141 | Dr7Value = CpuContext->Dr7;\r | |
142 | \r | |
143 | //\r | |
144 | // Enable Gx, Lx\r | |
145 | //\r | |
146 | Dr7Value |= 0x3 << (RegisterIndex * 2);\r | |
147 | //\r | |
148 | // Set RWx and Lenx\r | |
149 | //\r | |
150 | Dr7Value &= ~(0xf0000 << (RegisterIndex * 4));\r | |
151 | Dr7Value |= (SetHwBreakpoint->Type.Length | SetHwBreakpoint->Type.Access) << (RegisterIndex * 4);\r | |
152 | //\r | |
153 | // Enable GE, LE\r | |
154 | //\r | |
155 | Dr7Value |= 0x300;\r | |
156 | \r | |
157 | CpuContext->Dr7 = Dr7Value;\r | |
158 | }\r | |
159 | \r | |
160 | /**\r | |
161 | Clear debug register for hardware breakpoint.\r | |
162 | \r | |
163 | @param[in] CpuContext Pointer to saved CPU context.\r | |
164 | @param[in] ClearHwBreakpoint Hardware breakpoint to be cleared.\r | |
165 | \r | |
166 | **/\r | |
167 | VOID\r | |
168 | ClearDebugRegister (\r | |
169 | IN DEBUG_CPU_CONTEXT *CpuContext,\r | |
170 | IN DEBUG_DATA_CLEAR_HW_BREAKPOINT *ClearHwBreakpoint\r | |
171 | )\r | |
172 | {\r | |
173 | if ((ClearHwBreakpoint->IndexMask & BIT0) != 0) {\r | |
174 | CpuContext->Dr0 = 0;\r | |
175 | CpuContext->Dr7 &= ~(0x3 << 0);\r | |
176 | }\r | |
177 | if ((ClearHwBreakpoint->IndexMask & BIT1) != 0) {\r | |
178 | CpuContext->Dr1 = 0;\r | |
179 | CpuContext->Dr7 &= ~(0x3 << 2);\r | |
180 | }\r | |
181 | if ((ClearHwBreakpoint->IndexMask & BIT2) != 0) {\r | |
182 | CpuContext->Dr2 = 0;\r | |
183 | CpuContext->Dr7 &= ~(0x3 << 4);\r | |
184 | }\r | |
185 | if ((ClearHwBreakpoint->IndexMask & BIT3) != 0) {\r | |
186 | CpuContext->Dr3 = 0;\r | |
187 | CpuContext->Dr7 &= ~(0x3 << 6);\r | |
188 | }\r | |
189 | }\r | |
190 | \r | |
191 | /**\r | |
192 | Send acknowledge packet to HOST.\r | |
193 | \r | |
194 | @param[in] AckCommand Type of Acknowledge packet.\r | |
195 | \r | |
196 | **/\r | |
197 | VOID\r | |
198 | SendAckPacket (\r | |
199 | IN UINT8 AckCommand\r | |
200 | )\r | |
201 | {\r | |
202 | DEBUG_COMMAND_HEADER DebugCommonHeader;\r | |
203 | DEBUG_PORT_HANDLE Handle;\r | |
204 | \r | |
205 | Handle = GetDebugPortHandle();\r | |
206 | \r | |
207 | DebugCommonHeader.StartSymbol = DEBUG_STARTING_SYMBOL_NORMAL;\r | |
208 | DebugCommonHeader.Command = AckCommand;\r | |
209 | DebugCommonHeader.DataLength = 0;\r | |
210 | \r | |
211 | DebugPortWriteBuffer (Handle, (UINT8 *) &DebugCommonHeader, sizeof (DEBUG_COMMAND_HEADER));\r | |
212 | }\r | |
213 | \r | |
214 | /**\r | |
215 | Receive acknowledge packet from HOST in specified time.\r | |
216 | \r | |
217 | @param[out] Ack Returned acknowlege type from HOST.\r | |
218 | @param[in] Timeout Time out value to wait for acknowlege from HOST.\r | |
219 | The unit is microsecond.\r | |
220 | @param[out] BreakReceived If BreakReceived is not NULL,\r | |
221 | TRUE is retured if break-in symbol received.\r | |
222 | FALSE is retured if break-in symbol not received.\r | |
223 | \r | |
224 | @retval RETRUEN_SUCCESS Succeed to receive acknowlege packet from HOST,\r | |
225 | the type of acknowlege packet saved in Ack.\r | |
226 | @retval RETURN_TIMEOUT Specified timeout value was up.\r | |
227 | \r | |
228 | **/\r | |
229 | RETURN_STATUS\r | |
230 | ReceiveAckPacket (\r | |
231 | OUT UINT8 *Ack,\r | |
232 | IN UINTN Timeout,\r | |
233 | OUT BOOLEAN *BreakReceived OPTIONAL\r | |
234 | )\r | |
235 | {\r | |
236 | DEBUG_COMMAND_HEADER DebugCommonHeader;\r | |
237 | DEBUG_PORT_HANDLE Handle;\r | |
238 | \r | |
239 | Handle = GetDebugPortHandle();\r | |
240 | \r | |
241 | while (TRUE) {\r | |
242 | if (DebugPortReadBuffer (Handle, (UINT8 *) &DebugCommonHeader.StartSymbol, 1, Timeout) == 0) {\r | |
243 | return RETURN_TIMEOUT;\r | |
244 | }\r | |
245 | if (DebugCommonHeader.StartSymbol == DEBUG_STARTING_SYMBOL_BREAK) {\r | |
246 | if (BreakReceived != NULL) {\r | |
247 | SendAckPacket (DEBUG_COMMAND_HALT_DEFERRED);\r | |
248 | *BreakReceived = TRUE;\r | |
249 | }\r | |
250 | }\r | |
251 | if (DebugCommonHeader.StartSymbol == DEBUG_STARTING_SYMBOL_NORMAL) {\r | |
252 | break;\r | |
253 | }\r | |
254 | }\r | |
255 | if (DebugPortReadBuffer (Handle, (UINT8 *)&DebugCommonHeader.Command, sizeof (DEBUG_COMMAND_HEADER) - 1, Timeout) == 0) {\r | |
256 | return RETURN_TIMEOUT;\r | |
257 | }\r | |
258 | \r | |
259 | *Ack = DebugCommonHeader.Command;\r | |
260 | return RETURN_SUCCESS;\r | |
261 | }\r | |
262 | \r | |
263 | /**\r | |
264 | Receive acknowledge packet OK from HOST in specified time.\r | |
265 | \r | |
266 | @param[in] Timeout Time out value to wait for acknowlege from HOST.\r | |
267 | The unit is microsecond.\r | |
268 | @param[out] BreakReceived If BreakReceived is not NULL,\r | |
269 | TRUE is retured if break-in symbol received.\r | |
270 | FALSE is retured if break-in symbol not received.\r | |
271 | \r | |
272 | @retval RETRUEN_SUCCESS Succeed to receive acknowlege packet from HOST,\r | |
273 | the type of acknowlege packet saved in Ack.\r | |
274 | @retval RETURN_TIMEOUT Specified timeout value was up.\r | |
275 | \r | |
276 | **/\r | |
277 | RETURN_STATUS\r | |
278 | WaitForAckPacketOK (\r | |
279 | IN UINTN Timeout,\r | |
280 | OUT BOOLEAN *BreakReceived OPTIONAL\r | |
281 | )\r | |
282 | {\r | |
283 | RETURN_STATUS Status;\r | |
284 | UINT8 Ack;\r | |
285 | \r | |
286 | while (TRUE) {\r | |
287 | Status = ReceiveAckPacket (&Ack, Timeout, BreakReceived);\r | |
288 | if ((Status == RETURN_SUCCESS && Ack == DEBUG_COMMAND_OK) ||\r | |
289 | Status == RETURN_TIMEOUT) {\r | |
290 | break;\r | |
291 | }\r | |
292 | }\r | |
293 | \r | |
294 | return Status;\r | |
295 | }\r | |
296 | \r | |
297 | /**\r | |
298 | Receive valid packet from HOST.\r | |
299 | \r | |
300 | @param[out] InputPacket Buffer to receive packet.\r | |
301 | @param[out] BreakReceived TRUE means break-in symbol received.\r | |
302 | FALSE means break-in symbol not received.\r | |
303 | \r | |
304 | @retval RETURN_SUCCESS A valid package was reveived in InputPacket.\r | |
305 | @retval RETURN_NOT_READY No valid start symbol received.\r | |
306 | @retval RETURN_TIMEOUT Timeout occurs.\r | |
307 | \r | |
308 | **/\r | |
309 | RETURN_STATUS\r | |
310 | ReceivePacket (\r | |
311 | OUT UINT8 *InputPacket,\r | |
312 | OUT BOOLEAN *BreakReceived\r | |
313 | )\r | |
314 | {\r | |
315 | DEBUG_COMMAND_HEADER *DebugHeader;\r | |
316 | UINTN Received;\r | |
317 | DEBUG_PORT_HANDLE Handle;\r | |
318 | \r | |
319 | Handle = GetDebugPortHandle();\r | |
320 | //\r | |
321 | // Find the valid start symbol\r | |
322 | //\r | |
323 | DebugPortReadBuffer (Handle, InputPacket, 1, 0);\r | |
324 | \r | |
325 | if (*InputPacket == DEBUG_STARTING_SYMBOL_BREAK) {\r | |
326 | *BreakReceived = TRUE;\r | |
327 | SendAckPacket (DEBUG_COMMAND_HALT_DEFERRED);\r | |
328 | }\r | |
329 | \r | |
330 | if (*InputPacket != DEBUG_STARTING_SYMBOL_NORMAL) {\r | |
331 | return RETURN_NOT_READY;\r | |
332 | }\r | |
333 | \r | |
334 | //\r | |
335 | // Read Package header\r | |
336 | //\r | |
337 | Received = DebugPortReadBuffer (Handle, InputPacket + 1, sizeof(DEBUG_COMMAND_HEADER_NO_START_SYMBOL), 0);\r | |
338 | if (Received == 0) {\r | |
339 | return RETURN_TIMEOUT;\r | |
340 | }\r | |
341 | \r | |
342 | DebugHeader = (DEBUG_COMMAND_HEADER *) InputPacket;\r | |
343 | //\r | |
344 | // Read the payload if has\r | |
345 | //\r | |
346 | if (DebugHeader->DataLength > 0 && DebugHeader->DataLength < (DEBUG_DATA_MAXIMUM_REAL_DATA - sizeof(DEBUG_COMMAND_HEADER))) {\r | |
347 | InputPacket = InputPacket + 1 + Received;\r | |
348 | Received = DebugPortReadBuffer (Handle, InputPacket, DebugHeader->DataLength, 0);\r | |
349 | \r | |
350 | if (Received == 0) {\r | |
351 | return RETURN_TIMEOUT;\r | |
352 | }\r | |
353 | }\r | |
354 | \r | |
355 | return RETURN_SUCCESS;\r | |
356 | }\r | |
357 | \r | |
358 | /**\r | |
359 | Get current break cause.\r | |
360 | \r | |
361 | @param[in] Vector Vector value of exception or interrupt.\r | |
362 | @param[in] CpuContext Pointer to save CPU context.\r | |
363 | \r | |
364 | @return The type of break cause defined by XXXX\r | |
365 | \r | |
366 | **/\r | |
367 | UINT8\r | |
368 | GetBreakCause (\r | |
369 | IN UINTN Vector,\r | |
370 | IN DEBUG_CPU_CONTEXT *CpuContext\r | |
371 | )\r | |
372 | {\r | |
373 | UINT8 Cause;\r | |
374 | \r | |
375 | Cause = DEBUG_DATA_BREAK_CAUSE_UNKNOWN;\r | |
376 | \r | |
377 | switch (Vector) {\r | |
378 | case DEBUG_INT1_VECTOR:\r | |
379 | case DEBUG_INT3_VECTOR:\r | |
380 | \r | |
381 | if (Vector == DEBUG_INT1_VECTOR) {\r | |
382 | //\r | |
383 | // INT 1\r | |
384 | //\r | |
385 | if ((CpuContext->Dr6 & BIT14) != 0) {\r | |
386 | Cause = DEBUG_DATA_BREAK_CAUSE_STEPPING;\r | |
387 | \r | |
388 | } else {\r | |
389 | Cause = DEBUG_DATA_BREAK_CAUSE_HW_BREAKPOINT;\r | |
390 | }\r | |
391 | } else {\r | |
392 | //\r | |
393 | // INT 3\r | |
394 | //\r | |
395 | Cause = DEBUG_DATA_BREAK_CAUSE_SW_BREAKPOINT;\r | |
396 | }\r | |
397 | \r | |
398 | switch (CpuContext->Dr0) {\r | |
399 | case IMAGE_LOAD_SIGNATURE:\r | |
400 | case IMAGE_UNLOAD_SIGNATURE:\r | |
401 | \r | |
402 | if (CpuContext->Dr3 == IO_PORT_BREAKPOINT_ADDRESS) {\r | |
403 | \r | |
404 | Cause = (UINT8) ((CpuContext->Dr0 == IMAGE_LOAD_SIGNATURE) ? \r | |
405 | DEBUG_DATA_BREAK_CAUSE_IMAGE_LOAD : DEBUG_DATA_BREAK_CAUSE_IMAGE_UNLOAD);\r | |
406 | }\r | |
407 | break;\r | |
408 | \r | |
409 | case SOFT_INTERRUPT_SIGNATURE:\r | |
410 | \r | |
411 | if (CpuContext->Dr1 == MEMORY_READY_SIGNATURE) {\r | |
412 | Cause = DEBUG_DATA_BREAK_CAUSE_MEMORY_READY;\r | |
413 | CpuContext->Dr0 = 0;\r | |
414 | } else if (CpuContext->Dr1 == SYSTEM_RESET_SIGNATURE) {\r | |
415 | Cause = DEBUG_DATA_BREAK_CAUSE_SYSTEM_RESET;\r | |
416 | CpuContext->Dr0 = 0;\r | |
417 | }\r | |
418 | break;\r | |
419 | \r | |
420 | default:\r | |
421 | break;\r | |
422 | \r | |
423 | }\r | |
424 | \r | |
425 | break;\r | |
426 | \r | |
427 | case DEBUG_TIMER_VECTOR:\r | |
428 | Cause = DEBUG_DATA_BREAK_CAUSE_USER_HALT;\r | |
429 | break;\r | |
430 | \r | |
431 | default:\r | |
432 | if (Vector < 20) {\r | |
433 | Cause = DEBUG_DATA_BREAK_CAUSE_EXCEPTION;\r | |
434 | }\r | |
435 | break;\r | |
436 | }\r | |
437 | \r | |
438 | return Cause;\r | |
439 | }\r | |
440 | \r | |
441 | /**\r | |
442 | Send packet with response data to HOST.\r | |
443 | \r | |
444 | @param[in] CpuContext Pointer to saved CPU context.\r | |
445 | @param[in] Data Pointer to response data buffer.\r | |
446 | @param[in] DataSize Size of response data in byte.\r | |
447 | \r | |
448 | @retval RETURN_SUCCESS Response data was sent successfully.\r | |
449 | @retval RETURN_DEVICE_ERROR Cannot receive DEBUG_COMMAND_OK from HOST.\r | |
450 | \r | |
451 | **/\r | |
452 | RETURN_STATUS\r | |
453 | SendDataResponsePacket (\r | |
454 | IN DEBUG_CPU_CONTEXT *CpuContext,\r | |
455 | IN UINT8 *Data,\r | |
456 | IN UINT16 DataSize\r | |
457 | )\r | |
458 | {\r | |
459 | UINT8 PacketHeader[DEBUG_DATA_MAXIMUM_LENGTH_FOR_SMALL_COMMANDS];\r | |
460 | BOOLEAN LastPacket;\r | |
461 | UINT8 Ack;\r | |
462 | UINT8 PacketData[DEBUG_DATA_MAXIMUM_REAL_DATA];\r | |
463 | DEBUG_PORT_HANDLE Handle;\r | |
464 | \r | |
465 | Handle = GetDebugPortHandle();\r | |
466 | \r | |
467 | ((DEBUG_COMMAND_HEADER *)PacketHeader)->StartSymbol = DEBUG_STARTING_SYMBOL_NORMAL;\r | |
468 | \r | |
469 | while (TRUE) {\r | |
470 | if (DataSize <= DEBUG_DATA_MAXIMUM_REAL_DATA) {\r | |
471 | LastPacket = TRUE;\r | |
472 | ((DEBUG_COMMAND_HEADER *)PacketHeader)->Command = DEBUG_COMMAND_OK;\r | |
473 | ((DEBUG_COMMAND_HEADER *)PacketHeader)->DataLength = (UINT8) DataSize;\r | |
474 | CopyMem (PacketData, Data, DataSize);\r | |
475 | \r | |
476 | } else {\r | |
477 | LastPacket = FALSE;\r | |
478 | ((DEBUG_COMMAND_HEADER *)PacketHeader)->Command = DEBUG_COMMAND_IN_PROGRESS;\r | |
479 | ((DEBUG_COMMAND_HEADER *)PacketHeader)->DataLength = DEBUG_DATA_MAXIMUM_REAL_DATA;\r | |
480 | CopyMem (PacketData, Data, DEBUG_DATA_MAXIMUM_REAL_DATA);\r | |
481 | }\r | |
482 | \r | |
483 | DebugPortWriteBuffer (Handle, PacketHeader, sizeof (DEBUG_COMMAND_HEADER));\r | |
484 | DebugPortWriteBuffer (Handle, PacketData, ((DEBUG_COMMAND_HEADER *)PacketHeader)->DataLength);\r | |
485 | \r | |
486 | ReceiveAckPacket(&Ack, 0, NULL);\r | |
487 | switch (Ack) {\r | |
488 | case DEBUG_COMMAND_RESEND:\r | |
489 | //\r | |
490 | // Send the packet again\r | |
491 | //\r | |
492 | break;\r | |
493 | \r | |
494 | case DEBUG_COMMAND_CONTINUE:\r | |
495 | //\r | |
496 | // Send the rest packet\r | |
497 | //\r | |
498 | Data += DEBUG_DATA_MAXIMUM_REAL_DATA;\r | |
499 | DataSize -= DEBUG_DATA_MAXIMUM_REAL_DATA;\r | |
500 | break;\r | |
501 | \r | |
502 | case DEBUG_COMMAND_OK:\r | |
503 | if (LastPacket) {\r | |
504 | //\r | |
505 | // If this is the last packet, return RETURN_SUCCESS.\r | |
506 | //\r | |
507 | return RETURN_SUCCESS;\r | |
508 | } else {\r | |
509 | return RETURN_DEVICE_ERROR;\r | |
510 | }\r | |
511 | \r | |
512 | default:\r | |
513 | return RETURN_DEVICE_ERROR;\r | |
514 | \r | |
515 | }\r | |
516 | }\r | |
517 | }\r | |
518 | \r | |
519 | /**\r | |
520 | Send break cause packet to HOST.\r | |
521 | \r | |
522 | @param[in] Vector Vector value of exception or interrutp.\r | |
523 | @param[in] CpuContext Pointer to save CPU context.\r | |
524 | \r | |
525 | @retval RETURN_SUCCESS Response data was sent successfully.\r | |
526 | @retval RETURN_DEVICE_ERROR Cannot receive DEBUG_COMMAND_OK from HOST.\r | |
527 | \r | |
528 | **/\r | |
529 | RETURN_STATUS\r | |
530 | SendBreakCausePacket (\r | |
531 | IN UINTN Vector,\r | |
532 | IN DEBUG_CPU_CONTEXT *CpuContext\r | |
533 | )\r | |
534 | {\r | |
535 | DEBUG_DATA_RESPONSE_BREAK_CAUSE DebugDataBreakCause;\r | |
536 | \r | |
537 | DebugDataBreakCause.StopAddress = CpuContext->Eip;\r | |
538 | DebugDataBreakCause.Cause = GetBreakCause (Vector, CpuContext);\r | |
539 | \r | |
540 | return SendDataResponsePacket (CpuContext, (UINT8 *) &DebugDataBreakCause, (UINT16) sizeof (DEBUG_DATA_RESPONSE_BREAK_CAUSE));\r | |
541 | }\r | |
542 | \r | |
543 | \r | |
544 | /**\r | |
545 | The main function to process communication with HOST.\r | |
546 | \r | |
547 | It received the command packet from HOST, and sent response data packet to HOST.\r | |
548 | \r | |
549 | @param[in] Vector Vector value of exception or interrutp.\r | |
550 | @param[in, out] CpuContext Pointer to saved CPU context.\r | |
551 | @param[in] BreakReceived TRUE means break-in symbol received.\r | |
552 | FALSE means break-in symbol not received.\r | |
553 | \r | |
554 | **/\r | |
555 | VOID\r | |
556 | CommandCommunication (\r | |
557 | IN UINTN Vector,\r | |
558 | IN OUT DEBUG_CPU_CONTEXT *CpuContext,\r | |
559 | IN BOOLEAN BreakReceived\r | |
560 | )\r | |
561 | {\r | |
562 | RETURN_STATUS Status;\r | |
563 | UINT8 InputPacketBuffer[DEBUG_DATA_MAXIMUM_LENGTH_FOR_SMALL_COMMANDS];\r | |
564 | DEBUG_COMMAND_HEADER *DebugHeader;\r | |
565 | UINT8 Data8;\r | |
566 | UINT32 Data32;\r | |
567 | UINT64 Data64;\r | |
568 | UINTN DataN;\r | |
569 | DEBUG_DATA_READ_MEMORY_8 *MemoryRead;\r | |
570 | DEBUG_DATA_WRITE_MEMORY_8 *MemoryWrite;\r | |
571 | DEBUG_DATA_READ_IO *IoRead;\r | |
572 | DEBUG_DATA_WRITE_IO *IoWrite;\r | |
573 | DEBUG_DATA_READ_REGISTER *RegisterRead;\r | |
574 | DEBUG_DATA_WRITE_REGISTER *RegisterWrite;\r | |
575 | UINT8 *RegisterBuffer;\r | |
576 | DEBUG_DATA_READ_MSR *MsrRegisterRead;\r | |
577 | DEBUG_DATA_WRITE_MSR *MsrRegisterWrite;\r | |
578 | DEBUG_DATA_REPONSE_READ_REGISTER_GROUP_SEGLIM RegisterGroupSegLim;\r | |
579 | DEBUG_DATA_REPONSE_READ_REGISTER_GROUP_SEGBASE RegisterGroupSegBase;\r | |
580 | DEBUG_DATA_RESPONSE_GET_REVISION DebugAgentRevision;\r | |
581 | BOOLEAN HaltDeferred;\r | |
582 | DEBUG_DATA_RESPONSE_GET_EXCEPTION Exception;\r | |
583 | UINT32 ProcessorIndex;\r | |
584 | DEBUG_PORT_HANDLE Handle;\r | |
585 | \r | |
586 | Handle = GetDebugPortHandle();\r | |
587 | \r | |
588 | ProcessorIndex = 0;\r | |
589 | HaltDeferred = BreakReceived;\r | |
590 | \r | |
591 | if (MultiProcessorDebugSupport) {\r | |
592 | ProcessorIndex = GetProcessorIndex ();\r | |
593 | SetCpuStopFlagByIndex (ProcessorIndex, TRUE);\r | |
594 | }\r | |
595 | \r | |
596 | while (TRUE) {\r | |
597 | \r | |
598 | if (MultiProcessorDebugSupport) {\r | |
599 | if (mDebugMpContext.ViewPointIndex != ProcessorIndex) {\r | |
600 | if (mDebugMpContext.RunCommandSet) {\r | |
601 | SetCpuStopFlagByIndex (ProcessorIndex, FALSE);\r | |
602 | CommandGo (CpuContext);\r | |
603 | break;\r | |
604 | } else {\r | |
605 | continue;\r | |
606 | }\r | |
607 | }\r | |
608 | }\r | |
609 | \r | |
610 | AcquireDebugPortControl ();\r | |
611 | \r | |
612 | Status = ReceivePacket (InputPacketBuffer, &BreakReceived);\r | |
613 | \r | |
614 | if (BreakReceived) {\r | |
615 | HaltDeferred = TRUE;\r | |
616 | BreakReceived = FALSE;\r | |
617 | }\r | |
618 | \r | |
619 | if (Status != RETURN_SUCCESS) {\r | |
620 | ReleaseDebugPortControl ();\r | |
621 | continue;\r | |
622 | }\r | |
623 | \r | |
624 | Data8 = 1;\r | |
625 | \r | |
626 | DebugHeader =(DEBUG_COMMAND_HEADER *) InputPacketBuffer;\r | |
627 | switch (DebugHeader->Command) {\r | |
628 | \r | |
629 | case DEBUG_COMMAND_RESET:\r | |
630 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
631 | ReleaseDebugPortControl ();\r | |
632 | \r | |
633 | ResetCold ();\r | |
634 | //\r | |
635 | // Wait for reset\r | |
636 | //\r | |
637 | CpuDeadLoop ();\r | |
638 | break;\r | |
639 | \r | |
640 | case DEBUG_COMMAND_GO:\r | |
641 | CommandGo (CpuContext);\r | |
642 | if (!HaltDeferred) {\r | |
643 | //\r | |
644 | // If no HALT command received when being in-active mode\r | |
645 | //\r | |
646 | if (MultiProcessorDebugSupport) {\r | |
647 | Data32 = FindCpuNotRunning ();\r | |
648 | if (Data32 != -1) {\r | |
649 | //\r | |
650 | // If there are still others processors being in break state, \r | |
651 | // send OK packet to HOST to finish this go command\r | |
652 | //\r | |
653 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
654 | CpuPause ();\r | |
655 | //\r | |
656 | // Set current view to the next breaking processor\r | |
657 | //\r | |
658 | mDebugMpContext.ViewPointIndex = Data32;\r | |
659 | mDebugMpContext.BreakAtCpuIndex = mDebugMpContext.ViewPointIndex;\r | |
660 | SetCpuBreakFlagByIndex (mDebugMpContext.ViewPointIndex, FALSE);\r | |
661 | //\r | |
662 | // Send break packet to HOST and exit to wait for command packet from HOST.\r | |
663 | //\r | |
664 | SendAckPacket (DEBUG_COMMAND_BREAK_POINT);\r | |
665 | WaitForAckPacketOK (0, &BreakReceived);\r | |
666 | ReleaseDebugPortControl (); \r | |
667 | break;\r | |
668 | }\r | |
669 | \r | |
670 | //\r | |
671 | // If no else processor break, set stop bitmask,\r | |
672 | // and set Running flag for all processors.\r | |
673 | //\r | |
674 | SetCpuStopFlagByIndex (ProcessorIndex, FALSE);\r | |
675 | SetCpuRunningFlag (TRUE);\r | |
676 | CpuPause ();\r | |
677 | //\r | |
678 | // Wait for all processors are in running state \r | |
679 | //\r | |
680 | while (TRUE) {\r | |
681 | if (IsAllCpuRunning ()) {\r | |
682 | break;\r | |
683 | }\r | |
684 | }\r | |
685 | //\r | |
686 | // Set BSP to be current view point.\r | |
687 | //\r | |
688 | SetDebugViewPoint (mDebugMpContext.BspIndex);\r | |
689 | CpuPause ();\r | |
690 | //\r | |
691 | // Clear breaking processor index and running flag\r | |
692 | //\r | |
693 | mDebugMpContext.BreakAtCpuIndex = (UINT32) (-1);\r | |
694 | SetCpuRunningFlag (FALSE);\r | |
695 | }\r | |
696 | \r | |
697 | //\r | |
698 | // Send OK packet to HOST to finish this go command\r | |
699 | //\r | |
700 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
701 | \r | |
702 | ReleaseDebugPortControl ();\r | |
703 | \r | |
704 | return;\r | |
705 | \r | |
706 | } else {\r | |
707 | //\r | |
708 | // If reveived HALT command, need to defer the GO command\r | |
709 | //\r | |
710 | SendAckPacket (DEBUG_COMMAND_HALT_PROCESSED);\r | |
711 | HaltDeferred = FALSE;\r | |
712 | Data8 = GetBreakCause (Vector, CpuContext);\r | |
713 | if (Data8 == DEBUG_DATA_BREAK_CAUSE_IMAGE_LOAD || Data8 == DEBUG_DATA_BREAK_CAUSE_IMAGE_UNLOAD) {\r | |
714 | CpuContext->Dr0 = 0;\r | |
715 | CpuContext->Dr3 = 0;\r | |
716 | }\r | |
717 | \r | |
718 | Vector = DEBUG_TIMER_VECTOR;\r | |
719 | }\r | |
720 | break;\r | |
721 | \r | |
722 | case DEBUG_COMMAND_BREAK_CAUSE:\r | |
723 | \r | |
724 | if (MultiProcessorDebugSupport && ProcessorIndex != mDebugMpContext.BreakAtCpuIndex) {\r | |
725 | Status = SendBreakCausePacket (DEBUG_TIMER_VECTOR, CpuContext);\r | |
726 | \r | |
727 | } else {\r | |
728 | Status = SendBreakCausePacket (Vector, CpuContext);\r | |
729 | }\r | |
730 | \r | |
731 | break;\r | |
732 | \r | |
733 | case DEBUG_COMMAND_SET_HW_BREAKPOINT:\r | |
734 | SetDebugRegister (CpuContext, (DEBUG_DATA_SET_HW_BREAKPOINT *) (DebugHeader + 1));\r | |
735 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
736 | break;\r | |
737 | \r | |
738 | case DEBUG_COMMAND_CLEAR_HW_BREAKPOINT:\r | |
739 | ClearDebugRegister (CpuContext, (DEBUG_DATA_CLEAR_HW_BREAKPOINT *) (DebugHeader + 1));\r | |
740 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
741 | break;\r | |
742 | \r | |
743 | case DEBUG_COMMAND_SINGLE_STEPPING:\r | |
744 | CommandStepping (CpuContext);\r | |
745 | \r | |
746 | mDebugMpContext.BreakAtCpuIndex = (UINT32) (-1);\r | |
747 | \r | |
748 | ReleaseDebugPortControl ();\r | |
749 | //\r | |
750 | // Executing stepping command directly without sending ACK packet.\r | |
751 | //\r | |
752 | return;\r | |
753 | \r | |
754 | case DEBUG_COMMAND_SET_SW_BREAKPOINT:\r | |
755 | Data64 = (UINTN) (((DEBUG_DATA_SET_SW_BREAKPOINT *) (DebugHeader + 1))->Address);\r | |
756 | Data8 = *(UINT8 *) (UINTN) Data64;\r | |
757 | *(UINT8 *) (UINTN) Data64 = DEBUG_SW_BREAKPOINT_SYMBOL;\r | |
758 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &Data8, (UINT16) sizeof (UINT8));\r | |
759 | break;\r | |
760 | \r | |
761 | case DEBUG_COMMAND_READ_MEMORY_64:\r | |
762 | Data8 *= 2;\r | |
763 | case DEBUG_COMMAND_READ_MEMORY_32:\r | |
764 | Data8 *= 2;\r | |
765 | case DEBUG_COMMAND_READ_MEMORY_16:\r | |
766 | Data8 *= 2;\r | |
767 | case DEBUG_COMMAND_READ_MEMORY_8:\r | |
768 | MemoryRead = (DEBUG_DATA_READ_MEMORY_8 *) (DebugHeader + 1);\r | |
769 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) (UINTN) MemoryRead->Address, (UINT16) (MemoryRead->Count * Data8));\r | |
770 | break;\r | |
771 | \r | |
772 | case DEBUG_COMMAND_WRITE_MEMORY_64:\r | |
773 | Data8 *= 2;\r | |
774 | case DEBUG_COMMAND_WRITE_MEMORY_32:\r | |
775 | Data8 *= 2;\r | |
776 | case DEBUG_COMMAND_WRITE_MEMORY_16:\r | |
777 | Data8 *= 2;\r | |
778 | case DEBUG_COMMAND_WRITE_MEMORY_8:\r | |
779 | MemoryWrite = (DEBUG_DATA_WRITE_MEMORY_8 *) (DebugHeader + 1);\r | |
780 | CopyMem ((VOID *) (UINTN) MemoryWrite->Address, &MemoryWrite->Data, MemoryWrite->Count * Data8);\r | |
781 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
782 | break;\r | |
783 | \r | |
784 | case DEBUG_COMMAND_READ_IO:\r | |
785 | IoRead = (DEBUG_DATA_READ_IO *) (DebugHeader + 1);\r | |
786 | switch (IoRead->Width) {\r | |
787 | case 1:\r | |
788 | Data64 = IoRead8 (IoRead->Port);\r | |
789 | break;\r | |
790 | case 2:\r | |
791 | Data64 = IoRead16 (IoRead->Port);\r | |
792 | break;\r | |
793 | case 4:\r | |
794 | Data64 = IoRead32 (IoRead->Port);\r | |
795 | break;\r | |
796 | case 8:\r | |
797 | Data64 = IoRead64 (IoRead->Port);\r | |
798 | break;\r | |
799 | default:\r | |
800 | Data64 = (UINT64) -1;\r | |
801 | }\r | |
802 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &Data64, IoRead->Width);\r | |
803 | break;\r | |
804 | \r | |
805 | case DEBUG_COMMAND_WRITE_IO:\r | |
806 | IoWrite = (DEBUG_DATA_WRITE_IO *) (DebugHeader + 1);\r | |
807 | switch (IoWrite->Width) {\r | |
808 | case 1:\r | |
809 | Data64 = IoWrite8 (IoWrite->Port, *(UINT8 *) &IoWrite->Data);\r | |
810 | break;\r | |
811 | case 2:\r | |
812 | Data64 = IoWrite16 (IoWrite->Port, *(UINT16 *) &IoWrite->Data);\r | |
813 | break;\r | |
814 | case 4:\r | |
815 | Data64 = IoWrite32 (IoWrite->Port, *(UINT32 *) &IoWrite->Data);\r | |
816 | break;\r | |
817 | case 8:\r | |
818 | Data64 = IoWrite64 (IoWrite->Port, *(UINT64 *) &IoWrite->Data);\r | |
819 | break;\r | |
820 | default:\r | |
821 | Data64 = (UINT64) -1;\r | |
822 | }\r | |
823 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
824 | break;\r | |
825 | \r | |
826 | case DEBUG_COMMAND_READ_REGISTER:\r | |
827 | RegisterRead = (DEBUG_DATA_READ_REGISTER *) (DebugHeader + 1);\r | |
828 | \r | |
829 | if (RegisterRead->Index < SOFT_DEBUGGER_REGISTER_OTHERS_BASE) {\r | |
830 | Data8 = RegisterRead->Length;\r | |
831 | RegisterBuffer = ArchReadRegisterBuffer (CpuContext, RegisterRead->Index, RegisterRead->Offset, &Data8);\r | |
832 | Status = SendDataResponsePacket (CpuContext, RegisterBuffer, Data8);\r | |
833 | break;\r | |
834 | }\r | |
835 | \r | |
836 | if (RegisterRead->Index <= SOFT_DEBUGGER_REGISTER_TSS_LIM) {\r | |
837 | ReadRegisterGroupSegLim (CpuContext, &RegisterGroupSegLim);\r | |
838 | DataN = * ((UINTN *) &RegisterGroupSegLim + (RegisterRead->Index - SOFT_DEBUGGER_REGISTER_CS_LIM));\r | |
839 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &DataN, (UINT16) sizeof (UINTN));\r | |
840 | } else if (RegisterRead->Index <= SOFT_DEBUGGER_REGISTER_TSS_BAS) {\r | |
841 | ReadRegisterGroupSegBase (CpuContext, &RegisterGroupSegBase);\r | |
842 | DataN = * ((UINTN *) &RegisterGroupSegBase + (RegisterRead->Index - SOFT_DEBUGGER_REGISTER_CS_BAS));\r | |
843 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &DataN, (UINT16) sizeof (UINTN));\r | |
844 | } else if (RegisterRead->Index < SOFT_DEBUGGER_REGISTER_IDT_LIM) {\r | |
845 | Data64 = ReadRegisterSelectorByIndex (CpuContext, RegisterRead->Index);\r | |
846 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &Data64, (UINT16) sizeof (UINT64));\r | |
847 | } else {\r | |
848 | switch (RegisterRead->Index) {\r | |
849 | case SOFT_DEBUGGER_REGISTER_IDT_LIM:\r | |
850 | DataN = (UINTN) (CpuContext->Idtr[0] & 0xffff);\r | |
851 | SendDataResponsePacket (CpuContext, (UINT8 *) &DataN, (UINT16) sizeof (UINTN));\r | |
852 | break;\r | |
853 | case SOFT_DEBUGGER_REGISTER_GDT_LIM:\r | |
854 | DataN = (UINTN) (CpuContext->Gdtr[0] & 0xffff);\r | |
855 | SendDataResponsePacket (CpuContext, (UINT8 *) &DataN, (UINT16) sizeof (UINTN));\r | |
856 | break;\r | |
857 | case SOFT_DEBUGGER_REGISTER_IDT_BAS:\r | |
858 | DataN = (UINTN) RShiftU64 (CpuContext->Idtr[0], 16);\r | |
859 | DataN |= (UINTN) LShiftU64 (CpuContext->Idtr[1], (UINT16) (sizeof (UINTN) * 8 - 16));\r | |
860 | SendDataResponsePacket (CpuContext, (UINT8 *) &DataN, (UINT16) sizeof (UINTN));\r | |
861 | break;\r | |
862 | case SOFT_DEBUGGER_REGISTER_GDT_BAS:\r | |
863 | DataN = (UINTN) RShiftU64 (CpuContext->Gdtr[0], 16);\r | |
864 | DataN |= (UINTN) LShiftU64 (CpuContext->Gdtr[1], (UINT16) (sizeof (UINTN) * 8 - 16));\r | |
865 | SendDataResponsePacket (CpuContext, (UINT8 *) &DataN, (UINT16) sizeof (UINTN));\r | |
866 | break;\r | |
867 | }\r | |
868 | }\r | |
869 | break;\r | |
870 | \r | |
871 | case DEBUG_COMMAND_WRITE_REGISTER:\r | |
872 | RegisterWrite = (DEBUG_DATA_WRITE_REGISTER *) (DebugHeader + 1);\r | |
873 | ArchWriteRegisterBuffer (CpuContext, RegisterWrite->Index, RegisterWrite->Offset, RegisterWrite->Length, (UINT8 *)&RegisterWrite->Value);\r | |
874 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
875 | break;\r | |
876 | \r | |
877 | case DEBUG_COMMAND_ARCH_MODE:\r | |
878 | Data8 = DEBUG_ARCH_SYMBOL;\r | |
879 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &Data8, (UINT16) sizeof (UINT8));\r | |
880 | break;\r | |
881 | \r | |
882 | case DEBUG_COMMAND_READ_MSR:\r | |
883 | MsrRegisterRead = (DEBUG_DATA_READ_MSR *) (DebugHeader + 1);\r | |
884 | Data64 = AsmReadMsr64 (MsrRegisterRead->Index);\r | |
885 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &Data64, (UINT16) sizeof (UINT64));\r | |
886 | break;\r | |
887 | \r | |
888 | case DEBUG_COMMAND_WRITE_MSR:\r | |
889 | MsrRegisterWrite = (DEBUG_DATA_WRITE_MSR *) (DebugHeader + 1);\r | |
890 | AsmWriteMsr64 (MsrRegisterWrite->Index, MsrRegisterWrite->Value);\r | |
891 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
892 | break;\r | |
893 | \r | |
894 | case DEBUG_COMMAND_READ_REGISTER_GROUP:\r | |
895 | Data8 = *(UINT8 *) (DebugHeader + 1);\r | |
896 | Status = ArchReadRegisterGroup (CpuContext, Data8);\r | |
897 | break;\r | |
898 | \r | |
899 | case DEBUG_COMMAND_SET_DEBUG_FLAG:\r | |
900 | Data32 = *(UINT32 *) (DebugHeader + 1);\r | |
901 | SetDebugFlag (Data32);\r | |
902 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
903 | break;\r | |
904 | \r | |
905 | case DEBUG_COMMAND_GET_REVISION:\r | |
906 | DebugAgentRevision.Revision = DEBUG_AGENT_REVISION;\r | |
907 | DebugAgentRevision.Capabilities = DEBUG_AGENT_CAPABILITIES;\r | |
908 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &DebugAgentRevision, (UINT16) sizeof (DEBUG_DATA_RESPONSE_GET_REVISION));\r | |
909 | break;\r | |
910 | \r | |
911 | case DEBUG_COMMAND_GET_EXCEPTION:\r | |
912 | Exception.ExceptionNum = (UINT8) Vector;\r | |
913 | Exception.ExceptionData = 0;\r | |
914 | Status = SendDataResponsePacket (CpuContext, (UINT8 *) &Exception, (UINT16) sizeof (DEBUG_DATA_RESPONSE_GET_EXCEPTION));\r | |
915 | break;\r | |
916 | \r | |
917 | case DEBUG_COMMAND_SET_VIEWPOINT:\r | |
918 | Data32 = *(UINT32 *) (DebugHeader + 1);\r | |
919 | \r | |
920 | if (MultiProcessorDebugSupport) {\r | |
921 | if (IsCpuStopped (Data32)) {\r | |
922 | SetDebugViewPoint (Data32);\r | |
923 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
924 | } else {\r | |
925 | //\r | |
926 | // If CPU is not halted\r | |
927 | //\r | |
928 | SendAckPacket (DEBUG_COMMAND_NOT_SUPPORTED);\r | |
929 | }\r | |
930 | } else if (Data32 == 0) {\r | |
931 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
932 | \r | |
933 | } else {\r | |
934 | SendAckPacket (DEBUG_COMMAND_NOT_SUPPORTED);\r | |
935 | }\r | |
936 | \r | |
937 | break;\r | |
938 | \r | |
939 | case DEBUG_COMMAND_GET_VIEWPOINT:\r | |
940 | Data32 = mDebugMpContext.ViewPointIndex;\r | |
941 | SendDataResponsePacket(CpuContext, (UINT8 *) &Data32, (UINT16) sizeof (UINT32));\r | |
942 | break;\r | |
943 | \r | |
944 | default:\r | |
945 | SendAckPacket (DEBUG_COMMAND_NOT_SUPPORTED);\r | |
946 | break;\r | |
947 | }\r | |
948 | \r | |
949 | if (Status == RETURN_UNSUPPORTED) {\r | |
950 | SendAckPacket (DEBUG_COMMAND_NOT_SUPPORTED);\r | |
951 | } else if (Status != RETURN_SUCCESS) {\r | |
952 | SendAckPacket (DEBUG_COMMAND_ABORT);\r | |
953 | }\r | |
954 | \r | |
955 | ReleaseDebugPortControl ();\r | |
956 | CpuPause ();\r | |
957 | }\r | |
958 | }\r | |
959 | \r | |
960 | /**\r | |
961 | C function called in interrupt handler.\r | |
962 | \r | |
963 | @param[in] Vector Vector value of exception or interrutp.\r | |
964 | @param[in] CpuContext Pointer to save CPU context.\r | |
965 | \r | |
966 | **/\r | |
967 | VOID\r | |
968 | EFIAPI\r | |
969 | InterruptProcess (\r | |
970 | IN UINT32 Vector,\r | |
971 | IN DEBUG_CPU_CONTEXT *CpuContext\r | |
972 | )\r | |
973 | {\r | |
974 | UINT8 InputCharacter;\r | |
975 | UINT8 BreakCause;\r | |
976 | UINTN SavedEip;\r | |
977 | BOOLEAN BreakReceived;\r | |
978 | UINT32 ProcessorIndex;\r | |
979 | UINT32 CurrentDebugTimerInitCount;\r | |
980 | DEBUG_PORT_HANDLE Handle;\r | |
981 | UINT8 Data8;\r | |
982 | \r | |
983 | Handle = GetDebugPortHandle();\r | |
984 | \r | |
985 | ProcessorIndex = 0;\r | |
986 | BreakReceived = FALSE;\r | |
987 | \r | |
988 | if (MultiProcessorDebugSupport) {\r | |
989 | ProcessorIndex = GetProcessorIndex ();\r | |
990 | while (mDebugMpContext.RunCommandSet);\r | |
991 | }\r | |
992 | \r | |
993 | switch (Vector) {\r | |
994 | case DEBUG_INT1_VECTOR:\r | |
995 | case DEBUG_INT3_VECTOR:\r | |
996 | \r | |
997 | BreakCause = GetBreakCause (Vector, CpuContext);\r | |
998 | \r | |
999 | if (BreakCause == DEBUG_DATA_BREAK_CAUSE_SYSTEM_RESET) {\r | |
1000 | \r | |
1001 | //\r | |
1002 | // Init break, if no ack received after 200ms, return\r | |
1003 | //\r | |
1004 | SendAckPacket (DEBUG_COMMAND_INIT_BREAK);\r | |
1005 | if (WaitForAckPacketOK (200 * 1000, &BreakReceived) != RETURN_SUCCESS) {\r | |
1006 | break;\r | |
1007 | }\r | |
1008 | \r | |
1009 | SetHostConnectedFlag ();\r | |
1010 | CommandCommunication (Vector, CpuContext, BreakReceived);\r | |
1011 | \r | |
1012 | } else if (BreakCause == DEBUG_DATA_BREAK_CAUSE_STEPPING) {\r | |
1013 | \r | |
1014 | //\r | |
1015 | // Stepping is finished, send Ack package.\r | |
1016 | //\r | |
1017 | if (MultiProcessorDebugSupport) {\r | |
1018 | mDebugMpContext.BreakAtCpuIndex = ProcessorIndex;\r | |
1019 | }\r | |
1020 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
1021 | CommandCommunication (Vector, CpuContext, BreakReceived);\r | |
1022 | \r | |
1023 | } else if (BreakCause == DEBUG_DATA_BREAK_CAUSE_MEMORY_READY) {\r | |
1024 | \r | |
1025 | //\r | |
1026 | // Memory is ready\r | |
1027 | //\r | |
1028 | SendAckPacket (DEBUG_COMMAND_MEMORY_READY);\r | |
1029 | WaitForAckPacketOK (0, &BreakReceived);\r | |
1030 | CommandCommunication (Vector, CpuContext, BreakReceived);\r | |
1031 | \r | |
1032 | } else {\r | |
1033 | \r | |
1034 | if (BreakCause == DEBUG_DATA_BREAK_CAUSE_IMAGE_LOAD || BreakCause == DEBUG_DATA_BREAK_CAUSE_IMAGE_UNLOAD) {\r | |
1035 | \r | |
1036 | //\r | |
1037 | // Set AL to DEBUG_AGENT_IMAGE_CONTINUE\r | |
1038 | //\r | |
1039 | Data8 = DEBUG_AGENT_IMAGE_CONTINUE;\r | |
1040 | ArchWriteRegisterBuffer (CpuContext, SOFT_DEBUGGER_REGISTER_AX, 0, 1, &Data8);\r | |
1041 | \r | |
1042 | if (!IsHostConnected ()) {\r | |
1043 | //\r | |
1044 | // If HOST is not connected, return\r | |
1045 | //\r | |
1046 | break;\r | |
1047 | }\r | |
1048 | }\r | |
1049 | \r | |
1050 | AcquireDebugPortControl ();\r | |
1051 | \r | |
1052 | if (MultiProcessorDebugSupport) {\r | |
1053 | if(!IsAllCpuRunning ()) {\r | |
1054 | //\r | |
1055 | // If other processors have been stopped\r | |
1056 | //\r | |
1057 | SetCpuBreakFlagByIndex (ProcessorIndex, TRUE);\r | |
1058 | } else {\r | |
1059 | //\r | |
1060 | // If no any processor was stopped, try to halt other processors\r | |
1061 | //\r | |
1062 | HaltOtherProcessors (ProcessorIndex);\r | |
1063 | SendAckPacket (DEBUG_COMMAND_BREAK_POINT);\r | |
1064 | WaitForAckPacketOK (0, &BreakReceived);\r | |
1065 | }\r | |
1066 | } else {\r | |
1067 | SendAckPacket (DEBUG_COMMAND_BREAK_POINT);\r | |
1068 | WaitForAckPacketOK (0, &BreakReceived);\r | |
1069 | }\r | |
1070 | \r | |
1071 | ReleaseDebugPortControl ();\r | |
1072 | \r | |
1073 | if (Vector == DEBUG_INT3_VECTOR) {\r | |
1074 | //\r | |
1075 | // go back address located "0xCC"\r | |
1076 | //\r | |
1077 | CpuContext->Eip--;\r | |
1078 | SavedEip = CpuContext->Eip;\r | |
1079 | CommandCommunication (Vector, CpuContext, BreakReceived);\r | |
1080 | if ((SavedEip == CpuContext->Eip) &&\r | |
1081 | (*(UINT8 *) (UINTN) CpuContext->Eip == DEBUG_SW_BREAKPOINT_SYMBOL)) {\r | |
1082 | //\r | |
1083 | // If this is not a software breakpoint set by HOST,\r | |
1084 | // restore EIP\r | |
1085 | //\r | |
1086 | CpuContext->Eip++;\r | |
1087 | }\r | |
1088 | } else {\r | |
1089 | CommandCommunication (Vector, CpuContext, BreakReceived);\r | |
1090 | }\r | |
1091 | }\r | |
1092 | \r | |
1093 | break;\r | |
1094 | \r | |
1095 | case DEBUG_TIMER_VECTOR:\r | |
1096 | \r | |
1097 | if (MultiProcessorDebugSupport) {\r | |
1098 | if (IsBsp (ProcessorIndex)) {\r | |
1099 | //\r | |
1100 | // If current processor is BSP, check Apic timer's init count if changed,\r | |
1101 | // it may be re-written when switching BSP.\r | |
1102 | // If it changed, re-initialize debug timer\r | |
1103 | //\r | |
1104 | CurrentDebugTimerInitCount = GetApicTimerInitCount ();\r | |
1105 | if (mDebugMpContext.DebugTimerInitCount != CurrentDebugTimerInitCount) {\r | |
1106 | InitializeDebugTimer ();\r | |
1107 | }\r | |
1108 | }\r | |
1109 | \r | |
1110 | if (!IsBsp (ProcessorIndex) || mDebugMpContext.IpiSentByAp) {\r | |
1111 | //\r | |
1112 | // If current processor is not BSP or this is one IPI sent by AP\r | |
1113 | //\r | |
1114 | if (mDebugMpContext.BreakAtCpuIndex != (UINT32) (-1)) {\r | |
1115 | CommandCommunication (Vector, CpuContext, FALSE);\r | |
1116 | }\r | |
1117 | \r | |
1118 | //\r | |
1119 | // Clear EOI before exiting interrupt process routine.\r | |
1120 | //\r | |
1121 | SendApicEoi ();\r | |
1122 | break;\r | |
1123 | }\r | |
1124 | }\r | |
1125 | \r | |
1126 | //\r | |
1127 | // Only BSP could run here\r | |
1128 | //\r | |
1129 | \r | |
1130 | AcquireDebugPortControl ();\r | |
1131 | \r | |
1132 | while (DebugPortPollBuffer (Handle)) {\r | |
1133 | //\r | |
1134 | // If there is data in debug port, will check whether it is break-in symbol,\r | |
1135 | // If yes, go into communication mode with HOST.\r | |
1136 | // If no, exit interrupt process.\r | |
1137 | //\r | |
1138 | DebugPortReadBuffer (Handle, &InputCharacter, 1, 0);\r | |
1139 | if (InputCharacter == DEBUG_STARTING_SYMBOL_BREAK) {\r | |
1140 | SendAckPacket (DEBUG_COMMAND_OK);\r | |
1141 | if (MultiProcessorDebugSupport) {\r | |
1142 | if(FindCpuNotRunning () != -1) {\r | |
1143 | SetCpuBreakFlagByIndex (ProcessorIndex, TRUE);\r | |
1144 | } else {\r | |
1145 | HaltOtherProcessors (ProcessorIndex);\r | |
1146 | }\r | |
1147 | }\r | |
1148 | ReleaseDebugPortControl ();\r | |
1149 | CommandCommunication (Vector, CpuContext, BreakReceived);\r | |
1150 | AcquireDebugPortControl ();\r | |
1151 | break;\r | |
1152 | }\r | |
1153 | }\r | |
1154 | \r | |
1155 | //\r | |
1156 | // Clear EOI before exiting interrupt process routine.\r | |
1157 | //\r | |
1158 | SendApicEoi ();\r | |
1159 | \r | |
1160 | ReleaseDebugPortControl ();\r | |
1161 | \r | |
1162 | break;\r | |
1163 | \r | |
1164 | default:\r | |
1165 | \r | |
1166 | if (Vector <= DEBUG_EXCEPT_SIMD) {\r | |
1167 | \r | |
1168 | AcquireDebugPortControl ();\r | |
1169 | \r | |
1170 | if (MultiProcessorDebugSupport) {\r | |
1171 | if(FindCpuNotRunning () != -1) {\r | |
1172 | SetCpuBreakFlagByIndex (ProcessorIndex, TRUE);\r | |
1173 | } else {\r | |
1174 | HaltOtherProcessors (ProcessorIndex);\r | |
1175 | }\r | |
1176 | }\r | |
1177 | SendAckPacket (DEBUG_COMMAND_BREAK_POINT);\r | |
1178 | WaitForAckPacketOK (0, &BreakReceived);\r | |
1179 | ReleaseDebugPortControl ();\r | |
1180 | CommandCommunication (Vector, CpuContext, BreakReceived);\r | |
1181 | }\r | |
1182 | break;\r | |
1183 | }\r | |
1184 | \r | |
1185 | if (MultiProcessorDebugSupport) {\r | |
1186 | //\r | |
1187 | // Clear flag and wait for all processors run here\r | |
1188 | //\r | |
1189 | SetIpiSentByApFlag (FALSE);\r | |
1190 | while (mDebugMpContext.RunCommandSet);\r | |
1191 | }\r | |
1192 | \r | |
1193 | return;\r | |
1194 | }\r | |
1195 | \r |