Adding processor flash memory reading, viewing and writing to file.
Works when the device is running either osimage or bootloader. - New memory reading command in osimage and bootloader. - Extended 'hw readmem' command with length parameter, file writing and hex viewer. - Introduced '--dumpmem' option to proxmark3 executable to support dumping from bootloader. Simple interactive examples: hw readmem -f flashdump hw readmem -l 1024 CLI example: ./pm3 --dumpmem flashdump.bin Reading from arbitrary memory ranges can be unlocked using the 'raw' option.
This commit is contained in:
1 parent
c6adda54ed
commit
e35385fde1
10 files changed
+386
-12
No files matched your search
+51
-8
@@ -633,20 +633,63 @@ static int CmdLCDReset(const char *Cmd) {
|
||||
static int CmdReadmem(const char *Cmd) {
|
||||
CLIParserContext *ctx;
|
||||
CLIParserInit(&ctx, "hw readmem",
|
||||
"Read memory at decimal address from ARM chip flash.",
|
||||
"hw readmem -a 10000"
|
||||
"Reads processor flash memory into a file or views on console",
|
||||
"hw readmem -f myfile -> save 512KB processor flash memory to file\n"
|
||||
"hw readmem -a 8192 -l 512 -> display 512 bytes from offset 8192\n"
|
||||
);
|
||||
|
||||
void *argtable[] = {
|
||||
arg_param_begin,
|
||||
arg_u64_1("a", "adr", "<dec>", "address to read"),
|
||||
arg_int0("a", "adr", "<dec>", "flash address to start reading from"),
|
||||
arg_int0("l", "len", "<dec>", "length (default 32 or 512KB)"),
|
||||
arg_str0("f", "file", "<fn>", "save to file"),
|
||||
arg_int0("c", "cols", "<dec>", "column breaks"),
|
||||
arg_lit0("r", "raw", "use raw address mode: read from anywhere, not just flash"),
|
||||
arg_param_end
|
||||
};
|
||||
CLIExecWithReturn(ctx, Cmd, argtable, true);
|
||||
uint32_t address = arg_get_u32(ctx, 1);
|
||||
CLIExecWithReturn(ctx, Cmd, argtable, false);
|
||||
|
||||
// check for -file option first to determine the output mode
|
||||
int fnlen = 0;
|
||||
char filename[FILE_PATH_SIZE] = {0};
|
||||
CLIParamStrToBuf(arg_get_str(ctx, 3), (uint8_t *)filename, FILE_PATH_SIZE, &fnlen);
|
||||
bool save_to_file = fnlen > 0;
|
||||
|
||||
// default len to 512KB when saving to file, to 32 bytes when viewing on the console.
|
||||
uint32_t default_len = save_to_file ? 512*1024 : 32;
|
||||
|
||||
uint32_t address = arg_get_u32_def(ctx, 1, 0);
|
||||
uint32_t len = arg_get_u32_def(ctx, 2, default_len);
|
||||
int breaks = arg_get_int_def(ctx, 4, 32);
|
||||
bool raw = arg_get_lit(ctx, 5);
|
||||
CLIParserFree(ctx);
|
||||
clearCommandBuffer();
|
||||
SendCommandNG(CMD_READ_MEM, (uint8_t *)&address, sizeof(address));
|
||||
|
||||
uint8_t *buffer = calloc(len, sizeof(uint8_t));
|
||||
if (!buffer) {
|
||||
PrintAndLogEx(ERR, "error, cannot allocate memory ");
|
||||
return PM3_EMALLOC;
|
||||
}
|
||||
|
||||
const char *flash_str = raw ? "" : " flash";
|
||||
PrintAndLogEx(INFO, "reading "_YELLOW_("%u")" bytes from processor%s memory",
|
||||
len, flash_str);
|
||||
|
||||
DeviceMemType_t type = raw ? MCU_MEM : MCU_FLASH;
|
||||
if (!GetFromDevice(type, buffer, len, address, NULL, 0, NULL, -1, true)) {
|
||||
PrintAndLogEx(FAILED, "ERROR; reading from MCU flash memory");
|
||||
free(buffer);
|
||||
return PM3_EFLASH;
|
||||
}
|
||||
|
||||
if (save_to_file) {
|
||||
PrintAndLogEx(INFO, "saving to "_YELLOW_("%s"), filename);
|
||||
saveFile(filename, ".bin", buffer, len);
|
||||
} else {
|
||||
PrintAndLogEx(INFO, "---- " _CYAN_("processor%s memory") " ----", flash_str);
|
||||
print_hex_break(buffer, len, breaks);
|
||||
}
|
||||
|
||||
free(buffer);
|
||||
return PM3_SUCCESS;
|
||||
}
|
||||
|
||||
@@ -1150,7 +1193,7 @@ static command_t CommandTable[] = {
|
||||
{"lcd", CmdLCD, IfPm3Lcd, "Send command/data to LCD"},
|
||||
{"lcdreset", CmdLCDReset, IfPm3Lcd, "Hardware reset LCD"},
|
||||
{"ping", CmdPing, IfPm3Present, "Test if the Proxmark3 is responsive"},
|
||||
{"readmem", CmdReadmem, IfPm3Present, "Read memory at decimal address from flash"},
|
||||
{"readmem", CmdReadmem, IfPm3Present, "Read from processor flash"},
|
||||
{"reset", CmdReset, IfPm3Present, "Reset the Proxmark3"},
|
||||
{"setlfdivisor", CmdSetDivisor, IfPm3Present, "Drive LF antenna at 12MHz / (divisor + 1)"},
|
||||
{"setmux", CmdSetMux, IfPm3Present, "Set the ADC mux to a specific value"},
|
||||
|
||||
@@ -1134,6 +1134,12 @@ bool GetFromDevice(DeviceMemType_t memtype, uint8_t *dest, uint32_t bytes, uint3
|
||||
SendCommandNG(CMD_FPGAMEM_DOWNLOAD, NULL, 0);
|
||||
return dl_it(dest, bytes, response, ms_timeout, show_warning, CMD_FPGAMEM_DOWNLOADED);
|
||||
}
|
||||
case MCU_FLASH:
|
||||
case MCU_MEM: {
|
||||
uint32_t flags = memtype == MCU_MEM ? CMD_READ_MEM_DOWNLOAD_RAW : 0;
|
||||
SendCommandBL(CMD_READ_MEM_DOWNLOAD, start_index, bytes, flags, NULL, 0);
|
||||
return dl_it(dest, bytes, response, ms_timeout, show_warning, CMD_READ_MEM_DOWNLOADED);
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
@@ -54,6 +54,8 @@ typedef enum {
|
||||
SIM_MEM,
|
||||
SPIFFS,
|
||||
FPGA_MEM,
|
||||
MCU_FLASH,
|
||||
MCU_MEM,
|
||||
} DeviceMemType_t;
|
||||
|
||||
typedef enum {
|
||||
|
||||
+157
-1
@@ -636,6 +636,11 @@ static void show_help(bool showFullHelp, char *exec_name) {
|
||||
PrintAndLogEx(NORMAL, " --unlock-bootloader Enable flashing of bootloader area *DANGEROUS* (need --flash)");
|
||||
PrintAndLogEx(NORMAL, " --force Enable flashing even if firmware seems to not match client version");
|
||||
PrintAndLogEx(NORMAL, " --image <imagefile> image to flash. Can be specified several times.");
|
||||
PrintAndLogEx(NORMAL, "\nOptions in memory dump mode:");
|
||||
PrintAndLogEx(NORMAL, " --dumpmem <dumpfile> dumps Proxmark3 flash memory to file");
|
||||
PrintAndLogEx(NORMAL, " --dumpaddr <address> starting address for dump, default 0");
|
||||
PrintAndLogEx(NORMAL, " --dumplen <length> number of bytes to dump, default 512KB");
|
||||
PrintAndLogEx(NORMAL, " --dumpraw raw address mode: dump from anywhere, not just flash");
|
||||
PrintAndLogEx(NORMAL, "\nExamples:");
|
||||
PrintAndLogEx(NORMAL, "\n to run Proxmark3 client:\n");
|
||||
PrintAndLogEx(NORMAL, " %s "SERIAL_PORT_EXAMPLE_H" -- runs the pm3 client", exec_name);
|
||||
@@ -660,6 +665,109 @@ static void show_help(bool showFullHelp, char *exec_name) {
|
||||
}
|
||||
}
|
||||
|
||||
static int dumpmem_to_file(const char *filename, uint32_t addr, uint32_t len, bool raw, bool in_bootloader) {
|
||||
int res = PM3_EUNDEF;
|
||||
|
||||
uint8_t *buffer = calloc(len, sizeof(uint8_t));
|
||||
if (!buffer) {
|
||||
PrintAndLogEx(ERR, "error, cannot allocate memory ");
|
||||
res = PM3_EMALLOC;
|
||||
goto fail;
|
||||
}
|
||||
|
||||
size_t read = 0;
|
||||
DeviceMemType_t type = raw ? MCU_MEM : MCU_FLASH;
|
||||
if (GetFromDevice(type, buffer, len, addr, NULL, 0, NULL, 1000, true)) {
|
||||
res = PM3_SUCCESS;
|
||||
read = len; // GetFromDevice does not report the actual number of bytes received.
|
||||
}
|
||||
|
||||
if (res == PM3_SUCCESS) {
|
||||
FILE *fd = fopen(filename, "wb");
|
||||
if (!fd) {
|
||||
PrintAndLogEx(ERR, _RED_("Could not open file") " %s >>> ", filename);
|
||||
res = PM3_EFILE;
|
||||
goto fail2;
|
||||
}
|
||||
fwrite(buffer, 1, read, fd);
|
||||
fclose(fd);
|
||||
}
|
||||
|
||||
fail2:
|
||||
free(buffer);
|
||||
fail:
|
||||
return res;
|
||||
}
|
||||
|
||||
static int dumpmem_pm3(char *serial_port_name, const char *filename, uint32_t addr, uint32_t len, bool raw) {
|
||||
int ret = PM3_EUNDEF;
|
||||
bool in_bootloader = false;
|
||||
|
||||
if (serial_port_name == NULL) {
|
||||
PrintAndLogEx(ERR, "You must specify a port.\n");
|
||||
return PM3_EINVARG;
|
||||
}
|
||||
|
||||
if (OpenProxmark(&g_session.current_device, serial_port_name, true, 60, true, FLASHMODE_SPEED)) {
|
||||
PrintAndLogEx(NORMAL, _GREEN_(" found"));
|
||||
msleep(200);
|
||||
} else {
|
||||
PrintAndLogEx(ERR, "Could not find Proxmark3 on " _RED_("%s") ".\n", serial_port_name);
|
||||
ret = PM3_ETIMEOUT;
|
||||
goto finish;
|
||||
}
|
||||
|
||||
// Determine if we're talking to a bootloader or main firmware.
|
||||
SendCommandBL(CMD_DEVICE_INFO, 0, 0, 0, NULL, 0);
|
||||
PacketResponseNG resp;
|
||||
if (WaitForResponseTimeout(CMD_UNKNOWN, &resp, 1000) == false) {
|
||||
PrintAndLogEx(ERR, "Could not get device info.");
|
||||
goto finish2;
|
||||
}
|
||||
uint32_t dev_info = resp.oldarg[0];
|
||||
in_bootloader = (dev_info & DEVICE_INFO_FLAG_CURRENT_MODE_BOOTROM) != 0;
|
||||
if (in_bootloader) {
|
||||
if ((dev_info & DEVICE_INFO_FLAG_UNDERSTANDS_READ_MEM) != 0) {
|
||||
PrintAndLogEx(INFO, "Device is running the bootloader.");
|
||||
}
|
||||
else {
|
||||
PrintAndLogEx(ERR, "Device is running the bootloader, but the bootloader"
|
||||
" doesn't understand the READ MEM command.");
|
||||
goto finish2;
|
||||
}
|
||||
}
|
||||
|
||||
PrintAndLogEx(SUCCESS,"Dump requested from address "_YELLOW_("%u")", length "_YELLOW_("%u")"%s.",
|
||||
addr, len, raw ? ", in raw address mode" : "");
|
||||
|
||||
PrintAndLogEx(SUCCESS, _CYAN_("Memory dumping to file..."));
|
||||
ret = dumpmem_to_file(filename, addr, len, raw, in_bootloader);
|
||||
if (ret != PM3_SUCCESS) {
|
||||
goto finish2;
|
||||
}
|
||||
PrintAndLogEx(NORMAL, "");
|
||||
|
||||
finish2:
|
||||
clearCommandBuffer();
|
||||
if (in_bootloader) {
|
||||
g_session.current_device->g_conn->run = false;
|
||||
SendCommandOLD(CMD_PING, 0, 0, 0, NULL, 0);
|
||||
} else {
|
||||
SendCommandNG(CMD_QUIT_SESSION, NULL, 0);
|
||||
msleep(100);
|
||||
}
|
||||
CloseProxmark(g_session.current_device);
|
||||
|
||||
finish:
|
||||
if (ret == PM3_SUCCESS)
|
||||
PrintAndLogEx(SUCCESS, _CYAN_("All done"));
|
||||
else if (ret == PM3_EOPABORTED)
|
||||
PrintAndLogEx(FAILED, "Aborted by user");
|
||||
else
|
||||
PrintAndLogEx(ERR, "Aborted on error %u", ret);
|
||||
return ret;
|
||||
}
|
||||
|
||||
static int flash_pm3(char *serial_port_name, uint8_t num_files, const char *filenames[FLASH_MAX_FILES], bool can_write_bl, bool force) {
|
||||
|
||||
int ret = PM3_EUNDEF;
|
||||
@@ -812,6 +920,11 @@ int main(int argc, char *argv[]) {
|
||||
bool debug_mode_forced = false;
|
||||
int flash_num_files = 0;
|
||||
const char *flash_filenames[FLASH_MAX_FILES];
|
||||
bool dumpmem_mode = false;
|
||||
const char *dumpmem_filename = NULL;
|
||||
uint32_t dumpmem_addr = 0;
|
||||
uint32_t dumpmem_len = 512*1024;
|
||||
bool dumpmem_raw = false;
|
||||
|
||||
// color management:
|
||||
// 1. default = no color
|
||||
@@ -1013,6 +1126,44 @@ int main(int argc, char *argv[]) {
|
||||
continue;
|
||||
}
|
||||
|
||||
// go to dump mode
|
||||
if (strcmp(argv[i], "--dumpmem") == 0) {
|
||||
dumpmem_mode = true;
|
||||
if (i + 1 == argc) {
|
||||
PrintAndLogEx(ERR, _RED_("ERROR:") " missing file specification after --dumpmem\n");
|
||||
show_help(false, exec_name);
|
||||
return 1;
|
||||
}
|
||||
dumpmem_filename = argv[++i];
|
||||
continue;
|
||||
}
|
||||
if (strcmp(argv[i], "--dumpaddr") == 0) {
|
||||
if (i + 1 == argc) {
|
||||
PrintAndLogEx(ERR, _RED_("ERROR:") " missing address specification after -dumpaddr\n");
|
||||
show_help(false, exec_name);
|
||||
return 1;
|
||||
}
|
||||
uint32_t tmpaddr = strtol(argv[i + 1], NULL, 10);
|
||||
dumpmem_addr = tmpaddr;
|
||||
i++;
|
||||
continue;
|
||||
}
|
||||
if (strcmp(argv[i], "--dumplen") == 0) {
|
||||
if (i + 1 == argc) {
|
||||
PrintAndLogEx(ERR, _RED_("ERROR:") " missing address specification after -dumplen\n");
|
||||
show_help(false, exec_name);
|
||||
return 1;
|
||||
}
|
||||
uint32_t tmplen = strtol(argv[i + 1], NULL, 10);
|
||||
dumpmem_len = tmplen;
|
||||
i++;
|
||||
continue;
|
||||
}
|
||||
if (strcmp(argv[i], "--dumpraw") == 0) {
|
||||
dumpmem_raw = true;
|
||||
continue;
|
||||
}
|
||||
|
||||
// go to flash mode
|
||||
if (strcmp(argv[i], "--flash") == 0) {
|
||||
flash_mode = true;
|
||||
@@ -1094,6 +1245,11 @@ int main(int argc, char *argv[]) {
|
||||
if (speed == 0)
|
||||
speed = USART_BAUD_RATE;
|
||||
|
||||
if (dumpmem_mode) {
|
||||
dumpmem_pm3(port, dumpmem_filename, dumpmem_addr, dumpmem_len, dumpmem_raw);
|
||||
exit(EXIT_SUCCESS);
|
||||
}
|
||||
|
||||
if (flash_mode) {
|
||||
flash_pm3(port, flash_num_files, flash_filenames, flash_can_write_bl, flash_force);
|
||||
exit(EXIT_SUCCESS);
|
||||
@@ -1148,7 +1304,7 @@ int main(int argc, char *argv[]) {
|
||||
}
|
||||
|
||||
// ascii art only in interactive client
|
||||
if (!script_cmds_file && !script_cmd && g_session.stdinOnTTY && g_session.stdoutOnTTY && !flash_mode && !reboot_bootloader_mode) {
|
||||
if (!script_cmds_file && !script_cmd && g_session.stdinOnTTY && g_session.stdoutOnTTY && !dumpmem_mode && !flash_mode && !reboot_bootloader_mode) {
|
||||
showBanner();
|
||||
}
|
||||
|
||||
|
||||
Reference in new issue
Block a user