1 //-----------------------------------------------------------------------------
2 // Copyright (C) 2010 Hector Martin "marcan" <marcan@marcansoft.com>
4 // This code is licensed to you under the terms of the GNU GPL, version 2 or,
5 // at your option, any later version. See the LICENSE.txt file for the text of
7 //-----------------------------------------------------------------------------
9 //-----------------------------------------------------------------------------
16 #include "proxmark3.h"
18 #include "util_posix.h"
21 #include "proxendian.h"
25 void SendCommand(UsbCommand
* txcmd
);
26 void ReceiveCommand(UsbCommand
* rxcmd
);
30 #define FLASH_START 0x100000
31 #define FLASH_SIZE (256*1024)
32 #define FLASH_END (FLASH_START + FLASH_SIZE)
33 #define BOOTLOADER_SIZE 0x2000
34 #define BOOTLOADER_END (FLASH_START + BOOTLOADER_SIZE)
36 #define BLOCK_SIZE 0x200
38 static const uint8_t elf_ident
[] = {
45 void CloseProxmark(const char *serial_port_name
) {
48 // Fix for linux, it seems that it is extremely slow to release the serial port file descriptor /dev/*
49 unlink(serial_port_name
);
52 bool OpenProxmark(size_t i
, const char *serial_port_name
) {
53 sp
= uart_open(serial_port_name
);
54 if (sp
== INVALID_SERIAL_PORT
|| sp
== CLAIMED_SERIAL_PORT
) {
62 // Turn PHDRs into flasher segments, checking for PHDR sanity and merging adjacent
63 // unaligned segments if needed
64 static int build_segs_from_phdrs(flash_file_t
*ctx
, FILE *fd
, Elf32_Phdr
*phdrs
, int num_phdrs
)
66 Elf32_Phdr
*phdr
= phdrs
;
68 uint32_t last_end
= 0;
70 ctx
->segments
= malloc(sizeof(flash_seg_t
) * num_phdrs
);
72 fprintf(stderr
, "Out of memory\n");
78 fprintf(stderr
, "Loading usable ELF segments:\n");
79 for (int i
= 0; i
< num_phdrs
; i
++) {
80 if (le32(phdr
->p_type
) != PT_LOAD
) {
84 uint32_t vaddr
= le32(phdr
->p_vaddr
);
85 uint32_t paddr
= le32(phdr
->p_paddr
);
86 uint32_t filesz
= le32(phdr
->p_filesz
);
87 uint32_t memsz
= le32(phdr
->p_memsz
);
88 uint32_t offset
= le32(phdr
->p_offset
);
89 uint32_t flags
= le32(phdr
->p_flags
);
94 fprintf(stderr
, "%d: V 0x%08x P 0x%08x (0x%08x->0x%08x) [%c%c%c] @0x%x\n",
95 i
, vaddr
, paddr
, filesz
, memsz
,
96 flags
& PF_R
? 'R' : ' ',
97 flags
& PF_W
? 'W' : ' ',
98 flags
& PF_X
? 'X' : ' ',
100 if (filesz
!= memsz
) {
101 fprintf(stderr
, "Error: PHDR file size does not equal memory size\n"
102 "(DATA+BSS PHDRs do not make sense on ROM platforms!)\n");
105 if (paddr
< last_end
) {
106 fprintf(stderr
, "Error: PHDRs not sorted or overlap\n");
109 if (paddr
< FLASH_START
|| (paddr
+filesz
) > FLASH_END
) {
110 fprintf(stderr
, "Error: PHDR is not contained in Flash\n");
113 if (vaddr
>= FLASH_START
&& vaddr
< FLASH_END
&& (flags
& PF_W
)) {
114 fprintf(stderr
, "Error: Flash VMA segment is writable\n");
119 // make extra space if we need to move the data forward
120 data
= malloc(filesz
+ BLOCK_SIZE
);
122 fprintf(stderr
, "Out of memory\n");
125 if (fseek(fd
, offset
, SEEK_SET
) < 0 || fread(data
, 1, filesz
, fd
) != filesz
) {
126 fprintf(stderr
, "Error while reading PHDR payload\n");
131 uint32_t block_offset
= paddr
& (BLOCK_SIZE
-1);
134 flash_seg_t
*prev_seg
= seg
- 1;
135 uint32_t this_end
= paddr
+ filesz
;
136 uint32_t this_firstblock
= paddr
& ~(BLOCK_SIZE
-1);
137 uint32_t prev_lastblock
= (last_end
- 1) & ~(BLOCK_SIZE
-1);
139 if (this_firstblock
== prev_lastblock
) {
140 uint32_t new_length
= this_end
- prev_seg
->start
;
141 uint32_t this_offset
= paddr
- prev_seg
->start
;
142 uint32_t hole
= this_offset
- prev_seg
->length
;
143 uint8_t *new_data
= malloc(new_length
);
145 fprintf(stderr
, "Out of memory\n");
149 memset(new_data
, 0xff, new_length
);
150 memcpy(new_data
, prev_seg
->data
, prev_seg
->length
);
151 memcpy(new_data
+ this_offset
, data
, filesz
);
152 fprintf(stderr
, "Note: Extending previous segment from 0x%x to 0x%x bytes\n",
153 prev_seg
->length
, new_length
);
155 fprintf(stderr
, "Note: 0x%x-byte hole created\n", hole
);
157 free(prev_seg
->data
);
158 prev_seg
->data
= new_data
;
159 prev_seg
->length
= new_length
;
165 fprintf(stderr
, "Warning: segment does not begin on a block boundary, will pad\n");
166 memmove(data
+ block_offset
, data
, filesz
);
167 memset(data
, 0xFF, block_offset
);
168 filesz
+= block_offset
;
169 paddr
-= block_offset
;
174 seg
->length
= filesz
;
178 last_end
= paddr
+ filesz
;
184 // Sanity check segments and check for bootloader writes
185 static int check_segs(flash_file_t
*ctx
, int can_write_bl
) {
186 for (int i
= 0; i
< ctx
->num_segs
; i
++) {
187 flash_seg_t
*seg
= &ctx
->segments
[i
];
189 if (seg
->start
& (BLOCK_SIZE
-1)) {
190 fprintf(stderr
, "Error: Segment is not aligned\n");
193 if (seg
->start
< FLASH_START
) {
194 fprintf(stderr
, "Error: Segment is outside of flash bounds\n");
197 if (seg
->start
+ seg
->length
> FLASH_END
) {
198 fprintf(stderr
, "Error: Segment is outside of flash bounds\n");
201 if (!can_write_bl
&& seg
->start
< BOOTLOADER_END
) {
202 fprintf(stderr
, "Attempted to write bootloader but bootloader writes are not enabled\n");
209 // Load an ELF file and prepare it for flashing
210 int flash_load(flash_file_t
*ctx
, const char *name
, int can_write_bl
)
214 Elf32_Phdr
*phdrs
= NULL
;
218 fd
= fopen(name
, "rb");
220 fprintf(stderr
, "Could not open file '%s': ", name
);
225 fprintf(stderr
, "Loading ELF file '%s'...\n", name
);
227 if (fread(&ehdr
, sizeof(ehdr
), 1, fd
) != 1) {
228 fprintf(stderr
, "Error while reading ELF file header\n");
231 if (memcmp(ehdr
.e_ident
, elf_ident
, sizeof(elf_ident
))
232 || le32(ehdr
.e_version
) != 1)
234 fprintf(stderr
, "Not an ELF file or wrong ELF type\n");
237 if (le16(ehdr
.e_type
) != ET_EXEC
) {
238 fprintf(stderr
, "ELF is not executable\n");
241 if (le16(ehdr
.e_machine
) != EM_ARM
) {
242 fprintf(stderr
, "Wrong ELF architecture\n");
245 if (!ehdr
.e_phnum
|| !ehdr
.e_phoff
) {
246 fprintf(stderr
, "ELF has no PHDRs\n");
249 if (le16(ehdr
.e_phentsize
) != sizeof(Elf32_Phdr
)) {
250 // could be a structure padding issue...
251 fprintf(stderr
, "Either the ELF file or this code is made of fail\n");
254 num_phdrs
= le16(ehdr
.e_phnum
);
256 phdrs
= malloc(le16(ehdr
.e_phnum
) * sizeof(Elf32_Phdr
));
258 fprintf(stderr
, "Out of memory\n");
261 if (fseek(fd
, le32(ehdr
.e_phoff
), SEEK_SET
) < 0) {
262 fprintf(stderr
, "Error while reading ELF PHDRs\n");
265 if (fread(phdrs
, sizeof(Elf32_Phdr
), num_phdrs
, fd
) != num_phdrs
) {
266 fprintf(stderr
, "Error while reading ELF PHDRs\n");
270 res
= build_segs_from_phdrs(ctx
, fd
, phdrs
, num_phdrs
);
273 res
= check_segs(ctx
, can_write_bl
);
279 ctx
->filename
= name
;
291 // Get the state of the proxmark, backwards compatible
292 static int get_proxmark_state(uint32_t *state
)
295 c
.cmd
= CMD_DEVICE_INFO
;
298 ReceiveCommand(&resp
);
301 // 1. The old bootrom code will ignore CMD_DEVICE_INFO, but respond with an ACK
302 // 2. The old os code will respond with CMD_DEBUG_PRINT_STRING and "unknown command"
303 // 3. The new bootrom and os codes will respond with CMD_DEVICE_INFO and flags
307 *state
= DEVICE_INFO_FLAG_CURRENT_MODE_BOOTROM
;
309 case CMD_DEBUG_PRINT_STRING
:
310 *state
= DEVICE_INFO_FLAG_CURRENT_MODE_OS
;
312 case CMD_DEVICE_INFO
:
313 *state
= resp
.arg
[0];
316 fprintf(stderr
, "Error: Couldn't get proxmark state, bad response type: 0x%04" PRIx64
"\n", resp
.cmd
);
324 // Enter the bootloader to be able to start flashing
325 static int enter_bootloader(char *serial_port_name
)
329 if (get_proxmark_state(&state
) < 0)
332 if (state
& DEVICE_INFO_FLAG_CURRENT_MODE_BOOTROM
) {
333 /* Already in flash state, we're done. */
337 if (state
& DEVICE_INFO_FLAG_CURRENT_MODE_OS
) {
338 fprintf(stderr
,"Entering bootloader...\n");
340 memset(&c
, 0, sizeof (c
));
342 if ((state
& DEVICE_INFO_FLAG_BOOTROM_PRESENT
)
343 && (state
& DEVICE_INFO_FLAG_OSIMAGE_PRESENT
))
345 // New style handover: Send CMD_START_FLASH, which will reset the board
346 // and enter the bootrom on the next boot.
347 c
.cmd
= CMD_START_FLASH
;
349 fprintf(stderr
,"(Press and release the button only to abort)\n");
351 // Old style handover: Ask the user to press the button, then reset the board
352 c
.cmd
= CMD_HARDWARE_RESET
;
354 fprintf(stderr
,"Press and hold down button NOW if your bootloader requires it.\n");
358 CloseProxmark(serial_port_name
);
360 fprintf(stderr
,"Waiting for Proxmark to reappear on %s",serial_port_name
);
363 fprintf(stderr
, ".");
364 } while (!OpenProxmark(0, serial_port_name
));
366 fprintf(stderr
," Found.\n");
371 fprintf(stderr
, "Error: Unknown Proxmark mode\n");
375 static int wait_for_ack(void)
378 ReceiveCommand(&ack
);
379 if (ack
.cmd
!= CMD_ACK
) {
380 printf("Error: Unexpected reply 0x%04" PRIx64
" (expected ACK)\n", ack
.cmd
);
386 // Go into flashing mode
387 int flash_start_flashing(int enable_bl_writes
,char *serial_port_name
)
391 if (enter_bootloader(serial_port_name
) < 0)
394 if (get_proxmark_state(&state
) < 0)
397 if (state
& DEVICE_INFO_FLAG_UNDERSTANDS_START_FLASH
) {
398 // This command is stupid. Why the heck does it care which area we're
399 // flashing, as long as it's not the bootloader area? The mind boggles.
400 UsbCommand c
= {CMD_START_FLASH
};
402 if (enable_bl_writes
) {
403 c
.arg
[0] = FLASH_START
;
404 c
.arg
[1] = FLASH_END
;
405 c
.arg
[2] = START_FLASH_MAGIC
;
407 c
.arg
[0] = BOOTLOADER_END
;
408 c
.arg
[1] = FLASH_END
;
412 return wait_for_ack();
414 fprintf(stderr
, "Note: Your bootloader does not understand the new START_FLASH command\n");
415 fprintf(stderr
, " It is recommended that you update your bootloader\n\n");
421 static int write_block(uint32_t address
, uint8_t *data
, uint32_t length
)
423 uint8_t block_buf
[BLOCK_SIZE
];
425 memset(block_buf
, 0xFF, BLOCK_SIZE
);
426 memcpy(block_buf
, data
, length
);
428 c
.cmd
= CMD_FINISH_WRITE
;
430 memcpy(c
.d
.asBytes
, block_buf
, length
);
432 return wait_for_ack();
435 // Write a file's segments to Flash
436 int flash_write(flash_file_t
*ctx
)
438 fprintf(stderr
, "Writing segments for file: %s\n", ctx
->filename
);
439 for (int i
= 0; i
< ctx
->num_segs
; i
++) {
440 flash_seg_t
*seg
= &ctx
->segments
[i
];
442 uint32_t length
= seg
->length
;
443 uint32_t blocks
= (length
+ BLOCK_SIZE
- 1) / BLOCK_SIZE
;
444 uint32_t end
= seg
->start
+ length
;
446 fprintf(stderr
, " 0x%08x..0x%08x [0x%x / %d blocks]",
447 seg
->start
, end
- 1, length
, blocks
);
450 uint8_t *data
= seg
->data
;
451 uint32_t baddr
= seg
->start
;
454 uint32_t block_size
= length
;
455 if (block_size
> BLOCK_SIZE
)
456 block_size
= BLOCK_SIZE
;
458 if (write_block(baddr
, data
, block_size
) < 0) {
459 fprintf(stderr
, " ERROR\n");
460 fprintf(stderr
, "Error writing block %d of %d\n", block
, blocks
);
466 length
-= block_size
;
468 fprintf(stderr
, ".");
470 fprintf(stderr
, " OK\n");
475 // free a file context
476 void flash_free(flash_file_t
*ctx
)
481 for (int i
= 0; i
< ctx
->num_segs
; i
++)
482 free(ctx
->segments
[i
].data
);
484 ctx
->segments
= NULL
;
489 // just reset the unit
490 int flash_stop_flashing(void) {
491 UsbCommand c
= {CMD_HARDWARE_RESET
};