From f7faa1f098acedf718526458f7aec4f855161849 Mon Sep 17 00:00:00 2001
From: maniglia <kSociety85@gmail.com>
Date: Tue, 7 Jan 2025 11:40:59 +0100
Subject: [PATCH] Async backup.

---
 .../CubeProgrammerApi.cs                      | 161 ++++++++++++++++++
 .../Interface/ICubeProgrammerApiAsync.cs      |  62 +++----
 2 files changed, 192 insertions(+), 31 deletions(-)

diff --git a/src/01/KSociety.SharpCubeProgrammer/CubeProgrammerApi.cs b/src/01/KSociety.SharpCubeProgrammer/CubeProgrammerApi.cs
index b867425..fbd600c 100644
--- a/src/01/KSociety.SharpCubeProgrammer/CubeProgrammerApi.cs
+++ b/src/01/KSociety.SharpCubeProgrammer/CubeProgrammerApi.cs
@@ -7,6 +7,7 @@ namespace SharpCubeProgrammer
     using System.Diagnostics.CodeAnalysis;
     using System.Globalization;
     using System.IO;
+    using System.IO.Compression;
     using System.Net;
     using System.Runtime.InteropServices;
     using System.Security.Cryptography;
@@ -1395,6 +1396,11 @@ public CubeProgrammerError SendOptionBytesCmd(string command)
             return output;
         }
 
+        public async ValueTask<CubeProgrammerError> SendOptionBytesCmdAsync(string command, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.SendOptionBytesCmd(command), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public DevicePeripheralC? InitOptionBytesInterface()
         {
@@ -1408,6 +1414,11 @@ public CubeProgrammerError SendOptionBytesCmd(string command)
             return null;
         }
 
+        public async ValueTask<DevicePeripheralC?> InitOptionBytesInterfaceAsync(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.InitOptionBytesInterface(), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public DevicePeripheralC? FastRomInitOptionBytesInterface(ushort deviceId)
         {
@@ -1421,6 +1432,11 @@ public CubeProgrammerError SendOptionBytesCmd(string command)
             return null;
         }
 
+        public async ValueTask<DevicePeripheralC?> FastRomInitOptionBytesInterfaceAsync(ushort deviceId, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.FastRomInitOptionBytesInterface(deviceId), cancellationToken).ConfigureAwait(false);
+        }
+
         private DevicePeripheralC? DevicePeripheralCHandler(IntPtr pointer)
         {
             var pointerSize = Marshal.SizeOf<IntPtr>();
@@ -1539,6 +1555,11 @@ public CubeProgrammerError SendOptionBytesCmd(string command)
             return null;
         }
 
+        //private async ValueTask<DevicePeripheralC?> DevicePeripheralCHandlerAsync(IntPtr pointer, CancellationToken cancellationToken = default)
+        //{
+        //    return await Task.Run(() => this.DevicePeripheralCHandler(pointer), cancellationToken).ConfigureAwait(false);
+        //}
+
         /// <inheritdoc />
         public CubeProgrammerError ObDisplay()
         {
@@ -1560,6 +1581,11 @@ public CubeProgrammerError ObDisplay()
             return output;
         }
 
+        public async ValueTask<CubeProgrammerError> ObDisplayAsync(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.ObDisplay(), cancellationToken).ConfigureAwait(false);
+        }
+
         #endregion
 
         #region [Loaders]
@@ -1576,6 +1602,11 @@ public void SetLoadersPath(string path)
             }
         }
 
