mbed-os - mbed os with nrf51 internal bandgap enabled to re…

Users » elessair » Code » mbed-os

mbed os with nrf51 internal bandgap enabled to read battery level

Dependents: BLE_file_test BLE_Blink ExternalEncoder

tools/build_api.py@0:f269e3021894, 2016-10-23 (annotated)

Committer:: elessair
Date:: Sun Oct 23 15:10:02 2016 +0000
Revision:: 0:f269e3021894

Initial commit

Who changed what in which revision?

User	Revision	Line number	New contents of line
elessair	0:f269e3021894	1	"""
elessair	0:f269e3021894	2	mbed SDK
elessair	0:f269e3021894	3	Copyright (c) 2011-2016 ARM Limited
elessair	0:f269e3021894	4
elessair	0:f269e3021894	5	Licensed under the Apache License, Version 2.0 (the "License");
elessair	0:f269e3021894	6	you may not use this file except in compliance with the License.
elessair	0:f269e3021894	7	You may obtain a copy of the License at
elessair	0:f269e3021894	8
elessair	0:f269e3021894	9	http://www.apache.org/licenses/LICENSE-2.0
elessair	0:f269e3021894	10
elessair	0:f269e3021894	11	Unless required by applicable law or agreed to in writing, software
elessair	0:f269e3021894	12	distributed under the License is distributed on an "AS IS" BASIS,
elessair	0:f269e3021894	13	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
elessair	0:f269e3021894	14	See the License for the specific language governing permissions and
elessair	0:f269e3021894	15	limitations under the License.
elessair	0:f269e3021894	16	"""
elessair	0:f269e3021894	17
elessair	0:f269e3021894	18	import re
elessair	0:f269e3021894	19	import tempfile
elessair	0:f269e3021894	20	from types import ListType
elessair	0:f269e3021894	21	from shutil import rmtree
elessair	0:f269e3021894	22	from os.path import join, exists, dirname, basename, abspath, normpath
elessair	0:f269e3021894	23	from os import linesep, remove
elessair	0:f269e3021894	24	from time import time
elessair	0:f269e3021894	25
elessair	0:f269e3021894	26	from tools.utils import mkdir, run_cmd, run_cmd_ext, NotSupportedException,\
elessair	0:f269e3021894	27	ToolException, InvalidReleaseTargetException
elessair	0:f269e3021894	28	from tools.paths import MBED_CMSIS_PATH, MBED_TARGETS_PATH, MBED_LIBRARIES,\
elessair	0:f269e3021894	29	MBED_HEADER, MBED_DRIVERS, MBED_PLATFORM, MBED_HAL, MBED_CONFIG_FILE,\
elessair	0:f269e3021894	30	MBED_LIBRARIES_DRIVERS, MBED_LIBRARIES_PLATFORM, MBED_LIBRARIES_HAL,\
elessair	0:f269e3021894	31	BUILD_DIR
elessair	0:f269e3021894	32	from tools.targets import TARGET_NAMES, TARGET_MAP
elessair	0:f269e3021894	33	from tools.libraries import Library
elessair	0:f269e3021894	34	from tools.toolchains import TOOLCHAIN_CLASSES
elessair	0:f269e3021894	35	from jinja2 import FileSystemLoader
elessair	0:f269e3021894	36	from jinja2.environment import Environment
elessair	0:f269e3021894	37	from tools.config import Config
elessair	0:f269e3021894	38
elessair	0:f269e3021894	39	RELEASE_VERSIONS = ['2', '5']
elessair	0:f269e3021894	40
elessair	0:f269e3021894	41	def prep_report(report, target_name, toolchain_name, id_name):
elessair	0:f269e3021894	42	"""Setup report keys
elessair	0:f269e3021894	43
elessair	0:f269e3021894	44	Positional arguments:
elessair	0:f269e3021894	45	report - the report to fill
elessair	0:f269e3021894	46	target_name - the target being used
elessair	0:f269e3021894	47	toolchain_name - the toolchain being used
elessair	0:f269e3021894	48	id_name - the name of the executable or library being built
elessair	0:f269e3021894	49	"""
elessair	0:f269e3021894	50	if not target_name in report:
elessair	0:f269e3021894	51	report[target_name] = {}
elessair	0:f269e3021894	52
elessair	0:f269e3021894	53	if not toolchain_name in report[target_name]:
elessair	0:f269e3021894	54	report[target_name][toolchain_name] = {}
elessair	0:f269e3021894	55
elessair	0:f269e3021894	56	if not id_name in report[target_name][toolchain_name]:
elessair	0:f269e3021894	57	report[target_name][toolchain_name][id_name] = []
elessair	0:f269e3021894	58
elessair	0:f269e3021894	59	def prep_properties(properties, target_name, toolchain_name, vendor_label):
elessair	0:f269e3021894	60	"""Setup test properties
elessair	0:f269e3021894	61
elessair	0:f269e3021894	62	Positional arguments:
elessair	0:f269e3021894	63	properties - the dict to fill
elessair	0:f269e3021894	64	target_name - the target the test is targeting
elessair	0:f269e3021894	65	toolchain_name - the toolchain that will compile the test
elessair	0:f269e3021894	66	vendor_label - the vendor
elessair	0:f269e3021894	67	"""
elessair	0:f269e3021894	68	if not target_name in properties:
elessair	0:f269e3021894	69	properties[target_name] = {}
elessair	0:f269e3021894	70
elessair	0:f269e3021894	71	if not toolchain_name in properties[target_name]:
elessair	0:f269e3021894	72	properties[target_name][toolchain_name] = {}
elessair	0:f269e3021894	73
elessair	0:f269e3021894	74	properties[target_name][toolchain_name]["target"] = target_name
elessair	0:f269e3021894	75	properties[target_name][toolchain_name]["vendor"] = vendor_label
elessair	0:f269e3021894	76	properties[target_name][toolchain_name]["toolchain"] = toolchain_name
elessair	0:f269e3021894	77
elessair	0:f269e3021894	78	def create_result(target_name, toolchain_name, id_name, description):
elessair	0:f269e3021894	79	"""Create a result dictionary
elessair	0:f269e3021894	80
elessair	0:f269e3021894	81	Positional arguments:
elessair	0:f269e3021894	82	target_name - the target being built for
elessair	0:f269e3021894	83	toolchain_name - the toolchain doing the building
elessair	0:f269e3021894	84	id_name - the name of the executable or library being built
elessair	0:f269e3021894	85	description - a human readable description of what's going on
elessair	0:f269e3021894	86	"""
elessair	0:f269e3021894	87	cur_result = {}
elessair	0:f269e3021894	88	cur_result["target_name"] = target_name
elessair	0:f269e3021894	89	cur_result["toolchain_name"] = toolchain_name
elessair	0:f269e3021894	90	cur_result["id"] = id_name
elessair	0:f269e3021894	91	cur_result["description"] = description
elessair	0:f269e3021894	92	cur_result["elapsed_time"] = 0
elessair	0:f269e3021894	93	cur_result["output"] = ""
elessair	0:f269e3021894	94
elessair	0:f269e3021894	95	return cur_result
elessair	0:f269e3021894	96
elessair	0:f269e3021894	97	def add_result_to_report(report, result):
elessair	0:f269e3021894	98	"""Add a single result to a report dictionary
elessair	0:f269e3021894	99
elessair	0:f269e3021894	100	Positional arguments:
elessair	0:f269e3021894	101	report - the report to append to
elessair	0:f269e3021894	102	result - the result to append
elessair	0:f269e3021894	103	"""
elessair	0:f269e3021894	104	target = result["target_name"]
elessair	0:f269e3021894	105	toolchain = result["toolchain_name"]
elessair	0:f269e3021894	106	id_name = result['id']
elessair	0:f269e3021894	107	result_wrap = {0: result}
elessair	0:f269e3021894	108	report[target][toolchain][id_name].append(result_wrap)
elessair	0:f269e3021894	109
elessair	0:f269e3021894	110	def get_config(src_paths, target, toolchain_name):
elessair	0:f269e3021894	111	"""Get the configuration object for a target-toolchain combination
elessair	0:f269e3021894	112
elessair	0:f269e3021894	113	Positional arguments:
elessair	0:f269e3021894	114	src_paths - paths to scan for the configuration files
elessair	0:f269e3021894	115	target - the device we are building for
elessair	0:f269e3021894	116	toolchain_name - the string that identifies the build tools
elessair	0:f269e3021894	117	"""
elessair	0:f269e3021894	118	# Convert src_paths to a list if needed
elessair	0:f269e3021894	119	if type(src_paths) != ListType:
elessair	0:f269e3021894	120	src_paths = [src_paths]
elessair	0:f269e3021894	121
elessair	0:f269e3021894	122	# Pass all params to the unified prepare_resources()
elessair	0:f269e3021894	123	toolchain = prepare_toolchain(src_paths, target, toolchain_name)
elessair	0:f269e3021894	124
elessair	0:f269e3021894	125	# Scan src_path for config files
elessair	0:f269e3021894	126	resources = toolchain.scan_resources(src_paths[0])
elessair	0:f269e3021894	127	for path in src_paths[1:]:
elessair	0:f269e3021894	128	resources.add(toolchain.scan_resources(path))
elessair	0:f269e3021894	129
elessair	0:f269e3021894	130	# Update configuration files until added features creates no changes
elessair	0:f269e3021894	131	prev_features = set()
elessair	0:f269e3021894	132	while True:
elessair	0:f269e3021894	133	# Update the configuration with any .json files found while scanning
elessair	0:f269e3021894	134	toolchain.config.add_config_files(resources.json_files)
elessair	0:f269e3021894	135
elessair	0:f269e3021894	136	# Add features while we find new ones
elessair	0:f269e3021894	137	features = toolchain.config.get_features()
elessair	0:f269e3021894	138	if features == prev_features:
elessair	0:f269e3021894	139	break
elessair	0:f269e3021894	140
elessair	0:f269e3021894	141	for feature in features:
elessair	0:f269e3021894	142	if feature in resources.features:
elessair	0:f269e3021894	143	resources += resources.features[feature]
elessair	0:f269e3021894	144
elessair	0:f269e3021894	145	prev_features = features
elessair	0:f269e3021894	146	toolchain.config.validate_config()
elessair	0:f269e3021894	147
elessair	0:f269e3021894	148	cfg, macros = toolchain.config.get_config_data()
elessair	0:f269e3021894	149	features = toolchain.config.get_features()
elessair	0:f269e3021894	150	return cfg, macros, features
elessair	0:f269e3021894	151
elessair	0:f269e3021894	152	def is_official_target(target_name, version):
elessair	0:f269e3021894	153	""" Returns True, None if a target is part of the official release for the
elessair	0:f269e3021894	154	given version. Return False, 'reason' if a target is not part of the
elessair	0:f269e3021894	155	official release for the given version.
elessair	0:f269e3021894	156
elessair	0:f269e3021894	157	Positional arguments:
elessair	0:f269e3021894	158	target_name - Name if the target (ex. 'K64F')
elessair	0:f269e3021894	159	version - The release version string. Should be a string contained within
elessair	0:f269e3021894	160	RELEASE_VERSIONS
elessair	0:f269e3021894	161	"""
elessair	0:f269e3021894	162
elessair	0:f269e3021894	163	result = True
elessair	0:f269e3021894	164	reason = None
elessair	0:f269e3021894	165	target = TARGET_MAP[target_name]
elessair	0:f269e3021894	166
elessair	0:f269e3021894	167	if hasattr(target, 'release_versions') \
elessair	0:f269e3021894	168	and version in target.release_versions:
elessair	0:f269e3021894	169	if version == '2':
elessair	0:f269e3021894	170	# For version 2, either ARM or uARM toolchain support is required
elessair	0:f269e3021894	171	required_toolchains = set(['ARM', 'uARM'])
elessair	0:f269e3021894	172
elessair	0:f269e3021894	173	if not len(required_toolchains.intersection(
elessair	0:f269e3021894	174	set(target.supported_toolchains))) > 0:
elessair	0:f269e3021894	175	result = False
elessair	0:f269e3021894	176	reason = ("Target '%s' must support " % target.name) + \
elessair	0:f269e3021894	177	("one of the folowing toolchains to be included in the") + \
elessair	0:f269e3021894	178	((" mbed 2.0 official release: %s" + linesep) %
elessair	0:f269e3021894	179	", ".join(required_toolchains)) + \
elessair	0:f269e3021894	180	("Currently it is only configured to support the ") + \
elessair	0:f269e3021894	181	("following toolchains: %s" %
elessair	0:f269e3021894	182	", ".join(target.supported_toolchains))
elessair	0:f269e3021894	183
elessair	0:f269e3021894	184	elif version == '5':
elessair	0:f269e3021894	185	# For version 5, ARM, GCC_ARM, and IAR toolchain support is required
elessair	0:f269e3021894	186	required_toolchains = set(['ARM', 'GCC_ARM', 'IAR'])
elessair	0:f269e3021894	187	required_toolchains_sorted = list(required_toolchains)
elessair	0:f269e3021894	188	required_toolchains_sorted.sort()
elessair	0:f269e3021894	189	supported_toolchains = set(target.supported_toolchains)
elessair	0:f269e3021894	190	supported_toolchains_sorted = list(supported_toolchains)
elessair	0:f269e3021894	191	supported_toolchains_sorted.sort()
elessair	0:f269e3021894	192
elessair	0:f269e3021894	193	if not required_toolchains.issubset(supported_toolchains):
elessair	0:f269e3021894	194	result = False
elessair	0:f269e3021894	195	reason = ("Target '%s' must support " % target.name) + \
elessair	0:f269e3021894	196	("ALL of the folowing toolchains to be included in the") + \
elessair	0:f269e3021894	197	((" mbed OS 5.0 official release: %s" + linesep) %
elessair	0:f269e3021894	198	", ".join(required_toolchains_sorted)) + \
elessair	0:f269e3021894	199	("Currently it is only configured to support the ") + \
elessair	0:f269e3021894	200	("following toolchains: %s" %
elessair	0:f269e3021894	201	", ".join(supported_toolchains_sorted))
elessair	0:f269e3021894	202
elessair	0:f269e3021894	203	elif not target.default_lib == 'std':
elessair	0:f269e3021894	204	result = False
elessair	0:f269e3021894	205	reason = ("Target '%s' must set the " % target.name) + \
elessair	0:f269e3021894	206	("'default_lib' to 'std' to be included in the ") + \
elessair	0:f269e3021894	207	("mbed OS 5.0 official release." + linesep) + \
elessair	0:f269e3021894	208	("Currently it is set to '%s'" % target.default_lib)
elessair	0:f269e3021894	209
elessair	0:f269e3021894	210	else:
elessair	0:f269e3021894	211	result = False
elessair	0:f269e3021894	212	reason = ("Target '%s' has set an invalid release version of '%s'" %
elessair	0:f269e3021894	213	version) + \
elessair	0:f269e3021894	214	("Please choose from the following release versions: %s" %
elessair	0:f269e3021894	215	', '.join(RELEASE_VERSIONS))
elessair	0:f269e3021894	216
elessair	0:f269e3021894	217	else:
elessair	0:f269e3021894	218	result = False
elessair	0:f269e3021894	219	if not hasattr(target, 'release_versions'):
elessair	0:f269e3021894	220	reason = "Target '%s' " % target.name
elessair	0:f269e3021894	221	reason += "does not have the 'release_versions' key set"
elessair	0:f269e3021894	222	elif not version in target.release_versions:
elessair	0:f269e3021894	223	reason = "Target '%s' does not contain the version '%s' " % \
elessair	0:f269e3021894	224	(target.name, version)
elessair	0:f269e3021894	225	reason += "in its 'release_versions' key"
elessair	0:f269e3021894	226
elessair	0:f269e3021894	227	return result, reason
elessair	0:f269e3021894	228
elessair	0:f269e3021894	229	def transform_release_toolchains(toolchains, version):
elessair	0:f269e3021894	230	""" Given a list of toolchains and a release version, return a list of
elessair	0:f269e3021894	231	only the supported toolchains for that release
elessair	0:f269e3021894	232
elessair	0:f269e3021894	233	Positional arguments:
elessair	0:f269e3021894	234	toolchains - The list of toolchains
elessair	0:f269e3021894	235	version - The release version string. Should be a string contained within
elessair	0:f269e3021894	236	RELEASE_VERSIONS
elessair	0:f269e3021894	237	"""
elessair	0:f269e3021894	238	if version == '5':
elessair	0:f269e3021894	239	return ['ARM', 'GCC_ARM', 'IAR']
elessair	0:f269e3021894	240	else:
elessair	0:f269e3021894	241	return toolchains
elessair	0:f269e3021894	242
elessair	0:f269e3021894	243
elessair	0:f269e3021894	244	def get_mbed_official_release(version):
elessair	0:f269e3021894	245	""" Given a release version string, return a tuple that contains a target
elessair	0:f269e3021894	246	and the supported toolchains for that release.
elessair	0:f269e3021894	247	Ex. Given '2', return (('LPC1768', ('ARM', 'GCC_ARM')),
elessair	0:f269e3021894	248	('K64F', ('ARM', 'GCC_ARM')), ...)
elessair	0:f269e3021894	249
elessair	0:f269e3021894	250	Positional arguments:
elessair	0:f269e3021894	251	version - The version string. Should be a string contained within
elessair	0:f269e3021894	252	RELEASE_VERSIONS
elessair	0:f269e3021894	253	"""
elessair	0:f269e3021894	254
elessair	0:f269e3021894	255	mbed_official_release = (
elessair	0:f269e3021894	256	tuple(
elessair	0:f269e3021894	257	tuple(
elessair	0:f269e3021894	258	[
elessair	0:f269e3021894	259	TARGET_MAP[target].name,
elessair	0:f269e3021894	260	tuple(transform_release_toolchains(
elessair	0:f269e3021894	261	TARGET_MAP[target].supported_toolchains, version))
elessair	0:f269e3021894	262	]
elessair	0:f269e3021894	263	) for target in TARGET_NAMES \
elessair	0:f269e3021894	264	if (hasattr(TARGET_MAP[target], 'release_versions')
elessair	0:f269e3021894	265	and version in TARGET_MAP[target].release_versions)
elessair	0:f269e3021894	266	)
elessair	0:f269e3021894	267	)
elessair	0:f269e3021894	268
elessair	0:f269e3021894	269	for target in mbed_official_release:
elessair	0:f269e3021894	270	is_official, reason = is_official_target(target[0], version)
elessair	0:f269e3021894	271
elessair	0:f269e3021894	272	if not is_official:
elessair	0:f269e3021894	273	raise InvalidReleaseTargetException(reason)
elessair	0:f269e3021894	274
elessair	0:f269e3021894	275	return mbed_official_release
elessair	0:f269e3021894	276
elessair	0:f269e3021894	277
elessair	0:f269e3021894	278	def prepare_toolchain(src_paths, target, toolchain_name,
elessair	0:f269e3021894	279	macros=None, clean=False, jobs=1,
elessair	0:f269e3021894	280	notify=None, silent=False, verbose=False,
elessair	0:f269e3021894	281	extra_verbose=False, config=None,
elessair	0:f269e3021894	282	app_config=None, build_profile=None):
elessair	0:f269e3021894	283	""" Prepares resource related objects - toolchain, target, config
elessair	0:f269e3021894	284
elessair	0:f269e3021894	285	Positional arguments:
elessair	0:f269e3021894	286	src_paths - the paths to source directories
elessair	0:f269e3021894	287	target - ['LPC1768', 'LPC11U24', 'LPC2368', etc.]
elessair	0:f269e3021894	288	toolchain_name - ['ARM', 'uARM', 'GCC_ARM', 'GCC_CR']
elessair	0:f269e3021894	289
elessair	0:f269e3021894	290	Keyword arguments:
elessair	0:f269e3021894	291	macros - additional macros
elessair	0:f269e3021894	292	clean - Rebuild everything if True
elessair	0:f269e3021894	293	jobs - how many compilers we can run at once
elessair	0:f269e3021894	294	notify - Notify function for logs
elessair	0:f269e3021894	295	silent - suppress printing of progress indicators
elessair	0:f269e3021894	296	verbose - Write the actual tools command lines used if True
elessair	0:f269e3021894	297	extra_verbose - even more output!
elessair	0:f269e3021894	298	config - a Config object to use instead of creating one
elessair	0:f269e3021894	299	app_config - location of a chosen mbed_app.json file
elessair	0:f269e3021894	300	build_profile - a dict of flags that will be passed to the compiler
elessair	0:f269e3021894	301	"""
elessair	0:f269e3021894	302
elessair	0:f269e3021894	303	# We need to remove all paths which are repeated to avoid
elessair	0:f269e3021894	304	# multiple compilations and linking with the same objects
elessair	0:f269e3021894	305	src_paths = [src_paths[0]] + list(set(src_paths[1:]))
elessair	0:f269e3021894	306
elessair	0:f269e3021894	307	# If the configuration object was not yet created, create it now
elessair	0:f269e3021894	308	config = config or Config(target, src_paths, app_config=app_config)
elessair	0:f269e3021894	309	target = config.target
elessair	0:f269e3021894	310
elessair	0:f269e3021894	311	# Toolchain instance
elessair	0:f269e3021894	312	try:
elessair	0:f269e3021894	313	toolchain = TOOLCHAIN_CLASSES[toolchain_name](
elessair	0:f269e3021894	314	target, notify, macros, silent,
elessair	0:f269e3021894	315	extra_verbose=extra_verbose, build_profile=build_profile)
elessair	0:f269e3021894	316	except KeyError:
elessair	0:f269e3021894	317	raise KeyError("Toolchain %s not supported" % toolchain_name)
elessair	0:f269e3021894	318
elessair	0:f269e3021894	319	toolchain.config = config
elessair	0:f269e3021894	320	toolchain.jobs = jobs
elessair	0:f269e3021894	321	toolchain.build_all = clean
elessair	0:f269e3021894	322	toolchain.VERBOSE = verbose
elessair	0:f269e3021894	323
elessair	0:f269e3021894	324	return toolchain
elessair	0:f269e3021894	325
elessair	0:f269e3021894	326	def scan_resources(src_paths, toolchain, dependencies_paths=None,
elessair	0:f269e3021894	327	inc_dirs=None, base_path=None):
elessair	0:f269e3021894	328	""" Scan resources using initialized toolcain
elessair	0:f269e3021894	329
elessair	0:f269e3021894	330	Positional arguments
elessair	0:f269e3021894	331	src_paths - the paths to source directories
elessair	0:f269e3021894	332	toolchain - valid toolchain object
elessair	0:f269e3021894	333	dependencies_paths - dependency paths that we should scan for include dirs
elessair	0:f269e3021894	334	inc_dirs - additional include directories which should be added to
elessair	0:f269e3021894	335	the scanner resources
elessair	0:f269e3021894	336	"""
elessair	0:f269e3021894	337
elessair	0:f269e3021894	338	# Scan src_path
elessair	0:f269e3021894	339	resources = toolchain.scan_resources(src_paths[0], base_path=base_path)
elessair	0:f269e3021894	340	for path in src_paths[1:]:
elessair	0:f269e3021894	341	resources.add(toolchain.scan_resources(path, base_path=base_path))
elessair	0:f269e3021894	342
elessair	0:f269e3021894	343	# Scan dependency paths for include dirs
elessair	0:f269e3021894	344	if dependencies_paths is not None:
elessair	0:f269e3021894	345	for path in dependencies_paths:
elessair	0:f269e3021894	346	lib_resources = toolchain.scan_resources(path)
elessair	0:f269e3021894	347	resources.inc_dirs.extend(lib_resources.inc_dirs)
elessair	0:f269e3021894	348
elessair	0:f269e3021894	349	# Add additional include directories if passed
elessair	0:f269e3021894	350	if inc_dirs:
elessair	0:f269e3021894	351	if type(inc_dirs) == ListType:
elessair	0:f269e3021894	352	resources.inc_dirs.extend(inc_dirs)
elessair	0:f269e3021894	353	else:
elessair	0:f269e3021894	354	resources.inc_dirs.append(inc_dirs)
elessair	0:f269e3021894	355
elessair	0:f269e3021894	356	# Load resources into the config system which might expand/modify resources
elessair	0:f269e3021894	357	# based on config data
elessair	0:f269e3021894	358	resources = toolchain.config.load_resources(resources)
elessair	0:f269e3021894	359
elessair	0:f269e3021894	360	# Set the toolchain's configuration data
elessair	0:f269e3021894	361	toolchain.set_config_data(toolchain.config.get_config_data())
elessair	0:f269e3021894	362
elessair	0:f269e3021894	363	return resources
elessair	0:f269e3021894	364
elessair	0:f269e3021894	365	def build_project(src_paths, build_path, target, toolchain_name,
elessair	0:f269e3021894	366	libraries_paths=None, linker_script=None,
elessair	0:f269e3021894	367	clean=False, notify=None, verbose=False, name=None,
elessair	0:f269e3021894	368	macros=None, inc_dirs=None, jobs=1, silent=False,
elessair	0:f269e3021894	369	report=None, properties=None, project_id=None,
elessair	0:f269e3021894	370	project_description=None, extra_verbose=False, config=None,
elessair	0:f269e3021894	371	app_config=None, build_profile=None):
elessair	0:f269e3021894	372	""" Build a project. A project may be a test or a user program.
elessair	0:f269e3021894	373
elessair	0:f269e3021894	374	Positional arguments:
elessair	0:f269e3021894	375	src_paths - a path or list of paths that contain all files needed to build
elessair	0:f269e3021894	376	the project
elessair	0:f269e3021894	377	build_path - the directory where all of the object files will be placed
elessair	0:f269e3021894	378	target - the MCU or board that the project will compile for
elessair	0:f269e3021894	379	toolchain_name - the name of the build tools
elessair	0:f269e3021894	380
elessair	0:f269e3021894	381	Keyword arguments:
elessair	0:f269e3021894	382	libraries_paths - The location of libraries to include when linking
elessair	0:f269e3021894	383	linker_script - the file that drives the linker to do it's job
elessair	0:f269e3021894	384	clean - Rebuild everything if True
elessair	0:f269e3021894	385	notify - Notify function for logs
elessair	0:f269e3021894	386	verbose - Write the actual tools command lines used if True
elessair	0:f269e3021894	387	name - the name of the project
elessair	0:f269e3021894	388	macros - additional macros
elessair	0:f269e3021894	389	inc_dirs - additional directories where include files may be found
elessair	0:f269e3021894	390	jobs - how many compilers we can run at once
elessair	0:f269e3021894	391	silent - suppress printing of progress indicators
elessair	0:f269e3021894	392	report - a dict where a result may be appended
elessair	0:f269e3021894	393	properties - UUUUHHHHH beats me
elessair	0:f269e3021894	394	project_id - the name put in the report
elessair	0:f269e3021894	395	project_description - the human-readable version of what this thing does
elessair	0:f269e3021894	396	extra_verbose - even more output!
elessair	0:f269e3021894	397	config - a Config object to use instead of creating one
elessair	0:f269e3021894	398	app_config - location of a chosen mbed_app.json file
elessair	0:f269e3021894	399	build_profile - a dict of flags that will be passed to the compiler
elessair	0:f269e3021894	400	"""
elessair	0:f269e3021894	401
elessair	0:f269e3021894	402	# Convert src_path to a list if needed
elessair	0:f269e3021894	403	if type(src_paths) != ListType:
elessair	0:f269e3021894	404	src_paths = [src_paths]
elessair	0:f269e3021894	405	# Extend src_paths wiht libraries_paths
elessair	0:f269e3021894	406	if libraries_paths is not None:
elessair	0:f269e3021894	407	src_paths.extend(libraries_paths)
elessair	0:f269e3021894	408	inc_dirs.extend(map(dirname, libraries_paths))
elessair	0:f269e3021894	409
elessair	0:f269e3021894	410	# Build Directory
elessair	0:f269e3021894	411	if clean and exists(build_path):
elessair	0:f269e3021894	412	rmtree(build_path)
elessair	0:f269e3021894	413	mkdir(build_path)
elessair	0:f269e3021894	414
elessair	0:f269e3021894	415	# Pass all params to the unified prepare_toolchain()
elessair	0:f269e3021894	416	toolchain = prepare_toolchain(
elessair	0:f269e3021894	417	src_paths, target, toolchain_name, macros=macros, clean=clean,
elessair	0:f269e3021894	418	jobs=jobs, notify=notify, silent=silent, verbose=verbose,
elessair	0:f269e3021894	419	extra_verbose=extra_verbose, config=config, app_config=app_config,
elessair	0:f269e3021894	420	build_profile=build_profile)
elessair	0:f269e3021894	421
elessair	0:f269e3021894	422	# The first path will give the name to the library
elessair	0:f269e3021894	423	if name is None:
elessair	0:f269e3021894	424	name = basename(normpath(abspath(src_paths[0])))
elessair	0:f269e3021894	425	toolchain.info("Building project %s (%s, %s)" %
elessair	0:f269e3021894	426	(name, toolchain.target.name, toolchain_name))
elessair	0:f269e3021894	427
elessair	0:f269e3021894	428	# Initialize reporting
elessair	0:f269e3021894	429	if report != None:
elessair	0:f269e3021894	430	start = time()
elessair	0:f269e3021894	431	# If project_id is specified, use that over the default name
elessair	0:f269e3021894	432	id_name = project_id.upper() if project_id else name.upper()
elessair	0:f269e3021894	433	description = project_description if project_description else name
elessair	0:f269e3021894	434	vendor_label = toolchain.target.extra_labels[0]
elessair	0:f269e3021894	435	prep_report(report, toolchain.target.name, toolchain_name, id_name)
elessair	0:f269e3021894	436	cur_result = create_result(toolchain.target.name, toolchain_name,
elessair	0:f269e3021894	437	id_name, description)
elessair	0:f269e3021894	438	if properties != None:
elessair	0:f269e3021894	439	prep_properties(properties, toolchain.target.name, toolchain_name,
elessair	0:f269e3021894	440	vendor_label)
elessair	0:f269e3021894	441
elessair	0:f269e3021894	442	try:
elessair	0:f269e3021894	443	# Call unified scan_resources
elessair	0:f269e3021894	444	resources = scan_resources(src_paths, toolchain, inc_dirs=inc_dirs)
elessair	0:f269e3021894	445
elessair	0:f269e3021894	446	# Change linker script if specified
elessair	0:f269e3021894	447	if linker_script is not None:
elessair	0:f269e3021894	448	resources.linker_script = linker_script
elessair	0:f269e3021894	449
elessair	0:f269e3021894	450	# Compile Sources
elessair	0:f269e3021894	451	objects = toolchain.compile_sources(resources, build_path,
elessair	0:f269e3021894	452	resources.inc_dirs)
elessair	0:f269e3021894	453	resources.objects.extend(objects)
elessair	0:f269e3021894	454
elessair	0:f269e3021894	455	# Link Program
elessair	0:f269e3021894	456	res, _ = toolchain.link_program(resources, build_path, name)
elessair	0:f269e3021894	457
elessair	0:f269e3021894	458	memap_instance = getattr(toolchain, 'memap_instance', None)
elessair	0:f269e3021894	459	memap_table = ''
elessair	0:f269e3021894	460	if memap_instance:
elessair	0:f269e3021894	461	# Write output to stdout in text (pretty table) format
elessair	0:f269e3021894	462	memap_table = memap_instance.generate_output('table')
elessair	0:f269e3021894	463
elessair	0:f269e3021894	464	if not silent:
elessair	0:f269e3021894	465	print memap_table
elessair	0:f269e3021894	466
elessair	0:f269e3021894	467	# Write output to file in JSON format
elessair	0:f269e3021894	468	map_out = join(build_path, name + "_map.json")
elessair	0:f269e3021894	469	memap_instance.generate_output('json', map_out)
elessair	0:f269e3021894	470
elessair	0:f269e3021894	471	# Write output to file in CSV format for the CI
elessair	0:f269e3021894	472	map_csv = join(build_path, name + "_map.csv")
elessair	0:f269e3021894	473	memap_instance.generate_output('csv-ci', map_csv)
elessair	0:f269e3021894	474
elessair	0:f269e3021894	475	resources.detect_duplicates(toolchain)
elessair	0:f269e3021894	476
elessair	0:f269e3021894	477	if report != None:
elessair	0:f269e3021894	478	end = time()
elessair	0:f269e3021894	479	cur_result["elapsed_time"] = end - start
elessair	0:f269e3021894	480	cur_result["output"] = toolchain.get_output() + memap_table
elessair	0:f269e3021894	481	cur_result["result"] = "OK"
elessair	0:f269e3021894	482	cur_result["memory_usage"] = toolchain.map_outputs
elessair	0:f269e3021894	483
elessair	0:f269e3021894	484	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	485
elessair	0:f269e3021894	486	return res
elessair	0:f269e3021894	487
elessair	0:f269e3021894	488	except Exception as exc:
elessair	0:f269e3021894	489	if report != None:
elessair	0:f269e3021894	490	end = time()
elessair	0:f269e3021894	491
elessair	0:f269e3021894	492	if isinstance(exc, NotSupportedException):
elessair	0:f269e3021894	493	cur_result["result"] = "NOT_SUPPORTED"
elessair	0:f269e3021894	494	else:
elessair	0:f269e3021894	495	cur_result["result"] = "FAIL"
elessair	0:f269e3021894	496
elessair	0:f269e3021894	497	cur_result["elapsed_time"] = end - start
elessair	0:f269e3021894	498
elessair	0:f269e3021894	499	toolchain_output = toolchain.get_output()
elessair	0:f269e3021894	500	if toolchain_output:
elessair	0:f269e3021894	501	cur_result["output"] += toolchain_output
elessair	0:f269e3021894	502
elessair	0:f269e3021894	503	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	504
elessair	0:f269e3021894	505	# Let Exception propagate
elessair	0:f269e3021894	506	raise
elessair	0:f269e3021894	507
elessair	0:f269e3021894	508	def build_library(src_paths, build_path, target, toolchain_name,
elessair	0:f269e3021894	509	dependencies_paths=None, name=None, clean=False,
elessair	0:f269e3021894	510	archive=True, notify=None, verbose=False, macros=None,
elessair	0:f269e3021894	511	inc_dirs=None, jobs=1, silent=False, report=None,
elessair	0:f269e3021894	512	properties=None, extra_verbose=False, project_id=None,
elessair	0:f269e3021894	513	remove_config_header_file=False, app_config=None,
elessair	0:f269e3021894	514	build_profile=None):
elessair	0:f269e3021894	515	""" Build a library
elessair	0:f269e3021894	516
elessair	0:f269e3021894	517	Positional arguments:
elessair	0:f269e3021894	518	src_paths - a path or list of paths that contain all files needed to build
elessair	0:f269e3021894	519	the library
elessair	0:f269e3021894	520	build_path - the directory where all of the object files will be placed
elessair	0:f269e3021894	521	target - the MCU or board that the project will compile for
elessair	0:f269e3021894	522	toolchain_name - the name of the build tools
elessair	0:f269e3021894	523
elessair	0:f269e3021894	524	Keyword arguments:
elessair	0:f269e3021894	525	dependencies_paths - The location of libraries to include when linking
elessair	0:f269e3021894	526	name - the name of the library
elessair	0:f269e3021894	527	clean - Rebuild everything if True
elessair	0:f269e3021894	528	archive - whether the library will create an archive file
elessair	0:f269e3021894	529	notify - Notify function for logs
elessair	0:f269e3021894	530	verbose - Write the actual tools command lines used if True
elessair	0:f269e3021894	531	macros - additional macros
elessair	0:f269e3021894	532	inc_dirs - additional directories where include files may be found
elessair	0:f269e3021894	533	jobs - how many compilers we can run at once
elessair	0:f269e3021894	534	silent - suppress printing of progress indicators
elessair	0:f269e3021894	535	report - a dict where a result may be appended
elessair	0:f269e3021894	536	properties - UUUUHHHHH beats me
elessair	0:f269e3021894	537	extra_verbose - even more output!
elessair	0:f269e3021894	538	project_id - the name that goes in the report
elessair	0:f269e3021894	539	remove_config_header_file - delete config header file when done building
elessair	0:f269e3021894	540	app_config - location of a chosen mbed_app.json file
elessair	0:f269e3021894	541	build_profile - a dict of flags that will be passed to the compiler
elessair	0:f269e3021894	542	"""
elessair	0:f269e3021894	543
elessair	0:f269e3021894	544	# Convert src_path to a list if needed
elessair	0:f269e3021894	545	if type(src_paths) != ListType:
elessair	0:f269e3021894	546	src_paths = [src_paths]
elessair	0:f269e3021894	547
elessair	0:f269e3021894	548	# Build path
elessair	0:f269e3021894	549	if archive:
elessair	0:f269e3021894	550	# Use temp path when building archive
elessair	0:f269e3021894	551	tmp_path = join(build_path, '.temp')
elessair	0:f269e3021894	552	mkdir(tmp_path)
elessair	0:f269e3021894	553	else:
elessair	0:f269e3021894	554	tmp_path = build_path
elessair	0:f269e3021894	555
elessair	0:f269e3021894	556	# Clean the build directory
elessair	0:f269e3021894	557	if clean and exists(tmp_path):
elessair	0:f269e3021894	558	rmtree(tmp_path)
elessair	0:f269e3021894	559	mkdir(tmp_path)
elessair	0:f269e3021894	560
elessair	0:f269e3021894	561	# Pass all params to the unified prepare_toolchain()
elessair	0:f269e3021894	562	toolchain = prepare_toolchain(
elessair	0:f269e3021894	563	src_paths, target, toolchain_name, macros=macros, clean=clean,
elessair	0:f269e3021894	564	jobs=jobs, notify=notify, silent=silent, verbose=verbose,
elessair	0:f269e3021894	565	extra_verbose=extra_verbose, app_config=app_config,
elessair	0:f269e3021894	566	build_profile=build_profile)
elessair	0:f269e3021894	567
elessair	0:f269e3021894	568	# The first path will give the name to the library
elessair	0:f269e3021894	569	if name is None:
elessair	0:f269e3021894	570	name = basename(normpath(abspath(src_paths[0])))
elessair	0:f269e3021894	571	toolchain.info("Building library %s (%s, %s)" %
elessair	0:f269e3021894	572	(name, toolchain.target.name, toolchain_name))
elessair	0:f269e3021894	573
elessair	0:f269e3021894	574	# Initialize reporting
elessair	0:f269e3021894	575	if report != None:
elessair	0:f269e3021894	576	start = time()
elessair	0:f269e3021894	577	# If project_id is specified, use that over the default name
elessair	0:f269e3021894	578	id_name = project_id.upper() if project_id else name.upper()
elessair	0:f269e3021894	579	description = name
elessair	0:f269e3021894	580	vendor_label = toolchain.target.extra_labels[0]
elessair	0:f269e3021894	581	prep_report(report, toolchain.target.name, toolchain_name, id_name)
elessair	0:f269e3021894	582	cur_result = create_result(toolchain.target.name, toolchain_name,
elessair	0:f269e3021894	583	id_name, description)
elessair	0:f269e3021894	584	if properties != None:
elessair	0:f269e3021894	585	prep_properties(properties, toolchain.target.name, toolchain_name,
elessair	0:f269e3021894	586	vendor_label)
elessair	0:f269e3021894	587
elessair	0:f269e3021894	588	for src_path in src_paths:
elessair	0:f269e3021894	589	if not exists(src_path):
elessair	0:f269e3021894	590	error_msg = "The library source folder does not exist: %s", src_path
elessair	0:f269e3021894	591	if report != None:
elessair	0:f269e3021894	592	cur_result["output"] = error_msg
elessair	0:f269e3021894	593	cur_result["result"] = "FAIL"
elessair	0:f269e3021894	594	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	595	raise Exception(error_msg)
elessair	0:f269e3021894	596
elessair	0:f269e3021894	597	try:
elessair	0:f269e3021894	598	# Call unified scan_resources
elessair	0:f269e3021894	599	resources = scan_resources(src_paths, toolchain,
elessair	0:f269e3021894	600	dependencies_paths=dependencies_paths,
elessair	0:f269e3021894	601	inc_dirs=inc_dirs)
elessair	0:f269e3021894	602
elessair	0:f269e3021894	603
elessair	0:f269e3021894	604	# Copy headers, objects and static libraries - all files needed for
elessair	0:f269e3021894	605	# static lib
elessair	0:f269e3021894	606	toolchain.copy_files(resources.headers, build_path, resources=resources)
elessair	0:f269e3021894	607	toolchain.copy_files(resources.objects, build_path, resources=resources)
elessair	0:f269e3021894	608	toolchain.copy_files(resources.libraries, build_path,
elessair	0:f269e3021894	609	resources=resources)
elessair	0:f269e3021894	610	toolchain.copy_files(resources.json_files, build_path,
elessair	0:f269e3021894	611	resources=resources)
elessair	0:f269e3021894	612	if resources.linker_script:
elessair	0:f269e3021894	613	toolchain.copy_files(resources.linker_script, build_path,
elessair	0:f269e3021894	614	resources=resources)
elessair	0:f269e3021894	615
elessair	0:f269e3021894	616	if resources.hex_files:
elessair	0:f269e3021894	617	toolchain.copy_files(resources.hex_files, build_path,
elessair	0:f269e3021894	618	resources=resources)
elessair	0:f269e3021894	619
elessair	0:f269e3021894	620	# Compile Sources
elessair	0:f269e3021894	621	objects = toolchain.compile_sources(resources, abspath(tmp_path),
elessair	0:f269e3021894	622	resources.inc_dirs)
elessair	0:f269e3021894	623	resources.objects.extend(objects)
elessair	0:f269e3021894	624
elessair	0:f269e3021894	625	if archive:
elessair	0:f269e3021894	626	toolchain.build_library(objects, build_path, name)
elessair	0:f269e3021894	627
elessair	0:f269e3021894	628	if remove_config_header_file:
elessair	0:f269e3021894	629	config_header_path = toolchain.get_config_header()
elessair	0:f269e3021894	630	if config_header_path:
elessair	0:f269e3021894	631	remove(config_header_path)
elessair	0:f269e3021894	632
elessair	0:f269e3021894	633	if report != None:
elessair	0:f269e3021894	634	end = time()
elessair	0:f269e3021894	635	cur_result["elapsed_time"] = end - start
elessair	0:f269e3021894	636	cur_result["output"] = toolchain.get_output()
elessair	0:f269e3021894	637	cur_result["result"] = "OK"
elessair	0:f269e3021894	638
elessair	0:f269e3021894	639
elessair	0:f269e3021894	640	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	641	return True
elessair	0:f269e3021894	642
elessair	0:f269e3021894	643	except Exception as exc:
elessair	0:f269e3021894	644	if report != None:
elessair	0:f269e3021894	645	end = time()
elessair	0:f269e3021894	646
elessair	0:f269e3021894	647	if isinstance(exc, ToolException):
elessair	0:f269e3021894	648	cur_result["result"] = "FAIL"
elessair	0:f269e3021894	649	elif isinstance(exc, NotSupportedException):
elessair	0:f269e3021894	650	cur_result["result"] = "NOT_SUPPORTED"
elessair	0:f269e3021894	651
elessair	0:f269e3021894	652	cur_result["elapsed_time"] = end - start
elessair	0:f269e3021894	653
elessair	0:f269e3021894	654	toolchain_output = toolchain.get_output()
elessair	0:f269e3021894	655	if toolchain_output:
elessair	0:f269e3021894	656	cur_result["output"] += toolchain_output
elessair	0:f269e3021894	657
elessair	0:f269e3021894	658	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	659
elessair	0:f269e3021894	660	# Let Exception propagate
elessair	0:f269e3021894	661	raise
elessair	0:f269e3021894	662
elessair	0:f269e3021894	663	######################
elessair	0:f269e3021894	664	### Legacy methods ###
elessair	0:f269e3021894	665	######################
elessair	0:f269e3021894	666
elessair	0:f269e3021894	667	def build_lib(lib_id, target, toolchain_name, verbose=False,
elessair	0:f269e3021894	668	clean=False, macros=None, notify=None, jobs=1, silent=False,
elessair	0:f269e3021894	669	report=None, properties=None, extra_verbose=False,
elessair	0:f269e3021894	670	build_profile=None):
elessair	0:f269e3021894	671	""" Legacy method for building mbed libraries
elessair	0:f269e3021894	672
elessair	0:f269e3021894	673	Positional arguments:
elessair	0:f269e3021894	674	lib_id - the library's unique identifier
elessair	0:f269e3021894	675	target - the MCU or board that the project will compile for
elessair	0:f269e3021894	676	toolchain_name - the name of the build tools
elessair	0:f269e3021894	677
elessair	0:f269e3021894	678	Keyword arguments:
elessair	0:f269e3021894	679	clean - Rebuild everything if True
elessair	0:f269e3021894	680	verbose - Write the actual tools command lines used if True
elessair	0:f269e3021894	681	macros - additional macros
elessair	0:f269e3021894	682	notify - Notify function for logs
elessair	0:f269e3021894	683	jobs - how many compilers we can run at once
elessair	0:f269e3021894	684	silent - suppress printing of progress indicators
elessair	0:f269e3021894	685	report - a dict where a result may be appended
elessair	0:f269e3021894	686	properties - UUUUHHHHH beats me
elessair	0:f269e3021894	687	extra_verbose - even more output!
elessair	0:f269e3021894	688	build_profile - a dict of flags that will be passed to the compiler
elessair	0:f269e3021894	689	"""
elessair	0:f269e3021894	690	lib = Library(lib_id)
elessair	0:f269e3021894	691	if not lib.is_supported(target, toolchain_name):
elessair	0:f269e3021894	692	print('Library "%s" is not yet supported on target %s with toolchain %s'
elessair	0:f269e3021894	693	% (lib_id, target.name, toolchain_name))
elessair	0:f269e3021894	694	return False
elessair	0:f269e3021894	695
elessair	0:f269e3021894	696	# We need to combine macros from parameter list with macros from library
elessair	0:f269e3021894	697	# definition
elessair	0:f269e3021894	698	lib_macros = lib.macros if lib.macros else []
elessair	0:f269e3021894	699	if macros:
elessair	0:f269e3021894	700	macros.extend(lib_macros)
elessair	0:f269e3021894	701	else:
elessair	0:f269e3021894	702	macros = lib_macros
elessair	0:f269e3021894	703
elessair	0:f269e3021894	704	src_paths = lib.source_dir
elessair	0:f269e3021894	705	build_path = lib.build_dir
elessair	0:f269e3021894	706	dependencies_paths = lib.dependencies
elessair	0:f269e3021894	707	inc_dirs = lib.inc_dirs
elessair	0:f269e3021894	708	inc_dirs_ext = lib.inc_dirs_ext
elessair	0:f269e3021894	709
elessair	0:f269e3021894	710	if type(src_paths) != ListType:
elessair	0:f269e3021894	711	src_paths = [src_paths]
elessair	0:f269e3021894	712
elessair	0:f269e3021894	713	# The first path will give the name to the library
elessair	0:f269e3021894	714	name = basename(src_paths[0])
elessair	0:f269e3021894	715
elessair	0:f269e3021894	716	if report != None:
elessair	0:f269e3021894	717	start = time()
elessair	0:f269e3021894	718	id_name = name.upper()
elessair	0:f269e3021894	719	description = name
elessair	0:f269e3021894	720	vendor_label = target.extra_labels[0]
elessair	0:f269e3021894	721	cur_result = None
elessair	0:f269e3021894	722	prep_report(report, target.name, toolchain_name, id_name)
elessair	0:f269e3021894	723	cur_result = create_result(target.name, toolchain_name, id_name,
elessair	0:f269e3021894	724	description)
elessair	0:f269e3021894	725
elessair	0:f269e3021894	726	if properties != None:
elessair	0:f269e3021894	727	prep_properties(properties, target.name, toolchain_name,
elessair	0:f269e3021894	728	vendor_label)
elessair	0:f269e3021894	729
elessair	0:f269e3021894	730	for src_path in src_paths:
elessair	0:f269e3021894	731	if not exists(src_path):
elessair	0:f269e3021894	732	error_msg = "The library source folder does not exist: %s", src_path
elessair	0:f269e3021894	733
elessair	0:f269e3021894	734	if report != None:
elessair	0:f269e3021894	735	cur_result["output"] = error_msg
elessair	0:f269e3021894	736	cur_result["result"] = "FAIL"
elessair	0:f269e3021894	737	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	738
elessair	0:f269e3021894	739	raise Exception(error_msg)
elessair	0:f269e3021894	740
elessair	0:f269e3021894	741	try:
elessair	0:f269e3021894	742	# Toolchain instance
elessair	0:f269e3021894	743	toolchain = TOOLCHAIN_CLASSES[toolchain_name](
elessair	0:f269e3021894	744	target, macros=macros, notify=notify, silent=silent,
elessair	0:f269e3021894	745	extra_verbose=extra_verbose, build_profile=build_profile)
elessair	0:f269e3021894	746	toolchain.VERBOSE = verbose
elessair	0:f269e3021894	747	toolchain.jobs = jobs
elessair	0:f269e3021894	748	toolchain.build_all = clean
elessair	0:f269e3021894	749
elessair	0:f269e3021894	750	toolchain.info("Building library %s (%s, %s)" %
elessair	0:f269e3021894	751	(name.upper(), target.name, toolchain_name))
elessair	0:f269e3021894	752
elessair	0:f269e3021894	753	# Take into account the library configuration (MBED_CONFIG_FILE)
elessair	0:f269e3021894	754	config = Config(target)
elessair	0:f269e3021894	755	toolchain.config = config
elessair	0:f269e3021894	756	config.add_config_files([MBED_CONFIG_FILE])
elessair	0:f269e3021894	757
elessair	0:f269e3021894	758	# Scan Resources
elessair	0:f269e3021894	759	resources = []
elessair	0:f269e3021894	760	for src_path in src_paths:
elessair	0:f269e3021894	761	resources.append(toolchain.scan_resources(src_path))
elessair	0:f269e3021894	762
elessair	0:f269e3021894	763	# Add extra include directories / files which are required by library
elessair	0:f269e3021894	764	# This files usually are not in the same directory as source files so
elessair	0:f269e3021894	765	# previous scan will not include them
elessair	0:f269e3021894	766	if inc_dirs_ext is not None:
elessair	0:f269e3021894	767	for inc_ext in inc_dirs_ext:
elessair	0:f269e3021894	768	resources.append(toolchain.scan_resources(inc_ext))
elessair	0:f269e3021894	769
elessair	0:f269e3021894	770	# Dependencies Include Paths
elessair	0:f269e3021894	771	dependencies_include_dir = []
elessair	0:f269e3021894	772	if dependencies_paths is not None:
elessair	0:f269e3021894	773	for path in dependencies_paths:
elessair	0:f269e3021894	774	lib_resources = toolchain.scan_resources(path)
elessair	0:f269e3021894	775	dependencies_include_dir.extend(lib_resources.inc_dirs)
elessair	0:f269e3021894	776	dependencies_include_dir.extend(map(dirname, lib_resources.inc_dirs))
elessair	0:f269e3021894	777
elessair	0:f269e3021894	778	if inc_dirs:
elessair	0:f269e3021894	779	dependencies_include_dir.extend(inc_dirs)
elessair	0:f269e3021894	780
elessair	0:f269e3021894	781	# Add other discovered configuration data to the configuration object
elessair	0:f269e3021894	782	for res in resources:
elessair	0:f269e3021894	783	config.load_resources(res)
elessair	0:f269e3021894	784	toolchain.set_config_data(toolchain.config.get_config_data())
elessair	0:f269e3021894	785
elessair	0:f269e3021894	786	# Create the desired build directory structure
elessair	0:f269e3021894	787	bin_path = join(build_path, toolchain.obj_path)
elessair	0:f269e3021894	788	mkdir(bin_path)
elessair	0:f269e3021894	789	tmp_path = join(build_path, '.temp', toolchain.obj_path)
elessair	0:f269e3021894	790	mkdir(tmp_path)
elessair	0:f269e3021894	791
elessair	0:f269e3021894	792	# Copy Headers
elessair	0:f269e3021894	793	for resource in resources:
elessair	0:f269e3021894	794	toolchain.copy_files(resource.headers, build_path,
elessair	0:f269e3021894	795	resources=resource)
elessair	0:f269e3021894	796
elessair	0:f269e3021894	797	dependencies_include_dir.extend(
elessair	0:f269e3021894	798	toolchain.scan_resources(build_path).inc_dirs)
elessair	0:f269e3021894	799
elessair	0:f269e3021894	800	# Compile Sources
elessair	0:f269e3021894	801	objects = []
elessair	0:f269e3021894	802	for resource in resources:
elessair	0:f269e3021894	803	objects.extend(toolchain.compile_sources(resource, tmp_path,
elessair	0:f269e3021894	804	dependencies_include_dir))
elessair	0:f269e3021894	805
elessair	0:f269e3021894	806	needed_update = toolchain.build_library(objects, bin_path, name)
elessair	0:f269e3021894	807
elessair	0:f269e3021894	808	if report != None and needed_update:
elessair	0:f269e3021894	809	end = time()
elessair	0:f269e3021894	810	cur_result["elapsed_time"] = end - start
elessair	0:f269e3021894	811	cur_result["output"] = toolchain.get_output()
elessair	0:f269e3021894	812	cur_result["result"] = "OK"
elessair	0:f269e3021894	813
elessair	0:f269e3021894	814	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	815	return True
elessair	0:f269e3021894	816
elessair	0:f269e3021894	817	except Exception:
elessair	0:f269e3021894	818	if report != None:
elessair	0:f269e3021894	819	end = time()
elessair	0:f269e3021894	820	cur_result["result"] = "FAIL"
elessair	0:f269e3021894	821	cur_result["elapsed_time"] = end - start
elessair	0:f269e3021894	822
elessair	0:f269e3021894	823	toolchain_output = toolchain.get_output()
elessair	0:f269e3021894	824	if toolchain_output:
elessair	0:f269e3021894	825	cur_result["output"] += toolchain_output
elessair	0:f269e3021894	826
elessair	0:f269e3021894	827	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	828
elessair	0:f269e3021894	829	# Let Exception propagate
elessair	0:f269e3021894	830	raise
elessair	0:f269e3021894	831
elessair	0:f269e3021894	832	# We do have unique legacy conventions about how we build and package the mbed
elessair	0:f269e3021894	833	# library
elessair	0:f269e3021894	834	def build_mbed_libs(target, toolchain_name, verbose=False,
elessair	0:f269e3021894	835	clean=False, macros=None, notify=None, jobs=1, silent=False,
elessair	0:f269e3021894	836	report=None, properties=None, extra_verbose=False,
elessair	0:f269e3021894	837	build_profile=None):
elessair	0:f269e3021894	838	""" Function returns True is library was built and false if building was
elessair	0:f269e3021894	839	skipped
elessair	0:f269e3021894	840
elessair	0:f269e3021894	841	Positional arguments:
elessair	0:f269e3021894	842	target - the MCU or board that the project will compile for
elessair	0:f269e3021894	843	toolchain_name - the name of the build tools
elessair	0:f269e3021894	844
elessair	0:f269e3021894	845	Keyword arguments:
elessair	0:f269e3021894	846	verbose - Write the actual tools command lines used if True
elessair	0:f269e3021894	847	clean - Rebuild everything if True
elessair	0:f269e3021894	848	macros - additional macros
elessair	0:f269e3021894	849	notify - Notify function for logs
elessair	0:f269e3021894	850	jobs - how many compilers we can run at once
elessair	0:f269e3021894	851	silent - suppress printing of progress indicators
elessair	0:f269e3021894	852	report - a dict where a result may be appended
elessair	0:f269e3021894	853	properties - UUUUHHHHH beats me
elessair	0:f269e3021894	854	extra_verbose - even more output!
elessair	0:f269e3021894	855	build_profile - a dict of flags that will be passed to the compiler
elessair	0:f269e3021894	856	"""
elessair	0:f269e3021894	857
elessair	0:f269e3021894	858	if report != None:
elessair	0:f269e3021894	859	start = time()
elessair	0:f269e3021894	860	id_name = "MBED"
elessair	0:f269e3021894	861	description = "mbed SDK"
elessair	0:f269e3021894	862	vendor_label = target.extra_labels[0]
elessair	0:f269e3021894	863	cur_result = None
elessair	0:f269e3021894	864	prep_report(report, target.name, toolchain_name, id_name)
elessair	0:f269e3021894	865	cur_result = create_result(target.name, toolchain_name, id_name,
elessair	0:f269e3021894	866	description)
elessair	0:f269e3021894	867
elessair	0:f269e3021894	868	if properties != None:
elessair	0:f269e3021894	869	prep_properties(properties, target.name, toolchain_name,
elessair	0:f269e3021894	870	vendor_label)
elessair	0:f269e3021894	871
elessair	0:f269e3021894	872	# Check toolchain support
elessair	0:f269e3021894	873	if toolchain_name not in target.supported_toolchains:
elessair	0:f269e3021894	874	supported_toolchains_text = ", ".join(target.supported_toolchains)
elessair	0:f269e3021894	875	print('%s target is not yet supported by toolchain %s' %
elessair	0:f269e3021894	876	(target.name, toolchain_name))
elessair	0:f269e3021894	877	print('%s target supports %s toolchain%s' %
elessair	0:f269e3021894	878	(target.name, supported_toolchains_text, 's'
elessair	0:f269e3021894	879	if len(target.supported_toolchains) > 1 else ''))
elessair	0:f269e3021894	880
elessair	0:f269e3021894	881	if report != None:
elessair	0:f269e3021894	882	cur_result["result"] = "SKIP"
elessair	0:f269e3021894	883	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	884
elessair	0:f269e3021894	885	return False
elessair	0:f269e3021894	886
elessair	0:f269e3021894	887	try:
elessair	0:f269e3021894	888	# Toolchain
elessair	0:f269e3021894	889	toolchain = TOOLCHAIN_CLASSES[toolchain_name](
elessair	0:f269e3021894	890	target, macros=macros, notify=notify, silent=silent,
elessair	0:f269e3021894	891	extra_verbose=extra_verbose, build_profile=build_profile)
elessair	0:f269e3021894	892	toolchain.VERBOSE = verbose
elessair	0:f269e3021894	893	toolchain.jobs = jobs
elessair	0:f269e3021894	894	toolchain.build_all = clean
elessair	0:f269e3021894	895
elessair	0:f269e3021894	896	# Take into account the library configuration (MBED_CONFIG_FILE)
elessair	0:f269e3021894	897	config = Config(target)
elessair	0:f269e3021894	898	toolchain.config = config
elessair	0:f269e3021894	899	config.add_config_files([MBED_CONFIG_FILE])
elessair	0:f269e3021894	900	toolchain.set_config_data(toolchain.config.get_config_data())
elessair	0:f269e3021894	901
elessair	0:f269e3021894	902	# Source and Build Paths
elessair	0:f269e3021894	903	build_target = join(MBED_LIBRARIES, "TARGET_" + target.name)
elessair	0:f269e3021894	904	build_toolchain = join(build_target, "TOOLCHAIN_" + toolchain.name)
elessair	0:f269e3021894	905	mkdir(build_toolchain)
elessair	0:f269e3021894	906
elessair	0:f269e3021894	907	tmp_path = join(MBED_LIBRARIES, '.temp', toolchain.obj_path)
elessair	0:f269e3021894	908	mkdir(tmp_path)
elessair	0:f269e3021894	909
elessair	0:f269e3021894	910	# CMSIS
elessair	0:f269e3021894	911	toolchain.info("Building library %s (%s, %s)" %
elessair	0:f269e3021894	912	('CMSIS', target.name, toolchain_name))
elessair	0:f269e3021894	913	cmsis_src = MBED_CMSIS_PATH
elessair	0:f269e3021894	914	resources = toolchain.scan_resources(cmsis_src)
elessair	0:f269e3021894	915
elessair	0:f269e3021894	916	toolchain.copy_files(resources.headers, build_target)
elessair	0:f269e3021894	917	toolchain.copy_files(resources.linker_script, build_toolchain)
elessair	0:f269e3021894	918	toolchain.copy_files(resources.bin_files, build_toolchain)
elessair	0:f269e3021894	919
elessair	0:f269e3021894	920	objects = toolchain.compile_sources(resources, tmp_path)
elessair	0:f269e3021894	921	toolchain.copy_files(objects, build_toolchain)
elessair	0:f269e3021894	922
elessair	0:f269e3021894	923	# mbed
elessair	0:f269e3021894	924	toolchain.info("Building library %s (%s, %s)" %
elessair	0:f269e3021894	925	('MBED', target.name, toolchain_name))
elessair	0:f269e3021894	926
elessair	0:f269e3021894	927	# Common Headers
elessair	0:f269e3021894	928	toolchain.copy_files([MBED_HEADER], MBED_LIBRARIES)
elessair	0:f269e3021894	929	library_incdirs = [dirname(MBED_LIBRARIES), MBED_LIBRARIES]
elessair	0:f269e3021894	930
elessair	0:f269e3021894	931	for dir, dest in [(MBED_DRIVERS, MBED_LIBRARIES_DRIVERS),
elessair	0:f269e3021894	932	(MBED_PLATFORM, MBED_LIBRARIES_PLATFORM),
elessair	0:f269e3021894	933	(MBED_HAL, MBED_LIBRARIES_HAL)]:
elessair	0:f269e3021894	934	resources = toolchain.scan_resources(dir)
elessair	0:f269e3021894	935	toolchain.copy_files(resources.headers, dest)
elessair	0:f269e3021894	936	library_incdirs.append(dest)
elessair	0:f269e3021894	937
elessair	0:f269e3021894	938	# Target specific sources
elessair	0:f269e3021894	939	hal_src = MBED_TARGETS_PATH
elessair	0:f269e3021894	940	hal_implementation = toolchain.scan_resources(hal_src)
elessair	0:f269e3021894	941	toolchain.copy_files(hal_implementation.headers +
elessair	0:f269e3021894	942	hal_implementation.hex_files +
elessair	0:f269e3021894	943	hal_implementation.libraries +
elessair	0:f269e3021894	944	[MBED_CONFIG_FILE],
elessair	0:f269e3021894	945	build_target, resources=hal_implementation)
elessair	0:f269e3021894	946	toolchain.copy_files(hal_implementation.linker_script, build_toolchain)
elessair	0:f269e3021894	947	toolchain.copy_files(hal_implementation.bin_files, build_toolchain)
elessair	0:f269e3021894	948	incdirs = toolchain.scan_resources(build_target).inc_dirs
elessair	0:f269e3021894	949	objects = toolchain.compile_sources(hal_implementation, tmp_path,
elessair	0:f269e3021894	950	library_incdirs + incdirs)
elessair	0:f269e3021894	951	toolchain.copy_files(objects, build_toolchain)
elessair	0:f269e3021894	952
elessair	0:f269e3021894	953	# Common Sources
elessair	0:f269e3021894	954	mbed_resources = None
elessair	0:f269e3021894	955	for dir in [MBED_DRIVERS, MBED_PLATFORM, MBED_HAL]:
elessair	0:f269e3021894	956	mbed_resources += toolchain.scan_resources(dir)
elessair	0:f269e3021894	957
elessair	0:f269e3021894	958	objects = toolchain.compile_sources(mbed_resources, tmp_path,
elessair	0:f269e3021894	959	library_incdirs + incdirs)
elessair	0:f269e3021894	960
elessair	0:f269e3021894	961	# A number of compiled files need to be copied as objects as opposed to
elessair	0:f269e3021894	962	# way the linker search for symbols in archives. These are:
elessair	0:f269e3021894	963	# - retarget.o: to make sure that the C standard lib symbols get
elessair	0:f269e3021894	964	# overridden
elessair	0:f269e3021894	965	# - board.o: mbed_die is weak
elessair	0:f269e3021894	966	# - mbed_overrides.o: this contains platform overrides of various
elessair	0:f269e3021894	967	# weak SDK functions
elessair	0:f269e3021894	968	separate_names, separate_objects = ['retarget.o', 'board.o',
elessair	0:f269e3021894	969	'mbed_overrides.o'], []
elessair	0:f269e3021894	970
elessair	0:f269e3021894	971	for obj in objects:
elessair	0:f269e3021894	972	for name in separate_names:
elessair	0:f269e3021894	973	if obj.endswith(name):
elessair	0:f269e3021894	974	separate_objects.append(obj)
elessair	0:f269e3021894	975
elessair	0:f269e3021894	976	for obj in separate_objects:
elessair	0:f269e3021894	977	objects.remove(obj)
elessair	0:f269e3021894	978
elessair	0:f269e3021894	979	toolchain.build_library(objects, build_toolchain, "mbed")
elessair	0:f269e3021894	980
elessair	0:f269e3021894	981	for obj in separate_objects:
elessair	0:f269e3021894	982	toolchain.copy_files(obj, build_toolchain)
elessair	0:f269e3021894	983
elessair	0:f269e3021894	984	if report != None:
elessair	0:f269e3021894	985	end = time()
elessair	0:f269e3021894	986	cur_result["elapsed_time"] = end - start
elessair	0:f269e3021894	987	cur_result["output"] = toolchain.get_output()
elessair	0:f269e3021894	988	cur_result["result"] = "OK"
elessair	0:f269e3021894	989
elessair	0:f269e3021894	990	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	991
elessair	0:f269e3021894	992	return True
elessair	0:f269e3021894	993
elessair	0:f269e3021894	994	except Exception as exc:
elessair	0:f269e3021894	995	if report != None:
elessair	0:f269e3021894	996	end = time()
elessair	0:f269e3021894	997	cur_result["result"] = "FAIL"
elessair	0:f269e3021894	998	cur_result["elapsed_time"] = end - start
elessair	0:f269e3021894	999
elessair	0:f269e3021894	1000	toolchain_output = toolchain.get_output()
elessair	0:f269e3021894	1001	if toolchain_output:
elessair	0:f269e3021894	1002	cur_result["output"] += toolchain_output
elessair	0:f269e3021894	1003
elessair	0:f269e3021894	1004	cur_result["output"] += str(exc)
elessair	0:f269e3021894	1005
elessair	0:f269e3021894	1006	add_result_to_report(report, cur_result)
elessair	0:f269e3021894	1007
elessair	0:f269e3021894	1008	# Let Exception propagate
elessair	0:f269e3021894	1009	raise
elessair	0:f269e3021894	1010
elessair	0:f269e3021894	1011
elessair	0:f269e3021894	1012	def get_unique_supported_toolchains(release_targets=None):
elessair	0:f269e3021894	1013	""" Get list of all unique toolchains supported by targets
elessair	0:f269e3021894	1014
elessair	0:f269e3021894	1015	Keyword arguments:
elessair	0:f269e3021894	1016	release_targets - tuple structure returned from get_mbed_official_release().
elessair	0:f269e3021894	1017	If release_targets is not specified, then it queries all
elessair	0:f269e3021894	1018	known targets
elessair	0:f269e3021894	1019	"""
elessair	0:f269e3021894	1020	unique_supported_toolchains = []
elessair	0:f269e3021894	1021
elessair	0:f269e3021894	1022	if not release_targets:
elessair	0:f269e3021894	1023	for target in TARGET_NAMES:
elessair	0:f269e3021894	1024	for toolchain in TARGET_MAP[target].supported_toolchains:
elessair	0:f269e3021894	1025	if toolchain not in unique_supported_toolchains:
elessair	0:f269e3021894	1026	unique_supported_toolchains.append(toolchain)
elessair	0:f269e3021894	1027	else:
elessair	0:f269e3021894	1028	for target in release_targets:
elessair	0:f269e3021894	1029	for toolchain in target[1]:
elessair	0:f269e3021894	1030	if toolchain not in unique_supported_toolchains:
elessair	0:f269e3021894	1031	unique_supported_toolchains.append(toolchain)
elessair	0:f269e3021894	1032
elessair	0:f269e3021894	1033	return unique_supported_toolchains
elessair	0:f269e3021894	1034
elessair	0:f269e3021894	1035
elessair	0:f269e3021894	1036	def mcu_toolchain_matrix(verbose_html=False, platform_filter=None,
elessair	0:f269e3021894	1037	release_version='5'):
elessair	0:f269e3021894	1038	""" Shows target map using prettytable
elessair	0:f269e3021894	1039
elessair	0:f269e3021894	1040	Keyword arguments:
elessair	0:f269e3021894	1041	verbose_html - emit html instead of a simple table
elessair	0:f269e3021894	1042	platform_filter - remove results that match the string
elessair	0:f269e3021894	1043	release_version - get the matrix for this major version number
elessair	0:f269e3021894	1044	"""
elessair	0:f269e3021894	1045	# Only use it in this function so building works without extra modules
elessair	0:f269e3021894	1046	from prettytable import PrettyTable
elessair	0:f269e3021894	1047
elessair	0:f269e3021894	1048	if isinstance(release_version, basestring):
elessair	0:f269e3021894	1049	# Force release_version to lowercase if it is a string
elessair	0:f269e3021894	1050	release_version = release_version.lower()
elessair	0:f269e3021894	1051	else:
elessair	0:f269e3021894	1052	# Otherwise default to printing all known targets and toolchains
elessair	0:f269e3021894	1053	release_version = 'all'
elessair	0:f269e3021894	1054
elessair	0:f269e3021894	1055
elessair	0:f269e3021894	1056	version_release_targets = {}
elessair	0:f269e3021894	1057	version_release_target_names = {}
elessair	0:f269e3021894	1058
elessair	0:f269e3021894	1059	for version in RELEASE_VERSIONS:
elessair	0:f269e3021894	1060	version_release_targets[version] = get_mbed_official_release(version)
elessair	0:f269e3021894	1061	version_release_target_names[version] = [x[0] for x in
elessair	0:f269e3021894	1062	version_release_targets[
elessair	0:f269e3021894	1063	version]]
elessair	0:f269e3021894	1064
elessair	0:f269e3021894	1065	if release_version in RELEASE_VERSIONS:
elessair	0:f269e3021894	1066	release_targets = version_release_targets[release_version]
elessair	0:f269e3021894	1067	else:
elessair	0:f269e3021894	1068	release_targets = None
elessair	0:f269e3021894	1069
elessair	0:f269e3021894	1070	unique_supported_toolchains = get_unique_supported_toolchains(
elessair	0:f269e3021894	1071	release_targets)
elessair	0:f269e3021894	1072	prepend_columns = ["Target"] + ["mbed OS %s" % x for x in RELEASE_VERSIONS]
elessair	0:f269e3021894	1073
elessair	0:f269e3021894	1074	# All tests status table print
elessair	0:f269e3021894	1075	columns = prepend_columns + unique_supported_toolchains
elessair	0:f269e3021894	1076	table_printer = PrettyTable(columns)
elessair	0:f269e3021894	1077	# Align table
elessair	0:f269e3021894	1078	for col in columns:
elessair	0:f269e3021894	1079	table_printer.align[col] = "c"
elessair	0:f269e3021894	1080	table_printer.align["Target"] = "l"
elessair	0:f269e3021894	1081
elessair	0:f269e3021894	1082	perm_counter = 0
elessair	0:f269e3021894	1083	target_counter = 0
elessair	0:f269e3021894	1084
elessair	0:f269e3021894	1085	target_names = []
elessair	0:f269e3021894	1086
elessair	0:f269e3021894	1087	if release_targets:
elessair	0:f269e3021894	1088	target_names = [x[0] for x in release_targets]
elessair	0:f269e3021894	1089	else:
elessair	0:f269e3021894	1090	target_names = TARGET_NAMES
elessair	0:f269e3021894	1091
elessair	0:f269e3021894	1092	for target in sorted(target_names):
elessair	0:f269e3021894	1093	if platform_filter is not None:
elessair	0:f269e3021894	1094	# FIlter out platforms using regex
elessair	0:f269e3021894	1095	if re.search(platform_filter, target) is None:
elessair	0:f269e3021894	1096	continue
elessair	0:f269e3021894	1097	target_counter += 1
elessair	0:f269e3021894	1098
elessair	0:f269e3021894	1099	row = [target] # First column is platform name
elessair	0:f269e3021894	1100
elessair	0:f269e3021894	1101	for version in RELEASE_VERSIONS:
elessair	0:f269e3021894	1102	if target in version_release_target_names[version]:
elessair	0:f269e3021894	1103	text = "Supported"
elessair	0:f269e3021894	1104	else:
elessair	0:f269e3021894	1105	text = "-"
elessair	0:f269e3021894	1106	row.append(text)
elessair	0:f269e3021894	1107
elessair	0:f269e3021894	1108	for unique_toolchain in unique_supported_toolchains:
elessair	0:f269e3021894	1109	if unique_toolchain in TARGET_MAP[target].supported_toolchains:
elessair	0:f269e3021894	1110	text = "Supported"
elessair	0:f269e3021894	1111	perm_counter += 1
elessair	0:f269e3021894	1112	else:
elessair	0:f269e3021894	1113	text = "-"
elessair	0:f269e3021894	1114
elessair	0:f269e3021894	1115	row.append(text)
elessair	0:f269e3021894	1116	table_printer.add_row(row)
elessair	0:f269e3021894	1117
elessair	0:f269e3021894	1118	result = table_printer.get_html_string() if verbose_html \
elessair	0:f269e3021894	1119	else table_printer.get_string()
elessair	0:f269e3021894	1120	result += "\n"
elessair	0:f269e3021894	1121	result += "Supported targets: %d\n"% (target_counter)
elessair	0:f269e3021894	1122	if target_counter == 1:
elessair	0:f269e3021894	1123	result += "Supported toolchains: %d"% (perm_counter)
elessair	0:f269e3021894	1124	return result
elessair	0:f269e3021894	1125
elessair	0:f269e3021894	1126
elessair	0:f269e3021894	1127	def get_target_supported_toolchains(target):
elessair	0:f269e3021894	1128	""" Returns target supported toolchains list
elessair	0:f269e3021894	1129
elessair	0:f269e3021894	1130	Positional arguments:
elessair	0:f269e3021894	1131	target - the target to get the supported toolchains of
elessair	0:f269e3021894	1132	"""
elessair	0:f269e3021894	1133	return TARGET_MAP[target].supported_toolchains if target in TARGET_MAP \
elessair	0:f269e3021894	1134	else None
elessair	0:f269e3021894	1135
elessair	0:f269e3021894	1136
elessair	0:f269e3021894	1137	def static_analysis_scan(target, toolchain_name, cppcheck_cmd,
elessair	0:f269e3021894	1138	cppcheck_msg_format, verbose=False,
elessair	0:f269e3021894	1139	clean=False, macros=None, notify=None, jobs=1,
elessair	0:f269e3021894	1140	extra_verbose=False, build_profile=None):
elessair	0:f269e3021894	1141	"""Perform static analysis on a target and toolchain combination
elessair	0:f269e3021894	1142
elessair	0:f269e3021894	1143	Positional arguments:
elessair	0:f269e3021894	1144	target - the target to fake the build for
elessair	0:f269e3021894	1145	toolchain_name - pretend you would compile with this toolchain
elessair	0:f269e3021894	1146	cppcheck_cmd - the command used to do static analysis
elessair	0:f269e3021894	1147	cppcheck_msg_format - the format of the check messages
elessair	0:f269e3021894	1148
elessair	0:f269e3021894	1149	Keyword arguments:
elessair	0:f269e3021894	1150	verbose - more printing!
elessair	0:f269e3021894	1151	clean - start from a clean slate
elessair	0:f269e3021894	1152	macros - extra macros to compile with
elessair	0:f269e3021894	1153	notify - the notification event handling function
elessair	0:f269e3021894	1154	jobs - number of commands to run at once
elessair	0:f269e3021894	1155	extra_verbose - even moar printing
elessair	0:f269e3021894	1156	build_profile - a dict of flags that will be passed to the compiler
elessair	0:f269e3021894	1157	"""
elessair	0:f269e3021894	1158	# Toolchain
elessair	0:f269e3021894	1159	toolchain = TOOLCHAIN_CLASSES[toolchain_name](target, macros=macros,
elessair	0:f269e3021894	1160	notify=notify,
elessair	0:f269e3021894	1161	extra_verbose=extra_verbose,
elessair	0:f269e3021894	1162	build_profile=build_profile)
elessair	0:f269e3021894	1163	toolchain.VERBOSE = verbose
elessair	0:f269e3021894	1164	toolchain.jobs = jobs
elessair	0:f269e3021894	1165	toolchain.build_all = clean
elessair	0:f269e3021894	1166
elessair	0:f269e3021894	1167	# Source and Build Paths
elessair	0:f269e3021894	1168	build_target = join(MBED_LIBRARIES, "TARGET_" + target.name)
elessair	0:f269e3021894	1169	build_toolchain = join(build_target, "TOOLCHAIN_" + toolchain.name)
elessair	0:f269e3021894	1170	mkdir(build_toolchain)
elessair	0:f269e3021894	1171
elessair	0:f269e3021894	1172	tmp_path = join(MBED_LIBRARIES, '.temp', toolchain.obj_path)
elessair	0:f269e3021894	1173	mkdir(tmp_path)
elessair	0:f269e3021894	1174
elessair	0:f269e3021894	1175	# CMSIS
elessair	0:f269e3021894	1176	toolchain.info("Static analysis for %s (%s, %s)" %
elessair	0:f269e3021894	1177	('CMSIS', target.name, toolchain_name))
elessair	0:f269e3021894	1178	cmsis_src = MBED_CMSIS_PATH
elessair	0:f269e3021894	1179	resources = toolchain.scan_resources(cmsis_src)
elessair	0:f269e3021894	1180
elessair	0:f269e3021894	1181	# Copy files before analysis
elessair	0:f269e3021894	1182	toolchain.copy_files(resources.headers, build_target)
elessair	0:f269e3021894	1183	toolchain.copy_files(resources.linker_script, build_toolchain)
elessair	0:f269e3021894	1184
elessair	0:f269e3021894	1185	# Gather include paths, c, cpp sources and macros to transfer to cppcheck
elessair	0:f269e3021894	1186	# command line
elessair	0:f269e3021894	1187	includes = ["-I%s"% i for i in resources.inc_dirs]
elessair	0:f269e3021894	1188	includes.append("-I%s"% str(build_target))
elessair	0:f269e3021894	1189	c_sources = " ".join(resources.c_sources)
elessair	0:f269e3021894	1190	cpp_sources = " ".join(resources.cpp_sources)
elessair	0:f269e3021894	1191	macros = ["-D%s"% s for s in toolchain.get_symbols() + toolchain.macros]
elessair	0:f269e3021894	1192
elessair	0:f269e3021894	1193	includes = [inc.strip() for inc in includes]
elessair	0:f269e3021894	1194	macros = [mac.strip() for mac in macros]
elessair	0:f269e3021894	1195
elessair	0:f269e3021894	1196	check_cmd = cppcheck_cmd
elessair	0:f269e3021894	1197	check_cmd += cppcheck_msg_format
elessair	0:f269e3021894	1198	check_cmd += includes
elessair	0:f269e3021894	1199	check_cmd += macros
elessair	0:f269e3021894	1200
elessair	0:f269e3021894	1201	# We need to pass some params via file to avoid "command line too long in
elessair	0:f269e3021894	1202	# some OSs"
elessair	0:f269e3021894	1203	tmp_file = tempfile.NamedTemporaryFile(delete=False)
elessair	0:f269e3021894	1204	tmp_file.writelines(line + '\n' for line in c_sources.split())
elessair	0:f269e3021894	1205	tmp_file.writelines(line + '\n' for line in cpp_sources.split())
elessair	0:f269e3021894	1206	tmp_file.close()
elessair	0:f269e3021894	1207	check_cmd += ["--file-list=%s"% tmp_file.name]
elessair	0:f269e3021894	1208
elessair	0:f269e3021894	1209	_stdout, _stderr, _ = run_cmd(check_cmd)
elessair	0:f269e3021894	1210	if verbose:
elessair	0:f269e3021894	1211	print _stdout
elessair	0:f269e3021894	1212	print _stderr
elessair	0:f269e3021894	1213
elessair	0:f269e3021894	1214	# =========================================================================
elessair	0:f269e3021894	1215
elessair	0:f269e3021894	1216	# MBED
elessair	0:f269e3021894	1217	toolchain.info("Static analysis for %s (%s, %s)" %
elessair	0:f269e3021894	1218	('MBED', target.name, toolchain_name))
elessair	0:f269e3021894	1219
elessair	0:f269e3021894	1220	# Common Headers
elessair	0:f269e3021894	1221	toolchain.copy_files([MBED_HEADER], MBED_LIBRARIES)
elessair	0:f269e3021894	1222	toolchain.copy_files(toolchain.scan_resources(MBED_DRIVERS).headers,
elessair	0:f269e3021894	1223	MBED_LIBRARIES)
elessair	0:f269e3021894	1224	toolchain.copy_files(toolchain.scan_resources(MBED_PLATFORM).headers,
elessair	0:f269e3021894	1225	MBED_LIBRARIES)
elessair	0:f269e3021894	1226	toolchain.copy_files(toolchain.scan_resources(MBED_HAL).headers,
elessair	0:f269e3021894	1227	MBED_LIBRARIES)
elessair	0:f269e3021894	1228
elessair	0:f269e3021894	1229	# Target specific sources
elessair	0:f269e3021894	1230	hal_src = join(MBED_TARGETS_PATH, "hal")
elessair	0:f269e3021894	1231	hal_implementation = toolchain.scan_resources(hal_src)
elessair	0:f269e3021894	1232
elessair	0:f269e3021894	1233	# Copy files before analysis
elessair	0:f269e3021894	1234	toolchain.copy_files(hal_implementation.headers +
elessair	0:f269e3021894	1235	hal_implementation.hex_files, build_target,
elessair	0:f269e3021894	1236	resources=hal_implementation)
elessair	0:f269e3021894	1237	incdirs = toolchain.scan_resources(build_target)
elessair	0:f269e3021894	1238
elessair	0:f269e3021894	1239	target_includes = ["-I%s" % i for i in incdirs.inc_dirs]
elessair	0:f269e3021894	1240	target_includes.append("-I%s"% str(build_target))
elessair	0:f269e3021894	1241	target_includes.append("-I%s"% str(hal_src))
elessair	0:f269e3021894	1242	target_c_sources = " ".join(incdirs.c_sources)
elessair	0:f269e3021894	1243	target_cpp_sources = " ".join(incdirs.cpp_sources)
elessair	0:f269e3021894	1244	target_macros = ["-D%s"% s for s in
elessair	0:f269e3021894	1245	toolchain.get_symbols() + toolchain.macros]
elessair	0:f269e3021894	1246
elessair	0:f269e3021894	1247	# Common Sources
elessair	0:f269e3021894	1248	mbed_resources = toolchain.scan_resources(MBED_COMMON)
elessair	0:f269e3021894	1249
elessair	0:f269e3021894	1250	# Gather include paths, c, cpp sources and macros to transfer to cppcheck
elessair	0:f269e3021894	1251	# command line
elessair	0:f269e3021894	1252	mbed_includes = ["-I%s" % i for i in mbed_resources.inc_dirs]
elessair	0:f269e3021894	1253	mbed_includes.append("-I%s"% str(build_target))
elessair	0:f269e3021894	1254	mbed_includes.append("-I%s"% str(MBED_DRIVERS))
elessair	0:f269e3021894	1255	mbed_includes.append("-I%s"% str(MBED_PLATFORM))
elessair	0:f269e3021894	1256	mbed_includes.append("-I%s"% str(MBED_HAL))
elessair	0:f269e3021894	1257	mbed_c_sources = " ".join(mbed_resources.c_sources)
elessair	0:f269e3021894	1258	mbed_cpp_sources = " ".join(mbed_resources.cpp_sources)
elessair	0:f269e3021894	1259
elessair	0:f269e3021894	1260	target_includes = [inc.strip() for inc in target_includes]
elessair	0:f269e3021894	1261	mbed_includes = [inc.strip() for inc in mbed_includes]
elessair	0:f269e3021894	1262	target_macros = [mac.strip() for mac in target_macros]
elessair	0:f269e3021894	1263
elessair	0:f269e3021894	1264	check_cmd = cppcheck_cmd
elessair	0:f269e3021894	1265	check_cmd += cppcheck_msg_format
elessair	0:f269e3021894	1266	check_cmd += target_includes
elessair	0:f269e3021894	1267	check_cmd += mbed_includes
elessair	0:f269e3021894	1268	check_cmd += target_macros
elessair	0:f269e3021894	1269
elessair	0:f269e3021894	1270	# We need to pass some parames via file to avoid "command line too long in
elessair	0:f269e3021894	1271	# some OSs"
elessair	0:f269e3021894	1272	tmp_file = tempfile.NamedTemporaryFile(delete=False)
elessair	0:f269e3021894	1273	tmp_file.writelines(line + '\n' for line in target_c_sources.split())
elessair	0:f269e3021894	1274	tmp_file.writelines(line + '\n' for line in target_cpp_sources.split())
elessair	0:f269e3021894	1275	tmp_file.writelines(line + '\n' for line in mbed_c_sources.split())
elessair	0:f269e3021894	1276	tmp_file.writelines(line + '\n' for line in mbed_cpp_sources.split())
elessair	0:f269e3021894	1277	tmp_file.close()
elessair	0:f269e3021894	1278	check_cmd += ["--file-list=%s"% tmp_file.name]
elessair	0:f269e3021894	1279
elessair	0:f269e3021894	1280	_stdout, _stderr, _ = run_cmd_ext(check_cmd)
elessair	0:f269e3021894	1281	if verbose:
elessair	0:f269e3021894	1282	print _stdout
elessair	0:f269e3021894	1283	print _stderr
elessair	0:f269e3021894	1284
elessair	0:f269e3021894	1285
elessair	0:f269e3021894	1286	def static_analysis_scan_lib(lib_id, target, toolchain, cppcheck_cmd,
elessair	0:f269e3021894	1287	cppcheck_msg_format, verbose=False,
elessair	0:f269e3021894	1288	clean=False, macros=None, notify=None, jobs=1,
elessair	0:f269e3021894	1289	extra_verbose=False, build_profile=None):
elessair	0:f269e3021894	1290	"""Perform static analysis on a library as if it were to be compiled for a
elessair	0:f269e3021894	1291	particular target and toolchain combination
elessair	0:f269e3021894	1292	"""
elessair	0:f269e3021894	1293	lib = Library(lib_id)
elessair	0:f269e3021894	1294	if lib.is_supported(target, toolchain):
elessair	0:f269e3021894	1295	static_analysis_scan_library(
elessair	0:f269e3021894	1296	lib.source_dir, lib.build_dir, target, toolchain, cppcheck_cmd,
elessair	0:f269e3021894	1297	cppcheck_msg_format, lib.dependencies, verbose=verbose,
elessair	0:f269e3021894	1298	clean=clean, macros=macros, notify=notify, jobs=jobs,
elessair	0:f269e3021894	1299	extra_verbose=extra_verbose, build_profile=build_profile)
elessair	0:f269e3021894	1300	else:
elessair	0:f269e3021894	1301	print('Library "%s" is not yet supported on target %s with toolchain %s'
elessair	0:f269e3021894	1302	% (lib_id, target.name, toolchain))
elessair	0:f269e3021894	1303
elessair	0:f269e3021894	1304
elessair	0:f269e3021894	1305	def static_analysis_scan_library(src_paths, build_path, target, toolchain_name,
elessair	0:f269e3021894	1306	cppcheck_cmd, cppcheck_msg_format,
elessair	0:f269e3021894	1307	dependencies_paths=None,
elessair	0:f269e3021894	1308	name=None, clean=False, notify=None,
elessair	0:f269e3021894	1309	verbose=False, macros=None, jobs=1,
elessair	0:f269e3021894	1310	extra_verbose=False, build_profile=None):
elessair	0:f269e3021894	1311	""" Function scans library for statically detectable defects
elessair	0:f269e3021894	1312
elessair	0:f269e3021894	1313	Positional arguments:
elessair	0:f269e3021894	1314	src_paths - the list of library paths to scan
elessair	0:f269e3021894	1315	build_path - the location directory of result files
elessair	0:f269e3021894	1316	target - the target to fake the build for
elessair	0:f269e3021894	1317	toolchain_name - pretend you would compile with this toolchain
elessair	0:f269e3021894	1318	cppcheck_cmd - the command used to do static analysis
elessair	0:f269e3021894	1319	cppcheck_msg_format - the format of the check messages
elessair	0:f269e3021894	1320
elessair	0:f269e3021894	1321	Keyword arguments:
elessair	0:f269e3021894	1322	dependencies_paths - the paths to sources that this library depends on
elessair	0:f269e3021894	1323	name - the name of this library
elessair	0:f269e3021894	1324	clean - start from a clean slate
elessair	0:f269e3021894	1325	notify - the notification event handling function
elessair	0:f269e3021894	1326	verbose - more printing!
elessair	0:f269e3021894	1327	macros - extra macros to compile with
elessair	0:f269e3021894	1328	jobs - number of commands to run at once
elessair	0:f269e3021894	1329	extra_verbose - even moar printing
elessair	0:f269e3021894	1330	build_profile - a dict of flags that will be passed to the compiler
elessair	0:f269e3021894	1331	"""
elessair	0:f269e3021894	1332	if type(src_paths) != ListType:
elessair	0:f269e3021894	1333	src_paths = [src_paths]
elessair	0:f269e3021894	1334
elessair	0:f269e3021894	1335	for src_path in src_paths:
elessair	0:f269e3021894	1336	if not exists(src_path):
elessair	0:f269e3021894	1337	raise Exception("The library source folder does not exist: %s",
elessair	0:f269e3021894	1338	src_path)
elessair	0:f269e3021894	1339
elessair	0:f269e3021894	1340	# Toolchain instance
elessair	0:f269e3021894	1341	toolchain = TOOLCHAIN_CLASSES[toolchain_name](target, macros=macros,
elessair	0:f269e3021894	1342	notify=notify,
elessair	0:f269e3021894	1343	extra_verbose=extra_verbose,
elessair	0:f269e3021894	1344	build_profile=build_profile)
elessair	0:f269e3021894	1345	toolchain.VERBOSE = verbose
elessair	0:f269e3021894	1346	toolchain.jobs = jobs
elessair	0:f269e3021894	1347
elessair	0:f269e3021894	1348	# The first path will give the name to the library
elessair	0:f269e3021894	1349	name = basename(src_paths[0])
elessair	0:f269e3021894	1350	toolchain.info("Static analysis for library %s (%s, %s)" %
elessair	0:f269e3021894	1351	(name.upper(), target.name, toolchain_name))
elessair	0:f269e3021894	1352
elessair	0:f269e3021894	1353	# Scan Resources
elessair	0:f269e3021894	1354	resources = []
elessair	0:f269e3021894	1355	for src_path in src_paths:
elessair	0:f269e3021894	1356	resources.append(toolchain.scan_resources(src_path))
elessair	0:f269e3021894	1357
elessair	0:f269e3021894	1358	# Dependencies Include Paths
elessair	0:f269e3021894	1359	dependencies_include_dir = []
elessair	0:f269e3021894	1360	if dependencies_paths is not None:
elessair	0:f269e3021894	1361	for path in dependencies_paths:
elessair	0:f269e3021894	1362	lib_resources = toolchain.scan_resources(path)
elessair	0:f269e3021894	1363	dependencies_include_dir.extend(lib_resources.inc_dirs)
elessair	0:f269e3021894	1364
elessair	0:f269e3021894	1365	# Create the desired build directory structure
elessair	0:f269e3021894	1366	bin_path = join(build_path, toolchain.obj_path)
elessair	0:f269e3021894	1367	mkdir(bin_path)
elessair	0:f269e3021894	1368	tmp_path = join(build_path, '.temp', toolchain.obj_path)
elessair	0:f269e3021894	1369	mkdir(tmp_path)
elessair	0:f269e3021894	1370
elessair	0:f269e3021894	1371	# Gather include paths, c, cpp sources and macros to transfer to cppcheck
elessair	0:f269e3021894	1372	# command line
elessair	0:f269e3021894	1373	includes = ["-I%s" % i for i in dependencies_include_dir + src_paths]
elessair	0:f269e3021894	1374	c_sources = " "
elessair	0:f269e3021894	1375	cpp_sources = " "
elessair	0:f269e3021894	1376	macros = ['-D%s' % s for s in toolchain.get_symbols() + toolchain.macros]
elessair	0:f269e3021894	1377
elessair	0:f269e3021894	1378	# Copy Headers
elessair	0:f269e3021894	1379	for resource in resources:
elessair	0:f269e3021894	1380	toolchain.copy_files(resource.headers, build_path, resources=resource)
elessair	0:f269e3021894	1381	includes += ["-I%s" % i for i in resource.inc_dirs]
elessair	0:f269e3021894	1382	c_sources += " ".join(resource.c_sources) + " "
elessair	0:f269e3021894	1383	cpp_sources += " ".join(resource.cpp_sources) + " "
elessair	0:f269e3021894	1384
elessair	0:f269e3021894	1385	dependencies_include_dir.extend(
elessair	0:f269e3021894	1386	toolchain.scan_resources(build_path).inc_dirs)
elessair	0:f269e3021894	1387
elessair	0:f269e3021894	1388	includes = [inc.strip() for inc in includes]
elessair	0:f269e3021894	1389	macros = [mac.strip() for mac in macros]
elessair	0:f269e3021894	1390
elessair	0:f269e3021894	1391	check_cmd = cppcheck_cmd
elessair	0:f269e3021894	1392	check_cmd += cppcheck_msg_format
elessair	0:f269e3021894	1393	check_cmd += includes
elessair	0:f269e3021894	1394	check_cmd += macros
elessair	0:f269e3021894	1395
elessair	0:f269e3021894	1396	# We need to pass some parameters via file to avoid "command line too long
elessair	0:f269e3021894	1397	# in some OSs". A temporary file is created to store e.g. cppcheck list of
elessair	0:f269e3021894	1398	# files for command line
elessair	0:f269e3021894	1399	tmp_file = tempfile.NamedTemporaryFile(delete=False)
elessair	0:f269e3021894	1400	tmp_file.writelines(line + '\n' for line in c_sources.split())
elessair	0:f269e3021894	1401	tmp_file.writelines(line + '\n' for line in cpp_sources.split())
elessair	0:f269e3021894	1402	tmp_file.close()
elessair	0:f269e3021894	1403	check_cmd += ["--file-list=%s"% tmp_file.name]
elessair	0:f269e3021894	1404
elessair	0:f269e3021894	1405	# This will allow us to grab result from both stdio and stderr outputs (so
elessair	0:f269e3021894	1406	# we can show them) We assume static code analysis tool is outputting
elessair	0:f269e3021894	1407	# defects on STDERR
elessair	0:f269e3021894	1408	_stdout, _stderr, _ = run_cmd_ext(check_cmd)
elessair	0:f269e3021894	1409	if verbose:
elessair	0:f269e3021894	1410	print _stdout
elessair	0:f269e3021894	1411	print _stderr
elessair	0:f269e3021894	1412
elessair	0:f269e3021894	1413
elessair	0:f269e3021894	1414	def print_build_results(result_list, build_name):
elessair	0:f269e3021894	1415	""" Generate result string for build results
elessair	0:f269e3021894	1416
elessair	0:f269e3021894	1417	Positional arguments:
elessair	0:f269e3021894	1418	result_list - the list of results to print
elessair	0:f269e3021894	1419	build_name - the name of the build we are printing result for
elessair	0:f269e3021894	1420	"""
elessair	0:f269e3021894	1421	result = ""
elessair	0:f269e3021894	1422	if len(result_list) > 0:
elessair	0:f269e3021894	1423	result += build_name + "\n"
elessair	0:f269e3021894	1424	result += "\n".join([" * %s" % f for f in result_list])
elessair	0:f269e3021894	1425	result += "\n"
elessair	0:f269e3021894	1426	return result
elessair	0:f269e3021894	1427
elessair	0:f269e3021894	1428	def print_build_memory_usage(report):
elessair	0:f269e3021894	1429	""" Generate result table with memory usage values for build results
elessair	0:f269e3021894	1430	Aggregates (puts together) reports obtained from self.get_memory_summary()
elessair	0:f269e3021894	1431
elessair	0:f269e3021894	1432	Positional arguments:
elessair	0:f269e3021894	1433	report - Report generated during build procedure.
elessair	0:f269e3021894	1434	"""
elessair	0:f269e3021894	1435	from prettytable import PrettyTable
elessair	0:f269e3021894	1436	columns_text = ['name', 'target', 'toolchain']
elessair	0:f269e3021894	1437	columns_int = ['static_ram', 'stack', 'heap', 'total_ram', 'total_flash']
elessair	0:f269e3021894	1438	table = PrettyTable(columns_text + columns_int)
elessair	0:f269e3021894	1439
elessair	0:f269e3021894	1440	for col in columns_text:
elessair	0:f269e3021894	1441	table.align[col] = 'l'
elessair	0:f269e3021894	1442
elessair	0:f269e3021894	1443	for col in columns_int:
elessair	0:f269e3021894	1444	table.align[col] = 'r'
elessair	0:f269e3021894	1445
elessair	0:f269e3021894	1446	for target in report:
elessair	0:f269e3021894	1447	for toolchain in report[target]:
elessair	0:f269e3021894	1448	for name in report[target][toolchain]:
elessair	0:f269e3021894	1449	for dlist in report[target][toolchain][name]:
elessair	0:f269e3021894	1450	for dlistelem in dlist:
elessair	0:f269e3021894	1451	# Get 'memory_usage' record and build table with
elessair	0:f269e3021894	1452	# statistics
elessair	0:f269e3021894	1453	record = dlist[dlistelem]
elessair	0:f269e3021894	1454	if 'memory_usage' in record and record['memory_usage']:
elessair	0:f269e3021894	1455	# Note that summary should be in the last record of
elessair	0:f269e3021894	1456	# 'memory_usage' section. This is why we are
elessair	0:f269e3021894	1457	# grabbing last "[-1]" record.
elessair	0:f269e3021894	1458	row = [
elessair	0:f269e3021894	1459	record['description'],
elessair	0:f269e3021894	1460	record['target_name'],
elessair	0:f269e3021894	1461	record['toolchain_name'],
elessair	0:f269e3021894	1462	record['memory_usage'][-1]['summary'][
elessair	0:f269e3021894	1463	'static_ram'],
elessair	0:f269e3021894	1464	record['memory_usage'][-1]['summary']['stack'],
elessair	0:f269e3021894	1465	record['memory_usage'][-1]['summary']['heap'],
elessair	0:f269e3021894	1466	record['memory_usage'][-1]['summary'][
elessair	0:f269e3021894	1467	'total_ram'],
elessair	0:f269e3021894	1468	record['memory_usage'][-1]['summary'][
elessair	0:f269e3021894	1469	'total_flash'],
elessair	0:f269e3021894	1470	]
elessair	0:f269e3021894	1471	table.add_row(row)
elessair	0:f269e3021894	1472
elessair	0:f269e3021894	1473	result = "Memory map breakdown for built projects (values in Bytes):\n"
elessair	0:f269e3021894	1474	result += table.get_string(sortby='name')
elessair	0:f269e3021894	1475	return result
elessair	0:f269e3021894	1476
elessair	0:f269e3021894	1477	def write_build_report(build_report, template_filename, filename):
elessair	0:f269e3021894	1478	"""Write a build report to disk using a template file
elessair	0:f269e3021894	1479
elessair	0:f269e3021894	1480	Positional arguments:
elessair	0:f269e3021894	1481	build_report - a report generated by the build system
elessair	0:f269e3021894	1482	template_filename - a file that contains the template for the style of build
elessair	0:f269e3021894	1483	report
elessair	0:f269e3021894	1484	filename - the location on disk to write the file to
elessair	0:f269e3021894	1485	"""
elessair	0:f269e3021894	1486	build_report_failing = []
elessair	0:f269e3021894	1487	build_report_passing = []
elessair	0:f269e3021894	1488
elessair	0:f269e3021894	1489	for report in build_report:
elessair	0:f269e3021894	1490	if len(report["failing"]) > 0:
elessair	0:f269e3021894	1491	build_report_failing.append(report)
elessair	0:f269e3021894	1492	else:
elessair	0:f269e3021894	1493	build_report_passing.append(report)
elessair	0:f269e3021894	1494
elessair	0:f269e3021894	1495	env = Environment(extensions=['jinja2.ext.with_'])
elessair	0:f269e3021894	1496	env.loader = FileSystemLoader('ci_templates')
elessair	0:f269e3021894	1497	template = env.get_template(template_filename)
elessair	0:f269e3021894	1498
elessair	0:f269e3021894	1499	with open(filename, 'w+') as placeholder:
elessair	0:f269e3021894	1500	placeholder.write(template.render(
elessair	0:f269e3021894	1501	failing_builds=build_report_failing,
elessair	0:f269e3021894	1502	passing_builds=build_report_passing))

Repository toolbox

Export to desktop IDE

Repository details

Type:	Library
Created:	23 Oct 2016
Imports:	1689
Forks:	1
Commits:	1
Dependents:	3
Dependencies:	0
Followers:	20

tools/build_api.py@0:f269e3021894, 2016-10-23 (annotated)

Who changed what in which revision?

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning