DM: Use SR specific guidelines document
[glsdk/iodelay-config.git] / iodelay-autogen.py
1 #!/usr/bin/python
2 # Python script to automatically generate the IO pad and delay data
3 # Author:- Nikhil Devshatwar
5 # This script uses regdump of the pad registers to figure out the muxmodes
6 # Based on the pad and muxmode, it find out all possible virtual/manual modes
7 # by referring to the PCT XML model. Using the, selection file, script
8 # decides which modes to be selected. Finally it dumps the required array entries
10 # This script depends on following files:-
11 # * XML data files      - Shipped with the DRA7xx PCT tool
12 # * Pad register dump   - Generate using omapconf dump 0x4a003400 0x4a00380c
13 # * selection file      - List of selected virtual/manual modes to be used
15 import xml.etree.ElementTree as ET
16 import re
17 import argparse
19 # Handle the command line arguments
20 parser = argparse.ArgumentParser(prog='iodelay-autogen.py',
21         description='Python script to generate the IOdelay data.\n' \
22                 'This script refers to the XML data and automatically generates\n' \
23                 'PAD and DELAY data for the same use case.\n' \
24                 'Note that only the PADs which are used in the dump are configured.',
25         epilog='Generate the pad and delay data using pad register dumps. For this,\n' \
26                 'Run omapconf dump 0x4a003400 0x4a00380c and save the output')
28 parser.add_argument('-d', '--debug', dest='debug',
29         action='store', type=int, choices=[0, 1, 2], default=0,
30         help='set the debug level')
32 parser.add_argument('-i', '--interactive', dest='interactive',
33         action='store', type=int, choices=[0, 1], default=1,
34         help='run interactively with menus for resolving conflicts')
36 parser.add_argument('-f', '--format', dest='format',
37         action='store', type=str, choices=["linux", "uboot", "bios"], default="uboot",
38         help='select the output format to be used')
40 parser.add_argument('-r', '--revision', dest='revision',
41         action='store', type=str, choices=["1.0", "1.1", "2.0"], default="1.1",
42         help='select the silicon revision')
44 parser.add_argument('-p', '--part', dest='part',
45         action='store', type=str, choices=["dra74x", "dra75x", "dra72x"], default="dra74x",
46         help='select the device part')
48 parser.add_argument('-m', '--module', dest='module',
49         action='store', type=str, default="",
50         help='generate only for modules matching the provided RE')
52 parser.add_argument('-s', '--strict', dest='strict',
53         action='store_true',
54         help='strict mode - ask for each pad of the group, do not save selection.\n' \
55                 'For some peripherals, same delaymode cannot be used for all the pads.\n' \
56                 'Use this mode to select different modes for each pad')
58 parser.add_argument('-g', '--gpio', dest='gpio',
59         action='store_true',
60         help='generate script to read pad data from GPIO')
62 parser.add_argument('-c', '--check', dest='check_xml',
63         action='store_true',
64         help='check consistency of the XML files and other data')
66 args = parser.parse_args()
68 # Some more knobs for developers, Don't want to expose them to cmd line
69 args.resetslew = True
71 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
73 VERSION = "2.4"
75 if (args.part == "dra74x" or args.part == "dra75x"):
76         XML_PATH = "XMLFiles/DRA75x_DRA74x"
77         PART = "DRA75x_DRA74x"
78         PCT_VERSION = "v1.0.10"
79 elif (args.part == "dra72x"):
80         XML_PATH = "XMLFiles/DRA72x"
81         PART = "DRA72x"
82         PCT_VERSION = "v1.0.7"
84 pad_data_xml   = XML_PATH + "/CTRL_MODULE_CORE.xml"
85 iod_data_xml   = XML_PATH + "/IODELAYCONFIG.xml"
86 model_data_xml = XML_PATH + "/model_" + PART + "_SR" + args.revision + "_" + PCT_VERSION + ".xml"
87 modehelp_file  = XML_PATH + "/guidelines_SR" + args.revision + ".txt"
89 pad_file = "ctrl-core.dump"
90 sel_file = "selected-modes.txt"
92 print "iodelay-autogen.py - Python script to generate the IOdelay data."
93 print "v" + VERSION + " using PCT version " + PCT_VERSION
94 print "Parsing PCT data from " + model_data_xml + "..."
95 print ""
97 # Read the XML file database for pad and delay registers
98 pad_xml = ET.parse(pad_data_xml).getroot()
99 iod_xml = ET.parse(iod_data_xml).getroot()
100 model_xml = ET.parse(model_data_xml).getroot()
102 # Functions to parse the input files and build data structures
103 def read_guidelines(fname):
104         modehelp = {}
105         pattern = re.compile('([^\t.]+\w)\t+(.+)')
106         f = open(fname)
107         for line in f.readlines():
108                 list = re.match(pattern, line)
109                 if ( list == None):
110                         continue
111                 mode = list.groups(0)[0]
112                 info = list.groups(0)[1]
113                 modehelp[mode] = info
114                 if (args.debug >= 2):
115                         print "Help: Mode '%s' is used for '%s'" % (mode, info)
116         return modehelp
118 def read_selmodes(fname):
119         sel = {}
120         pattern = re.compile('(\w+)\W*,\W*(\w*)')
121         f = open(fname)
122         for line in f.readlines():
123                 list = re.match(pattern, line)
124                 if ( list == None):
125                         continue
126                 module = list.groups(0)[0]
127                 mode = list.groups(0)[1]
128                 sel[module] = mode
129                 if (args.debug >= 2):
130                         print "INFO: Select '%s' for '%s'" % (mode, module)
131         return sel
133 def read_pad_dump(file):
134         regmap = {}
135         pattern = re.compile('.*(0x[0-9A-F]+).*(0x[0-9A-F]+).*')
136         f = open(file, 'r')
137         for line in f:
138                 list = re.match(pattern, line)
139                 if ( list == None):
140                         continue
141                 addr = int(list.groups(0)[0], 16)
142                 val = int(list.groups(0)[1], 16)
143                 #print "PADXML: Addr = %08x Value = %08x" % (addr, val)
144                 regmap[addr] = val
145         return regmap
146 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
148 # Helper functions to parse XML nodes and get the desired data
149 # Hugely dependent on the XML format of the PCT files
150 # Uses XPath to search elements with queries and filters
151 # Parse the nodes to generate data in desired format
153 def xml_pad_get_name(offset):
154         padlist = pad_xml.findall("register[@offset='0x%X']" % offset)
155         if (len(padlist) == 0):
156                 return "Unknown"
157         else:
158                 return padlist[0].get("id")
160 def xml_pad_get_slew(offset):
161         padlist = pad_xml.findall("register[@offset='0x%X']" % offset)
162         if (len(padlist) == 0):
163                 return 0x0
164         else:
165                 bitlist = padlist[0].findall("bitfield[@begin='19']")
166                 if (len(bitlist) == 0):
167                         return 0x0
168                 else:
169                         return int(bitlist[0].get("resetval"), 16)
171 # For DRA72x SoC, for "ball compatibility" purpose, some signals have same muxmode.
172 # CTRL_CORE_ALT_SELECT_MUX register allows to select between one of the signals
173 # Its like a board mux has been added inside the SoC, except it uses same muxmode.
174 def resolve_group(muxmode_str):
175         mmlist = muxmode_str.split(" ")
176         mmlen = len(mmlist)
177         if (mmlen == 1):
178                 def_mode = mmlist[0]
179                 return mmlist[0]
180         elif (mmlen == 2):
181                 def_mode = mmlist[0]
182                 grp1_mode = mmlist[1]
183         elif (mmlen == 3):
184                 def_mode = mmlist[0]
185                 grp1_mode = mmlist[1]
186                 grp2_mode = mmlist[2]
187         else:
188                 print "ERR: Cannot resolve muxmode group for '%s'" % muxmode_str
190         #HACK for now
191         return def_mode
193 def xml_model_get_signal(offset, muxmode):
194         padlist = pad_xml.findall("register[@offset='0x%X']" % offset)
195         if (len(padlist) == 0):
196                 return "Unknown"
197         else:
198                 mux_field = padlist[0].findall("./bitfield[@end='0']")
199                 if (len(mux_field) == 0):
200                         return "Unknown"
201                 modes = mux_field[0].findall("./bitenum[@value='%d']" % muxmode)
202                 if (len(modes) == 0):
203                         return "Unknown"
204                 return resolve_group(modes[0].get("id"))
206 def xml_iodelay_get_reg(name):
207         delaylist = iod_xml.findall("register[@id='%s']" % name)
208         if (len(delaylist) == 0):
209                 return 0
210         else:
211                 offset = delaylist[0].get("offset")
212                 #print "IOD: Name = %s Offset = %s" % (del_reg, offset)
213                 return int(offset, 16)
215 def xml_get_virtual(mode):
216         vmodes = {}
217         signal = mode.findtext("signal")
218         for virt in mode.findall("virtualmode/mode"):
219                 virt_mode = virt.findtext("value")
220                 virt_name = virt.findtext("name")
221                 if (virt_name == "NA"):
222                         continue
223                 virt_mode = int(virt_mode)
224                 vmodes[virt_name] = virt_mode
225                 if (args.debug >= 1):
226                         print ("    * VIRTUAL: %s [%s] => delaymode = %d" % (signal, virt_name, virt_mode))
227         return vmodes
229 def xml_get_manual(mode):
230         mmodes = {}
231         signal = mode.findtext("signal")
232         for man in mode.findall("manualmode"):
233                 regname = man.findtext("cfgreg/name")
234                 for sel in man.findall("cfgreg/mode"):
235                         adel = sel.findtext("adelay")
236                         gdel = sel.findtext("gdelay")
237                         man_name = sel.findtext("name")
238                         if (man_name == "NA"):
239                                 continue
240                         adel = int(adel)
241                         gdel = int(gdel)
242                         if (man_name not in mmodes.keys()):
243                                 mmodes[man_name] = []
244                         mmodes[man_name].append((regname, adel, gdel))
245                         if (args.debug >= 1):
246                                 print ("    * MANUAL: %s [%s] => delay[%s] = %d, %d" % (signal, man_name, regname, adel, gdel))
247         return mmodes
249 def xml_find_delaymodes(pad_name, muxmode):
250         padlist = model_xml.findall("padDB/clockNode/type/pad")
251         for pad in padlist:
252                 if (pad_name == pad.findtext("confregisters/regbit/register")):
253                         muxmodes = pad.findall("muxmode")
254                         break
255         if not muxmodes:
256                 return None
257         for mode in muxmodes:
258                 if ("%d" % muxmode == mode.findtext("mode")):
259                         virt = xml_get_virtual(mode)
260                         man = xml_get_manual(mode)
261                         return (virt, man)
262         return None
264 def xml_check_correctness(modehelp):
265         if(args.check_xml == False):
266                 return
268         print "###########################################"
269         print "XML correctness checks:"
270         padcore_list = []
271         padmodel_list = []
272         modes = {}
274         # Fint all the pads in core XML
275         pad_list = pad_xml.findall("register")
276         for i in pad_list:
277                 name = i.get("id")
278                 if (re.match("CTRL_CORE_PAD_.*", name) == None):
279                         continue
280                 padcore_list.append(name)
281         print ">> Total pads defined in core XML = %d" % len(padcore_list)
283         # Find all the pads in model XML
284         pad_list = model_xml.findall("padDB/clockNode/type/pad/confregisters/regbit")
285         for i in pad_list:
286                 name = i.findtext("register")
287                 padmodel_list.append(name)
288         print ">> Total pads defined in model XML = %d" % len(padmodel_list)
290         # Find all the manual modes
291         manmode_list = model_xml.findall("padDB/clockNode/type/pad/muxmode/manualmode/cfgreg/mode")
292         for i in manmode_list:
293                 man_name = i.findtext("name")
294                 modes[man_name] = "manual"
295         # Find all the virtual modes
296         virtmode_list = model_xml.findall("padDB/clockNode/type/pad/muxmode/virtualmode/mode")
297         for i in virtmode_list:
298                 virt_name = i.findtext("name")
299                 modes[virt_name] = "virtual"
300         print ">> Total delaymodes defined in model XML = %d" % len(modes)
302         # Print out all the errors found in the tests
303         print "== Pads defined in core XML but not in model XML =="
304         for i in padcore_list:
305                 if (i not in padmodel_list):
306                         print "\t%s" % i
307         print "== Pads defined in model XML but not in core XML =="
308         for i in padmodel_list:
309                 if (i not in padcore_list):
310                         print "\t%s" % i
312         # Check if description for each mode is available
313         print "== Delaymodes missing description in the guidelines.txt =="
314         for i in modes:
315                 if (i not in modehelp):
316                         print "\t%s" % i
318         print "###########################################"
320 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
322 # Decision point of the script
323 # For each pad/pin, decide what delay method is used
324 # Lookup in the selection file or ask user with a menu
325 def select_mode(pad, pin, module, virt, man, modehelp, sel):
326         modelist = []
327         for modename in virt.keys():
328                 modelist.append(modename)
330         for modename in man.keys():
331                 modelist.append(modename)
333         if (len(modelist) == 0):
334                 return "LEGACY"
336         if (module in sel.keys()):
337                 mode = sel[module]
338                 if (mode == "SKIP" or mode == "LEGACY" or mode in modelist):
339                         return mode
340                 else:
341                         print("ERR: Invalid delaymode '%s' for module '%s'" % (mode, module))
343         if (args.interactive == 0):
344                 print "WARN: No delay modes for %s found, skipping" % module
345                 mode = "SKIP"
346                 return mode
348         # Display the menu and ask user to select the 'right' mode
349         while True:
350                 print ""
351                 print "MENU: Select delay mode for %s -> %s" % (pad, pin)
352                 i = 0
353                 print "MENU: %d: %s \t\t\t%s" % (i, "SKIP", "Skips this module for now")
354                 i = 1
355                 print "MENU: %d: %s \t\t%s" % (i, "LEGACY", "No external delay config (No virtual/manual needed)")
356                 for mode in modelist:
357                         i += 1
358                         if (mode in modehelp):
359                                 helptext = modehelp[mode]
360                         else:
361                                 helptext = "Unknown"
362                         print "MENU: %d: %s \t\t%s" % (i, mode, helptext)
363                 try:
364                         choice = int(raw_input("Select delay mode #> "))
365                         if (choice == 0):
366                                 mode = "SKIP"
367                                 break
368                         elif (choice == 1):
369                                 mode = "LEGACY"
370                                 break
371                         elif (choice >=2 and choice <= len(modelist) + 1):
372                                 mode = modelist[choice - 2]
373                                 break
374                         print "ERROR: Invalid choice"
375                 except ValueError:
376                         print "ERROR: Invalid choice"
377         print "MENU: Selected mode is %s" % mode
378         print ""
380         return mode
381 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
383 # Pad read using GPIO - Specific to linux only
384 # As each pad is muxed with a SoC gpio (for most of the pads)
385 # It's possible to read the pad data using gpio datain registers
386 # Dump the linux commands to read the gpio registers and read the pad data
387 def pad_dump_gpio(padconf, per_padconf):
388         print "###########################################"
389         print "# Read %s signals using GPIO DATA-IN registers" % args.module
390         print "# Works only for the input signals"
391         print "###########################################"
392         gpio_data_addrs = (0, 0x4ae10138, 0x48055138, 0x48057138, 0x48059138, 0x4805b138, 0x4805d138, 0x48051138, 0x48053138)
393         for i in padconf:
394                 (pad_name, pin_name, addr, val, mode, delayinfo) = i
396                 offset = addr - 0x4a002000
397                 gpio_name = xml_model_get_signal(offset, 14)
398                 matchlist = re.match("GPIO(.)_(.*)", gpio_name)
399                 if (matchlist == None):
400                         print "ERR: No GPIO for pad %s" % pad_name
401                         continue
403                 inst = int(matchlist.groups(0)[0])
404                 bit = int(matchlist.groups(0)[1])
405                 gpio_addr = gpio_data_addrs[inst]
407                 print "#Read GPIO%d_%d to sample %s" % (inst, bit, pin_name)
408                 print " echo %d > /sys/class/gpio/export 2>/dev/null;" % ((inst - 1) * 32)
409                 print " val=`omapconf read 0x%x 2>&1 | grep -v \"support\"`;" % gpio_addr
410                 print " status=$((0x$val >> %d & 0x1));" % bit
411                 print " echo -e \"%s (%s)\t = $status\";" % (pin_name, gpio_name)
412                 print ""
413         print ""
414 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
416 # Generate the final pad and delay data in the required format
417 def format_pad_regs(padconf, per_padconf):
418         print "###########################################"
419         print "Pad data output (with the delay modes)"
420         print "###########################################"
421         if (args.format == "uboot"):
422                 uboot_format_pad_regs(padconf, per_padconf)
423         elif (args.format == "linux"):
424                 linux_format_pad_regs(padconf, per_padconf)
425         elif (args.format == "bios"):
426                 bios_format_pad_regs(padconf, per_padconf)
427         else:
428                 print "ERR: Format %s not suppported" % args.format
430 def format_delay_regs(delayconf, per_delayconf):
431         print "#########################################"
432         print "Delay data output (for manual modes)"
433         print "#########################################"
434         if (args.format == "uboot"):
435                 uboot_format_delay_regs(delayconf, per_delayconf)
436         elif (args.format == "linux"):
437                 linux_format_delay_regs(delayconf, per_delayconf)
438         elif (args.format == "bios"):
439                 bios_format_delay_regs(delayconf, per_delayconf)
440         else:
441                 print "ERR: Format %s not suppported" % args.format
443 def get_pin_info(val):
444         slew_fast = (val >> 19) & 0x1
445         inp_en = (val >> 18) & 0x1
446         pulltype = (val >> 17) & 0x1
447         pull_dis = (val >> 16) & 0x1
448         pin = "PIN"
449         if (inp_en):
450                 pin += "_INPUT"
451         else:
452                 pin += "_OUTPUT"
453         if (pull_dis == 0):
454                 if (pulltype):
455                         pin += "_PULLUP"
456                 else:
457                         pin += "_PULLDOWN"
458         if (slew_fast):
459                 pin += " | SLEWCONTROL"
460         return pin
462 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
464 # Generate output in u-boot format
465 def uboot_format_pad_regs(padconf, per_padconf):
466         print "\nconst struct pad_conf_entry dra74x_core_padconf_array[] = {"
467         for i in padconf:
468                 (pad_name, pin_name, addr, val, mode, delayinfo) = i
470                 muxmode = val & 0xf
471                 (method, data) = delayinfo
472                 if (method == "LEGACY"):
473                         extramode = ""
474                 elif (method == "VIRTUAL"):
475                         delaymode = data
476                         extramode = " | VIRTUAL_MODE%d" % delaymode
477                 elif (method == "MANUAL"):
478                         extramode = " | MANUAL_MODE"
479                 else:
480                         print "ERR: Invalid method %s" % method
482                 pin_info = get_pin_info(val) + extramode
483                 pad_short = re.sub("CTRL_CORE_PAD_", "", pad_name)
484                 comment = (pad_short + "." + pin_name).lower()
486                 print "\t{ %s, (M%d | %s) },\t/* %s */" % (pad_short, muxmode, pin_info, comment)
487         print "};\n"
489 def uboot_format_delay_regs(delayconf, per_delayconf):
490         manual_del = []
491         for i in delayconf:
492                 (pad_name, pin_name, regname, del_offset, man_name, adel, gdel) = i
494                 entry = (del_offset, adel, gdel, regname, pin_name, man_name)
495                 manual_del.append(entry)
497         es_rev = args.revision.replace('.', '_')
498         print "\nconst struct iodelay_cfg_entry dra742_es" + es_rev + "_iodelay_cfg_array[] = {"
499         for entry in sorted(manual_del):
500                 print "\t{ 0x%04X, %5d, %5d },\t/* %s : %s - %s */" % entry
501         print "};\n"
503 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
505 # Generate output in linux format
506 def linux_format_pad_regs(padconf, per_padconf):
507         print "&dra7_pmx_core {"
508         for per in per_padconf:
510                 if (re.match("MMC.*", per) == None):
511                         print "WARN: Only MMC padconf is recommended in kernel"
513                 # Get the mode from the first entry
514                 (pad_name, pin_name, addr, val, mode, delayinfo) = per_padconf[per][0]
516                 dtsnode = ("%s_pins_%s" % (per, mode)).lower()
517                 print ""
518                 print "\t%s: %s {" % (dtsnode, dtsnode)
519                 print "\t\tpinctrl-single,pins = <"
520                 for i in per_padconf[per]:
521                         (pad_name, pin_name, addr, val, mode, delayinfo) = i
523                         muxmode = val & 0xf
524                         (method, data) = delayinfo
525                         if (method == "LEGACY"):
526                                 extramode = ""
527                         elif (method == "VIRTUAL"):
528                                 delaymode = data
529                                 extramode = " | MUX_VIRTUAL_MODE%d" % delaymode
530                         elif (method == "MANUAL"):
531                                 extramode = " | MANUAL_MODE"
532                         else:
533                                 print "ERR: Invalid method %s" % method
535                         pin_info = get_pin_info(val) + extramode
536                         pad_short = re.sub("CTRL_CORE_PAD_", "", pad_name)
537                         offset = addr - 0x4a003400
538                         comment = (pad_short + "." + pin_name).lower()
540                         print "\t\t\t0x%03X\t(%s | MUX_MODE%d)\t/* %s */" % (offset, pin_info, muxmode, comment)
541                 print "\t\t>;"
542                 print "\t};"
543         print "};\n"
546 def linux_format_delay_regs(delayconf, per_delayconf):
547         print "&dra7_iodelay_core {"
548         for per in per_delayconf.keys():
550                 if (re.match("MMC.*", per) == None):
551                         print "WARN: Only MMC delayconf is recommended in kernel"
553                 # Get the mode from the first entry
554                 (pad_name, pin_name, regname, del_offset, mode, adel, gdel) = per_delayconf[per][0]
556                 dtsnode = ("%s_iodelay_%s_conf" % (per, mode)).lower()
557                 print "\t%s: %s {" % (dtsnode, dtsnode)
558                 print "\t\tpinctrl-single,pins = <"
559                 for i in per_delayconf[per]:
560                         (pad_name, pin_name, regname, del_offset, mode, adel, gdel) = i
562                         print "\t\t\t0x%03X (A_DELAY(%d) | G_DELAY(%d))\t/* %s */" % (del_offset, adel, gdel, regname)
563                 print "\t\t>;"
564                 print "\t};"
565         print "};\n"
567 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
569 # Generate output in bios format
570 def bios_format_pad_regs(padconf, per_padconf):
571         for i in padconf:
572                 (pad_name, pin_name, addr, val, mode, delayinfo) = i
574                 delaylist = []
575                 (method, data) = delayinfo
576                 if (method == "VIRTUAL"):
577                         virt_mode = data
578                         val = val | ( virt_mode<< 4)
579                         val = val | (1 << 8)
580                 elif (method == "MANUAL"):
581                         delaylist = data
582                         val = val | (1 << 8)
584                 offset = addr - 0x4a003400
585                 out_delreg = out_adel = out_gdel = 0
586                 in_delreg  = in_adel  = in_gdel  = 0
587                 oen_delreg = oen_adel = oen_gdel = 0
589                 for j in delaylist:
590                         (regname, adel, gdel) = j
591                         if (re.match(".*_IN", regname) != None):
592                                 in_delreg = xml_iodelay_get_reg(regname)
593                                 in_adel = adel
594                                 in_gdel = gdel
595                         elif (re.match(".*_OEN", regname) != None):
596                                 oen_delreg = xml_iodelay_get_reg(regname)
597                                 oen_adel = adel
598                                 oen_gdel = gdel
599                         elif (re.match(".*_OUT", regname) != None):
600                                 out_delreg = xml_iodelay_get_reg(regname)
601                                 out_adel = adel
602                                 out_gdel = gdel
603                 indel  = "{ 0x%04X, %4d, %4d }" % (in_delreg,  in_adel,  in_gdel)
604                 oendel = "{ 0x%04X, %4d, %4d }" % (oen_delreg, oen_adel, oen_gdel)
605                 outdel = "{ 0x%04X, %4d, %4d }" % (out_delreg, out_adel, out_gdel)
606                 pin_info = get_pin_info(val)
607                 print "\t/* %s -> %s (%s) %s delaymode */" % (pad_name, pin_name, pin_info, method)
608                 print "\t{ 0x%03X, 0x%08X, %s, %s, %s }" % (offset, val, indel, oendel, outdel)
610 def bios_format_delay_regs(delayconf, per_delayconf):
611         print "Manual delays are not configured separately"
612         print "Delays are configured as part of the padconf step only"
614 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
616 # Main execution starts here
617 # * Parse all the XML files - Get the pad data and IOdelay data
618 # * Iterate over the pad register dumps
619 # * For each pad, find out the muxmode being used and the pad direction, etc
620 # * For the muxmode being used, find out available virtual/modes
621 #   - Dump the virtual/manual modes available (based on options)
622 #   - Build up the gpio script to read the pad data using GPIO module
623 # * Select the correct mode to be used
624 #   - Check if the mode is described for the peripheral module, (from selected-modes.txt)
625 #   - Otherwise ask the user (with a menu) to decide the delaymode
626 #     => Update the selection for the whole of the peripheral module
627 #   - Worst case, skip the delaymode for this pad
628 # * Build the pad and delay register information
629 # * Create the dump for pad and delay data in linux/u-boot format
630 # * Dump the delaymode selection for each peripheral
631 # * Dump the GPIO script for each peripheral (all pads grouped together)
634 # Read all the input files and parse the required info
635 modehelp = read_guidelines(modehelp_file)
636 sel = read_selmodes(sel_file)
637 regmap = read_pad_dump(pad_file)
638 reglist = regmap.keys()
640 # List of all the pads being configured
641 padconf = []
642 # List of all the delay registers being configured (for manual mode)
643 delayconf = []
644 # Dictionary of pads grouped by peripheral/module
645 per_padconf = {}
646 # Dictionary of delay registers grouped by peripheral/module
647 per_delayconf = {}
649 xml_check_correctness(modehelp)
651 # Start iterating over each pad
652 for i in range(0, 260):
653         # Find out the muxmode and pad direction, etc
654         addr = 0x4a003400 + i * 4
655         offset = 0x1400 + i * 4
656         dts_offset = offset - 0x1400
658         if (addr not in reglist):
659                 print "WARN: Register dump for pad 0x%X not found" % addr
660                 continue
661         val = regmap[addr]
662         muxmode = val & 0xf
664         # Find out the pin based on the muxmode
665         pad_name = xml_pad_get_name(offset)
666         pin_name = xml_model_get_signal(offset, muxmode)
667         if (pad_name == "Unknown" or pin_name == "Unknown"):
668                 print "WARN: Cannot find out Pad/Pin name for PAD address 0x%X (%s[%s] = %s)" \
669                 % (addr, pad_name, muxmode, pin_name)
670                 continue
671         if (pin_name == "DRIVER"):
672                 continue
674         # Find out if the delaymode for this module is already selected
675         module = re.match("([^_]+)_.*", pin_name).groups(0)[0]
677         if (args.module != "" and re.match("%s" % args.module, module) == None):
678                 continue
680         # It is recommended to keep the reset value of the slewcontrol bit
681         # Find out the reset value from XML and update if required
682         if (args.resetslew):
683                 val |= (xml_pad_get_slew(offset) & 0x1) << 19
685         if (args.debug >= 1):
686                 print "\nPAD: %s: Addr= 0x%08X Value = 0x%08X \"%s\"" \
687                 % (pad_name, addr, val, pin_name)
689         # Find out all the possible virtual, manual modes fot the specific pad -> pin combination
690         (virt, man) = xml_find_delaymodes(pad_name, muxmode)
692         if (args.gpio == True):
693                 mode = "LEGACY"
694         else:
695                 # Need to select one out of allowed modes
696                 mode = select_mode(pad_name, pin_name, module, virt, man, modehelp, sel)
698         # Remember the selection for that module, for later reuse
699         if (args.strict == False and module not in sel.keys()):
700                 sel[module] = mode
702         if (mode == "SKIP"):
703                 continue
704         elif (mode == "LEGACY"):
705                 delayinfo = ("LEGACY", "")
706         elif (mode in virt):
707                 delayinfo = ("VIRTUAL", virt[mode])
708         elif (mode in man):
709                 delayinfo = ("MANUAL", man[mode])
710         else:
711                 print "ERR: Unknown mode '%s' selected" % mode
712                 continue
714         if (args.debug >= 1):
715                 print "  => Using mode %s" % mode
716         paddata = (pad_name, pin_name, addr, val, mode, delayinfo)
717         if (module not in per_padconf.keys()):
718                 per_padconf[module] = []
719         padconf.append(paddata)
720         per_padconf[module].append(paddata)
722         if(mode not in man):
723                 continue
725         # Add the delay data if using manual mode
726         for regval in man[mode]:
727                 (regname, adel, gdel) = regval
728                 del_offset = xml_iodelay_get_reg(regname)
729                 if (del_offset == 0):
730                         print "WARN: Can't find delay offset of register %s" % regname
731                         break
732                 if (args.debug >= 1):
733                         print "  => Manual delay[%s] = (%d, %d)" % (regname, adel, gdel)
734                 delaydata = (pad_name, pin_name, regname, del_offset, mode, adel, gdel)
735                 if (module not in per_delayconf.keys()):
736                         per_delayconf[module] = []
737                 delayconf.append(delaydata)
738                 per_delayconf[module].append(delaydata)
740 print ""
741 print "Total PAD registers: %d" % len(padconf)
742 print "Total DELAY registers: %d" % len(delayconf)
743 print ""
745 if(args.gpio == True):
746         pad_dump_gpio(padconf, per_padconf)
747         exit()
749 format_pad_regs(padconf, per_padconf)
750 format_delay_regs(delayconf, per_delayconf)
752 # Dump the final selection for reuse
753 print "Selected modes for each peripheral module\n"
754 for group in sel:
755         print "%s,\t%s" % (group, sel[group])
756 print ""
757 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #