![]() |
tcio
|
Functions | |
DLL_RESULT | TC42GetFirmwareVersionIBC (unsigned short *pVersion) |
Get firmware version of IBC board (e.g. 123 means V1.23) Reads zero if device is not a GSS device. | |
DLL_RESULT | TC42GetFirmwareVersionPLD (unsigned short *pVersionPLD) |
Read out the PLD version. | |
DLL_RESULT | TC42GetIsGSSDevice (unsigned short *pEnabled) |
Get info if device is a GSS device or not. | |
DLL_RESULT | TC42GetIsGSSDeviceReady (unsigned short *pReady) |
Get info if device is a GSS device and internal communication to IBC board (needed for Q4 operation) is ok. | |
DLL_RESULT | TC42GetIsSupportedQ4VoltageUserLimit (unsigned short *pIsSupported) |
Query if Q4 voltage user limit is supported. | |
DLL_RESULT | TC42GetOperatingHoursAtVoltageOn (float *pOperatingHoursAtVoltageOn) |
Get operating hours the device was voltage-on. | |
DLL_RESULT | TC4GetAdditionalPhysicalValues (int *pDCLinkPhysNom, int *pPrimaryCurrentPhysNom, int *pTemperaturePhysNom) |
get the standardised physical values from the TopCon module. This is not the same as the physical limit max values from module. | |
DLL_RESULT | TC4GetDevicePhysicalMinValues (int *pVPhysMin, int *pIPhysMin, int *pPPhysMin) |
Gets the physical min values from module. | |
DLL_RESULT | TC4GetDeviceVersion (unsigned int *pMain, unsigned int *pSub, unsigned int *pRevision) |
This function returns the firmware version of the MainDSP. All API-functions beginning with "TC4..." require *pmain to be 4 or 11 A main Version of 11 indicates a client specific software based upon V4.x. | |
DLL_RESULT | TC4GetIsSupportedQ1Q4LimitMode (unsigned short *pIsSupported) |
Query if limiting operating mode to Q1only and Q4only is supported. | |
DLL_RESULT | TC4GetIsSupportedQ4CurrentSinkActiveQuery (unsigned short *pIsSupported) |
Query if Q4 current sink is supported. | |
DLL_RESULT | TC4GetIsSupportedQ4UserLimits (unsigned short *pIsSupported) |
Query if Q4 user limits are supported. | |
DLL_RESULT | TC4GetIsSupportedVoltageOnHoursCounter (unsigned short *pIsSupported) |
Query if voltage on hours counter is supported. | |
DLL_RESULT | TC4GetModuleID (unsigned int *pModuleId) |
Reads the ModuleID which is set by the ID-selector (AH and AL) on the front panel of each module. The ModuleID is calculated as follows: ModuleID = (16*AH) + AL. | |
DLL_RESULT | TC4GetModulePhysicalLimitMax (double *pVoltagePhysMax, double *pCurrentPhysMax, double *pPowerPhysMax, double *pResistancePhysMax) |
Gets the physical max values from module. | |
DLL_RESULT | TC4GetModulePhysicalLimitMin (double *pVoltagePhysMin, double *pCurrentPhysMin, double *pPowerPhysMin, double *pResistancePhysMin) |
Gets the physical min values from module. | |
DLL_RESULT | TC4GetModulePhysicalLimitNom (double *pVoltagePhysNom, double *pCurrentPhysNom, double *pPowerPhysNom, double *pResistancePhysNom) |
Gets the physical nominal values from module. These are the same values as from TC4GetModulePhysicalValues but from cache | |
DLL_RESULT | TC4GetModulePhysicalValues (int *pVoltagePhysNom, int *pCurrentPhysNom, int *pPowerPhysNom, int *pResistancePhysNom) |
get the standardised physical values from the TopCon module. This is not the same as the physical limit max values from module. | |
DLL_RESULT | TC4GetPeripherieVersion (unsigned int *pVersionPeripherieDSP, unsigned int *pVersionModulatorDSP, unsigned int *pVersionBootloader) |
This function returns software versions of two auxiliary DSP's and the bootloader version for the MainDSP. | |
DLL_RESULT | TC4GetPhysicalValues (int *pVoltagePhysNom, int *pCurrentPhysNom, int *pPowerPhysNom, int *pResistancePhysNom, int *pDCLinkPhysNom, int *pPrimaryCurrentPhysNom, int *pTemperaturePhysNom) |
get the standardised physical values from the TopCon module. This is not the same as the physical limit max values from module. | |
DLL_RESULT | TC4GetPhysicalValuesLimits (double *pVLimitMod, double *pILimitMod, double *pPLimitMod, double *pRLimitMod, double *pVLimitSys, double *pILimitSys, double *pPLimitSys, double *pRLimitSys) |
This function is used in multi-unit operation to translate between standardised system-values and physical system-values. Only use this function on a TopCon Master (a TopCon Slave will return false results) | |
DLL_RESULT | TC4GetSerialNrString (unsigned short sizeInBytes, char *pSerialNr) |
This function reads serial number string of device. | |
DLL_RESULT | TC4GetSystemPhysicalLimitMax (double *pVoltagePhysMax, double *pCurrentPhysMax, double *pPowerPhysMax, double *pResistancePhysMax) |
Gets the physical maximal values from system. | |
DLL_RESULT | TC4GetSystemPhysicalLimitMin (double *pVoltagePhysMin, double *pCurrentPhysMin, double *pPowerPhysMin, double *pResistancePhysMin) |
Gets the physical minimal values from system. | |
DLL_RESULT | TC4GetSystemPhysicalLimitNom (double *pVoltagePhysNom, double *pCurrentPhysNom, double *pPowerPhysNom, double *pResistancePhysNom) |
Gets the physical nominal values from system. These are the same values as from TC4GetSystemPhysicalValues but from cache | |
DLL_RESULT | TC4GetSystemPhysicalMinValues (int *pVPhysMin, int *pIPhysmin, int *pPPhysMin) |
Gets the physical min values from system. | |
DLL_RESULT | TC4GetSystemPhysicalValues (int *pVoltagePhysNom, int *pCurrentPhysNom, int *pPowerPhysNom, int *pResistancePhysNom) |
This function is used in multi-unit operation to translate between standardised system-values and physical system-values. Only use this function on a TopCon Master (a TopCon Slave will return false results) This is not the same as the physical limit max values from system. |
This group contains e.g. physical device limits, firmware versions, installed options and so on.
DLL_RESULT TC42GetFirmwareVersionIBC | ( | unsigned short * | pVersion | ) |
Get firmware version of IBC board (e.g. 123 means V1.23)
Reads zero if device is not a GSS device.
[out] | pVersion | Version of IBC |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC42GetFirmwareVersionPLD | ( | unsigned short * | pVersionPLD | ) |
Read out the PLD version.
[out] | pVersionPLD,: | PLD version (e.g. 123 means V1.23) |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC42GetIsGSSDevice | ( | unsigned short * | pEnabled | ) |
Get info if device is a GSS device or not.
[out] | pEnabled | 1: Enabled 0: Disabled |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC42GetIsGSSDeviceReady | ( | unsigned short * | pReady | ) |
Get info if device is a GSS device and internal communication to IBC board (needed for Q4 operation) is ok.
[out] | pReady | 1: Enabled 0: Disabled |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC42GetIsSupportedQ4VoltageUserLimit | ( | unsigned short * | pIsSupported | ) |
Query if Q4 voltage user limit is supported.
[out] | pIsSupported | 0: false 1: true |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC42GetOperatingHoursAtVoltageOn | ( | float * | pOperatingHoursAtVoltageOn | ) |
Get operating hours the device was voltage-on.
[out] | pOperatingHoursAtVoltageOn | voltage-on operating hours [0...596523h] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetAdditionalPhysicalValues | ( | int * | pDCLinkPhysNom, |
int * | pPrimaryCurrentPhysNom, | ||
int * | pTemperaturePhysNom | ||
) |
get the standardised physical values from the TopCon module. This is not the same as the physical limit max values from module.
[out] | pDCLinkPhysNom | standardised voltageDCLink [V] |
[out] | pPrimaryCurrentPhysNom | standardised primaryCurrent [A] |
[out] | pTemperaturePhysNom | standardised temperature [°C] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetDevicePhysicalMinValues | ( | int * | pVPhysMin, |
int * | pIPhysMin, | ||
int * | pPPhysMin | ||
) |
Gets the physical min values from module.
[out] | pVPhysMin | PhysicalMinVoltage [V] |
[out] | pIPhysMin | PhysicalMinCurrent [A] |
[out] | pPPhysMin | PhysicalMinPower [kW] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetDeviceVersion | ( | unsigned int * | pMain, |
unsigned int * | pSub, | ||
unsigned int * | pRevision | ||
) |
This function returns the firmware version of the MainDSP. All API-functions beginning with "TC4..." require *pmain to be 4 or 11 A main Version of 11 indicates a client specific software based upon V4.x.
[out] | pMain | Firmware main version |
[out] | pSub | Firmware sub version |
[out] | pRevision | Firmware revision |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetIsSupportedQ1Q4LimitMode | ( | unsigned short * | pIsSupported | ) |
Query if limiting operating mode to Q1only and Q4only is supported.
[out] | pIsSupported | 0: false 1: true |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetIsSupportedQ4CurrentSinkActiveQuery | ( | unsigned short * | pIsSupported | ) |
Query if Q4 current sink is supported.
[out] | pIsSupported | 0: false 1: true |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetIsSupportedQ4UserLimits | ( | unsigned short * | pIsSupported | ) |
Query if Q4 user limits are supported.
[out] | pIsSupported | 0: false 1: true |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetIsSupportedVoltageOnHoursCounter | ( | unsigned short * | pIsSupported | ) |
Query if voltage on hours counter is supported.
[out] | pIsSupported | 0: false 1: true |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetModuleID | ( | unsigned int * | pModuleId | ) |
Reads the ModuleID which is set by the ID-selector (AH and AL) on the front panel of each module.
The ModuleID is calculated as follows: ModuleID = (16*AH) + AL.
*pModuleId | Module ID |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetModulePhysicalLimitMax | ( | double * | pVoltagePhysMax, |
double * | pCurrentPhysMax, | ||
double * | pPowerPhysMax, | ||
double * | pResistancePhysMax | ||
) |
Gets the physical max values from module.
[out] | pVoltagePhysMax | [V] |
[out] | pCurrentPhysMax | [A] |
[out] | pPowerPhysMax | [kW] |
[out] | pResistancePhysMax | [mOhm] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetModulePhysicalLimitMin | ( | double * | pVoltagePhysMin, |
double * | pCurrentPhysMin, | ||
double * | pPowerPhysMin, | ||
double * | pResistancePhysMin | ||
) |
Gets the physical min values from module.
[out] | pVoltagePhysMin | [V] |
[out] | pCurrentPhysMin | [A] |
[out] | pPowerPhysMin | [kW] |
[out] | pResistancePhysMin | [mOhm] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetModulePhysicalLimitNom | ( | double * | pVoltagePhysNom, |
double * | pCurrentPhysNom, | ||
double * | pPowerPhysNom, | ||
double * | pResistancePhysNom | ||
) |
Gets the physical nominal values from module. These are the same values as from TC4GetModulePhysicalValues but from cache
[out] | pVoltagePhysNom | [V] |
[out] | pCurrentPhysNom | [A] |
[out] | pPowerPhysNom | [kW] |
[out] | pResistancePhysNom | [mOhm] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetModulePhysicalValues | ( | int * | pVoltagePhysNom, |
int * | pCurrentPhysNom, | ||
int * | pPowerPhysNom, | ||
int * | pResistancePhysNom | ||
) |
get the standardised physical values from the TopCon module. This is not the same as the physical limit max values from module.
[out] | pVoltagePhysNom | standardised module voltage [V] |
[out] | pCurrentPhysNom | standardised module current [A] |
[out] | pPowerPhysNom | standardised module power [kW] |
[out] | pResistancePhysNom | standardised simulated module resistance [mOhm] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetPeripherieVersion | ( | unsigned int * | pVersionPeripherieDSP, |
unsigned int * | pVersionModulatorDSP, | ||
unsigned int * | pVersionBootloader | ||
) |
This function returns software versions of two auxiliary DSP's and the bootloader version for the MainDSP.
[out] | pVersionPeripherieDSP | Software version of peripherie-DSP (e.g. 10, read as 0.10) |
[out] | pVersionModulatorDSP | Software version of modulator-DSP (e.g. 23, read as 0.23) |
[out] | pVersionBootloader | Bootloader version for theMainDSP (e.g. 4, read as 0.04) |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetPhysicalValues | ( | int * | pVoltagePhysNom, |
int * | pCurrentPhysNom, | ||
int * | pPowerPhysNom, | ||
int * | pResistancePhysNom, | ||
int * | pDCLinkPhysNom, | ||
int * | pPrimaryCurrentPhysNom, | ||
int * | pTemperaturePhysNom | ||
) |
get the standardised physical values from the TopCon module. This is not the same as the physical limit max values from module.
[out] | pVoltagePhysNom | standardised module voltage [V] |
[out] | pCurrentPhysNom | standardised module current [A] |
[out] | pPowerPhysNom | standardised module power [kW] |
[out] | pResistancePhysNom | standardised simulated module resistance [mOhm] |
[out] | pDCLinkPhysNom | standardised voltageDCLink [V] |
[out] | pPrimaryCurrentPhysNom | standardised primaryCurrent [A] |
[out] | pTemperaturePhysNom | standardised temperature [°C] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetPhysicalValuesLimits | ( | double * | pVLimitMod, |
double * | pILimitMod, | ||
double * | pPLimitMod, | ||
double * | pRLimitMod, | ||
double * | pVLimitSys, | ||
double * | pILimitSys, | ||
double * | pPLimitSys, | ||
double * | pRLimitSys | ||
) |
This function is used in multi-unit operation to translate between standardised system-values and physical system-values. Only use this function on a TopCon Master (a TopCon Slave will return false results)
[out] | pVLimitMod | Nominal output voltage [V] of that module |
[out] | pILimitMod | Maximum output current [A] of that module |
[out] | pPLimitMod | Nominal output power [kW] of that module |
[out] | pRLimitMod | Nominal simulated resistance [mOhm] of that module |
[out] | pVLimitSys | Nominal output voltage [V] of the whole system |
[out] | pILimitSys | Maximum output current [A]of the whole system |
[out] | pPLimitSys | Nominal output power [kW] of the whole system |
[out] | pRLimitSys | Nominal simulated resistance [mOhm] of the whole system. |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetSerialNrString | ( | unsigned short | sizeInBytes, |
char * | pSerialNr | ||
) |
This function reads serial number string of device.
[in] | sizeInBytes | size of string [byte] The string must have a minimum size of 10 bytes, otherwise the dll returns an error. |
[out] | pSerialNr | the requested serial number string |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetSystemPhysicalLimitMax | ( | double * | pVoltagePhysMax, |
double * | pCurrentPhysMax, | ||
double * | pPowerPhysMax, | ||
double * | pResistancePhysMax | ||
) |
Gets the physical maximal values from system.
[out] | pVoltagePhysMax | [V] |
[out] | pCurrentPhysMax | [A] |
[out] | pPowerPhysMax | [kW] |
[out] | pResistancePhysMax | [mOhm] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetSystemPhysicalLimitMin | ( | double * | pVoltagePhysMin, |
double * | pCurrentPhysMin, | ||
double * | pPowerPhysMin, | ||
double * | pResistancePhysMin | ||
) |
Gets the physical minimal values from system.
[out] | pVoltagePhysMin | [V] |
[out] | pCurrentPhysMin | [A] |
[out] | pPowerPhysMin | [kW] |
[out] | pResistancePhysMin | [mOhm] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetSystemPhysicalLimitNom | ( | double * | pVoltagePhysNom, |
double * | pCurrentPhysNom, | ||
double * | pPowerPhysNom, | ||
double * | pResistancePhysNom | ||
) |
Gets the physical nominal values from system. These are the same values as from TC4GetSystemPhysicalValues but from cache
[out] | pVoltagePhysNom | standardised module voltage [V] |
[out] | pCurrentPhysNom | standardised module current [A] |
[out] | pPowerPhysNom | standardised module power [kW] |
[out] | pResistancePhysNom | standardised simulated module resistance [mOhm] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetSystemPhysicalMinValues | ( | int * | pVPhysMin, |
int * | pIPhysmin, | ||
int * | pPPhysMin | ||
) |
Gets the physical min values from system.
[out] | pVPhysMin | PhysicalMinVoltage [V] |
[out] | pIPhysmin | PhysicalMinCurrent [A] |
[out] | pPPhysMin | PhysicalMinPower [kW] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4GetSystemPhysicalValues | ( | int * | pVoltagePhysNom, |
int * | pCurrentPhysNom, | ||
int * | pPowerPhysNom, | ||
int * | pResistancePhysNom | ||
) |
This function is used in multi-unit operation to translate between standardised system-values and physical system-values. Only use this function on a TopCon Master (a TopCon Slave will return false results) This is not the same as the physical limit max values from system.
[out] | pVoltagePhysNom | standardised system voltage [V] |
[out] | pCurrentPhysNom | standardised system current[A] |
[out] | pPowerPhysNom | standardised system power [kW] |
[out] | pResistancePhysNom | standardised simulated system resistance [mOhm] |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs