Update SDK to version 21.4.0.0

Added
- Functions to add and remove simulated instruments

Fixed
- After replacing a Flow Unit on a Flow EZ, the type is updated on reinit
- Switchboard correctly returns an error on fgt_get_power if it is not connected
- Switchboard and Switch EZ commands sent in quick succession are less
  likely to be ignored by the instrument. A 60ms delay is still recommended.

C#/fgt_sdk_csharp/fgtSdk.cs

@@ -77,6 +77,11 @@ private static IntPtr ArchResolver(string libraryName, Assembly assembly, DllImp
         [DllImport(FGT_SDK)]
         private static extern byte fgt_initEx(ushort[] serialNumbers);
 
+        [DllImport(FGT_SDK)]
+        private static extern byte fgt_create_simulated_instr(fgt_INSTRUMENT_TYPE type, ushort serial, ushort version, int[] config, int length);
+
+        [DllImport(FGT_SDK)]
+        private static extern byte fgt_remove_simulated_instr(fgt_INSTRUMENT_TYPE type, ushort serial);
 
         #endregion
 
@@ -415,6 +420,33 @@ public static fgt_ERROR_CODE Fgt_initEx(List<ushort> serialNumbers)
             return ErrCheck((fgt_ERROR_CODE) fgt_initEx(sns), fgt_ERRCHECK_TYPE.Generic);
         }
 
+        /// <summary>
+        /// Creates a simulated Fluigent instrument, which can be detected and initialized like a real one,
+        /// for the purposes of testing and demonstrations.
+        /// </summary>
+        /// <param name="type">Type of instrument to simulate</param>
+        /// <param name="serial">Serial number for the simulated instrument</param>
+        /// <param name="version">Firmware version for the simulated instrument. Set to 0 to use the default version</param>
+        /// <param name="config">Array describing the instrument's configuration</param>
+        /// <returns></returns>
+        public static fgt_ERROR_CODE Fgt_create_simulated_instr(fgt_INSTRUMENT_TYPE type, ushort serial, ushort version, int[] config)
+        {
+            return ErrCheck((fgt_ERROR_CODE)fgt_create_simulated_instr(type, serial, version, config, config.Length), fgt_ERRCHECK_TYPE.Generic);
+        }
+
+        /// <summary>
+        /// Removes a simulated instrument that had been previously created. If it had already been initialized
+        /// by the SDK, the controller and channels will remain in the respective lists, but they will act as if
+        /// the instrument is missing. This is equivalent to physically disconnecting a real instrument.
+        /// </summary>
+        /// <param name="type">Type of instrument to remove</param>
+        /// <param name="serial">Serial number of the simulated instrument</param>
+        /// <returns></returns>
+        public static fgt_ERROR_CODE Fgt_remove_simulated_instr(fgt_INSTRUMENT_TYPE type, ushort serial)
+        {
+            return ErrCheck((fgt_ERROR_CODE)fgt_remove_simulated_instr(type, serial), fgt_ERRCHECK_TYPE.Generic);
+        }
+
         #endregion
 
         #region Channels info

C#/fgt_sdk_csharp/fgt_sdk.csproj

@@ -5,16 +5,16 @@
     <Authors>Fluigent</Authors>
     <Product>Fluigent Software Development Kit</Product>
     <Description>C# Software Development Kit for Fluigent instruments</Description>
-    <Version>21.3.0.0</Version>
+    <Version>21.4.0.0</Version>
     <PackageTags>Microfluidics, Control</PackageTags>
     <Platforms>AnyCPU;x64;x86</Platforms>
     <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
-    <AssemblyVersion>21.3.0.0</AssemblyVersion>
+    <AssemblyVersion>21.4.0.0</AssemblyVersion>
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
     <Copyright>Copyright (c) Fluigent 2021</Copyright>
     <RepositoryUrl>https://github.com/Fluigent/fgt-SDK</RepositoryUrl>
     <PackageProjectUrl>https://www.fluigent.com/</PackageProjectUrl>
-    <FileVersion>21.3.0.0</FileVersion>
+    <FileVersion>21.4.0.0</FileVersion>
   </PropertyGroup>
 
   <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">

C++/CMakeLists.txt

@@ -1,6 +1,6 @@
-cmake_minimum_required(VERSION 3.17)
+cmake_minimum_required(VERSION 3.13)
 
-project(SDK_cpp_examples VERSION 21.0.0.0)
+project(SDK_cpp_examples VERSION 21.4.0.0)
 set(CMAKE_CXX_STANDARD 11)
 
 add_subdirectory(fgt_SDK_Cpp)

C++/fgt_SDK_Cpp/dlls/fgt_SDK.h

@@ -6,8 +6,8 @@
 *                                                                            
 * Title:   fgt_SDK.h                                                         
 * Purpose: Functions API for Fluigent instruments                            
-* Version: 21.3.0.0
-* Date:	11/2021
+* Version: 21.4.0.0
+* Date:	12/2021
 *============================================================================*/
 
 #ifndef _FGT_SDK_H
@@ -182,6 +182,27 @@ typedef struct
 	 */
 	unsigned char FGT_API fgt_initEx(unsigned short SN[256]);
 
