Commit 0bb6b63e authored by Damien George's avatar Damien George

stm32/mboot/README: Fix some typos, describe bootloader and fwupdate.py.

parent 66bcb559
...@@ -46,14 +46,14 @@ How to use ...@@ -46,14 +46,14 @@ How to use
This assumes that the board declares and defines the relevant SPI flash This assumes that the board declares and defines the relevant SPI flash
configuration structs, eg in the board-specific bdev.c file. The configuration structs, eg in the board-specific bdev.c file. The
`MBOOT_SPIFLASH2_LAYOUT` string will be seen by the USB DFU utility and `MBOOT_SPIFLASH_LAYOUT` string will be seen by the USB DFU utility and
must describe the SPI flash layout. Note that the number of pages in must describe the SPI flash layout. Note that the number of pages in
this layout description (the `64` above) cannot be larger than 99 (it this layout description (the `64` above) cannot be larger than 99 (it
must fit in two digits) so the reported page size (the `32Kg` above) must fit in two digits) so the reported page size (the `32Kg` above)
must be made large enough so the number of pages fits in two digits. must be made large enough so the number of pages fits in two digits.
Alternatively the layout can specify multiple sections like Alternatively the layout can specify multiple sections like
`32*16Kg,32*16Kg`, in which case `MBOOT_SPIFLASH_ERASE_BLOCKS_PER_PAGE` `32*16Kg,32*16Kg`, in which case `MBOOT_SPIFLASH_ERASE_BLOCKS_PER_PAGE`
must be changed to `16 / 4` to match tho `16Kg` value. must be changed to `16 / 4` to match the `16Kg` value.
Mboot supports up to two external SPI flash devices. To configure the Mboot supports up to two external SPI flash devices. To configure the
second one use the same configuration names as above but with second one use the same configuration names as above but with
...@@ -115,6 +115,10 @@ The last element in the data sequence must be the end element: ...@@ -115,6 +115,10 @@ The last element in the data sequence must be the end element:
* END: type=1, len=0 * END: type=1, len=0
Note: MicroPython's `machine.bootloader()` function performs steps 1-4
above, and also accepts an optional bytes argument as additional data to
pass through to Mboot.
Loading firmware from a filesystem Loading firmware from a filesystem
---------------------------------- ----------------------------------
...@@ -130,6 +134,9 @@ are located and what filename to program. The elements to use are: ...@@ -130,6 +134,9 @@ are located and what filename to program. The elements to use are:
The firmware to load must be a gzip'd DfuSe file (.dfu.gz). The firmware to load must be a gzip'd DfuSe file (.dfu.gz).
The provided fwupdate.py script contains helper functions to call into Mboot
with the correct data, and also to update Mboot itself.
Example: Mboot on PYBv1.x Example: Mboot on PYBv1.x
------------------------- -------------------------
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment