#!/usr/bin/env python # Tool for canonical RISC-V architecture string. # Copyright (C) 2011-2022 Free Software Foundation, Inc. # Contributed by Andrew Waterman (andrew@sifive.com). # # This file is part of GCC. # # GCC is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 3, or (at your option) # any later version. # # GCC is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with GCC; see the file COPYING3. If not see # . # TODO: Extract riscv_subset_t from riscv-common.cc and make it can be compiled # standalone to replace this script, that also prevents us implementing # that twice and keep sync again and again. from __future__ import print_function import sys import argparse import collections import itertools from functools import reduce SUPPORTED_ISA_SPEC = ["2.2", "20190608", "20191213"] CANONICAL_ORDER = "imafdgqlcbjktpvn" LONG_EXT_PREFIXES = ['z', 's', 'h', 'x'] # # IMPLIED_EXT(ext) -> implied extension list. # IMPLIED_EXT = { "d" : ["f", "zicsr"], "f" : ["zicsr"], "zk" : ["zkn", "zkr", "zkt"], "zkn" : ["zbkb", "zbkc", "zbkx", "zkne", "zknd", "zknh"], "zks" : ["zbkb", "zbkc", "zbkx", "zksed", "zksh"], "v" : ["zvl128b", "zve64d"], "zve32x" : ["zvl32b"], "zve64x" : ["zve32x", "zvl64b"], "zve32f" : ["f", "zve32x"], "zve64f" : ["f", "zve32f", "zve64x"], "zve64d" : ["d", "zve64f"], "zvl64b" : ["zvl32b"], "zvl128b" : ["zvl64b"], "zvl256b" : ["zvl128b"], "zvl512b" : ["zvl256b"], "zvl1024b" : ["zvl512b"], "zvl2048b" : ["zvl1024b"], "zvl4096b" : ["zvl2048b"], "zvl8192b" : ["zvl4096b"], "zvl16384b" : ["zvl8192b"], "zvl32768b" : ["zvl16384b"], "zvl65536b" : ["zvl32768b"], } def arch_canonicalize(arch, isa_spec): # TODO: Support extension version. is_isa_spec_2p2 = isa_spec == '2.2' new_arch = "" extra_long_ext = [] std_exts = [] if arch[:5] in ['rv32e', 'rv32i', 'rv32g', 'rv64i', 'rv64g']: new_arch = arch[:5].replace("g", "i") if arch[:5] in ['rv32g', 'rv64g']: std_exts = ['m', 'a', 'f', 'd'] if not is_isa_spec_2p2: extra_long_ext = ['zicsr', 'zifencei'] else: raise Exception("Unexpected arch: `%s`" % arch[:5]) # Find any Z, S, H or X long_ext_prefixes_idx = map(lambda x: arch.find(x), LONG_EXT_PREFIXES) # Filter out any non-existent index. long_ext_prefixes_idx = list(filter(lambda x: x != -1, long_ext_prefixes_idx)) if long_ext_prefixes_idx: first_long_ext_idx = min(long_ext_prefixes_idx) long_exts = arch[first_long_ext_idx:].split("_") std_exts += list(arch[5:first_long_ext_idx]) else: long_exts = [] std_exts += list(arch[5:]) long_exts += extra_long_ext # # Handle implied extensions. # any_change = True while any_change: any_change = False for ext in std_exts + long_exts: if ext in IMPLIED_EXT: implied_exts = IMPLIED_EXT[ext] for implied_ext in implied_exts: if implied_ext == 'zicsr' and is_isa_spec_2p2: continue if implied_ext not in std_exts + long_exts: long_exts.append(implied_ext) any_change = True # Single letter extension might appear in the long_exts list, # becasue we just append extensions list to the arch string. std_exts += list(filter(lambda x:len(x) == 1, long_exts)) def longext_sort (exts): if not exts.startswith("zxm") and exts.startswith("z"): # If "Z" extensions are named, they should be ordered first by CANONICAL. if exts[1] not in CANONICAL_ORDER: raise Exception("Unsupported extension `%s`" % exts) canonical_sort = CANONICAL_ORDER.index(exts[1]) else: canonical_sort = -1 return (exts.startswith("x"), exts.startswith("zxm"), LONG_EXT_PREFIXES.index(exts[0]), canonical_sort, exts[1:]) # Removing duplicates. long_exts = list(set(long_exts)) # Multi-letter extension must be in lexicographic order. long_exts = list(sorted(filter(lambda x:len(x) != 1, long_exts), key=longext_sort)) # Put extensions in canonical order. for ext in CANONICAL_ORDER: if ext in std_exts: new_arch += ext # Check every extension is processed. for ext in std_exts: if ext == '_': continue if ext not in CANONICAL_ORDER: raise Exception("Unsupported extension `%s`" % ext) # Concat rest of the multi-char extensions. if long_exts: new_arch += "_" + "_".join(long_exts) return new_arch if len(sys.argv) < 2: print ("Usage: %s [*]" % sys.argv) sys.exit(1) parser = argparse.ArgumentParser() parser.add_argument('-misa-spec', type=str, default='20191213', choices=SUPPORTED_ISA_SPEC) parser.add_argument('arch_strs', nargs=argparse.REMAINDER) args = parser.parse_args() for arch in args.arch_strs: print (arch_canonicalize(arch, args.misa_spec))