Add version check for onix gateware v2.x

Author: aacuevas

OpenEphys.Onix1/ContextTask.cs

@@ -76,6 +76,8 @@ public class ContextTask : IDisposable
         readonly string contextDriver = DefaultDriver;
         readonly int contextIndex = DefaultIndex;
 
+        private oni.Hub controllerHub;
+
         /// <summary>
         /// Initializes a new instance of the <see cref="ContextTask"/> class.
         /// </summary>
@@ -94,6 +96,15 @@ internal ContextTask(string driver, int index)
             contextIndex = index;
             ctx = new oni.Context(contextDriver, contextIndex);
             Initialize();
+            controllerHub = GetHub(0);
+            uint versionMajor;
+            GenericHelper.GetVersionComponents(controllerHub.FirmwareVersion, out versionMajor, out _);
+            if (versionMajor != 2)
+            {
+                throw new NotSupportedException("This library requires version 2.x of the ONIX firmware."
+                    + "Please update it. Instructions can be found in "
+                    + "https://open-ephys.github.io/onix-docs/Hardware%20Guide/PCIe%20Host/updating-firmware.html");
+            }
         }
 
         private void Initialize()

OpenEphys.Onix1/GenericHelper.cs

@@ -6,5 +6,17 @@ public static uint GetHubAddressFromDeviceAddress(uint deviceAddress)
         {
             return (deviceAddress & 0xFF00u);
         }
+
+        /// <summary>
+        /// Gets the version components from a 16-bit version register value
+        /// </summary>
+        /// <param name="rawVersion">Raw 16-bit version</param>
+        /// <param name="major">Contains the major component extracted from <paramref name="rawVersion"/></param>
+        /// <param name="minor">Contains the minor component extracted from <paramref name="rawVersion"/></param>
+        public static void GetVersionComponents(uint rawVersion, out uint major, out uint minor)
+        {
+            major = (rawVersion >> 8) & 0xFF;
+            minor = rawVersion & 0xFF;
+        }
     }
 }