uphy-upgen 1.0.0.dev2794__tar.gz

uphy_upgen-1.0.0.dev2794/LICENSE.txt

@@ -0,0 +1,5 @@
+Copyright rt-labs AB, Sweden.
+All rights reserved.
+
+You may not use this software in a commercial product without
+purchasing a license. Contact sales@rt-labs.com for more information.

uphy_upgen-1.0.0.dev2794/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.1
+Name: uphy-upgen
+Version: 1.0.0.dev2794
+Summary: U-Phy Generator
+License: Proprietary
+Author: RT-Labs
+Author-email: support@rt-labs.com
+Requires-Python: >=3.8,<4.0
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: crc8 (>=0.2.0,<0.3.0)
+Requires-Dist: jinja2 (>=3.1.2,<4.0.0)
+Requires-Dist: pydantic (>=1.10.7,<2.0.0)
+Requires-Dist: xmlschema (>=3.0.1,<4.0.0)
+Project-URL: Documentation, https://docs.rt-labs.com/u-phy
+Project-URL: RT-Labs, https://rt-labs.com/
+Project-URL: U-Phy, https://rt-labs.com/u-phy
+Description-Content-Type: text/markdown
+
+# U-Phy Device Generator
+
+U-Phy device generator.
+
+## Developing
+
+Python Poetry is recommended. See
+https://python-poetry.org/docs/#installation for installation
+instructions.
+
+    $ cd /path/to/upgen
+    $ poetry install
+    $ poetry shell
+
+## Build distributable binary using Nuitka
+
+Install dependencies on Ubuntu::
+
+    apt install patchelf python3-dev build-essential
+
+The Nuitka compiler can be used to build a distributable binary. Note
+that it should be possible to run the binary on the currently used and
+all later Linux GLIBC versions, but not versions earlier than the one
+in the build platform.
+
+    $ poetry run nuitka \
+        --include-package-data=upgen \
+        --onefile \
+        upgen/cli.py
+    $ mkdir -p bin
+    $ mv cli.bin bin/upgen
+

uphy_upgen-1.0.0.dev2794/README.md

@@ -0,0 +1,31 @@
+# U-Phy Device Generator
+
+U-Phy device generator.
+
+## Developing
+
+Python Poetry is recommended. See
+https://python-poetry.org/docs/#installation for installation
+instructions.
+
+    $ cd /path/to/upgen
+    $ poetry install
+    $ poetry shell
+
+## Build distributable binary using Nuitka
+
+Install dependencies on Ubuntu::
+
+    apt install patchelf python3-dev build-essential
+
+The Nuitka compiler can be used to build a distributable binary. Note
+that it should be possible to run the binary on the currently used and
+all later Linux GLIBC versions, but not versions earlier than the one
+in the build platform.
+
+    $ poetry run nuitka \
+        --include-package-data=upgen \
+        --onefile \
+        upgen/cli.py
+    $ mkdir -p bin
+    $ mv cli.bin bin/upgen

uphy_upgen-1.0.0.dev2794/pyproject.toml

@@ -0,0 +1,39 @@
+[tool.poetry]
+name = "uphy-upgen"
+version = "1.0.0.dev2794"
+description = "U-Phy Generator"
+authors = ["RT-Labs <support@rt-labs.com>"]
+readme = "README.md"
+packages = [
+    { include = "upgen" },
+]
+license = "Proprietary"
+
+[tool.poetry.dependencies]
+python = "^3.8"
+pydantic = "^1.10.7"
+jinja2 = "^3.1.2"
+crc8 = "^0.2.0"
+xmlschema = "^3.0.1"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^7.4.4"
+pytest-cov = "^5.0.0"
+
+[tool.poetry.group.compile.dependencies]
+nuitka = "^2.4.11"
+
+[tool.poetry.scripts]
+upgen = 'upgen.cli:run'
+
+[tool.pytest.ini_options]
+addopts = "--cov=upgen --cov-report term-missing"
+
+[tool.poetry.urls]
+"RT-Labs" = "https://rt-labs.com/"
+"U-Phy" = "https://rt-labs.com/u-phy"
+"Documentation" = "https://docs.rt-labs.com/u-phy"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

uphy_upgen-1.0.0.dev2794/upgen/__init__.py

