]> Gitweb @ Texas Instruments - Open Source Git Repositories - git.TI.com/gitweb - glsdk/iodelay-config.git/blobdiff - iodelay-autogen.py
script: Add checks for unsupported Si revisions
[glsdk/iodelay-config.git] / iodelay-autogen.py
index 21bec3a993b386739d1da39e56fe3b36ba24b52b..677f68de8f72786ee24cec1761bc8ba80df94649 100755 (executable)
@@ -25,30 +25,30 @@ parser = argparse.ArgumentParser(prog='iodelay-autogen.py',
        epilog='Generate the pad and delay data using pad register dumps. For this,\n' \
                'Run omapconf dump 0x4a003400 0x4a00380c and save the output')
 
-parser.add_argument('-d', '--debug', dest='debug',
-       action='store', type=int, choices=[0, 1, 2], default=0,
-       help='set the debug level')
-
-parser.add_argument('-i', '--interactive', dest='interactive',
-       action='store', type=int, choices=[0, 1], default=1,
-       help='run interactively with menus for resolving conflicts')
-
-parser.add_argument('-f', '--format', dest='format',
-       action='store', type=str, choices=["linux", "uboot", "bios"], default="uboot",
-       help='select the output format to be used')
+parser.add_argument('-p', '--part', dest='part',
+       action='store', type=str, choices=["dra74x", "dra75x", "dra72x"], default="dra74x",
+       help='select the device part')
 
 parser.add_argument('-r', '--revision', dest='revision',
        action='store', type=str, choices=["1.0", "1.1", "2.0"], default="1.1",
        help='select the silicon revision')
 
-parser.add_argument('-p', '--part', dest='part',
-       action='store', type=str, choices=["dra74x", "dra75x", "dra72x"], default="dra74x",
-       help='select the device part')
-
 parser.add_argument('-m', '--module', dest='module',
        action='store', type=str, default="",
        help='generate only for modules matching the provided RE')
 
