Other > Hardware Status

<< Click to Display Table of Contents >

Client Control Interface Manual > Other > Hardware Status

Hardware Status

Previous page

Return to chapter overview

Next page

•Hardware State

•Last Message Input

•SCAPS Dongle ID

•USC Firmware Status

•USC Server Status

Hardware State			☐ Set ☒ Get
DLL Function	int State = ScGetLongValue(int Value_Type)
ASCII Function	int State = ScCciGetLongValue(int Value_Type)
Description	Get the hardware state of the current selected head.
Value_Type	Type: int
	Location: ScComSAMLightClientCtrlValueTypes
	scComSAMLightClientCtrlLongValueTypeHardwareState		41
State	Type: int	Unit: none
State	•0: Error. •2: OK.
CCI_Return	Type: int
CCI_Return	CCI return number, see error list.
Notes	-
C# Example: Get hardware state int State = cci.ScGetLongValue((int)ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlLongValueTypeHardwareState);

Table 340: Hardware State

Last Message Input			☐ Set ☒ Get
DLL Function	int CCI_Return = ScGetStringValue(int Value_Type, ref string Last_Message_Input)
ASCII Function	string Last_Message_Input = ScCciGetStringValue(int Value_Type)
Description	Get last message input that is still active.
Value_Type	Type: int		ID:
	Location: ScComSAMLightClientCtrlValueTypes
	scComSAMLightClientCtrlStringValueTypeGetLastErrorMessageInput		14
	Error message input.
	scComSAMLightClientCtrlStringValueTypeGetLastInfoMessageInput		15
	Info message input.
Last_Message_Input	Type: string	Unit: none
Last_Message_Input	The corresponding last message input.
CCI_Return	Type: int
CCI_Return	CCI return number, see error list.
Notes	-
C# Example: Get last message input: string Last_Message_Input = ""; int CCI_Return = cci.ScGetStringValue( ( int )ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlStringValueTypeGetLastErrorMessageInput, ref Last_Message_Input );

Table 341: Last Message Input

License			☐ Set ☒ Get
DLL Function	int CCI_Return = ScGetStringValue(int Value_Type, ref string License)
ASCII Function	string License = ScCciGetStringValue(int Value_Type)
Description	Get the active license from USB dongle and USC card.
Value_Type	Type: int
	Location: ScComSAMLightClientCtrlValueTypes
	scComSAMLightClientCtrlStringValueTypeLicenseAsString		40
License	Type: string	Unit: none
License	The active license from USB dongle and USC card. Example string: "USB license: None, USC license: SAMLight + MOTF"
CCI_Return	Type: int
CCI_Return	CCI return number, see error list.
Notes	-
C# Example: Get current license information: string License = ""; int CCI_Return = cci.ScGetStringValue( ( int )ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlStringValueTypeLicenseAsString, ref License );

Table 342: License

SCAPS Dongle ID			☐ Set ☒ Get
DLL Function	int Dongle_ID = ScGetLongValue(int Value_Type)
ASCII Function	int Dongle_ID = ScCciGetLongValue(int Value_Type)
Description	Get customer or dongle ID.
Value_Type	Type: int		ID:
	Location: ScComSAMLightClientCtrlValueTypes
	scComSAMLightClientCtrlLongValueTypeDongleUserNumber		39
	Customer ID (aka user number or user ID)
	scComSAMLightClientCtrlLongValueTypeDongleSystemNumber		40
	Dongle ID (aka system number, system ID or card ID)
Dongle_ID	Type: int	Unit: none
Dongle_ID	Get the required dongle ID
CCI_Return	Type: int
CCI_Return	CCI return number, see error list.
Notes	•If a combination of USB-Dongle and Card is used, the USB-Dongle is shown.
C# Example: Get current SCAPS dongle ID: int Dongle_ID = cci.ScGetLongValue( ( int )ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlLongValueTypeDongleSystemNumber );

Table 343: SCAPS Dongle ID

USC Firmware Status			☐ Set ☒ Get
DLL Function	int Firmware_Status = ScGetLongValue(int Value_Type)
ASCII Function	int Firmware_Status = ScCciGetLongValue(int Value_Type)
Description	Get the status of the USC firmware.
Value_Type	Type: int		ID:
	Location: ScComSAMLightClientCtrlValueTypes
	scComSAMLightClientCtrlLongValueTypeFirmwareStatus		123
Firmware_Status	Type: int	Unit: none
Firmware_Status	•< 0: Firmware on the USC card is newer than the software version. •= 0: Firmware on the USC card is up to date. •> 0: A newer firmware is available.
CCI Return	Type: int
CCI Return	CCI return number, see error list.
Notes	•This command is only for USC-2 and USC-3 cards.
C# Example: Get current USC firmware status: int Firmware_Status = cci.ScGetLongValue( ( int )ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlLongValueTypeFirmwareStatus );

Table 344: USC Firmware Status

USC Server Status		☐ Set ☒ Get
DLL Function	int Server_Status = ScGetLongValue(int Value_Type)
ASCII Function	int Server_Status = ScCciGetLongValue(int Value_Type)
Description	Get the status of the usc server.
Value_Type	Type: int	ID:
	Location: ScComSAMLightClientCtrlValueTypes
	scComSAMLightClientCtrlLongValueTypeServerStatus	67
Server_Status	Type: int	Flag:
	Location: None
	Device Connected	0x1
	Device OK	0x2
	Device Missing	0x8
	Device USC-1	0x10000
	Device USC-2	0x20000
	Device USC-3	0x80000
CCI_Return	Type: int
CCI_Return	CCI return number, see error list.
Notes	•The flags can be combined by using logical operators. Please refer to the chapter How to work with Flags for more information. •There are further undocumented flags for internal use only.
C# Example: Get current USC server status: int Server_Status = cci.ScGetLongValue( ( int )ScComSAMLightClientCtrlValueTypes.scComSAMLightClientCtrlLongValueTypeServerStatus );

Table 345: USC Server Status