ioddcomchecker 1.8.3__cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

ioddcomchecker-1.8.3.dist-info/METADATA

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: ioddcomchecker
+Version: 1.8.3
+Summary: IoddCom IO-Link master checker
+Home-page: https://siogeen.com
+Author: Reimund Renner
+Author-email: reimund@siogeen.com
+License: proprietary and confidential
+Project-URL: Documentation, https://siogeen.com/doc/
+Project-URL: Help Desk, https://siogeen.com/helpdesk/
+Project-URL: Knowledge Base, https://siogeen.com/helpdesk/knowledgebase
+Project-URL: News, https://news.siogeen.com/
+Keywords: IO-Link,IODD,development,test,production
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Manufacturing
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Customer Service
+Classifier: Topic :: Software Development :: Embedded Systems
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: License :: Other/Proprietary License
+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-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: ioddcombase>=1.8.3
+Requires-Dist: dict2obj>=1.2.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+IoddComChecker - IoddCom Checker
+================================
+
+.. _IoddComCheckerGui: /project/IoddComCheckerGui
+
+This is the CLI for checking your IO-Link masters working with Siogeen IoddCom.
+
+If you want using a GUI see IoddComCheckerGui_
+
+**Install**
+
+Use pip to install IoddComChecker:
+
+>>> pip install IoddComChecker
+
+In case of dependency problems, please use a virtual environment, see https://docs.python.org/3/library/venv.html
+
+USB IO-Link masters:
+
+* Linux and Raspberry Pi
+
+  For Linux and Raspberry Pi udev rules and dialout group need to be installed. Please install this script as root or sudo user:
+  https://siogeen.com/scripts/install_udev_rules.sh
+
+  Please check the script to have SHA256 hash: https://siogeen.com/scripts/install_udev_rules.sh.sha256
+
+  For searching ethernet based masters, the permission for sending ping ICMP packets is needed, if an exception
+  is displayed in the console, see here how to fix:
+  https://github.com/ValentinBELYN/icmplib/blob/main/docs/6-use-icmplib-without-privileges.md
+
+* Windows
+
+  The respective master serial driver shipped by the vendor needs to be installed
+
+* macOS
+
+  Unfotunately most USB masters cann not be recognized by macOS. If your USB master is not detected,
+  contact us or consider using Windows or Linux.
+
+
+**Usage**
+
+To start a scan execute on the console:
+
+>>> python -m siogeen.tools.cli.IoddComChecker
+
+**Command line options**
+
+>>> IoddComChecker [-h] [-a ADDRESS] [--auto] [-s SELECT] [--verbose VERBOSE] [--version]
+
+-h, --help            show this help message and exit
+-a ADDRESS, --address ADDRESS
+                    specify one or more master addresses (default all)
+--auto                activate master ports if all are disabled
+-s SELECT, --select SELECT
+                    select specific master types: ETH (ethernet) or USB
+--verbose VERBOSE     verbosity 0..3
+--version             print version
+
+**Example**
+
+>>> IoddComChecker -a 10.0.0.17 -a 10.0.0.19 --auto
+
+For full package, requests and support go to https://siogeen.com
+
+**Copyright 2017-2025 Siogeen UG** (limited liability)
+
+.. _request: https://siogeen.com/#contact
+
+Supported Platforms
+~~~~~~~~~~~~~~~~~~~
+
+========================= ===================== ======================
+**OS**                    Python 2.7, 3.4-3.7   Python 3.8 - 3.13
+========================= ===================== ======================
+**Windows**                 [1]_                   x
+**Linux x86/x64**           [1]_                   x
+**Linux Arm (Raspberry)**   [1]_                   x
+**macOS**                   [1]_                   x
+========================= ===================== ======================
+
+.. [1] IoddCom for Python 2.7, 3.4 - 3.7 on request_.
+
+Support for other platforms on request_.
+
+Supported operating systems and IO-Link masters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Table of supported IO-Link masters for specific operating systems (OS):
+
++-----------------------------------+---------------------------------------------------+
+| Master                            | supported OS                                      |
+|                                   +---------+----------+--------------+---------------+
+|                                   | Windows |  Linux   | Raspberry Pi | macOS 64 [3]_ |
++===================================+=========+==========+==============+===============+
+| TMG-USB based masters             |   x     |   x [4]_ |    x [4]_    |    x [4]_     |
++-----------------------------------+---------+----------+--------------+---------------+
+| TMG ethernet based masters [5]_   |   x     |    x     |    x         |    x          |
++-----------------------------------+---------+----------+--------------+---------------+
+| ifm ethernet based masters [6]_   |   x     |    x     |    x         |    x          |
++-----------------------------------+---------+----------+--------------+---------------+
+| ifm USB based masters [7]_        |   x     |    x     |    x         |    x          |
++-----------------------------------+---------+----------+--------------+---------------+
+| Turck Multi-Protocol masters [8]_ |   x     |    x     |    x         |    x          |
++-----------------------------------+---------+----------+--------------+---------------+
+| REST API based masters [9]_       |   x     |    x     |    x         |    x          |
++-----------------------------------+---------+----------+--------------+---------------+
+| IQ2 based masters [10]_           |   x     |    x     |    x         |    x          |
++-----------------------------------+---------+----------+--------------+---------------+
+
+For Windows, Linux and Raspberry Pi both, 32-bit and 64-bit versions are available.
+
+.. [3] For macOS 11.0+
+
+.. [4] For example: Baumer, Leuze, Pepperl+Fuchs, SICK AG, Turck.
+       *Firmware v3.2+ only runs under Windows. For Linux/macOS/RasPi use FW < 3.2!*
+
+.. [5] For Example: Balluff, Belden, Murrelektronik, Pepperl+Fuchs, Wenglor
+
+.. [6] All ifm IO-Link masters AL1xxx should be supported. Functionality depends on master type
+
+.. [7] ifm USB IO-Link master AL1060
+
+.. [8] Turck Multi-Protocol masters (Modbus TCP, PROFINET, EtherNet/IP): TBEN-L, TBEN-S, FEN20, ...
+       Special functions missing: read/write SIO, functions not available: data storage
+
+.. [9] REST API based masters (Sick SIG200/SIG350, Belden Lion-X, MurrElectronik Impact67 Pro/MVK Pro, Baumer, **Beta:** Balluff)
+
+.. [10] **Experimental:** Iq2 based masters (iqLink, iqInterface and SensoPart SensoIO)
+
+Not supported masters:
+
+* iO-Fly masters (soon)
+* Baumer senscontrol masters (soon)
+* Baumer USB-C masters
+* RevolutionPi RevPi masters
+* Pepperl & Fuchs comtrol masters
+* Germbedded masters
+* TEConcept masters
+
+Support for them or other masters on request_.
+
+
+Supported functionality
+~~~~~~~~~~~~~~~~~~~~~~~
+All supported masters have the following functionality:
+
+read/write ISDUs, read/write process data, get/set port config.
+
+The following functionality is varying by master:
+
+====================  ============  =======================================  ============  ==================
+master                data storage  multi data / multi port                  PD streaming  special functions
+====================  ============  =======================================  ============  ==================
+Sim                   yes           read ISDU, read PD, read DI, multi-port  hw/sw         --
+ifm ethernet based    yes           read PD, read DI, multi-port             hw/sw         yes
+ifm USB based         yes           read PD, read DI, multi-port             sw            yes
+REST API based        yes           read ISDU [12]_                          sw            yes, Balluff, SICK
+TMG-USB based         yes [11]_     read PD, read DI, multi-port             hw/sw         yes
+TMG ethernet based    yes           read PD, read DI, multi-port             hw/sw         yes, Balluff
+Turck Multi-Protocol  --            read PD, read DI, multi-port             sw            yes
+Iq2 USB/ethernet      yes [13]_     --                                       sw            yes
+====================  ============  =======================================  ============  ==================
+
+.. [11] getConfig not supported, FW 3.2+: masterCommandDownloadFromMaster not supported anymore
+.. [12] REST API multi data write ISDU will be added in future
+.. [13] no read/write master DS supported (only config)
+
+

