cocotb 2.0.0rc2__cp311-cp311-macosx_11_0_arm64.whl

cocotb_tools/config.py

@@ -0,0 +1,241 @@
+#!/usr/bin/env python
+# Copyright cocotb contributors
+# Copyright (c) 2013 Potential Ventures Ltd
+# Copyright (c) 2013 SolarFlare Communications Inc
+# Licensed under the Revised BSD License, see LICENSE for details.
+# SPDX-License-Identifier: BSD-3-Clause
+
+"""
+Module for querying the cocotb configuration
+
+This module provides information in module global variables and through a
+``main()`` function that is used in the cocotb-config script.
+
+Global variables:
+    share_dir: str, path where the cocotb data is stored
+    makefiles_dir: str, path where the cocotb makefiles are installed
+    libs_dir: str, path where the cocotb interface libraries are located
+"""
+
+import argparse
+import os
+import sys
+import textwrap
+from pathlib import Path
+
+import find_libpython
+
+import cocotb_tools
+
+base_tools_dir = Path(cocotb_tools.__file__).parent.resolve()
+base_cocotb_dir = (base_tools_dir.parent / "cocotb").resolve()
+if not (base_cocotb_dir.exists() and (base_cocotb_dir / "libs").exists()):
+    import cocotb
+
+    base_cocotb_dir = Path(cocotb.__file__).parent.resolve()
+
+share_dir = base_cocotb_dir.joinpath("share")
+libs_dir = base_cocotb_dir.joinpath("libs")
+makefiles_dir = base_tools_dir.joinpath("makefiles")
+
+
+def _get_version() -> str:
+    import cocotb  # noqa: PLC0415
+
+    return cocotb.__version__
+
+
+def _help_vars_text() -> str:
+    if "dev" in _get_version():
+        doclink = "https://docs.cocotb.org/en/development/library_reference.html"
+    else:
+        doclink = f"https://docs.cocotb.org/en/v{_get_version()}/library_reference.html"
+
+    # NOTE: make sure to keep "helpmsg" aligned with docs/source/library_reference.rst
+    helpmsg = textwrap.dedent(
+        """\
+        The following variables are environment variables:
+
+        cocotb
+        ------
+        COCOTB_TOPLEVEL           Instance in the hierarchy to use as the DUT
+        COCOTB_RANDOM_SEED        Random seed, to recreate a previous test stimulus
+        COCOTB_ANSI_OUTPUT        Force cocotb to print or not print in color
+        COCOTB_REDUCED_LOG_FMT    Display log lines shorter
+        COCOTB_ATTACH             Pause time value in seconds before the simulator start
+        COCOTB_ENABLE_PROFILING   Performance analysis of the Python portion of cocotb
+        COCOTB_LOG_LEVEL          Default logging level (default INFO)
+        COCOTB_RESOLVE_X          How to resolve X, Z, U, W, - on integer conversion
+        LIBPYTHON_LOC             Absolute path to libpython
+
+        Regression Manager
+        ------------------
+        COCOTB_PDB_ON_EXCEPTION   Drop into the Python debugger (pdb) on exception
+        COCOTB_TEST_MODULES       Module(s) to search for test functions (comma-separated)
+        COCOTB_TESTCASE           Test function(s) to run (comma-separated list)
+        COCOTB_RESULTS_FILE       File name for xUnit XML tests results
+        COCOTB_USER_COVERAGE      Collect Python user coverage (HDL for some simulators)
+        COVERAGE_RCFILE           Configuration for user code coverage
+
+        GPI
+        ---
+        GPI_EXTRA                       Extra libraries to load at runtime (comma-separated)
+
+        Scheduler
+        ---------
+        COCOTB_SCHEDULER_DEBUG         Enable additional output of coroutine scheduler
+        COCOTB_TRUST_INERTIAL_WRITES   Trust inertial writes rather than mock them using scheduler
+
+        For details, see {}"""
+    ).format(doclink)
+    return helpmsg
+
+
+def lib_name(interface: str, simulator: str) -> str:
+    """
+    Return the name of interface library for given interface (VPI/VHPI/FLI) and simulator.
+    """
+
+    interface_name = interface.lower()
+    supported_interfaces = ["vpi", "vhpi", "fli"]
+    if interface_name not in supported_interfaces:
+        raise ValueError(
+            "Wrong interface used. Supported: " + ", ".join(supported_interfaces)
+        )
+
+    simulator_name = simulator.lower()
+    supported_sims = [
+        "icarus",
+        "questa",
+        "modelsim",
+        "ius",
+        "xcelium",
+        "vcs",
+        "ghdl",
+        "riviera",
+        "activehdl",
+        "cvc",
+        "nvc",
+        "dsim",
+    ]
+    if simulator not in supported_sims:
+        raise ValueError(
+            "Wrong simulator name. Supported: " + ", ".join(supported_sims)
+        )
+
+    if simulator_name in ["questa", "cvc"]:
+        library_name = "modelsim"
+    elif simulator_name == "xcelium":
+        library_name = "ius"
+    elif simulator_name in ["riviera", "activehdl"]:
+        library_name = "aldec"
+    else:
+        library_name = simulator_name
+
+    if library_name == "icarus":
+        lib_ext = ""
+    elif os.name == "nt":
+        lib_ext = ".dll"
+    else:
+        lib_ext = ".so"
+
+    # check if compiled with msvc
+    if (libs_dir / "cocotb.dll").is_file():
+        lib_prefix = ""
+    else:
+        lib_prefix = "lib"
+
+    return lib_prefix + "cocotb" + interface_name + "_" + library_name + lib_ext
+
+
+def lib_name_path(interface: str, simulator: str) -> Path:
+    """
+    Return the absolute path of interface library for given interface (VPI/VHPI/FLI) and simulator
+    """
+    return libs_dir / lib_name(interface, simulator)
+
+
+def _get_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(formatter_class=argparse.RawTextHelpFormatter)
+
+    group = parser.add_mutually_exclusive_group()
+    group.add_argument(
+        "--share",
+        action="store_true",
+        help="Print the path to cocotb's share directory",
+    )
+    group.add_argument(
+        "--makefiles",
+        action="store_true",
+        help="Print the path to cocotb's makefile directory",
+    )
+    group.add_argument(
+        "--python-bin",
+        action="store_true",
+        help="Print the path to the Python executable associated with the environment that cocotb is installed in.",
+    )
+    group.add_argument(
+        "--help-vars",
+        action="store_true",
+        help="Print help about supported Makefile variables",
+    )
+    group.add_argument(
+        "--libpython",
+        action="store_true",
+        help="Print the absolute path to the libpython associated with the current Python installation",
+    )
+    group.add_argument(
+        "--lib-dir",
+        action="store_true",
+        help="Print the absolute path to the interface libraries location",
+    )
+    group.add_argument(
+        "--lib-name",
+        help="Print the name of interface library for given interface (VPI/VHPI/FLI) and simulator",
+        nargs=2,
+        metavar=("INTERFACE", "SIMULATOR"),
+    )
+    group.add_argument(
+        "--lib-name-path",
+        help="Print the absolute path of interface library for given interface (VPI/VHPI/FLI) and simulator",
+        nargs=2,
+        metavar=("INTERFACE", "SIMULATOR"),
+    )
+    group.add_argument(
+        "--version",
+        action="store_true",
+        help="Print the version of cocotb",
+    )
+
+    return parser
+
+
+def main() -> None:
+    parser = _get_parser()
+    args = parser.parse_args()
+
+    if args.share:
+        print(share_dir.as_posix())
+    elif args.makefiles:
+        print(makefiles_dir.as_posix())
+    elif args.python_bin:
+        print(Path(sys.executable).as_posix())
+    elif args.help_vars:
+        print(_help_vars_text())
+    elif args.libpython:
+        libpython_path = find_libpython.find_libpython()
+        if libpython_path is None:
+            sys.exit(1)
+        print(Path(libpython_path).as_posix())
+    elif args.lib_dir:
+        print(libs_dir.as_posix())
+    elif args.lib_name:
+        print(lib_name(*args.lib_name))
+    elif args.lib_name_path:
+        print(lib_name_path(*args.lib_name_path).as_posix())
+    elif args.version:
+        print(_get_version())
+
+
+if __name__ == "__main__":
+    main()

