tools/cpy2remed: Addition of cpy2remed programmer to nucleo-L552ZE-Q

RIOT-OS · Feb 11, 2022 · d417e95 · d417e95
1 parent 4aa173d
commit d417e95
Show file tree

Hide file tree

Showing 4 changed files with 41 additions and 0 deletions.
diff --git a/boards/nucleo-l552ze-q/Makefile.include b/boards/nucleo-l552ze-q/Makefile.include
@@ -1,2 +1,8 @@
+#variable needed by cpy2remed PROGRAMMER
+#it contains name of ST-Link removable media
+DIR_NAME_AT_REMED = "NODE_L552ZE"
+
+PROGRAMMERS_SUPPORTED += cpy2remed
+
 # load the common Makefile.include for Nucleo boards
 include $(RIOTBOARD)/common/nucleo144/Makefile.include
diff --git a/boards/nucleo-l552ze-q/doc.txt b/boards/nucleo-l552ze-q/doc.txt
@@ -5,6 +5,8 @@
 
 ## Flashing the device
 
+### Flashing the Board Using OpenOCD
+
 The ST Nucleo-L552ZE-Q board includes an on-board ST-LINK programmer and can be
 flashed using OpenOCD.
 @note The upstream version of OpenOCD doesn't contain yet support for this board,
@@ -34,6 +36,20 @@ and debug via GDB by simply typing
 make BOARD=nucleo-l552ze-q debug
 ```
 
+### Flashing the Board Using ST-LINK Removable Media
+
+On-board ST-LINK programmer provides via composite USB device removable media.
+Copying the HEX file causes reprogramming of the board. This task
+could be performed manually; however, the cpy2remed (copy to removable
+media) PROGRAMMER script does this automatically. To program board in
+this manner, use the command:
+```
+make BOARD=nucleo-l552ze-q PROGRAMMER=cpy2remed flash
+```
+@note This PROGRAMMER was tested using ST-LINK firmware 2.37.26. Firmware updates
+could be found on [this STM webpage](https://www.st.com/en/development-tools/stsw-link007.html).
+
+
 ## Supported Toolchains
 
 For using the ST Nucleo-L552ZE-Q board we recommend the usage of the

diff --git a/dist/tools/cpy2remed/cpy2remed.sh b/dist/tools/cpy2remed/cpy2remed.sh
@@ -0,0 +1,13 @@
+#!/bin/sh
+
+#cpy2remed - copy to removable media
+#$1 contains generated hexfile
+#$2 contains directory name for this particular nucleo board which could be
+#   set in the board makefile.include using variable DIR_NAME_AT_REMED
+
+HEXFILE="$1"
+DEV_DIR="$2"
+
+REMED_MOUNT_PATH="${REMED_MOUNT_PATH:-/media/$USER/$DEV_DIR/}"
+
+cp "$HEXFILE" "$REMED_MOUNT_PATH"
diff --git a/makefiles/tools/cpy2remed.inc.mk b/makefiles/tools/cpy2remed.inc.mk
@@ -0,0 +1,6 @@
+
+FLASHER ?= $(RIOTTOOLS)/cpy2remed/cpy2remed.sh
+
+FLASHFILE ?= $(HEXFILE)
+
+FFLAGS ?= $(FLASHFILE) $(DIR_NAME_AT_REMED)