From 327060ca40b08cf7d0cd614f4e0ea3970deb320c Mon Sep 17 00:00:00 2001
From: Marian Buschsieweke <marian.buschsieweke@ovgu.de>
Date: Tue, 12 Nov 2019 15:51:32 +0100
Subject: [PATCH] makesfiles/boards: Added common programmer config

Added common configuration for the programmer, debugger and serial for STM32
based boards.
---
 makefiles/boards/stm32.inc.mk | 58 +++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 makefiles/boards/stm32.inc.mk

diff --git a/makefiles/boards/stm32.inc.mk b/makefiles/boards/stm32.inc.mk
new file mode 100644
index 0000000000..1240568d88
--- /dev/null
+++ b/makefiles/boards/stm32.inc.mk
@@ -0,0 +1,58 @@
+PROGRAMMER ?= openocd
+
+PROGRAMMERS_SUPPORTED := bmp dfu-util openocd
+
+ifeq (,$(filter $(PROGRAMMER), $(PROGRAMMERS_SUPPORTED)))
+  $(error Programmer $(PROGRAMMER) not supported)
+endif
+
+ifeq (bmp,$(PROGRAMMER))
+  # On Blackmagic Probe, the first ACM is used to connect to the gdb server,
+  # the second is the BMP's UART interface
+  PORT_LINUX ?= /dev/ttyACM1
+  PORT_DARWIN ?= $(wordlist 2, 2, $(sort $(wildcard /dev/tty.usbmodem*)))
+else
+  # configure the serial terminal
+  PORT_LINUX ?= /dev/ttyACM0
+  PORT_DARWIN ?= $(firstword $(sort $(wildcard /dev/tty.usbmodem*)))
+endif
+
+# setup serial terminal
+include $(RIOTMAKE)/tools/serial.inc.mk
+
+ifeq (openocd,$(PROGRAMMER))
+  # STM32 boards can become un-flashable after a hardfault,
+  # use connect_assert_srst to always be able to flash or reset the boards.
+  export OPENOCD_RESET_USE_CONNECT_ASSERT_SRST ?= 1
+
+  # For STM32 boards the ST-link adapter is the default adapter, e.g. all
+  # Nucleo boards have an on-board ST-link adapter
+  DEBUG_ADAPTER ?= stlink
+
+  # RIOT uses openocd by default
+  include $(RIOTMAKE)/tools/openocd.inc.mk
+endif
+
+ifeq (bmp,$(PROGRAMMER))
+  include $(RIOTMAKE)/tools/bmp.inc.mk
+endif
+
+ifeq (dfu-util,$(PROGRAMMER))
+  # optionally, use dfu-util to flash via usb
+  # note: needs a bootloader flashed before, config below is compatible
+  # with blackmagic_dfu, see https://github.com/blacksphere/blackmagic/
+  # To stop bootloader from loading an existing firmware, pull down
+  # (ground) GPIO B1.
+  ifeq (,$(DFU_USB_ID))
+    $(error DFU_USB_ID is not set)
+  endif
+  # Skip the space needed by the embedded bootloader
+  export ROM_OFFSET ?= 0x2000
+  FLASHER = dfu-util
+  DEBUGGER = # no debugger
+  RESET ?= # dfu-util has no support for resetting the device
+
+  FLASHFILE ?= $(BINFILE)
+  DFU_FLAGS ?= -a 2
+  FFLAGS = -d $(DFU_USB_ID) $(DFU_FLAGS) -D $(FLASHFILE)
+endif