+parser.add_argument('-f', '--format', dest='format',
+       action='store', type=str, choices=["linux", "uboot", "bios"], default="uboot",
+       help='select the output format to be used')
+
+parser.add_argument('-d', '--debug', dest='debug',
+       action='store', type=int, choices=[0, 1, 2, 3, 4], default=0,
+       help='set the debug level - ERR,WARN,INFO,DBG,VERBOSE')
+
+parser.add_argument('-i', '--interactive', dest='interactive',
+       action='store', type=int, choices=[0, 1], default=1,
+       help='run interactively with menus for resolving conflicts')
+
 parser.add_argument('-s', '--strict', dest='strict',
        action='store_true',
        help='strict mode - ask for each pad of the group, do not save selection.\n' \
@@ -57,7 +57,7 @@ parser.add_argument('-s', '--strict', dest='strict',
 
 parser.add_argument('-g', '--gpio', dest='gpio',
        action='store_true',
-       help='generate script to read pad data from GPIO')
+       help='generate script to probe signals using gpio')
 
 parser.add_argument('-c', '--check', dest='check_xml',
        action='store_true',
@@ -70,29 +70,49 @@ args.resetslew = True
 
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 
-VERSION = "2.4"
+VERSION = "2.5"
 
 if (args.part == "dra74x" or args.part == "dra75x"):
+       if (args.revision == "1.0"):
+               args.revision = "1.1"
        XML_PATH = "XMLFiles/DRA75x_DRA74x"
        PART = "DRA75x_DRA74x"
        PCT_VERSION = "v1.0.10"
 elif (args.part == "dra72x"):
+       if (args.revision == "1.1"):
+               print "dra72x doesn't have silicon revision 1.1"
+               exit()
        XML_PATH = "XMLFiles/DRA72x"
        PART = "DRA72x"
-       PCT_VERSION = "v1.0.6"
+       PCT_VERSION = "v1.0.7"
 
 pad_data_xml   = XML_PATH + "/CTRL_MODULE_CORE.xml"
 iod_data_xml   = XML_PATH + "/IODELAYCONFIG.xml"
 model_data_xml = XML_PATH + "/model_" + PART + "_SR" + args.revision + "_" + PCT_VERSION + ".xml"
-modehelp_file  = XML_PATH + "/guidelines.txt"
+modehelp_file  = XML_PATH + "/guidelines_SR" + args.revision + ".txt"
 
 pad_file = "ctrl-core.dump"
 sel_file = "selected-modes.txt"
 
-print "iodelay-autogen.py - Python script to generate the IOdelay data."
-print "v" + VERSION + " using PCT version " + PCT_VERSION
-print "Parsing PCT data from " + model_data_xml + "..."
-print ""
+def trace(level, msg):
+       if (args.debug >= level):
+               print(msg)
+def verbose(msg):
+       trace(4, "DEBUG: " + msg)
+def debug(msg, args=None):
+       trace(3, "DEBUG: " + msg)
+def info(msg):
+       trace(2, "INFO: " + msg)
+def warn(msg):
+       trace(1, "WARN: " + msg)
+def error(msg):
+       trace(0, "ERR: " + msg)
+
+if (args.interactive):
+       print "iodelay-autogen.py - Python script to generate the IOdelay data."
+       print "v" + VERSION + " using PCT version " + PCT_VERSION
+       print "Parsing PCT data from " + model_data_xml + "..."
+       print ""
 
 # Read the XML file database for pad and delay registers
 pad_xml = ET.parse(pad_data_xml).getroot()
@@ -111,8 +131,7 @@ def read_guidelines(fname):
                mode = list.groups(0)[0]
                info = list.groups(0)[1]
                modehelp[mode] = info
-               if (args.debug >= 2):
-                       print "Help: Mode '%s' is used for '%s'" % (mode, info)
+               verbose("Guideline: Mode '%30s' => '%s'" % (mode, info))
        return modehelp
 
 def read_selmodes(fname):
@@ -126,8 +145,7 @@ def read_selmodes(fname):
                module = list.groups(0)[0]
                mode = list.groups(0)[1]
                sel[module] = mode
-               if (args.debug >= 2):
-                       print "INFO: Select '%s' for '%s'" % (mode, module)
+               verbose("Input modes: Select '%s' => '%s'" % (mode, module))
        return sel
 
 def read_pad_dump(file):
@@ -140,7 +158,7 @@ def read_pad_dump(file):
                        continue
                addr = int(list.groups(0)[0], 16)
                val = int(list.groups(0)[1], 16)
-               #print "PADXML: Addr = %08x Value = %08x" % (addr, val)
+               verbose("XML pad-reg: Addr = %08x Value = %08x" % (addr, val))
                regmap[addr] = val
        return regmap
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -168,7 +186,30 @@ def xml_pad_get_slew(offset):
                else:
                        return int(bitlist[0].get("resetval"), 16)
 
-def xml_pad_get_pin(offset, muxmode):
+# For DRA72x SoC, for "ball compatibility" purpose, some signals have same muxmode.
+# CTRL_CORE_ALT_SELECT_MUX register allows to select between one of the signals
+# Its like a board mux has been added inside the SoC, except it uses same muxmode.
+def resolve_group(muxmode_str):
+       mmlist = muxmode_str.split(" ")
+       mmlen = len(mmlist)
+       if (mmlen == 1):
+               def_mode = mmlist[0]
+               return mmlist[0]
+       elif (mmlen == 2):
+               def_mode = mmlist[0]
+               grp1_mode = mmlist[1]
+       elif (mmlen == 3):
+               def_mode = mmlist[0]
+               grp1_mode = mmlist[1]
+               grp2_mode = mmlist[2]
+       else:
+               error("Cannot resolve muxmode group for '%s'" % muxmode_str)
+
+       #HACK for now
+       warn("Not resolving muxmode %s, assuming default %s" % (muxmode_str, def_mode))
+       return def_mode
+
+def xml_model_get_signal(offset, muxmode):
        padlist = pad_xml.findall("register[@offset='0x%X']" % offset)
        if (len(padlist) == 0):
                return "Unknown"
@@ -179,7 +220,7 @@ def xml_pad_get_pin(offset, muxmode):
                modes = mux_field[0].findall("./bitenum[@value='%d']" % muxmode)
                if (len(modes) == 0):
                        return "Unknown"
-               return modes[0].get("id")
+               return resolve_group(modes[0].get("id"))
 
 def xml_iodelay_get_reg(name):
        delaylist = iod_xml.findall("register[@id='%s']" % name)
@@ -187,7 +228,7 @@ def xml_iodelay_get_reg(name):
                return 0
        else:
                offset = delaylist[0].get("offset")
-               #print "IOD: Name = %s Offset = %s" % (del_reg, offset)
+               verbose("XML delay-reg: Name = %s Offset = %s" % (name, offset))
                return int(offset, 16)
 
 def xml_get_virtual(mode):
@@ -200,8 +241,7 @@ def xml_get_virtual(mode):
                        continue
                virt_mode = int(virt_mode)
                vmodes[virt_name] = virt_mode
-               if (args.debug >= 1):
-                       print ("    * VIRTUAL: %s [%s] => delaymode = %d" % (signal, virt_name, virt_mode))
+               debug("    * VIRTUAL: %s [%s] => delaymode = %d" % (signal, virt_name, virt_mode))
        return vmodes
 
 def xml_get_manual(mode):
@@ -220,8 +260,7 @@ def xml_get_manual(mode):
                        if (man_name not in mmodes.keys()):
                                mmodes[man_name] = []
                        mmodes[man_name].append((regname, adel, gdel))
-                       if (args.debug >= 1):
-                               print ("    * MANUAL: %s [%s] => delay[%s] = %d, %d" % (signal, man_name, regname, adel, gdel))
+                       debug("    * MANUAL: %s [%s] => delay[%s] = %d, %d" % (signal, man_name, regname, adel, gdel))
        return mmodes
 
 def xml_find_delaymodes(pad_name, muxmode):
@@ -240,8 +279,6 @@ def xml_find_delaymodes(pad_name, muxmode):
        return None
 
 def xml_check_correctness(modehelp):
-       if(args.check_xml == False):
-               return
 
        print "###########################################"
        print "XML correctness checks:"
@@ -249,7 +286,7 @@ def xml_check_correctness(modehelp):
        padmodel_list = []
        modes = {}
 
-       # Fint all the pads in core XML
+       # Find all the pads in core XML
        pad_list = pad_xml.findall("register")
        for i in pad_list:
                name = i.get("id")
@@ -293,6 +330,12 @@ def xml_check_correctness(modehelp):
                if (i not in modehelp):
                        print "\t%s" % i
 
+       # Check if description for unknown mode is documented
+       print "== Delaymodes unused from guidelines.txt =="
+       for i in modehelp:
+               if (i not in modes):
+                       print "\t%s" % i
+
        print "###########################################"
 
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
@@ -316,10 +359,10 @@ def select_mode(pad, pin, module, virt, man, modehelp, sel):
                if (mode == "SKIP" or mode == "LEGACY" or mode in modelist):
                        return mode
                else:
-                       print("ERR: Invalid delaymode '%s' for module '%s'" % (mode, module))
+                       error("Invalid delaymode '%s' for module '%s'" % (mode, module))
 
        if (args.interactive == 0):
-               print "WARN: No delay modes for %s found, skipping" % module
+               warn("No delay modes for %s found, skipping" % module)
                mode = "SKIP"
                return mode
 
@@ -361,42 +404,81 @@ def select_mode(pad, pin, module, virt, man, modehelp, sel):
 # Pad read using GPIO - Specific to linux only
 # As each pad is muxed with a SoC gpio (for most of the pads)
 # It's possible to read the pad data using gpio datain registers
-# Dump the linux commands to read the gpio registers and read the pad data
+# Change pad register to enable input path and export sysfs
+# Use sysfs to read the status of GPIO and print in a loop
 def pad_dump_gpio(padconf, per_padconf):
-       if(args.gpio == False):
-               return
-
-       print "# Read pad signals using GPIO DATA-IN registers"
-       print "# Works only for the input signals"
        gpio_data_addrs = (0, 0x4ae10138, 0x48055138, 0x48057138, 0x48059138, 0x4805b138, 0x4805d138, 0x48051138, 0x48053138)
+       module = args.module
+
+       # script header
+       gen_header = "###########################################\n" + \
+                    "# Read %s signals using GPIO sysfs\n" % module + \
+                    "###########################################\n\n"
+       gen_data = "%s_data=(\n" % module
+
        for i in padconf:
                (pad_name, pin_name, addr, val, mode, delayinfo) = i
 
                offset = addr - 0x4a002000
-               gpio_name = xml_pad_get_pin(offset, 14)
+               gpio_name = xml_model_get_signal(offset, 14)
                matchlist = re.match("GPIO(.)_(.*)", gpio_name)
                if (matchlist == None):
-                       print "ERR: No GPIO for pad %s" % pad_name
+                       error("No GPIO for pad %s - cannot read from script" % pad_name)
                        continue
 
                inst = int(matchlist.groups(0)[0])
                bit = int(matchlist.groups(0)[1])
                gpio_addr = gpio_data_addrs[inst]
+               ngpio = (inst - 1) * 32 + bit
+               pin_short = re.match(".+_(.*)", pin_name).groups(0)[0]
+
+               gen_data += "\t%s:0x%x:%s:%d:0x%x:%d\n" % (pin_short, addr, gpio_name, ngpio, gpio_addr, bit)
+
+       gen_data += ")\n\n"
+
+       # Main script to probe the signal
+       gen_main = "echo; echo Probing %s signals\n\n" % module + \
+                  "for data in ${%s_data[@]}\n" % module + \
+                  "do\n" + \
+                  "    pin=`echo $data | cut -d ':' -f1`\n" + \
+                  "    pad=`echo $data | cut -d ':' -f2`\n" + \
+                  "    ngpio=`echo $data | cut -d ':' -f4`\n" + \
+                  "    echo $ngpio > /sys/class/gpio/export 2>/dev/null\n" + \
+                  "    omapconf set bit $pad 18 1>/dev/null 2>/dev/null\n" + \
+                  "    printf \"%8s\" $pin\n" + \
+                  "done\n" + \
+                  "echo\n\n"
+
+       gen_main += "while true;\n" + \
+                   "do\n" + \
+                   "    for data in ${%s_data[@]}\n" % module + \
+                   "    do\n" + \
+                   "#       pin=`echo $data | cut -d ':' -f1`\n" + \
+                   "#        pad=`echo $data | cut -d ':' -f2`\n" + \
+                   "#       gpio=`echo $data | cut -d ':' -f3`\n" + \
+                   "        ngpio=`echo $data | cut -d ':' -f4`\n" + \
+                   "#       addr=`echo $data | cut -d ':' -f5`\n" + \
+                   "#       bit=`echo $data | cut -d ':' -f6`\n" + \
+                   "        val=`cat /sys/class/gpio/gpio$ngpio/value`\n" + \
+                   "        printf %8d $val \n" + \
+                   "    done\n" + \
+                   "    echo\n" + \
+                   "done\n\n"
+
+       gen_footer = "###########################################\n"
+
+       # Generate the shell script
+       gen_script = gen_header + gen_data + gen_main + gen_footer
+       filename = ("./%s-probe.sh" % module).lower()
+       print "Generating '%s' script..." % filename
+       gen_file = open(filename, "w+")
+       gen_file.write(gen_script)
 
-               print "#Read GPIO%d_%d to sample %s" % (inst, bit, pin_name)
-               print " echo %d > /sys/class/gpio/export 2>/dev/null;" % ((inst - 1) * 32)
-               print " val=`omapconf read 0x%x 2>&1 | grep -v \"support\"`;" % gpio_addr
-               print " status=$((0x$val >> %d & 0x1));" % bit
-               print " echo -e \"%s (%s)\t = $status\";" % (pin_name, gpio_name)
-               print ""
-       print ""
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 
 # Generate the final pad and delay data in the required format
 def format_pad_regs(padconf, per_padconf):
-       print "###########################################"
-       print "Pad data output (with the delay modes)"
-       print "###########################################"
+       print "######## Pad data output ########"
        if (args.format == "uboot"):
                uboot_format_pad_regs(padconf, per_padconf)
        elif (args.format == "linux"):
@@ -404,12 +486,10 @@ def format_pad_regs(padconf, per_padconf):
        elif (args.format == "bios"):
                bios_format_pad_regs(padconf, per_padconf)
        else:
-               print "ERR: Format %s not suppported" % args.format
+               error("Format %s not suppported" % args.format)
 
 def format_delay_regs(delayconf, per_delayconf):
-       print "#########################################"
-       print "Delay data output (for manual modes)"
-       print "#########################################"
+       print "######## Delay data output ########"
        if (args.format == "uboot"):
                uboot_format_delay_regs(delayconf, per_delayconf)
        elif (args.format == "linux"):
@@ -417,7 +497,7 @@ def format_delay_regs(delayconf, per_delayconf):
        elif (args.format == "bios"):
                bios_format_delay_regs(delayconf, per_delayconf)
        else:
-               print "ERR: Format %s not suppported" % args.format
+               error("Format %s not suppported" % args.format)
 
 def get_pin_info(val):
        slew_fast = (val >> 19) & 0x1
@@ -456,7 +536,7 @@ def uboot_format_pad_regs(padconf, per_padconf):
                elif (method == "MANUAL"):
                        extramode = " | MANUAL_MODE"
                else:
-                       print "ERR: Invalid method %s" % method
+                       error("Invalid delay method %s" % method)
 
                pin_info = get_pin_info(val) + extramode
                pad_short = re.sub("CTRL_CORE_PAD_", "", pad_name)
@@ -487,7 +567,7 @@ def linux_format_pad_regs(padconf, per_padconf):
        for per in per_padconf:
 
                if (re.match("MMC.*", per) == None):
-                       print "WARN: Only MMC padconf is recommended in kernel"
+                       warn("Only MMC padconf is recommended in kernel")
 
                # Get the mode from the first entry
                (pad_name, pin_name, addr, val, mode, delayinfo) = per_padconf[per][0]
@@ -509,7 +589,7 @@ def linux_format_pad_regs(padconf, per_padconf):
                        elif (method == "MANUAL"):
                                extramode = " | MANUAL_MODE"
                        else:
-                               print "ERR: Invalid method %s" % method
+                               warn("Invalid method %s" % method)
 
                        pin_info = get_pin_info(val) + extramode
                        pad_short = re.sub("CTRL_CORE_PAD_", "", pad_name)
@@ -527,7 +607,7 @@ def linux_format_delay_regs(delayconf, per_delayconf):
        for per in per_delayconf.keys():
 
                if (re.match("MMC.*", per) == None):
-                       print "WARN: Only MMC delayconf is recommended in kernel"
+                       warn("Only MMC delayconf is recommended in kernel")
 
                # Get the mode from the first entry
                (pad_name, pin_name, regname, del_offset, mode, adel, gdel) = per_delayconf[per][0]
@@ -587,8 +667,8 @@ def bios_format_pad_regs(padconf, per_padconf):
                print "\t{ 0x%03X, 0x%08X, %s, %s, %s }" % (offset, val, indel, oendel, outdel)
 
 def bios_format_delay_regs(delayconf, per_delayconf):
-       print "Manual delays are not configured separately"
-       print "Delays are configured as part of the padconf step only"
+       debug("Manual delays are not configured separately")
+       debug("Delays are configured as part of the padconf step only")
 
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 
@@ -625,7 +705,9 @@ per_padconf = {}
 # Dictionary of delay registers grouped by peripheral/module
 per_delayconf = {}
 
-xml_check_correctness(modehelp)
+if(args.check_xml):
+       xml_check_correctness(modehelp)
+       exit()
 
 # Start iterating over each pad
 for i in range(0, 260):
@@ -635,23 +717,27 @@ for i in range(0, 260):
        dts_offset = offset - 0x1400
 
        if (addr not in reglist):
-               print "WARN: Register dump for pad 0x%X not found" % addr
+               warn("Register dump for pad 0x%X not found" % addr)
                continue
        val = regmap[addr]
        muxmode = val & 0xf
 
        # Find out the pin based on the muxmode
        pad_name = xml_pad_get_name(offset)
-       pin_name = xml_pad_get_pin(offset, muxmode)
+       pin_name = xml_model_get_signal(offset, muxmode)
        if (pad_name == "Unknown" or pin_name == "Unknown"):
-               print "WARN: Cannot find out Pad/Pin name for PAD address 0x%X (%s[%s] = %s)" \
-               % (addr, pad_name, muxmode, pin_name)
+               warn("Cannot find out Pad/Pin name for PAD address 0x%X (%s[%s] = %s)" \
+               % (addr, pad_name, muxmode, pin_name))
                continue
-       if (pin_name == "DRIVER OFF"):
+       if (pin_name == "DRIVER"):
                continue
 
        # Find out if the delaymode for this module is already selected
-       module = re.match("([^_]+)_.*", pin_name).groups(0)[0]
+       match = re.match("([^_]+)_.*", pin_name)
+       if (match):
+               module = match.groups(0)[0]
+       else:
+               module = pin_name
 
        if (args.module != "" and re.match("%s" % args.module, module) == None):
                continue
@@ -661,15 +747,17 @@ for i in range(0, 260):
        if (args.resetslew):
                val |= (xml_pad_get_slew(offset) & 0x1) << 19
 
-       if (args.debug >= 1):
-               print "\nPAD: %s: Addr= 0x%08X Value = 0x%08X \"%s\"" \
-               % (pad_name, addr, val, pin_name)
+       debug("\nPAD: %s: Addr= 0x%08X Value = 0x%08X \"%s\"" \
+               % (pad_name, addr, val, pin_name))
 
        # Find out all the possible virtual, manual modes fot the specific pad -> pin combination
        (virt, man) = xml_find_delaymodes(pad_name, muxmode)
 
-       # Need to select one out of allowed modes
-       mode = select_mode(pad_name, pin_name, module, virt, man, modehelp, sel)
+       if (args.gpio == True):
+               mode = "LEGACY"
+       else:
+               # Need to select one out of allowed modes
+               mode = select_mode(pad_name, pin_name, module, virt, man, modehelp, sel)
 
        # Remember the selection for that module, for later reuse
        if (args.strict == False and module not in sel.keys()):
@@ -684,11 +772,10 @@ for i in range(0, 260):
        elif (mode in man):
                delayinfo = ("MANUAL", man[mode])
        else:
-               print "ERR: Unknown mode '%s' selected" % mode
+               error("Unknown mode '%s' selected" % mode)
                continue
 
-       if (args.debug >= 1):
-               print "  => Using mode %s" % mode
+       debug("  => Using mode %s" % mode)
        paddata = (pad_name, pin_name, addr, val, mode, delayinfo)
        if (module not in per_padconf.keys()):
                per_padconf[module] = []
@@ -703,28 +790,31 @@ for i in range(0, 260):
                (regname, adel, gdel) = regval
                del_offset = xml_iodelay_get_reg(regname)
                if (del_offset == 0):
-                       print "WARN: Can't find delay offset of register %s" % regname
+                       error("Can't find delay offset of register %s" % regname)
                        break
-               if (args.debug >= 1):
-                       print "  => Manual delay[%s] = (%d, %d)" % (regname, adel, gdel)
+               debug("  => Manual delay[%s] = (%d, %d)" % (regname, adel, gdel))
                delaydata = (pad_name, pin_name, regname, del_offset, mode, adel, gdel)
                if (module not in per_delayconf.keys()):
                        per_delayconf[module] = []
                delayconf.append(delaydata)
                per_delayconf[module].append(delaydata)
 
-print ""
-print "Total PAD registers: %d" % len(padconf)
-print "Total DELAY registers: %d" % len(delayconf)
-print ""
+if(args.gpio == True):
+       pad_dump_gpio(padconf, per_padconf)
+       exit()
 
 format_pad_regs(padconf, per_padconf)
 format_delay_regs(delayconf, per_delayconf)
-pad_dump_gpio(padconf, per_padconf)
 
-# Dump the final selection for reuse
-print "Selected modes for each peripheral module\n"
-for group in sel:
-       print "%s,\t%s" % (group, sel[group])
-print ""
+if (args.interactive):
+       # Summary of the generated data
+       print ""
+       print "Total PAD registers: %d" % len(padconf)
+       print "Total DELAY registers: %d" % len(delayconf)
+       print ""
+       # Dump the final selection for reuse
+       print "Selected modes for each peripheral module\n"
+       for group in sel:
+               print "%s,\t%s" % (group, sel[group])
+       print ""
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #