Communication API
장치 통신을 제어하는 API로써 통신 인터페이스는 LAN, USB, RS485 등이 있습니다. 실시간으로 장치의 연결유무와 탐색 결과를 받으려면 BS2_SetDeviceEventListener 함수를 통해 콜백 함수를 등록하세요.
BS2_SetDeviceEventListener
Subnet에서 BioStar 장치를 찾았거나, 장치의 네트워크 연결 상태가 변경될 때 호출되는 콜백 함수를 등록합니다.
BS2_SearchDevices
Subnet에서 BioStar 장치를 검색하고 현재 Context에 가용한 장치 목록을 갱신합니다. 장치 목록은 BS2GetDevices 함수를 통해 가져올 수 있습니다.
BS2_SearchDevicesEx
[지원 중단]
BS2_SearchDeviceByIP
+ v2.9.13 특정 IPv4 주소의 장치를 검색하고 현재 Context에 가용한 장치 목록을 갱신합니다. 장치 목록은 BS2GetDevices 함수를 통해 가져올 수 있습니다.
BS2_GetDevices
가용한 장치 목록을 가져옵니다.
BS2_ConnectDevice
주어진 장치 식별자를 기반으로 장치 연결을 시도합니다.
BS2_ConnectDeviceIPV6
장치 식별자를 이용해 장치를 IPv6 모드로 연결합니다
BS2_ConnectDeviceViaIP
명시한 IP 주소와 port로 장치 연결을 시도합니다.
BS2_DisconnectDevice
장치와의 연결을 끊습니다.
BS2_SetKeepAliveTimeout
Keep-alive timeout을 설정합니다.
BS2_SetNotificationListener
Notification listener를 설정합니다.
BS2_SetServerPort
Server Port를 설정합니다. 0을 지정하면 port를 open하지 않습니다.
BS2_SetSSLServerPort
SSL Port를 설정합니다. 0을 지정하면 port를 open하지 않습니다.
BS2_GetServerPort
+ v2.6.3 Server Port를 설정을 확인합니다.
BS2_GetSSLServerPort
+ v2.6.3 SSL Server Port을 확인합니다.
BS2_IsConnected
장치 연결상태를 확인합니다.
BS2_IsAutoConnection
자동연결이 설정되어 있는지 여부를 확인합니다.
BS2_SetAutoConnection
자동연결 여부를 설정합니다.
BS2_GetEnableIPV4
+ v2.6.3 IP V4 연결모드가 설정되어 있는지 여부를 확인합니다.
BS2_SetEnableIPV4
+ v2.6.3 IP V4 연결모드로 설정합니다.
BS2_GetEnableIPV6
+ v2.6.3 IP V6 연결모드가 설정되어 있는지 여부를 확인합니다.
BS2_SetEnableIPV6
+ v2.6.3 IP V6 연결모드로 설정합니다.
BS2_SetServerPortIPV6
+ v2.6.3 IP V6를 이용하여 서버모드 연결 시 연결 Port를 설정합니다.
BS2_GetServerPortIPV6
+ v2.6.3 IP V6를 이용하여 서버모드 연결 시 사용되는 연결 Port 정보를 확인합니다.
BS2_SetSSLServerPortIPV6
+ v2.6.3 IP V6와 ssl을 이용하여 서버모드 연결 시 연결 Port를 설정합니다.
BS2_GetSSLServerPortIPV6
+ v2.6.3 IP V6와 ssl을 이용하여 서버모드 연결 시 사용되는 연결 Port 정보를 확인합니다.
BS2_SetDefaultResponseTimeout
+ v2.6.3 장치와의 패킷 응답 대기시간을 설정합니다.
BS2_GetDefaultResponseTimeout
+ v2.6.3 장치와의 패킷 응답 대기시간 정보를 확인합니다.
BS2_GetSocketRetryCount
+ v2.9.1 일반 TCP/IP 소켓 통신 시, 통신구간에서 소켓으로부터 패킷을 읽고쓰는 도중 오류가 발생하게되면, SDK는 자동으로 일정 횟수 만큼 재시도를 하는데, 이 함수는 SDK에 설정된 재시도 횟수 설정 값을 가져옵니다.
BS2_SetSocketRetryCount
+ v2.9.1 일반 TCP/IP 소켓 통신 시, 통신구간에서 소켓으로부터 패킷을 읽고쓰는 도중 오류가 발생하게되면, SDK는 자동으로 일정 횟수 만큼 재시도를 하는데, 이 함수를 통해 재시도 횟수를 변경할 수 있습니다.
BS2_GetSocketSSLRetryCount
+ v2.9.1 SSL 소켓 통신 시, 통신구간에서 소켓으로부터 패킷을 읽고쓰는 도중 오류가 발생하게되면, SDK는 자동으로 일정 횟수 만큼 재시도를 하는데, 이 함수는 SDK에 설정된 재시도 횟수 설정 값을 가져옵니다.
BS2_SetSocketSSLRetryCount
+ v2.9.1 SSL 소켓 통신 시, 통신구간에서 소켓으로부터 패킷을 읽고쓰는 도중 오류가 발생하게되면, SDK는 자동으로 일정 횟수 만큼 재시도를 하는데, 이 함수를 통해 재시도 횟수를 변경할 수 있습니다.
BS2_SetDefaultLongResponseTimeout
+ v2.9.12 BS2ScanCard, BS2WriteCard, BS2EraseCard와 같이, 장치로부터 응답시간이 긴 API들의 패킷 응답 시간을 직접 변경할 수 있습니다.
BS2_GetDefaultLongResponseTimeout
+ v2.9.12 BS2ScanCard, BS2WriteCard, BS2EraseCard와 같이, 장치로부터 응답시간이 긴 API들의 패킷 응답 시간을 직접 변경할 수 있습니다.
콜백 함수
typedef void (*OnDeviceFound)(uint32_t deviceId);
typedef void (*OnDeviceAccepted)(BS2_DEVICE_ID deviceId);
typedef void (*OnDeviceConnected)(uint32_t deviceId);
typedef void (*OnDeviceDisconnected)(uint32_t deviceId);
typedef void (*OnAlarmFired)(BS2_DEVICE_ID deviceId, const BS2Event* event);
typedef void (*OnInputDetected)(BS2_DEVICE_ID deviceId, const BS2Event* event);
typedef void (*OnConfigChanged)(BS2_DEVICE_ID deviceId, uint32_t configMask);
-
OnDeviceFoundSubnet에서 새로운 BioStar 장치를 찾았을 때 호출되는 콜백 함수입니다.
-
OnDeviceAcceptedBioStar 장치가 BioStar 애플리케이션으로 연결을 요청할 때 호출되는 콜백 함수입니다.
-
OnDeviceConnected장치와 BioStar 애플리케이션이 연결되었을 때 호출되는 콜백 함수입니다.
-
OnDeviceDisconnected장치와 BioStar 애플리케이션의 연결이 끊어졌을 때 호출되는 콜백 함수입니다.
-
OnAlarmFiredZone에 설정한 알람이 발생되면 호출되는 콜백 함수입니다.
-
OnInputDetected입력 신호가 발생되면 호출되는 콜백 함수입니다.
-
OnConfigChanged단말기를 조작하여 Configuration이 변경될 때 호출되는 콜백 함수입니다.