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 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