P.I. Engineering SDK Documentation

PIEDevice.DongleCheck2()

Syntax

C#

Visual Basic (Declaration)

Visual Basic (Usage)

Examples

C#

private void BtnCheckKey_Click(object sender, EventArgs e)
{
	//This is done within the developer's application to check for the correct
	//hardware.  The K0-K3 values must be the same as those entered in Set Key.
           
 	LblPassFail.Text = "Pass/Fail";
 	//check hardware

	//IMPORTANT turn off the callback if going so data isn't grabbed there, turn it back on later (not done here)
	devices[selecteddevice].callNever = true;

 	//randomn numbers
 	Random rnd = new Random();
	int N0 = rnd.Next(1, 254); //pick any number between 1 and 254, 0 and 255 not allowed
	int N1 = rnd.Next(1, 254); //pick any number between 1 and 254, 0 and 255 not allowed
	int N2 = rnd.Next(1, 254); //pick any number between 1 and 254, 0 and 255 not allowed
	int N3 = rnd.Next(1, 254); //pick any number between 1 and 254, 0 and 255 not allowed

	//this is the key used in the Set Dongle Key output report
 	int K0 = 7;
 	int K1 = 58;
 	int K2 = 33;
 	int K3 = 243;
                
 	//hash and save these for comparison later
 	int R0;
 	int R1;
 	int R2;
 	int R3;
 	PIEDevice.DongleCheck2(K0, K1, K2, K3, N0, N1, N2, N3, out R0, out R1, out R2, out R3);
	
	for (int j = 0; j < devices[selecteddevice].WriteLength; j++)
	{
		wData[j] = 0;
	}
 	wData[0] = 0;
 	wData[1] = 193; //Check Dongle Key command
 	wData[2] = (byte)N0;
 	wData[3] = (byte)N1;
 	wData[4] = (byte)N2;
 	wData[5] = (byte)N3;
 	          
 	int result = devices[selecteddevice].WriteData(wData);
	if (result != 0)
 	{
 		toolStripStatusLabel1.Text = "Write Fail: " + result;
 	}
 	else
 	{
 		toolStripStatusLabel1.Text = "Write Success-Check Dongle Key";
 	}
	//after this write the next read with the 3rd byte=193 will give 4 values which are used below for comparison        
  
 	byte[] data =null;
 	int countout = 0;
 	int ret = devices[selecteddevice].BlockingReadData(ref data, 100);
	while ((ret == 0 && data[2] != 193) || ret == 304)
 	{
 		if (ret == 304)
 		{
 			// Didn't get any data for 100ms, increment the countout extra
			countout += 100;
		}
		countout++;
		if (countout > 500) //increase this if have to check more than once
			break;
		ret = devices[selecteddevice].BlockingReadData(ref data, 100);
	}

	if (ret == 0 && data[2] == 193)
 	{
		bool fail = false;
		if (R0 != data[3]) fail = true;
		if (R1 != data[4]) fail = true;
		if (R2 != data[5]) fail = true;
		if (R3 != data[6]) fail = true;
		if (fail == false)
		{
			LblPassFail.Text = "Pass-Correct Hardware Found";
		}
		else
		{
			LblPassFail.Text = "Fail-Correct Hardward Not Found";
		}
	}        
}

Visual Basic