cocotb_tools/ipython_support.py

@@ -0,0 +1,99 @@
+# Copyright cocotb contributors
+# Licensed under the Revised BSD License, see LICENSE for details.
+# SPDX-License-Identifier: BSD-3-Clause
+from typing import Any, Dict, TypeVar
+
+import IPython
+from IPython.terminal.ipapp import load_default_config
+from IPython.terminal.prompts import Prompts
+from pygments.token import Token
+
+import cocotb
+from cocotb.task import bridge
+from cocotb.utils import get_sim_time
+
+T = TypeVar("T")
+
+
+class SimTimePrompt(Prompts):
+    """custom prompt that shows the sim time after a trigger fires"""
+
+    _show_time = 1
+
+    def in_prompt_tokens(self):
+        tokens = super().in_prompt_tokens()
+        if self._show_time == self.shell.execution_count:
+            tokens = [
+                (Token.Comment, f"sim time: {get_sim_time()}"),
+                (Token.Text, "\n"),
+                *tokens,
+            ]
+        return tokens
+
+
+async def embed(user_ns: Dict[str, Any] = {}) -> None:
+    """
+    Start an IPython shell in the current coroutine.
+
+    Unlike using :func:`IPython.embed` directly, the :keyword:`await` keyword
+    can be used directly from the shell to wait for triggers.
+    The :keyword:`yield` keyword from the legacy :ref:`yield-syntax` is not supported.
+
+    This coroutine will complete only when the user exits the interactive session.
+
+    Args:
+        user_ns:
+            The variables to have made available in the shell.
+            Passing ``locals()`` is often a good idea.
+            ``cocotb`` will automatically be included.
+
+    .. note::
+        If your simulator does not provide an appropriate ``stdin``, you may
+        find you cannot type in the resulting shell. Using simulators in batch
+        or non-GUI mode may resolve this. This feature is experimental, and
+        not all simulators are supported.
+    """
+    # ensure cocotb is in the namespace, for convenience
+    default_ns = {"cocotb": cocotb}
+    default_ns.update(user_ns)
+
+    def _runner(x):
+        """Handler for async functions"""
+        nonlocal shell
+        ret = cocotb._scheduler_inst._queue_function(x)
+        shell.prompts._show_time = shell.execution_count
+        return ret
+
+    # build the config to enable `await`
+    c = load_default_config()
+    c.TerminalInteractiveShell.loop_runner = _runner
+    c.TerminalInteractiveShell.autoawait = True
+    # Python3 checks SQLite DB accesses to ensure process ID matches the one that opened the DB and is not propagated
+    # because we launch IPython in a different process, this will cause unnecessary warnings, so disable the PID check
+    c.HistoryAccessor.connection_options = {"check_same_thread": False}
+    # create a shell with access to the dut, and cocotb pre-imported
+    shell = IPython.terminal.embed.InteractiveShellEmbed(
+        user_ns=default_ns,
+        config=c,
+    )
+
+    # add our custom prompts
+    shell.prompts = SimTimePrompt(shell)
+
+    # start the shell in a background thread
+    @bridge
+    def run_shell() -> None:
+        shell()
+
+    await run_shell()
+
+
+@cocotb.test()
+async def run_ipython(dut: Any) -> None:
+    """A test that launches an interactive Python shell.
+
+    Do not call this directly - use this as ``make COCOTB_TEST_MODULES=cocotb.ipython_support``.
+
+    Within the shell, a global ``dut`` variable pointing to the design will be present.
+    """
+    await embed(user_ns={"dut": dut})

