Updated doc

Author: lupyuen

.vscode/launch-stm32l4.json

@@ -17,7 +17,7 @@
             //  Arm System View Description, downloaded from https://www.st.com/en/microcontrollers-microprocessors/stm32l476rc.html#
             "svdFile": "scripts/STM32L4x6.svd",
             "configFiles": [ 
-                //  Tell OpenOCD to open the ST Link connection to STM32F1 MCU.
+                //  Tell OpenOCD to open the ST Link connection to STM32 MCU.
                 "interface/stlink-v2.cfg",
                 //  Previously: "target/stm32f1x.cfg",
                 "target/stm32l4x.cfg",

scripts/stm32l4/README.md

@@ -1,3 +1,19 @@
-# stm32l4
+# stm32l4: Build and Flash Scripts for STM32 L4xx
 
-Scripts for STM32L4
+[`build-boot.cmd`](build-boot.cmd), [`.sh`](build-boot.sh): Build the bootloader by running `newt build stm32l4_boot`
+
+build-app.cmd, .sh: Build the application by running newt build stm32l4_my_sensor
+
+image-app.cmd, .sh: Create the application firmware image: newt create-image -v stm32l4_my_sensor 1.0.0
+
+flash-boot.cmd, .sh: Flash the bootloader with OpenOCD
+
+flash-boot.ocd: OpenOCD script for flashing the bootloader
+
+flash-app.cmd, .sh: Flash the application with OpenOCD
+
+flash-app.ocd: OpenOCD script for flashing the application
+
+flash-init.ocd: OpenOCD initialisation script called by flash-boot.ocd and flash-app.ocd
+
+debug.ocd: OpenOCD script for debugging the application. Called by .vscode/launch-stm32l4.json

scripts/stm32l4/debug.ocd

@@ -1,4 +1,4 @@
-# This is an OpenOCD script that connects to the STM32 Blue Pill for Cortex Debug.
+# This is an OpenOCD script that connects to the STM32 L4xx for Cortex Debug.
 
 # Debug Level must be 2 or greater or gdb will fail.
 debug_level 2