From 297ac49867b750bfeeeca3a354619c527468cc41 Mon Sep 17 00:00:00 2001 From: Christian Pointner Date: Wed, 10 Jul 2013 03:57:48 +0000 Subject: added bootloader for IHU git-svn-id: https://svn.spreadspace.org/mur.sat@807 7de4ea59-55d0-425e-a1af-a3118ea81d4c --- software/pic.bootloader/proto.txt | 200 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 200 insertions(+) create mode 100644 software/pic.bootloader/proto.txt (limited to 'software/pic.bootloader/proto.txt') diff --git a/software/pic.bootloader/proto.txt b/software/pic.bootloader/proto.txt new file mode 100644 index 0000000..0e35e1e --- /dev/null +++ b/software/pic.bootloader/proto.txt @@ -0,0 +1,200 @@ +Command List: +============= + + code | command + ------+------------ + 1 | identify + 2 | boot + 3 | reset + 4 | read flash + 5 | write flash + 6 | read eeprom + 7 | write eeprom + 8 | read config + 9 | write config + + +Description: +------------ + +Every command consits of one byte command code, one byte length which counts all +bytes of the command including the command code and checksum. The length is followed +by zero or more data and a XOR checksum over all bytes sent. All data is +transferred LSB first (aka little endian). All addresses and words are 2bytes long. +Every answer to a command starts with the command code a length field which counts all +bytes of the answer, one byte return value optionally some data and a checksum +(XOR over all bytes received). +The return codes have the following meaning: + + code | Error + ------+------------- + 0 | OK + 1 | invalid command + 2 | bad checksum + 3 | not implemented + 4 | flash write error + 5 | address invalid + 6 | address prohibited + 5 | value out of bounds + +identify: +~~~~~~~~~ + command: + 1 | len=3 | + + answer: + 1 | len=19 | | version | name | devid | fs | fss | es | mess | supported | + + version: + 2bytes, protocol version + It is an error if the major version (MSB) is different (hence any + protocol update must change the major version of the bootloader). + + name: + 3bytes, a descriptive name of the device. + The downloader has to compare this name with the device name supplied + via commandline and stop in case they don't match + + devid: + 2bytes, device id of the PIC + The downlaoder may use this id to check if it talks to the right bootloader + + fs: + 2bytes, flash size + The size of the flash in code words. + + fss: + 1byte, flash segment size + The number of words of one flash segment which has to be written at once. + If less than should be updated the downloader has to perform a read + operation first. + + es: + 2bytes, eeprom size + The size of the eeprom in bytes. + + mess: + 1byte, maximum eeprom segment size + This represents the maximum number of eeprom bytes which may be written or + read at once. Unlike value it is ok to write or read less than + bytes. + + supported: + 2bytes, a bitmap showing supported commands + The commands 'identify' and 'boot' are always supported by the bootloader, + others may not (i.e.: not all PICs allow to update the configurtion words) + + bit | command + -----+---------- + 0 | reset + 1 | read flash + 2 | write flash + 3 | read eeprom + 4 | write eeprom + 5 | read config + 6 | write config + + +boot: +~~~~~ + + command: + 2 | len=3 | + + answer: + 2 | len=4 | | + + This instucts the bootloader to boot to the user application directly (no reset) + + +reset: +~~~~~~ + + command: + 3 | len=3 | + + answer: + 3 | len=4 | | + + The device performs a reboot. If the boot condition (i.e.: port pin) is not met + this instructs the device to boot to the user application. + + +read flash: +~~~~~~~~~~~ + + command: + 4 | len=5 | addr | + + answer: + 4 | len=4+2* | | data | + + The bootloader reads words from flash address and returns it as + . + + +write flash: +~~~~~~~~~~~~ + + command: + 5 | len=5+2* | addr | data | + + answer: + 5 | len=4 | | + + The bootloader writes (which has to contain exactly words) to address + inside the flash. The start address has to be aligned to boundaries. + Before writing the memory region will be erased. If there are words which shouldn't + be altered the downloader has to read these words first and reprogram the whole segment. + + +read eeprom: +~~~~~~~~~~~~ + + command: + 6 | len=5 | addr | len | + + answer: + 6 | len=4+ | | data | + + The bootloader reads bytes from eeprom at address and returns it as + . len is 1byte long. + + +write eeprom: +~~~~~~~~~~~~~ + + command: + 7 | len=4+len(data) | addr | data | + + answer: + 7 | len=4 | | + + The bootloader writes (which has to contain exactly -4 bytes) to address + inside the eeprom. len is 1byte long and the value must not exceed bytes. + + +read config: +~~~~~~~~~~~~ + + command: + 8 | len=3 | nr | + + answer: + 8 | len=6 | | word | + + The bootloader reads and returns the configuration word number . is one + byte long. + + +write config: +~~~~~~~~~~~~~ + + command: + 9 | len=5 | nr | word | + + answer: + 9 | len=4 | | + + The bootloader writes onto configuration word number . is one + byte long. -- cgit v1.2.3