cocotb_tools/makefiles/Makefile.deprecations

@@ -0,0 +1,27 @@
+# Copyright cocotb contributors
+# Licensed under the Revised BSD License, see LICENSE for details.
+# SPDX-License-Identifier: BSD-3-Clause
+
+ifdef VERILATOR_TRACE
+    $(warning VERILATOR_TRACE is deprecated, see the "Simulator Support" section in the documentation.)
+endif
+
+ifeq ($(SIM_LOWERCASE),aldec)
+    $(warning Using SIM=aldec is deprecated, please use SIM=riviera instead.)
+    SIM_LOWERCASE := riviera
+endif
+
+# Use this function to warn users about deprecated environment variables
+deprecate = $(if $($(1)),$(if $(filter $($(2)),$($(1))),$($(2)),$(warning Using $(1) is deprecated, please use $(2) instead.)$($(1))),$($(2)))
+
+ifneq ($(COCOTB_TOPLEVEL),$(TOPLEVEL))
+ifneq ($(TOPLEVEL),)
+    COCOTB_TOPLEVEL := $(TOPLEVEL)
+endif
+endif
+
+ifneq ($(COCOTB_USER_COVERAGE),$(COVERAGE))
+ifneq ($(COVERAGE),)
+    COCOTB_USER_COVERAGE := $(COVERAGE)
+endif
+endif

