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