> For the complete documentation index, see [llms.txt](https://sandbox-docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sandbox-docs.verifone.com/adk-5.0-programmers-guide/readme/modules/group__sdisystem.md).

# System interface

[Data Structures](#nested-classes) | [Functions](#func-members)

|                 |                                                                                     |
| --------------- | ----------------------------------------------------------------------------------- |
| Data Structures |                                                                                     |
| struct          | [SDIClient::ComponentVersion](#structvfisdi_1_1_s_d_i_client_1_1_component_version) |

|           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Functions |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| int       | [sysAbort](#gaaa584883946486751113f98b317623df) ()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| int       | [sysGetConfig](#ga7f25a798b839c063cbd06d44e0313613) (const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&req, [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&out)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| int       | [sysGetCPUID](#gaf233502e71652c8d51917e15bc22a7e8) (std::string \&id)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| int       | [sysGetSerialNumber](#ga86c99be3edd67ee31ae80ebcd610aab0) (std::string \&sn)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| int       | [sysGetBootSoftwareID](#gae02f6e7a29647f0c172d4321370cecf0) (std::string \&id)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| int       | [sysGetApplicationSoftwareID](#gac2ec2c92bfb5beba8b26b7063798f292) (std::string \&id)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| int       | [sysGetHardwareID](#ga49b22bbb731a1d9d16c0ca99802e1254) (std::string \&id)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| int       | [sysGetIFMID](#gaf95a9d826bd2aeb89d1fb943e2ea3fce) (std::string \&id)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| int       | [sysGetEMVL2ID](#gafa12882d0135fa7897f2f64982c33320) (std::string \&id)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| int       | [sysGetStatus](#ga8b4f5e6d6d12cf5760153114bc3d371f) (const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&req, [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&out)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| int       | [sysGetDateTime](#ga41e7b1518505a9f0a34253a57c3e597f) (unsigned short \&year, unsigned char \&month, unsigned char \&day, unsigned char \&hour, unsigned char \&minute, unsigned char \&second)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| int       | [sysGetTamperStatus](#gaab4470413c2c1cbdf6a25cca76795cfa) ([Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/structvfisdi_1_1_array.md)< 9 > \&tamper)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| int       | [sysGetBatteryStatus](#gacd3edebd1174d3398320769e6208a50c) (unsigned char \&charge\_level, unsigned char \&charge\_status)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| int       | [sysGetBatteryVoltage](#ga21ec43a34504219da1656b945530b231) (unsigned short \&voltage)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| int       | [sysGetLanguage](#ga5bfe0a8a267e7e674283b92e05de3cce) (enum [Language](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a315ca917ad583797f709ea477dd28705) \&language)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| int       | [sysGetCVVDeactivation](#ga4f956cba60843a3b06d425f49fcd09d1) (unsigned char \&cfg)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| int       | [sysGetCardEntryMode](#ga3fb40f1c66989d42fa78b046caa0b342) (unsigned char \&mode)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| int       | [sysSetDateTime](#ga2e7b93e265700b9d778b01c11b95fe5f) (unsigned short year, unsigned char month, unsigned char day, unsigned char hour, unsigned char minute, unsigned char second)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| int       | [sysSetLanguage](#gad78e48f51cb1c87de771a7ddd67b394e) (enum [Language](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a315ca917ad583797f709ea477dd28705) language)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| int       | [sysSetCVVDeactivation](#ga0ee790d0fb18e5083f51b13595cf497c) (unsigned char deactivate)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| int       | [sysSetCardEntryMode](#gab36d0bea0c486f3c6011bcb39e1f708c) (unsigned char mode)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| int       | [sysSetDisplayBacklight](#gaf0686bd5790182aa13c9bf357dcc7d7d) (unsigned char backlight)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| int       | [sysSetDisplayConstrast](#ga967e25786eab08f36a0c0898b596f897) (unsigned char contrast)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| int       | [sysGetKSN](#ga39444f5aad6fae3dcbc7ca49bb7f169a) ([KSNSelection](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#add4280440188ede2e1f6ea4397df6cfa) which, [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&out)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| int       | [sysAuthStep1](#ga5168e5e231b33ac39248376c92c84d83) (const [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/structvfisdi_1_1_array.md)< 16 > \&hostRandom, [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/structvfisdi_1_1_array.md)< 32 > \&serverData, [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&ksn)                                                                                                                                                                                                                                                                                                                                                                                                                      |
| int       | [sysAuthStep2](#ga43f8cfaccb41c4b3e73ecacac524cc14) (const [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/structvfisdi_1_1_array.md)< 32 > \&hostData, [Array](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/structvfisdi_1_1_array.md)< 32 > \&serverData)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| int       | [sysSetIdleText](#gaaaf5929f91bcc56ce5e0c4e930b3eed6) (const std::string \&text)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| int       | [sysClearIdleText](#gabb0e1911d5072f1a3d14b313501d0a11) ()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| int       | [sysUploadBegin](#ga9f6703b20083d77a2bc09ae3e8741771) (const std::string \&filename, [SYSUploadType](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#af55973ce01a27acae146f17b4a0366fa) type=[SYS\_UPLOAD\_SOFTWARE\_UPDATE](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#af55973ce01a27acae146f17b4a0366faa45f06815e16da88212b9ee5ed2f3ddc8), int dest=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| int       | [sysUploadData](#gacba3dc1703d99fc2d4b7a5b763f2da10) (const void \*packet, unsigned size, int packet\_no, int dest=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| int       | [sysUploadEnd](#ga8ab36922e973801b2b45803208c0c4f9) (const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \*md5=0, const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \*mac=0, int dest=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| int       | [sysUpload](#ga358df855cbad214ec3340bb976dff4d9) (const std::string \&filename, const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&data, [SYSUploadType](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#af55973ce01a27acae146f17b4a0366fa) type=[SYS\_UPLOAD\_SOFTWARE\_UPDATE](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#af55973ce01a27acae146f17b4a0366faa45f06815e16da88212b9ee5ed2f3ddc8), const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \*md5=0, const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \*mac=0, int dest=1) |
| int       | [sysShutdown](#ga014fa2a5e800e62c61ce747292407e59) ()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| int       | [sysReboot](#ga87aee721c6d116ee2f974db6efe85fe7) ()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| int       | [sysSleep](#ga52a26c8a62e227a00ec702bb9b3b2082) ()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| int       | [sysHibernate](#ga0660fa6f7eecf4b5925d312333e358a4) ()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| int       | [sysShowMACDesktop](#ga4f3eacc3478548919e6a19cd20c5bf5d) ()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| int       | [sysSetPropertyString](#gaa90a2a61e90239e655f5798fe8138929) (int property, const std::string \&in, int dest=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| int       | [sysSetPropertyInt](#ga7c674016f7f7360cad04c180a9a2f687) (int property, int in, int dest=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| int       | [sysGetPropertyString](#gacc125e4c576a0e8d19bf03df8c198904) (int property, std::string \&out, int dest=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| int       | [sysGetPropertyInt](#ga37e6626374e1fcd0e155ce8479c2ae68) (int property, int \&out, int dest=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| int       | [sysInstallSponsorCert](#ga7f438fca0104c137edee4cdd3d5e22ae) (const [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&cert)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| int       | [sysGetSDIVersion](#ga5bb253079c8feedc3ae93c855f721a15) (std::vector< [ComponentVersion](#structvfisdi_1_1_s_d_i_client_1_1_component_version) > \&info, unsigned char device=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| int       | [sysInstallUpdate](#ga1782bace2e44b08df3f5bf98fa7e8e5f) ([SYSUpdateType](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#ae85b937298c01c4202810ff9a3133b11) type)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| int       | [sysInstallResult](#ga38ac875ac5b4276dd3e6d3ba229c58b9) (std::string \&result, unsigned char device=1)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| int       | [sysEnableEPP](#gadb6da218490ec0f55e357550362a7eb9) (bool enable)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| int       | [sysFactoryReset](#gaf6cffadf0636bda10038b2569e76719a) ()                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| int       | [sysReadCert](#ga2d26df79f3db64673a382881b653fcf5) (const std::string \&name, [bytevector](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfisdi_1_1_s_d_i_client.md#a64b5be62be31dcda165d2c6c3c262fb5) \&cert)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| int       | [sysSetCurrencyDisplay](#gaca65ca02efc350a8ac4537dbdf32ca50) (enum [Currency](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a59f74bf9ae55ffd390b8806b2559021c) currency, enum [CurrencyDisplay](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#ac8c9a7e6b9069dbf93c0520716472812) display)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

### DetailedDescription <a href="#detailed-description" id="detailed-description"></a>

***

### DataStructure Documentation <a href="#data-structure-documentation" id="data-structure-documentation"></a>

### vfisdi::SDIClient::ComponentVersion <a href="#structvfisdi_1_1_s_d_i_client_1_1_component_version" id="structvfisdi_1_1_s_d_i_client_1_1_component_version"></a>

struct vfisdi::SDIClient::ComponentVersion

component version information

|             |         |                       |
| ----------- | ------- | --------------------- |
| Data Fields |         |                       |
| string      | name    | name of the component |
| string      | version | version information   |

### FunctionDocumentation <a href="#function-documentation" id="function-documentation"></a>

### sysAbort() <a href="#gaaa584883946486751113f98b317623df" id="gaaa584883946486751113f98b317623df"></a>

int sysAbort

abort the current command in progress (20-02)

{% hint style="info" %}
Not all commands can be aborted.
{% endhint %}

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysAuthStep1() <a href="#ga5168e5e231b33ac39248376c92c84d83" id="ga5168e5e231b33ac39248376c92c84d83"></a>

int sysAuthStep1

mutual auth and session key setup step 1 (20-11)

**Parameters**

\[in] **hostRandom** host random number \[out] **serverData** encrypted SDI server data. After decryption contains 16 bytes SDI server token and 16 bytes SDI server random number \[out] **ksn** key serial number

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysAuthStep2() <a href="#ga43f8cfaccb41c4b3e73ecacac524cc14" id="ga43f8cfaccb41c4b3e73ecacac524cc14"></a>

int sysAuthStep2

mutual auth and session key setup step 2 (20-11)

**Parameters**

\[in] **hostData** encrypted host data \[out] **serverData** encrypted SDI server data. After decryption contains 16 bytes host token and 16 bytes SDI server serial number

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysClearIdleText() <a href="#gabb0e1911d5072f1a3d14b313501d0a11" id="gabb0e1911d5072f1a3d14b313501d0a11"></a>

int sysClearIdleText

clear the idle text (20-13)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysEnableEPP() <a href="#gadb6da218490ec0f55e357550362a7eb9" id="gadb6da218490ec0f55e357550362a7eb9"></a>

int sysEnableEPP

Enable EPP (20-21)

**Parameters**

\[in] **enable** if true enable EPP, else disable

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysFactoryReset() <a href="#gaf6cffadf0636bda10038b2569e76719a" id="gaf6cffadf0636bda10038b2569e76719a"></a>

int sysFactoryReset

Trigger factory reset (20-22)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetApplicationSoftwareID() <a href="#gac2ec2c92bfb5beba8b26b7063798f292" id="gac2ec2c92bfb5beba8b26b7063798f292"></a>

int sysGetApplicationSoftwareID

Read application software ID (20-03)

**Parameters**

\[out] **id** ID

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetBatteryStatus() <a href="#gacd3edebd1174d3398320769e6208a50c" id="gacd3edebd1174d3398320769e6208a50c"></a>

int sysGetBatteryStatus

Get battery status

**Parameters**

\[out] **charge\_level** charge level in percent \[out] **charge\_status** charge\_status: 0: in progress, 1: finished, 2: suspended, 3: error

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetBatteryVoltage() <a href="#ga21ec43a34504219da1656b945530b231" id="ga21ec43a34504219da1656b945530b231"></a>

int sysGetBatteryVoltage

Get battery voltage (20-04)

**Parameters**

\[out] **voltage** battery voltage

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetBootSoftwareID() <a href="#gae02f6e7a29647f0c172d4321370cecf0" id="gae02f6e7a29647f0c172d4321370cecf0"></a>

int sysGetBootSoftwareID

Read boot software ID (20-03)

**Parameters**

\[out] **id** ID

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetCardEntryMode() <a href="#ga3fb40f1c66989d42fa78b046caa0b342" id="ga3fb40f1c66989d42fa78b046caa0b342"></a>

int sysGetCardEntryMode

Get card entry mode (20-04)

**Parameters**

\[out] **mode** card entry mode

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetConfig() <a href="#ga7f25a798b839c063cbd06d44e0313613" id="ga7f25a798b839c063cbd06d44e0313613"></a>

int sysGetConfig

Read configuration parameters. Check the SDI server documentation for details about the DOL and COL format. (20-03)

**Parameters**

\[in] **req** read request in DOL or COL format \[out] **out** requested configuration parameters

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetCPUID() <a href="#gaf233502e71652c8d51917e15bc22a7e8" id="gaf233502e71652c8d51917e15bc22a7e8"></a>

int sysGetCPUID

Read CPU unique ID (20-03)

**Parameters**

\[out] **id** ID

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetCVVDeactivation() <a href="#ga4f956cba60843a3b06d425f49fcd09d1" id="ga4f956cba60843a3b06d425f49fcd09d1"></a>

int sysGetCVVDeactivation

Get CVV deactivation (20-04)

**Parameters**

\[out] **cfg** Card Entry Value Deactivation

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetDateTime() <a href="#ga41e7b1518505a9f0a34253a57c3e597f" id="ga41e7b1518505a9f0a34253a57c3e597f"></a>

int sysGetDateTime

Get date and time (20-04)

**Parameters**

\[out] **year** year including century (e.g. 2020) \[out] **month** month (1..12) \[out] **day** day (1..31) \[out] **hour** hour (0..23) \[out] **minute** minute (0..59) \[out] **second** second (0..59)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetEMVL2ID() <a href="#gafa12882d0135fa7897f2f64982c33320" id="gafa12882d0135fa7897f2f64982c33320"></a>

int sysGetEMVL2ID

Read EMV L2 ID (20-03)

**Parameters**

\[out] **id** ID

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetHardwareID() <a href="#ga49b22bbb731a1d9d16c0ca99802e1254" id="ga49b22bbb731a1d9d16c0ca99802e1254"></a>

int sysGetHardwareID

Read hardware ID (20-03)

**Parameters**

\[out] **id** ID

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetIFMID() <a href="#gaf95a9d826bd2aeb89d1fb943e2ea3fce" id="gaf95a9d826bd2aeb89d1fb943e2ea3fce"></a>

int sysGetIFMID

Read IFM ID (20-03)

**Parameters**

\[out] **id** ID

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetKSN() <a href="#ga39444f5aad6fae3dcbc7ca49bb7f169a" id="ga39444f5aad6fae3dcbc7ca49bb7f169a"></a>

int sysGetKSN

read the key serial number (20-10)

**Parameters**

\[in] **which** selects which KSN to read \[out] **out** read KSN

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetLanguage() <a href="#ga5bfe0a8a267e7e674283b92e05de3cce" id="ga5bfe0a8a267e7e674283b92e05de3cce"></a>

int sysGetLanguage

Get language (20-04)

**Parameters**

\[out] **language** language

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetPropertyInt() <a href="#ga37e6626374e1fcd0e155ce8479c2ae68" id="ga37e6626374e1fcd0e155ce8479c2ae68"></a>

int sysGetPropertyInt

read int property (20-1A)

**Parameters**

\[in] **property** property ID (SYSPropertyInt) \[out] **out** read property \[in] **dest** display destination: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetPropertyString() <a href="#gacc125e4c576a0e8d19bf03df8c198904" id="gacc125e4c576a0e8d19bf03df8c198904"></a>

int sysGetPropertyString

read string property (20-1A)

**Parameters**

\[in] **property** property ID (SYSPropertyString) \[out] **out** read property \[in] **dest** display destination: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetSDIVersion() <a href="#ga5bb253079c8feedc3ae93c855f721a15" id="ga5bb253079c8feedc3ae93c855f721a15"></a>

int sysGetSDIVersion

Get version information of basic SDI components and installed SDI plugins (20-1C)

**Parameters**

\[out] **info** array with component version information \[in] **device** device: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetSerialNumber() <a href="#ga86c99be3edd67ee31ae80ebcd610aab0" id="ga86c99be3edd67ee31ae80ebcd610aab0"></a>

int sysGetSerialNumber

Read serial number (20-03)

**Parameters**

\[out] **sn** serial number

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetStatus() <a href="#ga8b4f5e6d6d12cf5760153114bc3d371f" id="ga8b4f5e6d6d12cf5760153114bc3d371f"></a>

int sysGetStatus

Read device status information from PINPad (20-04)

**Parameters**

\[in] **req** read request in DOL or COL format \[out] **out** device status information

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysGetTamperStatus() <a href="#gaab4470413c2c1cbdf6a25cca76795cfa" id="gaab4470413c2c1cbdf6a25cca76795cfa"></a>

int sysGetTamperStatus

Get tamper status (20-04)

**Parameters**

\[out] **tamper** tamper status

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysHibernate() <a href="#ga0660fa6f7eecf4b5925d312333e358a4" id="ga0660fa6f7eecf4b5925d312333e358a4"></a>

int sysHibernate

set system to hibernate state (20-17)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysInstallResult() <a href="#ga38ac875ac5b4276dd3e6d3ba229c58b9" id="ga38ac875ac5b4276dd3e6d3ba229c58b9"></a>

int sysInstallResult

Get installation result (20-1E)

**Parameters**

\[out] **result** JSON string containing installation errors (DFA148) \[in] **device** device: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysInstallSponsorCert() <a href="#ga7f438fca0104c137edee4cdd3d5e22ae" id="ga7f438fca0104c137edee4cdd3d5e22ae"></a>

int sysInstallSponsorCert

install DER encoded X.509 certficate (20-1B)

**Parameters**

\[in] **cert** certificate

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysInstallUpdate() <a href="#ga1782bace2e44b08df3f5bf98fa7e8e5f" id="ga1782bace2e44b08df3f5bf98fa7e8e5f"></a>

int sysInstallUpdate

Install update, that has been uploaded before. (20-1D)

**Parameters**

\[in] **type** update type

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysReadCert() <a href="#ga2d26df79f3db64673a382881b653fcf5" id="ga2d26df79f3db64673a382881b653fcf5"></a>

int sysReadCert

read X509 certificate from keystore (20-23)

**Parameters**

\[in] **name** certificate name \[out] **cert** certificate in DER format

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysReboot() <a href="#ga87aee721c6d116ee2f974db6efe85fe7" id="ga87aee721c6d116ee2f974db6efe85fe7"></a>

int sysReboot

perform system reboot (20-17)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetCardEntryMode() <a href="#gab36d0bea0c486f3c6011bcb39e1f708c" id="gab36d0bea0c486f3c6011bcb39e1f708c"></a>

int sysSetCardEntryMode

Set card entry mode (20-09)

**Parameters**

\[in] **mode** card entry mode

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetCurrencyDisplay() <a href="#gaca65ca02efc350a8ac4537dbdf32ca50" id="gaca65ca02efc350a8ac4537dbdf32ca50"></a>

int sysSetCurrencyDisplay

switch whether the currency is displayed using a symbol or an abbreviation for currencies that support it. This setting is persistent. (20-24)

**Parameters**

\[in] **currency** currency for which to change the setting \[in] **display** display configuration

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetCVVDeactivation() <a href="#ga0ee790d0fb18e5083f51b13595cf497c" id="ga0ee790d0fb18e5083f51b13595cf497c"></a>

int sysSetCVVDeactivation

Set CVV deactivation (20-09)

**Parameters**

\[in] **deactivate** deactivation value

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetDateTime() <a href="#ga2e7b93e265700b9d778b01c11b95fe5f" id="ga2e7b93e265700b9d778b01c11b95fe5f"></a>

int sysSetDateTime

Set date and time (20-09)

**Parameters**

\[in] **year** year including century (e.g. 2020) \[in] **month** month (1..12) \[in] **day** day (1..31) \[in] **hour** hour (0..23) \[in] **minute** minute (0..59) \[in] **second** second (0..59)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetDisplayBacklight() <a href="#gaf0686bd5790182aa13c9bf357dcc7d7d" id="gaf0686bd5790182aa13c9bf357dcc7d7d"></a>

int sysSetDisplayBacklight

Set display backlight (20-09)

**Parameters**

\[in] **backlight** backlight

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetDisplayConstrast() <a href="#ga967e25786eab08f36a0c0898b596f897" id="ga967e25786eab08f36a0c0898b596f897"></a>

int sysSetDisplayConstrast

Set display contrast (20-09)

**Parameters**

\[in] **contrast** contrast

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetIdleText() <a href="#gaaaf5929f91bcc56ce5e0c4e930b3eed6" id="gaaaf5929f91bcc56ce5e0c4e930b3eed6"></a>

int sysSetIdleText

set the idle text (20-13)

**Parameters**

\[in] **text** idle text

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetLanguage() <a href="#gad78e48f51cb1c87de771a7ddd67b394e" id="gad78e48f51cb1c87de771a7ddd67b394e"></a>

int sysSetLanguage

Set language (20-09)

**Parameters**

\[in] **language** language

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetPropertyInt() <a href="#ga7c674016f7f7360cad04c180a9a2f687" id="ga7c674016f7f7360cad04c180a9a2f687"></a>

int sysSetPropertyInt

set int property (20-19)

**Parameters**

\[in] **property** property ID (SYSPropertyInt) \[in] **in** new property value \[in] **dest** display destination: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSetPropertyString() <a href="#gaa90a2a61e90239e655f5798fe8138929" id="gaa90a2a61e90239e655f5798fe8138929"></a>

int sysSetPropertyString

set string property (20-19)

**Parameters**

\[in] **property** property ID (SYSPropertyString) \[in] **in** new property value \[in] **dest** display destination: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysShowMACDesktop() <a href="#ga4f3eacc3478548919e6a19cd20c5bf5d" id="ga4f3eacc3478548919e6a19cd20c5bf5d"></a>

int sysShowMACDesktop

show MAC desktop (20-18)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysShutdown() <a href="#ga014fa2a5e800e62c61ce747292407e59" id="ga014fa2a5e800e62c61ce747292407e59"></a>

int sysShutdown

perform system shutdown (20-17)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysSleep() <a href="#ga52a26c8a62e227a00ec702bb9b3b2082" id="ga52a26c8a62e227a00ec702bb9b3b2082"></a>

int sysSleep

set system to sleep state (20-17)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysUpload() <a href="#ga358df855cbad214ec3340bb976dff4d9" id="ga358df855cbad214ec3340bb976dff4d9"></a>

int sysUpload

upload software or configuration, shortcut for sysUploadBegin/Data/End (20-14/20-15/20-16)

**Parameters**

\[in] **filename** filename including extension or empty string if not required \[in] **data** data to be uploaded, splitting into data chunks is performed internally \[in] **type** configuration file type \[in] **md5** optional MD5 checksum or NULL \[in] **mac** optional MAC or NULL \[in] **dest** display destination: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysUploadBegin() <a href="#ga9f6703b20083d77a2bc09ae3e8741771" id="ga9f6703b20083d77a2bc09ae3e8741771"></a>

int sysUploadBegin

begin software or configuration package upload. (20-14)

**Parameters**

\[in] **filename** filename including extension (mandatory in case of software update) \[in] **type** configuration type \[in] **dest** display destination: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

{% hint style="info" %}
After a successfull call to [sysUploadBegin()](#ga9f6703b20083d77a2bc09ae3e8741771), [sysUploadData()](#gacba3dc1703d99fc2d4b7a5b763f2da10) is used to transmit the data in chunks. [sysUploadEnd()](#ga8ab36922e973801b2b45803208c0c4f9) completes the upload. It must be invoked also if [sysUploadData()](#gacba3dc1703d99fc2d4b7a5b763f2da10) reports an error to clean up resources.
{% endhint %}

### sysUploadData() <a href="#gacba3dc1703d99fc2d4b7a5b763f2da10" id="gacba3dc1703d99fc2d4b7a5b763f2da10"></a>

int sysUploadData

upload data chunk (20-15)

**Parameters**

\[in] **packet** data chunk \[in] **size** chunk size, the maximum size depends on the protocol type \[in] **packet\_no** packet number. The first packet should be number 1 \[in] **dest** display destination: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))

### sysUploadEnd() <a href="#ga8ab36922e973801b2b45803208c0c4f9" id="ga8ab36922e973801b2b45803208c0c4f9"></a>

int sysUploadEnd

finalize software upload (20-16)

**Parameters**

\[in] **md5** optional MD5 checksum or NULL \[in] **mac** optional MAC or NULL \[in] **dest** display destination: countertop=1, EPP=2 (DFA150)

#### Returns

SDI error code ([Result](/adk-5.0-programmers-guide/readme/namespaces/namespacevfisdi.md#a28287671eaf7406afd604bd055ba4066))


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://sandbox-docs.verifone.com/adk-5.0-programmers-guide/readme/modules/group__sdisystem.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