ioddcomchecker-1.8.3.dist-info/RECORD

@@ -0,0 +1,9 @@
+siogeen/tools/IoddComChecker.cpython-312-x86_64-linux-gnu.so,sha256=VEqs_K6rzj9qNWyKLlEIIT4q83WVXveGJ-dZYNV2HOg,182232
+siogeen/tools/__init__.py,sha256=CCpWoKGerJjGcTDaC48F6skWG4rDZuBzIKxBIZqL74w,462
+siogeen/tools/cli/IoddComChecker.py,sha256=QTQPpDSHzcsCFx6sIiq4LbcoaBghJr5FOG0yIv_1e4k,2420
+siogeen/tools/cli/__init__.py,sha256=5U7K-XTwdy1Iy5suv_-WSFGwC_zqleJ6KdZQR7kShP0,468
+ioddcomchecker-1.8.3.dist-info/METADATA,sha256=m7h6YozWgLddmSB97yzCDHw6diS0VDYXjZyR0qVpM2M,9299
+ioddcomchecker-1.8.3.dist-info/WHEEL,sha256=aSgG0F4rGPZtV0iTEIfy6dtHq6g67Lze3uLfk0vWn88,151
+ioddcomchecker-1.8.3.dist-info/top_level.txt,sha256=vIFg0bLkihbkHyuCZUdHmA-50LP8LvTwDknGWir0T5o,8
+ioddcomchecker-1.8.3.dist-info/RECORD,,
+ioddcomchecker-1.8.3.dist-info/licenses/LICENSE.txt,sha256=mjUk_O3YPxAZeoS61zCys2pyShGDxR4ghwb55ItZ0lg,732

