CP210xManufacturingDLL.h

#ifndef HOST_LIB_MANUFACTURING_INCLUDE_CP210XMANUFACTURINGDLL_H_INCLUDED_XF3N9QM3BK
#define HOST_LIB_MANUFACTURING_INCLUDE_CP210XMANUFACTURINGDLL_H_INCLUDED_XF3N9QM3BK


#include    <stddef.h>
#include    <stdlib.h>
#include    <string.h>
#include    <stdio.h>
#include    <stdint.h>  // For C99 fixed sized types
#include    <stdbool.h> // For C99 _Bool

#include    "silabs_defs.h"
#include    "silabs_sal.h"

#ifdef _WIN32
// The following ifdef block is the standard way of creating macros which make exporting 
// from a DLL simpler. All files within this DLL are compiled with the CP210xDLL_EXPORTS
// symbol defined on the command line. this symbol should not be defined on any project
// that uses this DLL. This way any other project whose source files include this file see 
// CP210xDLL_API functions as being imported from a DLL, whereas this DLL sees symbols
// defined with this macro as being exported.
#ifdef CP210xDLL_EXPORTS
#define CP210xDLL_API
#else
#if defined(SILABS_STATIC_LINK)
#define CP210xDLL_API extern
#pragma comment (lib, "CP210xManufacturing.static.lib")
#else // defined(SILABS_STATIC_LINK)
#define CP210xDLL_API __declspec(dllimport)
#pragma comment (lib, "CP210xManufacturing.lib")
#endif // defined(SILABS_STATIC_LINK)
#endif
#else // !_WIN32
#define CP210xDLL_API 
#define WINAPI 
#endif // !_WIN32


typedef enum _CP210X_GETPRODUCTSTRING {
    CP210x_GETPRODUCTSTRING_SERIAL_NUMBER = 0x00    
    , CP210x_GETPRODUCTSTRING_DESCRIPTION   = 0x01  
    , CP210x_GETPRODUCTSTRING_FULL_PATH = 0x02  

    , CP210x_RETURN_SERIAL_NUMBER = CP210x_GETPRODUCTSTRING_SERIAL_NUMBER   
    , CP210x_RETURN_DESCRIPTION = CP210x_GETPRODUCTSTRING_DESCRIPTION       
    , CP210x_RETURN_FULL_PATH = CP210x_GETPRODUCTSTRING_FULL_PATH           
} CP210X_GETPRODUCTSTRING, *PCP210X_GETPRODUCTSTRING; 
_Check_return_
_Success_(return == TRUE)
__inline static bool IsValidSILABS_GETPRODUCTSTRING(_In_ const CP210X_GETPRODUCTSTRING _s) { return (CP210x_GETPRODUCTSTRING_SERIAL_NUMBER == _s) || (CP210x_GETPRODUCTSTRING_DESCRIPTION == _s) || (CP210x_GETPRODUCTSTRING_FULL_PATH == _s); }

#define     CP210x_CP2101_VERSION               CP210x_PARTNUM_CP2101   
#define     CP210x_CP2102_VERSION               CP210x_PARTNUM_CP2102   
#define     CP210x_CP2103_VERSION               CP210x_PARTNUM_CP2103   
#define     CP210x_CP2104_VERSION               CP210x_PARTNUM_CP2104   
#define     CP210x_CP2105_VERSION               CP210x_PARTNUM_CP2105   
#define     CP210x_CP2108_VERSION               CP210x_PARTNUM_CP2108   
#define     CP210x_CP2109_VERSION               CP210x_PARTNUM_CP2109   
#define     CP210x_CP2102N_QFN28_VERSION        CP210x_PARTNUM_CP2102N_QFN28    
#define     CP210x_CP2102N_QFN24_VERSION        CP210x_PARTNUM_CP2102N_QFN24    
#define     CP210x_CP2102N_QFN20_VERSION        CP210x_PARTNUM_CP2102N_QFN20    

