siliconcompiler 0.29.2__tar.gz → 0.29.4__tar.gz

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/Changes

@@ -8,6 +8,40 @@ The changes in each SiliconCompiler release version are described below. Commit
 version shown in (). Where applicable, the contributors that suggested a given
 feature are shown in [].
 
+SiliconCompiler 0.29.4 (2025-02-06)
+=========================================
+
+**Minor:**
+
+ * Added helper function to allow tasks to handle clock information in a uniform method.
+ * Improved feedback on unsupported platforms during `sc-install`.
+
+
+ * Tools:
+
+  * bambu: updates to better handle platform and clock information.
+  * openroad: added recover_power option support.
+  * yosys: switch to use builtin `keep_hierarchy` to speedup compile times.
+
+
+SiliconCompiler 0.29.3 (2025-01-28)
+=========================================
+
+**Major:**
+
+ * Added color support to logger to allow for easier identification of warnings and errors.
+
+**Minor:**
+
+ * Corrected install scripts for surelog and bambu.
+ * Fixed task setup order to avoid setting up tasks before the input nodes have been setup.
+
+ * Tools:
+
+  * slang: added elaboration task.
+  * yosys: added controls for separator used during flattening via `['tool', 'yosys', 'task', 'syn_asic', 'var', 'hierarchy_separator']`.
+
+
 SiliconCompiler 0.29.2 (2025-01-16)
 =========================================
 

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: siliconcompiler
-Version: 0.29.2
+Version: 0.29.4
 Summary: A compiler framework that automates translation from source code to silicon.
 Author-email: Andreas Olofsson <andreas.d.olofsson@gmail.com>
 License: Apache License 2.0
@@ -38,7 +38,7 @@ Requires-Dist: psutil>=5.8.0
 Requires-Dist: Pillow==10.4.0; python_version <= "3.8"
 Requires-Dist: Pillow==11.1.0; python_version >= "3.9"
 Requires-Dist: GitPython==3.1.44
-Requires-Dist: lambdapdk>=0.1.44
+Requires-Dist: lambdapdk>=0.1.47
 Requires-Dist: PyGithub==2.5.0
 Requires-Dist: urllib3>=1.26.0
 Requires-Dist: fasteners==0.19
@@ -46,7 +46,7 @@ Requires-Dist: fastjsonschema==2.21.1
 Requires-Dist: docker==7.1.0
 Requires-Dist: importlib_metadata; python_version < "3.10"
 Requires-Dist: sc-surelog==1.84.1
-Requires-Dist: orjson==3.10.14
+Requires-Dist: orjson==3.10.15
 Requires-Dist: streamlit==1.40.1; python_version <= "3.8"
 Requires-Dist: streamlit==1.41.1; python_version >= "3.9" and python_full_version != "3.9.7"
 Requires-Dist: streamlit_agraph==0.0.45; python_full_version != "3.9.7"
@@ -58,15 +58,15 @@ Requires-Dist: pytest==8.3.4; extra == "test"
 Requires-Dist: pytest-xdist==3.6.1; extra == "test"
 Requires-Dist: pytest-timeout==2.3.1; extra == "test"
 Requires-Dist: pytest-asyncio==0.24.0; python_version <= "3.8" and extra == "test"
-Requires-Dist: pytest-asyncio==0.25.2; python_version >= "3.9" and extra == "test"
+Requires-Dist: pytest-asyncio==0.25.3; python_version >= "3.9" and extra == "test"
 Requires-Dist: pytest-cov==5.0.0; python_version <= "3.8" and extra == "test"
 Requires-Dist: pytest-cov==6.0.0; python_version >= "3.9" and extra == "test"
-Requires-Dist: responses==0.25.5; extra == "test"
+Requires-Dist: responses==0.25.6; extra == "test"
 Requires-Dist: PyVirtualDisplay==3.0; extra == "test"
 Provides-Extra: lint
 Requires-Dist: flake8==7.1.1; extra == "lint"
 Requires-Dist: tclint==0.5.0; extra == "lint"
-Requires-Dist: codespell==2.3.0; extra == "lint"
+Requires-Dist: codespell==2.4.1; extra == "lint"
 Provides-Extra: docs
 Requires-Dist: Sphinx==8.1.3; extra == "docs"
 Requires-Dist: pip-licenses==5.0.0; extra == "docs"
