#SpringCoreControl

#Name

SpringCoreControl.exe

#Description

SpringCoreControl.exe is a command-line tool that allows to send any arbitrary command to a SpringCore device.

#Dependencies

SpringCoreTool.exe runs over Microsoft .NET standard framework, version 4.6.2 or greater. On Linux and Mac OS X, it runs over Mono.

#Copyright and License

Copyright 2019-2020 SpringCard SAS, France. All Rights Reserved.

See LICENSE.txt in the tool directory for the complete License.

#Synopsis

Windows:

> SpringCoreControl.exe [--class=<CLASS>] <PAYLOAD> [PARAMETERS] [[OPTIONS]]

Linux / Mac OS X:

$ mono SpringCoreControl.exe [--class=<CLASS>] <PAYLOAD> [PARAMETERS] [[OPTIONS]]

#Common features

#Device selection

SpringCoreTool.exe needs to open a communication channel with the SpringCore device. See Device selection for details.

#Secure sessions

See Secure sessions.

#Misc.

See Misc. options.

#Options

#–class

Specify the message CLAss

SpringCoreTool.exe --class=<CLASS> <PAYLOAD>

Specify the CLAss within the Direct Protocol. See docs.springcard.com/books/SpringCore/Host_interfaces/Logical/Direct_Protocol/List_of_CLAsses for the list of supported CLAsses.

Default is 58 (CONTROL)

#–text

Show the response as a text

SpringCoreTool.exe <PAYLOAD> --text

Specify that the device’s response shall be shown as a text. Default is hexadecimal.

#Payload

The <PAYLOAD> buffer is an hexadecimal string that shall contain

• The INStruction code
• (Optionaly) the data for this INStruction

The list of valid INStruction code depends on the CLAss. For instance, INStructions in the default 58 CLAss (CONTROL) are listed in docs.springcard.com/books/SpringCore/Host_interfaces/Logical/Direct_Protocol/CONTROL_class/List_of_INStructions.

#Examples

#Using the default CLAss

> SpringCoreControl.exe 2000
<<< 58 2000
>>> 00  00 537072696E6743617264205075636B
Success

#Specifying the CLAss explicitly

> SpringCoreControl.exe --class=50 2000
<<< 50 2000
Wrong CLAss
Failed

> SpringCoreControl.exe --class=58 2000
<<< 58 2000
>>> 00  00 537072696E6743617264205075636B
Success

#Formatting the response as a text

> SpringCoreControl.exe 2000 --text
<<< 58 2000
>>> 00  00 537072696E6743617264205075636B
        SpringCard Puck
Success