@@ -0,0 +1,16 @@
+import sys
+
+if sys.version_info[:2] >= (3, 8):
+    # TODO: Import directly (no need for conditional) when `python_requires = >= 3.8`
+    from importlib.metadata import PackageNotFoundError, version  # pragma: no cover
+else:
+    from importlib_metadata import PackageNotFoundError, version  # pragma: no cover
+
+try:
+    # Change here if project is renamed and does not equal the package name
+    dist_name = "uphy-upgen"
+    __version__ = version(dist_name)
+except PackageNotFoundError:  # pragma: no cover
+    __version__ = "unknown"
+finally:
+    del version, PackageNotFoundError

uphy_upgen-1.0.0.dev2794/upgen/cli.py

@@ -0,0 +1,142 @@
+import argparse
+import logging
+import sys
+import os
+import traceback
+from argparse import RawTextHelpFormatter
+
+from pathlib import Path
+
+from upgen import __version__
+from upgen.model import *
+from upgen.generators import EtherCATGenerator
+from upgen.generators import ProfinetGenerator
+from upgen.generators import EthernetipGenerator
+from upgen.generators import CCodeGenerator
+from upgen.generators import SIIGenerator
+
+_logger = logging.getLogger(__name__)
+
+GENERATORS = {
+    'EtherCAT': EtherCATGenerator,
+    'Profinet': ProfinetGenerator,
+    "EtherNetIP":EthernetipGenerator,
+        'Code': CCodeGenerator,
+         'SII': SIIGenerator,
+
+}
+
+
+def get_generator_classes(name):
+    if name == 'All':
+        return [GENERATORS[g] for g in GENERATORS]
+    try:
+        return [GENERATORS[name]]
+    except KeyError:
+        raise ValueError(f"--generator name must be in {tuple(GENERATORS)} or \'All\')")
+
+
+def parse_args(args):
+    parser = argparse.ArgumentParser(description=
+    """
+    Tool for generation of device artifacts from a U-Phy device model
+    file, including:
+    - C-code with the device specific data model
+    - EtherCAT ESI file
+    - EtherCAT SII EEPROM file
+    - Profinet GSDML file
+
+    To evaluate the device functionality, copy generated model.c/h and
+    eeprom.bin to the \'generated\' folder of the U-Phy sample application
+    and rebuild.
+
+    Example usage:
+        upgen export my_device_model.json
+    """,
+    formatter_class=RawTextHelpFormatter)
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"upgen {__version__}",
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        dest="loglevel",
+        help="set loglevel to INFO",
+        action="store_const",
+        const=logging.INFO,
+    )
+    parser.add_argument(
+        "-vv",
+        "--very-verbose",
+        dest="loglevel",
+        help="set loglevel to DEBUG",
+        action="store_const",
+        const=logging.DEBUG,
+    )
+    parser.add_argument("-d", "--destination", help="destination folder for generated model", default=".")
+
+    parser.add_argument('--generator', help="the generator to use. Option value "
+                        "can be one of  {} or \'All\'. Default value is \'All\'".format(tuple(GENERATORS)), default="All")
+
+    parser.add_argument('-n', '--device_name', help="the name of the device to generate. "
+                        "Only used when generating C code or SII eeprom for multi device models.")
+
+    # Import device description file or
+    # Export source code and device description files from json model
+    # TODO - for export the generators for fieldbuses defined by the
+    # model should be run. All outputs placed in the destination folder.
+    parser.add_argument('action', choices=('import', 'export', 'schema'))
+    parser.add_argument("file", help="Device model in JSON format")
+
+    return parser.parse_args(args)
+
+
+def setup_logging(loglevel):
+    logformat = "[%(asctime)s] %(levelname)s:%(name)s:%(message)s"
+    if loglevel is None:
+        loglevel = logging.ERROR
+    logging.basicConfig(
+        level=loglevel, stream=sys.stdout, format=logformat, datefmt="%Y-%m-%d %H:%M:%S"
+    )
+
+
+def main(args):
+    args = parse_args(args)
+    setup_logging(args.loglevel)
+
+    if args.action == 'import':
+        raise Exception( "import not supported")
+        generator_class = get_generator_class(args.generator)
+        generator = generator_class(None)
+        generator.import_file(args.file)
+        print(generator.model)
+
+    elif args.action == 'export':
+        model = Root.parse_file(Path(args.file))
+        os.chdir(args.destination)
+        generator_classes = get_generator_classes(args.generator)
+        for gen_cls in generator_classes:
+            try:
+                generator = gen_cls(model)
+                if (gen_cls in [CCodeGenerator, SIIGenerator, EthernetipGenerator]):
+                    generator.select_device(args.device_name)
+                generator.export_file()
+            except Exception as e:
+                print(
+                    f"Error while running {gen_cls.__name__}: \"{str(e)}\" Continue generating rest of artifacts.")
+                _logger.warning(''.join(traceback.TracebackException.from_exception(e).format()))
+
+    elif args.action == 'schema':
+        print(Root.schema_json(indent=2))
+
+    _logger.info("Script ends here")
+
+
+def run():
+    main(sys.argv[1:])
+
+
+if __name__ == "__main__":
+    run()

