RIOT/makefiles/tools/jlink.inc.mk

FLASHER ?= $(RIOTTOOLS)/jlink/jlink.sh
DEBUGGER ?= $(RIOTTOOLS)/jlink/jlink.sh
DEBUGSERVER ?= $(RIOTTOOLS)/jlink/jlink.sh
RESET ?= $(RIOTTOOLS)/jlink/jlink.sh

FLASHFILE ?= $(ELFFILE)

FFLAGS ?= flash $(FLASHFILE)
DEBUGGER_FLAGS ?= debug $(DEBUG_ELFFILE)
DEBUGSERVER_FLAGS ?= debug-server
RESET_FLAGS ?= reset

JLINK_SERIAL ?= $(DEBUG_ADAPTER_ID)

JLINK_IF ?=
JLINK_RESET_FILE ?=
JLINK_PRE_FLASH ?=
JLINK_POST_FLASH ?=

JLINK_FLASH_TARGETS = flash flash%
JLINK_TARGETS = debug% $(JLINK_FLASH_TARGETS) reset term-rtt

# Export JLINK_SERIAL to required targets
$(call target-export-variables,$(JLINK_TARGETS),JLINK_SERIAL)

# Export JLINK_DEVICE to required targets
$(call target-export-variables,$(JLINK_TARGETS),JLINK_DEVICE)

ifneq (,$(JLINK))
  # Export JLINK to required targets if not empty
  $(call target-export-variables,$(JLINK_TARGETS),JLINK)
endif

ifneq (,$(JLINK_IF))
  # Export JLINK_IF to required targets if not empty
  $(call target-export-variables,$(JLINK_TARGETS),JLINK_IF)
endif

ifneq (,$(JLINK_RESET_FILE))
  # Export JLINK_RESET_FILE to required targets if not empty
  $(call target-export-variables,$(JLINK_TARGETS),JLINK_RESET_FILE)
endif

# Export JLINK_PRE_FLASH to flash targets only if not empty
ifneq (,$(JLINK_PRE_FLASH))
  $(call target-export-variables,JLINK_FLASH_TARGETS,JLINK_PRE_FLASH)
endif

# Export JLINK_POST_FLASH to flash targets only if not empty
ifneq (,$(JLINK_POST_FLASH))
  $(call target-export-variables,JLINK_FLASH_TARGETS,JLINK_POST_FLASH)
endif
makefiles/jlink: define FLASHER var as overridable 2021-02-09 18:48:00 +01:00			`FLASHER ?= $(RIOTTOOLS)/jlink/jlink.sh`
makefiles/tools: ensure all FLASHER/DEBUGGER* vars are overridable 2020-11-21 22:31:03 +01:00			`DEBUGGER ?= $(RIOTTOOLS)/jlink/jlink.sh`
			`DEBUGSERVER ?= $(RIOTTOOLS)/jlink/jlink.sh`
make: allow override of RESET for jlink 2019-06-06 16:25:20 +02:00			`RESET ?= $(RIOTTOOLS)/jlink/jlink.sh`
make: added common JLink Makefile for boards 2015-08-05 19:49:10 +02:00
makefiles/tools/jlink.inc.mk: use ELF file for flashing There seems to be a consensus to go for a more ELF centric approach whenever possible. J-Link seems to work fine with ELF files, so let's avoid the extra step to create a bin file from the ELF file prior to flashing. 2023-05-03 10:26:44 +02:00			`FLASHFILE ?= $(ELFFILE)`
make: added common JLink Makefile for boards 2015-08-05 19:49:10 +02:00
boards/tools: remove exporting FLASHER/FFLAGS FLASHER and FFLAGS are evaluated by the main Makefile.include or by file included by it. Their value does not need to be exported. This will also prevent evaluating 'PORT' for FFLAGS when not needed. Testing ------- `git diff --word-diff` only reports `export` being removed. `git show --stat` reports `84 insertions(+), 84 deletions(-)` Which is the same amount as lines that where matching `export[[:blank::]]\+VARIABLE`. 2019-05-17 13:52:34 +02:00			`FFLAGS ?= flash $(FLASHFILE)`
makefiles/tools: define DEBUG_ELFFILE and use it for debugging 2022-05-31 12:39:16 +02:00			`DEBUGGER_FLAGS ?= debug $(DEBUG_ELFFILE)`
boards/tools: remove exporting DEBUG* DEBUGGER/DEBUGGER_FLAGS/DEBUGSERVER/DEBUGSERVER_FLAGS are evaluated by the main Makefile.include or by file included by it. Their value does not need to be exported. Testing ------- `git diff --word-diff` only reports `export` being removed. `git show --stat` reports `55 insertions(+), 55 deletions(-)` Which is the same amount as lines that where matching `export[[:blank::]]\+VARIABLE`. 2019-05-17 13:52:34 +02:00			`DEBUGSERVER_FLAGS ?= debug-server`
boards/tools: remove exporting RESET/RESET_FLAGS RESET and RESET_FLAGS are evaluated by the main Makefile.include or by file included by it. Their value does not need to be exported. This will also prevent evaluating 'PORT' for RESET_FLAGS when not needed. Testing ------- `git diff --word-diff` only reports `export` being removed. `git show --stat` reports `24 insertions(+), 24 deletions(-)` Which is the same amount as lines that where matching `export[[:blank::]]\+VARIABLE`. 2019-05-17 13:52:34 +02:00			`RESET_FLAGS ?= reset`
makefiles/tools/jlink.inc.mk: DEBUG_ADAPTER_ID as JLINK_SERIAL - export JLINK_SERIAL for required targets 2019-11-17 22:18:57 +01:00
			`JLINK_SERIAL ?= $(DEBUG_ADAPTER_ID)`

