Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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:

  • gpiSwitchLED: LED #2 is switch on

  • gpiDisplayMessageByID: PROCESSING identifier

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

gpiDisplayMessage

SPED

Display any string

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

gpiBeep

SPED

Beep at a specific frequency for a specific duration (if supported by the platform)

gpiSound

SPED

Generate a sound from a specific physical address

gpiSleep

SPED

Sleep. This function shall by implemented with care (no thread)

gpiSwitchLED

SPED

Switch ON/OFF a LED.

gpiClearScreen

SPED

Clear display

gpiGetString

SPED

Get string from the string table indexed by ID

Platform

Platform primitives are used to support the logic of the processing flow

gpiMemSet

Platform

Equivalent to stdlib’s memset

gpiStrLen

Platform

Equivalent to string’s memset

gpiMemCpy

Platform

Equivalent to stdlib’s memcpy

gpiGetDate

Platform

Get system’s date. Careful with time format

gpiGetTimer

Platform

Get system’s time. Careful with time format

gpiSetDateTime

Platform

Set system’s time. Careful with time format

gpiStartTimer

Platform

gpiGetTimerTime

Platform

gpiGetTimerState

Platform

gpiFreeTimer

Platform

gpiGetTotalRAM

Platform

Agnos card processing uses shared RAM (no dynamic allocation) no prevent runtime issues. Static RAM is allocated from inside the GPI. This primitive returns a pointer on the toal RAM available. Similar primitives exclusively used by Agnos framework:

  • gpiGetRAMForTags

  • gpiGetRAMForUnknownTags

  • gpiGetFreeRAM

  • gpiGetPrivateScratchPAD

HSM

gpiRsaComputation

HSM

Standard EMV RSA computation primitive to support ODA

gpiShaInit

HSM

Standard EMV SHA computation primitive to support ODA

gpiShaUpdate

HSM

Standard EMV SHA computation primitive to support ODA

gpiShaFinal

HSM

Standard EMV SHA computation primitive to support ODA

gpiRandomNumber

HSM

gpiGetCheckSum

HSM

Provide the checksum corresponding to each L2 CT/CL kernel

gpiGetEMVCertificate

HSM

gpiGetEMVCRL

HSM

...