@@ -76,7 +76,7 @@ Provides-Extra: profile
 Requires-Dist: gprof2dot==2024.6.6; extra == "profile"
 Provides-Extra: examples
 Requires-Dist: migen==0.9.2; extra == "examples"
-Requires-Dist: lambdalib==0.3.2; extra == "examples"
+Requires-Dist: lambdalib==0.3.3; extra == "examples"
 Provides-Extra: optimizer
 Requires-Dist: google-vizier[jax]==0.1.21; python_version >= "3.10" and extra == "optimizer"
 
@@ -195,7 +195,7 @@ python3 -m pip install -e .[docs,test]  # Optional install step for generating d
 Installation instructions for all external tools can be found in the
 [External Tools](https://docs.siliconcompiler.com/en/stable/user_guide/installation.html#external-tools) section
 of the user guide. We have included shell setup scripts (Ubuntu) for most of the supported tools.
-See the [./setup](./setup) directory for a complete set of scripts and [./setup/_tools.json](./setup/_tools.json) for the currently recommended tool versions.
+See the [./siliconcompiler/toolscripts](./siliconcompiler/toolscripts) directory for a complete set of scripts and [./siliconcompiler/toolscripts/_tools.json](./siliconcompiler/toolscripts/_tools.json) for the currently recommended tool versions.
 
 # Contributing
 

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/README.md

@@ -113,7 +113,7 @@ python3 -m pip install -e .[docs,test]  # Optional install step for generating d
 Installation instructions for all external tools can be found in the
 [External Tools](https://docs.siliconcompiler.com/en/stable/user_guide/installation.html#external-tools) section
 of the user guide. We have included shell setup scripts (Ubuntu) for most of the supported tools.
-See the [./setup](./setup) directory for a complete set of scripts and [./setup/_tools.json](./setup/_tools.json) for the currently recommended tool versions.
+See the [./siliconcompiler/toolscripts](./siliconcompiler/toolscripts) directory for a complete set of scripts and [./siliconcompiler/toolscripts/_tools.json](./siliconcompiler/toolscripts/_tools.json) for the currently recommended tool versions.
 
 # Contributing
 

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/pyproject.toml

@@ -45,7 +45,7 @@ dependencies = [
     "Pillow == 10.4.0; python_version <= '3.8'",
     "Pillow == 11.1.0; python_version >= '3.9'",
     "GitPython == 3.1.44",
-    "lambdapdk >= 0.1.44",
+    "lambdapdk >= 0.1.47",
     "PyGithub == 2.5.0",
     "urllib3 >= 1.26.0", # Required for PyGithub
     "fasteners == 0.19",
@@ -53,7 +53,7 @@ dependencies = [
     "docker == 7.1.0",
     "importlib_metadata; python_version < '3.10'",
     "sc-surelog == 1.84.1",
-    "orjson == 3.10.14",
+    "orjson == 3.10.15",
 
     # dashboard, streamlit does not support 3.9.7
     "streamlit == 1.40.1; python_version <= '3.8'",
@@ -106,16 +106,16 @@ test = [
     "pytest-xdist == 3.6.1",
     "pytest-timeout == 2.3.1",
     "pytest-asyncio == 0.24.0; python_version <= '3.8'",
-    "pytest-asyncio == 0.25.2; python_version >= '3.9'",
+    "pytest-asyncio == 0.25.3; python_version >= '3.9'",
     "pytest-cov == 5.0.0; python_version <= '3.8'",
     "pytest-cov == 6.0.0; python_version >= '3.9'",
-    "responses == 0.25.5",
+    "responses == 0.25.6",
     "PyVirtualDisplay == 3.0"
 ]
 lint = [
     "flake8 == 7.1.1",
     "tclint == 0.5.0",
-    "codespell == 2.3.0"
+    "codespell == 2.4.1"
 ]
 docs = [
     "Sphinx == 8.1.3",
@@ -128,7 +128,7 @@ profile = [
 ]
 examples = [
     "migen == 0.9.2",
-    "lambdalib == 0.3.2"
+    "lambdalib == 0.3.3"
 ]
 optimizer = [
     "google-vizier[jax] == 0.1.21; python_version >= '3.10'"
@@ -156,6 +156,11 @@ testpaths = [
 ]
 timeout = "180"
 asyncio_default_fixture_loop_scope = "function"
+filterwarnings = [
+    "ignore:pkg_resources is deprecated as an API:DeprecationWarning",
+    'ignore:Deprecated call to `pkg_resources.declare_namespace.*:DeprecationWarning',
+    'ignore:.* is multi-threaded, use of fork\(\) may lead to deadlocks in the child.:DeprecationWarning'
+]
 
 [tool.tclint]
 exclude = [

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/siliconcompiler/_metadata.py

@@ -1,5 +1,5 @@
 # Version number following semver standard.
-version = '0.29.2'
+version = '0.29.4'
 
 # Default server address for remote runs, if unspecified.
 default_server = 'https://server.siliconcompiler.com'

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/siliconcompiler/apps/sc_install.py

@@ -73,16 +73,18 @@ def show_tool(tool, script):
 def _get_os_name():
     machine_info = _get_machine_info()
     system = machine_info.get('system', "").lower()
-    distro = machine_info.get('distro', "").lower()
-    osversion = machine_info.get('osversion', "").lower()
     if system == 'linux':
+        distro = machine_info.get('distro', "").lower()
         if distro == 'ubuntu':
+            osversion = machine_info.get('osversion', "").lower()
             version, _ = osversion.split('.')
             return f"{distro}{version}"
         elif distro == 'rocky':
+            osversion = machine_info.get('osversion', "").lower()
             version, _ = osversion.split('.')
             return f"rhel{version}"
         elif distro == 'rhel':
+            osversion = machine_info.get('osversion', "").lower()
             version, _ = osversion.split('.')
             return f"rhel{version}"
     return None
@@ -134,6 +136,10 @@ def _recommended_tool_groups(tools):
     for group, group_tools in groups.items():
         if all([tool in tools for tool in group_tools]):
             filter_groups[group] = group_tools
+        else:
+            missing = sorted([tool for tool in group_tools if tool not in tools])
+            filter_groups[group] = f"{group} group is not available for {_get_os_name()} " \
+                f"due to lack of support for the following tools: {', '.join(missing)}"
     return filter_groups
 
 
@@ -168,10 +174,15 @@ To system debugging information (this should only be used to debug):
     parser = argparse.ArgumentParser(
         prog=progname,
         description=description,
-        formatter_class=argparse.RawDescriptionHelpFormatter)
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter)
 
     tools = _get_tools_list()
 
+    if _get_os_name() is None:
+        print("Unsupported operating system", file=sys.stderr)
+        print_machine_info()
+        return 1
+
     tool_choices = ChoiceOptional(tools.keys())
     parser.add_argument(
         "tool",
@@ -220,7 +231,11 @@ To system debugging information (this should only be used to debug):
     args.tool = list(args.tool)
     if args.group:
         for group in args.group:
-            args.tool.extend(tool_groups[group])
+            if isinstance(tool_groups[group], str):
+                print(tool_groups[group], file=sys.stderr)
+                return 1
+            else:
+                args.tool.extend(tool_groups[group])
 
     tools_handled = set()
     for tool in args.tool:

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/siliconcompiler/core.py

@@ -21,6 +21,7 @@ from siliconcompiler.remote import client
 from siliconcompiler.schema import Schema, SCHEMA_VERSION
 from siliconcompiler.schema import utils as schema_utils
 from siliconcompiler import utils
+from siliconcompiler.utils.logging import LoggerFormatter, ColorStreamFormatter
 from siliconcompiler import _metadata
 from siliconcompiler import NodeStatus, SiliconCompilerError
 from siliconcompiler.report import _show_summary_table
@@ -225,7 +226,8 @@ class Chip:
         else:
             in_run = False
 
-        log_format = ['%(levelname)-7s']
+        level_format = '%(levelname)-7s'
+        log_format = [level_format]
         if loglevel == 'debug':
             log_format.append('%(funcName)-10s')
             log_format.append('%(lineno)-4s')
@@ -261,14 +263,17 @@ class Chip:
             log_formatprefix = ""
 
         log_format.append('%(message)s')
-        logformat = log_formatprefix + ' | '.join(log_format)
+        stream_logformat = log_formatprefix + ' | '.join(log_format[1:])
 
         if not self.logger.hasHandlers():
             stream_handler = logging.StreamHandler(stream=sys.stdout)
             self.logger.addHandler(stream_handler)
 
         for handler in self.logger.handlers:
-            formatter = logging.Formatter(logformat)
+            if ColorStreamFormatter.supports_color(handler):
+                formatter = ColorStreamFormatter(log_formatprefix, level_format, stream_logformat)
+            else:
+                formatter = LoggerFormatter(log_formatprefix, level_format, stream_logformat)
             handler.setFormatter(formatter)
 
         self.logger.setLevel(schema_utils.translate_loglevel(loglevel))

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/siliconcompiler/flowgraph.py

@@ -205,18 +205,36 @@ def _get_flowgraph_execution_order(chip, flow, reverse=False):
             else:
                 ex_map.setdefault((istep, iindex), set()).add((step, index))
 
+    rev_ex_map = {}
+    for node, edges in ex_map.items():
+        for step, index in edges:
+            rev_ex_map.setdefault((step, index), set()).add(node)
+
     # Collect execution order of nodes
     if reverse:
         order = [set(_get_flowgraph_exit_nodes(chip, flow))]
     else:
         order = [set(_get_flowgraph_entry_nodes(chip, flow))]
 
+    visited = set()
     while True:
         next_level = set()
-        for step, index in order[-1]:
-            if (step, index) in ex_map and \
-               not any([(step, index) in v for v in ex_map.values()]):
-                next_level.update(ex_map.pop((step, index)))
+        next_visited = set()
+        for step, index in sorted(order[-1]):
+            if (step, index) not in rev_ex_map:
+                # No edges so assume inputs are okay
+                inputs_valid = True
+            else:
+                inputs_valid = all([node in visited for node in rev_ex_map[(step, index)]])
+
+            if inputs_valid:
+                next_visited.add((step, index))
+                if (step, index) in ex_map:
+                    next_level.update(ex_map.pop((step, index)))
+            else:
+                next_level.add((step, index))
+
+        visited.update(next_visited)
 
         if not next_level:
             break
@@ -233,7 +251,7 @@ def _get_flowgraph_execution_order(chip, flow, reverse=False):
 
     exec_order.reverse()
 
-    return exec_order
+    return [sorted(level) for level in exec_order]
 
 
 def get_executed_nodes(chip, flow):

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/siliconcompiler/remote/client.py

@@ -477,6 +477,9 @@ service, provided by SiliconCompiler, is not intended to process proprietary IP.
             # Flush file to ensure everything is written
             upload_file.flush()
 
+            # We no longer need the collected files
+            shutil.rmtree(self.__chip._getcollectdir(jobname=self.__chip.get('option', 'jobname')))
+
         if 'pre_upload' in remote_status:
             self.__logger.info(remote_status['pre_upload']['message'])
             time.sleep(remote_status['pre_upload']['delay'])

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/siliconcompiler/scheduler/__init__.py

@@ -55,6 +55,10 @@ def _get_callback(hook):
     return None
 
 
+# Max lines to print from failed node log
+_failed_log_lines = 20
+
+
 ###############################################################################
 class SiliconCompilerTimeout(Exception):
     ''' Minimal Exception wrapper used to raise sc timeout errors.
@@ -833,6 +837,8 @@ def _run_executable_or_builtin(chip, step, index, version, toolpath, workdir, ru
     is_stderr_log = chip.get('tool', tool, 'task', task, 'stderr', 'destination',
                              step=step, index=index) == 'log' and stderr_file != stdout_file
 
+    chip.logger.info(f'Running in {workdir}')
+
     retcode = 0
     cmdlist = []
     cmd_args = []
@@ -877,7 +883,6 @@ def _run_executable_or_builtin(chip, step, index, version, toolpath, workdir, ru
         # Make record of tool options
         __record_tool(chip, step, index, version, toolpath, cmd_args)
 
-        chip.logger.info('Running in %s', workdir)
         chip.logger.info('%s', printable_cmd)
         timeout = chip.get('option', 'timeout', step=step, index=index)
         logfile = step + '.log'
@@ -988,10 +993,10 @@ def _run_executable_or_builtin(chip, step, index, version, toolpath, workdir, ru
         msg = f'Command failed with code {retcode}.'
         if logfile:
             if quiet:
-                # Print last 10 lines of log when in quiet mode
+                # Print last N lines of log when in quiet mode
                 with sc_open(logfile) as logfd:
                     loglines = logfd.read().splitlines()
-                    for logline in loglines[-10:]:
+                    for logline in loglines[-_failed_log_lines:]:
                         chip.logger.error(logline)
                 # No log file for pure-Python tools.
             msg += f' See log file {os.path.abspath(logfile)}'
@@ -1239,6 +1244,13 @@ def _finalizenode(chip, step, index, replay):
 
     if not is_skipped:
         _check_logfile(chip, step, index, quiet, run_func)
+
+    # Report metrics
+    for metric in ['errors', 'warnings']:
+        val = chip.get('metric', metric, step=step, index=index)
+        if val is not None:
+            chip.logger.info(f'Number of {metric}: {val}')
+
     _hash_files(chip, step, index)
 
     # Capture wall runtime and cpu cores
@@ -1535,12 +1547,13 @@ def _check_node_dependencies(chip, node, deps, deps_was_successful):
 def _launch_nodes(chip, nodes_to_run, processes, local_processes):
     running_nodes = {}
     max_parallel_run = chip.get('option', 'scheduler', 'maxnodes')
-    max_threads = os.cpu_count()
+    max_cores = utils.get_cores(chip)
+    max_threads = utils.get_cores(chip)
     if not max_parallel_run:
-        max_parallel_run = max_threads
+        max_parallel_run = utils.get_cores(chip)
 
-    # clip max parallel jobs to 1 <= jobs <= max_threads
-    max_parallel_run = max(1, min(max_parallel_run, max_threads))
+    # clip max parallel jobs to 1 <= jobs <= max_cores
+    max_parallel_run = max(1, min(max_parallel_run, max_cores))
 
     def allow_start(node):
         if node not in local_processes:
@@ -1561,7 +1574,7 @@ def _launch_nodes(chip, nodes_to_run, processes, local_processes):
         # clamp to max_parallel to avoid getting locked up
         requested_threads = max(1, min(requested_threads, max_threads))
 
-        if requested_threads + sum(running_nodes.values()) > max_threads:
+        if requested_threads + sum(running_nodes.values()) > max_cores:
             # delay until there are enough core available
             return False, 0
 
@@ -1615,8 +1628,14 @@ def _launch_nodes(chip, nodes_to_run, processes, local_processes):
             # Update dashboard if the manifest changed
             chip._dash.update_manifest()
 
-        # TODO: exponential back-off with max?
-        time.sleep(0.1)
+        if len(running_nodes) == 1:
+            # if there is only one node running, just join the thread
+            running_node = list(running_nodes.keys())[0]
+            processes[running_node]["proc"].join()
+        elif len(running_nodes) > 1:
+            # if there are more than 1, join the first with a timeout
+            running_node = list(running_nodes.keys())[0]
+            processes[running_node]["proc"].join(timeout=0.1)
 
 
 def _process_completed_nodes(chip, processes, running_nodes):
@@ -1936,7 +1955,7 @@ def check_node_inputs(chip, step, index):
                                            step=check_step, index=check_index)
 
                 if check_hash != prev_hash:
-                    print_warning(key)
+                    print_warning(key, "file hash")
                     return False
             else:
                 # check timestamps on current files
@@ -2062,7 +2081,6 @@ def check_logfile(chip, jobname=None, step=None, index='0',
                             chip.logger.info(f'{suffix}: {line_with_num}')
 
     for suffix in ordered_suffixes:
-        chip.logger.info(f'Number of {suffix}: {matches[suffix]}')
         checks[suffix]['report'].close()
 
     return matches

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/siliconcompiler/tools/__init__.py

@@ -1,4 +1,4 @@
-from siliconcompiler.tools.bambu import bambu
+from siliconcompiler.tools import bambu
 from siliconcompiler.tools.bluespec import bluespec
 from siliconcompiler.tools.builtin import builtin
 from siliconcompiler.tools.chisel import chisel

{siliconcompiler-0.29.2 → siliconcompiler-0.29.4}/siliconcompiler/tools/_common/asic.py

@@ -194,6 +194,9 @@ def set_tool_task_lib_var(chip,
 
         values.update(chip.get(*lib_key, step=get_step, index=get_index))
 
+    if default_value and not check_value(values):
+        values = default_value
+
     if check_value(values):
         chip.set('tool', tool, 'task', task, 'var', param_key, values,
                  step=step, index=index, clobber=False)

siliconcompiler-0.29.4/siliconcompiler/tools/_common/asic_clock.py

@@ -0,0 +1,101 @@
+import re
+from siliconcompiler.utils import sc_open
+from siliconcompiler.tools._common.asic import get_tool_task
+
+
+def __get_clock_data(chip, clock_units_multiplier=1):
+    step = chip.get('arg', 'step')
+    index = chip.get('arg', 'index')
+
+    period = None
+    # get clock information from sdc files
+    if chip.valid('input', 'constraint', 'sdc'):
+        for sdc in chip.find_files('input', 'constraint', 'sdc', step=step, index=index):
+            lines = []
+            with sc_open(sdc) as f:
+                lines = f.read().splitlines()
+
+            # collect simple variables in case clock is specified with a variable
+            re_var = r"[A-Za-z0-9_]+"
+            re_num = r"[0-9\.]+"
+            sdc_vars = {}
+            for line in lines:
+                tcl_variable = re.findall(fr"^\s*set\s+({re_var})\s+({re_num}|\${re_var})", line)
+                if tcl_variable:
+                    var_name, var_value = tcl_variable[0]
+                    sdc_vars[f'${var_name}'] = var_value
+
+            # TODO: handle line continuations
+            for line in lines:
+                clock_period = re.findall(fr"create_clock\s.*-period\s+({re_num}|\${re_var})",
+                                          line)
+                if clock_period:
+                    convert_period = clock_period[0]
+                    while isinstance(convert_period, str) and convert_period[0] == "$":
+                        if convert_period in sdc_vars:
+                            convert_period = sdc_vars[convert_period]
+                        else:
+                            break
+                    if isinstance(convert_period, str) and convert_period[0] == "$":
+                        chip.logger.warning('Unable to identify clock period from '
+                                            f'{clock_period[0]}.')
+                        continue
+                    else:
+                        try:
+                            clock_period = float(convert_period)
+                        except TypeError:
+                            continue
+
+                    clock_period = clock_period * clock_units_multiplier
+
+                    if period is None:
+                        period = clock_period
+                    else:
+                        period = min(period, clock_period)
+
+        if period is not None:
+            return period, None, [('input', 'constraint', 'sdc')]
+
+    if period is None:
+        keys = []
+        key_pin = None
+        # get clock information from defined clocks
+        for pin in chip.getkeys('datasheet', 'pin'):
+            for mode in chip.getkeys('datasheet', 'pin', pin, 'type'):
+                if chip.get('datasheet', 'pin', pin, 'type', mode) == 'clock':
+                    clock_period = min(chip.get('datasheet', 'pin', pin, 'tperiod', mode)) * 1e9
+
+                    if period is None:
+                        period = clock_period
+                        keys = [
+                            ('datasheet', 'pin', pin, 'type', mode),
+                            ('datasheet', 'pin', pin, 'tperiod', mode)
+                        ]
+                        key_pin = pin
+                    else:
+                        if clock_period < period:
+                            period = clock_period
+                            keys = [
+                                ('datasheet', 'pin', pin, 'type', mode),
+                                ('datasheet', 'pin', pin, 'tperiod', mode)
+                            ]
+                            key_pin = pin
+        return period, key_pin, keys
+
+    return None, None, []
+
+
+def add_clock_requirements(chip):
+    _, _, keys = __get_clock_data(chip)
+
+    step = chip.get('arg', 'step')
+    index = chip.get('arg', 'index')
+    tool, task = get_tool_task(chip, step, index)
+    for key in keys:
+        chip.add('tool', tool, 'task', task, 'require', ','.join(key),
+                 step=step, index=index)
+
+
+def get_clock_period(chip, clock_units_multiplier=1):
+    period, name, _ = __get_clock_data(chip, clock_units_multiplier=clock_units_multiplier)
+    return name, period