openpower/sv_analysis.py

   1 #!/usr/bin/env python3
   2 # Initial version written by lkcl Oct 2020
   3 # This program analyses the Power 9 op codes and looks at in/out register uses
   4 # The results are displayed:
   5 #       https://libre-soc.org/openpower/opcode_regs_deduped/
   6 #
   7 # It finds .csv files in the directory isatables/
   8
   9 import csv
  10 import os
  11 from os.path import dirname, join
  12 from glob import glob
  13 from collections import OrderedDict
  14
  15 # Return absolute path (ie $PWD) + isatables + name
  16 def find_wiki_file(name):
  17     filedir = os.path.dirname(os.path.abspath(__file__))
  18     tabledir = join(filedir, 'isatables')
  19     file_path = join(tabledir, name)
  20     return file_path
  21
  22 # Return an array of dictionaries from the CSV file name:
  23 def get_csv(name):
  24     file_path = find_wiki_file(name)
  25     with open(file_path, 'r') as csvfile:
  26         reader = csv.DictReader(csvfile)
  27         return list(reader)
  28
  29 # This will return True if all values are true.
  30 # Not sure what this is about
  31 def blank_key(row):
  32     #for v in row.values():
  33     #    if 'SPR' in v: # skip all SPRs
  34     #        return True
  35     for v in row.values():
  36         if v:
  37             return False
  38     return True
  39
  40 # General purpose registers have names like: RA, RT, R1, ...
  41 # Floating point registers names like: FRT, FRA, FR1, ..., FRTp, ...
  42 # Return True if field is a register
  43 def isreg(field):
  44     return field.startswith('R') or field.startswith('FR')
  45
  46
  47 # These are the attributes of the instructions,
  48 # register names
  49 keycolumns = ['unit', 'in1', 'in2', 'in3', 'out', 'CR in', 'CR out',
  50                  ] # don't think we need these: 'ldst len', 'rc', 'lk']
  51
  52 tablecols = ['unit', 'in', 'outcnt', 'CR in', 'CR out',
  53                  ] # don't think we need these: 'ldst len', 'rc', 'lk']
  54
  55 def create_key(row):
  56     res = OrderedDict()
  57     #print ("row", row)
  58     for key in keycolumns:
  59         # registers IN - special-case: count number of regs RA/RB/RC/RS
  60         if key in ['in1', 'in2', 'in3']:
  61             if 'in' not in res:
  62                 res['in'] = 0
  63             if isreg(row[key]):
  64                 res['in'] += 1
  65
  66         # registers OUT
  67         if key == 'out':
  68             # If upd is 1 then increment the count of outputs
  69             if 'outcnt' not in res:
  70                 res['outcnt'] = 0
  71             if isreg(row[key]):
  72                 res['outcnt'] += 1
  73             if row['upd'] == '1':
  74                 res['outcnt'] += 1
  75
  76         # CRs (Condition Register) (CR0 .. CR7)
  77         if key.startswith('CR'):
  78             if row[key].startswith('NONE'):
  79                 res[key] = '0'
  80             else:
  81                 res[key] = '1'
  82         # unit
  83         if key == 'unit':
  84             if row[key] == 'LDST': # we care about LDST units
  85                 res[key] = row[key]
  86             else:
  87                 res[key] = 'OTHER'
  88         # LDST len (LoadStore length)
  89         if key.startswith('ldst'):
  90             if row[key].startswith('NONE'):
  91                 res[key] = '0'
  92             else:
  93                 res[key] = '1'
  94         # rc, lk
  95         if key in ['rc', 'lk']:
  96             if row[key] == 'ONE':
  97                 res[key] = '1'
  98             elif row[key] == 'NONE':
  99                 res[key] = '0'
 100             else:
 101                 res[key] = 'R'
 102         if key == 'lk':
 103             res[key] = row[key]
 104
 105     # Convert the numerics 'in' & 'outcnt' to strings
 106     res['in'] = str(res['in'])
 107     res['outcnt'] = str(res['outcnt'])
 108
 109     return res
 110
 111 #
 112 def dformat(d):
 113     res = []
 114     for k, v in d.items():
 115         res.append("%s: %s" % (k, v))
 116     return ' '.join(res)
 117
 118 def tformat(d):
 119     return ' | '.join(d) + "|"
 120
 121 def keyname(row):
 122     res = []
 123     if row['unit'] != 'OTHER':
 124         res.append(row['unit'])
 125     if row['in'] != '0':
 126         res.append('%sR' % row['in'])
 127     if row['outcnt'] != '0':
 128         res.append('%sW' % row['outcnt'])
 129     if row['CR in'] == '1' and row['CR out'] == '1':
 130         res.append("CRio")
 131     elif row['CR in'] == '1':
 132         res.append("CRi")
 133     elif row['CR out'] == '1':
 134         res.append("CRo")
 135     return '-'.join(res)
 136
 137
 138 def process_csvs():
 139     csvs = {}
 140     bykey = {}
 141     primarykeys = set()
 142     dictkeys = OrderedDict()
 143
 144     # Expand that (all .csv files)
 145     pth = find_wiki_file("*.csv")
 146
 147     # Ignore those containing: valid test sprs
 148     for fname in glob(pth):
 149         if 'valid' in fname:
 150             continue
 151         if 'test' in fname:
 152             continue
 153         if 'sprs' in fname:
 154             continue
 155
 156         #print (fname)
 157         csvname = os.path.split(fname)[1]
 158         # csvname is something like: minor_59.csv, fname the whole path
 159         csv = get_csv(fname)
 160         csvs[fname] = csv
 161         for row in csv:
 162             if blank_key(row):
 163                 continue
 164             dkey = create_key(row)
 165             key = tuple(dkey.values())
 166             # print("key=", key)
 167             dictkeys[key] = dkey
 168             primarykeys.add(key)
 169             if key not in bykey:
 170                 bykey[key] = []
 171             bykey[key].append((csvname, row['opcode'], row['comment'],
 172                                row['form'].upper() + '-Form'))
 173
 174     primarykeys = list(primarykeys)
 175     primarykeys.sort()
 176
 177     print ("# keys")
 178     print ('')
 179     print ('[[!table  data="""')
 180     print (tformat(tablecols) + " name |")
 181
 182     for key in primarykeys:
 183         name = keyname(dictkeys[key])
 184         print (tformat(dictkeys[key].values()) + " %s |" % name)
 185     print ('"""]]')
 186     print ('')
 187
 188     for key in primarykeys:
 189         name = keyname(dictkeys[key])
 190         print ("## %s " % name)
 191         print ('')
 192         print ('[[!table  data="""')
 193         print (tformat(['CSV', 'opcode', 'asm', 'form']))
 194         rows = bykey[key]
 195         rows.sort()
 196         for row in rows:
 197             print (tformat(row))
 198         print ('"""]]')
 199         print ('')
 200
 201     bykey = {}
 202     for fname, csv in csvs.items():
 203         key
 204
 205 if __name__ == '__main__':
 206     process_csvs()