cocotb_tools/makefiles/Makefile.inc

@@ -0,0 +1,198 @@
+# Copyright cocotb contributors
+# Copyright (c) 2013 Potential Ventures Ltd
+# Copyright (c) 2013 SolarFlare Communications Inc
+# Licensed under the Revised BSD License, see LICENSE for details.
+# SPDX-License-Identifier: BSD-3-Clause
+
+# Common makefile included by everything
+
+ifndef COCOTB_MAKEFILE_INC_INCLUDED # Protect against multiple includes
+COCOTB_MAKEFILE_INC_INCLUDED = 1
+
+# Default sim rule will force a re-run of the simulation (though the cocotb library
+# and RTL compilation phases are still evaluated by makefile dependencies)
+.PHONY: sim
+sim:
+	$(RM) $(COCOTB_RESULTS_FILE)
+	"$(MAKE)" -f $(firstword $(MAKEFILE_LIST)) $(COCOTB_RESULTS_FILE)
+
+# Make sure to use bash for the pipefail option used in many simulator Makefiles
+SHELL := bash
+
+OS=$(shell uname)
+ifneq (, $(findstring MINGW, $(OS)))
+    OS := Msys
+else ifneq (, $(findstring MSYS, $(OS)))
+    OS := Msys
+endif
+export OS
+
+export PYGPI_PYTHON_BIN := $(shell $(PYTHON_BIN) -m cocotb_tools.config --python-bin)
+
+# Directory containing the cocotb Makefiles
+COCOTB_MAKEFILES_DIR := $(shell $(PYTHON_BIN) -m cocotb_tools.config --makefiles)
+
+include $(COCOTB_MAKEFILES_DIR)/Makefile.deprecations
+
+PYTHON_ARCH := $(shell $(PYTHON_BIN) -c 'from platform import architecture; print(architecture()[0])')
+ifeq ($(filter $(PYTHON_ARCH),64bit 32bit),)
+    $(error Unknown Python architecture: $(PYTHON_ARCH))
+endif
+
+ifeq ($(OS),Msys)
+    to_tcl_path = $(shell cygpath -m $(1) )
+else
+    to_tcl_path = $(1)
+endif
+
+# Check that the COCOTB_RESULTS_FILE was created, since we can't set an exit code from cocotb.
+define check_for_results_file
+    @test -f $(COCOTB_RESULTS_FILE) || (echo "ERROR: $(COCOTB_RESULTS_FILE) was not written by the simulation!" >&2 && exit 1)
+endef
+
+# Check that the COCOTB_RESULTS_FILE was created and has no failures
+define check_results
+    @$(PYTHON_BIN) -m cocotb_tools.check_results $(COCOTB_RESULTS_FILE)
+endef
+
+SIM_BUILD ?= sim_build
+export SIM_BUILD
+
+COCOTB_RESULTS_FILE ?= results.xml
+COCOTB_HDL_TIMEUNIT ?= 1ns
+COCOTB_HDL_TIMEPRECISION ?= 1ps
+
+export COCOTB_RESULTS_FILE
+
+
+$(SIM_BUILD):
+	mkdir -p $@
+
+# Regression rule uses Make dependencies to determine whether to run the simulation
+.PHONY: regression
+regression: $(COCOTB_RESULTS_FILE)
+
+# Attempt to detect TOPLEVEL_LANG based on available sources if not set
+ifeq ($(TOPLEVEL_LANG),)
+
+ifneq ($(VHDL_SOURCES),)
+ifeq ($(VERILOG_SOURCES),)
+	TOPLEVEL_LANG := vhdl
+endif
+else ifneq ($(VERILOG_SOURCES),)
+ifeq ($(VHDL_SOURCES),)
+	TOPLEVEL_LANG := verilog
+endif
+endif
+
+endif
+
+define find_libpython_errmsg =
+
+
+find_libpython was not able to find a libpython in the current Python environment. Ensure
+the Python development packages are installed. If they are installed and find_libpython
+is not finding the path to libpython, file an upstream bug in find_libpython; then
+manually override the LIBPYTHON_LOC make variable with the absolute path to libpython.so
+(or python.dll on Windows).
+
+endef
+
+ifndef LIBPYTHON_LOC
+
+# get the path to libpython and the return code from the script
+# adapted from https://stackoverflow.com/a/24658961/6614127
+FIND_LIBPYTHON_RES := $(shell $(PYTHON_BIN) -m cocotb_tools.config --libpython; echo $$?)
+FIND_LIBPYTHON_RC := $(lastword $(FIND_LIBPYTHON_RES))
+LIBPYTHON_LOC := $(strip $(subst $(FIND_LIBPYTHON_RC)QQQQ,,$(FIND_LIBPYTHON_RES)QQQQ))
+
+# complain if libpython isn't found, and export otherwise
+ifneq ($(FIND_LIBPYTHON_RC),0)
+    $(error $(find_libpython_errmsg))
+endif
+
+endif
+
+export LIBPYTHON_LOC
+
+define check_vhdl_sources
+if [ "$(VHDL_SOURCES_$(LIB))" == "" ]; then \
+  >&2 echo "ERROR: VHDL_SOURCES_$(LIB) is empty or undefined, but '$(LIB)' is present in VHDL_LIB_ORDER."; \
+  exit 1; \
+fi;
+endef
+
+define check_lib_order
+  if [ "$(filter $(SOURCES_VAR:VHDL_SOURCES_%=%), $(VHDL_LIB_ORDER))" == "" ]; then \
+    >&2 echo "ERROR: $(SOURCES_VAR) defined, but library $(SOURCES_VAR:VHDL_SOURCES_%=%) not present in VHDL_LIB_ORDER."; \
+    exit 1; \
+  fi;
+endef
+
+# NOTE: if the following simulator list is modified, update the sentence
+# "This flag is enabled by default for the GHDL, NVC and Verilator simulators."
+# in docs/source/building.rst accordingly.
+ifneq ($(filter $(SIM),nvc ghdl verilator),)
+  COCOTB_TRUST_INERTIAL_WRITES ?= 1
+else
+  COCOTB_TRUST_INERTIAL_WRITES ?= 0
+endif
+
+export COCOTB_TRUST_INERTIAL_WRITES
+
+
+# Universal
+clean::
+	@$(RM) -rf $(SIM_BUILD)
+	@$(RM) -f $(COCOTB_RESULTS_FILE)
+
+
+# Active-HDL
+clean::
+	@$(RM) -rf work
+	@$(RM) -rf wave.asdb
+
+# IUS
+clean::
+	@$(RM) -rf irun.*
+	@$(RM) -rf ncsim.*
+	@$(RM) -rf gdb_cmd_ncsim
+
+# VCS
+clean::
+	@$(RM) -rf simv.daidir
+	@$(RM) -rf cm.log
+	@$(RM) -rf ucli.key
+
+# Riviera
+clean::
+	@$(RM) -rf compile
+	@$(RM) -rf library.cfg
+	@$(RM) -rf dataset.asdb
+
+# Verilator
+clean::
+	@$(RM) -f dump.vcd
+	@$(RM) -f dump.fst
+
+# Xcelium
+clean::
+	@$(RM) -rf xrun.*
+	@$(RM) -rf xmsim.*
+	@$(RM) -rf gdb_cmd_xmsim
+	@$(RM) -f qrun*
+	@$(RM) -f visualizer.log
+	@$(RM) -f design.bin
+	@$(RM) -f qwave.db
+	@$(RM) -f transcript
+
+
+# DSim
+clean::
+	@$(RM) -rf dsim.*
+	@$(RM) -rf metrics.db
+	@$(RM) -rf file.vcd
+
+else
+    $(warning Including Makefile.inc from a user makefile is a no-op and deprecated. Remove the Makefile.inc inclusion from your makefile, and only leave the Makefile.sim include.)
+endif # COCOTB_MAKEFILE_INC_INCLUDED

