1. Developer Kit Simulator User Guide
  2. Setup, Samples, and Tools
  3. Installation
  4. Configuring the Java Card Development Kit Simulator

Configuring the Java Card Development Kit Simulator

Before using the simulator for the first time, it must be provisioned with an initial Secure Channel Protocol key set and with a Global PIN.

This can be done by running the Configurator tool from the command line as follows:

java -jar Configurator.jar -binary <simulator-binary> -SCP-keyset <k_enc> <k_mac> <k_dek> -global-pin <pin> <tries_count>
where:
  • simulator-binary is the SDK binary file to inject the data, which is jcsl for Linux and jcsw.exe for Windows.
  • k_enc is the ENC key of the card manager SCP keyset. It is not set by default.
  • k_mac is the MAC key of the card manager SCP keyset. It is not set by default.
  • k_dek is the DEK key of the card manager SCP keyset. It is not set by default.
  • pin is the global Personal Identification Number (PIN) used as a mechanism for CVM.
  • tries_count is the CVM Retry Limit.

Note:

The Configurator.jar file is located in the tools sub-directory of JC_HOME_SIMULATOR. To print the available arguments and further details of the configurator, execute java -jar Configurator.jar

Here are examples on how to provision the simulator using the Configurator. Use your own values accordingly.

Example - Linux (values must be set with yours):

java -jar ${JC_HOME_SIMULATOR}/tools/Configurator.jar -binary ${JC_HOME_SIMULATOR}/runtime/bin/jcsl -SCP-keyset 1111111111111111111111111111111111111111111111111111111111111111 2222222222222222222222222222222222222222222222222222222222222222 3333333333333333333333333333333333333333333333333333333333333333 -global-pin 01020304050f 03

Example - Windows

java -jar %JC_HOME_SIMULATOR%\tools\Configurator.jar -binary %JC_HOME_SIMULATOR%\runtime\bin\jcsw.exe -SCP-keyset 1111111111111111111111111111111111111111111111111111111111111111 2222222222222222222222222222222222222222222222222222222222222222 3333333333333333333333333333333333333333333333333333333333333333 -global-pin 01020304050f 03