Tech note 19_07 - iClassPlugin
iClass Plugin
Technote 19/06 (year/number)
Date: July 9th, 2019
Author: Rui Paulino
Applicable Products: CardExchange® Producer & CardExchange® Visitor
Iclass Plugin
The CardExchange® Producer plug-in framework includes the iClassPlugin that allows to work with iClass(Development Access to read and write, PACS, Weigand), SEOS(read UID/Serial Number Only), DESFire(read UID/Serial Number Only).
It has 1 Input variables:
WriteData**;
It has 4 Output variables:
SerialNumber/UID;
PACS;
Weigand;
DeveloperMemory**;
**Only available if the iClass.ini file has the DevMode as Yes.
Plug-ins are only available in CardExchange ® Producer Ultimate.
Description
This plugin is compliant with iClass(Development Access to read and write, PACS, Weigand), SEOS(read UID/Serial Number Only), DESFire(read UID/Serial Number Only).
It can be used for example with;
iClass SE(S10);
iClass Legacy Corporate;
SEOS;
Mifare DESFire EV1;
Please note that the iClassPlugin has its own iClass.ini file where you can set and configure the following:
[Settings]
Format=No
[AccessMode]
DevMode=No
;Format = No, H10301, H1000
;DataType = Hex, Dec, Utf8
;DevMode = No, Yes
;Write to card can only write a 8 byte value for instance "cardexch" or "01234567" in block 19 and to block 20
Settings
The Format is if you want to format the iClass card to H10301 or to H1000, please note that this will only work if the card was not already formatted yet and for iClass cards.
AccessMode
DevMode to have access to block19 and 20 to read and write is needed to change the DevMode to Yes.
Please note that to read from the block 19 and block 20 it only has 8 bytes for each, the same when writing only has 8 bytes so you can send “cardexchange” and 19th block will have “cardexch” and the 20th block will have “ange”.
That data could be sent using the Input Variable WriteData.
Supported Readers
Omnikey 5023, 5127 and 5427.
Example
To illustrate how iClassPlugin work, we will create a card definition with 2 manual entries.
To start, create a new card layout with a text object linked to a variable called "OutputVariable1" and a second text object linked to a variable called "OutputVariable2".
Select "Do you want to use external functions or plug-ins" in the card-definition wizard and click the Edit button to configure the plug-in.
Add a plug-in called "Plugin Template" and browse for the IClassPlugin the DLL-file. Then click Next.
After that please configure the InputVariable to send to the plugin for the Input Variables (WriteData**).**Only if you want to access to the Development memory.
WriteMemory will be the Data written;
4. Next, select the Visible items and choose which is the data that you want to save on the OutputVariables (SerialNumber, PASCS, Weigand, DeveloperMemory**).**Only if you want to access to the Development memory.
5. Click Next to go to the mappings window and map the visible item called "ManualText" to the plug-in output "ManualText.Result". Then map the plug-in input "ManualText.Definition" to "Enter manually".
Select the External Function Input items tab and map the storage Item/variable/database column to the item "Template.WriteMemory".
If nothing is mapped the plugin will take its defaults (NoWriteaction).
Map the item/storage item to save the read data and click on finish.
8. Print the card. You will now see that the manual entry on the printed card.
For further assistance, please do not hesitate to contact our Support team using the details available on the page footer.