#!/usr/bin/env python3 import os, sys, struct, time from serial import Serial class MTreader: def __init__(self, devfile): while True: try: self.s = Serial(devfile, 115200, rtscts=True, dsrdtr=True) sys.stdout.write('\n') break except OSError as e: sys.stdout.write('.') sys.stdout.flush() time.sleep(0.1) def send(self, data, sz = 0): r = '' if len(data): self.s.write(data) if sz > 0: r = self.s.read(sz) return r def cmd(self, cmd, sz = 0): r = '' cmdlen = len(cmd) if cmdlen > 0: assert(self.send(cmd, cmdlen) == cmd) if sz > 0: r = self.s.read(sz) return r def read16(self, addr, sz=1, endianness='>'): r = self.cmd(b'\xA2' + struct.pack('>II', addr, sz), sz*2) return struct.unpack(endianness + sz * 'H', r) def write16(self, addr, val): r = self.cmd(b'\xD2' + struct.pack('>II', addr, 1), 2) assert(r == b'\0\1') r = self.cmd(struct.pack('>H', val), 2) assert(r == b'\0\1') def read32(self, addr, sz=1, endianness='>'): r = self.cmd(b'\xD1' + struct.pack('>LL', addr, sz), (sz*4) + 4) return struct.unpack(endianness + 'H' + (sz*'L') + 'H', r) def write32(self, addr, val): r = self.cmd(b'\xD4' + struct.pack('>LL', addr, 1), 2) assert(r == b'\0\1') r = self.cmd(struct.pack('>L', val), 2) assert(r == b'\0\1') def connect(self, timeout = 0.1): self.s.timeout = timeout while True: r = self.send(b'\xA0', 1) if r == b'\x5F': break r = self.send(b'\x0A\x50\x05', 3) assert(r == b'\xF5\xAF\xFA') self.chip = self.read16(0x80000008)[0] self.write16(0xa0030000, 0x2200) # disable system watchdog self.write16(0xa0700a28, 0x8000) # enable USB download mode self.write16(0xa0700a24, 2) # disable battery watchdog self.write32(0xa0510000, 2) # enter memory map mode 2 to map ROM from the start of RAM def read_flash(self, outfile, addr, size, blk_size=1024): outf = open(outfile, 'wb') while size > 0: rsize = min(size, blk_size) chunk = self.read32(addr, rsize>>2, '<') outchunk = struct.pack('>' + (len(chunk) - 2)*'L', *chunk[1:-1]) size -= rsize addr += rsize outf.write(outchunk) sys.stdout.write('.') sys.stdout.flush() outf.close() def reset(self): self.write16(0xa003001c, 0x1209) def auto_int(x): return int(x,0) if __name__ == '__main__': # main app start from argparse import ArgumentParser parser = ArgumentParser(description='MTreader: a simple, no-nonsense MediaTek MT626x phone ROM reader', epilog='(c) Luxferre 2020 --- No rights reserved ') parser.add_argument('port', help='Serial port to connect to (/dev/ttyUSB0, /dev/tty.usbmodem14100 etc.)') parser.add_argument('file', help='File to write the dump into') parser.add_argument('start', type=auto_int, help='start position (in the phone flash memory)') parser.add_argument('length', type=auto_int, help='data length') parser.add_argument('-bs','--block-size', type=int, default=1024, help='Readback block size (in bytes), defaults to 1024') args = parser.parse_args() if(args.length < 1): print('Zero length of data, exiting') exit(1) print('Turn the phone off, hold the boot key and connect the cable') m = MTreader(args.port) print('Sending BROM handshake...') m.connect() print('Connected, chip ID: %04x' % m.chip) print('Dumping, do not disconnect...') m.read_flash(args.file, args.start, args.length, args.block_size) print('\nROM dumped, disconnect the cable') m.reset()