Applies To:
  • CitectSCADA
  • CIKT Driver v2.02.08.000 onwards

Summary:
v2.02.08.000 onwards of CIKT includes additional logging of the installation procedure, how does this work? 

Solution:
In v2.02.08.000 of the CIKT driver, and above, additional logging of the installation process has been configured.

This logging is best enabled by setting the following INI parameters, and the results of these logs are saved to the CIKT.dat in the Windows

[CIKT]
Debug=1
[GENERAL]
ShowDriverErr=1

Format of the logging:

The logs are mainly meant to be analyzed by Support, however they can be useful to the End-User.

They provide information about each step of the installation process, and you should be able to determine where an error is occurring, or if a particular step is repeating and not progressing.

As you should know, the CIKT installation procedure requires CitectSCADA to be restarted 3 times, before the card can initialise. The logging of this 'standard' scenario should look like this.

Step 1: After just installing the CIKT driver (which installs WinRT), and running Citect without an initial reboot, you will most likely get something similar to the following:
--------------------------------------------------------------------------------
* 'Net Start WinRT' Failed = ERROR_FILE_NOT_FOUND - Retry No: 0
* Invalid Handle Value, after 1 retries. Returning Memory Address: 0
***TRY RESTARTING YOUR PC***
* Ended Early, never checked for Vendor ID.
* 'Net Start WinRT' Failed = ERROR_FILE_NOT_FOUND - Retry No: 0
* Invalid Handle Value, after 1 retries. Returning Memory Address: 0
***TRY RESTARTING YOUR PC***
* Result of InitCard:
-Error: 1
-Board Number: 0
-Memory Address: 0
-Node Address: 63
-IRQ: 0
-IsKTX: 1
-BoardType: 1
-Board ID: 15
-Board Index: 0
-Board Name: BOARD1
-Board Used: 0
-Board Initialized: 0
--------------------------------------------------------------------------------
The logs show that WinRT failed to start, hence the driver never looked for the CIKT card, hence couldnt return the memory address and couldn't initialise the card.
This is because the PC needs to be rebooted after WinRT is first installed.

Step 2: After a restart of the PC, and starting Citect SCADA back up again, the following will be appended to the previous log:
--------------------------------------------------------------------------------
* Successful Vendor ID Match. Device ID Match?:1
* Result of InitCard:
-Error: 1
-Board Number: 0
-Memory Address: fc500000
-Node Address: 63
-IRQ: 0
-IsKTX: 1
-BoardType: 1
-Board ID: 15
-Board Index: 0
-Board Name: BOARD1
-Board Used: 0
-Board Initialized: 0
*** CARD SHOULD COME ONLINE NEXT RESTART OF CITECT ***
--------------------------------------------------------------------------------
This shows no errors with starting WinRT, and it shows the Memory Address has been returned (you can check that this address is correct via Device Manager).

The driver has still not finished installing this time, since Error is still 1, and the 'Board Used' and 'Board Initialised' are still 0.
The CIKT driver has now written these settings to the Registry, and should be able to function properly on the next restart of Citect.

Step 3: After restarting Citect, the Card will initialise and come online:
--------------------------------------------------------------------------------
* Successful Vendor ID Match. Device ID Match?:1
* Result of InitCard:
-Error: 0
-Board Number: 0
-Memory Address: fc500000
-Node Address: 63
-IRQ: 0
-IsKTX: 1
-BoardType: 1
-Board ID: 15
-Board Index: 0
-Board Name: BOARD1
-Board Used: 1
-Board Initialized: 1
*** CARD INSTALLED SUCCESSFULLY ***
--------------------------------------------------------------------------------

 

Keywords:
 

Attachments