From 237ed14d2855a7eae7c039c4066c3b2e0254017a Mon Sep 17 00:00:00 2001 From: bunnie Date: Fri, 22 Jul 2022 19:06:13 +0800 Subject: [PATCH] finalize renaming so we don't have to deal with _ vs - ambiguities --- .../precursorupdater-0.0.1-py3-none-any.whl | Bin 0 -> 18287 bytes .../dist/precursorupdater-0.0.1.tar.gz | Bin 0 -> 18627 bytes .../precursorupdater.egg-info/PKG-INFO | 230 ++++++++++ .../precursorupdater.egg-info/SOURCES.txt | 14 + .../dependency_links.txt | 1 + .../entry_points.txt | 2 + .../precursorupdater.egg-info/requires.txt | 3 + .../precursorupdater.egg-info/top_level.txt | 1 + .../precursorupdater/precursorusb/__init__.py | 0 .../__pycache__/__init__.cpython-38.pyc | Bin 0 -> 187 bytes .../__pycache__/__init__.cpython-39.pyc | Bin 0 -> 184 bytes .../__pycache__/precursorusb.cpython-38.pyc | Bin 0 -> 10094 bytes .../__pycache__/precursorusb.cpython-39.pyc | Bin 0 -> 10087 bytes .../precursorusb/precursorusb.py | 407 ++++++++++++++++++ tools/updater/setup.py | 3 + 15 files changed, 661 insertions(+) create mode 100644 tools/updater/dist/precursorupdater-0.0.1-py3-none-any.whl create mode 100644 tools/updater/dist/precursorupdater-0.0.1.tar.gz create mode 100644 tools/updater/precursorupdater.egg-info/PKG-INFO create mode 100644 tools/updater/precursorupdater.egg-info/SOURCES.txt create mode 100644 tools/updater/precursorupdater.egg-info/dependency_links.txt create mode 100644 tools/updater/precursorupdater.egg-info/entry_points.txt create mode 100644 tools/updater/precursorupdater.egg-info/requires.txt create mode 100644 tools/updater/precursorupdater.egg-info/top_level.txt create mode 100644 tools/updater/precursorupdater/precursorusb/__init__.py create mode 100644 tools/updater/precursorupdater/precursorusb/__pycache__/__init__.cpython-38.pyc create mode 100644 tools/updater/precursorupdater/precursorusb/__pycache__/__init__.cpython-39.pyc create mode 100644 tools/updater/precursorupdater/precursorusb/__pycache__/precursorusb.cpython-38.pyc create mode 100644 tools/updater/precursorupdater/precursorusb/__pycache__/precursorusb.cpython-39.pyc create mode 100644 tools/updater/precursorupdater/precursorusb/precursorusb.py create mode 100644 tools/updater/setup.py diff --git a/tools/updater/dist/precursorupdater-0.0.1-py3-none-any.whl b/tools/updater/dist/precursorupdater-0.0.1-py3-none-any.whl new file mode 100644 index 0000000000000000000000000000000000000000..2167aee7721861026fdcbca44272b1add75820a9 GIT binary patch literal 18287 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.8 +Description-Content-Type: text/markdown +License-File: LICENSE + +# Precursor Updater + +This script automatically updates a Precursor device. Please run with `--help` to see +all the available options. By default, the script will attempt to load the latest stable release onto a Precursor device that is attached to the host via USB. + +When the script is finished running, you will need to reset the device by pressing on the +switch inside the hole in the lower right hand side of the case. See https://ci.betrusted.io/i/reset.jpg for an example of how to do this. + +See our [troubleshooting](https://github.com/betrusted-io/betrusted-wiki/wiki/Updating-Your-Device#troubleshooting) guide for more help, especially if you are running Windows. diff --git a/tools/updater/precursorupdater.egg-info/SOURCES.txt b/tools/updater/precursorupdater.egg-info/SOURCES.txt new file mode 100644 index 000000000..50a9b770d --- /dev/null +++ b/tools/updater/precursorupdater.egg-info/SOURCES.txt @@ -0,0 +1,14 @@ +LICENSE +README.md +pyproject.toml +setup.py +precursorupdater/__init__.py +precursorupdater/precursorupdater.py +precursorupdater.egg-info/PKG-INFO +precursorupdater.egg-info/SOURCES.txt +precursorupdater.egg-info/dependency_links.txt +precursorupdater.egg-info/entry_points.txt +precursorupdater.egg-info/requires.txt +precursorupdater.egg-info/top_level.txt +precursorupdater/precursorusb/__init__.py +precursorupdater/precursorusb/precursorusb.py \ No newline at end of file diff --git a/tools/updater/precursorupdater.egg-info/dependency_links.txt b/tools/updater/precursorupdater.egg-info/dependency_links.txt new file mode 100644 index 000000000..8b1378917 --- /dev/null +++ b/tools/updater/precursorupdater.egg-info/dependency_links.txt @@ -0,0 +1 @@ + diff --git a/tools/updater/precursorupdater.egg-info/entry_points.txt b/tools/updater/precursorupdater.egg-info/entry_points.txt new file mode 100644 index 000000000..9f3e65aa2 --- /dev/null +++ b/tools/updater/precursorupdater.egg-info/entry_points.txt @@ -0,0 +1,2 @@ +[console_scripts] +my-script = precursorupdater.precursorupdater:main diff --git a/tools/updater/precursorupdater.egg-info/requires.txt b/tools/updater/precursorupdater.egg-info/requires.txt new file mode 100644 index 000000000..83611572d --- /dev/null +++ b/tools/updater/precursorupdater.egg-info/requires.txt @@ -0,0 +1,3 @@ +requests>=2 +pyusb>=1 +progressbar2>=3 diff --git a/tools/updater/precursorupdater.egg-info/top_level.txt b/tools/updater/precursorupdater.egg-info/top_level.txt new file mode 100644 index 000000000..e0bc34273 --- /dev/null +++ b/tools/updater/precursorupdater.egg-info/top_level.txt @@ -0,0 +1 @@ +precursorupdater diff --git a/tools/updater/precursorupdater/precursorusb/__init__.py b/tools/updater/precursorupdater/precursorusb/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/tools/updater/precursorupdater/precursorusb/__pycache__/__init__.cpython-38.pyc b/tools/updater/precursorupdater/precursorusb/__pycache__/__init__.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e4d7914c54163c77704407498352be7465ac236 GIT binary patch literal 187 zcmWIL<>g`kf_?S3l0fuh5P=LBfgA@QE@lA|DGb33nv8xc8Hzx{2;x_Qer{fgewuzx zVo`c(d45s0eo<+0iEepjo_=zEN~(TEerd68a(+>&eo20QPO*MzK}uptYLR|HQEGB& oQE`3|ra*C$etdjpUS>&ryk0@&Ee@O9{FKt1R6CH(pMjVG0A7?cb^rhX literal 0 HcmV?d00001 diff --git a/tools/updater/precursorupdater/precursorusb/__pycache__/__init__.cpython-39.pyc b/tools/updater/precursorupdater/precursorusb/__pycache__/__init__.cpython-39.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f4eca20634523cda4b76928a8d23bdbda88de695 GIT binary patch literal 184 zcmYe~<>g`kf_?S3l0fuh5P=LBfgA@QE@lA|DGb33nv8xc8Hzx{2;x_)n^jCsVo`c( zd45rLOi^iZiEepjUQBX+N@`3+erd68a(+>2Oi6xzPH{|WK}uptYEeu4 literal 0 HcmV?d00001 diff --git a/tools/updater/precursorupdater/precursorusb/__pycache__/precursorusb.cpython-38.pyc b/tools/updater/precursorupdater/precursorusb/__pycache__/precursorusb.cpython-38.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ed9ebd3e880ade8be0554671eccfab2c26db5e51 GIT binary patch literal 10094 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 Vj_h;sBD_M2#_0``2o68B{|5#LDbfG{ literal 0 HcmV?d00001 diff --git a/tools/updater/precursorupdater/precursorusb/__pycache__/precursorusb.cpython-39.pyc b/tools/updater/precursorupdater/precursorusb/__pycache__/precursorusb.cpython-39.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7e3ad2d28d72bac5ad0dc361186e77986958c7b9 GIT binary patch literal 10087 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%0DLNH;7y%LaAgaiBNpb2MyV|q1)u6gwW!(-p=*Y zdHffYTs%tG(HYmDQrn*p`7f z{Z%;J)le-@hRVt4O}*ga7(nCwEjm`>nTF!IZIkZi%<0j5W(U#g!ujIbjY3mN2)3F=f;Rp`jIeZ-i=aIvw z77mWwY^`;4EKnbtR#siiYKx0VJ!5{obmTsztct&KUC++bKX7R4lFx@uK3}biW`)X$ ze14-@s6=5~g$S~W> zCHmuyq$o9ppZ639)+7blB%Md?jD6fToVXq1uVweX&Xe|OZi9J0Pwlsf{5D89-H*|V f1-XD<1a|6wzZZx0E72mnN{hxR50VHDLbd+~NZ~5# literal 0 HcmV?d00001 diff --git a/tools/updater/precursorupdater/precursorusb/precursorusb.py b/tools/updater/precursorupdater/precursorusb/precursorusb.py new file mode 100644 index 000000000..2058c84cf --- /dev/null +++ b/tools/updater/precursorupdater/precursorusb/precursorusb.py @@ -0,0 +1,407 @@ +import array +import hashlib +import csv + +from progressbar.bar import ProgressBar + +class PrecursorUsb: + def __init__(self, dev): + self.dev = dev + self.RDSR = 0x05 + self.RDSCUR = 0x2B + self.RDID = 0x9F + self.WREN = 0x06 + self.WRDI = 0x04 + self.SE4B = 0x21 + self.BE4B = 0xDC + self.PP4B = 0x12 + self.registers = {} + self.regions = {} + self.gitrev = '' + + def register(self, name): + return int(self.registers[name], 0) + + def peek(self, addr, display=False): + _dummy_s = '\x00'.encode('utf-8') + data = array.array('B', _dummy_s * 4) + + numread = self.dev.ctrl_transfer(bmRequestType=(0x80 | 0x43), bRequest=0, + wValue=(addr & 0xffff), wIndex=((addr >> 16) & 0xffff), + data_or_wLength=data, timeout=500) + + read_data = int.from_bytes(data.tobytes(), byteorder='little', signed=False) + if display == True: + print("0x{:08x}".format(read_data)) + return read_data + + def poke(self, addr, wdata, check=False, display=False): + if check == True: + _dummy_s = '\x00'.encode('utf-8') + data = array.array('B', _dummy_s * 4) + + numread = self.dev.ctrl_transfer(bmRequestType=(0x80 | 0x43), bRequest=0, + wValue=(addr & 0xffff), wIndex=((addr >> 16) & 0xffff), + data_or_wLength=data, timeout=500) + + read_data = int.from_bytes(data.tobytes(), byteorder='little', signed=False) + print("before poke: 0x{:08x}".format(read_data)) + + data = array.array('B', wdata.to_bytes(4, 'little')) + numwritten = self.dev.ctrl_transfer(bmRequestType=(0x00 | 0x43), bRequest=0, + wValue=(addr & 0xffff), wIndex=((addr >> 16) & 0xffff), + data_or_wLength=data, timeout=500) + + if check == True: + _dummy_s = '\x00'.encode('utf-8') + data = array.array('B', _dummy_s * 4) + + numread = self.dev.ctrl_transfer(bmRequestType=(0x80 | 0x43), bRequest=0, + wValue=(addr & 0xffff), wIndex=((addr >> 16) & 0xffff), + data_or_wLength=data, timeout=500) + + read_data = int.from_bytes(data.tobytes(), byteorder='little', signed=False) + print("after poke: 0x{:08x}".format(read_data)) + if display == True: + print("wrote 0x{:08x} to 0x{:08x}".format(wdata, addr)) + + def burst_read(self, addr, len): + _dummy_s = '\x00'.encode('utf-8') + maxlen = 4096 + + ret = bytearray() + packet_count = len // maxlen + if (len % maxlen) != 0: + packet_count += 1 + + for pkt_num in range(packet_count): + cur_addr = addr + pkt_num * maxlen + if pkt_num == packet_count - 1: + if len % maxlen != 0: + bufsize = len % maxlen + else: + bufsize = maxlen + else: + bufsize = maxlen + + data = array.array('B', _dummy_s * bufsize) + numread = self.dev.ctrl_transfer(bmRequestType=(0x80 | 0x43), bRequest=0, + wValue=(cur_addr & 0xffff), wIndex=((cur_addr >> 16) & 0xffff), + data_or_wLength=data, timeout=500) + + if numread != bufsize: + print("Burst read error: {} bytes requested, {} bytes read at 0x{:08x}".format(bufsize, numread, cur_addr)) + exit(1) + + ret = ret + data + + return ret + + def burst_write(self, addr, data): + if len(data) == 0: + return + + # the actual "addr" doesn't matter for a burst_write, because it's specified + # as an argument to the flash_pp4b command. We lock out access to the base of + # SPINOR because it's part of the gateware, so, we pick a "safe" address to + # write to instead. The page write responder will aggregate any write data + # to anywhere in the SPINOR address range. + writebuf_addr = 0x2098_0000 # the current start address of the kernel, for example + + maxlen = 4096 + packet_count = len(data) // maxlen + if (len(data) % maxlen) != 0: + packet_count += 1 + + for pkt_num in range(packet_count): + cur_addr = addr + pkt_num * maxlen + if pkt_num == packet_count - 1: + if len(data) % maxlen != 0: + bufsize = len(data) % maxlen + else: + bufsize = maxlen + else: + bufsize = maxlen + + wdata = array.array('B', data[(pkt_num * maxlen):(pkt_num * maxlen) + bufsize]) + numwritten = self.dev.ctrl_transfer(bmRequestType=(0x00 | 0x43), bRequest=0, + # note use of writebuf_addr instead of cur_addr -> see comment above about the quirk of write addressing + wValue=(writebuf_addr & 0xffff), wIndex=((writebuf_addr >> 16) & 0xffff), + data_or_wLength=wdata, timeout=500) + + if numwritten != bufsize: + print("Burst write error: {} bytes requested, {} bytes written at 0x{:08x}".format(bufsize, numwritten, cur_addr)) + exit(1) + + def ping_wdt(self): + self.poke(self.register('wdt_watchdog'), 1, display=False) + self.poke(self.register('wdt_watchdog'), 1, display=False) + + def spinor_command_value(self, exec=0, lock_reads=0, cmd_code=0, dummy_cycles=0, data_words=0, has_arg=0): + return ((exec & 1) << 1 | + (lock_reads & 1) << 24 | + (cmd_code & 0xff) << 2 | + (dummy_cycles & 0x1f) << 11 | + (data_words & 0xff) << 16 | + (has_arg & 1) << 10 + ) + + def flash_rdsr(self, lock_reads): + self.poke(self.register('spinor_cmd_arg'), 0) + self.poke(self.register('spinor_command'), + self.spinor_command_value(exec=1, lock_reads=lock_reads, cmd_code=self.RDSR, dummy_cycles=4, data_words=1, has_arg=1) + ) + return self.peek(self.register('spinor_cmd_rbk_data'), display=False) + + def flash_rdscur(self): + self.poke(self.register('spinor_cmd_arg'), 0) + self.poke(self.register('spinor_command'), + self.spinor_command_value(exec=1, lock_reads=1, cmd_code=self.RDSCUR, dummy_cycles=4, data_words=1, has_arg=1) + ) + return self.peek(self.register('spinor_cmd_rbk_data'), display=False) + + def flash_rdid(self, offset): + self.poke(self.register('spinor_cmd_arg'), 0) + self.poke(self.register('spinor_command'), + self.spinor_command_value(exec=1, cmd_code=self.RDID, dummy_cycles=4, data_words=offset, has_arg=1) + ) + return self.peek(self.register('spinor_cmd_rbk_data'), display=False) + + def flash_wren(self): + self.poke(self.register('spinor_cmd_arg'), 0) + self.poke(self.register('spinor_command'), + self.spinor_command_value(exec=1, lock_reads=1, cmd_code=self.WREN) + ) + + def flash_wrdi(self): + self.poke(self.register('spinor_cmd_arg'), 0) + self.poke(self.register('spinor_command'), + self.spinor_command_value(exec=1, lock_reads=1, cmd_code=self.WRDI) + ) + + def flash_se4b(self, sector_address): + self.poke(self.register('spinor_cmd_arg'), sector_address) + self.poke(self.register('spinor_command'), + self.spinor_command_value(exec=1, lock_reads=1, cmd_code=self.SE4B, has_arg=1) + ) + + def flash_be4b(self, block_address): + self.poke(self.register('spinor_cmd_arg'), block_address) + self.poke(self.register('spinor_command'), + self.spinor_command_value(exec=1, lock_reads=1, cmd_code=self.BE4B, has_arg=1) + ) + + def flash_pp4b(self, address, data_bytes): + self.poke(self.register('spinor_cmd_arg'), address) + self.poke(self.register('spinor_command'), + self.spinor_command_value(exec=1, lock_reads=1, cmd_code=self.PP4B, has_arg=1, data_words=(data_bytes//2)) + ) + + def load_csrs(self, fname=None): + LOC_CSRCSV = 0x20277000 # this address shouldn't change because it's how we figure out our version number + # CSR extraction: + # dd if=soc_csr.bin of=csr_data_0.9.6.bin skip=2524 count=32 bs=1024 + if fname == None: + csr_data = self.burst_read(LOC_CSRCSV, 0x8000) + else: + with open(fname, "rb") as f: + csr_data = f.read(0x8000) + + hasher = hashlib.sha512() + hasher.update(csr_data[:0x7FC0]) + digest = hasher.digest() + if digest != csr_data[0x7fc0:]: + print("Could not find a valid csr.csv descriptor on the device, aborting!") + exit(1) + + csr_len = int.from_bytes(csr_data[:4], 'little') + csr_extracted = csr_data[4:4+csr_len] + decoded = csr_extracted.decode('utf-8') + # strip comments + stripped = [] + for line in decoded.split('\n'): + if line.startswith('#') == False: + stripped.append(line) + # create database + csr_db = csv.reader(stripped) + for row in csr_db: + if len(row) > 1: + if 'csr_register' in row[0]: + self.registers[row[1]] = row[2] + if 'memory_region' in row[0]: + self.regions[row[1]] = [row[2], row[3]] + if 'git_rev' in row[0]: + self.gitrev = row[1] + print("Using SoC {} registers".format(self.gitrev)) + + def erase_region(self, addr, length): + # ID code check + code = self.flash_rdid(1) + print("ID code bytes 1-2: 0x{:08x}".format(code)) + if code != 0x8080c2c2: + print("ID code mismatch") + exit(1) + code = self.flash_rdid(2) + print("ID code bytes 2-3: 0x{:08x}".format(code)) + if code != 0x3b3b8080: + print("ID code mismatch") + exit(1) + + # block erase + progress = ProgressBar(min_value=0, max_value=length, prefix='Erasing ').start() + erased = 0 + while erased < length: + self.ping_wdt() + if (length - erased >= 65536) and ((addr & 0xFFFF) == 0): + blocksize = 65536 + else: + blocksize = 4096 + + while True: + self.flash_wren() + status = self.flash_rdsr(1) + if status & 0x02 != 0: + break + + if blocksize == 4096: + self.flash_se4b(addr + erased) + else: + self.flash_be4b(addr + erased) + erased += blocksize + + while (self.flash_rdsr(1) & 0x01) != 0: + pass + + result = self.flash_rdscur() + if result & 0x60 != 0: + print("E_FAIL/P_FAIL set on erase, programming may fail, but trying anyways...") + + if self.flash_rdsr(1) & 0x02 != 0: + self.flash_wrdi() + while (self.flash_rdsr(1) & 0x02) != 0: + pass + if erased < length: + progress.update(erased) + progress.finish() + print("Erase finished") + + # addr is relative to the base of FLASH (not absolute) + def flash_program(self, addr, data, verify=True): + flash_region = int(self.regions['spiflash'][0], 0) + flash_len = int(self.regions['spiflash'][1], 0) + + if (addr + len(data) > flash_len): + print("Write data out of bounds! Aborting.") + exit(1) + + # ID code check + code = self.flash_rdid(1) + print("ID code bytes 1-2: 0x{:08x}".format(code)) + if code != 0x8080c2c2: + print("ID code mismatch") + exit(1) + code = self.flash_rdid(2) + print("ID code bytes 2-3: 0x{:08x}".format(code)) + if code != 0x3b3b8080: + print("ID code mismatch") + exit(1) + + # block erase + progress = ProgressBar(min_value=0, max_value=len(data), prefix='Erasing ').start() + erased = 0 + while erased < len(data): + self.ping_wdt() + if (len(data) - erased >= 65536) and ((addr & 0xFFFF) == 0): + blocksize = 65536 + else: + blocksize = 4096 + + while True: + self.flash_wren() + status = self.flash_rdsr(1) + if status & 0x02 != 0: + break + + if blocksize == 4096: + self.flash_se4b(addr + erased) + else: + self.flash_be4b(addr + erased) + erased += blocksize + + while (self.flash_rdsr(1) & 0x01) != 0: + pass + + result = self.flash_rdscur() + if result & 0x60 != 0: + print("E_FAIL/P_FAIL set on erase, programming may fail, but trying anyways...") + + if self.flash_rdsr(1) & 0x02 != 0: + self.flash_wrdi() + while (self.flash_rdsr(1) & 0x02) != 0: + pass + if erased < len(data): + progress.update(erased) + progress.finish() + print("Erase finished") + + # program + # pad out to the nearest word length + if len(data) % 4 != 0: + data += bytearray([0xff] * (4 - (len(data) % 4))) + written = 0 + progress = ProgressBar(min_value=0, max_value=len(data), prefix='Writing ').start() + while written < len(data): + self.ping_wdt() + if len(data) - written > 256: + chunklen = 256 + else: + chunklen = len(data) - written + + while True: + self.flash_wren() + status = self.flash_rdsr(1) + if status & 0x02 != 0: + break + + self.burst_write(self.register('spinor_wdata'), data[written:(written+chunklen)]) + self.flash_pp4b(addr + written, chunklen) + + written += chunklen + if written < len(data): + progress.update(written) + progress.finish() + print("Write finished") + + if self.flash_rdsr(1) & 0x02 != 0: + self.flash_wrdi() + while (self.flash_rdsr(1) & 0x02) != 0: + pass + + # dummy reads to clear the "read lock" bit + self.flash_rdsr(0) + + # verify + self.ping_wdt() + if verify: + print("Performing readback for verification...") + self.ping_wdt() + rbk_data = self.burst_read(addr + flash_region, len(data)) + if rbk_data != data: + errs = 0 + err_thresh = 64 + for i in range(0, len(rbk_data)): + if rbk_data[i] != data[i]: + if errs < err_thresh: + print("Error at 0x{:x}: {:x}->{:x}".format(i, data[i], rbk_data[i])) + errs += 1 + if errs == err_thresh: + print("Too many errors, stopping print...") + print("Errors were found in verification, programming failed") + print("Total byte errors: {}".format(errs)) + exit(1) + else: + print("Verification passed.") + else: + print("Skipped verification at user request") + + self.ping_wdt() diff --git a/tools/updater/setup.py b/tools/updater/setup.py new file mode 100644 index 000000000..606849326 --- /dev/null +++ b/tools/updater/setup.py @@ -0,0 +1,3 @@ +from setuptools import setup + +setup()