cocotb_tools/makefiles/Makefile.sim

@@ -0,0 +1,96 @@
+# Copyright cocotb contributors
+# Copyright (c) 2013, 2018 Potential Ventures Ltd
+# Copyright (c) 2013 SolarFlare Communications Inc
+# Licensed under the Revised BSD License, see LICENSE for details.
+# SPDX-License-Identifier: BSD-3-Clause
+
+# This file includes an appropriate makefile depending on the SIM variable.
+
+.PHONY: all
+all: sim
+
+# NOTE: keep this at 80 chars.
+define help_targets =
+Targets
+=======
+sim                       Unconditionally re-run the simulator (default)
+regression                Run simulator when dependencies have changes
+clean                     Remove build and simulation artefacts
+help                      This help text
+
+endef
+
+# NOTE: keep this at 80 chars.
+define help_makevars =
+Variables
+=========
+
+The following variables are makefile variables:
+
+Makefile-based Test Scripts
+---------------------------
+GUI                       Set this to 1 to enable the GUI mode in the simulator
+SIM                       Selects which simulator Makefile to use
+WAVES                     Enable wave traces dump for Riviera-PRO and Questa
+VERILOG_SOURCES           A list of the Verilog source files to include
+VHDL_SOURCES              A list of the VHDL source files to include
+VHDL_SOURCES_<lib>        VHDL source files to include in *lib* (GHDL/NVC/ModelSim/Questa/Xcelium/Incisive/Riviera-PRO only)
+VHDL_LIB_ORDER            Compilation order of VHDL libraries (needed for NVC/ModelSim/Questa/Xcelium/Incisive/Riviera-PRO)
+SIM_CMD_PREFIX            Prefix for simulation command invocations
+COMPILE_ARGS              Arguments to pass to compile (analysis) stage of simulation
+SIM_ARGS                  Arguments to pass to execution of compiled simulation
+EXTRA_ARGS                Arguments for compile and execute phases
+COCOTB_PLUSARGS           Plusargs to pass to the simulator
+COCOTB_HDL_TIMEUNIT       Default time unit for simulation
+COCOTB_HDL_TIMEPRECISION  Default time precision for simulation
+CUSTOM_COMPILE_DEPS       Add additional dependencies to the compilation target
+CUSTOM_SIM_DEPS           Add additional dependencies to the simulation target
+SIM_BUILD                 Define a scratch directory for use by the simulator
+SCRIPT_FILE               Simulator script to run (for e.g. wave traces)
+
+endef
+
+
+# NOTE: keep *two* empty lines between "define" and "endef":
+define newline
+
+
+endef
+
+# this ensures we use the same python as the one cocotb was installed into
+# attempts to use cocotb_config entry script to get that info, falls back to "python"
+PYTHON_BIN_RES := $(shell cocotb-config --python-bin 2>>/dev/null; echo $$?)
+PYTHON_BIN_RC := $(lastword $(PYTHON_BIN_RES))
+PYTHON_BIN := $(strip $(subst $(PYTHON_BIN_RC)QQQQ,,$(PYTHON_BIN_RES)QQQQ))
+ifneq ($(PYTHON_BIN_RC),0)
+    PYTHON_BIN := python3
+endif
+
+# this cannot be a regular target because of the way Makefile.$(SIM) is included
+ifeq ($(MAKECMDGOALS),help)
+    $(info $(help_targets))
+    $(info $(help_makevars))
+    # hack to get newlines in output, see https://stackoverflow.com/a/54539610
+    # NOTE: the output of the command must not include a '%' sign, otherwise the formatting will break
+    help_envvars := $(subst %,${newline},$(shell $(PYTHON_BIN) -m cocotb.config --help-vars | tr \\n %))
+    $(info ${help_envvars})
+    # is there a cleaner way to exit here?
+    $(error Stopping after printing help)
+endif
+
+include $(shell $(PYTHON_BIN) -m cocotb_tools.config --makefiles)/Makefile.inc
+
+# Default to Icarus if no simulator is defined
+SIM ?= icarus
+
+# Maintain backwards compatibility by supporting upper and lower case SIM variable
+SIM_LOWERCASE := $(shell echo $(SIM) | tr A-Z a-z)
+
+HAVE_SIMULATOR = $(shell if [ -f $(COCOTB_MAKEFILES_DIR)/simulators/Makefile.$(SIM_LOWERCASE) ]; then echo 1; else echo 0; fi;)
+AVAILABLE_SIMULATORS = $(patsubst .%,%,$(suffix $(wildcard $(COCOTB_MAKEFILES_DIR)/simulators/Makefile.*)))
+
+ifeq ($(HAVE_SIMULATOR),0)
+    $(error Couldn't find makefile for simulator: "$(SIM_LOWERCASE)"! Available simulators: $(AVAILABLE_SIMULATORS))
+endif
+
+include $(COCOTB_MAKEFILES_DIR)/simulators/Makefile.$(SIM_LOWERCASE)