Table of Contents

Primitives

...

Basics

Primitives	Module	Comments
User Interface		UI primitives are limited to a few set of functions. EMV processing doesn’t require sophisticated displays. However, a minimum set of functions is required to provide a feedback to the cardholder and the merchants.

Most of them are not used during transaction flow excepted:

Depending on the platform, these two primitives should be managed specifically if they alter the performance.


gpiDisplayMessageByID	SPED	Display a string from the string table indexed by ID
gpiSetPollingMessage	SPED	Set the message to be display at AgnosEP’s polling time
gpiDisplayPollingMessage	SPED	Display the message - at AgnosEP’s polling time - that has been set from gpiSetPollingMessage
Memory		Platform/Memory primitives are used to

support the logic of the processing flow

optimize the memory allocation for card processing. Hence, no dynamic allocation is performed within the framework. There a 6 different king of RAM memory slots: DEV_TOTAL_RAM (0x01): DEV_TAGS_RAM + DEV_UNKNOWN_TAGS_RAM + DEV_UNKNOWN_TAGS_RAM DEV_TAGS_RAM (0x02): all tags supporting the card processing coming from device configuration or the card DEV_UNKNOWN_TAGS_RAM (0x03): any tags coming out from the card and not supported by AgnosDB DEV_FREE_RAM (0x04): extra RAM to support any king of processing beyond AGF if shared RAM used beyond AGF DEV_SLOT_RAM (0x05): private RAM to store data to support a proprietary processing such as torn mechanism. As of tofay, C2/MCW and C5/JCB requires these pads. DEV_DO_RAM (0x06): all tags corresponding to the CL combination in progress. This RAM space is used to load ENTRY POINT data (for a given transaction type) in order to prepare entry point confugration data specific to the transaction in progress. Recommended sizes: DEV_TAGS_RAM = 11500 bytes DEV_UNKNOWN_TAGS_RAM = 2500 bytes DEV_FREE_RAM = 3000 bytes DEV_SLOT_RAM = 17100 bytes DEV_DO_RAM = 10000 bytes
gpiGetTotalRAM	Platform
gpiGetRAMForTags	Platform
gpiGetRAMForUnknownTags	Platform
gpiGetFreeRAM
gpiGetPrivateScratchPAD
gpiGetDataObjectRAM
RTC

gpiStartTimer	Device Management
gpiGetTimerTime	Device Management
gpiGetTimerState	Device Management
gpiFreeTimer

Device Management

dev_get_shared_ram_size

Device Management

Agnos card processing uses shared RAM (no dynamic allocation) to prevent runtime issues. Static RAM is allocated from inside the GPI.

dev_get_shared_ram


HSM
gpiGetChecksum	HSM Management	Provide the checksum corresponding to each L2 CT/CL kernel
File Management
gpiFileOpen	Platform
gpiFileClose	Platform
gpiFileRead	Platform
gpiFileWrite	Platform
gpiFileDelete	Platform
gpiFileRename	Platform
gpiFileGetSize	Platform

Primitives	Module	Comment
Initialization
gpiMain	Platform	GPI specific
gpiInitialize	Platform	Platform specific. Enable any initialization related to the plaftorm
gpiInitPolling	CAD	Platform specific. Enable any initialization realted to the contactless reader
gpiInitializeHSM	HSM	Platform specific. Enable any initialization related to the platform’s crypto

...