> 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/sysinfo_8h_source.md).

# sysinfo.h

[Go to the documentation of this file.](/adk-5.0-programmers-guide/readme/files/dir_a221c7c7a3d266b8aa1c13ced02d08a5/dir_1084a09caae2cca43d02da13ecc9a141/dir_8b8eef682edb37a46c9343899b359ed7/sysinfo_8h.md)

```cpp
 1 #pragma once
 2 
 8 #include <string>
 9 #include "dllspec.h"
 10 #include "syserror.h"
 11 
 12 #ifndef DOXYGEN
 13 
 14 namespace vfisysinfo
 15 {
 16 #endif
 17 
 18 
 20 enum displayContrastConstants
 21 {
 22  ContrastMin = 1,
 23  ContrastDefault = 8,
 24  ContrastMax = 15,
 25  ContrastUp = 64,
 26  ContrastDown = 65
 27 };
 28 
 30 enum batteryTechnology
 31 {
 32  BattTUnknown = 0,
 33  BattTNiMH = 1,
 34  BattTLiIon = 2,
 35  BattTLiPoly = 3,
 36  BattTLiFe = 4,
 37  BattTNiCd = 5,
 38  BattTLiMn = 6
 39 };
 40 
 42 enum deviceMode
 43 {
 44  DEVICE_MANUF = 0,
 45  DEVICE_PROD = 1,
 46  DEVICE_OS_DEV = 2,
 47  DEVICE_CP_DEV = 3
 48 };
 49 
 51 enum batteryChargeMode
 52 {
 53  UNRESTRICTED_CHARGE_MODE = 1,
 54  CAR_CHARGER_MODE = 2,
 55 };
 56 
 58 enum chargingPort
 59 {
 60  CHARGING_USB_C_PORT = 0,
 61  CHARGING_POGO_PORT = 1,
 62 };
 63 
 65 enum sysUSBmode
 66 {
 67  SYS_USB_UNKNOWN = 0,
 68  SYS_USB_DEFAULT = 1,
 69  SYS_USB_HOST = 2,
 70  SYS_USB_DEVICE = 3,
 71 };
 72 
 74 enum deviceType
 75 {
 76  DEVICE_NON_PORTABLE = 0,
 77  DEVICE_HANDSET = 1,
 78  DEVICE_BASE = 2,
 79  DEVICE_MOBILE = 3
 80 };
 81 
 83 enum batteryType
 84 {
 85  BATTERY_TYPE_SMART = 1,
 86  BATTERY_TYPE_SIMPLE = 2
 87 };
 88 
 91 enum keyboardType
 92 {
 93  KEYBOARD_TYPE_UNKNOWN = 0,
 94  KEYBOARD_TYPE_STANDARD = 3,
 95  KEYBOARD_TYPE_EBS100 = 4,
 96  KEYBOARD_TYPE_ARABIC = 5,
 97  KEYBOARD_TYPE_RNIB = 6
 98 };
 99 
 101 enum SYSPropertyInt
 102 {
 103  SYS_PROP_BATTERY_AVAILABLE=0,
 104  SYS_PROP_BATTERY_STATUS_OK=1,
 105  SYS_PROP_BATTERY_DEVICE=2,
 106  SYS_PROP_BATTERY_VOLTAGE=3,
 107  SYS_PROP_BATTERY_CAPACITY=4,
 108  SYS_PROP_BATTERY_CHARGE_LEVEL=5,
 109  SYS_PROP_BATTERY_CHARGING=10,
 110  SYS_PROP_BATTERY_FULL=11,
 111  SYS_PROP_BATTERY_TEMP=13,
 112  SYS_PROP_BATTERY_CURRENT=14,
 113  SYS_PROP_BATTERY_CRITICAL=18,
 114  SYS_PROP_BATTERY_LOW=19,
 115  SYS_PROP_BATTERY_NORMAL=20,
 116  SYS_PROP_BATTERY_TECHNOLOGY=700,
 117  SYS_PROP_BATTERY_FCC=701,
 118  SYS_PROP_BATTERY_SOH=702,
 119  SYS_PROP_BATTERY_CHARGE_IN_SLEEP=21,
 120  SYS_PROP_BATTERY_CALIBRATION=705,
 121  SYS_PROP_BATTERY_TYPE=706,
 122  SYS_PROP_BATTERY_CHARGE_MODE=707,
 123  SYS_PROP_CHARGE_CYCLE_COUNT=704,
 124  SYS_PROP_UX100_AVAILABLE=22,
 125  SYS_PROP_UX100_OPERATIONAL_MODE=24,
 126  SYS_PROP_UX100_BACKLIGHT=209,
 127  SYS_PROP_UX400_AVAILABLE=23,
 128  SYS_PROP_UX115_UNIT=26,
 129  SYS_PROP_UX_UNIT=25,
 130  SYS_PROP_INTERNAL_BATTERY_STATUS=7,
 131  SYS_PROP_INTERNAL_BATTERY_VOLTAGE=8,
 132  SYS_PROP_DOCKING_STATUS=6,
 133  SYS_PROP_DOCK_SUPPORT=15,
 134  SYS_PROP_USB1_MODE=16,
 135  SYS_PROP_USB2_MODE=17,
 136  SYS_PROP_USB1_CONFIGURABLE=27,
 137  SYS_PROP_USB2_CONFIGURABLE=28,
 138  SYS_PROP_USB1_DEFAULT=29,
 139  SYS_PROP_USB2_DEFAULT=30,
 140  SYS_PROP_USB1_CHARGE=31,
 141  SYS_PROP_USB2_CHARGE=32,
 142  SYS_PROP_USB_HIGH_POWER_MODE=38,
 143  SYS_PROP_PRINTER_AVAILABLE=9,
 144  SYS_PROP_POWER_STATUS=12,
 145  SYS_PROP_POWER_ON=39,
 146  SYS_PROP_CHARGE_ON_SAVING=703,
 147  SYS_PROP_KEYBOARD_BEEP=100,
 148  SYS_PROP_KEYB_BACKLIGHT=101,
 149  SYS_PROP_KEYBOARD_HW=102,
 150  SYS_PROP_KEYBOARD_SIZE=103,
 151  SYS_PROP_DISP_CONTRAST=200,
 152  SYS_PROP_DISP_BACKLIGHT=201,
 153  SYS_PROP_DISP=202,
 154  SYS_PROP_DISP_HW=203,
 155  SYS_PROP_DISP_COLOR=205,
 156  SYS_PROP_DISP_HEIGHT=206,
 157  SYS_PROP_DISP_WIDTH=207,
 158  SYS_PROP_DISP_TOUCH=208,
 159  SYS_PROP_ANDROID=204,
 160  SYS_PROP_HW_RAM_SIZE=300,
 161  SYS_PROP_HW_RAM_USED=302,
 162  SYS_PROP_HW_FLASH_SIZE=301,
 163  SYS_PROP_HW_FLASH_USED=303,
 164  SYS_PROP_HW_EXE_PARTITION_SIZE=307,
 165  SYS_PROP_HW_EXE_PARTITION_USED=308,
 166  SYS_PROP_HW_DATA_PARTITION_SIZE=309,
 167  SYS_PROP_HW_DATA_PARTITION_USED=310,
 168  SYS_PROP_HW_SYSDATA_PARTITION_SIZE=311,
 169  SYS_PROP_HW_SYSDATA_PARTITION_USED=312,
 170  SYS_PROP_HW_TOUCH_GROUNDED=306,
 171  SYS_PROP_LED=304,
 172  SYS_PROP_PCI=305,
 173  SYS_PROP_VOLUME=400,
 174  SYS_PROP_SPEAKER_AVAILABLE=401,
 175  SYS_PROP_BUZZER_AVAILABLE=402,
 176  SYS_PROP_ADE_STATUS=500,
 177  SYS_PROP_CERT_SPONSOR_PROD=501,
 178  SYS_PROP_ATTACK_STATUS=502,
 179  SYS_PROP_ATTACK_STATUS_CODE=513,
 180  SYS_PROP_VCL_ENCRYPTION_STATUS=503,
 181  SYS_PROP_VOLTAGE_ENCRYPTION_STATUS=504,
 182  SYS_PROP_POSEIDON_ENCRYPTION_STATUS=505,
 183  SYS_PROP_NAVIGATOR_STATUS=506,
 184  SYS_PROP_SERVICE_SWITCH_STATUS=507,
 185  SYS_PROP_DEVICE_MODE=508,
 186  SYS_PROP_SYSMODE_BUTTON=509,
 187  SYS_PROP_DEVICE_TYPE=510,
 188  SYS_PROP_VATS=512,
 189  SYS_PROP_UX100_ANTI_REMOVAL_SWITCH=511,
 190  SYS_PROP_SLP_TAINTED_STATUS=514,
 191  SYS_PROP_UPTIME=600,
 192  SYS_PROP_BARCODE_SCANNER=33,
 193  SYS_PROP_CAMERA=34,
 194  SYS_PROP_SWITCH_THRESHOLD_VOLTAGE=35,
 195  SYS_PROP_LOW_THRESHOLD_VOLTAGE=36,
 196  SYS_PROP_CONSOLE_STATE=37,
 197  SYS_PROP_UX_MDB = 40,
 198  SYS_PROP_CARD_SLOT2_MODE=41,
 199  SYS_PROP_CARD_SLOT_COUNT=42,
 200  SYS_PROP_KEYBOARD_TYPE=43,
 201  SYS_PROP_EXT_NFC_ANTENNA=44,
 202  SYS_PROP_VRK2_SUPPORT=45,
 203  SYS_PROP_USB_C_CHARGING_STATE=708,
 204  SYS_PROP_POGO_CHARGING_STATE=709,
 205  SYS_PROP_ECC_VRK_SUPPORT=46,
 206  SYS_PROP_LCD_PANEL_ID=47,
 207  SYS_PROP_VRK_CERT_INSTALLED=48,
 208  SYS_PROP_VRK_PACKAGING_UVRK_SUPPORT=49,
 209  SYS_PROP_POGO_DATA_STATE=710,
 210  SYS_PROP_ANDROID_PREFIX_LENGTH=50,
 211  SYS_PROP_UX100_TYPE=51,
 212  SYS_PROP_USB_AUDIO_JACK_STATE=52,
 213  SYS_PROP_UEPP_AVAILABLE=53,
 214  SYS_PROP_UEPP_TYPE=54,
 215  SYS_PROP_UEPP_BACKLIGHT=55,
 216  SYS_PROP_UEPP_OPERATIONAL_MODE=56,
 217  SYS_PROP_HEADPHONES_JACK_STATUS=57,
 218  SYS_PROP_DIAG_DOCK_EVENTS=800,
 219  SYS_PROP_DIAG_SYSTEM_BOOT_CYCLES=801,
 220  SYS_PROP_DIAG_SYSTEM_TOTAL_UPTIME=802,
 221  SYS_PROP_DIAG_KEYBOARD_PRESSES=803,
 222  SYS_PROP_DIAG_MSR_SWIPES=804,
 223  SYS_PROP_DIAG_MSR_ERRORS=805,
 224  SYS_PROP_DIAG_MSR_SWIPES_EMPTY=806,
 225  SYS_PROP_DIAG_ICC_INSERTIONS=807,
 226  SYS_PROP_DIAG_ICC_INSERTIONS_OK=808,
 227  SYS_PROP_DIAG_ICC_INSERTIONS_ERRORS=809,
 228  SYS_PROP_DIAG_PRINTER_PAPER_FEEDS=810,
 229  SYS_PROP_DIAG_PRINTER_ERRORS=811,
 230 };
 231 
 233 enum SYSPropertyString
 234 {
 235  SYS_PROP_HW_MODEL_NAME=0,
 236  SYS_PROP_HW_MODEL_NAME_SHORT=54,
 237  SYS_PROP_HW_SERIALNO=1,
 238  SYS_PROP_OS_VERSION=2,
 239  SYS_PROP_HW_PTID=3,
 240  SYS_PROP_HW_VARIANT_NAME=4,
 241  SYS_PROP_HW_PART_NO=5,
 242  SYS_PROP_HW_VERSION=6,
 243  SYS_PROP_HW_LOT_NO=7,
 244  SYS_PROP_BOOT_VERSION=8,
 245  SYS_PROP_TERMINAL_SPONSOR=9,
 246  SYS_PROP_MANUF_DATE=10,
 247  SYS_PROP_CERT_SPONSOR_SN=11,
 248  SYS_PROP_CERT_SPONSOR_MODE=12,
 249  SYS_PROP_ADK_VERSION=14,
 250  SYS_PROP_UX100_SERIALNO=13,
 251  SYS_PROP_UX100_PARTNO=65,
 252  SYS_PROP_UX100_FW_VERSION=15,
 253  SYS_PROP_SBI_VERSION=16,
 254  SYS_PROP_VAULT_VERSION=17,
 255  SYS_PROP_CIB_VERSION=18,
 256  SYS_PROP_MIB_VERSION=19,
 257  SYS_PROP_KERNEL_VERSION=20,
 258  SYS_PROP_RFS_VERSION=21,
 259  SYS_PROP_RELEASE_VERSION=22,
 260  SYS_PROP_RFS_SECURITY_VERSION=23,
 261  SYS_PROP_SRED_VERSION=24,
 262  SYS_PROP_SRED_MODE=75,
 263  SYS_PROP_OPENPROTOCOL_VERSION=25,
 264  SYS_PROP_PCI_REBOOT_TIME=26,
 265  SYS_PROP_FILE_NAME_TO_INSTALL=27,
 266  SYS_PROP_MSR_COUNTERS=29,
 267  SYS_PROP_SCR_COUNTERS=30,
 268  SYS_PROP_CTLS_COUNTERS=58,
 269  SYS_PROP_DOCK_STATION_SN=31,
 270  SYS_PROP_DOCK_STATION_PN=32,
 271  SYS_PROP_DOCK_STATION_MODEL=33,
 272  SYS_PROP_DOCK_STATION_MAC=34,
 273  SYS_PROP_DOCK_STATION_HW_REV=35,
 274  SYS_PROP_DOCK_STATION_INSTALL=36,
 275  SYS_PROP_GSM_FIRMWARE_VERSION=37,
 276  SYS_PROP_DOCK_STATION_OS_VERSION=38,
 277  SYS_PROP_DOCK_STATION_IP_ADDRESS=39,
 278  SYS_PROP_DOCK_STATION_IP_V6_ADDRESS=51,
 279  SYS_PROP_DOCK_STATION_USB1_IP_ADDRESS=57,
 280  SYS_PROP_ANDROID_IP_V4_ADDRESS=59,
 281  SYS_PROP_ANDROID_IP_V6_ADDRESS=66,
 282  SYS_PROP_ANDROID_MAC=67,
 283  SYS_PROP_WARRANTIED_KEYS=53,
 284  SYS_PROP_SECAPP_VERSION=40,
 285  SYS_PROP_VSS_VERSION=41,
 286  SYS_PROP_STBY_MCU_VERSION=42,
 287  SYS_PROP_EXT_STORAGE=43,
 288  SYS_PROP_INSTALLED_PCKG_LIST=28,
 289  SYS_PROP_PKG_LIST=28,
 290  SYS_PROP_APP_PKG_LIST=44,
 291  SYS_PROP_BUNDLE_LIST=45,
 292  SYS_PROP_APP_BUNDLE_LIST=49,
 293  SYS_PROP_MSR_INFO=46,
 294  SYS_PROP_SCR_INFO=47,
 295  SYS_PROP_CTLS_INFO=48,
 296  SYS_PROP_HW_STRING=50,
 297  SYS_PROP_DEV_ID=52,
 298  SYS_PROP_FET=55,
 299  SYS_PROP_BT_MAC=60,
 300  SYS_PROP_WIFI_MAC=61,
 301  SYS_PROP_ETH_MAC=62,
 302  SYS_PROP_ETH2_MAC=63,
 303  SYS_PROP_COUNTRY=64,
 304  SYS_PROP_RTC=100,
 305  SYS_PROP_NTP_SERVER=101,
 306  SYS_PROP_BATTERY_SERIALNO=200,
 307  SYS_PROP_TIME_ZONE=300,
 308  SYS_PROP_TIME_ZONE_LIST=301,
 309  SYS_PROP_TIME_ZONE_FROM_FILE=302,
 310  SYS_PROP_TIME_ZONE_NAME=304,
 311  SYS_PROP_TIME_ISO8601=303,
 312  SYS_PROP_REBOOT_REASON=400,
 313  SYS_PROP_ALL_LOADED_KEYS=56,
 314  SYS_PROP_ALL_LOADED_KEYS_V2=80,
 315  SYS_PROP_TAMPER_RECORDS=68,
 316  SYS_PROP_BARCODE_SCANNER_FW_VERSION=69,
 317  SYS_PROP_ANDROID_VERSION=70,
 318  SYS_PROP_STATUSBAR_COLOR=71,
 319  SYS_PROP_ANDROID_TIME=72,
 320  SYS_PROP_MTD_INFO=73,
 321  SYS_PROP_HW_ID=74,
 322  SYS_PROP_LCD_PANEL_MODEL=76,
 323  SYS_PROP_DT_NAME=77,
 324  SYS_PROP_PCI_APPS=78,
 325  SYS_PROP_FW_PCI_VERSION=79,
 326  SYS_PROP_HW_MODEL_NAME_SEC=81,
 327  SYS_PROP_MOBILE_RADIO_SW_VERSION=82,
 328  SYS_PROP_TOUCH_NAME=83,
 329  SYS_PROP_TOUCH_HW_VERSION=84,
 330  SYS_PROP_TOUCH_SW_VERSION=85,
 331  SYS_PROP_TOUCH_CONFIG_VERSION=86,
 332  SYS_PROP_ANDROID_GATEWAY=87,
 333  SYS_PROP_ANDROID_DNS1=88,
 334  SYS_PROP_ANDROID_DNS2=89,
 335  SYS_PROP_SECURE_CHIP_FW_VERSION=90,
 336  SYS_PROP_UEPP_FW_VERSION=91,
 337  SYS_PROP_UEPP_SERIALNO=92,
 338  SYS_PROP_UEPP_PARTNO=93,
 339 };
 340 
 346 SYS_INFO_API int sysGetPropertyInt(enum SYSPropertyInt property, int & value);
 347 
 353 SYS_INFO_API int sysGetPropertyInt(enum SYSPropertyInt property, int * value);
 354 
 360 SYS_INFO_API int sysSetPropertyInt(enum SYSPropertyInt property, int value);
 361 
 368 SYS_INFO_API int sysGetPropertyString(enum SYSPropertyString property, char * value, int len);
 369 
 375 SYS_INFO_API int sysSetPropertyString(enum SYSPropertyString property, const char * value);
 376 
 382 SYS_INFO_API int sysGetPropertyString(enum SYSPropertyString property, std::string & value);
 383 
 389 SYS_INFO_API int sysSetPropertyString(enum SYSPropertyString property, const std::string & value);
 390 
 394 SYS_INFO_API const char *sysInfo_GetVersion();
 395 
 399 SYS_INFO_API const char *sysLibInfo_GetVersion();
 400 
 404 SYS_INFO_API const char *sysGetVersion();
 405 
 409 SYS_INFO_API int sysReboot();
 410 
 414 SYS_INFO_API int sysSleep();
 415 
 419 SYS_INFO_API int sysDeepSleep();
 420 
 424 SYS_INFO_API int sysHibernate();
 425 
 429 SYS_INFO_API int sysShutdown();
 430 
 434 SYS_INFO_API int sysRebootDock();
 435 
 439 SYS_INFO_API std::string sysErrorMsg( enum sysError code );
 440 
 444 SYS_INFO_API const char * sysErrorMessage( enum sysError code );
 445 
 447 inline const char * sysSDKVersion()
 448 {
 449  return "UNSUPPORTED";
 450 }
 451 
 452 #ifndef DOXYGEN
 453 } // namespace vfisysinfo
 454 #endif
 455 
```


---

# 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/sysinfo_8h_source.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.