#if defined(NOT_YET)    // TODO: Enstone: These defines are a cut'n'paste dup of the ones in CP210xRuntimeDLL.h.
typedef enum _CP210x_STATUS {
    CP210x_SUCCESS                  = SILABS_STATUS_SUCCESS
    , CP210x_INVALID_HANDLE         = 0x01          
    , CP210x_INVALID_PARAMETER      = 0x02          
    , CP210x_DEVICE_IO_FAILED       = 0x03  
    , CP210x_FUNCTION_NOT_SUPPORTED = 0x04          
    , CP210x_GLOBAL_DATA_ERROR      = 0x05  
    , CP210x_FILE_ERROR             = 0x06  
    , CP210x_COMMAND_FAILED         = 0x08  
    , CP210x_INVALID_ACCESS_TYPE    = 0x09  

    , CP210x_DEVICE_NOT_FOUND       = 0xFF          
} CP210x_STATUS, *PCP210x_STATUS;
#else // defined(NOT_YET)
#define CP210x_SUCCESS SILABS_STATUS_SUCCESS    
#define CP210x_INVALID_HANDLE 0x01              
#define CP210x_INVALID_PARAMETER 0x02           
#define CP210x_DEVICE_IO_FAILED 0x03    
#define CP210x_FUNCTION_NOT_SUPPORTED 0x04  
#define CP210x_GLOBAL_DATA_ERROR 0x05   
#define CP210x_FILE_ERROR 0x06  
#define CP210x_COMMAND_FAILED 0x08  
#define CP210x_INVALID_ACCESS_TYPE 0x09 
#define CP210x_DEVICE_NOT_FOUND 0xFF    
typedef     int     CP210x_STATUS;  
#endif // defined(NOT_YET)

#define     CP210x_MAX_DEVICE_STRLEN            256 
#define     CP210x_MAX_SETUP_STRING_SIZE            246 

#define     CP210x_MAX_MANUFACTURER_STRLEN      45  
#define     CP210x_MAX_PRODUCT_STRLEN           126 
#define     CP210x_MAX_SERIAL_STRLEN            63  

#define     CP2105_MAX_MANUFACTURER_STRLEN      12  
#define     CP2105_MAX_PRODUCT_STRLEN           47  
#define     CP2105_MAX_SERIAL_STRLEN            16  
#define     CP2105_MAX_INTERFACE_STRLEN         32  

#define     CP2108_MAX_MANUFACTURER_STRLEN      126 
#define     CP2108_MAX_PRODUCT_STRLEN           126 
#define     CP2108_MAX_SERIAL_STRLEN            126 
#define     CP2108_MAX_INTERFACE_STRLEN         126 

// CP2102N
#define     CP2102N_MAX_ 
// Type definitions
typedef     char    CP210x_DEVICE_STRING[CP210x_MAX_DEVICE_STRLEN]; 
typedef     char    CP210x_MANUFACTURER_STRING[CP210x_MAX_MANUFACTURER_STRLEN]; 
typedef     char    CP210x_PRODUCT_STRING[CP210x_MAX_PRODUCT_STRLEN]; 
typedef     char    CP210x_SERIAL_STRING[CP210x_MAX_SERIAL_STRLEN]; 
typedef     char    CP2105_INTERFACE_STRING[CP2105_MAX_INTERFACE_STRLEN]; 
typedef     char    CP2108_INTERFACE_STRING[CP2108_MAX_INTERFACE_STRLEN]; 

#define     CP210x_MAX_MAXPOWER                 250 


#define     NUM_BAUD_CONFIGS    32  
//
typedef struct _BAUD_CONFIG
{
    uint16_t    BaudGen;
    uint16_t    Timer0Reload;
    uint8_t Prescaler;
    uint32_t    BaudRate;
} BAUD_CONFIG, *PBAUD_CONFIG;
//
//
#define     BAUD_CONFIG_SIZE    10  
//
typedef     BAUD_CONFIG     BAUD_CONFIG_DATA[NUM_BAUD_CONFIGS];


#define FC_OPEN_TX      0x01    
#define FC_OPEN_RX      0x02    
#define FC_CLOSE_TX     0x04    
#define FC_CLOSE_RX     0x08    
//
#define FC_OPEN_TX_SCI  FC_OPEN_TX  
#define FC_OPEN_RX_SCI  FC_OPEN_RX  
#define FC_CLOSE_TX_SCI FC_CLOSE_TX 
#define FC_CLOSE_RX_SCI FC_CLOSE_RX 
//
#define FC_OPEN_TX_ECI  0x10    
#define FC_OPEN_RX_ECI  0x20    
#define FC_CLOSE_TX_ECI 0x40    
#define FC_CLOSE_RX_ECI 0x80    
//
#define FC_OPEN_TX_IFC0  0x0001 
#define FC_OPEN_RX_IFC0  0x0002 
#define FC_CLOSE_TX_IFC0 0x0004 
#define FC_CLOSE_RX_IFC0 0x0008 
#define FC_OPEN_TX_IFC1  0x0010 
#define FC_OPEN_RX_IFC1  0x0020 
#define FC_CLOSE_TX_IFC1 0x0040 
#define FC_CLOSE_RX_IFC1 0x0080 
#define FC_OPEN_TX_IFC2  0x0100 
#define FC_OPEN_RX_IFC2  0x0200 
#define FC_CLOSE_TX_IFC2 0x0400 
#define FC_CLOSE_RX_IFC2 0x0800 
#define FC_OPEN_TX_IFC3  0x1000 
#define FC_OPEN_RX_IFC3  0x2000 
#define FC_CLOSE_TX_IFC3 0x4000 
#define FC_CLOSE_RX_IFC3 0x8000 

