mbed-os
Dependents: cobaLCDJoyMotor_Thread odometry_omni_3roda_v3 odometry_omni_3roda_v1 odometry_omni_3roda_v2 ... more
tools/export/makefile/__init__.py@0:b74591d5ab33, 2017-12-11 (annotated)
- Committer:
- be_bryan
- Date:
- Mon Dec 11 17:54:04 2017 +0000
- Revision:
- 0:b74591d5ab33
motor ++
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
be_bryan | 0:b74591d5ab33 | 1 | """ |
be_bryan | 0:b74591d5ab33 | 2 | mbed SDK |
be_bryan | 0:b74591d5ab33 | 3 | Copyright (c) 2011-2016 ARM Limited |
be_bryan | 0:b74591d5ab33 | 4 | |
be_bryan | 0:b74591d5ab33 | 5 | Licensed under the Apache License, Version 2.0 (the "License"); |
be_bryan | 0:b74591d5ab33 | 6 | you may not use this file except in compliance with the License. |
be_bryan | 0:b74591d5ab33 | 7 | You may obtain a copy of the License at |
be_bryan | 0:b74591d5ab33 | 8 | |
be_bryan | 0:b74591d5ab33 | 9 | http://www.apache.org/licenses/LICENSE-2.0 |
be_bryan | 0:b74591d5ab33 | 10 | |
be_bryan | 0:b74591d5ab33 | 11 | Unless required by applicable law or agreed to in writing, software |
be_bryan | 0:b74591d5ab33 | 12 | distributed under the License is distributed on an "AS IS" BASIS, |
be_bryan | 0:b74591d5ab33 | 13 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
be_bryan | 0:b74591d5ab33 | 14 | See the License for the specific language governing permissions and |
be_bryan | 0:b74591d5ab33 | 15 | limitations under the License. |
be_bryan | 0:b74591d5ab33 | 16 | """ |
be_bryan | 0:b74591d5ab33 | 17 | from os.path import splitext, basename, relpath, join, abspath, dirname,\ |
be_bryan | 0:b74591d5ab33 | 18 | exists |
be_bryan | 0:b74591d5ab33 | 19 | from os import remove |
be_bryan | 0:b74591d5ab33 | 20 | import sys |
be_bryan | 0:b74591d5ab33 | 21 | from subprocess import check_output, CalledProcessError, Popen, PIPE |
be_bryan | 0:b74591d5ab33 | 22 | import shutil |
be_bryan | 0:b74591d5ab33 | 23 | from jinja2.exceptions import TemplateNotFound |
be_bryan | 0:b74591d5ab33 | 24 | from tools.export.exporters import Exporter, apply_supported_whitelist |
be_bryan | 0:b74591d5ab33 | 25 | from tools.utils import NotSupportedException |
be_bryan | 0:b74591d5ab33 | 26 | from tools.targets import TARGET_MAP |
be_bryan | 0:b74591d5ab33 | 27 | |
be_bryan | 0:b74591d5ab33 | 28 | |
be_bryan | 0:b74591d5ab33 | 29 | class Makefile(Exporter): |
be_bryan | 0:b74591d5ab33 | 30 | """Generic Makefile template that mimics the behavior of the python build |
be_bryan | 0:b74591d5ab33 | 31 | system |
be_bryan | 0:b74591d5ab33 | 32 | """ |
be_bryan | 0:b74591d5ab33 | 33 | |
be_bryan | 0:b74591d5ab33 | 34 | DOT_IN_RELATIVE_PATH = True |
be_bryan | 0:b74591d5ab33 | 35 | |
be_bryan | 0:b74591d5ab33 | 36 | MBED_CONFIG_HEADER_SUPPORTED = True |
be_bryan | 0:b74591d5ab33 | 37 | |
be_bryan | 0:b74591d5ab33 | 38 | PREPROCESS_ASM = False |
be_bryan | 0:b74591d5ab33 | 39 | |
be_bryan | 0:b74591d5ab33 | 40 | POST_BINARY_WHITELIST = set([ |
be_bryan | 0:b74591d5ab33 | 41 | "MCU_NRF51Code.binary_hook", |
be_bryan | 0:b74591d5ab33 | 42 | "TEENSY3_1Code.binary_hook", |
be_bryan | 0:b74591d5ab33 | 43 | "LPCTargetCode.lpc_patch", |
be_bryan | 0:b74591d5ab33 | 44 | "LPC4088Code.binary_hook" |
be_bryan | 0:b74591d5ab33 | 45 | ]) |
be_bryan | 0:b74591d5ab33 | 46 | |
be_bryan | 0:b74591d5ab33 | 47 | @classmethod |
be_bryan | 0:b74591d5ab33 | 48 | def is_target_supported(cls, target_name): |
be_bryan | 0:b74591d5ab33 | 49 | target = TARGET_MAP[target_name] |
be_bryan | 0:b74591d5ab33 | 50 | return apply_supported_whitelist( |
be_bryan | 0:b74591d5ab33 | 51 | cls.TOOLCHAIN, cls.POST_BINARY_WHITELIST, target) |
be_bryan | 0:b74591d5ab33 | 52 | |
be_bryan | 0:b74591d5ab33 | 53 | def generate(self): |
be_bryan | 0:b74591d5ab33 | 54 | """Generate the makefile |
be_bryan | 0:b74591d5ab33 | 55 | |
be_bryan | 0:b74591d5ab33 | 56 | Note: subclasses should not need to override this method |
be_bryan | 0:b74591d5ab33 | 57 | """ |
be_bryan | 0:b74591d5ab33 | 58 | if not self.resources.linker_script: |
be_bryan | 0:b74591d5ab33 | 59 | raise NotSupportedException("No linker script found.") |
be_bryan | 0:b74591d5ab33 | 60 | |
be_bryan | 0:b74591d5ab33 | 61 | self.resources.win_to_unix() |
be_bryan | 0:b74591d5ab33 | 62 | |
be_bryan | 0:b74591d5ab33 | 63 | to_be_compiled = [splitext(src)[0] + ".o" for src in |
be_bryan | 0:b74591d5ab33 | 64 | self.resources.s_sources + |
be_bryan | 0:b74591d5ab33 | 65 | self.resources.c_sources + |
be_bryan | 0:b74591d5ab33 | 66 | self.resources.cpp_sources] |
be_bryan | 0:b74591d5ab33 | 67 | |
be_bryan | 0:b74591d5ab33 | 68 | libraries = [self.prepare_lib(basename(lib)) for lib |
be_bryan | 0:b74591d5ab33 | 69 | in self.resources.libraries] |
be_bryan | 0:b74591d5ab33 | 70 | sys_libs = [self.prepare_sys_lib(lib) for lib |
be_bryan | 0:b74591d5ab33 | 71 | in self.toolchain.sys_libs] |
be_bryan | 0:b74591d5ab33 | 72 | |
be_bryan | 0:b74591d5ab33 | 73 | ctx = { |
be_bryan | 0:b74591d5ab33 | 74 | 'name': self.project_name, |
be_bryan | 0:b74591d5ab33 | 75 | 'to_be_compiled': to_be_compiled, |
be_bryan | 0:b74591d5ab33 | 76 | 'object_files': self.resources.objects, |
be_bryan | 0:b74591d5ab33 | 77 | 'include_paths': list(set(self.resources.inc_dirs)), |
be_bryan | 0:b74591d5ab33 | 78 | 'library_paths': self.resources.lib_dirs, |
be_bryan | 0:b74591d5ab33 | 79 | 'linker_script': self.resources.linker_script, |
be_bryan | 0:b74591d5ab33 | 80 | 'libraries': libraries, |
be_bryan | 0:b74591d5ab33 | 81 | 'ld_sys_libs': sys_libs, |
be_bryan | 0:b74591d5ab33 | 82 | 'hex_files': self.resources.hex_files, |
be_bryan | 0:b74591d5ab33 | 83 | 'vpath': (["../../.."] |
be_bryan | 0:b74591d5ab33 | 84 | if (basename(dirname(dirname(self.export_dir))) |
be_bryan | 0:b74591d5ab33 | 85 | == "projectfiles") |
be_bryan | 0:b74591d5ab33 | 86 | else [".."]), |
be_bryan | 0:b74591d5ab33 | 87 | 'cc_cmd': " ".join(["\'" + part + "\'" for part |
be_bryan | 0:b74591d5ab33 | 88 | in ([basename(self.toolchain.cc[0])] + |
be_bryan | 0:b74591d5ab33 | 89 | self.toolchain.cc[1:])]), |
be_bryan | 0:b74591d5ab33 | 90 | 'cppc_cmd': " ".join(["\'" + part + "\'" for part |
be_bryan | 0:b74591d5ab33 | 91 | in ([basename(self.toolchain.cppc[0])] + |
be_bryan | 0:b74591d5ab33 | 92 | self.toolchain.cppc[1:])]), |
be_bryan | 0:b74591d5ab33 | 93 | 'asm_cmd': " ".join(["\'" + part + "\'" for part |
be_bryan | 0:b74591d5ab33 | 94 | in ([basename(self.toolchain.asm[0])] + |
be_bryan | 0:b74591d5ab33 | 95 | self.toolchain.asm[1:])]), |
be_bryan | 0:b74591d5ab33 | 96 | 'ld_cmd': "\'" + basename(self.toolchain.ld[0]) + "\'", |
be_bryan | 0:b74591d5ab33 | 97 | 'elf2bin_cmd': "\'" + basename(self.toolchain.elf2bin) + "\'", |
be_bryan | 0:b74591d5ab33 | 98 | 'link_script_ext': self.toolchain.LINKER_EXT, |
be_bryan | 0:b74591d5ab33 | 99 | 'link_script_option': self.LINK_SCRIPT_OPTION, |
be_bryan | 0:b74591d5ab33 | 100 | 'user_library_flag': self.USER_LIBRARY_FLAG, |
be_bryan | 0:b74591d5ab33 | 101 | 'needs_asm_preproc': self.PREPROCESS_ASM, |
be_bryan | 0:b74591d5ab33 | 102 | } |
be_bryan | 0:b74591d5ab33 | 103 | |
be_bryan | 0:b74591d5ab33 | 104 | if hasattr(self.toolchain, "preproc"): |
be_bryan | 0:b74591d5ab33 | 105 | ctx['pp_cmd'] = " ".join(["\'" + part + "\'" for part |
be_bryan | 0:b74591d5ab33 | 106 | in ([basename(self.toolchain.preproc[0])] + |
be_bryan | 0:b74591d5ab33 | 107 | self.toolchain.preproc[1:] + |
be_bryan | 0:b74591d5ab33 | 108 | self.toolchain.ld[1:])]) |
be_bryan | 0:b74591d5ab33 | 109 | else: |
be_bryan | 0:b74591d5ab33 | 110 | ctx['pp_cmd'] = None |
be_bryan | 0:b74591d5ab33 | 111 | |
be_bryan | 0:b74591d5ab33 | 112 | for key in ['include_paths', 'library_paths', 'linker_script', |
be_bryan | 0:b74591d5ab33 | 113 | 'hex_files']: |
be_bryan | 0:b74591d5ab33 | 114 | if isinstance(ctx[key], list): |
be_bryan | 0:b74591d5ab33 | 115 | ctx[key] = [ctx['vpath'][0] + "/" + t for t in ctx[key]] |
be_bryan | 0:b74591d5ab33 | 116 | else: |
be_bryan | 0:b74591d5ab33 | 117 | ctx[key] = ctx['vpath'][0] + "/" + ctx[key] |
be_bryan | 0:b74591d5ab33 | 118 | if "../." not in ctx["include_paths"]: |
be_bryan | 0:b74591d5ab33 | 119 | ctx["include_paths"] += ['../.'] |
be_bryan | 0:b74591d5ab33 | 120 | for key in ['include_paths', 'library_paths', 'hex_files', |
be_bryan | 0:b74591d5ab33 | 121 | 'to_be_compiled']: |
be_bryan | 0:b74591d5ab33 | 122 | ctx[key] = sorted(ctx[key]) |
be_bryan | 0:b74591d5ab33 | 123 | ctx.update(self.format_flags()) |
be_bryan | 0:b74591d5ab33 | 124 | |
be_bryan | 0:b74591d5ab33 | 125 | for templatefile in \ |
be_bryan | 0:b74591d5ab33 | 126 | ['makefile/%s_%s.tmpl' % (self.TEMPLATE, |
be_bryan | 0:b74591d5ab33 | 127 | self.target.lower())] + \ |
be_bryan | 0:b74591d5ab33 | 128 | ['makefile/%s_%s.tmpl' % (self.TEMPLATE, |
be_bryan | 0:b74591d5ab33 | 129 | label.lower()) for label |
be_bryan | 0:b74591d5ab33 | 130 | in self.toolchain.target.extra_labels] +\ |
be_bryan | 0:b74591d5ab33 | 131 | ['makefile/%s.tmpl' % self.TEMPLATE]: |
be_bryan | 0:b74591d5ab33 | 132 | try: |
be_bryan | 0:b74591d5ab33 | 133 | self.gen_file(templatefile, ctx, 'Makefile') |
be_bryan | 0:b74591d5ab33 | 134 | break |
be_bryan | 0:b74591d5ab33 | 135 | except TemplateNotFound: |
be_bryan | 0:b74591d5ab33 | 136 | pass |
be_bryan | 0:b74591d5ab33 | 137 | else: |
be_bryan | 0:b74591d5ab33 | 138 | raise NotSupportedException("This make tool is in development") |
be_bryan | 0:b74591d5ab33 | 139 | |
be_bryan | 0:b74591d5ab33 | 140 | def format_flags(self): |
be_bryan | 0:b74591d5ab33 | 141 | """Format toolchain flags for Makefile""" |
be_bryan | 0:b74591d5ab33 | 142 | flags = {} |
be_bryan | 0:b74591d5ab33 | 143 | for k, v in self.flags.iteritems(): |
be_bryan | 0:b74591d5ab33 | 144 | if k in ['asm_flags', 'c_flags', 'cxx_flags']: |
be_bryan | 0:b74591d5ab33 | 145 | flags[k] = map(lambda x: x.replace('"', '\\"'), v) |
be_bryan | 0:b74591d5ab33 | 146 | else: |
be_bryan | 0:b74591d5ab33 | 147 | flags[k] = v |
be_bryan | 0:b74591d5ab33 | 148 | |
be_bryan | 0:b74591d5ab33 | 149 | return flags |
be_bryan | 0:b74591d5ab33 | 150 | |
be_bryan | 0:b74591d5ab33 | 151 | @staticmethod |
be_bryan | 0:b74591d5ab33 | 152 | def build(project_name, log_name="build_log.txt", cleanup=True): |
be_bryan | 0:b74591d5ab33 | 153 | """ Build Make project """ |
be_bryan | 0:b74591d5ab33 | 154 | # > Make -j |
be_bryan | 0:b74591d5ab33 | 155 | cmd = ["make", "-j"] |
be_bryan | 0:b74591d5ab33 | 156 | |
be_bryan | 0:b74591d5ab33 | 157 | # Build the project |
be_bryan | 0:b74591d5ab33 | 158 | p = Popen(cmd, stdout=PIPE, stderr=PIPE) |
be_bryan | 0:b74591d5ab33 | 159 | out, err = p.communicate() |
be_bryan | 0:b74591d5ab33 | 160 | ret_code = p.returncode |
be_bryan | 0:b74591d5ab33 | 161 | |
be_bryan | 0:b74591d5ab33 | 162 | out_string = "=" * 10 + "STDOUT" + "=" * 10 + "\n" |
be_bryan | 0:b74591d5ab33 | 163 | out_string += out |
be_bryan | 0:b74591d5ab33 | 164 | out_string += "=" * 10 + "STDERR" + "=" * 10 + "\n" |
be_bryan | 0:b74591d5ab33 | 165 | out_string += err |
be_bryan | 0:b74591d5ab33 | 166 | |
be_bryan | 0:b74591d5ab33 | 167 | if ret_code == 0: |
be_bryan | 0:b74591d5ab33 | 168 | out_string += "SUCCESS" |
be_bryan | 0:b74591d5ab33 | 169 | else: |
be_bryan | 0:b74591d5ab33 | 170 | out_string += "FAILURE" |
be_bryan | 0:b74591d5ab33 | 171 | |
be_bryan | 0:b74591d5ab33 | 172 | print out_string |
be_bryan | 0:b74591d5ab33 | 173 | |
be_bryan | 0:b74591d5ab33 | 174 | if log_name: |
be_bryan | 0:b74591d5ab33 | 175 | # Write the output to the log file |
be_bryan | 0:b74591d5ab33 | 176 | with open(log_name, 'w+') as f: |
be_bryan | 0:b74591d5ab33 | 177 | f.write(out_string) |
be_bryan | 0:b74591d5ab33 | 178 | |
be_bryan | 0:b74591d5ab33 | 179 | # Cleanup the exported and built files |
be_bryan | 0:b74591d5ab33 | 180 | if cleanup: |
be_bryan | 0:b74591d5ab33 | 181 | remove("Makefile") |
be_bryan | 0:b74591d5ab33 | 182 | remove(log_name) |
be_bryan | 0:b74591d5ab33 | 183 | # legacy .build directory cleaned if exists |
be_bryan | 0:b74591d5ab33 | 184 | if exists('.build'): |
be_bryan | 0:b74591d5ab33 | 185 | shutil.rmtree('.build') |
be_bryan | 0:b74591d5ab33 | 186 | if exists('BUILD'): |
be_bryan | 0:b74591d5ab33 | 187 | shutil.rmtree('BUILD') |
be_bryan | 0:b74591d5ab33 | 188 | |
be_bryan | 0:b74591d5ab33 | 189 | if ret_code != 0: |
be_bryan | 0:b74591d5ab33 | 190 | # Seems like something went wrong. |
be_bryan | 0:b74591d5ab33 | 191 | return -1 |
be_bryan | 0:b74591d5ab33 | 192 | else: |
be_bryan | 0:b74591d5ab33 | 193 | return 0 |
be_bryan | 0:b74591d5ab33 | 194 | |
be_bryan | 0:b74591d5ab33 | 195 | |
be_bryan | 0:b74591d5ab33 | 196 | class GccArm(Makefile): |
be_bryan | 0:b74591d5ab33 | 197 | """GCC ARM specific makefile target""" |
be_bryan | 0:b74591d5ab33 | 198 | NAME = 'Make-GCC-ARM' |
be_bryan | 0:b74591d5ab33 | 199 | TEMPLATE = 'make-gcc-arm' |
be_bryan | 0:b74591d5ab33 | 200 | TOOLCHAIN = "GCC_ARM" |
be_bryan | 0:b74591d5ab33 | 201 | LINK_SCRIPT_OPTION = "-T" |
be_bryan | 0:b74591d5ab33 | 202 | USER_LIBRARY_FLAG = "-L" |
be_bryan | 0:b74591d5ab33 | 203 | |
be_bryan | 0:b74591d5ab33 | 204 | @staticmethod |
be_bryan | 0:b74591d5ab33 | 205 | def prepare_lib(libname): |
be_bryan | 0:b74591d5ab33 | 206 | if "lib" == libname[:3]: |
be_bryan | 0:b74591d5ab33 | 207 | libname = libname[3:-2] |
be_bryan | 0:b74591d5ab33 | 208 | return "-l" + libname |
be_bryan | 0:b74591d5ab33 | 209 | |
be_bryan | 0:b74591d5ab33 | 210 | @staticmethod |
be_bryan | 0:b74591d5ab33 | 211 | def prepare_sys_lib(libname): |
be_bryan | 0:b74591d5ab33 | 212 | return "-l" + libname |
be_bryan | 0:b74591d5ab33 | 213 | |
be_bryan | 0:b74591d5ab33 | 214 | |
be_bryan | 0:b74591d5ab33 | 215 | class Arm(Makefile): |
be_bryan | 0:b74591d5ab33 | 216 | """ARM Compiler generic makefile target""" |
be_bryan | 0:b74591d5ab33 | 217 | LINK_SCRIPT_OPTION = "--scatter" |
be_bryan | 0:b74591d5ab33 | 218 | USER_LIBRARY_FLAG = "--userlibpath " |
be_bryan | 0:b74591d5ab33 | 219 | TEMPLATE = 'make-arm' |
be_bryan | 0:b74591d5ab33 | 220 | |
be_bryan | 0:b74591d5ab33 | 221 | @staticmethod |
be_bryan | 0:b74591d5ab33 | 222 | def prepare_lib(libname): |
be_bryan | 0:b74591d5ab33 | 223 | return libname |
be_bryan | 0:b74591d5ab33 | 224 | |
be_bryan | 0:b74591d5ab33 | 225 | @staticmethod |
be_bryan | 0:b74591d5ab33 | 226 | def prepare_sys_lib(libname): |
be_bryan | 0:b74591d5ab33 | 227 | return libname |
be_bryan | 0:b74591d5ab33 | 228 | |
be_bryan | 0:b74591d5ab33 | 229 | def generate(self): |
be_bryan | 0:b74591d5ab33 | 230 | if self.resources.linker_script: |
be_bryan | 0:b74591d5ab33 | 231 | new_script = self.toolchain.correct_scatter_shebang( |
be_bryan | 0:b74591d5ab33 | 232 | self.resources.linker_script) |
be_bryan | 0:b74591d5ab33 | 233 | if new_script is not self.resources.linker_script: |
be_bryan | 0:b74591d5ab33 | 234 | self.resources.linker_script = new_script |
be_bryan | 0:b74591d5ab33 | 235 | self.generated_files.append(new_script) |
be_bryan | 0:b74591d5ab33 | 236 | return super(Arm, self).generate() |
be_bryan | 0:b74591d5ab33 | 237 | |
be_bryan | 0:b74591d5ab33 | 238 | class Armc5(Arm): |
be_bryan | 0:b74591d5ab33 | 239 | """ARM Compiler 5 (armcc) specific makefile target""" |
be_bryan | 0:b74591d5ab33 | 240 | NAME = 'Make-ARMc5' |
be_bryan | 0:b74591d5ab33 | 241 | TOOLCHAIN = "ARM" |
be_bryan | 0:b74591d5ab33 | 242 | PREPROCESS_ASM = True |
be_bryan | 0:b74591d5ab33 | 243 | |
be_bryan | 0:b74591d5ab33 | 244 | class Armc6(Arm): |
be_bryan | 0:b74591d5ab33 | 245 | """ARM Compiler 6 (armclang) specific generic makefile target""" |
be_bryan | 0:b74591d5ab33 | 246 | NAME = 'Make-ARMc6' |
be_bryan | 0:b74591d5ab33 | 247 | TOOLCHAIN = "ARMC6" |
be_bryan | 0:b74591d5ab33 | 248 | |
be_bryan | 0:b74591d5ab33 | 249 | |
be_bryan | 0:b74591d5ab33 | 250 | class IAR(Makefile): |
be_bryan | 0:b74591d5ab33 | 251 | """IAR specific makefile target""" |
be_bryan | 0:b74591d5ab33 | 252 | NAME = 'Make-IAR' |
be_bryan | 0:b74591d5ab33 | 253 | TEMPLATE = 'make-iar' |
be_bryan | 0:b74591d5ab33 | 254 | TOOLCHAIN = "IAR" |
be_bryan | 0:b74591d5ab33 | 255 | LINK_SCRIPT_OPTION = "--config" |
be_bryan | 0:b74591d5ab33 | 256 | USER_LIBRARY_FLAG = "-L" |
be_bryan | 0:b74591d5ab33 | 257 | |
be_bryan | 0:b74591d5ab33 | 258 | @staticmethod |
be_bryan | 0:b74591d5ab33 | 259 | def prepare_lib(libname): |
be_bryan | 0:b74591d5ab33 | 260 | if "lib" == libname[:3]: |
be_bryan | 0:b74591d5ab33 | 261 | libname = libname[3:] |
be_bryan | 0:b74591d5ab33 | 262 | return "-l" + splitext(libname)[0] |
be_bryan | 0:b74591d5ab33 | 263 | |
be_bryan | 0:b74591d5ab33 | 264 | @staticmethod |
be_bryan | 0:b74591d5ab33 | 265 | def prepare_sys_lib(libname): |
be_bryan | 0:b74591d5ab33 | 266 | if "lib" == libname[:3]: |
be_bryan | 0:b74591d5ab33 | 267 | libname = libname[3:] |
be_bryan | 0:b74591d5ab33 | 268 | return "-l" + splitext(libname)[0] |