Start » Filter Reference » Hardware Support » Nodka » Nodka_GetVersionInfo

Nodka_GetVersionInfo


Module: ThirdParty

Gets information about the hardware and the firmware of the device.

Name Type Range Description
Input value
inServerPort Integer* 1 - 65535 Port of NodkaServer service.
Input value
inDeviceConfigPath File* Path to nkio_config.ini file with I/O configuration.
Input value
inDeviceLightControllerPort Integer* 1 - COM port used by the light controller (if supported by the device).
Input value
inDevId Integer 0 - 255 ID of the device (0x01 for the light controller).
Input value
inTimeout Integer 0 - Timeout for the callback function.
Output value
outHardwareMajorVer Integer Device hardware major version.
Output value
outHardwareMinorVer Integer Device hardware minor version.
Output value
outHardwareRevVer Integer Device hardware revision version.
Output value
outFirmwareMajorVer Integer Device firmware major version.
Output value
outFirmwareMinorVer Integer Device firmware minor version.
Output value
outFirmwareRevVer Integer Device firmware revision version.

Remarks

This filter can be used to get the information about the hardware and the firmware version of the device.

I/O device driver software

This filter is intended to cooperate with a Nodka device using its vendor SDK and Nodka_Server.exe program. To be able to connect to the device, it is required to install Nodka NKDIO SDK.

Add DLL path to system environment variable may be required.

Recommended Nodka NKDIO SDK version for Aurora Vision Studio usage is v4.1.9. The implementation of all SDK functionality is done in Nodka_Server.exe program. The filters in Aurora Vision Studio work as a client which communicates with the server and they don't use the SDK directly. Only localhost connections are allowed.

It is mandatory to run the Nodka_Server.exe program with administrative privileges and keep it running during the execution of this and other Nodka filters.

For the correct operation of the program, it is required to copy the WinRing0.sys and WinRing0x64.sys files from the SDK directory to the directory where the Nodka_Server.exe file is located. These files are placed in C:\NODKA\NKDIO_SDK\Lib\x86 and C:\NODKA\NKDIO_SDK\Lib\x64 directories by default. Choose those that match your operating system version. Adding the directory to the PATH system variable will likely not work.

To run the program, open the Command Prompt as administrator, navigate to the directory where Nodka_Server.exe file is situated and then run the command `Nodka_Server.exe --port PORT` where 'PORT' is a TCP port on which the server will be listening (an integer value from the range 1-65535). Aurora Vision uses port 44100 by default so it is recommended to choose this one.

The Nodka_Server.exe program can be found in Aurora Vision installation path.

Some ports may operate in reverse logic. For details, refer to the electronic input and output diagram documentation of the device.

Device identification

inServerPort field is used to select a TCP port on which the Nodka_Server.exe is listening. Setting this parameter to 'Auto' will select port 44100 which is the default value. ServerPort can be set to:

  • TCP port - a TCP port on which the Nodka_Server.exe is listening.

inDeviceConfigPath field is used to select a path to the configuration file for a specific Nodka device model. This field cannot be empty for the first Nodka filter used. For each of the following filters with the same value of inServerPort, the value of this field can be set to 'Auto' which would result in using the previously specified configuration file. A new configuration file must be provided for each distinct value of inServerPort. The Nodka NKDIO SDK installer puts the configuration files in C:\NODKA\NKDIO_SDK\ConfigFile directory by default. The SDK does not check if the specified configuration file is correct, so any errors in the configuration file may be ignored by the SDK. DeviceConfigPath can be set to:

  • File path - a path to the configuration file for a specific Nodka device model.

inDeviceLightControllerPort field is used to select the COM port of the on-board light controller. Please note that not all Nodka devices have an on-board light controller. For more information refer to the documentation of the specific model. This field is optional and for devices without the light controller should be set to 'Auto'. DeviceLightControllerPort can be set to:

  • COM port - a COM port of the on-board light controller.

Complexity Level

This filter is available on Advanced Complexity Level.

Disabled in Lite Edition

This filter is disabled in Lite Edition. It is available only in full, Aurora Vision Studio Professional version.