typedef struct _PORT_CONFIG
{
    uint16_t Mode;          
    uint16_t Reset_Latch;   
    uint16_t Suspend_Latch; 
    unsigned char EnhancedFxn; 
} PORT_CONFIG, *PPORT_CONFIG;
//
//
#define PORT_RI_ON              0x0001  
#define PORT_DCD_ON             0x0002  
#define PORT_DTR_ON             0x0004  
#define PORT_DSR_ON             0x0008  
#define PORT_TXD_ON             0x0010  
#define PORT_RXD_ON             0x0020  
#define PORT_RTS_ON             0x0040  
#define PORT_CTS_ON             0x0080  
//
#define PORT_GPIO_0_ON          0x0100  
#define PORT_GPIO_1_ON          0x0200  
#define PORT_GPIO_2_ON          0x0400  
#define PORT_GPIO_3_ON          0x0800  
//
#define PORT_SUSPEND_ON         0x4000  
#define PORT_SUSPEND_BAR_ON     0x8000  
//
#define EF_GPIO_0_TXLED             0x01    
#define EF_GPIO_1_RXLED             0x02    
#define EF_GPIO_2_RS485             0x04    
#define EF_RS485_INVERT             0x08    
#define EF_WEAKPULLUP               0x10    
#define EF_RESERVED_1               0x20    
#define EF_SERIAL_DYNAMIC_SUSPEND   0x40    
#define EF_GPIO_DYNAMIC_SUSPEND     0x80    


typedef struct _DUAL_PORT_CONFIG
{
    uint16_t Mode;          
    uint16_t Reset_Latch;   
    uint16_t Suspend_Latch; 
    unsigned char EnhancedFxn_ECI; 
    unsigned char EnhancedFxn_SCI; 
    unsigned char EnhancedFxn_Device; 
} DUAL_PORT_CONFIG, *PDUAL_PORT_CONFIG;
//
//
#define PORT_RI_SCI_ON          0x0001 
#define PORT_DCD_SCI_ON         0x0002 
#define PORT_DTR_SCI_ON         0x0004 
#define PORT_DSR_SCI_ON         0x0008 
#define PORT_TXD_SCI_ON         0x0010 
#define PORT_RXD_SCI_ON         0x0020 
#define PORT_RTS_SCI_ON         0x0040 
#define PORT_CTS_SCI_ON         0x0080 
#define PORT_GPIO_0_SCI_ON      0x0002 
#define PORT_GPIO_1_SCI_ON      0x0004 
#define PORT_GPIO_2_SCI_ON      0x0008 
#define PORT_SUSPEND_SCI_ON     0x0001  

#define PORT_RI_ECI_ON          0x0100 
#define PORT_DCD_ECI_ON         0x0200 
#define PORT_DTR_ECI_ON         0x0400 
#define PORT_DSR_ECI_ON         0x0800 
#define PORT_TXD_ECI_ON         0x1000 
#define PORT_RXD_ECI_ON         0x2000 
#define PORT_RTS_ECI_ON         0x4000 
#define PORT_CTS_ECI_ON         0x8000 
#define PORT_GPIO_0_ECI_ON      0x0400 
#define PORT_GPIO_1_ECI_ON      0x0800 
#define PORT_SUSPEND_ECI_ON     0x0100  

#define EF_GPIO_0_TXLED_ECI         0x01    
#define EF_GPIO_1_RXLED_ECI         0x02    
#define EF_GPIO_1_RS485_ECI         0x04    
#define EF_RS485_INVERT             0x08    
#define EF_INVERT_SUSPEND_ECI       0x10    
#define EF_DYNAMIC_SUSPEND_ECI      0x40    

