// Copyright 2013 Dolphin Emulator Project // Licensed under GPLv2 // Refer to the license.txt file included. #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "Common/BreakPoints.h" #include "Common/Common.h" #include "Common/StringUtil.h" #include "Common/SymbolDB.h" #include "Core/Core.h" #include "Core/CoreParameter.h" #include "Core/Host.h" #include "Core/Debugger/Debugger_SymbolMap.h" #include "Core/Debugger/PPCDebugInterface.h" #include "Core/HW/CPU.h" #include "Core/HW/Memmap.h" #include "Core/PowerPC/Gekko.h" #include "Core/PowerPC/JitInterface.h" #include "Core/PowerPC/PowerPC.h" #include "Core/PowerPC/PPCSymbolDB.h" #include "Core/PowerPC/PPCTables.h" #include "DolphinWX/Frame.h" #include "DolphinWX/Globals.h" #include "DolphinWX/WxUtils.h" #include "DolphinWX/Debugger/BreakpointWindow.h" #include "DolphinWX/Debugger/CodeView.h" #include "DolphinWX/Debugger/CodeWindow.h" #include "DolphinWX/Debugger/DebuggerUIUtil.h" #include "DolphinWX/Debugger/JitWindow.h" #include "DolphinWX/Debugger/RegisterWindow.h" extern "C" // Bitmaps { #include "DolphinWX/resources/toolbar_add_memorycheck.c" // NOLINT #include "DolphinWX/resources/toolbar_add_breakpoint.c" // NOLINT } class DebugInterface; // ------- // Main BEGIN_EVENT_TABLE(CCodeWindow, wxPanel) // Menu bar EVT_MENU_RANGE(IDM_INTERPRETER, IDM_JITSROFF, CCodeWindow::OnCPUMode) EVT_MENU(IDM_FONTPICKER, CCodeWindow::OnChangeFont) EVT_MENU_RANGE(IDM_CLEARCODECACHE, IDM_SEARCHINSTRUCTION, CCodeWindow::OnJitMenu) EVT_MENU_RANGE(IDM_CLEARSYMBOLS, IDM_PATCHHLEFUNCTIONS, CCodeWindow::OnSymbolsMenu) EVT_MENU_RANGE(IDM_PROFILEBLOCKS, IDM_WRITEPROFILE, CCodeWindow::OnProfilerMenu) // Toolbar EVT_MENU_RANGE(IDM_STEP, IDM_GOTOPC, CCodeWindow::OnCodeStep) EVT_TEXT(IDM_ADDRBOX, CCodeWindow::OnAddrBoxChange) // Other EVT_LISTBOX(ID_SYMBOLLIST, CCodeWindow::OnSymbolListChange) EVT_LISTBOX(ID_CALLSTACKLIST, CCodeWindow::OnCallstackListChange) EVT_LISTBOX(ID_CALLERSLIST, CCodeWindow::OnCallersListChange) EVT_LISTBOX(ID_CALLSLIST, CCodeWindow::OnCallsListChange) EVT_HOST_COMMAND(wxID_ANY, CCodeWindow::OnHostMessage) END_EVENT_TABLE() // Class CCodeWindow::CCodeWindow(const SCoreStartupParameter& _LocalCoreStartupParameter, CFrame *parent, wxWindowID id, const wxPoint& position, const wxSize& size, long style, const wxString& name) : wxPanel(parent, id, position, size, style, name) , Parent(parent) , m_RegisterWindow(nullptr) , m_BreakpointWindow(nullptr) , m_MemoryWindow(nullptr) , m_JitWindow(nullptr) , m_SoundWindow(nullptr) , m_VideoWindow(nullptr) , codeview(nullptr) { InitBitmaps(); wxBoxSizer* sizerBig = new wxBoxSizer(wxHORIZONTAL); wxBoxSizer* sizerLeft = new wxBoxSizer(wxVERTICAL); DebugInterface* di = &PowerPC::debug_interface; codeview = new CCodeView(di, &g_symbolDB, this, ID_CODEVIEW); sizerBig->Add(sizerLeft, 2, wxEXPAND); sizerBig->Add(codeview, 5, wxEXPAND); sizerLeft->Add(callstack = new wxListBox(this, ID_CALLSTACKLIST, wxDefaultPosition, wxSize(90, 100)), 0, wxEXPAND); sizerLeft->Add(symbols = new wxListBox(this, ID_SYMBOLLIST, wxDefaultPosition, wxSize(90, 100), 0, nullptr, wxLB_SORT), 1, wxEXPAND); sizerLeft->Add(calls = new wxListBox(this, ID_CALLSLIST, wxDefaultPosition, wxSize(90, 100), 0, nullptr, wxLB_SORT), 0, wxEXPAND); sizerLeft->Add(callers = new wxListBox(this, ID_CALLERSLIST, wxDefaultPosition, wxSize(90, 100), 0, nullptr, wxLB_SORT), 0, wxEXPAND); SetSizer(sizerBig); sizerLeft->Fit(this); sizerBig->Fit(this); } wxMenuBar *CCodeWindow::GetMenuBar() { return Parent->GetMenuBar(); } wxToolBar *CCodeWindow::GetToolBar() { return Parent->m_ToolBar; } // ---------- // Events void CCodeWindow::OnHostMessage(wxCommandEvent& event) { switch (event.GetId()) { case IDM_NOTIFYMAPLOADED: NotifyMapLoaded(); if (m_BreakpointWindow) m_BreakpointWindow->NotifyUpdate(); break; case IDM_UPDATEDISASMDIALOG: Update(); if (codeview) codeview->Center(PC); if (m_RegisterWindow) m_RegisterWindow->NotifyUpdate(); break; case IDM_UPDATEBREAKPOINTS: Update(); if (m_BreakpointWindow) m_BreakpointWindow->NotifyUpdate(); break; case IDM_UPDATEJITPANE: // Check if the JIT pane is in the AUI notebook. If not, add it and switch to it. if (!m_JitWindow) ToggleJitWindow(true); m_JitWindow->ViewAddr(codeview->GetSelection()); break; } } // The Play, Stop, Step, Skip, Go to PC and Show PC buttons go here void CCodeWindow::OnCodeStep(wxCommandEvent& event) { switch (event.GetId()) { case IDM_STEP: SingleStep(); break; case IDM_STEPOVER: StepOver(); break; case IDM_TOGGLE_BREAKPOINT: ToggleBreakpoint(); break; case IDM_SKIP: PC += 4; Update(); break; case IDM_SETPC: PC = codeview->GetSelection(); Update(); break; case IDM_GOTOPC: JumpToAddress(PC); break; } UpdateButtonStates(); // Update all toolbars in the aui manager Parent->UpdateGUI(); } bool CCodeWindow::JumpToAddress(u32 address) { // Jump to anywhere in memory if (address <= 0xFFFFFFFF) { codeview->Center(address); UpdateLists(); return true; } return false; } void CCodeWindow::OnCodeViewChange(wxCommandEvent &event) { UpdateLists(); } void CCodeWindow::OnAddrBoxChange(wxCommandEvent& event) { if (!GetToolBar()) return; wxTextCtrl* pAddrCtrl = (wxTextCtrl*)GetToolBar()->FindControl(IDM_ADDRBOX); // Trim leading and trailing whitespace. wxString txt = pAddrCtrl->GetValue().Trim().Trim(false); bool success = false; unsigned long addr; if (txt.ToULong(&addr, 16)) { if (JumpToAddress(addr)) success = true; } if (success) pAddrCtrl->SetBackgroundColour(wxNullColour); else pAddrCtrl->SetBackgroundColour(*wxRED); pAddrCtrl->Refresh(); event.Skip(); } void CCodeWindow::OnCallstackListChange(wxCommandEvent& event) { int index = callstack->GetSelection(); if (index >= 0) { u32 address = (u32)(u64)(callstack->GetClientData(index)); if (address) JumpToAddress(address); } } void CCodeWindow::OnCallersListChange(wxCommandEvent& event) { int index = callers->GetSelection(); if (index >= 0) { u32 address = (u32)(u64)(callers->GetClientData(index)); if (address) JumpToAddress(address); } } void CCodeWindow::OnCallsListChange(wxCommandEvent& event) { int index = calls->GetSelection(); if (index >= 0) { u32 address = (u32)(u64)(calls->GetClientData(index)); if (address) JumpToAddress(address); } } void CCodeWindow::SingleStep() { if (CCPU::IsStepping()) { JitInterface::InvalidateICache(PC, 4); CCPU::StepOpcode(&sync_event); wxThread::Sleep(20); // need a short wait here JumpToAddress(PC); Update(); } } void CCodeWindow::StepOver() { if (CCPU::IsStepping()) { UGeckoInstruction inst = Memory::Read_Instruction(PC); if (inst.LK) { PowerPC::breakpoints.Add(PC + 4, true); CCPU::EnableStepping(false); JumpToAddress(PC); Update(); } else { SingleStep(); } UpdateButtonStates(); // Update all toolbars in the aui manager Parent->UpdateGUI(); } } void CCodeWindow::ToggleBreakpoint() { if (CCPU::IsStepping()) { if (codeview) codeview->ToggleBreakpoint(codeview->GetSelection()); Update(); } } void CCodeWindow::UpdateLists() { callers->Clear(); u32 addr = codeview->GetSelection(); Symbol *symbol = g_symbolDB.GetSymbolFromAddr(addr); if (!symbol) return; for (auto& call : symbol->callers) { u32 caller_addr = call.callAddress; Symbol *caller_symbol = g_symbolDB.GetSymbolFromAddr(caller_addr); if (caller_symbol) { int idx = callers->Append(StrToWxStr(StringFromFormat ("< %s (%08x)", caller_symbol->name.c_str(), caller_addr).c_str())); callers->SetClientData(idx, (void*)(u64)caller_addr); } } calls->Clear(); for (auto& call : symbol->calls) { u32 call_addr = call.function; Symbol *call_symbol = g_symbolDB.GetSymbolFromAddr(call_addr); if (call_symbol) { int idx = calls->Append(StrToWxStr(StringFromFormat ("> %s (%08x)", call_symbol->name.c_str(), call_addr).c_str())); calls->SetClientData(idx, (void*)(u64)call_addr); } } } void CCodeWindow::UpdateCallstack() { if (Core::GetState() == Core::CORE_STOPPING) return; callstack->Clear(); std::vector stack; bool ret = Dolphin_Debugger::GetCallstack(stack); for (auto& frame : stack) { int idx = callstack->Append(StrToWxStr(frame.Name)); callstack->SetClientData(idx, (void*)(u64)frame.vAddress); } if (!ret) callstack->Append(StrToWxStr("invalid callstack")); } // Create CPU Mode menus void CCodeWindow::CreateMenu(const SCoreStartupParameter& _LocalCoreStartupParameter, wxMenuBar *pMenuBar) { // CPU Mode wxMenu* pCoreMenu = new wxMenu; wxMenuItem* interpreter = pCoreMenu->Append(IDM_INTERPRETER, _("&Interpreter core"), _("This is necessary to get break points" " and stepping to work as explained in the Developer Documentation. But it can be very" " slow, perhaps slower than 1 fps."), wxITEM_CHECK); interpreter->Check(_LocalCoreStartupParameter.iCPUCore == 0); pCoreMenu->AppendSeparator(); pCoreMenu->Append(IDM_JITBLOCKLINKING, _("&JIT Block Linking off"), _("Provide safer execution by not linking the JIT blocks."), wxITEM_CHECK); pCoreMenu->Append(IDM_JITNOBLOCKCACHE, _("&Disable JIT Cache"), _("Avoid any involuntary JIT cache clearing, this may prevent Zelda TP from crashing.\n[This option must be selected before a game is started.]"), wxITEM_CHECK); pCoreMenu->Append(IDM_CLEARCODECACHE, _("&Clear JIT cache")); pCoreMenu->AppendSeparator(); pCoreMenu->Append(IDM_LOGINSTRUCTIONS, _("&Log JIT instruction coverage")); pCoreMenu->Append(IDM_SEARCHINSTRUCTION, _("&Search for an op")); pCoreMenu->AppendSeparator(); pCoreMenu->Append(IDM_JITOFF, _("&JIT off (JIT core)"), _("Turn off all JIT functions, but still use the JIT core from Jit.cpp"), wxITEM_CHECK); pCoreMenu->Append(IDM_JITLSOFF, _("&JIT LoadStore off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITLSLBZXOFF, _(" &JIT LoadStore lbzx off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITLSLXZOFF, _(" &JIT LoadStore lXz off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITLSLWZOFF, _("&JIT LoadStore lwz off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITLSFOFF, _("&JIT LoadStore Floating off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITLSPOFF, _("&JIT LoadStore Paired off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITFPOFF, _("&JIT FloatingPoint off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITIOFF, _("&JIT Integer off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITPOFF, _("&JIT Paired off"), wxEmptyString, wxITEM_CHECK); pCoreMenu->Append(IDM_JITSROFF, _("&JIT SystemRegisters off"), wxEmptyString, wxITEM_CHECK); pMenuBar->Append(pCoreMenu, _("&JIT")); // Debug Menu wxMenu* pDebugMenu = new wxMenu; pDebugMenu->Append(IDM_STEP, _("Step &Into\tF11")); pDebugMenu->Append(IDM_STEPOVER, _("Step &Over\tF10")); pDebugMenu->Append(IDM_TOGGLE_BREAKPOINT, _("Toggle &Breakpoint\tF9")); pDebugMenu->AppendSeparator(); wxMenu* pPerspectives = new wxMenu; Parent->m_SavedPerspectives = new wxMenu; pDebugMenu->AppendSubMenu(pPerspectives, _("Perspectives"), _("Edit Perspectives")); pPerspectives->Append(IDM_SAVE_PERSPECTIVE, _("Save perspectives"), _("Save currently-toggled perspectives")); pPerspectives->Append(IDM_EDIT_PERSPECTIVES, _("Edit perspectives"), _("Toggle editing of perspectives"), wxITEM_CHECK); pPerspectives->AppendSeparator(); pPerspectives->Append(IDM_ADD_PERSPECTIVE, _("Create new perspective")); pPerspectives->AppendSubMenu(Parent->m_SavedPerspectives, _("Saved perspectives")); Parent->PopulateSavedPerspectives(); pPerspectives->AppendSeparator(); pPerspectives->Append(IDM_PERSPECTIVES_ADD_PANE, _("Add new pane")); pPerspectives->Append(IDM_TAB_SPLIT, _("Tab split"), "", wxITEM_CHECK); pPerspectives->Append(IDM_NO_DOCKING, _("Disable docking"), "Disable docking of perspective panes to main window", wxITEM_CHECK); pMenuBar->Append(pDebugMenu, _("&Debug")); CreateMenuSymbols(pMenuBar); } void CCodeWindow::CreateMenuOptions(wxMenu* pMenu) { wxMenuItem* boottopause = pMenu->Append(IDM_BOOTTOPAUSE, _("Boot to pause"), _("Start the game directly instead of booting to pause"), wxITEM_CHECK); boottopause->Check(bBootToPause); wxMenuItem* automaticstart = pMenu->Append(IDM_AUTOMATICSTART, _("&Automatic start"), _( "Automatically load the Default ISO when Dolphin starts, or the last game you loaded," " if you have not given it an elf file with the --elf command line. [This can be" " convenient if you are bug-testing with a certain game and want to rebuild" " and retry it several times, either with changes to Dolphin or if you are" " developing a homebrew game.]"), wxITEM_CHECK); automaticstart->Check(bAutomaticStart); pMenu->Append(IDM_FONTPICKER, _("&Font...")); } // CPU Mode and JIT Menu void CCodeWindow::OnCPUMode(wxCommandEvent& event) { switch (event.GetId()) { case IDM_INTERPRETER: PowerPC::SetMode(UseInterpreter() ? PowerPC::MODE_INTERPRETER : PowerPC::MODE_JIT); break; case IDM_BOOTTOPAUSE: bBootToPause = !bBootToPause; return; case IDM_AUTOMATICSTART: bAutomaticStart = !bAutomaticStart; return; case IDM_JITOFF: Core::g_CoreStartupParameter.bJITOff = event.IsChecked(); break; case IDM_JITLSOFF: Core::g_CoreStartupParameter.bJITLoadStoreOff = event.IsChecked(); break; case IDM_JITLSLXZOFF: Core::g_CoreStartupParameter.bJITLoadStorelXzOff = event.IsChecked(); break; case IDM_JITLSLWZOFF: Core::g_CoreStartupParameter.bJITLoadStorelwzOff = event.IsChecked(); break; case IDM_JITLSLBZXOFF: Core::g_CoreStartupParameter.bJITLoadStorelbzxOff = event.IsChecked(); break; case IDM_JITLSFOFF: Core::g_CoreStartupParameter.bJITLoadStoreFloatingOff = event.IsChecked(); break; case IDM_JITLSPOFF: Core::g_CoreStartupParameter.bJITLoadStorePairedOff = event.IsChecked(); break; case IDM_JITFPOFF: Core::g_CoreStartupParameter.bJITFloatingPointOff = event.IsChecked(); break; case IDM_JITIOFF: Core::g_CoreStartupParameter.bJITIntegerOff = event.IsChecked(); break; case IDM_JITPOFF: Core::g_CoreStartupParameter.bJITPairedOff = event.IsChecked(); break; case IDM_JITSROFF: Core::g_CoreStartupParameter.bJITSystemRegistersOff = event.IsChecked(); break; } // Clear the JIT cache to enable these changes JitInterface::ClearCache(); // Update UpdateButtonStates(); } void CCodeWindow::OnJitMenu(wxCommandEvent& event) { switch (event.GetId()) { case IDM_LOGINSTRUCTIONS: PPCTables::LogCompiledInstructions(); break; case IDM_CLEARCODECACHE: JitInterface::ClearCache(); break; case IDM_SEARCHINSTRUCTION: { wxString str = wxGetTextFromUser("", _("Op?"), wxEmptyString, this); for (u32 addr = 0x80000000; addr < 0x80100000; addr += 4) { const char *name = PPCTables::GetInstructionName(Memory::ReadUnchecked_U32(addr)); auto const wx_name = WxStrToStr(str); if (name && (wx_name == name)) { NOTICE_LOG(POWERPC, "Found %s at %08x", wx_name.c_str(), addr); } } break; } } } // Shortcuts bool CCodeWindow::UseInterpreter() { return GetMenuBar()->IsChecked(IDM_INTERPRETER); } bool CCodeWindow::BootToPause() { return GetMenuBar()->IsChecked(IDM_BOOTTOPAUSE); } bool CCodeWindow::AutomaticStart() { return GetMenuBar()->IsChecked(IDM_AUTOMATICSTART); } bool CCodeWindow::JITNoBlockCache() { return GetMenuBar()->IsChecked(IDM_JITNOBLOCKCACHE); } bool CCodeWindow::JITBlockLinking() { return GetMenuBar()->IsChecked(IDM_JITBLOCKLINKING); } // Toolbar void CCodeWindow::InitBitmaps() { // load original size 48x48 m_Bitmaps[Toolbar_Step] = wxGetBitmapFromMemory(toolbar_add_breakpoint_png); m_Bitmaps[Toolbar_StepOver] = wxGetBitmapFromMemory(toolbar_add_memcheck_png); m_Bitmaps[Toolbar_Skip] = wxGetBitmapFromMemory(toolbar_add_memcheck_png); m_Bitmaps[Toolbar_GotoPC] = wxGetBitmapFromMemory(toolbar_add_memcheck_png); m_Bitmaps[Toolbar_SetPC] = wxGetBitmapFromMemory(toolbar_add_memcheck_png); // scale to 24x24 for toolbar for (auto& bitmap : m_Bitmaps) bitmap = wxBitmap(bitmap.ConvertToImage().Scale(24, 24)); } void CCodeWindow::PopulateToolbar(wxToolBar* toolBar) { int w = m_Bitmaps[0].GetWidth(), h = m_Bitmaps[0].GetHeight(); toolBar->SetToolBitmapSize(wxSize(w, h)); toolBar->AddTool(IDM_STEP, _("Step"), m_Bitmaps[Toolbar_Step]); toolBar->AddTool(IDM_STEPOVER, _("Step Over"), m_Bitmaps[Toolbar_StepOver]); toolBar->AddTool(IDM_SKIP, _("Skip"), m_Bitmaps[Toolbar_Skip]); toolBar->AddSeparator(); toolBar->AddTool(IDM_GOTOPC, _("Show PC"), m_Bitmaps[Toolbar_GotoPC]); toolBar->AddTool(IDM_SETPC, _("Set PC"), m_Bitmaps[Toolbar_SetPC]); toolBar->AddSeparator(); toolBar->AddControl(new wxTextCtrl(toolBar, IDM_ADDRBOX, "")); toolBar->Realize(); } // Update GUI void CCodeWindow::Update() { if (!codeview) return; codeview->Refresh(); UpdateCallstack(); UpdateButtonStates(); // Do not automatically show the current PC position when a breakpoint is hit or // when we pause since this can be called at other times too. //codeview->Center(PC); } void CCodeWindow::UpdateButtonStates() { bool Initialized = (Core::GetState() != Core::CORE_UNINITIALIZED); bool Pause = (Core::GetState() == Core::CORE_PAUSE); bool Stepping = CCPU::IsStepping(); wxToolBar* ToolBar = GetToolBar(); // Toolbar if (!ToolBar) return; if (!Initialized) { ToolBar->EnableTool(IDM_STEPOVER, false); ToolBar->EnableTool(IDM_SKIP, false); } else { if (!Stepping) { ToolBar->EnableTool(IDM_STEPOVER, false); ToolBar->EnableTool(IDM_SKIP, false); } else { ToolBar->EnableTool(IDM_STEPOVER, true); ToolBar->EnableTool(IDM_SKIP, true); } } ToolBar->EnableTool(IDM_STEP, Initialized && Stepping); ToolBar->Realize(); // Menu bar // ------------------ GetMenuBar()->Enable(IDM_INTERPRETER, Pause); // CPU Mode GetMenuBar()->Enable(IDM_JITNOBLOCKCACHE, !Initialized); GetMenuBar()->Enable(IDM_JITOFF, Pause); GetMenuBar()->Enable(IDM_JITLSOFF, Pause); GetMenuBar()->Enable(IDM_JITLSLXZOFF, Pause); GetMenuBar()->Enable(IDM_JITLSLWZOFF, Pause); GetMenuBar()->Enable(IDM_JITLSLBZXOFF, Pause); GetMenuBar()->Enable(IDM_JITLSFOFF, Pause); GetMenuBar()->Enable(IDM_JITLSPOFF, Pause); GetMenuBar()->Enable(IDM_JITFPOFF, Pause); GetMenuBar()->Enable(IDM_JITIOFF, Pause); GetMenuBar()->Enable(IDM_JITPOFF, Pause); GetMenuBar()->Enable(IDM_JITSROFF, Pause); GetMenuBar()->Enable(IDM_CLEARCODECACHE, Pause); // JIT Menu GetMenuBar()->Enable(IDM_SEARCHINSTRUCTION, Initialized); GetMenuBar()->Enable(IDM_CLEARSYMBOLS, Initialized); // Symbols menu GetMenuBar()->Enable(IDM_SCANFUNCTIONS, Initialized); GetMenuBar()->Enable(IDM_LOADMAPFILE, Initialized); GetMenuBar()->Enable(IDM_SAVEMAPFILE, Initialized); GetMenuBar()->Enable(IDM_SAVEMAPFILEWITHCODES, Initialized); GetMenuBar()->Enable(IDM_CREATESIGNATUREFILE, Initialized); GetMenuBar()->Enable(IDM_RENAME_SYMBOLS, Initialized); GetMenuBar()->Enable(IDM_USESIGNATUREFILE, Initialized); GetMenuBar()->Enable(IDM_PATCHHLEFUNCTIONS, Initialized); // Update Fonts callstack->SetFont(DebuggerFont); symbols->SetFont(DebuggerFont); callers->SetFont(DebuggerFont); calls->SetFont(DebuggerFont); }