Changelog

Fixed

• Fixes an issue with exception handling in the WAIT_FOR_CARD_REMOVAL state of the observable reader state machine that blocked the state machine in the same state.
• Fixes a performance issue introduced in version 2.1.3 related to the closing of the physical channel when processing a new card selection scenario with the same card (issue [#58]).

Upgraded

• Calypsonet Terminal Reader API 1.2.0 -> 1.3.0. Introduced a new capability to export a locally processed card selection scenario to be imported and analyzed remotely by another card selection manager. For this purpose, the following two methods have been added to the CardSelectionManager interface:
  • exportProcessedCardSelectionScenario
  • importProcessedCardSelectionScenario

Fixed

• An issue with “Select File” and “Read Record” commands when the card is a legacy ASK Tango card having the following startup information value:
  • 03 08 03 04 00 02 00

Upgraded

• “Keyple Service Resource Library” to version 2.1.1

Fixed

• Fixes the communication issue between client and server components when using the “Reader Client Side” usage mode that appeared with version 2.2.0.

Fixed

• Fixes the communication issue between client and server components of the “Distributed” solution that appeared with version 2.1.4.

Fixed

• Exception handling associated with the reader allocation process.

Upgraded

• “Keyple Service Resource Library” to version 2.1.1

Fixed

• The issue of resource allocation associated with regular (non-pool) plugins, happening when the resource usage timeout was not explicitly configured.

Added

• The method CardResource.getReaderExtension to access the reader extension.

Changed

• CardResource is now an interface.

Upgraded

• “Calypsonet Terminal Reader API” to version 1.2.0
• “Keyple Service Library” to version 2.2.0
• “Keyple Util Library” to version 2.3.0
• “Google Gson Library” (com.google.code.gson) to version 2.10.1

⚠️ CAUTION: In the case of a distributed mode, it is required to use at least this version on the client and server side.

Added

• The PoolPlugin.getSelectedSmartCard method to retrieve the smart card if it has been automatically selected by the reader allocation process.

Upgraded

• “Keyple Plugin API” to version 2.1.0

Added

• The method PoolPluginSpi.allocateReader now returns the new interface PoolReaderSpi, which extends ReaderSpi, in order to retrieve the smart card that may be automatically selected.
• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#7]).

Fixed

• Unnecessary logging in Java 16+ during reflexive calls used to overcome the deficiencies of smartcard.io in Windows environment.

Changed

• PcscPluginFactoryBuilder.useContactReaderIdentificationFilter method marked as deprecated.

Fixed

• Use default reader type identification filters.
• Logging of the available readers names in the AbstractPcscPluginAdapter class.

⚠️ CAUTION: this version requires to use at least version 2.2.0 of the Keyple Distributed Remote Library!

Added

• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#5]).

Changed

• Initial card content and user input/output data used for “ReaderClientSide” mode are now serialized/de-serialized as JSON objects, and no more as strings containing JSON objects.
• All JSON property names are now “lowerCamelCase” formatted.

Upgraded

• “Keyple Distributed Network Library” to version 2.2.0.
• “Keyple Util Library” to version 2.3.0.
• “Google Gson Library” (com.google.code.gson) to version 2.10.1.

⚠️ CAUTION: this version requires to use at least version 2.2.0 of the Keyple Distributed Local Library!

Changed

• Initial card content and user input/output data used for “ReaderClientSide” mode are now serialized/de-serialized as JSON objects, and no more as strings containing JSON objects.

Upgraded

• “Keyple Distributed Network Library” to version 2.2.0.

Changed

• Prevent internal fields serialization.

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.8.0 (initialize SAM context for next transaction).

Changed

• Objects transmitted through the network for “Distributed” solution are now serialized/de-serialized as JSON objects, and no more as strings containing JSON objects.
• All JSON property names are now “lowerCamelCase” formatted.

Added

• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#6])

Changed

• All JSON property names are now “lowerCamelCase” formatted.

Upgraded

• “Keyple Util Library” to version 2.3.0.
• “Google Gson Library” (com.google.code.gson) to version 2.10.1.

Fixed

• SV reload and debit logs are now updated in CalypsoCard during a transaction.

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.7.0 (pre-open secure session variant).

Upgraded

• “Calypsonet Terminal Reader API” to version 1.2.0.
• “Calypsonet Terminal Calypso Crypto Legacy SAM API” to version 0.2.0.
• “Google Gson Library” (com.google.code.gson) to version 2.10.1.

Added

• The possibility to provide to the RemotePluginServer a custom executor service to be used to asynchronously notify remote reader connection events (see new method RemotePluginServerFactoryBuilder.builder(String remotePluginName, ExecutorService executorService)).
• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#3])

Upgraded

• “Keyple Distributed Remote API” to version 2.1.0
• “Keyple Util Library” to version 2.3.0
• “Google Gson Library” (com.google.code.gson) to version 2.10.1

Fixed

• Management of the physical channel when chaining multiple selection scenarios.

Upgraded

• “Keyple Distributed Remote API” to version 2.1.0
• “Google Gson Library” (com.google.code.gson) to version 2.10.1.

Changed

• The errors raised by the “Read Record” command executed during the card selection process are no longer blocking.

Upgraded

• “Calypsonet Terminal Reader API” to version 1.2.0.
• “Calypsonet Terminal Calypso API” to version 1.6.0 (replacement of “process” commands by “prepare” commands).
• “Google Gson Library” (com.google.code.gson) to version 2.10.1.

Added

• The possibility to provide to the observable remote plugin a custom executor service to be used to asynchronously notify remote reader connection events (see new method ObservableRemotePluginSpi.getExecutorService).
• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#3])

Upgraded

• “Calypsonet Terminal Reader API” to version 1.2.0.
• “Keyple Util Library” to version 2.3.0.

Fixed

• SAM exception management for signature command.
• Increase/Decrease commands postponed data management for legacy cards.

Deprecated

• CalypsoExtensionService.createSamSecuritySetting method.
• CalypsoExtensionService.createSamTransaction method.
• CalypsoExtensionService.createSamTransactionWithoutSecurity method.

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.5.0 (extended mode management).

Added

• LegacySamCardExtensionService to gather all providers.

Added

• ContextSetting setting to CalypsoExtensionService to manage the limitations of some not fully compliant terminals.

Fixed

• Maximum payload length management for card and SAM APDUs.
• Exception management within a secure session.

Fixed

• Signature issue when doing SV operation in secure session.

Fixed

• Take card revision into account when parsing the FCP structure (issue [#83]).
• Generate multiple increase/decrease counter commands when the card does not support Increase/DecreaseMultiple commands (issue [#84]).
• Expected length issue in “Read Binary” card command.
• Set payload capacity to 235 for cards revision 3 having the following startup information pattern: xx 3C xx xx xx 10 xx
• Set payload capacity to 128 for cards revision 1 2.
• Fix postponed data issue for increase/decrease counter commands for cards revision 1 2 having the following startup information pattern:
  • 06 xx 01 03 xx xx xx
  • 06 0A 01 02 xx xx xx
  • xx xx 0x xx 15 xx xx
  • xx xx 1x xx 15 xx xx

Changed

• Enable binary commands with PRIME_REVISION_2 cards.

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.4.1.
• “Keyple Util Library” to version 2.3.0.

Added

• ByteArrayUtil.extractBytes method to extract bytes from a number.
• ByteArrayUtil.extractShort method.
• ByteArrayUtil.extractLong method.
• ByteArrayUtil.copyBytes method.

Added

• JSON serializers for the new import/export feature of the card selection manager.

Changed

• Merge of internal setApduResponse and checkStatus methods to parseApduResponse method.
• Improvement of the card command parsing process.
• Internal identification of the currently selected file.

Fixed

• Management of “Read Records” card command for cards not supporting multiple record reads.

Upgraded

• “Calypsonet Terminal Reader API” to version 1.1.0.
• “Calypsonet Terminal Calypso API” to version 1.4.0 (issues [#40], [#41], [#42]).

Fixed

• Logging format for distributed service.

Upgraded

• “Calypsonet Terminal Reader API” to version 1.1.0.
• “Keyple Util Library” to version 2.2.0.

Changed

• Use the SAM “Digest Update Multiple” command whenever possible.

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.3.0.

Added

• Class CalendarJsonAdapter for serialization of Calendar objects in ISO 8601 format.
• Class DateJsonSerializer for serialization of Date objects in ISO 8601 format.

Fixed

• Problem occurring when reusing a CalypsoSamSelection containing unlocking data.

Upgraded

• “Keyple Service Resource Library” to version 2.0.2.

Changed

• Usage of CardReader instead of Reader.

Upgraded

• “Keyple Service Library” to version 2.1.0
• “Keyple Util Library” to version 2.1.0

Added

• SmartCardService.getPlugin from a CardReader reference.
• SmartCardService.getReader from a CardReader name.
• Plugin.getReaderExtension to access the reader’s extension class.

Deprecated

• Reader in favor of CardReader from the “Calypsonet Terminal Reader API”.
• ObservableReader in favor of ObservableCardReader from the “Calypsonet Terminal Reader API”.
• ConfigurableReader in favor of ConfigurableCardReader from the “Calypsonet Terminal Reader API”.
• ReaderEvent in favor of CardReaderEvent from the “Calypsonet Terminal Reader API”.

Fixed

• Auto management of 61XX and 6CXX status words and case 4 commands (Calypsonet Terminal Requirements: RL-SW-61XX.1, RL-SW-6CXX.1, RL-SW-ANALYSIS.1 and RL-SW-CASE4.1) (issue [#37]).
• Returned value of getActiveSmartCard method when there is no active smart card (issue [#40]).
• JSON serialization for interfaces in objects trees (issue [#43]).
• No longer clear the selection requests after processing the card selection.
• Closing the physical channel when unregistering a reader.

Upgraded

• “Keyple Util Library” to version 2.1.0 by removing the use of deprecated methods.

Added

• PcscReader.transmitControlCommand and PcscReader.getIoctlCcidEscapeCommandId methods (issue [#9]).
• “CHANGELOG.md” file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#6]).

Upgraded

• “Keyple Util Library” to version 2.1.0 by removing the use of deprecated methods.

Fixed

• Setting the smartcard.io path in the case of MacOS platform.

Added

• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#3]).

Fixed

• Removal of the unused Jacoco plugin for compiling Android applications that had an unwanted side effect when the application was launched (stacktrace with warnings).

Upgraded

• “Keyple Util Library” to version 2.1.0 by removing the use of deprecated methods.

Added

• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#5]).

Fixed

• Removal of the unused Jacoco plugin for compiling Android applications that had an unwanted side effect when the application was launched (stacktrace with warnings).

Upgraded

• “Keyple Util Library” to version 2.1.0 by removing the use of deprecated methods.

Added

• “CHANGELOG.md” file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#7]).
• New way of mocking APDU responses for a StubSmartCard using a provider (issue [#10]).

Upgraded

• “Keyple Util Library” to version 2.1.0 by removing the use of deprecated methods.

Added

• CalypsoExtensionService.createBasicSignatureComputationData method.
• CalypsoExtensionService.createTraceableSignatureComputationData method.
• CalypsoExtensionService.createBasicSignatureVerificationData method.
• CalypsoExtensionService.createTraceableSignatureVerificationData method.
• CalypsoExtensionService.createSamSecuritySetting method.
• CalypsoExtensionService.createSamTransaction method.
• CalypsoExtensionService.createSamTransactionWithoutSecurity method.
• Additional Calypso requirements related to Stored Value operations (issue [#59]).
• Additional Calypso requirements related to abortion of a secure session (issue [#57]).
• Additional Calypso requirement related to the analysis of the APDU response length (issue [#62]).
• Additional Calypso requirement related to the card extended mode command management (issue [#64]).
• Additional Calypso requirement related to the card transaction counter (issue [#66]).
• Additional Calypso requirement related to the transaction audit data (issue [#68]).

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.2.0 (issue [#66]).
• “Keyple Util Library” to version 2.1.0.

Fixed

• Null Pointer Exception raised when the “open secure session” command returns an unexpected status word [#70]
• JSON serialization for interfaces in objects trees (issue [#71]).

Added

• “CHANGELOG.md” file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#14]).
• JSON serializer/deserializer for short and long data types (issue [#17]).
• Assert.isHexString method.
• HexUtil.isValid method.
• HexUtil.toByteArray method.
• HexUtil.toByte method.
• HexUtil.toShort method.
• HexUtil.toInt method.
• HexUtil.toLong method.
• HexUtil.toHex methods for byte[], byte, short, int and long data types.
• ByteArrayUtil.extractBytes method.
• ByteArrayUtil.extractInt method.
• BerTlvUtil.parse method to parse TLV data structure having several identical TAGs (issue [#19]).

Changed

• Optimizations of hexadecimal data conversions.

Deprecated

• ByteArrayUtil.isValidHexString method replaced by HexUtil.isValid method.
• ByteArrayUtil.normalizeHexString method.
• ByteArrayUtil.fromHex method replaced by HexUtil.toByteArray method.
• ByteArrayUtil.toHex method replaced by HexUtil.toHex method.
• ByteArrayUtil.twoBytesToInt method replaced by ByteArrayUtil.extractInt method.
• ByteArrayUtil.twoBytesSignedToInt method replaced by ByteArrayUtil.extractInt method.
• ByteArrayUtil.threeBytesToInt method replaced by ByteArrayUtil.extractInt method.
• ByteArrayUtil.threeBytesSignedToInt method replaced by ByteArrayUtil.extractInt method.
• ByteArrayUtil.fourBytesToInt method replaced by ByteArrayUtil.extractInt method.
• ContactCardCommonProtocol class.
• ContactlessCardCommonProtocol class.

Added

• Implementation of EF_LIST and TRACEABILITY_INFORMATION tags to prepareGetData methods (issue [#33]).
• Implementation of prepareUpdateBinary and prepareWriteBinary methods (issue [#34]).
• Implementation of prepareReadBinary method (issue [#35]).
• Implementation of prepareReadRecordsPartially method (issue [#36]).
• Implementation of prepareSearchRecords method (issue [#37]).
• Implementation of prepareIncreaseCounters and prepareDecreaseCounters methods (issue [#38]).
• Implementation of processChangeKey method (issue [#39]).
• Management of EFs with SFI equal to 0 (issue [#55]).

Changed

• Internal parameter P2 to FFh for the “Change PIN” card APDU command.

Fixed

• Revision 2 case for prepareSelectFile method (issue [#32]).

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.1.0 (issue [#53]).

Fixed

• Commands anticipation management during “processClosing” method (issue [#30])

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.0.5.

Fixed

• Logging of APDU request command (issue [#9]).

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.0.3 (issue [#28]).

Added

• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#34]).

Fixed

• Logical channel management for multiple selections (issue [#38]).

Added

• “CHANGELOG.md” file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#4]).

Fixed

• Returned value of addSuccessfulStatusWord method (issue [#7]).

Upgraded

• “Keyple Service Resource Library” to version 2.0.1

Added

• CHANGELOG.md file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#20]).

Changed

• Merging of internal builders and parsers of APDU commands (issue [#24]).

Fixed

• Take into account the last DF status for isDfInvalidated() method (issue [#22]).

Upgraded

• “Calypsonet Terminal Calypso API” to version 1.0.2
• “Keyple Service Resource Library” to version 2.0.1

Deprecated

• addSuccessfulStatusWord method (issue [calypsonet/calypsonet-terminal-calypso-java-api#11]).

Added

• “CHANGELOG.md” file (issue [eclipse/keyple#6]).
• CI: Forbid the publication of a version already released (issue [#4]).

Changed

• Useless check removed in configurator builder (issue [#9])

Fixed

• Sonar issues (issue [#6]).