// Copyright (c) 2018- PPSSPP Project. // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, version 2.0 or later versions. // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License 2.0 for more details. // A copy of the GPL 2.0 should have been included with the program. // If not, see http://www.gnu.org/licenses/ // Official git repository and contact information can be found at // https://github.com/hrydgard/ppsspp and http://www.ppsspp.org/. #include #include "Common/Data/Encoding/Base64.h" #include "Common/StringUtils.h" #include "Core/MemMap.h" #include "Core/MIPS/MIPSDebugInterface.h" #include "Core/System.h" #include "Core/Debugger/WebSocket/MemorySubscriber.h" #include "Core/Debugger/WebSocket/WebSocketUtils.h" DebuggerSubscriber *WebSocketMemoryInit(DebuggerEventHandlerMap &map) { // No need to bind or alloc state, these are all global. map["memory.read_u8"] = &WebSocketMemoryReadU8; map["memory.read_u16"] = &WebSocketMemoryReadU16; map["memory.read_u32"] = &WebSocketMemoryReadU32; map["memory.read"] = &WebSocketMemoryRead; map["memory.write_u8"] = &WebSocketMemoryWriteU8; map["memory.write_u16"] = &WebSocketMemoryWriteU16; map["memory.write_u32"] = &WebSocketMemoryWriteU32; map["memory.write"] = &WebSocketMemoryWrite; return nullptr; } // Read a byte from memory (memory.read_u8) // // Parameters: // - address: unsigned integer // // Response (same event name): // - value: unsigned integer void WebSocketMemoryReadU8(DebuggerRequest &req) { auto memLock = Memory::Lock(); if (!currentDebugMIPS->isAlive() || !Memory::IsActive()) return req.Fail("CPU not started"); uint32_t addr; if (!req.ParamU32("address", &addr, false)) { return; } if (!Memory::IsValidAddress(addr)) { req.Fail("Invalid address"); return; } JsonWriter &json = req.Respond(); json.writeUint("value", Memory::Read_U8(addr)); } // Read two bytes from memory (memory.read_u16) // // Parameters: // - address: unsigned integer // // Response (same event name): // - value: unsigned integer void WebSocketMemoryReadU16(DebuggerRequest &req) { auto memLock = Memory::Lock(); if (!currentDebugMIPS->isAlive() || !Memory::IsActive()) return req.Fail("CPU not started"); uint32_t addr; if (!req.ParamU32("address", &addr, false)) { return; } if (!Memory::IsValidAddress(addr)) { req.Fail("Invalid address"); return; } JsonWriter &json = req.Respond(); json.writeUint("value", Memory::Read_U16(addr)); } // Read four bytes from memory (memory.read_u32) // // Parameters: // - address: unsigned integer // // Response (same event name): // - value: unsigned integer void WebSocketMemoryReadU32(DebuggerRequest &req) { auto memLock = Memory::Lock(); if (!currentDebugMIPS->isAlive() || !Memory::IsActive()) return req.Fail("CPU not started"); uint32_t addr; if (!req.ParamU32("address", &addr, false)) { return; } if (!Memory::IsValidAddress(addr)) { req.Fail("Invalid address"); return; } JsonWriter &json = req.Respond(); json.writeUint("value", Memory::Read_U32(addr)); } // Read bytes from memory (memory.read) // // Parameters: // - address: unsigned integer address for the start of the memory range. // - size: unsigned integer specifying size of memory range. // // Response (same event name): // - base64: base64 encode of binary data. void WebSocketMemoryRead(DebuggerRequest &req) { auto memLock = Memory::Lock(); if (!currentDebugMIPS->isAlive() || !Memory::IsActive()) return req.Fail("CPU not started"); uint32_t addr; if (!req.ParamU32("address", &addr)) { return; } uint32_t size; if (!req.ParamU32("size", &size)) { return; } if (!Memory::IsValidAddress(addr)) { return req.Fail("Invalid address"); } else if (!Memory::IsValidRange(addr, size)) { return req.Fail("Invalid size"); } JsonWriter &json = req.Respond(); // Start a value without any actual data yet... json.writeRaw("base64", ""); req.Flush(); // Now we'll write it directly to the stream. req.ws->AddFragment(false, "\""); // 65535 is an "even" number of base64 characters. static const size_t CHUNK_SIZE = 65535; for (size_t i = 0; i < size; i += CHUNK_SIZE) { size_t left = std::min(size - i, CHUNK_SIZE); req.ws->AddFragment(false, Base64Encode(Memory::GetPointerUnchecked(addr) + i, left)); } req.ws->AddFragment(false, "\""); } // Write a byte to memory (memory.write_u8) // // Parameters: // - address: unsigned integer // - value: unsigned integer // // Response (same event name): // - value: new value, unsigned integer void WebSocketMemoryWriteU8(DebuggerRequest &req) { auto memLock = Memory::Lock(); if (!currentDebugMIPS->isAlive() || !Memory::IsActive()) return req.Fail("CPU not started"); uint32_t addr, val; if (!req.ParamU32("address", &addr, false)) { return; } if (!req.ParamU32("value", &val, false)) { return; } if (!Memory::IsValidAddress(addr)) { req.Fail("Invalid address"); return; } Memory::Write_U8(val, addr); JsonWriter &json = req.Respond(); json.writeUint("value", Memory::Read_U8(addr)); } // Write two bytes to memory (memory.write_u16) // // Parameters: // - address: unsigned integer // - value: unsigned integer // // Response (same event name): // - value: new value, unsigned integer void WebSocketMemoryWriteU16(DebuggerRequest &req) { auto memLock = Memory::Lock(); if (!currentDebugMIPS->isAlive() || !Memory::IsActive()) return req.Fail("CPU not started"); uint32_t addr, val; if (!req.ParamU32("address", &addr, false)) { return; } if (!req.ParamU32("value", &val, false)) { return; } if (!Memory::IsValidAddress(addr)) { req.Fail("Invalid address"); return; } Memory::Write_U16(val, addr); JsonWriter &json = req.Respond(); json.writeUint("value", Memory::Read_U16(addr)); } // Write four bytes to memory (memory.write_u32) // // Parameters: // - address: unsigned integer // - value: unsigned integer // // Response (same event name): // - value: new value, unsigned integer void WebSocketMemoryWriteU32(DebuggerRequest &req) { auto memLock = Memory::Lock(); if (!currentDebugMIPS->isAlive() || !Memory::IsActive()) return req.Fail("CPU not started"); uint32_t addr, val; if (!req.ParamU32("address", &addr, false)) { return; } if (!req.ParamU32("value", &val, false)) { return; } if (!Memory::IsValidAddress(addr)) { req.Fail("Invalid address"); return; } Memory::Write_U32(val, addr); JsonWriter &json = req.Respond(); json.writeUint("value", Memory::Read_U32(addr)); } // Write bytes to memory (memory.write) // // Parameters: // - address: unsigned integer address for the start of the memory range. // - base64: data to write, encoded as base64 string // // Response (same event name) with no extra data. void WebSocketMemoryWrite(DebuggerRequest &req) { auto memLock = Memory::Lock(); if (!currentDebugMIPS->isAlive() || !Memory::IsActive()) return req.Fail("CPU not started"); uint32_t addr; if (!req.ParamU32("address", &addr)) { return; } std::string encoded; if (!req.ParamString("base64", &encoded)) { return; } std::vector value = Base64Decode(&encoded[0], encoded.size()); uint32_t size = (uint32_t)value.size(); if (!Memory::IsValidAddress(addr)) { return req.Fail("Invalid address"); } else if (value.size() != (size_t)size || !Memory::IsValidRange(addr, size)) { return req.Fail("Invalid size"); } Memory::MemcpyUnchecked(addr, &value[0], size); req.Respond(); }