ioddcomchecker-1.8.3.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-manylinux_2_17_x86_64
+Tag: cp312-cp312-manylinux2014_x86_64
+

ioddcomchecker-1.8.3.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,16 @@
+Copyright (c) 2017-2023 Siogeen UG (haftungsbeschraenkt) - All Rights Reserved
+
+Unauthorized copying of this package and its contents, via any medium is 
+strictly prohibited.
+Proprietary and confidential.
+
+Written by Reimund Renner <reimund@siogeen.com>, November 2017
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

ioddcomchecker-1.8.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+siogeen

siogeen/tools/__init__.py

@@ -0,0 +1,17 @@
+'''
+Siogeen IoddCom tools.
+
+The Siogeen IoddCom is designed for various use cases for best working
+experience with IO-Link devices, simple usage and time saving thus both saving
+costs and offering time for the real tasks.
+
+Created on 15.11.2022
+'''
+
+__author__ = "Reimund Renner"
+__email__ = "reimund@siogeen.com"
+__contact__ = "contact@siogeen.com"
+__license__ = "proprietary and confidential"
+
+# classes for: from siogeen import *
+__all__ = ['IoddComChecker']

siogeen/tools/cli/IoddComChecker.py

@@ -0,0 +1,58 @@
+# coding=utf-8
+'''
+Copyright (C) 2023-2025 Siogeen
+
+Created on 4.1.2023
+
+@author: Reimund Renner
+'''
+
+import argparse
+
+def get_parser():
+    """Get CLI parser"""
+    ret = argparse.ArgumentParser(
+        description='Check for IO-Link masters and devices',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='''Examples:
+  python -m siogeen.tools.cli.IoddComChecker
+  python -m siogeen.tools.cli.IoddComChecker -a 10.0.0.17 -a 10.0.0.19 --auto -s ETH
+  python -m siogeen.tools.cli.IoddComChecker -s USB --gui''')
+    ret.add_argument("-a", "--address", action='append',
+                        help="Specify one or more master addresses (default all)")
+    ret.add_argument("--auto", action='store_true',
+                        help="Activate master ports if all are disabled")
+    ret.add_argument("-s", "--select",
+                        help="Select specific master types: ETH (ethernet) or USB")
+    ret.add_argument("--verbose", default=2, help="Select verbosity 0..3")
+    ret.add_argument("--version", action='store_true',
+        help="Print version")
+    ret.add_argument("--gui", action='store_true',
+                        help="Start the graphical user interface")
+    ret.add_argument("--gui-mode", default='Dark', choices=('Dark', 'Light'),
+                        help="GUI screen mode")
+
+    return ret
+
+if __name__ == '__main__':
+    parser = get_parser()
+    args = parser.parse_args()
+    #args = parser.parse_args(['--auto'])
+    #args = parser.parse_args(['-a', '/dev/ttyUSB0'])
+    #args = parser.parse_args(['-a', '192.168.178.77'])
+    #args = parser.parse_args(['-a', '192.168.178.77', '-a', '192.168.178.73'])
+    #args = parser.parse_args(['-a', '192.168.178.77', '--auto'])
+    #args = parser.parse_args(['--gui', '--version'])
+    #args = parser.parse_args(['--gui', '--gui-mode', 'Light', '--select', 'USB'])
+
+    from siogeen.tools import IoddComChecker
+    if args.gui:
+        from siogeen.tools.gui import IoddComChecker as GC
+
+    if args.version:
+        sgui = f" (GUI {GC.__version__})" if args.gui and IoddComChecker.__version__ != GC.__version__ else ""
+        print(f"IoddComChecker {IoddComChecker.__version__}" + sgui)
+    elif args.gui:
+        GC.IoddComCheckerGui(args.address, args.auto, args.verbose, args.select, args.gui_mode).run()
+    else:
+        IoddComChecker.check(args.address, args.auto, verbose=args.verbose, select=args.select)

siogeen/tools/cli/__init__.py

@@ -0,0 +1,17 @@
+'''
+Siogeen IoddCom tools cli's.
+
+The Siogeen IoddCom is designed for various use cases for best working
+experience with IO-Link devices, simple usage and time saving thus both saving
+costs and offering time for the real tasks.
+
+Created on 09.01.2023
+'''
+
+__author__ = "Reimund Renner"
+__email__ = "reimund@siogeen.com"
+__contact__ = "contact@siogeen.com"
+__license__ = "proprietary and confidential"
+
+# classes for: from siogeen import *
+__all__ = ['IoddComChecker']