SDK API
장치를 관리하는 정보를 초기화 하고, 동적 메모리 제어와 PIN 생성을 위해 사용되는 API입니다.
BS2_Version
SDK 버전을 가져옵니다.
BS2_AllocateContext
BS2_AllocateContext() 함수는 장치를 관리하고 제어하는 Context를 생성합니다. 장치 관리 Context는 연결된 장치의 네트워크 연결 상태를 관리 및 감독하고, SDK에서 제공하는 API를 호출할 수 있는 기능을 담당합니다.
BS2_ReleaseContext
BS2_AllocateContext() 함수로부터 할당된 Context를 파괴합니다. 포인터 값이 NULL이면 아무런 동작을 하지 않습니다.
BS2_Initialize
Context를 초기화합니다.
BS2_ReleaseObject
동적으로 할당 받은 메모리를 시스템에 반환합니다. 포인터 값이 NULL이면 아무런 동작을 하지 않습니다.
BS2_MakePinCode
일반 문자를 PIN으로 암호화합니다.
BS2_MakePinCodeWithKey
+ v2.7.1 사용자 정의 PIN 암호화 키를 이용하여, 일반 문자를 PIN으로 암호화합니다.
BS2_SetMaxThreadCount
최대 스레드 개수를 지정합니다.
BS2_ComputeCRC16CCITT
CRC-16 CCITT 체크섬을 계산합니다.
BS2_GetCardModel
지원하는 카드 모델을 가져옵니다.
BS2_GetDataEncryptKey
[지원 중단] 장치의 데이터 암호화 키를 가져옵니다.
BS2_SetDataEncryptKey
+ v2.7.1 사용자의 PIN 코드 암호화 키 값을 변경 합니다.
BS2_RemoveDataEncryptKey
+ v2.6.0 장치의 데이터 암호화키를 제거합니다.
BS2_SetDeviceSearchingTimeout
장치 검색 시간을 설정합니다.
BS2_SetDebugFileLog
+ v2.6.4 SDK 내의 로그 메시지를 파일로 출력시켜 응용프로그램 등의 디버깅에 활용할 수 있습니다.
BS2_SetDebugFileLogEx
+ v2.8.3 SDK내의 로그메시지를 분할 파일로 출력시켜 응용프로그램 등의 디버깅에 활용할 수 있습니다.
BS2_EnableDeviceLicense
+ v2.9.1 라이선스를 활성화시킬 장치들과, 라이선스 파일을 지정하여 장치 라이선스를 활성화시킵니다.
BS2_DisableDeviceLicense
+ v2.9.1 마스터 장치 및 그와 연결된 슬레이브 장치들을 일괄 지정하여, 장치 내 라이선스를 비활성화시킵니다.
BS2_QueryDeviceLicense
+ v2.9.1 마스터 장치 및 그와 연결된 슬레이브 장치들의 라이선스 활성화/비활성화 상태를 가져옵니다.
BS2_InitializeEx
+ v2.9.6 Context를 초기화하고 두 번째 인자로 지정한 IP 주소로 소켓을 초기화합니다.
BS2_SetDebugExCallback
[지원 중단]
구조체
BS2EncryptKey
enum
{
BS2_ENC_KEY_SIZE = 32,
};
typedef struct
{
uint8_t key[BS2_ENC_KEY_SIZE];
uint8_t reserved[32];
} BS2EncryptKey;
-
key장치에서 사용되는 키 값입니다.
-
reserved예약된 영역입니다.
BS2LicenseBlob
typedef struct {
BS2_LICENSE_TYPE licenseType;
uint16_t numOfDevices;
BS2_DEVICE_ID* deviceIDObjs;
uint32_t licenseLen;
uint8_t* licenseObj;
} BS2LicenseBlob;
-
licenseType라이선스의 종류를 나타냅니다.
값 설명 0x0000 None 0x0001 Visual QR -
numOfDevices라이선스 활성화 장치의 개수입니다.
-
deviceIDObjs라이선스 정보가 내려질 slave 장치들입니다.
-
licenseLen라이선스 활성화 파일의 크기입니다.
-
licenseObj라이선스 활성화 데이터 블록입니다.
BS2LicenseResult
typedef struct {
BS2_DEVICE_ID deviceID;
BS2_LICENSE_STATUS status;
} BS2LicenseResult;
-
deviceID장치 식별자입니다.
-
status라이선스 상태 정보입니다.
값 설명 0 Not supported (지원 안 함) 1 Disable (꺼짐) 2 Enable (켜짐) 3 Expired (만료됨)