#define EF_GPIO_0_TXLED_SCI         0x01    
#define EF_GPIO_1_RXLED_SCI         0x02    
#define EF_INVERT_SUSPEND_SCI       0x10    
#define EF_DYNAMIC_SUSPEND_SCI      0x40    

#define EF_WEAKPULLUP               0x10    


typedef struct _QUAD_PORT_STATE
{
    uint16_t Mode_PB0;  
    uint16_t Mode_PB1;
    uint16_t Mode_PB2;
    uint16_t Mode_PB3;
    uint16_t Mode_PB4;

    uint16_t LowPower_PB0;
    uint16_t LowPower_PB1;
    uint16_t LowPower_PB2;
    uint16_t LowPower_PB3;
    uint16_t LowPower_PB4;

    uint16_t Latch_PB0;
    uint16_t Latch_PB1;
    uint16_t Latch_PB2;
    uint16_t Latch_PB3;
    uint16_t Latch_PB4;
} QUAD_PORT_STATE, *PQUAD_PORT_STATE;
//
//
typedef struct _QUAD_PORT_CONFIG
{
    QUAD_PORT_STATE Reset_Latch;
    QUAD_PORT_STATE Suspend_Latch;
    uint8_t IPDelay_IFC0;
    uint8_t IPDelay_IFC1;
    uint8_t IPDelay_IFC2;
    uint8_t IPDelay_IFC3;
    uint8_t EnhancedFxn_IFC0; 
    uint8_t EnhancedFxn_IFC1;
    uint8_t EnhancedFxn_IFC2;
    uint8_t EnhancedFxn_IFC3;
    uint8_t EnhancedFxn_Device; 
    uint8_t ExtClk0Freq;
    uint8_t ExtClk1Freq;
    uint8_t ExtClk2Freq;
    uint8_t ExtClk3Freq;
} QUAD_PORT_CONFIG, *PQUAD_PORT_CONFIG;
//
//
// PB0
#define  PORT_TX0       0x0001 
#define  PORT_RX0       0x0002 
#define  PORT_RTS0      0x0004 
#define  PORT_CTS0      0x0008 
#define  PORT_DTR0      0x0010 
#define  PORT_DSR0      0x0020 
#define  PORT_DCD0      0x0040 
#define  PORT_RI0       0x0080 
#define  PORT_TX1       0x0100 
#define  PORT_RX1       0x0200 
#define  PORT_RTS1      0x0400 
#define  PORT_CTS1      0x0800 
#define  PORT_DTR1      0x1000 
#define  PORT_DSR1      0x2000 
#define  PORT_DCD1      0x4000 
#define  PORT_RI1       0x8000 

// PB1
#define  PORT_GPIO_0    0x0001  
#define  PORT_GPIO_1    0x0002  
#define  PORT_GPIO_2    0x0004  
#define  PORT_GPIO_3    0x0008  
#define  PORT_GPIO_4    0x0010  
#define  PORT_GPIO_5    0x0020  
#define  PORT_GPIO_6    0x0040  
#define  PORT_GPIO_7    0x0080  
#define  PORT_GPIO_8    0x0100  
#define  PORT_GPIO_9    0x0200  
#define  PORT_GPIO_10   0x0400  
#define  PORT_GPIO_11   0x0800  
#define  PORT_GPIO_12   0x1000  
#define  PORT_GPIO_13   0x2000  
#define  PORT_GPIO_14   0x4000  
#define  PORT_GPIO_15   0x8000  

// PB2
#define  PORT_SUSPEND   0x0001 
#define  PORT_SUSPEND_BAR   0x0002 
#define  PORT_DTR2      0x0004 
#define  PORT_DSR2      0x0008 

// PB3
#define  PORT_TX2       0x0001 
#define  PORT_RX2       0x0002 
#define  PORT_RTS2      0x0004 
#define  PORT_CTS2      0x0008 
#define  PORT_DCD2      0x0010 
#define  PORT_RI2       0x0020 
#define  PORT_DTR3      0x0040 
#define  PORT_DSR3      0x0080 
#define  PORT_DCD3      0x0100 
#define  PORT_RI3       0x0200 

// PB4
#define  PORT_RTS3      0x0001 
#define  PORT_CTS3      0x0002 
#define  PORT_TX3       0x0004 
#define  PORT_RX3       0x0008 

