abf9e4d1f4
Internal bootloader will only run application image if valid product header is present on flash. This means product header is required for application that are not linked to code partition. Other applications that are linked to code partition are meant to be run by MCUboot and should not touch product header, with the exception of MCUboot itself which is also run by internal bootloader so requires product header. Default flash load offset for applications not linked to code partition is set to 0x2400 as this is where internal bootloader looks for an application image to run based on product header written by flasher. Flash load offset for MCUboot is set from boot partition. Valid product header is added by ezFlashCLI when using "flash_image" command. Co-authored-by: Andrzej Kaczmarek <andrzej.kaczmarek@codecoup.pl> Signed-off-by: Andrzej Kaczmarek <andrzej.kaczmarek@codecoup.pl> Signed-off-by: Niek Ilmer <niek.ilmer.aj@renesas.com>
75 lines
2.6 KiB
Python
75 lines
2.6 KiB
Python
# Copyright (c) 2022 Renesas Electronics Corporation
|
|
#
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
|
|
'''Runner for flashing with ezFlashCLI.'''
|
|
from runners.core import ZephyrBinaryRunner, RunnerCaps
|
|
|
|
DEFAULT_EZFLASHCLI = "ezFlashCLI"
|
|
|
|
class EzFlashCliBinaryRunner(ZephyrBinaryRunner):
|
|
'''Runner front-end for ezFlashCLI'''
|
|
|
|
def __init__(self, cfg, tool, sn, erase=False):
|
|
super().__init__(cfg)
|
|
self.bin_ = cfg.bin_file
|
|
|
|
self.tool = tool
|
|
self.sn_arg = ['-j', f'{sn}'] if sn is not None else []
|
|
self.erase = bool(erase)
|
|
|
|
@classmethod
|
|
def name(cls):
|
|
return 'ezflashcli'
|
|
|
|
@classmethod
|
|
def capabilities(cls):
|
|
return RunnerCaps(commands={'flash'}, erase=True)
|
|
|
|
@classmethod
|
|
def do_add_parser(cls, parser):
|
|
parser.add_argument('--tool', default=DEFAULT_EZFLASHCLI,
|
|
help='ezFlashCLI path, default is '
|
|
f'{DEFAULT_EZFLASHCLI}')
|
|
parser.add_argument('--sn', default=None, required=False,
|
|
help='J-Link probe serial number')
|
|
|
|
@classmethod
|
|
def do_create(cls, cfg, args):
|
|
return EzFlashCliBinaryRunner(cfg, tool=args.tool, sn=args.sn,
|
|
erase=args.erase)
|
|
|
|
def needs_product_header(self):
|
|
# Applications linked to code partition are meant to be run by MCUboot
|
|
# and do not require product header. Other applications and MCUboot itself
|
|
# are run by internal bootloader and thus require valid product header.
|
|
|
|
is_mcuboot = self.build_conf.getboolean('CONFIG_MCUBOOT')
|
|
uses_code_partition = self.build_conf.getboolean('CONFIG_USE_DT_CODE_PARTITION')
|
|
|
|
return is_mcuboot or not uses_code_partition
|
|
|
|
def program_bin(self):
|
|
|
|
if self.erase:
|
|
self.logger.info("Erasing flash...")
|
|
self.check_call([self.tool] + self.sn_arg + ["erase_flash"])
|
|
|
|
self.logger.info(f"Flashing {self.bin_}...")
|
|
if self.needs_product_header():
|
|
# Write product header and application image at fixed offset as required
|
|
# by internal bootloader.
|
|
self.check_call([self.tool] + self.sn_arg + ["image_flash", self.bin_])
|
|
else:
|
|
load_offset = self.build_conf['CONFIG_FLASH_LOAD_OFFSET']
|
|
self.check_call([self.tool] + self.sn_arg + ["write_flash", f'0x{load_offset:x}', self.bin_])
|
|
|
|
def reset(self):
|
|
self.logger.info("Resetting...")
|
|
self.check_call([self.tool] + self.sn_arg + ["go"])
|
|
|
|
def do_run(self, command, **kwargs):
|
|
self.require(self.tool)
|
|
self.ensure_output('bin')
|
|
self.program_bin()
|
|
self.reset()
|