uphy_upgen-1.0.0.dev2794/upgen/generators/__init__.py

@@ -0,0 +1,11 @@
+
+# import os
+from pathlib import Path, PurePath
+
+SCHEMA_DIR = Path(PurePath(__file__).parent, "schema")
+
+from .ethercat import EtherCATGenerator
+from .sii import SIIGenerator
+from .profinet import ProfinetGenerator
+from .ethernetip import EthernetipGenerator
+from .c_code import CCodeGenerator

uphy_upgen-1.0.0.dev2794/upgen/generators/c_code.py

@@ -0,0 +1,120 @@
+import logging
+import re
+import json
+import importlib.resources
+from .. import templates
+from jinja2 import Environment, PackageLoader, select_autoescape
+from ..model.uphy import *
+
+_logger = logging.getLogger(__name__)
+
+
+def c_type(value):
+    map = {
+        DataType.UINT32: 'uint32_t',
+        DataType.UINT16: 'uint16_t',
+        DataType.UINT8: 'uint8_t',
+        DataType.INT32: 'int32_t',
+        DataType.INT16: 'int16_t',
+        DataType.INT8: 'int8_t',
+        DataType.REAL32: 'float',
+    }
+    return map[value.datatype]
+
+
+def c_name(value):
+    name = value.name
+    if re.search("^[0-9].*", name):           # Escape leading numeral
+        name = f"_{name}"
+
+    name = re.sub("[^0-9A-Za-z_]", "_", name) # Replace special chars
+    name = re.sub("[_+]", "_", name)          # Contract repeating underscore
+    name = re.sub("_$", "", name)             # Strip trailing underscore
+    return name
+
+
+def c_name_upper(value):
+    """Filter for uppercase C names. For example defines."""
+    return c_name(value).upper()
+
+
+def c_hex(value):
+    return value.replace('#', '0')
+
+def c_array(signal):
+    if not signal.is_array:
+        return ""
+    else:
+        return f"[{signal.array_length}]"
+
+def c_flags(signal):
+    if not signal.is_array:
+        return "0"
+    else:
+        return "UP_SIG_FLAG_IS_ARRAY"
+
+def c_bool(value):
+    if value:
+        return "true"
+    else:
+        return "false"
+
+def enip_major_rev(rev_str):
+    return rev_str.split('.')[0]
+
+def enip_minor_rev(rev_str):
+    return rev_str.split('.')[1]
+
+class CCodeGenerator:
+    def __init__(self, model):
+        self.model = model
+        self.device = None
+
+        self.env = Environment(
+            loader=PackageLoader("upgen"),
+            autoescape=select_autoescape(),
+            trim_blocks=True,
+            lstrip_blocks=True
+        )
+        self.env.filters['c_type'] = c_type
+        self.env.filters['c_name'] = c_name
+        self.env.filters['c_hex'] = c_hex
+        self.env.filters['c_name_upper'] = c_name_upper
+        self.env.filters['c_array'] = c_array
+        self.env.filters['c_flags'] = c_flags
+        self.env.filters['c_bool'] = c_bool
+        self.env.filters['enip_major_rev'] = enip_major_rev
+        self.env.filters['enip_minor_rev'] = enip_minor_rev
+
+    def select_device(self, device_name):
+        if device_name == None:
+            self.device = self.model.devices[0]
+        else:
+            self.device = self.model.get_device(device_name)
+
+        if self.device == None:
+            raise Exception(f'{device_name} not found in model')
+
+    def export_file(self):
+        _logger.info('Generate model.h')
+        header = self.generate_header_file()
+        _logger.info('Generate model.c')
+        source = self.generate_source_file()
+
+        with open('model.h', 'w') as file:
+            file.write(header)
+
+        with open('model.c', 'w') as file:
+            file.write(source)
+
+    def generate_header_file(self):
+        template = self.env.get_template("model_template.h")
+        code = template.render(model=self.model, device=self.device)
+        _logger.debug(code)
+        return code
+
+    def generate_source_file(self):
+        template = self.env.get_template("model_template.c")
+        code = template.render(model=self.model, device=self.device)
+        _logger.debug(code)
+        return code