FUTEK .NET API Documentation
FUTEK_USB_DLL Assembly / FUTEK_USB_DLL Namespace / USB_DLL Class / Set_Zero_Correction Method
Type: System.IntPtr
The handle associated with the USB device.
Type: System.Int32
The loading point associated with the USB device.
The value must be between 0 and 19 (certain models may have fewer loading points).
Type: System.Int32
The the new value to assign to the loading point.
The value must be between 0 and 16,777,215.
Type: System.Byte
The channel number associated with the USB device.
Type: System.Int32
The type of calibration associated with the USB device.


In This Topic
    Set_Zero_Correction Method
    In This Topic
    Warning: The use of this function can affect the factory calibration of the USB device.
    Sets the new loading point value based on a zero correction for fixturing stored in the EEPROM of the microcontroller.
    Syntax
    'Declaration
     
    
    Public Function Set_Zero_Correction( _
       ByVal DeviceHandle As IntPtr, _
       ByVal Point As Integer, _
       ByVal ZeroCorrectionValue As Integer, _
       Optional ByVal ChannelNumber As Byte, _
       Optional ByVal TypeOfCalibration As Integer _
    ) As String
    'Usage
     
    
    Dim instance As USB_DLL
    Dim DeviceHandle As IntPtr
    Dim Point As Integer
    Dim ZeroCorrectionValue As Integer
    Dim ChannelNumber As Byte
    Dim TypeOfCalibration As Integer
    Dim value As String
     
    value = instance.Set_Zero_Correction(DeviceHandle, Point, ZeroCorrectionValue, ChannelNumber, TypeOfCalibration)

    Parameters

    DeviceHandle
    Type: System.IntPtr
    The handle associated with the USB device.
    Point
    Type: System.Int32
    The loading point associated with the USB device.
    The value must be between 0 and 19 (certain models may have fewer loading points).
    ZeroCorrectionValue
    Type: System.Int32
    The the new value to assign to the loading point.
    The value must be between 0 and 16,777,215.
    ChannelNumber
    Type: System.Byte
    The channel number associated with the USB device.
    TypeOfCalibration
    Type: System.Int32
    The type of calibration associated with the USB device.

    Return Value

    Type: System.String
    A value equal to 0; otherwise Error
    Remarks
    This function should be used when the loading point value includes an offset due to the calibration fixture. The ZeroCorrectionValue should represent the loading point value after the value of the fixturing is subtracted. This command should be used after Set_Loading_Point has assigned the loading point value. Please refer to Get_Loading_Point in order to determine the value that is currently assigned to the loading point.
    Example
    If the loading point value = 8,388,608 without any fixturing and the loading point value = 8,388,908 with the fixturing, then the difference is 300 counts. Therefore, each loading point that is taken with the fixturing should then have 300 counts subtracted from its loading point value. The result of the subtraction is the value that should be assigned as the ZeroCorrectionValue.
    Requirements

    Target Platforms: Windows 10, Windows 11

    Target Framework: .NET Framework 4.8 or later

    See Also