![]()  | 
     BALTECH Docs | 
    C API for BALTECH SDK
   
    
   
   | 
   
With the Sys command group, you can interact with the reader itself. More...
#include "../typedefs.h"Go to the source code of this file.
Macros | |
| #define | BRP_Sys_ErrCfgFull BRP_ERR_STATUS(0x0000, 0x01) | 
| There's not enough space to store the reader's configuration values.  More... | |
| #define | BRP_Sys_ErrCfgAccess BRP_ERR_STATUS(0x0000, 0x02) | 
| Reading/writing to the internal memory failed.  More... | |
| #define | BRP_Sys_ErrCfgNotFound BRP_ERR_STATUS(0x0000, 0x03) | 
| The meaning of this status code varies depending on the access mode:  More... | |
| #define | BRP_Sys_ErrInvalidCfgBlock BRP_ERR_STATUS(0x0000, 0x04) | 
| The format of the configuration file (BEC file) is invalid.  More... | |
| #define | BRP_Sys_ErrCfgAccessDenied BRP_ERR_STATUS(0x0000, 0x05) | 
| Memory access denied.  More... | |
| #define | BRP_Sys_ErrRegAccess BRP_ERR_STATUS(0x0000, 0x06) | 
| Register cannot be modified or doesn't exist.  More... | |
| #define | BRP_Sys_ErrInvalidProtocol BRP_ERR_STATUS(0x0000, 0x07) | 
| The selected protocol isn't supported by the current firmware.  More... | |
| #define | BRP_Sys_ErrNotSupportedByHardware BRP_ERR_STATUS(0x0000, 0x08) | 
| This feature isn't supported by the reader hardware.  More... | |
| #define | BRP_Sys_ErrFactsetRestore BRP_ERR_STATUS(0x0000, 0x09) | 
| Restoring the reader's factory settings failed.  More... | |
| #define | BRP_Sys_ErrCfgConfigSecurityCode BRP_ERR_STATUS(0x0000, 0x0A) | 
| brp_Sys_CfgLoadBlock() was run with an invalid Config Security Code, i.e.  More... | |
| #define | BRP_Sys_ErrCfgVersion BRP_ERR_STATUS(0x0000, 0x0B) | 
| brp_Sys_CfgLoadBlock() was run with a configuration version that is older than the one currently deployed (learn more).  More... | |
| #define | BRP_Sys_ErrCfgLoadWrongState BRP_ERR_STATUS(0x0000, 0x0C) | 
| The command can't be run in the current (CfgLoadBlock) state, i.e.  More... | |
| #define | BRP_Sys_ErrInvalidFwCrc BRP_ERR_STATUS(0x0000, 0x7F) | 
| The CRC of the firmware is invalid.  More... | |
Functions | |
| brp_errcode | brp_Sys_GetBufferSize (brp_protocol protocol, unsigned *MaxSendSize, unsigned *MaxRecvSize, unsigned *TotalSize) | 
| This command returns the maximum sizes of command and response frames that the reader can send and receive.  More... | |
| brp_errcode | brp_Sys_HFReset (brp_protocol protocol, unsigned OffDuration) | 
| This command turns the HF antenna off or on.  More... | |
| brp_errcode | brp_Sys_Reset (brp_protocol protocol) | 
| This command reboots the reader.  More... | |
| brp_errcode | brp_Sys_GetInfo (brp_protocol protocol, char **Info, brp_mempool *mempool) | 
| This command retrieves the firmware string of the reader, which holds information about the reader firmware and serial number.  More... | |
| brp_errcode | brp_Sys_GetBootStatus (brp_protocol protocol, brp_Sys_GetBootStatus_BootStatus *BootStatus) | 
| This command retrieves the boot status of the reader, i.e.  More... | |
| brp_errcode | brp_Sys_GetPort (brp_protocol protocol, brp_IoPortBitmask *PortMask) | 
| This command retrieves the voltage for the custom I/O ports of the module.  More... | |
| brp_errcode | brp_Sys_SetPort (brp_protocol protocol, brp_IoPortBitmask PortMask) | 
| **Please use brp_UI_Enable() and brp_UI_Disable() instead of this command for new applications.  More... | |
| brp_errcode | brp_Sys_CfgGetValue (brp_protocol protocol, unsigned Key, unsigned Value, brp_buf *Content, size_t *Content_len, brp_mempool *mempool) | 
| This command retrieves a desired value of the reader's configuration, specified by the Key and Value parameters.  More... | |
| brp_errcode | brp_Sys_CfgSetValue (brp_protocol protocol, unsigned Key, unsigned Value, brp_buf Content, size_t Content_len) | 
| This command stores a value in the reader's configuration.  More... | |
| brp_errcode | brp_Sys_CfgDelValues (brp_protocol protocol, unsigned Key, unsigned Value) | 
| This command deletes a key or a value from the reader's configuration.  More... | |
| brp_errcode | brp_Sys_CfgGetKeyList (brp_protocol protocol, unsigned **KeyList, size_t *KeyList_len, brp_mempool *mempool) | 
| Retrieves a list of all keys stored in the reader's configuration.  More... | |
| brp_errcode | brp_Sys_CfgGetValueList (brp_protocol protocol, unsigned Key, unsigned **ValueList, size_t *ValueList_len, brp_mempool *mempool) | 
| Returns a list of all configuration values within a specified Key.  More... | |
| brp_errcode | brp_Sys_CfgWriteTlvSector (brp_protocol protocol, brp_buf TlvBlock, size_t TlvBlock_len) | 
| **Please use brp_Sys_CfgLoadBlock() instead of this command for new applications.  More... | |
| brp_errcode | brp_Sys_CfgCheck (brp_protocol protocol, unsigned *TotalSize, unsigned *FreeSize) | 
| This command checks the consistency of the reader's internal configuration.  More... | |
| brp_errcode | brp_Sys_ConfigPort (brp_protocol protocol, brp_IoPortBitmask InpOutp, brp_IoPortBitmask DefaultState) | 
| Configures generic I/O ports for input/output.  More... | |
| brp_errcode | brp_Sys_SetRegister (brp_protocol protocol, bool ResetRegister, brp_Sys_SetRegister_RegisterAssignments_Entry *RegisterAssignments, size_t RegisterAssignments_len) | 
| Sets one or multiple of the reader's internal registers.  More... | |
| brp_errcode | brp_Sys_GetRegister (brp_protocol protocol, unsigned ID, unsigned *Value) | 
| Retrieves one of the reader's internal registers.  More... | |
| brp_errcode | brp_Sys_PowerDown (brp_protocol protocol) | 
| Powers off the device.  More... | |
| brp_errcode | brp_Sys_SelectProtocol (brp_protocol protocol, brp_ProtocolID Protocol) | 
| This command starts a host protocol.  More... | |
| brp_errcode | brp_Sys_SetCommParam (brp_protocol protocol, brp_Baudrate NewBaudrate, brp_Parity NewParity, unsigned CWT) | 
| This command is only required when the serial host-to-reader interface is in use.  More... | |
| brp_errcode | brp_Sys_CfgLoadBlock (brp_protocol protocol, unsigned Version, brp_buf Data, size_t Data_len) | 
| This command transfers the configuration from a BEC file into the reader.  More... | |
| brp_errcode | brp_Sys_GetPlatformId (brp_protocol protocol, brp_buf *PlatformId, unsigned *BootloaderId, unsigned *BootloaderMajor, unsigned *BootloaderMinor, unsigned *BootloaderBuild, brp_mempool *mempool) | 
| Maintenance command only needed for Baltech internal use to get detailed information about the actually used hardware.  More... | |
| brp_errcode | brp_Sys_CfgReset (brp_protocol protocol) | 
| Deletes the complete configuration.  More... | |
| brp_errcode | brp_Sys_StopProtocol (brp_protocol protocol, brp_ProtocolID Protocol) | 
| This command stops a host protocol.  More... | |
| brp_errcode | brp_Sys_CfgGetId (brp_protocol protocol, char **ConfigId, char **ConfigName, brp_mempool *mempool) | 
| This command returns the identifier of the reader configuration.  More... | |
| brp_errcode | brp_Sys_CfgGetDeviceSettingsId (brp_protocol protocol, char **ConfigId, char **ConfigName, brp_mempool *mempool) | 
| This command retrieves the ID of the reader configuration containing the device settings.  More... | |
| brp_errcode | brp_Sys_FactoryResetLegacy (brp_protocol protocol) | 
| **This is a legacy command! For new developments please use brp_Sys_FactoryReset() .  More... | |
| brp_errcode | brp_Sys_GetStatistics (brp_protocol protocol, bool DeleteCounters, brp_Sys_GetStatistics_CounterTuple_Entry **CounterTuple, size_t *CounterTuple_len, brp_mempool *mempool) | 
| This command retrieves all available statistics counters from the reader's configuration.  More... | |
| brp_errcode | brp_Sys_GetFeatures (brp_protocol protocol, brp_FeatureID **FeatureList, size_t *FeatureList_len, brp_FeatureID *MaxFeatureID, brp_mempool *mempool) | 
| This command retrieves the list of features supported by the reader, so you can find out if the reader meets your requirements.  More... | |
| brp_errcode | brp_Sys_GetPartNumber (brp_protocol protocol, char **PartNo, char **HwRevNo, brp_mempool *mempool) | 
| This command returns the part number and the hardware revision number of the device.  More... | |
| brp_errcode | brp_Sys_CfgLoadPrepare (brp_protocol protocol, brp_AuthReqUpload AuthReq) | 
| This command initiates the transfer of a BEC file via brp_Sys_CfgLoadBlock().  More... | |
| brp_errcode | brp_Sys_CfgLoadFinish (brp_protocol protocol, brp_Sys_CfgLoadFinish_FinalizeAction FinalizeAction) | 
| This command has to be called after transferring a BEC file with brp_Sys_CfgLoadBlock().  More... | |
| brp_errcode | brp_Sys_FactoryReset (brp_protocol protocol, bool PerformReboot) | 
| This command restores the reader's factory settings.  More... | |
| brp_errcode | brp_Sys_GetLicenses (brp_protocol protocol, brp_LicenseBitMask *LicenseBitMask) | 
| This command retrieves a bit mask of the licenses that are activated in the reader.  More... | |
| brp_errcode | brp_Sys_GetFwCrc (brp_protocol protocol, unsigned *CRC) | 
| Maintenance command only needed for Baltech internal use to get the CRC of the firmware.  More... | |
With the Sys command group, you can interact with the reader itself.
You can e.g. retrieve reader information, set up its behavior, and control it during runtime.
For a quick overview, please see our list of most important Sys commands.
Definition in file sys.h.