+        public async ValueTask SetLoadersPathAsync(string path, CancellationToken cancellationToken = default)
+        {
+            await Task.Run(() => this.SetLoadersPath(path), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public DeviceExternalLoader? SetExternalLoaderPath(string path)
         {
@@ -1625,6 +1656,11 @@ public void SetLoadersPath(string path)
             return null;
         }
 
+        public async ValueTask<DeviceExternalLoader?> SetExternalLoaderPathAsync(string path, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.SetExternalLoaderPath(path), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public DeviceExternalLoader? SetExternalLoaderOBL(string path)
         {
@@ -1674,6 +1710,11 @@ public void SetLoadersPath(string path)
             return null;
         }
 
+        public async ValueTask<DeviceExternalLoader?> SetExternalLoaderOBLAsync(string path, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.SetExternalLoaderOBL(path), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public DeviceExternalStorageInfo? GetExternalLoaders(string path = @".\st\Programmer")
         {
@@ -1742,6 +1783,11 @@ public void SetLoadersPath(string path)
             return null;
         }
 
+        public async ValueTask<DeviceExternalStorageInfo?> GetExternalLoadersAsync(string path = @".\st\Programmer", CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.GetExternalLoaders(path), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public void RemoveExternalLoader(string path)
         {
@@ -1752,6 +1798,11 @@ public void RemoveExternalLoader(string path)
             }
         }
 
+        public async ValueTask RemoveExternalLoaderAsync(string path, CancellationToken cancellationToken = default)
+        {
+            await Task.Run(() => this.RemoveExternalLoader(path), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public void DeleteLoaders()
         {
@@ -1761,6 +1812,11 @@ public void DeleteLoaders()
             }
         }
 
+        public async ValueTask DeleteLoadersAsync(CancellationToken cancellationToken = default)
+        {
+            await Task.Run(() => this.DeleteLoaders(), cancellationToken).ConfigureAwait(false);
+        }
+
         #endregion
 
         #region [STM32WB specific]
@@ -1790,6 +1846,11 @@ public void DeleteLoaders()
             return (result, buffer);
         }
 
+        public async ValueTask<(CubeProgrammerError, byte[])> GetUID64Async(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.GetUID64(), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError FirmwareDelete()
         {
@@ -1804,6 +1865,11 @@ public CubeProgrammerError FirmwareDelete()
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> FirmwareDeleteAsync(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.FirmwareDelete(), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError FirmwareUpgrade(string filePath, string address, uint firstInstall, uint startStack, uint verify)
         {
@@ -1821,6 +1887,11 @@ public CubeProgrammerError FirmwareUpgrade(string filePath, string address, uint
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> FirmwareUpgradeAsync(string filePath, string address, uint firstInstall, uint startStack, uint verify, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.FirmwareUpgrade(filePath, address, firstInstall, startStack, verify), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError StartWirelessStack()
         {
@@ -1835,6 +1906,11 @@ public CubeProgrammerError StartWirelessStack()
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> StartWirelessStackAsync(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.StartWirelessStack(), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError UpdateAuthKey(string filePath)
         {
@@ -1849,6 +1925,11 @@ public CubeProgrammerError UpdateAuthKey(string filePath)
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> UpdateAuthKeyAsync(string filePath, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.UpdateAuthKey(filePath), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError AuthKeyLock()
         {
@@ -1863,6 +1944,11 @@ public CubeProgrammerError AuthKeyLock()
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> AuthKeyLockAsync(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.AuthKeyLock(), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError WriteUserKey(string filePath, byte keyType)
         {
@@ -1879,6 +1965,11 @@ public CubeProgrammerError WriteUserKey(string filePath, byte keyType)
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> WriteUserKeyAsync(string filePath, byte keyType, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.WriteUserKey(filePath, keyType), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError AntiRollBack()
         {
@@ -1893,6 +1984,11 @@ public CubeProgrammerError AntiRollBack()
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> AntiRollBackAsync(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.AntiRollBack(), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError StartFus()
         {
@@ -1907,6 +2003,11 @@ public CubeProgrammerError StartFus()
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> StartFusAsync(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.StartFus(), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError UnlockChip()
         {
@@ -1921,6 +2022,11 @@ public CubeProgrammerError UnlockChip()
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> UnlockChipAsync(CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.UnlockChip(), cancellationToken).ConfigureAwait(false);
+        }
+
         #endregion
 
         #region [STM32MP specific functions]
@@ -1942,6 +2048,11 @@ public CubeProgrammerError ProgramSsp(string sspFile, string licenseFile, string
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> ProgramSspAsync(string sspFile, string licenseFile, string tfaFile, int hsmSlotId, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.ProgramSsp(sspFile, licenseFile, tfaFile, hsmSlotId), cancellationToken).ConfigureAwait(false);
+        }
+
         #endregion
 
         #region [STM32 HSM specific functions]
@@ -1957,6 +2068,11 @@ public string GetHsmFirmwareID(int hsmSlotId)
             return String.Empty;
         }
 
+        public async ValueTask<string> GetHsmFirmwareIDAsync(int hsmSlotId, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.GetHsmFirmwareID(hsmSlotId), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public ulong GetHsmCounter(int hsmSlotId)
         {
@@ -1967,6 +2083,11 @@ public ulong GetHsmCounter(int hsmSlotId)
             return 0UL;
         }
 
+        public async ValueTask<ulong> GetHsmCounterAsync(int hsmSlotId, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.GetHsmCounter(hsmSlotId), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public string GetHsmState(int hsmSlotId)
         {
@@ -1977,6 +2098,11 @@ public string GetHsmState(int hsmSlotId)
             return String.Empty;
         }
 
+        public async ValueTask<string> GetHsmStateAsync(int hsmSlotId, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.GetHsmState(hsmSlotId), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public string GetHsmVersion(int hsmSlotId)
         {
@@ -1987,6 +2113,11 @@ public string GetHsmVersion(int hsmSlotId)
             return String.Empty;
         }
 
+        public async ValueTask<string> GetHsmVersionAsync(int hsmSlotId, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.GetHsmVersion(hsmSlotId), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public string GetHsmType(int hsmSlotId)
         {
@@ -1997,6 +2128,11 @@ public string GetHsmType(int hsmSlotId)
             return String.Empty;
         }
 
+        public async ValueTask<string> GetHsmTypeAsync(int hsmSlotId, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.GetHsmType(hsmSlotId), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public CubeProgrammerError GetHsmLicense(int hsmSlotId, string outLicensePath)
         {
@@ -2012,6 +2148,11 @@ public CubeProgrammerError GetHsmLicense(int hsmSlotId, string outLicensePath)
             return result;
         }
 
+        public async ValueTask<CubeProgrammerError> GetHsmLicenseAsync(int hsmSlotId, string outLicensePath, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.GetHsmLicense(hsmSlotId, outLicensePath), cancellationToken).ConfigureAwait(false);
+        }
+
         #endregion
 
         #region [Util]
@@ -2025,6 +2166,11 @@ public uint HexConverterToUint(string hex)
             return parseResult ? result : 0;
         }
 
+        public async ValueTask<uint> HexConverterToUintAsync(string hex, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.HexConverterToUint(hex), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public int HexConverterToInt(string hex)
         {
@@ -2034,6 +2180,11 @@ public int HexConverterToInt(string hex)
             return parseResult ? result : 0;
         }
 
+        public async ValueTask<int> HexConverterToIntAsync(string hex, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.HexConverterToInt(hex), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public string HexConverterToString(uint hex)
         {
@@ -2041,6 +2192,11 @@ public string HexConverterToString(uint hex)
             return output;
         }
 
+        public async ValueTask<string> HexConverterToStringAsync(uint hex, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.HexConverterToString(hex), cancellationToken).ConfigureAwait(false);
+        }
+
         /// <inheritdoc />
         public string HexConverterToString(int hex)
         {
@@ -2048,6 +2204,11 @@ public string HexConverterToString(int hex)
             return output;
         }
 
+        public async ValueTask<string> HexConverterToStringAsync(int hex, CancellationToken cancellationToken = default)
+        {
+            return await Task.Run(() => this.HexConverterToString(hex), cancellationToken).ConfigureAwait(false);
+        }
+
         private static string StringFilter(string hex)
         {
             if (String.IsNullOrEmpty(hex))
diff --git a/src/01/KSociety.SharpCubeProgrammer/Interface/ICubeProgrammerApiAsync.cs b/src/01/KSociety.SharpCubeProgrammer/Interface/ICubeProgrammerApiAsync.cs
index ae769b2..72e8d17 100644
--- a/src/01/KSociety.SharpCubeProgrammer/Interface/ICubeProgrammerApiAsync.cs
+++ b/src/01/KSociety.SharpCubeProgrammer/Interface/ICubeProgrammerApiAsync.cs
@@ -309,22 +309,22 @@ public interface ICubeProgrammerApiAsync : IAsyncDisposable
         /// This routine allows program the given Option Byte.
         /// The option bytes are configured by the end user depending on the application requirements.
         /// </summary>
-        CubeProgrammerError SendOptionBytesCmd(string command);
+        ValueTask<CubeProgrammerError> SendOptionBytesCmdAsync(string command, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to get option bytes values of the connected target.
         /// </summary>
-        DevicePeripheralC? InitOptionBytesInterface();
+        ValueTask<DevicePeripheralC?> InitOptionBytesInterfaceAsync(CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to get option bytes values of the connected target.
         /// </summary>
-        DevicePeripheralC? FastRomInitOptionBytesInterface(ushort deviceId);
+        ValueTask<DevicePeripheralC?> FastRomInitOptionBytesInterfaceAsync(ushort deviceId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to display the Option bytes.
         /// </summary>
-        CubeProgrammerError ObDisplay();
+        ValueTask<CubeProgrammerError> ObDisplayAsync(CancellationToken cancellationToken = default);
 
         #endregion
 
@@ -336,34 +336,34 @@ public interface ICubeProgrammerApiAsync : IAsyncDisposable
         /// This routine allows to specify the location of Flash Loader.
         /// </summary>
         /// <param name="path">Indicates the full path of the considered folder.</param>
-        void SetLoadersPath(string path);
+        ValueTask SetLoadersPathAsync(string path, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to specify the path of the external Loaders to be loaded.
         /// </summary>
         /// <param name="path"></param>
-        DeviceExternalLoader? SetExternalLoaderPath(string path);
+        ValueTask<DeviceExternalLoader?> SetExternalLoaderPathAsync(string path, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to specify the path of the external Loaders to be loaded via OBL interfaces.
         /// </summary>
         /// <param name="path">Indicates the full path of the folder containing external Loaders.</param>
-        DeviceExternalLoader? SetExternalLoaderOBL(string path);
+        ValueTask<DeviceExternalLoader?> SetExternalLoaderOBLAsync(string path, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to get available external Loaders in th mentioned path.
         /// </summary>
-        DeviceExternalStorageInfo? GetExternalLoaders(string path = @".\st\Programmer");
+        ValueTask<DeviceExternalStorageInfo?> GetExternalLoadersAsync(string path = @".\st\Programmer", CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to unload an external Loaders.
         /// </summary>
-        void RemoveExternalLoader(string path);
+        ValueTask RemoveExternalLoaderAsync(string path, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to delete all target Flash Loaders.
         /// </summary>
-        void DeleteLoaders();
+        ValueTask DeleteLoadersAsync(CancellationToken cancellationToken = default);
 
         #endregion
 
@@ -376,53 +376,53 @@ public interface ICubeProgrammerApiAsync : IAsyncDisposable
         /// <summary>
         /// This routine allows to read the device unique identifier.
         /// </summary>
-        (CubeProgrammerError, byte[]) GetUID64();
+        ValueTask<(CubeProgrammerError, byte[])> GetUID64Async(CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to erase the BLE stack firmware.
         /// </summary>
-        CubeProgrammerError FirmwareDelete();
+        ValueTask<CubeProgrammerError> FirmwareDeleteAsync(CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to make upgrade of BLE stack firmware or FUS firmware.
         /// </summary>
-        CubeProgrammerError FirmwareUpgrade(string filePath, string address, uint firstInstall, uint startStack, uint verify);
+        ValueTask<CubeProgrammerError> FirmwareUpgradeAsync(string filePath, string address, uint firstInstall, uint startStack, uint verify, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to start the programmed Stack.
         /// </summary>
-        CubeProgrammerError StartWirelessStack();
+        ValueTask<CubeProgrammerError> StartWirelessStackAsync(CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to start the programmed Stack.
         /// </summary>
-        CubeProgrammerError UpdateAuthKey(string filePath);
+        ValueTask<CubeProgrammerError> UpdateAuthKeyAsync(string filePath, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to lock the authentication key and once locked, it is no longer possible to change it.
         /// </summary>
-        CubeProgrammerError AuthKeyLock();
+        ValueTask<CubeProgrammerError> AuthKeyLockAsync(CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to write a customized user key.
         /// </summary>
-        CubeProgrammerError WriteUserKey(string filePath, byte keyType);
+        ValueTask<CubeProgrammerError> WriteUserKeyAsync(string filePath, byte keyType, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to activate the AntiRollBack.
         /// </summary>
-        CubeProgrammerError AntiRollBack();
+        ValueTask<CubeProgrammerError> AntiRollBackAsync(CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to start and establish a communication with the FUS operator.
         /// </summary>
-        CubeProgrammerError StartFus();
+        ValueTask<CubeProgrammerError> StartFusAsync(CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine allows to set default option Bytes.
         /// </summary>
         /// <returns></returns>
-        CubeProgrammerError UnlockChip();
+        ValueTask<CubeProgrammerError> UnlockChipAsync(CancellationToken cancellationToken = default);
 
         #endregion
 
@@ -439,7 +439,7 @@ public interface ICubeProgrammerApiAsync : IAsyncDisposable
         /// <param name="tfaFile">Indicates the full path of the tfa-ssp file.</param>
         /// <param name="hsmSlotId">Indicates the HSM slot ID.</param>
         /// <returns>0 if the SSP was finished successfully, otherwise an error occurred.</returns>
-        CubeProgrammerError ProgramSsp(string sspFile, string licenseFile, string tfaFile, int hsmSlotId);
+        ValueTask<CubeProgrammerError> ProgramSspAsync(string sspFile, string licenseFile, string tfaFile, int hsmSlotId, CancellationToken cancellationToken = default);
 
         #endregion
 
@@ -452,35 +452,35 @@ public interface ICubeProgrammerApiAsync : IAsyncDisposable
         /// </summary>
         /// <param name="hsmSlotId">The slot index of the plugged-in HSM</param>
         /// <returns>string that contains the HSM Firmware Identifier.</returns>
-        string GetHsmFirmwareID(int hsmSlotId);
+        ValueTask<string> GetHsmFirmwareIDAsync(int hsmSlotId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine aims to get the current HSM counter.
         /// </summary>
         /// <param name="hsmSlotId">The slot index of the plugged-in HSM</param>
         /// <returns>Counter value</returns>
-        ulong GetHsmCounter(int hsmSlotId);
+        ValueTask<ulong> GetHsmCounterAsync(int hsmSlotId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine aims to get the HSM State.
         /// </summary>
         /// <param name="hsmSlotId">The slot index of the plugged-in HSM</param>
         /// <returns>string with possible values: ST_STATE , OEM_STATE, OPERATIONAL_STATE , UNKNOWN_STATE</returns>
-        string GetHsmState(int hsmSlotId);
+        ValueTask<string> GetHsmStateAsync(int hsmSlotId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine aims to get the HSM version.
         /// </summary>
         /// <param name="hsmSlotId">The slot index of the plugged-in HSM</param>
         /// <returns>string with possible values: 1 , 2</returns>
-        string GetHsmVersion(int hsmSlotId);
+        ValueTask<string> GetHsmVersionAsync(int hsmSlotId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine aims to get the HSM type.
         /// </summary>
         /// <param name="hsmSlotId">The slot index of the plugged-in HSM</param>
         /// <returns>string with possible values: SFI. SMU. SSP...</returns>
-        string GetHsmType(int hsmSlotId);
+        ValueTask<string> GetHsmTypeAsync(int hsmSlotId, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// This routine aims to get and save the HSM license into a binary file.
@@ -489,7 +489,7 @@ public interface ICubeProgrammerApiAsync : IAsyncDisposable
         /// <param name="hsmSlotId">The slot index of the plugged-in HSM</param>
         /// <param name="outLicensePath">Path of the output binary file.</param>
         /// <returns>0 if the operation was finished successfully, otherwise an error occurred.</returns>
-        CubeProgrammerError GetHsmLicense(int hsmSlotId, string outLicensePath);
+        ValueTask<CubeProgrammerError> GetHsmLicenseAsync(int hsmSlotId, string outLicensePath, CancellationToken cancellationToken = default);
 
         #endregion
 
@@ -500,28 +500,28 @@ public interface ICubeProgrammerApiAsync : IAsyncDisposable
         /// </summary>
         /// <param name="hex"></param>
         /// <returns></returns>
-        uint HexConverterToUint(string hex);
+        ValueTask<uint> HexConverterToUintAsync(string hex, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// HexConverterToInt
         /// </summary>
         /// <param name="hex"></param>
         /// <returns></returns>
-        int HexConverterToInt(string hex);
+        ValueTask<int> HexConverterToIntAsync(string hex, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// HexConverterToString
         /// </summary>
         /// <param name="hex"></param>
         /// <returns></returns>
-        string HexConverterToString(uint hex);
+        ValueTask<string> HexConverterToStringAsync(uint hex, CancellationToken cancellationToken = default);
 
         /// <summary>
         /// HexConverterToString
         /// </summary>
         /// <param name="hex"></param>
         /// <returns></returns>
-        string HexConverterToString(int hex);
+        ValueTask<string> HexConverterToStringAsync(int hex, CancellationToken cancellationToken = default);
 
         #endregion