Smart Card Manager
DPYSCMTOOL Linux Programmer's Manual DPYSCMTOOL
DESCRIPTION
dpyscmtool : Read and configure an Smart Card Manager
SYNOPSIS
dpyscmtool [-h/ --help]
dpyscmtool [-tv / --toolversion]
dpyscmtool [-d/ --devices]
dpyscmtool [-r/ --readers] <Device ID>
dpyscmtool [-e/ --newevent]
dpyscmtool [-us/ --upgradestatus]
dpyscmtool [-gk/ --getkeys] <Device ID> <Password>
dpyscmtool [-ak/ --addkeys] <Device ID> <Path to json file>
dpyscmtool [-rk/ --removekeys] <Device ID>
dpyscmtool [-gv/ --getversion] <Device ID>
dpyscmtool [-gm/ --getmediaprofiles] <Device ID>
dpyscmtool [-am/ --addmediaprofiles] <Device ID> <Path to json file>
dpyscmtool [-rm/ --removemediaprofiles] <Device ID>
dpyscmtool [-pm/ --playprofile] <Device ID> <Profile ID>
dpyscmtool [-re/ --rebootevent]
dpyscmtool [-srt/ --setreboottime] <Device ID> <Reboot Time>
dpyscmtool [-grt/ --getreboottime] <Device ID>
dpyscmtool [-gn/ --getnetworkconf] <Device ID>
dpyscmtool [-sip / --setip] <Device ID> <IP Address> <Net mask> <Gateway> <DNS>
dpyscmtool [-dhcp / --dhcp] <Device ID>
dpyscmtool [-gd / --getdatetime] <Device ID>
dpyscmtool [-rd / --reboot] <Device ID> <Reboot Type>
dpyscmtool [-fc / --forceconnection] <Device ID>
dpyscmtool [-fu / --forceupgrade] <Device ID>
dpyscmtool [-tn / --testnetwork] <Device ID> <IP/Name Address>
dpyscmtool [-slc / --setloggingconfig] <Device ID> <Component> <Level> <Address> <Port> <Reboots Until Logging Disabled>
dpyscmtool [-glc / --getloggingconfig] <Device ID>
dpyscmtool [-gps / --getpastatus] <Device ID>
dpyscmtool [-rsl/ --resetsamslot] <Device ID> <SAM slot>
dpyscmtool [-aa/ --addartifact] <Device ID> <Name> <Path> <Type> [Version]
dpyscmtool [-ga/ --getartifacts] <Device ID>
dpyscmtool [-ra/ --removeartifact] <Device ID> <Name>
dpyscmtool [-ep/ --executeplugin] <Device ID> <Name> {Data}
OPTIONS
-h / --help : This help page.
-tv / --toolversion : Print tool version.
-d / --devices: Print every device available.
-r / --readers <Device ID>: Print every smart card reader available in a specific device.
-e / --newevent: Subscribe to card and device events.
-us/ --upgradestatus: Subscribe to upgrade status notifications.
-gk/ --getkeys <Device ID> <Password>: Get keys for a specific device if "Password" is correct.
-ak/ --addkeys <Device ID> <Path to json file>: Add keys to a specific device from JSON file. See FORMATS section.
-rk/ --removekeys <Device ID>: Removes every key in device.
-gv/ --getversion <Device ID>: Get the information related to the SW version of a specific device.
-gm/ --getmediaprofiles <Device ID> : Retrieve media profiles configuration for a specific device.
-am/ --addmediaprofiles <Device ID> <Path to json file>: Add media profiles to a specific device from JSON file. See FORMATS section.
-rm/ --removemediaprofiles <Device ID> : Remove every media profile for a specific device.
-pm/ --playmediaprofile <Device ID> <Profile ID>: Plays a media profile in device, default (Default_OK, Default_KO, Default_Blacklist) or custom profiles.
-re/ --rebootevent : Subscribe to PCI Data Security Standard reboot events.
-srt/ --setreboottime <Device ID> <Reboot Time>: Set PCI Data Security Standard reboot time [hh:mm:ss] for a specific device.
-grt/ --getreboottime <Device ID> : Get PCI Data Security Standard reboot time for a specific device.
-gn/ --getnetworkconf <Device ID> : Get network configuration for a specific device.
-sip / --setip <Device ID> <IP Address> <Net mask> <Gateway> <DNS>: Set a static IP address.
-dhcp / --dhcp <Device ID>: Enable DCHP on its interface.
-gd / --getdatetime <Device ID>: Get actual date and time for a specific device.
-rd / --reboot <Device ID> <Reboot Type>: Reboot the device (<Reboot Type> can be SOFT or HARD).
-fc / --forceconnection <Device ID>: Force connection with payment gateway.
-fu / --forceupgrade <Device ID>: Force device to be upgraded using the firmware file located in the RFS (generally /lib/firmware/deepsy/ux410/)
-tn / --testnetwork <Device ID> <IP/Name address>: Test the network status of the device, if it is able to reach the address and to resolv its name.
-slc / --setloggingconfig <Device ID> <Component> <Level> <Address> <Port> <Reboots Until Logging Disabled> : Set remote logging configuration for a specific device.
Description:
<Device ID> : Device identifier.
<Component> : Element whose logging configuration will be changed. Possible values are:
NONE : Equivalent to disabling remote logging
ALL : Activate remote logging for all components
CONFIGURATION : Activate remote logging for CONFIGURATION component
LIBPAP_EMV : Activate remote logging for LIBPAP_EMV component
TRANSPORT_NFC : Activate remote logging for TRANSPORT_NFC component
SAM : Activate remote logging for SAM component
SYSTEM : Activate remote logging for SYSTEM component
UPDATES : Activate remote logging for UPDATES component
SERVER : Activate remote logging for SERVER component
<Level> Log Level indicating the severity of the logs. Possible values are:
ERROR, WARN, INFO, DEBUG
<Address> : Remote IP address to log the data to.
<Port> : Remote port to log the data to.
<Reboots Until Logging Disabled>: Number of reboots until the remote logging is disabled.
0 => remote logging will be disabled when a reboot is done
N ( N>0 ) => remote logging will remain active for N reboots (until N reboots are performed)
-glc / --getloggingconfig <Device ID> : Get current remote logging configuration for a specific device.
-gps / --getpastatus <Device ID>: Get current payment application status of a specific device.
-rsl/ --resetsamslot <Device ID> <SAM slot>: Reset SAM slot. Possible values are 1, 2, 3 or 4.
-aa / --addartifact <Device ID> <Name> <URI> <Type> [Version]: Add artifact to a specific device.
Description
<Device ID> : Device identifier.
<Name> : Artifact name.
<URI> : File absolute path where the artifact is located.
<Type> : Type of artifact. Possible values are:
PLUGIN : Plugin artifact
FILE : Standard file artifact
[Version] : Optional, version of the artifact.
-ga / --getartifacts <Device ID>: Get information about the artifacts loaded on a specific device.
-ra / --removeartifact <Device ID> <Name>: Remove artifacts from a specific device.
-ep / --executeplugin <Device ID> <Name> {Data}: Execute plugin for a specific device
Description
<Device ID> : Device identifier.
<Name> : Plugin name.
{Data} : Data map to be sent in {key value} format. Admits several pairs.
EXAMPLES
dpyscmtool -d
dpyscmtool -r Ux410
dpyscmtool -gk Ux410
dpyscmtool -ak Ux410 "keys.json"
dpyscmtool -rk Ux410
dpyscmtool -gv Ux410
dpyscmtool -gm Ux410
dpyscmtool -am Ux410 "media_profiles.json"
dpyscmtool -pp Ux410 Default_OK
dpyscmtool -srt Ux410 23:59:59
dpyscmtool -grt Ux410
dpyscmtool -gn Ux410
dpyscmtool -sip Ux410 192.168.0.236 255.255.255.0 192.168.0.21 1.1.1.1
dpyscmtool -dhcp Ux410
dpyscmtool -rd Ux410 SOFT
dpyscmtool -tn Ux410 www.google.es
dpyscmtool -slc Ux410 ALL DEBUG 192.168.0.125 7777 1
dpyscmtool -gps Ux410
dpyscmtool -rsl Ux410 1
dpyscmtool -aa Ux410 "simple_plugin" "/tmp/libsimple_plugin.so" PLUGIN
dpyscmtool -aa Ux410 "blacklist" "/tmp/blacklist.txt" FILE "12.0.1"
dpyscmtool -ga Ux410
dpyscmtool -ra Ux410 "simple_plugin"
dpyscmtool -ep Ux410 "simple_plugin" "Operation" "Validate"
FILES
/mntSFS/gmvCNF/networkConfiguration.json Network configuration file
FORMATS
Add keys JSON format:
{
"keyGroups": [{"priority" : (integer)
"key": ["keytype": ("KEY_A"|"KEY_B"),"index": (integer),"keys": (hex string)]}]
}
For instance:
{
"keyGroups": [{"priority": 1,
"key": [{"keytype": "KEY_A","index": 4,"keys": "FFFFFFFF"},
{"keytype": "KEY_A","index": 5,"keys": "FFFFFFFF"}]},
{"priority": 2,
"key": [{"keytype": "KEY_B","index": 4,"keys": "FFFFFFFF"}]}]
}
--------------
Add media profiles JSON format:
{
"profiles": [{"profileId": (string),
"sounds": [
{"tone_hz": (integer),"duration_ms": (integer)},
{"tone_hz": (integer),"duration_ms": (integer)}],
"ledGroupStates": [
{"leds":[
{"id": ("LED1"|"LED2"|...|"LEDLOGO1"),"color":("WHITE"|"RED"|...|"CYAN") },
{"id": ("LED1"|"LED2"|...|"LEDLOGO1"),"color":("WHITE"|"RED"|...|"CYAN") }],
"duration_ms": (integer)}]
}
]
}
For instance:
{
"profiles": [{"profileId": "1",
"sounds": [
{"tone_hz": 1000,"duration_ms": 100},
{"tone_hz": 2000,"duration_ms": 200},
{"tone_hz": 1000,"duration_ms": 100},
{"tone_hz": 300,"duration_ms": 200},
{"tone_hz": 2000,"duration_ms": 200}],
"ledGroupStates": [
{"leds":[
{"id": "LED2","color":"WHITE" },
{"id": "LED3","color":"WHITE" },
{"id": "LED4","color":"WHITE" }]
,"duration_ms": 1000},
{"leds":[
{"id": "LED1","color":"WHITE" },
{"id": "LED3","color":"WHITE" },
{"id": "LEDLOGO1","color":"WHITE" }]
,"duration_ms": 1000},
{"leds":[
{"id": "LED1","color":"WHITE" },
{"id": "LED2","color":"WHITE" },
{"id": "LED4","color":"WHITE" }],
"duration_ms": 100}]
}
]
}
BUGS
SEE ALSO
AUTHORS
Deepsy Team
