blackmagic/flashstub/README

Flash Stubs
===========

For most of the targets, these are assembler routines for executing
a flash write on the supported targets.  They are kept here for
reference, but are not used, as the compiled binary code is included
in the target drivers.

For the STM32l0x, the stubs are written in C++ and emitted as arrays
of half-words for inclusion in the target driver.  The use of a higher
level language allows more detailed code and for easy revisions.
These stubs communicate with the driver through a structure defined in
the src/include/stm32l0-nvm.h header.

The dump-to-array.sh helper script uses sed to transform the output of
'objdump -d' into a half-word array of the instructions that may be
included in C code to declare the stub.  FWIW, objcopy doesn't produce
the same output as objdump.  It omits some of the instructions,
probably because the object file isn't linked.
STM32L0x target support. Target support for stm32l0's and stm32l1's including option bytes and data EEPROM. This module will superceed the previous stm32l1 driver. o Program flash write and erase. o Options modification and interpretive status. o Stubs for program flash writes and erases. Stubs are modestly faster than non-stub version. The stm32l0 will not execute stubs when the MCU has crashed. A monitor option may be used to force non-stub flash writes. o Stubs generated from C++ code and converted to arrays of half-words. o Writes to data EEPROM supoprted when loading segments. o EEPROM data monitor command to write words. o Stubs supported on stm32l1. 2014-12-20 00:25:22 +00:00			`Flash Stubs`
			`===========`
Added Flash programming stubs. 2011-02-12 09:09:38 +00:00
STM32L0x target support. Target support for stm32l0's and stm32l1's including option bytes and data EEPROM. This module will superceed the previous stm32l1 driver. o Program flash write and erase. o Options modification and interpretive status. o Stubs for program flash writes and erases. Stubs are modestly faster than non-stub version. The stm32l0 will not execute stubs when the MCU has crashed. A monitor option may be used to force non-stub flash writes. o Stubs generated from C++ code and converted to arrays of half-words. o Writes to data EEPROM supoprted when loading segments. o EEPROM data monitor command to write words. o Stubs supported on stm32l1. 2014-12-20 00:25:22 +00:00			`For most of the targets, these are assembler routines for executing`
			`a flash write on the supported targets. They are kept here for`
			`reference, but are not used, as the compiled binary code is included`
			`in the target drivers.`

			`For the STM32l0x, the stubs are written in C++ and emitted as arrays`
			`of half-words for inclusion in the target driver. The use of a higher`
			`level language allows more detailed code and for easy revisions.`
			`These stubs communicate with the driver through a structure defined in`
			`the src/include/stm32l0-nvm.h header.`
Revisions on Gareth's comments. o Implemented byte writes to EEPROM now that the emulator has a byte-wide target write. o Added comment describing the reason that mass erase doesn't work. o Removed all unused code. o Changed to Linux kernel indent style. o Changed to Linux kernel function to parenthesis style. o Stub generation doesn't use Perl, switched to sed. Also, only including the instructions instead of the source and the instructions. o Handling unaligned destination writes. 2015-01-24 21:50:59 +00:00
			`The dump-to-array.sh helper script uses sed to transform the output of`
			`'objdump -d' into a half-word array of the instructions that may be`
			`included in C code to declare the stub. FWIW, objcopy doesn't produce`
			`the same output as objdump. It omits some of the instructions,`
			`probably because the object file isn't linked.`