mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-08-05 19:50:27 +00:00
3fe4c702e7
The current stty command uses a hard code value of 1200. This is not compliant with SAM-BA specs and may create compatibility problems. Add an optional speed argument with 115200 as default value following SAM-BA specifications. All boards that needs a different speed should define board_runner_args(bossac "--speed=<value>") with value as required speed. Signed-off-by: Gerson Fernando Budke <nandojve@gmail.com>
134 lines
4.6 KiB
Python
134 lines
4.6 KiB
Python
# Copyright (c) 2017 Linaro Limited.
|
|
#
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
|
|
'''bossac-specific runner (flash only) for Atmel SAM microcontrollers.'''
|
|
|
|
import subprocess
|
|
|
|
import platform
|
|
|
|
from runners.core import ZephyrBinaryRunner, RunnerCaps, BuildConfiguration
|
|
|
|
DEFAULT_BOSSAC_PORT = '/dev/ttyACM0'
|
|
DEFAULT_BOSSAC_SPEED = '115200'
|
|
|
|
|
|
class BossacBinaryRunner(ZephyrBinaryRunner):
|
|
'''Runner front-end for bossac.'''
|
|
|
|
def __init__(self, cfg, bossac='bossac', port=DEFAULT_BOSSAC_PORT,
|
|
speed=DEFAULT_BOSSAC_SPEED, offset=None):
|
|
super().__init__(cfg)
|
|
self.bossac = bossac
|
|
self.port = port
|
|
self.speed = speed
|
|
self.offset = offset
|
|
|
|
@classmethod
|
|
def name(cls):
|
|
return 'bossac'
|
|
|
|
@classmethod
|
|
def capabilities(cls):
|
|
return RunnerCaps(commands={'flash'})
|
|
|
|
@classmethod
|
|
def do_add_parser(cls, parser):
|
|
parser.add_argument('--bossac', default='bossac',
|
|
help='path to bossac, default is bossac')
|
|
parser.add_argument('--offset', default=None,
|
|
help='start erase/write/read/verify operation '
|
|
'at flash OFFSET; OFFSET must be aligned '
|
|
' to a flash page boundary')
|
|
parser.add_argument('--bossac-port', default=DEFAULT_BOSSAC_PORT,
|
|
help='serial port to use, default is ' +
|
|
DEFAULT_BOSSAC_PORT)
|
|
parser.add_argument('--speed', default=DEFAULT_BOSSAC_SPEED,
|
|
help='serial port speed to use, default is ' +
|
|
DEFAULT_BOSSAC_SPEED)
|
|
|
|
@classmethod
|
|
def get_flash_offset(cls, cfg):
|
|
# Pull the bootloader size from the config
|
|
build_conf = BuildConfiguration(cfg.build_dir)
|
|
if build_conf['CONFIG_HAS_FLASH_LOAD_OFFSET']:
|
|
return build_conf['CONFIG_FLASH_LOAD_OFFSET']
|
|
|
|
return None
|
|
|
|
@classmethod
|
|
def do_create(cls, cfg, args):
|
|
offset = args.offset
|
|
|
|
if offset is None:
|
|
offset = cls.get_flash_offset(cfg)
|
|
return BossacBinaryRunner(cfg, bossac=args.bossac,
|
|
port=args.bossac_port, speed=args.speed,
|
|
offset=offset)
|
|
|
|
def read_help(self):
|
|
"""Run bossac --help and return the output as a list of lines"""
|
|
self.require(self.bossac)
|
|
try:
|
|
# BOSSA > 1.9.1 returns OK
|
|
out = self.check_output([self.bossac, '--help']).decode()
|
|
except subprocess.CalledProcessError as ex:
|
|
# BOSSA <= 1.9.1 returns an error
|
|
out = ex.output.decode()
|
|
|
|
return out.split('\n')
|
|
|
|
def supports(self, flag):
|
|
"""Check if bossac supports a flag by searching the help"""
|
|
for line in self.read_help():
|
|
if flag in line:
|
|
return True
|
|
return False
|
|
|
|
def get_offset(self, supports_offset):
|
|
"""Validates and returns the flash offset"""
|
|
if supports_offset:
|
|
if self.offset is not None:
|
|
return self.offset
|
|
|
|
self.logger.warning(
|
|
'This version of BOSSA supports the --offset flag but' +
|
|
' no offset was supplied. If flashing fails, then' +
|
|
' please specify the size of the bootloader by adding' +
|
|
' the --offset= flag to board_runner_args in board.cmake')
|
|
return self.offset
|
|
|
|
if self.offset is not None:
|
|
self.logger.warning(
|
|
'This version of BOSSA does not support the --offset flag.' +
|
|
' Please see' +
|
|
' https://github.com/zephyrproject-rtos/sdk-ng/issues/234' +
|
|
' which tracks updating the Zephyr SDK.')
|
|
|
|
return self.offset
|
|
|
|
def do_run(self, command, **kwargs):
|
|
if platform.system() == 'Windows':
|
|
msg = 'CAUTION: BOSSAC runner not support on Windows!'
|
|
raise NotImplementedError(msg)
|
|
|
|
self.require(self.bossac)
|
|
|
|
if platform.system() == 'Linux':
|
|
self.require('stty')
|
|
cmd_stty = ['stty', '-F', self.port, 'raw', 'ispeed', self.speed,
|
|
'ospeed', self.speed, 'cs8', '-cstopb', 'ignpar',
|
|
'eol', '255', 'eof', '255']
|
|
self.check_call(cmd_stty)
|
|
|
|
cmd_flash = [self.bossac, '-p', self.port, '-R', '-e', '-w', '-v',
|
|
'-b', self.cfg.bin_file]
|
|
|
|
offset = self.get_offset(self.supports('--offset'))
|
|
|
|
if offset:
|
|
cmd_flash += ['-o', '%s' % offset]
|
|
|
|
self.check_call(cmd_flash)
|