makefiles/jlink: export JLINK_IF to required targets 2020-03-03 16:07:57 +01:00			`JLINK_IF ?=`
makefiles/jlink: export JLINK_RESET_FILE to required targets 2020-03-03 16:19:15 +01:00			`JLINK_RESET_FILE ?=`
makefiles/jlink: export JLINK_PRE_FLASH to flash targets 2020-03-03 16:42:37 +01:00			`JLINK_PRE_FLASH ?=`
makesfiles/jlink: fix exports for flashing 2024-07-06 19:24:55 +02:00			`JLINK_POST_FLASH ?=`

			`JLINK_FLASH_TARGETS = flash flash%`
			`JLINK_TARGETS = debug% $(JLINK_FLASH_TARGETS) reset term-rtt`
makefiles/jlink: export JLINK_IF to required targets 2020-03-03 16:07:57 +01:00
makefiles/tools/jlink.inc.mk: DEBUG_ADAPTER_ID as JLINK_SERIAL - export JLINK_SERIAL for required targets 2019-11-17 22:18:57 +01:00			`# Export JLINK_SERIAL to required targets`
			`$(call target-export-variables,$(JLINK_TARGETS),JLINK_SERIAL)`
makefiles/jlink: only export JLINK_DEVICE when required 2020-03-03 11:56:09 +01:00
			`# Export JLINK_DEVICE to required targets`
			`$(call target-export-variables,$(JLINK_TARGETS),JLINK_DEVICE)`
makefiles/jlink: export JLINK_IF to required targets 2020-03-03 16:07:57 +01:00
makesfiles/jlink: fix exports for flashing 2024-07-06 19:24:55 +02:00			`ifneq (,$(JLINK))`
			`# Export JLINK to required targets if not empty`
			`$(call target-export-variables,$(JLINK_TARGETS),JLINK)`
			`endif`

makefiles/jlink: export JLINK_IF to required targets 2020-03-03 16:07:57 +01:00			`ifneq (,$(JLINK_IF))`
			`# Export JLINK_IF to required targets if not empty`
			`$(call target-export-variables,$(JLINK_TARGETS),JLINK_IF)`
			`endif`
makefiles/jlink: export JLINK_RESET_FILE to required targets 2020-03-03 16:19:15 +01:00
			`ifneq (,$(JLINK_RESET_FILE))`
			`# Export JLINK_RESET_FILE to required targets if not empty`
			`$(call target-export-variables,$(JLINK_TARGETS),JLINK_RESET_FILE)`
			`endif`
makefiles/jlink: export JLINK_PRE_FLASH to flash targets 2020-03-03 16:42:37 +01:00
			`# Export JLINK_PRE_FLASH to flash targets only if not empty`
			`ifneq (,$(JLINK_PRE_FLASH))`
makesfiles/jlink: fix exports for flashing 2024-07-06 19:24:55 +02:00			`$(call target-export-variables,JLINK_FLASH_TARGETS,JLINK_PRE_FLASH)`
			`endif`

			`# Export JLINK_POST_FLASH to flash targets only if not empty`
			`ifneq (,$(JLINK_POST_FLASH))`
			`$(call target-export-variables,JLINK_FLASH_TARGETS,JLINK_POST_FLASH)`
makefiles/jlink: export JLINK_PRE_FLASH to flash targets 2020-03-03 16:42:37 +01:00			`endif`