make.py

   1 #!/usr/bin/env python3
   2
   3 import sys, os, argparse, subprocess, struct
   4
   5 from mibuild.tools import write_to_file
   6 from migen.util.misc import autotype
   7 from migen.fhdl import simplify
   8
   9 from misoclib.soc import cpuif
  10 from misoclib.mem.sdram.phy import initsequence
  11
  12 from misoc_import import misoc_import
  13
  14 def _get_args():
  15         parser = argparse.ArgumentParser(formatter_class=argparse.RawDescriptionHelpFormatter,
  16                 description="""\
  17 MiSoC - a high performance and small footprint SoC based on Migen.
  18
  19 This program builds and/or loads MiSoC components.
  20 One or several actions can be specified:
  21
  22 clean           delete previous build(s).
  23 build-bitstream build FPGA bitstream. Implies build-bios on targets with
  24                 integrated BIOS.
  25 build-headers   build software header files with CPU/CSR/IRQ/SDRAM_PHY definitions.
  26 build-csr-csv   save CSR map into CSV file.
  27 build-bios      build BIOS. Implies build-header.
  28
  29 load-bitstream  load bitstream into volatile storage.
  30 flash-bitstream load bitstream into non-volatile storage.
  31 flash-bios      load BIOS into non-volatile storage.
  32
  33 all             clean, build-bitstream, build-bios, flash-bitstream, flash-bios.
  34
  35 Load/flash actions use the existing outputs, and do not trigger new builds.
  36 """)
  37
  38         parser.add_argument("-t", "--target", default="mlabs_video", help="SoC type to build")
  39         parser.add_argument("-s", "--sub-target", default="", help="variant of the SoC type to build")
  40         parser.add_argument("-p", "--platform", default=None, help="platform to build for")
  41         parser.add_argument("-Ot", "--target-option", default=[], nargs=2, action="append", help="set target-specific option")
  42         parser.add_argument("-Op", "--platform-option", default=[], nargs=2, action="append", help="set platform-specific option")
  43         parser.add_argument("-X", "--external", default="", help="use external directory for targets, platforms and imports")
  44         parser.add_argument("--csr_csv", default="csr.csv", help="CSV file to save the CSR map into")
  45
  46         parser.add_argument("-d", "--decorate", default=[], action="append", help="apply simplification decorator to top-level")
  47         parser.add_argument("-Ob", "--build-option", default=[], nargs=2, action="append", help="set build option")
  48         parser.add_argument("-f", "--flash-proxy-dir", default=None, help="set search directory for flash proxy bitstreams")
  49
  50         parser.add_argument("action", nargs="+", help="specify an action")
  51
  52         return parser.parse_args()
  53
  54 if __name__ == "__main__":
  55         args = _get_args()
  56
  57         external_target = ""
  58         external_platform = ""
  59         if args.external:
  60                 external_target = os.path.join(args.external, "targets")
  61                 external_platform = os.path.join(args.external, "platforms")
  62                 sys.path.insert(1, os.path.abspath(args.external))
  63
  64         # create top-level SoC object
  65         target_module = misoc_import("targets", external_target, args.target)
  66         if args.sub_target:
  67                 top_class = getattr(target_module, args.sub_target)
  68         else:
  69                 top_class = target_module.default_subtarget
  70
  71         if args.platform is None:
  72                 if hasattr(top_class, "default_platform"):
  73                         platform_name = top_class.default_platform
  74                 else:
  75                         raise ValueError("Target has no default platform, specify a platform with -p your_platform")
  76         else:
  77                 platform_name = args.platform
  78         platform_module = misoc_import("mibuild.platforms", external_platform, platform_name)
  79         platform_kwargs = dict((k, autotype(v)) for k, v in args.platform_option)
  80         platform = platform_module.Platform(**platform_kwargs)
  81         if args.external:
  82                 platform.soc_ext_path = os.path.abspath(args.external)
  83
  84         build_name = top_class.__name__.lower() + "-" + platform_name
  85         top_kwargs = dict((k, autotype(v)) for k, v in args.target_option)
  86         soc = top_class(platform, **top_kwargs)
  87         soc.finalize()
  88         memory_regions = soc.get_memory_regions()
  89         csr_regions = soc.get_csr_regions()
  90
  91         bios_file = "software/bios/bios.bin"
  92
  93         # decode actions
  94         action_list = ["clean", "build-bitstream", "build-headers", "build-csr-csv", "build-bios",
  95                 "load-bitstream", "flash-bitstream", "flash-bios", "all"]
  96         actions = {k: False for k in action_list}
  97         for action in args.action:
  98                 if action in actions:
  99                         actions[action] = True
 100                 else:
 101                         print("Unknown action: "+action+". Valid actions are:")
 102                         for a in action_list:
 103                                 print("  "+a)
 104                         sys.exit(1)
 105
 106         print("""\
 107                 __  ___  _   ____     _____
 108                /  |/  / (_) / __/__  / ___/
 109               / /|_/ / / / _\ \/ _ \/ /__
 110              /_/  /_/ /_/ /___/\___/\___/
 111
 112 a high performance and small footprint SoC based on Migen
 113
 114 ====== Building for: ======
 115 Platform:  {}
 116 Target:    {}
 117 Subtarget: {}
 118 CPU type:  {}
 119 ===========================""".format(platform_name, args.target, top_class.__name__, soc.cpu_type))
 120
 121         # dependencies
 122         if actions["all"]:
 123                 actions["clean"] = True
 124                 actions["build-bitstream"] = True
 125                 actions["build-bios"] = True
 126                 if not actions["load-bitstream"]:
 127                         actions["flash-bitstream"] = True
 128                 if not soc.integrated_rom_size:
 129                         actions["flash-bios"] = True
 130         if actions["build-bitstream"] and soc.integrated_rom_size:
 131                 actions["build-bios"] = True
 132         if actions["build-bios"]:
 133                 actions["build-headers"] = True
 134
 135         if actions["clean"]:
 136                 subprocess.call(["rm", "-rf", "build/*"])
 137                 subprocess.call(["make", "-C", "software/libcompiler-rt", "clean"])
 138                 subprocess.call(["make", "-C", "software/libbase", "clean"])
 139                 subprocess.call(["make", "-C", "software/libnet", "clean"])
 140                 subprocess.call(["make", "-C", "software/bios", "clean"])
 141
 142         if actions["build-headers"]:
 143                 boilerplate = """/*
 144  * Platform:  {}
 145  * Target:    {}
 146  * Subtarget: {}
 147  * CPU type:  {}
 148  */
 149
 150 """.format(platform_name, args.target, top_class.__name__, soc.cpu_type)
 151                 if soc.cpu_type != "none":
 152                         cpu_mak = cpuif.get_cpu_mak(soc.cpu_type)
 153                         write_to_file("software/include/generated/cpu.mak", cpu_mak)
 154                         linker_output_format = cpuif.get_linker_output_format(soc.cpu_type)
 155                         write_to_file("software/include/generated/output_format.ld", linker_output_format)
 156
 157                         linker_regions = cpuif.get_linker_regions(memory_regions)
 158                         write_to_file("software/include/generated/regions.ld", boilerplate + linker_regions)
 159
 160                         for sdram_phy in ["sdrphy", "ddrphy"]:
 161                                 if hasattr(soc, sdram_phy):
 162                                         sdram_phy_header = initsequence.get_sdram_phy_header(getattr(soc, sdram_phy).settings)
 163                                         write_to_file("software/include/generated/sdram_phy.h", boilerplate + sdram_phy_header)
 164                 mem_header = cpuif.get_mem_header(memory_regions, getattr(soc, "flash_boot_address", None))
 165                 write_to_file("software/include/generated/mem.h", boilerplate + mem_header)
 166                 csr_header = cpuif.get_csr_header(csr_regions, soc.interrupt_map)
 167                 write_to_file("software/include/generated/csr.h", boilerplate + csr_header)
 168
 169         if actions["build-csr-csv"]:
 170                 csr_csv = cpuif.get_csr_csv(csr_regions)
 171                 write_to_file(args.csr_csv, csr_csv)
 172
 173         if actions["build-bios"]:
 174                 ret = subprocess.call(["make", "-C", "software/bios"])
 175                 if ret:
 176                         raise OSError("BIOS build failed")
 177
 178         if actions["build-bitstream"]:
 179                 if soc.integrated_rom_size:
 180                         with open(bios_file, "rb") as boot_file:
 181                                 boot_data = []
 182                                 while True:
 183                                         w = boot_file.read(4)
 184                                         if not w:
 185                                                 break
 186                                         boot_data.append(struct.unpack(">I", w)[0])
 187                         soc.init_rom(boot_data)
 188
 189                 for decorator in args.decorate:
 190                         soc = getattr(simplify, decorator)(soc)
 191                 build_kwargs = dict((k, autotype(v)) for k, v in args.build_option)
 192                 vns = platform.build(soc, build_name=build_name, **build_kwargs)
 193                 soc.do_exit(vns)
 194
 195         if actions["load-bitstream"]:
 196                 prog = platform.create_programmer()
 197                 prog.load_bitstream("build/" + build_name + platform.bitstream_ext)
 198
 199         if actions["flash-bitstream"]:
 200                 prog = platform.create_programmer()
 201                 prog.set_flash_proxy_dir(args.flash_proxy_dir)
 202                 if prog.needs_bitreverse:
 203                         flashbit = "build/" + build_name + ".fpg"
 204                         subprocess.call(["tools/byteswap",
 205                                 "build/" + build_name + ".bin",
 206                                 flashbit])
 207                 else:
 208                         flashbit = "build/" + build_name + ".bin"
 209                 prog.flash(0, flashbit)
 210
 211         if actions["flash-bios"]:
 212                 prog = platform.create_programmer()
 213                 prog.set_flash_proxy_dir(args.flash_proxy_dir)
 214                 prog.flash(soc.cpu_reset_address, bios_file)