+	/**
+	 * @Description Creates a simulated Fluigent instrument, which can be detected and initialized like a real one, for the purposes
+	 * of testing and demonstrations.
+	 * @param [type] Type of instrument to simulate
+	 * @param [serial] Serial number for the simulated instrument
+	 * @param [version] Firmware version for the simulated instrument. Set to 0 to use the default version
+	 * @param [config] Array describing the instrument's configuration
+	 * @param [length] Length of the config array
+	 * @return fgt_ERROR_CODE
+	 */
+	unsigned char FGT_API fgt_create_simulated_instr(fgt_instrument_t type, unsigned short serial, unsigned short version, int* config, int length);
+
+	/**
+	 * @Description Removes a simulated instrument that had been previously created. If it had already been initialized by the SDK,
+	 * the controller and channels will remain in the respective lists, but they will act as if the instrument is missing. This is
+	   equivalent to physically disconnecting a real instrument.
+	 * @param [type] Type of instrument to remove
+	 * @param [serial] Serial number of the simulated instrument
+	 * @return fgt_ERROR_CODE
+	 */
+	unsigned char FGT_API fgt_remove_simulated_instr(fgt_instrument_t type, unsigned short serial);
 
 	/*============================================================================*/
 	/*-----------------------------  Channels info  ------------------------------*/

C++/fgt_SDK_Cpp/fgt_SDK_Cpp.cpp

@@ -312,6 +312,20 @@ fgt_ERROR_CODE Fgt_initEx(unsigned short SN[256])
 	return returnCode;
 }
 
+fgt_ERROR_CODE Fgt_create_simulated_instr(fgt_instrument_t type, unsigned short serial, unsigned short version, int* config, int length)
+{
+	fgt_ERROR_CODE returnCode = fgt_ERROR_CODE(fgt_create_simulated_instr(type, serial, version, config, length));
+	Fgt_Manage_Generic_Status(returnCode, __func__);
+	return returnCode;
+}
+
+fgt_ERROR_CODE Fgt_remove_simulated_instr(fgt_instrument_t type, unsigned short serial)
+{
+	fgt_ERROR_CODE returnCode = fgt_ERROR_CODE(fgt_remove_simulated_instr(type, serial));
+	Fgt_Manage_Generic_Status(returnCode, __func__);
+	return returnCode;
+}
+
 /*============================================================================*/
 /*------------------------------  Channels info  -----------------------------*/
 /*============================================================================*/

C++/fgt_SDK_Cpp/fgt_SDK_Cpp.h

@@ -7,8 +7,8 @@
 * Title:    fgt_SDK_Cpp.h                                                     
 * Purpose:  Wrapper to fgt_SDK library
 *			Contains an interface to each dll function and type conversions
-* Version:  21.3.0.0
-* Date:	    09/2021
+* Version:  21.4.0.0
+* Date:	    12/2021
 *============================================================================*/
 
 #ifndef _FGT_SDK_CPP_H
@@ -121,6 +121,28 @@ unsigned char Fgt_detect(unsigned short SN[256], fgt_INSTRUMENT_TYPE type[256]);
  */
 fgt_ERROR_CODE Fgt_initEx(unsigned short SN[256]);
 
+/**
+ * @Description Creates a simulated Fluigent instrument, which can be detected and initialized like a real one, for the purposes
+ * of testing and demonstrations.
+ * @param [type] Type of instrument to simulate
+ * @param [serial] Serial number for the simulated instrument
+ * @param [version] Firmware version for the simulated instrument. Set to 0 to use the default version
+ * @param [config] Array describing the instrument's configuration
+ * @param [length] Length of the config array
+ * @return fgt_ERROR_CODE
+ */
+fgt_ERROR_CODE Fgt_create_simulated_instr(fgt_instrument_t type, unsigned short serial, unsigned short version, int* config, int length);
+
+/**
+ * @Description Removes a simulated instrument that had been previously created. If it had already been initialized by the SDK,
+ * the controller and channels will remain in the respective lists, but they will act as if the instrument is missing. This is
+   equivalent to physically disconnecting a real instrument.
+ * @param [type] Type of instrument to remove
+ * @param [serial] Serial number of the simulated instrument
+ * @return fgt_ERROR_CODE
+ */
+fgt_ERROR_CODE Fgt_remove_simulated_instr(fgt_instrument_t type, unsigned short serial);
+
 
 /*============================================================================*/
 /*-----------------------------  Channels info  ------------------------------*/

LabVIEW/dlls/fgt_SDK.h

@@ -6,8 +6,8 @@
 *                                                                            
 * Title:   fgt_SDK.h                                                         
 * Purpose: Functions API for Fluigent instruments                            
-* Version: 21.3.0.0
-* Date:	11/2021
+* Version: 21.4.0.0
+* Date:	12/2021
 *============================================================================*/
 
 #ifndef _FGT_SDK_H
@@ -182,6 +182,27 @@ typedef struct
 	 */
 	unsigned char FGT_API fgt_initEx(unsigned short SN[256]);
 
+	/**
+	 * @Description Creates a simulated Fluigent instrument, which can be detected and initialized like a real one, for the purposes
+	 * of testing and demonstrations.
+	 * @param [type] Type of instrument to simulate
+	 * @param [serial] Serial number for the simulated instrument
+	 * @param [version] Firmware version for the simulated instrument. Set to 0 to use the default version
+	 * @param [config] Array describing the instrument's configuration
+	 * @param [length] Length of the config array
+	 * @return fgt_ERROR_CODE
+	 */
+	unsigned char FGT_API fgt_create_simulated_instr(fgt_instrument_t type, unsigned short serial, unsigned short version, int* config, int length);
+
+	/**
+	 * @Description Removes a simulated instrument that had been previously created. If it had already been initialized by the SDK,
+	 * the controller and channels will remain in the respective lists, but they will act as if the instrument is missing. This is
+	   equivalent to physically disconnecting a real instrument.
+	 * @param [type] Type of instrument to remove
+	 * @param [serial] Serial number of the simulated instrument
+	 * @return fgt_ERROR_CODE
+	 */
+	unsigned char FGT_API fgt_remove_simulated_instr(fgt_instrument_t type, unsigned short serial);
 
 	/*============================================================================*/
 	/*-----------------------------  Channels info  ------------------------------*/