ID-Karta IdxApi communication protocol
Supported device types and versions
Communication line configuration
Communication station configuration
I/O tag configuration
Literature
Changes and modifications
Document revisions
Supported device types and versions
...
This protocol supports data reading/writing from the identification cards ID-Karta, type ID898, and ID898K.
Kotva |
---|
| komunikacna_linka |
---|
| komunikacna_linka |
---|
|
Communication line configuration
...
- Communication line category: API
Kotva |
---|
| komunikacna_stanica |
---|
| komunikacna_stanica |
---|
|
Communication station configuration
...
- Communication protocol: ID-Karta IdxAPI
- Station address according to settings on a sensor (sensor displays the address in off-line status after switch on).
I/O tag configuration
...
I/O tags: Ci, Co, TxtI, TxtO
The address is a number in the range of 1 byte (0 to 255). The meaning of the addresses is stated in the Table 1 below:
Table 1
Value type | Address | Meaning | Read/Write |
---|
Ci |
---|
Ci | 0 | Pressing the key - I/O tag value is an index of the pressed key. | R |
Ci | 1 | Identification - numerical. I/O tag value is |
a the number of the last card |
number last made performed the identification. | R |
Co |
---|
Co | 0 | Beeping - a module of the sensor makes an audible alarm. I/O tag value defines the number of |
beep beeps (max. 255). | W |
Co | 1 | Relay - control of relay on the module. The written value 1 up to 254 represents a time of closure x 0.5 second. 255 = permanent closure, 0 = immediate opening. | W |
TxtI |
---|
TxtI | 0 | Identification - text. I/O tag value is a string with the card number (in hex), which last made the identification (e.g. "40224AB8"). | R |
TxtO |
---|
TxtO | 0 | Text on a display. It displays a text on a display. The format of string value must be "x;y;text", where x and y are the coordinates on the display (the size of display is 2 x 20 characters; the position 0;0 means upper left corner) and text is the text that will be displayed (max. 40 characters). | W |
Configuration and files
The modules of the sensor communicate via RS485 interface and the communication is done by the idx.exe process, which must runbe running. D2000 KOM requires a dynamic library idxapi.dll, which is linked to idx.exe, for a proper communication. The configuration of modules that communicate with idx.exe is stored in the registry:
[HKEY_LOCAL_MACHINE\Software\IDKarta\IDX]
[HKEY_LOCAL_MACHINE\Software\IDKarta\IDX\Uzly]
[HKEY_LOCAL_MACHINE\Software\IDKarta\IDX\Uzly\NaCom]
"Adresa"=dword:00000001
"Typ"=dword:00000001
"COM"=dword:00000001
[HKEY_LOCAL_MACHINE\Software\IDKarta\IDX\Zarizeni]
[HKEY_LOCAL_MACHINE\Software\IDKarta\IDX\Zarizeni\z1]
"Adresa"=dword:00000001
"Uzel"=dword:00000001
"Typ"=dword:00000001
The parameters in "HKEY_LOCAL_MACHINE\Software\IDKarta\IDX\Uzly" define both a quantity and the parameters of so-called nodsnodes, i.e. communication interfaces. A key "COM" defines the serial port number. The list of devices is in "HKEY_LOCAL_MACHINE\Software\IDKarta\IDX\Zarizeni".
The producer ID-Karta s.r.o. (www.ID-Karta.cz) provides the files idx.exe and idxapi.dll.
Literature
...