add firmware compatibility check, v0.3.1

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "radiacode"
-version = "0.3.0"
+version = "0.3.1"
 description = "Library for RadiaCode-101"
 authors = ["Maxim Andreev <[email protected]>"]
 license = "MIT"

radiacode/radiacode.py

@@ -18,7 +18,7 @@ def spectrum_channel_to_energy(channel_number: int, a0: float, a1: float, a2: fl
 class RadiaCode:
     _connection: Union[Bluetooth, Usb]
 
-    def __init__(self, bluetooth_mac: Optional[str] = None):
+    def __init__(self, bluetooth_mac: Optional[str] = None, ignore_firmware_compatibility_check: bool = False):
         self._seq = 0
         if bluetooth_mac is not None:
             self._connection = Bluetooth(bluetooth_mac)
@@ -31,6 +31,12 @@ def __init__(self, bluetooth_mac: Optional[str] = None):
         self.set_local_time(self._base_time)
         self.device_time(0)
 
+        (_, (vmaj, vmin, _)) = self.fw_version()
+        if ignore_firmware_compatibility_check is False and vmaj < 4 or (vmaj == 4 and vmin < 8):
+            raise Exception(
+                f'Incompatible firmware version {vmaj}.{vmin}, >=4.8 required. Upgrade device firmware or use radiacode==0.2.2'
+            )
+
         self._spectrum_format_version = 0
         for line in self.configuration().split('\n'):
             if line.startswith('SpecFormatVersion'):
@@ -95,14 +101,14 @@ def fw_signature(self) -> str:
         idstring = r.unpack_string()
         return f'Signature: {signature:08X}, FileName="{filename}", IdString="{idstring}"'
 
-    def fw_version(self) -> str:
+    def fw_version(self) -> tuple[tuple[int, int, str], tuple[int, int, str]]:
         r = self.execute(b'\x0a\x00')
-        boot_v0, boot_v1 = r.unpack('<HH')
+        boot_minor, boot_major = r.unpack('<HH')
         boot_date = r.unpack_string()
-        target_v0, target_v1 = r.unpack('<HH')
+        target_minor, target_major = r.unpack('<HH')
         target_date = r.unpack_string()
         assert r.size() == 0
-        return f'Boot version: {boot_v1}.{boot_v0} {boot_date} | Target version: {target_v1}.{target_v0} {target_date}'
+        return ((boot_major, boot_minor, boot_date), (target_major, target_minor, target_date))
 
     def hw_serial_number(self) -> str:
         r = self.execute(b'\x0b\x00')