#!/usr/bin/env python3 import sys, argparse, importlib, subprocess, struct from mibuild.tools import write_to_file from migen.util.misc import autotype from migen.fhdl import simplify from misoclib.gensoc import cpuif from misoclib.s6ddrphy import initsequence import programmer def _get_args(): parser = argparse.ArgumentParser(formatter_class=argparse.RawDescriptionHelpFormatter, description="""\ MiSoC - a high performance and small footprint SoC based on Migen. This program builds and/or loads MiSoC components. One or several actions can be specified: build-bitstream build FPGA bitstream. Implies build-bios on targets with integrated BIOS. build-headers build software header files with CSR/IRQ/SDRAM_PHY definitions. build-csr-csv save CSR map into CSV file. build-bios build BIOS. Implies build-header. load-bitstream load bitstream into volatile storage. flash-bitstream load bitstream into non-volatile storage. flash-bios load BIOS into non-volatile storage. all build-bitstream, build-bios, flash-bitstream, flash-bios. Load/flash actions use the existing outputs, and do not trigger new builds. """) parser.add_argument("-p", "--platform", default="mixxeo", help="platform to build for") parser.add_argument("-t", "--target", default="mlabs_video", help="SoC type to build") parser.add_argument("-s", "--sub-target", default="", help="variant of the SoC type to build") parser.add_argument("-Ot", "--target-option", default=[], nargs=2, action="append", help="set target-specific option") parser.add_argument("-Xp", "--external-platform", default="", help="use external platform file in the specified path") parser.add_argument("-Xt", "--external-target", default="", help="use external target file in the specified path") parser.add_argument("-d", "--decorate", default=[], action="append", help="apply simplification decorator to top-level") parser.add_argument("-Ob", "--build-option", default=[], nargs=2, action="append", help="set build option") parser.add_argument("-f", "--flash-proxy-dir", default=None, help="set search directory for flash proxy bitstreams") parser.add_argument("action", nargs="+", help="specify an action") return parser.parse_args() def _misoc_import(default, external, name): if external: try: del sys.modules[name] # force external path search except KeyError: pass loader = importlib.find_loader(name, [external]) if loader is None: raise ImportError("Module not found: "+name) return loader.load_module() else: return importlib.import_module(default + "." + name) if __name__ == "__main__": args = _get_args() # create top-level SoC object platform_module = _misoc_import("mibuild.platforms", args.external_platform, args.platform) target_module = _misoc_import("targets", args.external_target, args.target) platform = platform_module.Platform() if args.sub_target: top_class = getattr(target_module, args.sub_target) else: top_class = target_module.get_default_subtarget(platform) build_name = top_class.__name__.lower() + "-" + args.platform top_kwargs = dict((k, autotype(v)) for k, v in args.target_option) soc = top_class(platform, **top_kwargs) soc.finalize() # decode actions action_list = ["build-bitstream", "build-headers", "build-csr-csv", "build-bios", "load-bitstream", "flash-bitstream", "flash-bios", "all"] actions = {k: False for k in action_list} for action in args.action: if action in actions: actions[action] = True else: print("Unknown action: "+action+". Valid actions are:") for a in action_list: print(" "+a) sys.exit(1) # dependencies if actions["all"]: actions["build-bitstream"] = True actions["build-bios"] = True actions["flash-bitstream"] = True actions["flash-bios"] = True if actions["build-bitstream"] and hasattr(soc, "init_bios_memory"): actions["build-bios"] = True if actions["build-bios"]: actions["build-headers"] = True if actions["build-headers"]: boilerplate = """/* * Platform: {} * Target: {} * Subtarget: {} */ """.format(args.platform, args.target, top_class.__name__) linker_header = cpuif.get_linker_regions(soc.cpu_memory_regions) write_to_file("software/include/generated/regions.ld", boilerplate + linker_header) csr_header = cpuif.get_csr_header(soc.csr_base, soc.csrbankarray, soc.interrupt_map) write_to_file("software/include/generated/csr.h", boilerplate + csr_header) if hasattr(soc, "ddrphy"): sdram_phy_header = initsequence.get_sdram_phy_header(soc.ddrphy) write_to_file("software/include/generated/sdram_phy.h", boilerplate + sdram_phy_header) if actions["build-csr-csv"]: csr_csv = cpuif.get_csr_csv(soc.csr_base, soc.csrbankarray) write_to_file(args.csr_csv, csr_csv) if actions["build-bios"]: ret = subprocess.call(["make", "-C", "software/bios"]) if ret: raise OSError("BIOS build failed") if hasattr(soc, "init_bios_memory"): with open("software/bios/bios.bin", "rb") as bios_file: bios_data = [] while True: w = bios_file.read(4) if not w: break bios_data.append(struct.unpack(">I", w)[0]) soc.init_bios_memory(bios_data) if actions["build-bitstream"]: for decorator in args.decorate: soc = getattr(simplify, decorator)(soc) build_kwargs = dict((k, autotype(v)) for k, v in args.build_option) platform.build(soc, build_name=build_name, **build_kwargs) if actions["load-bitstream"] or actions["flash-bitstream"] or actions["flash-bios"]: prog = programmer.create_programmer(platform.name, args.flash_proxy_dir) if actions["load-bitstream"]: prog.load_bitstream("build/" + build_name + ".bit") if actions["flash-bitstream"]: if prog.needs_bitreverse: flashbit = "build/" + build_name + ".fpg" subprocess.call(["tools/byteswap", "build/" + build_name + ".bin", flashbit]) else: flashbit = "build/" + build_name + ".bin" prog.flash(0, flashbit) if actions["flash-bios"]: prog.flash(soc.cpu_reset_address, "software/bios/bios.bin")