Calypso for Terminals

Calypso for terminals supports security and interoperability

Calypso for terminals supports the security and interoperability of contactless ticketing systems.

Any terminal using Calypso for the secure exchange of data with a smart card (or any other portable object such as a smartphone or wearable NFC) must align to Calypso’s open standards to ensure they receive the full benefit of Calypso’s security, interoperability and the long term flexibility of using an open standard framework.

The Calypso software used for terminals is in compliance with all standards applicable to ticketing transactions (ISO/IEC 14443 and CEN/TS 16794 radio frequency standards, ISO/IEC 7816 1 to 4 card structure and file management, EN 1545 for data description in the transport field). 

The Calypso software layer supports the data exchange mechanisms between the terminal and the smart card, and ensures their security (including mutual authentication and data integrity) by linking the customer smart card to a tamper-proof secure component located in the terminal, known as the SAM. The SAM can also be remote on a server.

The terminal’s application software layer is interfaced with the Calypso layer and manages the ticketing transaction in real time by analysing the data received, processing it (e.g. checking the validity of a ticket) and modifying it. It then deduces the actions to be taken (e.g. giving an opening order to an entrance gate), and ensures the exchange of information with the central systems.

How to implement Calypso in a ticketing terminal?

  • To implement Calypso in a ticketing terminal, users may refer to the Calypso specifications in theCalypso technical document library. This information contains the interface specifications for the SAM, which can be accessed subject to the signing of a non-disclosure agreement (NDA), alongside guidance on the complete development of the different software layers.

    In order to facilitate development, CNA provides developers with three documents that define the requirements to ensure optimum operational performance, interoperability, modularity and conformance:

    • The Reader Layer Requirements which help to manage all types of cards and SAMs by a smartcard reader, at the lower level of the transaction
    • The Calypso Layer Requirements which help to specifically manage Calypso cards and SAMs in strict compliance with Calypso specifications
    • The Ticketing Layer Requirements, which outline requirements on the use of the Calypso high-level API and best practices to follow in a Calypso ticketing system

Users can also implement Calypso in a ticketing terminal by using the Eclipse KeypleTM SDK, developed in open-source mode by CNA, and available to any ticketing application developer. The use of Keyple guarantees compliance with the Calypso specifications and the various requirements, without having to develop, or even master, the Calypso mechanisms for secure data exchange between card and terminal, and SAM management.

Therefore, through Keyple SDK, developers can create applications that seamlessly connect with Calypso cards. By using the Ticketing Layer Requirements document, developers can ensure they conform strictly to all Calypso features and optimise their ticketing application.

How to implement Calypso in a ticketing terminal?

Introduction to Keyple ebook "Blueprint for a Smarter Future"

Eclipse Keyple for operators and transport authorities

Operators, transport authorities and indeed all purchasers of Calypso-based solutions have access to  open source modules and well-documented APIs which guarantee that Calypso’s open source framework is accessible at all levels of the Calypso ticketing system. 

Requesting the use of the Keyple SDK is legally legitimate as an open source solution, and ensures the best possible implementation of Calypso, capable of managing all the portable objects within the Calypso family, with well-defined interfaces between all software layers.

Using Keyple ensures a competitive approach to the terminal’s software upgrades throughout the system’s lifespan. This is one of the conditions for mastering its system as outlined in the Golden Rules of an open and interoperable ticketing system adapted to MaaS.

By making the Calypso ticketing standard available to all with Keyple, CNA ensures that Calypso compatible applications can be created very quickly, significantly reducing the investment time and specialist expertise required.

What is Eclipse Keyple technically?

Eclipse Keyple is a set of open source software components:

  • Plugins for interfacing with an infinite number of smartcard readers
  • Keyple Core, for universal management of cards and SAM, even if they are not Calypso
  • Keyple Calypso, which performs high-level Calypso processing of the Calypso card and SAM

To know more, visit Keyple.org

How can you access Keyple?

Keyple is hosted by the Eclipse Foundation, a global developer community of individuals and organisations with a mature, scalable environment for open source software collaboration and innovation.

Visit Keyple.org to learn more, review the latest updates, read the documentation and download the Keyple components.

All interested parties are welcome to purchase the Test Kit for Keyple SDK containing Calypso cards and SAMs to explore the functionality, with preferential rates for CNA members. Join our community and become a member.

To find out more about the SAM

The Calypso Secure Application Module (SAM) is present in every Calypso terminal or system. The SAM is a smartcard which ensures the secure authentication of data between a transport/mobility authorities’ ticketing reader and a traveller’s media, which could be a plastic card, phone or watch.

The Calypso SAM is available to purchase directly from CNA or through Spirtech.

If you want to access the Calypso SAM specifications, a NDA is needed. Please get in touch with the CNA team for details.