//
#define EF_IFC_GPIO_TXLED   0x01 
#define EF_IFC_GPIO_RXLED   0x02 
#define EF_IFC_GPIO_RS485   0x04 
// If the next bit is clear, GPIO1 is low while sending UART data.
// If it is set, GPIO1 is high while sending UART data, and low otherwise
#define EF_IFC_GPIO_RS485_LOGIC 0x08 
#define EF_IFC_GPIO_CLOCK       0x10 
#define EF_IFC_DYNAMIC_SUSPEND  0x40 

//
#define EF_DEVICE_WEAKPULLUP_RESET      0x10 
#define EF_DEVICE_WEAKPULLUP_SUSPEND    0x20 
#define EF_DEVICE_DYNAMIC_SUSPEND       0x40 


typedef struct _firmware_t  {
    uint8_t major; 
    uint8_t minor; 
    uint8_t build; 
} firmware_t, *pFirmware_t;
//
//
#ifdef __cplusplus
extern "C" {
#endif

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetNumDevices(
    _Out_writes_bytes_(sizeof(uint32_t)) _Pre_defensive_ uint32_t *lpdwNumDevices
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetProductString(
    _In_ _Pre_defensive_ const uint32_t dwDeviceIndex,
    _Out_writes_z_(CP210x_MAX_DEVICE_STRLEN) _Pre_defensive_ void * lpvProductString,
    _In_ _Pre_defensive_ const uint32_t dwFlags
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetProductStringSafe(
    _In_ _Pre_defensive_ const uint32_t dwDeviceIndex,
    _In_ _Pre_defensive_ const CP210X_GETPRODUCTSTRING WhichProductStringToReturn,
    _Out_writes_z_(sizeof(wchar_t) * ProductStringLenInBytes) _Pre_defensive_ wchar_t *pProductString,
    _In_ _Pre_defensive_ const size_t ProductStringLenInBytes);


_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_Open(
    _In_ _Pre_defensive_ const uint32_t DeviceIndex,
    _Out_writes_bytes_(sizeof(HANDLE)) _Pre_defensive_ PHANDLE pcyHandle
    ); 

_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_Close(
    _In_ _Pre_defensive_ const HANDLE cyHandle
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetPartNumber(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(uint8_t)) _Pre_defensive_ uint8_t *lpbPartNum
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetVid(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const uint16_t Vid
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetPid(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const uint16_t Pid
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetManufacturerString(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ void *lpvManufacturerString,
    _In_ _Pre_defensive_ const uint8_t bManufacturerStringLength,
    _In_ _Pre_defensive_ const BOOL bIsStringASCII = TRUE
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetProductString(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ void * lpvProductString,
    _In_ _Pre_defensive_ const uint8_t bProductStringLength,
    _In_ _Pre_defensive_ const BOOL bIsStringASCII = TRUE
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetInterfaceString(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const uint8_t bInterfaceNumber,
    _In_ _Pre_defensive_ void * lpvInterfaceString,
    _In_ _Pre_defensive_ const uint8_t bInterfaceStringLength,
    _In_ _Pre_defensive_ const BOOL bIsStringASCII
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetSerialNumber(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ void *lpvSerialNumberString,
    _In_ _Pre_defensive_ const uint8_t bSerialNumberStringLength,
    _In_ _Pre_defensive_ const BOOL bIsStringASCII = TRUE
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetSelfPower(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const BOOL bSelfPower
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetMaxPower(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const uint8_t bMaxPower
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetFlushBufferConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const uint16_t wFlushBufferConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetDeviceMode(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const uint8_t bDeviceModeECI,
    _In_ _Pre_defensive_ const uint8_t bDeviceModeSCI
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetDeviceVersion(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const uint16_t wVersion
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetBaudRateConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_reads_bytes_(sizeof(BAUD_CONFIG)) _Pre_defensive_ PBAUD_CONFIG pBaudConfig
    );

void _ConfigLatchRS485(BYTE partNum, PORT_CONFIG * PortConfig, uint16_t & Temp_Reset_Latch, uint16_t & Temp_Suspend_Latch);

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetPortConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ PORT_CONFIG *pPortConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetDualPortConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ DUAL_PORT_CONFIG *pDualPortConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetQuadPortConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ QUAD_PORT_CONFIG *pQuadPortConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetLockValue(
    _In_ _Pre_defensive_ const HANDLE cyHandle
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDeviceVid(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(uint16_t)) _Pre_defensive_ uint16_t *lpwVid
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDevicePid(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(uint16_t)) _Pre_defensive_ uint16_t *lpwPid
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDeviceManufacturerString(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(*lpbManufacturerStringLengthInBytes) _Pre_defensive_ void *pManufacturerString,
    _Out_writes_bytes_(1) _Pre_defensive_ uint8_t   *lpbManufacturerStringLengthInBytes,
    _In_ _Pre_defensive_ const BOOL bConvertToASCII = FALSE
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDeviceProductString(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(*lpbProductStringLengthInBytes) _Pre_defensive_ void *pProductString,
    _Out_writes_bytes_(1) _Pre_defensive_ uint8_t *lpbProductStringLengthInBytes,
    _In_ _Pre_defensive_ const BOOL bConvertToASCII = FALSE
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDeviceInterfaceString(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ _Pre_defensive_ const uint8_t bInterfaceNumber,
    _Out_writes_bytes_(*lpbInterfaceStringLengthInBytes) _Pre_defensive_ void *pInterfaceString,
    _Out_writes_bytes_(1) _Pre_defensive_ uint8_t *lpbInterfaceStringLengthInBytes,
    _In_ _Pre_defensive_ const BOOL bConvertToASCII = FALSE
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDeviceSerialNumber(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(*lpbSerialNumberStringLengthInBytes) _Pre_defensive_ void *pSerialNumberString,
    _Out_writes_bytes_(1) _Pre_defensive_ uint8_t *lpbSerialNumberStringLengthInBytes,
    _In_ _Pre_defensive_ const BOOL bConvertToASCII = FALSE
    );


#if ! defined(_WIN32)
_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDeviceAddress(
  _In_ _Pre_defensive_ const HANDLE cyHandle,
    uint8_t *lpbAddress);
#endif // ! defined(_WIN32)

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetSelfPower(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(BOOL)) _Pre_defensive_ LPBOOL lpbSelfPower
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetMaxPower(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(uint8_t)) _Pre_defensive_ uint8_t *lpbPower
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetFlushBufferConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(uint16_t)) _Pre_defensive_ uint16_t *lpwFlushBufferConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDeviceMode(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(uint8_t)) _Pre_defensive_ uint8_t *lpbDeviceModeECI,
    _Out_writes_bytes_(sizeof(uint8_t)) _Pre_defensive_ uint8_t *lpbDeviceModeSCI
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDeviceVersion(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(uint16_t)) _Pre_defensive_ uint16_t *lpwVersion
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetBaudRateConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(BAUD_CONFIG)) _Pre_defensive_ PBAUD_CONFIG pBaudConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetPortConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(PORT_CONFIG)) _Pre_defensive_ PPORT_CONFIG pPortConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetDualPortConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(DUAL_PORT_CONFIG)) _Pre_defensive_ DUAL_PORT_CONFIG* pDualPortConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetQuadPortConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(QUAD_PORT_CONFIG)) _Pre_defensive_ QUAD_PORT_CONFIG* pQuadPortConfig
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetLockValue(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(uint8_t)) _Pre_defensive_ uint8_t *lpbLockValue
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_Reset(
    _In_ _Pre_defensive_ const HANDLE cyHandle
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_CreateHexFile(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_ LPCSTR lpvFileName
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetFirmwareVersion(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(sizeof(firmware_t)) _Pre_defensive_ pFirmware_t lpVersion
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(bLength) _Pre_defensive_ uint8_t *lpbConfig,
    _In_ _Pre_defensive_ const uint16_t bLength
);

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetConfig(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_reads_bytes_(bLength) _Pre_defensive_ uint8_t *lpbConfig,
    _In_ _Pre_defensive_ const uint16_t bLength
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_UpdateFirmware(
    _In_ _Pre_defensive_ const HANDLE cyHandle);

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_GetGeneric(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _Out_writes_bytes_(bLength) _Pre_defensive_ uint8_t *lpbGeneric,
    _In_ _Pre_defensive_ const uint16_t bLength
    );

_Check_return_
_Ret_range_(CP210x_SUCCESS, CP210x_DEVICE_NOT_FOUND)
_Success_(return == CP210x_SUCCESS)
CP210xDLL_API CP210x_STATUS WINAPI
CP210x_SetGeneric(
    _In_ _Pre_defensive_ const HANDLE cyHandle,
    _In_reads_bytes_(bLength) _Pre_defensive_ uint8_t *lpbGeneric,
    _In_ _Pre_defensive_ const uint16_t bLength
    );

#ifdef __cplusplus
}
#endif


#endif  // !HOST_LIB_MANUFACTURING_INCLUDE_CP210XMANUFACTURINGDLL_H_INCLUDED_XF3N9QM3BK