Private Sub BtnCheckKey_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles BtnCheckKey.Click
	'This is done within the developer's application to check for the correct
	'hardware.  The K0-K3 values must be the same as those entered in Set Key.
	
	'Check hardware


	'IMPORTANT turn off the callback if going so data isn't grabbed there, turn it back on later (not done here)
	devices(selecteddevice).callNever = True


	'pick 4 randomn numbers between 1 and 254
	Randomize()
	Dim N0 As Integer = CInt(Int((254 * Rnd()) + 1)) 'random number between 1 and 254
	Dim N1 As Integer = CInt(Int((254 * Rnd()) + 1)) 'random number between 1 and 254
	Dim N2 As Integer = CInt(Int((254 * Rnd()) + 1)) 'random number between 1 and 254
	Dim N3 As Integer = CInt(Int((254 * Rnd()) + 1)) 'random number between 1 and 254
	
	'this is the key from the Set Key
	Dim K0 As Integer = 7
	Dim K1 As Integer = 58
	Dim K2 As Integer = 33
	Dim K3 As Integer = 243


	'hash and save these for comparison later
	Dim R0 As Integer
	Dim R1 As Integer
	Dim R2 As Integer
	Dim R3 As Integer
	PIEHidDotNet.PIEDevice.DongleCheck2(K0, K1, K2, K3, N0, N1, N2, N3, R0, R1, R2, R3)
	
	For i As Integer = 0 To devices(selecteddevice).WriteLength - 1
		wdata(i) = 0
	Next
	wdata(0) = 0
	wdata(1) = 193 'Check Dongle Key command
	wdata(2) = N0
	wdata(3) = N1
	wdata(4) = N2
	wdata(5) = N3

	Dim result As Integer = devices(selecteddevice).WriteData(wdata)

	If result <> 0 Then
		LblStatus.Text = "Write Fail: " + result.ToString
	Else
		LblStatus.Text = "Write Success - Check Key"
	End If

	'after this write the next read with 3rd byte=193 will give 4 values which are used below for comparison
	Dim ddata(devices(selecteddevice).ReadLength) As Byte
	Dim countout As Integer = 0
	result = devices(selecteddevice).BlockingReadData(ddata, 100)
	While (result = 304 Or (result = 0 And ddata(2) <> 193))
		If result = 304 Then
			'no new data after 100ms, so increment countout extra
			countout = countout + 99
		End If
		countout = countout + 1
		If (countout > 1000) Then
			Exit While
		End If
		result = devices(selecteddevice).BlockingReadData(ddata, 100)
	End While

	If result = 0 And ddata(2) = 193 Then
		Dim fail As Boolean = False
		If R0 <> ddata(3) Then fail = True
		If R1 <> ddata(4) Then fail = True
		If R2 <> ddata(5) Then fail = True
		If R3 <> ddata(6) Then fail = True
		If fail = False Then LblPassFail.Text = "Pass-Correct Hardware Found"
		If fail = True Then LblPassFail.Text = "Fail-Correct Hardware Not Found"
	End If
End Sub

Unmanaged DLL

CheckDongle2 Function

Syntax

Parameters

Return Value

Example

C++


...
//This is done within the developer's application to check for the correct
//hardware.  The K0-K3 values must be the same as those entered in Set Dongle Key.
if (hDevice == -1) return TRUE;
//check hardware


//IMPORTANT turn off the callback if going so data isn't grabbed there, turn it back on later (not done here)
DisableDataCallback(hDevice, true);
			
//randomn numbers
int N0 = 3;   //pick any number between 1 and 254
int N1 = 1;   //pick any number between 1 and 254
int N2 = 4;   //pick any number between 1 and 254
int N3 = 1;   //pick any number between 1 and 254
//this is the key from set key
K0 = 7;
K1 = 58;
K2 = 33;
K3 = 243;
//hash and save these for comparison later
int R0;
int R1;
int R2;
int R3;
DongleCheck2(K0, K1, K2, K3, N0, N1, N2, N3, R0, R1, R2, R3);


for (i=0;i<36;i++)
{
	buffer[i]=0;

}
buffer[0]=0;
buffer[1]=193;  //0xc1 check dongle key command
buffer[2]=N0;
buffer[3]=N1;
buffer[4]=N2;
buffer[5]=N3;

result = WriteData(hDevice, buffer);
//after this write the next read beginning with byte 1=3 will give 4 values which are used below for comparison
for (int i=0;i<80;i++)
{buffer[i]=0;}
int countout=0;
int result = BlockingReadData(hDevice, buffer, 100);
			
while (result == 304 || (result == 0 && buffer[2] != 193))
{
	if (result == 304)
	{
		// No data received after 100ms, so increment countout extra
		countout += 99;
	}
	countout++;
	if (countout > 1000) //increase this if have to check more than once
	break;
	result = BlockingReadData(hDevice, buffer, 100);
}
if (result ==0 && buffer[2]==193)
{
	bool fail=false;
	if (R0!=buffer[3]) fail=true;
	if (R1!=buffer[4]) fail=true;
	if (R2!=buffer[5]) fail=true;
	if (R3!=buffer[6]) fail=true;			
}		

Remarks

Function Information