aboutsummaryrefslogtreecommitdiff
path: root/flashstub/README
diff options
context:
space:
mode:
authorGareth McMullin2015-03-08 16:56:01 -0700
committerGareth McMullin2015-03-08 16:56:01 -0700
commit51f91092e73fa77c618925d861bc731980c013b4 (patch)
treefe0cb67833677720caec8bda1f23263b3d364b8e /flashstub/README
parentb6d73442cc75669f617529610b8ededdab556e18 (diff)
parentbf1cb71eb7a3a679a6acf944283cd0f0ef53c077 (diff)
Merge pull request #75 from beewoolie/stm32lx-whole
STM32Lx target support.
Diffstat (limited to 'flashstub/README')
-rw-r--r--flashstub/README22
1 files changed, 18 insertions, 4 deletions
diff --git a/flashstub/README b/flashstub/README
index 05172a4..90d164c 100644
--- a/flashstub/README
+++ b/flashstub/README
@@ -1,5 +1,19 @@
-These are the 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.
+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.