Implement check for minimum version of pcan library

Author: Peter Kessen

can/interfaces/pcan/pcan.py

@@ -9,6 +9,8 @@
 
 from typing import Optional
 
+from packaging import version
+
 from ...message import Message
 from ...bus import BusABC, BusState
 from ...util import len2dlc, dlc2len
@@ -19,13 +21,15 @@
     PCAN_BITRATES,
     PCAN_FD_PARAMETER_LIST,
     PCAN_CHANNEL_NAMES,
+    PCAN_NONEBUS,
     PCAN_BAUD_500K,
     PCAN_TYPE_ISA,
     PCANBasic,
     PCAN_ERROR_OK,
     PCAN_ALLOW_ERROR_FRAMES,
     PCAN_PARAMETER_ON,
     PCAN_RECEIVE_EVENT,
+    PCAN_API_VERSION,
     PCAN_DEVICE_NUMBER,
     PCAN_ERROR_QRCVEMPTY,
     PCAN_ERROR_BUSLIGHT,
@@ -58,6 +62,8 @@
 # Set up logging
 log = logging.getLogger("can.pcan")
 
+MIN_PCAN_API_VERSION = version.parse("4.2.0")
+
 
 try:
     # use the "uptime" library if available
@@ -206,6 +212,19 @@ def __init__(
         self.m_objPCANBasic = PCANBasic()
         self.m_PcanHandle = channel
 
+        error, value = self.m_objPCANBasic.GetValue(PCAN_NONEBUS, PCAN_API_VERSION)
+        if error != PCAN_ERROR_OK:
+            raise CanInitializationError(
+                F"Failed to read pcan basic api version"
+            )
+
+        apv = version.parse(value.decode('ascii'))
+        if apv < MIN_PCAN_API_VERSION:
+            raise CanInitializationError(
+                F"Minimum version of pcan api is {MIN_PCAN_API_VERSION}."
+                F" Installed version is {apv}. Consider upgrade of pcan basic package"
+            )
+
         if state is BusState.ACTIVE or state is BusState.PASSIVE:
             self.state = state
         else:

setup.py

@@ -90,6 +90,7 @@
         "typing_extensions>=3.10.0.0",
         'pywin32;platform_system=="Windows" and platform_python_implementation=="CPython"',
         'msgpack~=1.0.0;platform_system!="Windows"',
+        "packaging",
     ],
     extras_require=extras_require,
 )