RIOT-OS/RIOT
RIOT-OS/RIOT
1
0
Fork 0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
Code Releases Activity
faa3727b1f
RIOT/makefiles/tools/openocd.inc.mk

100 lines
3.6 KiB
Makefile
Raw Normal View History

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
FLASHER ?= $(RIOTTOOLS)/openocd/openocd.sh
makefiles/tools: ensure all FLASHER/DEBUGGER* vars are overridable
2020-11-21 22:31:03 +01:00
DEBUGGER ?= $(RIOTTOOLS)/openocd/openocd.sh
DEBUGSERVER ?= $(RIOTTOOLS)/openocd/openocd.sh
openocd: support target debug-client
2023-06-10 00:05:35 +02:00
DEBUGCLIENT ?= $(RIOTTOOLS)/openocd/openocd.sh
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 ?= $(RIOTTOOLS)/openocd/openocd.sh
boards: moved flashing options to openocd Makefile
2015-05-28 15:08:21 +02:00
boards/openocd: use FLASHFILE for boards using openocd Update to use FLASHFILE as file to be flashed on the board.
2018-12-19 19:32:19 +01:00
FLASHFILE ?= $(ELFFILE)
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
openocd: support target debug-client
2023-06-10 00:05:35 +02:00
DEBUGCLIENT_FLAGS ?= debug-client $(DEBUG_ELFFILE)
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: Refactor openocd tool handling Attempt to decouple board configuration from debugger interface configuration by specifying the DEBUG_IFACE variable for the debug hardware interface to use.
2017-10-06 14:53:26 +02:00
make: namespace openocd DEBUG_ADAPTER variable
2021-02-18 17:15:55 +01:00
ifneq (,$(OPENOCD_DEBUG_ADAPTER))
include $(RIOTMAKE)/tools/openocd-adapters/$(OPENOCD_DEBUG_ADAPTER).inc.mk
makefiles/tools/openocd.inc.mk: Improve transport handling Allow setting `OPENOCD_TRANSPORT` to `default` for when a transport to not explicitly set the transport. This is useful when the target or interface script already specify the transport.
2024-01-17 09:14:38 +01:00
ifneq (default,$(OPENOCD_TRANSPORT))
OPENOCD_ADAPTER_INIT += -c 'transport select $(OPENOCD_TRANSPORT)'
endif
makefiles: Refactor openocd tool handling Attempt to decouple board configuration from debugger interface configuration by specifying the DEBUG_IFACE variable for the debug hardware interface to use.
2017-10-06 14:53:26 +02:00
endif
makefiles/openocd: export OPENOCD_CONFIG to required targets
2020-02-22 11:31:39 +01:00
Makefile*: Allow multiple external board dirs - Add the new EXTERNAL_BOARD_DIRS variable that can contain a space separated list of folders containing external boards - Introduce $(BOARDDIR) as shortcut for $(BOARDSDIR)/$(BOARD) - Map the existing BOARDSDIR to the new approach - If BOARDSDIR is provided by the user, it will be added to EXTERNAL_BOARD_DIRS for backward compatibility. (And a warning is issued to encourage users migrating to EXTRA_BOARDS.) - BOARDSDIR is updated after the board is found to "$(BOARDDIR)/..". - Useful for `include $(BOARDSDIR)/common/external_common/Makefile.dep` - Provides backward compatibility
2020-04-14 15:23:23 +02:00
OPENOCD_CONFIG ?= $(BOARDDIR)/dist/openocd.cfg
makefiles/openocd: export OPENOCD_CONFIG to required targets
2020-02-22 11:31:39 +01:00
OPENOCD_TARGETS = debug% flash% reset
tools/openocd: add GDB_PORT_CORE_OFFSET variable In case of muticore CPU, openocd opens one debug port by core for gdb. Thus add a GDB_PORT_CORE_OFFSET port offset to select the right port for debugging. Signed-off-by: Gilles DOFFE <gilles.doffe@savoirfairelinux.com>
2020-09-21 18:16:18 +02:00
# Export GDB_PORT_CORE_OFFSET to required targets
$(call target-export-variables,$(OPENOCD_TARGETS),GDB_PORT_CORE_OFFSET)
# Export OPENOCD_CONFIG to required targets
makefiles/openocd: export OPENOCD_CONFIG to required targets
2020-02-22 11:31:39 +01:00
$(call target-export-variables,$(OPENOCD_TARGETS),OPENOCD_CONFIG)
makefiles/openocd: export OPENOCD_RESET_USE... to required targets
2020-02-24 10:25:32 +01:00
tools/openocd: select target core For multi-arch SoC like STM32MP1, the right target core has to be selected to avoid debugging the wrong default cpu. This is done using openocd command 'targets ${OPENOCD_CORE}'. OPENOCD_CORE has to be set in board Makefile.include file. In case it is not set, the command just display available targets, thus it has no effect on already existing boards using openocd. Signed-off-by: Gilles DOFFE <gilles.doffe@savoirfairelinux.com>
2020-08-02 23:28:10 +02:00
# Export OPENOCD_CORE to required targets
$(call target-export-variables,$(OPENOCD_TARGETS),OPENOCD_CORE)
makefiles/openocd: export OPENOCD_ADAPTER_INIT to required target
2020-02-24 11:35:37 +01:00
# Export OPENOCD_ADAPTER_INIT to required targets
$(call target-export-variables,$(OPENOCD_TARGETS),OPENOCD_ADAPTER_INIT)
makefiles: introduce OPENOCD_POST_INIT_CMDS
2024-11-08 16:03:17 +01:00
# Export OPENOCD_EXTRA_INIT to required targets
$(call target-export-variables,$(OPENOCD_TARGETS),OPENOCD_EXTRA_INIT)
# Export OPENOCD_EXTRA_RESET_INIT to required targets
$(call target-export-variables,$(OPENOCD_TARGETS),OPENOCD_EXTRA_RESET_INIT)
makefiles/openocd: export OPENOCD_RESET_USE... to required targets
2020-02-24 10:25:32 +01:00
# Export OPENOCD_RESET_USE_CONNECT_ASSERT_SRST to required targets
$(call target-export-variables,$(OPENOCD_TARGETS),OPENOCD_RESET_USE_CONNECT_ASSERT_SRST)
makefiles/openocd: export OPENOCD_PRE_VERIFY_CMDS only when required
2020-03-26 09:17:04 +01:00
dist/tools/openocd: add OPENOCD_SERVER_ADDRESS variable
2023-06-09 23:52:01 +02:00
ifneq (,$(OPENOCD_SERVER_ADDRESS))
# Export OPENOCD_SERVER_ADDRESS to required targets
$(call target-export-variables,$(OPENOCD_TARGETS),OPENOCD_SERVER_ADDRESS)
endif
makefiles/openocd: export OPENOCD_CMD_RESET_RUN only when required
2020-03-26 10:00:05 +01:00
ifneq (,$(OPENOCD_CMD_RESET_RUN))
# Export OPENOCD_CMD_RESET_RUN only to the reset target
$(call target-export-variables,reset,OPENOCD_CMD_RESET_RUN)
endif
tools/openocd: Allow specifying a custom halt command Typically, OpenOCD is already performing a reset on connect. A `reset halt` to bring the target to a `halt` state for flashing will result in the device going through a second reset cycle. This can be problematic with some device, such as the CC26xx MCUs. For these devices, an `OPENOCD_CMD_RESET_HALT := -c 'halt'` will avoid the second reset that is causing the issues.
2022-12-21 23:17:13 +01:00
ifneq (,$(OPENOCD_CMD_RESET_HALT))
# Export OPENOCD_CMD_RESET_HALT only to the flash targets
tools/openocd: Fix handling of OPENOCD_CMD_RESET_HALT The OPENOCD_CMD_RESET_HALT was not longer correctly passed to the script. This fixes the issue.
2023-04-25 15:58:34 +02:00
$(call target-export-variables,flash,OPENOCD_CMD_RESET_HALT)
$(call target-export-variables,flash-only,OPENOCD_CMD_RESET_HALT)
tools/openocd: Allow specifying a custom halt command Typically, OpenOCD is already performing a reset on connect. A `reset halt` to bring the target to a `halt` state for flashing will result in the device going through a second reset cycle. This can be problematic with some device, such as the CC26xx MCUs. For these devices, an `OPENOCD_CMD_RESET_HALT := -c 'halt'` will avoid the second reset that is causing the issues.
2022-12-21 23:17:13 +01:00
endif
openocd: support target debug-client
2023-06-10 00:05:35 +02:00
OPENOCD_DEBUG_TARGETS = debug debugr debug-server debug-client
cpu/esp32: Reset when starting debugging To avoid 'Target not examined yet' error
2021-09-28 22:32:18 +02:00
ifneq (,$(OPENOCD_DBG_EXTRA_CMD))
# Export OPENOCD_DBG_EXTRA_CMD only to the flash/flash-only target
$(call target-export-variables,$(OPENOCD_DEBUG_TARGETS),OPENOCD_DBG_EXTRA_CMD)
endif
OPENOCD_FLASH_TARGETS = flash flash-only flashr
makefiles/openocd: define flash targets in a variable
2020-04-07 11:38:10 +02:00
tools/openocd: Export IMAGE_OFFSET only when flashing
2021-09-28 01:13:45 +02:00
ifneq (,$(IMAGE_OFFSET))
# Export IMAGE_OFFSET only to the flash/flash-only target
$(call target-export-variables,$(OPENOCD_FLASH_TARGETS),IMAGE_OFFSET)
endif
makefiles: introduce OPENOCD_POST_INIT_CMDS
2024-11-08 16:03:17 +01:00
ifneq (,$(OPENOCD_POST_INIT_CMDS))
# Export OPENOCD_POST_INIT_CMDS only to the flash/flash-only target
$(call target-export-variables,$(OPENOCD_FLASH_TARGETS),OPENOCD_POST_INIT_CMDS)
endif
makefiles/openocd: export OPENOCD_PRE_VERIFY_CMDS only when required
2020-03-26 09:17:04 +01:00
ifneq (,$(OPENOCD_PRE_VERIFY_CMDS))
# Export OPENOCD_PRE_VERIFY_CMDS only to the flash/flash-only target
makefiles/openocd: define flash targets in a variable
2020-04-07 11:38:10 +02:00
$(call target-export-variables,$(OPENOCD_FLASH_TARGETS),OPENOCD_PRE_VERIFY_CMDS)
makefiles/openocd: export OPENOCD_PRE_VERIFY_CMDS only when required
2020-03-26 09:17:04 +01:00
endif
makefiles/openocd: export OPENOCD_PRE_FLASH_CMDS only when required
2020-03-26 09:30:23 +01:00
tools/openocd: Make verifying flashed image optional Checksumming flash is not supported on xtensa platform: Warn : not implemented yet make: *** [.../RIOT/examples/saul/../../Makefile.include:796: flash] Error 1
2021-09-28 01:26:07 +02:00
ifneq (,$(OPENOCD_SKIP_VERIFY))
# Export OPENOCD_SKIP_VERIFY only to the flash/flash-only target
$(call target-export-variables,$(OPENOCD_FLASH_TARGETS),OPENOCD_SKIP_VERIFY)
endif
makefiles/openocd: export OPENOCD_PRE_FLASH_CMDS only when required
2020-03-26 09:30:23 +01:00
ifneq (,$(OPENOCD_PRE_FLASH_CMDS))
# Export OPENOCD_PRE_FLASH_CMDS only to the flash/flash-only targets
makefiles/openocd: define flash targets in a variable
2020-04-07 11:38:10 +02:00
$(call target-export-variables,$(OPENOCD_FLASH_TARGETS),OPENOCD_PRE_FLASH_CMDS)
makefiles/openocd: export OPENOCD_PRE_FLASH_CMDS only when required
2020-03-26 09:30:23 +01:00
endif
makefiles/openocd: export PRE_FLASH_CHECK_SCRIPT only when required
2020-03-26 09:37:05 +01:00
make: namespace openocd PRE_FLASH_CHECK_SCRIPT variable
2021-02-18 18:18:54 +01:00
ifneq (,$(OPENOCD_PRE_FLASH_CHECK_SCRIPT))
# Export OPENOCD_PRE_FLASH_CHECK_SCRIPT only to the flash/flash-only targets
$(call target-export-variables,$(OPENOCD_FLASH_TARGETS),OPENOCD_PRE_FLASH_CHECK_SCRIPT)
makefiles/openocd: export PRE_FLASH_CHECK_SCRIPT only when required
2020-03-26 09:37:05 +01:00
endif
Copy Permalink