차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 | ||
ko:configuration_api [2023/08/11 10:45] mwkim [BS2CustomMifareCard] |
ko:configuration_api [2024/10/24 14:24] (현재) |
||
---|---|---|---|
줄 70: | 줄 70: | ||
* [[BS2_GetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 가져옵니다. | * [[BS2_GetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 가져옵니다. | ||
* [[BS2_SetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 저장합니다. | * [[BS2_SetDesFireCardConfigEx]]: [+ 2.6.4] DesFire 카드 고급설정 정보를 저장합니다. | ||
- | * [[BS2_GetAuthConfigExt]]: [+ 2.7.1] ''FSF2'' 인증 설정 정보를 가져옵니다. | + | * [[BS2_GetAuthConfigExt]]: [+ 2.7.1] ''Visual Face 기반 장치'' 인증 설정 정보를 가져옵니다. |
- | * [[BS2_SetAuthConfigExt]]: [+ 2.7.1] ''FSF2'' 인증 설정 정보를 저장합니다. | + | * [[BS2_SetAuthConfigExt]]: [+ 2.7.1] ''Visual Face 기반 장치'' 인증 설정 정보를 저장합니다. |
- | * [[BS2_GetFaceConfigExt]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다. | + | * [[BS2_GetFaceConfigExt]]: [+ 2.7.1] 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 가져옵니다. |
- | * [[BS2_SetFaceConfigExt]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다. | + | * [[BS2_SetFaceConfigExt]]: [+ 2.7.1] 열화상 감지와 마스크 착용 체크를 위한 설정 정보를 저장합니다. |
- | * [[BS2_GetThermalCameraConfig]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 카메라 설정을 가져옵니다. | + | * [[BS2_GetThermalCameraConfig]]: [+ 2.7.1] 열화상 카메라 설정을 가져옵니다. |
- | * [[BS2_SetThermalCameraConfig]]: [+ 2.7.1] ''FSF2, FS2'' 열화상 카메라 설정을 저장합니다. | + | * [[BS2_SetThermalCameraConfig]]: [+ 2.7.1] 열화상 카메라 설정을 저장합니다. |
* [[BS2_GetBarcodeConfig]]: [+ 2.8] ''XS2'' Barcode 관련 설정을 가져옵니다. | * [[BS2_GetBarcodeConfig]]: [+ 2.8] ''XS2'' Barcode 관련 설정을 가져옵니다. | ||
* [[BS2_SetBarcodeConfig]]: [+ 2.8] ''XS2'' Barcode 관련 설정을 저장합니다. | * [[BS2_SetBarcodeConfig]]: [+ 2.8] ''XS2'' Barcode 관련 설정을 저장합니다. | ||
줄 82: | 줄 82: | ||
* [[BS2_GetRelayActionConfig]]: [+ 2.8.1] ''IM-120'' RelayAction 관련 설정을 가져옵니다. | * [[BS2_GetRelayActionConfig]]: [+ 2.8.1] ''IM-120'' RelayAction 관련 설정을 가져옵니다. | ||
* [[BS2_SetRelayActionConfig]]: [+ 2.8.1] ''IM-120'' RelayAction 관련 설정을 저장합니다. | * [[BS2_SetRelayActionConfig]]: [+ 2.8.1] ''IM-120'' RelayAction 관련 설정을 저장합니다. | ||
- | * [[BS2_GetVoipConfigExt]]: [+ 2.8.3] ''BS3'' 확장형 VoIP 설정을 가져옵니다. | + | * [[BS2_GetVoipConfigExt]]: [+ 2.8.3] 확장형 VoIP 설정을 가져옵니다. |
- | * [[BS2_SetVoipConfigExt]]: [+ 2.8.3] ''BS3'' 확장형 VoIP 설정을 저장합니다. | + | * [[BS2_SetVoipConfigExt]]: [+ 2.8.3] 확장형 VoIP 설정을 저장합니다. |
- | * [[BS2_GetRtspConfig]]: [+ 2.8.3] ''BS3'' RTSP 설정을 가져옵니다. | + | * [[BS2_GetRtspConfig]]: [+ 2.8.3] RTSP 설정을 가져옵니다. |
- | * [[BS2_SetRtspConfig]]: [+ 2.8.3] ''BS3'' RTSP 설정을 저장합니다. | + | * [[BS2_SetRtspConfig]]: [+ 2.8.3] RTSP 설정을 저장합니다. |
* [[BS2_GetLicenseConfig]]: [+ 2.9.1] 장치 라이선스 활성화 정보를 가져옵니다. | * [[BS2_GetLicenseConfig]]: [+ 2.9.1] 장치 라이선스 활성화 정보를 가져옵니다. | ||
* [[BS2_GetOsdpStandardConfig]]: [+ 2.9.1] 장치의 OSDP 설정 정보를 가져옵니다. | * [[BS2_GetOsdpStandardConfig]]: [+ 2.9.1] 장치의 OSDP 설정 정보를 가져옵니다. | ||
줄 208: | 줄 208: | ||
|0x80000000 |CARD_OPERATION_USE | | |0x80000000 |CARD_OPERATION_USE | | ||
|0x00000000 |CARD_OPERATION_MASK_NONE | | |0x00000000 |CARD_OPERATION_MASK_NONE | | ||
- | |0x00000001 |CARD_OPERATION_MASK_LF_EM | | + | |0x00000800 |CARD_OPERATION_MASK_CUSTOM_DESFIRE_EV1 | |
- | |0x00000002 |CARD_OPERATION_MASK_LF_PROX | | + | |0x00000400 |CARD_OPERATION_MASK_CUSTOM_CLASSIC_PLUS | |
- | |0x00000004 |CARD_OPERATION_MASK_HF_CSN_MIFARE | | + | |0x00000200 |CARD_OPERATION_MASK_BLE | |
- | |0x00000008 |CARD_OPERATION_MASK_HF_CSN_ICLASS | | + | |0x00000100 |CARD_OPERATION_MASK_NFC | |
- | |0x00000010 |CARD_OPERATION_MASK_HF_SMART_MIFARE | | + | |0x00000080 |CARD_OPERATION_MASK_SEOS | |
- | |0x00000020 |CARD_OPERATION_MASK_HF_SMART_MIFARE_DESFIRE | | + | |0x00000040 |CARD_OPERATION_MASK_SR_SE | |
- | |0x00000040 |CARD_OPERATION_MASK_HF_SMART_ICLASS | | + | |0x00000020 |CARD_OPERATION_MASK_DESFIRE_EV1 | |
- | |0x00000080 |CARD_OPERATION_MASK_HF_SMART_ICLASS_SEOS | | + | |0x00000010 |CARD_OPERATION_MASK_CLASSIC_PLUS | |
- | |0x00000100 |CARD_OPERATION_MASK_MOBILE_NFC | | + | |0x00000008 |CARD_OPERATION_MASK_ICLASS | |
- | |0x00000200 |CARD_OPERATION_MASK_MOBILE_BLE | | + | |0x00000004 |CARD_OPERATION_MASK_MIFARE_FELICA | |
- | |0x00000400 |CARD_OPERATION_MASK_HF_CSN_OTHERS | | + | |0x00000002 |CARD_OPERATION_MASK_HIDPROX | |
+ | |0x00000001 |CARD_OPERATION_MASK_EM | | ||
</WRAP> | </WRAP> | ||
16. //reserved2// \\ | 16. //reserved2// \\ | ||
줄 386: | 줄 387: | ||
uint8_t tnaIcon[16]; | uint8_t tnaIcon[16]; | ||
uint8_t useScreenSaver; | uint8_t useScreenSaver; | ||
- | uint8_t reserved1[31]; | + | uint8_t showOsdpResult; |
+ | uint8_t reserved1[30]; | ||
+ | BS2_SHOW_OSDP_RESULT showOsdpResult; ///< 1 byte | ||
+ | |||
+ | BS2_AUTHMSG_USERINFO authMsgUserName; ///< 1 byte | ||
+ | BS2_AUTHMSG_USERINFO authMsgUserId; ///< 1 byte | ||
+ | |||
+ | BS2_SCRAMBLE_KEYBOARD_MODE scrambleKeyboardMode ; ///< 1 byte | ||
+ | |||
+ | uint8_t reserved3[27]; ///< 27 bytes (padding) | ||
} BS2DisplayConfig; | } BS2DisplayConfig; | ||
</code> | </code> | ||
줄 491: | 줄 501: | ||
장치내에서 근태 코드값에 해당하는 아이콘을 보여줄 때 사용합니다. \\ \\ | 장치내에서 근태 코드값에 해당하는 아이콘을 보여줄 때 사용합니다. \\ \\ | ||
17. //useScreenSaver// \\ | 17. //useScreenSaver// \\ | ||
- | ''FaceStation 2'', ''FaceStation F2'' true로 설정 시, 화면보호기가 활성화됩니다. \\ \\ | + | true로 설정 시, 화면보호기가 활성화됩니다. \\ \\ |
- | 18. //reserved1// \\ | + | 18. //showOsdpResult// \\ |
- | 예약된 공간입니다. \\ | + | [+ 2.9.6] Intelligent slave나 타사 컨트롤러에 슈프리마 장치를 주변장치로 연결하여 사용하는 환경에서 \\ |
+ | 인증 결과를 장치 화면에 표시하도록 하는 옵션입니다. \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |OSDP 인증결과 표시 (기본값) | | ||
+ | |1 |OSDP 인증결과 표시안함 | | ||
+ | </WRAP> | ||
+ | 19. //reserved1// \\ | ||
+ | 예약된 공간입니다. \\ \\ | ||
+ | 20. //authMsgUserName// \\ | ||
+ | [+2.9.8] 장치 화면에 표시되는 인증 결과 메시지에 포함된 사용자 이름의 표시 방법을 설정합니다. \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |전체 표시 | | ||
+ | |1 |첫 문자만 표시 | | ||
+ | |2 |표시 안함 | | ||
+ | </WRAP> | ||
+ | 21. //authMsgUserID// \\ | ||
+ | [+2.9.8] 장치 화면에 표시되는 인증 결과 메시지에 포함된 사용자 ID의 표시 방법을 설정합니다. \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |전체 표시 | | ||
+ | |1 |첫 문자만 표시 | | ||
+ | |2 |표시 안함 | | ||
+ | </WRAP> | ||
+ | 22. //scrambleKeyboardMode// \\ | ||
+ | [+2.9.8] 스크램블 키패드의 사용 여부를 설정합니다. \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |사용 | | ||
+ | |1 |사용 안함 | | ||
+ | </WRAP> | ||
==== BS2IpConfig ==== | ==== BS2IpConfig ==== | ||
<code cpp> | <code cpp> | ||
줄 901: | 줄 941: | ||
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
- | |0 |사용안함 | | ||
|1 |Master | | |1 |Master | | ||
|2 |Slave | | |2 |Slave | | ||
줄 1107: | 줄 1146: | ||
uint8_t numInputs; | uint8_t numInputs; | ||
uint8_t numSupervised; | uint8_t numSupervised; | ||
- | uint16_t reseved; | + | union { |
+ | uint16_t value; | ||
+ | struct { | ||
+ | uint16_t tamperAuxIndex : 4; | ||
+ | uint16_t acFailAuxIndex : 4; | ||
+ | uint16_t aux0Type : 1; | ||
+ | uint16_t aux1Type : 1; | ||
+ | uint16_t reserved : 6; | ||
+ | } field; | ||
+ | } aux; | ||
struct { | struct { | ||
uint8_t portIndex; | uint8_t portIndex; | ||
줄 1147: | 줄 1195: | ||
|255 |사용자 정의 | | |255 |사용자 정의 | | ||
</WRAP> | </WRAP> | ||
- | 12. //reserved// \\ | + | 12. //aux// \\ |
- | 예약된 공간입니다. \\ \\ | + | [+2.9.8] Aux의 동작을 설정합니다. |
+ | <WRAP group 70%> | ||
+ | ^비트위치 ^비트 수 ^멤버명 ^설명 ^ | ||
+ | |0 |4 |tamperAuxIndex |Tamper로 사용할 Aux 번호 (0:None, 1:Aux0, 2:Aux1) | | ||
+ | |7 |4 |acFailAuxIndex |AC Fail로 사용할 Aux 번호 (0:None, 1:Aux0, 2:Aux1) | | ||
+ | |8 |1 |aux0Type |Aux 0의 타입 (0: NO, 1:NC) | | ||
+ | |9 |1 |aux1Type |Aux 1의 타입 (0: NO, 1:NC) | | ||
+ | |10 |6 |reserved |예약된 공간 | | ||
+ | </WRAP> | ||
13. //config// \\ | 13. //config// \\ | ||
supervised 입력 신호 유형을 판단하는 설정값으로, supervised input의 저항값이 사용자 정의일 경우에만 의미가 있습니다. \\ | supervised 입력 신호 유형을 판단하는 설정값으로, supervised input의 저항값이 사용자 정의일 경우에만 의미가 있습니다. \\ | ||
줄 1221: | 줄 1277: | ||
uint32_t deviceID; | uint32_t deviceID; | ||
uint8_t type; | uint8_t type; | ||
- | uint8_t reserved[3]; | + | uint8_t reserved; |
+ | uint16_t ignoreSignalTime; | ||
| | ||
union { | union { | ||
줄 1267: | 줄 1324: | ||
|3|Schedule trigger| | |3|Schedule trigger| | ||
</WRAP> | </WRAP> | ||
+ | 11. //reserved// \\ | ||
+ | 예약된 공간입니다. \\ \\ | ||
+ | 12. //ignoreSignalTime// \\ | ||
+ | [+2.9.6] 밀리초 단위로 지정하며 일정 시간 내 동일한 입력 신호가 반복적으로 입력되는 것을 무시하기 위한 설정입니다. \\ | ||
+ | 슈프리마 장치가 타사 컨트롤러와 wiegand로 연결된 환경에서 \\ | ||
+ | 특정 모델의 컨트롤러로부터 슈프리마 장치로 인증에 대한 피드백이 반복적으로 입력되는 경우 \\ | ||
+ | 이 설정을 통해 해당 시간만큼 강제로 입력 신호가 무시되도록 지정할 수 있습니다. \\ \\ | ||
==== BS2Action ==== | ==== BS2Action ==== | ||
줄 1706: | 줄 1770: | ||
uint8_t unused; | uint8_t unused; | ||
| | ||
- | uint8_t reserved[14]; ///< 14 bytes (reserved) | + | uint8_t unableToSaveImageOfVisualFace; |
+ | uint8_t reserved[13]; | ||
} BS2FaceConfig; | } BS2FaceConfig; | ||
</code> | </code> | ||
+ | |||
1. //securityLevel// \\ | 1. //securityLevel// \\ | ||
시스템 전반적으로 사용할 얼굴 인증 보안 레벨입니다. \\ | 시스템 전반적으로 사용할 얼굴 인증 보안 레벨입니다. \\ | ||
줄 1724: | 줄 1790: | ||
|1 |옥외 | | |1 |옥외 | | ||
|2 |자동 | | |2 |자동 | | ||
- | |3 |[+ 2.8] 사용 안함 ''(FaceStation F2)'' | | + | |3 |[+ 2.8] 사용 안함 | |
</WRAP> | </WRAP> | ||
3. //enrollThreshold// \\ | 3. //enrollThreshold// \\ | ||
줄 1751: | 줄 1817: | ||
</WRAP> | </WRAP> | ||
5. //enrollTimeout// \\ | 5. //enrollTimeout// \\ | ||
- | ''FaceStation2, FaceLite'' : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\ | + | ''IR Face 기반'' : 얼굴 스캔 대기 시간으로 기본값은 60초입니다. \\ |
<WRAP group 60%> | <WRAP group 60%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
줄 1758: | 줄 1824: | ||
|BS2_FACE_ENROLL_TIMEOUT_DEFAULT |BS2_FACE_ENROLL_TIMEOUT_MAX | | |BS2_FACE_ENROLL_TIMEOUT_DEFAULT |BS2_FACE_ENROLL_TIMEOUT_MAX | | ||
</WRAP> | </WRAP> | ||
- | ''FaceStation F2'' : [+ V2.7.1] 얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\ | + | ''Visual Face 기반'' : [+ V2.7.1] 얼굴 스캔 대기 시간으로 기본값은 20초입니다. \\ |
<WRAP group 70%> | <WRAP group 70%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
줄 1767: | 줄 1833: | ||
6. //lfdLevel// \\ | 6. //lfdLevel// \\ | ||
[+ 2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\ | [+ 2.6.3] 위조된 얼굴을 여과할 수 있는 민감도를 설정할 수 있습니다. \\ | ||
- | ''FaceStation2, FaceLite'' : 기본값은 0입니다. \\ | + | ''IR Face 기반'' : 기본값은 0입니다. \\ |
- | ''FaceStation F2'' : [+ 2.7.1] 기본값이 1입니다. \\ | + | ''Visual Face 기반'' : [+ 2.7.1] 기본값이 1입니다. \\ |
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
줄 1792: | 줄 1858: | ||
[+ 2.6.4] true로 설정하면 중복된 얼굴 정보인지 판단합니다. \\ \\ | [+ 2.6.4] true로 설정하면 중복된 얼굴 정보인지 판단합니다. \\ \\ | ||
10. //operationMode// \\ | 10. //operationMode// \\ | ||
- | [+ 2.7.1] ''FaceStation F2'' 아래의 동작 모드를 설정하며, 기본값은 Fusion 모드입니다. \\ | + | [+ 2.7.1] ''FaceStation F2 V1.0.1''미만은 아래의 동작 모드로 설정가능하며, 기본값은 Fusion 모드입니다. \\ |
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^모드 ^설명 ^기본값 ^ | ^값 ^모드 ^설명 ^기본값 ^ | ||
줄 1798: | 줄 1864: | ||
|1 |Visual 모드 |Visual matching | | | |1 |Visual 모드 |Visual matching | | | ||
|2 |Visual + IR검출 |Visual matching, IR은 얼굴 검출만| | | |2 |Visual + IR검출 |Visual matching, IR은 얼굴 검출만| | | ||
+ | </WRAP> | ||
+ | |||
+ | ''FaceStation F2 V1.0.1''이상, ''Visual Face 기반''는 아래와 같은 의미로 사용됩니다. | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^모드 ^설명 ^기본값 ^ | ||
+ | |0 |Fusion 모드 |Visual matching + IR matching |기본 | | ||
+ | |1 |Fast 모드 |Visual matching | | | ||
</WRAP> | </WRAP> | ||
11. //maxRotation// \\ | 11. //maxRotation// \\ | ||
- | [+ 2.7.1] ''FaceStation F2'' 얼굴 검출 시 보통은 정면 일 것입니다. \\ | + | [+ 2.7.1] ''Visual Face 기반'' 일반적인 상황에서 얼굴을 검출할 때 얼굴의 방향은 정면일 것입니다. \\ |
- | 하지만 FSF2는 얼굴 검출 시 정면에서 몇도 정도 회전된(외곡된) 이미지인지 판단이 가능합니다. \\ | + | 이 경우 장치는 얼굴 검출 시 정면에서 어느 정도 회전된(왜곡된) 이미지인지 판단할 수 있습니다. \\ |
- | 이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 시킬 수 있습니다. \\ | + | 이를 통해 일정 각도 이상 회전된 이미지의 경우 검출 실패 처리를 할 수 있습니다. \\ |
- | maxRotation은 이경우의 최대 허용치를 나타내며, 기본값은 15도 입니다. \\ \\ | + | maxRotation은 이런 경우의 최대 허용치를 나타내며 기본값은 15도입니다. \\ \\ |
+ | [+ 2.9.6] Angle 추가 정의 \\ | ||
+ | <WRAP group 40%> | ||
+ | ^정의 ^값 ^ | ||
+ | |BS2_MAX_ROTATION_DEFAULT | 15 | | ||
+ | |BS2_MAX_ROTATION_ANGLE_15 | 15 | | ||
+ | |BS2_MAX_ROTATION_ANGLE_30 | 30 | | ||
+ | |BS2_MAX_ROTATION_ANGLE_45 | 45 | | ||
+ | |BS2_MAX_ROTATION_ANGLE_60 | 60 | | ||
+ | |BS2_MAX_ROTATION_ANGLE_75 | 75 | | ||
+ | |BS2_MAX_ROTATION_ANGLE_90 | 90 | | ||
+ | |BS2_MAX_ROTATION_ANGLE_MAX | 90 | | ||
+ | </WRAP> | ||
12. //faceWidth// \\ | 12. //faceWidth// \\ | ||
- | [+ 2.7.1] ''FaceStation F2'' 얼굴 이미지의 폭을 나타내며, 폭의 최소값, 최대값을 지정할 수 있습니다. \\ | + | [+ 2.7.1] ''Visual Face 기반'' 얼굴 이미지의 폭을 나타내며 폭의 최소값, 최대값을 지정할 수 있습니다. \\ |
- | 최소값, 최대값은 아래의 값을 기본값으로 갖습니다. \\ | + | 최소값, 최대값의 기본값은 아래와 같습니다. \\ |
- | [+ 2.8.3] ''BioStation 3'' 해당 설정은 무시됩니다. \\ | + | <WRAP group 30%> |
- | <WRAP group 20%> | + | |
^ ^기본값(min) ^기본값(max) ^ | ^ ^기본값(min) ^기본값(max) ^ | ||
|FSF2 |66 |250 | | |FSF2 |66 |250 | | ||
- | |BS3 |- |- | | + | |BS3 |130 |350 | |
+ | |BEW3 |130 |350 | | ||
</WRAP> | </WRAP> | ||
13. //searchRange// \\ | 13. //searchRange// \\ | ||
- | [+ 2.7.1] ''FaceStation F2'' 얼굴 검색 범위를 나타내며, 범위의 x값(가로 좌표)과 x값 지점으로부터의 폭을 지정할 수 있습니다. \\ | + | [+ 2.7.1] ''Visual Face 기반'' 얼굴 감지 범위를 나타내며 범위의 x값(가로 좌표)과 x값으로부터의 폭을 지정할 수 있습니다. \\ |
- | x값과 폭은 아래의 값을 기본값으로 갖습니다. \\ | + | x값과 폭의 기본값은 아래와 같습니다. \\ |
- | [+ 2.8.3] ''BioStation 3'' 해당 설정은 무시됩니다. \\ | + | <WRAP group 30%> |
- | <WRAP group 20%> | + | |
^ ^기본값(x) ^기본값(width) ^ | ^ ^기본값(x) ^기본값(width) ^ | ||
|FSF2 |144 |432 | | |FSF2 |144 |432 | | ||
- | |BS3 |- |- | | + | |BS3 |90 |540 | |
+ | |BEW3 |90 |540 | | ||
</WRAP> | </WRAP> | ||
14. //detectDistance// \\ | 14. //detectDistance// \\ | ||
- | [+ 2.8.3] ''BioStation 3'' 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\ | + | [+ 2.8.3] ''Visual Face 기반'' 얼굴 감지 거리의 최소값과 최대값을 설정합니다. \\ |
픽셀 단위로 얼굴 위치를 지정하는 faceWidth는 사용하기 난해하므로 더 이상 사용하지 않습니다. \\ | 픽셀 단위로 얼굴 위치를 지정하는 faceWidth는 사용하기 난해하므로 더 이상 사용하지 않습니다. \\ | ||
대신 피사체(얼굴)의 감지 거리를 얼마로 할지 만 정합니다. 거리는 cm로 설정하며, 10의 배수로 입력하여야 합니다. \\ | 대신 피사체(얼굴)의 감지 거리를 얼마로 할지 만 정합니다. 거리는 cm로 설정하며, 10의 배수로 입력하여야 합니다. \\ | ||
<WRAP group 80%> | <WRAP group 80%> | ||
^ ^최소 감지거리의 최소값 ^최소 감지거리의 최대값 ^최소 감지거리(기본값) ^최대 감지거리의 최소값 ^최대 감지거리의 최대값 ^최대 감지거리(무제한) ^최대 감지거리(기본값) ^ | ^ ^최소 감지거리의 최소값 ^최소 감지거리의 최대값 ^최소 감지거리(기본값) ^최대 감지거리의 최소값 ^최대 감지거리의 최대값 ^최대 감지거리(무제한) ^최대 감지거리(기본값) ^ | ||
- | |BS3 |30 |100 |60 |40 |100 |255 |100 | | + | |FSF2 |30 |130 |30 |40 |130 |255 |130 | |
+ | |BS3 |30 |100 |30 |40 |100 |255 |100 | | ||
+ | |BEW3 |30 |100 |30 |40 |100 |255 |100 | | ||
</WRAP> | </WRAP> | ||
15. //wideSearch// \\ | 15. //wideSearch// \\ | ||
- | [+ 2.8.3] ''BioStation 3'' 얼굴 감지 범위를 넓힙니다. \\ | + | [+ 2.8.3] ''BioStation 3, BioEntry W3'' 얼굴 감지 범위를 넓힙니다. \\ |
x좌표와 width를 지정해야하는 난해한 설정인 searchRange는 더 이상 사용하지 않습니다. \\ | x좌표와 width를 지정해야하는 난해한 설정인 searchRange는 더 이상 사용하지 않습니다. \\ | ||
대신 얼굴 감지를 표준(false) 설정으로 할지, 광역(true)으로 할지 여부만 지정합니다. \\ | 대신 얼굴 감지를 표준(false) 설정으로 할지, 광역(true)으로 할지 여부만 지정합니다. \\ | ||
줄 1839: | 줄 1926: | ||
16. //unused// \\ | 16. //unused// \\ | ||
예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||
- | 17. //reserved// \\ | + | 17. //unableToSaveImageOfVisualFace// \\ |
+ | [+ 2.9.6] Visual face를 크리덴셜로 사용하는 장치에서 얼굴 이미지를 장치에 저장할 것인지를 나타냅니다. \\ | ||
+ | 이 설정을 키면 장치 내 모든 사용자의 얼굴 정보 중 이미지 정보가 즉시 삭제되며 템플릿만 남게됩니다. \\ | ||
+ | 또한, [[BS2_EnrollUserFaceEx]] API를 통해 사용자 이미지가 포함된 얼굴 정보를 가져오더라도 장치는 이를 무시하게됩니다. \\ | ||
+ | 기본값은 false 이며, 얼굴과 이미지 모두 저장입니다. \\ \\ | ||
+ | 18. //reserved// \\ | ||
예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||
줄 1883: | 줄 1975: | ||
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^ | ^값 ^설명 ^ | ||
- | |0 |사용안함 | | ||
|1 |Master | | |1 |Master | | ||
|2 |Slave | | |2 |Slave | | ||
|3 |Standalone | | |3 |Standalone | | ||
+ | </WRAP> | ||
+ | <WRAP info> | ||
+ | CoreStation은 Master로만 사용 가능합니다. 다른 값은 설정할 수 없습니다. | ||
</WRAP> | </WRAP> | ||
7. //numOfChannels// \\ | 7. //numOfChannels// \\ | ||
줄 2329: | 줄 2423: | ||
</WRAP> | </WRAP> | ||
2. //maskCheckMode// \\ | 2. //maskCheckMode// \\ | ||
- | ''FaceStation F2'' 마스크 착용 감지 모드를 설정합니다. \\ | + | ''Visual Face 기반'' 마스크 착용 감지 모드를 설정합니다. \\ |
- | ''FaceStation 2'' 이 설정은 무시됩니다. \\ | + | HARD로 설정 시 maskDetectionLevel에 따라 마스크 착용 위반이 감지될 경우 출입에 영향을 주게됩니다. \\ |
- | HARD로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면, 출입에 영향을 주게됩니다. \\ | + | SOFT로 설정 시 maskDetectionLevel에 따라 마스크 착용 위반이 감지될 경우 로그가 기록되고 출입에는 영향을 주지 않습니다. \\ |
- | SOFT로 설정 시, maskDetectionLevel에 근거하여 착용 위반이 감지되면, 근거를 로그를 남기고 출입에 영향을 주지 않습니다. \\ | + | maskCheckMode가 사용안함(0)으로 설정되면, maskDetectionLevel의 설정은 무시됩니다. \\ |
- | maskCheckMode가 사용안함(0)으로 설정되면, \\ | + | 또한 useRejectSound의 마스크 착용으로 인한 소리 발생과 faceCheckOrder의 마스크 착용 감지가 무시됩니다. \\ |
- | maskDetectionLevel 의 설정은 무시됩니다. \\ | + | [+2.9.8] 마스크 착용 금지(3)는 Mask Check Mode가 Check Before Authentication 인 경우만 설정 가능하며, maskDetectionLevel에 따라 마스크를 착용한 사용자는 인증이 실패됩니다. 이 옵션은 [[device_api#bs2devicecapabilities|BS2DeviceCapabilities - authDenyMaskSupported]]를 지원하는 장치만 사용할 수 있습니다. \\ |
- | 그리고 useRejectSound의 마스크 착용으로 인한 sound발생이, faceCheckOrder의 마스크 착용 감지가 무시됩니다. \\ | + | |
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^기본값 ^ | ^값 ^설명 ^기본값 ^ | ||
줄 2341: | 줄 2434: | ||
|1 |마스크 착용 감지 사용 (HARD) | | | |1 |마스크 착용 감지 사용 (HARD) | | | ||
|2 |마스크 착용 감지 사용 (SOFT) | | | |2 |마스크 착용 감지 사용 (SOFT) | | | ||
+ | |3 |마스크 착용 금지 | | | ||
</WRAP> | </WRAP> | ||
3. //reserved// \\ | 3. //reserved// \\ | ||
줄 2354: | 줄 2448: | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
6. //thermalThresholdLow// \\ | 6. //thermalThresholdLow// \\ | ||
- | ''지원 버전'' : ''FaceStation F2 V1.0.2'', ''FaceStation 2 V1.5.0'' \\ | ||
고열 판단 기준의 범위값이며, 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\ | 고열 판단 기준의 범위값이며, 설정 할 온도의 100을 곱한 값으로 입력하여야 합니다. \\ | ||
또한 섭씨 기준으로만 입력할 수 있습니다. \\ | 또한 섭씨 기준으로만 입력할 수 있습니다. \\ | ||
줄 2367: | 줄 2460: | ||
그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\ | 그리고 thermalThresholdLow보다 큰 값을 설정 하여야 합니다. \\ \\ | ||
8. //maskDetectionLevel// \\ | 8. //maskDetectionLevel// \\ | ||
- | ''FaceStation F2'' 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\ | + | ''Visual Face 기반'' 마스크 착용 감지 수준을 입력합니다. 여기서 감지 수준은 내부적으로 설정된 값에 근거합니다. \\ |
- | ''FaceStation 2'' 이 설정은 무시됩니다. \\ | + | |
<WRAP group 50%> | <WRAP group 50%> | ||
^값 ^설명 ^기본값 ^ | ^값 ^설명 ^기본값 ^ | ||
줄 2474: | 줄 2566: | ||
Visual barcode는 QR code sensor가 아닌, 일반 visual camera를 통해 QR code 읽기를 지원하며, \\ | Visual barcode는 QR code sensor가 아닌, 일반 visual camera를 통해 QR code 읽기를 지원하며, \\ | ||
이 기능을 사용하기 위해서는, 별도의 라이선스 활성화가 필요합니다. \\ | 이 기능을 사용하기 위해서는, 별도의 라이선스 활성화가 필요합니다. \\ | ||
- | 라이선스 활성화는 [[qr_code_api#BS2_EnableBarcodeLicense]]를 통해 지원합니다. \\ \\ | + | 라이선스 활성화는 [[BS2_EnableDeviceLicense]]를 통해 지원합니다. \\ \\ |
6. //motionSensitivity// \\ | 6. //motionSensitivity// \\ | ||
[+ 2.9.1] Visual barcode에 대한, 모션 센서의 감도를 설정합니다. \\ | [+ 2.9.1] Visual barcode에 대한, 모션 센서의 감도를 설정합니다. \\ | ||
줄 2657: | 줄 2749: | ||
BS2ExtensionNumber phonebook[128]; | BS2ExtensionNumber phonebook[128]; | ||
- | uint8_t reserved2[32]; ///< 32 bytes (reserved) | + | uint8_t resolution; |
+ | uint8_t transport; | ||
+ | uint8_t reserved2[30]; ///< 30 bytes (reserved) | ||
} BS2VoipConfigExt; | } BS2VoipConfigExt; | ||
</code> | </code> | ||
줄 2711: | 줄 2805: | ||
22. //phonebook// \\ | 22. //phonebook// \\ | ||
128개까지 내선 번호들을 전화번호부로 지정할 수 있습니다. \\ \\ | 128개까지 내선 번호들을 전화번호부로 지정할 수 있습니다. \\ \\ | ||
- | 23. //reserved2// \\ | + | 23. //resolution// \\ |
+ | [+2.9.8] 송신 비디오 해상도를 설정합니다. | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |360 x 640 | | ||
+ | |1 |720 x 480 | | ||
+ | </WRAP> | ||
+ | 24. //transport// \\ | ||
+ | [+2.9.8] 데이터 전송 방식을 설정합니다. | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |UDP | | ||
+ | |1 |TCP | | ||
+ | |2 |SSL | | ||
+ | </WRAP> | ||
+ | 25. //reserved2// \\ | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
줄 2725: | 줄 2834: | ||
BS2_PORT port; | BS2_PORT port; | ||
BS2_BOOL enabled; | BS2_BOOL enabled; | ||
- | uint8_t reserved; | + | uint8_t reserved; ///< 1 byte (packing) |
- | + | ||
- | uint8_t reserved2[32]; | + | uint8_t resolution; |
+ | uint8_t reserved2[31]; ///< 31 bytes (reserved) | ||
} BS2RtspConfig; | } BS2RtspConfig; | ||
</code> | </code> | ||
줄 2742: | 줄 2852: | ||
6. //reserved// \\ | 6. //reserved// \\ | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
- | 7. //reserved2// \\ | + | 7. //resolution// \\ |
+ | [+2.9.8] 송신 비디오 해상도를 설정합니다. | ||
+ | <WRAP group 30%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |180 x 320 | | ||
+ | |1 |720 x 480 | | ||
+ | </WRAP> | ||
+ | 8. //reserved2// \\ | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
줄 2814: | 줄 2931: | ||
5. //reserved1// \\ | 5. //reserved1// \\ | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
- | |||
- | |||
- | ==== BS2BarcodeConfig ==== | ||
- | <code cpp> | ||
- | typedef struct { | ||
- | uint8_t useBarcode; | ||
- | uint8_t scanTimeout; | ||
- | uint8_t bypassData; | ||
- | uint8_t treatAsCSN; | ||
- | |||
- | uint8_t useVisualBarcode; | ||
- | uint8_t motionSensitivity; | ||
- | uint8_t visualCameraScanTimeout; | ||
- | uint8_t reserved[9]; | ||
- | } BS2BarcodeConfig; | ||
- | </code> | ||
- | 1. //useBarcode// \\ | ||
- | ''XS2-QR 만 지원'' | ||
- | Barcode 사용여부 flag입니다. \\ \\ | ||
- | 2. //scanTimeout// \\ | ||
- | Barcode scan 시간을 설정합니다. 단위는 초입니다. \\ | ||
- | 기본값은 4초이며, 4~10초 범위 내로 입력 가능합니다. \\ \\ | ||
- | <WRAP group 50%> | ||
- | ^값 ^매크로 ^설명 ^ | ||
- | |4 |BS2_BARCODE_TIMEOUT_DEFAULT |기본값 | | ||
- | |4 |BS2_BARCODE_TIMEOUT_MIN |최소값 | | ||
- | |10 |BS2_BARCODE_TIMEOUT_MAX |최대값 | | ||
- | </WRAP> | ||
- | 3. //bypassData// \\ | ||
- | [+2.8.2] 읽혀진 barcode 정보를 장치에서 처리하지 않고, 서버로 전송하기 위해 사용합니다. \\ | ||
- | 사용자 인증을 위해 사용자 정보 구조체에 barcode 값을 저장하게되는 경우, \\ | ||
- | 32 byte의 크기 제약([[smartcard_api#BS2CSNCard|BS2CSNCard data 참조]])이 있으나, \\ | ||
- | [[BS2_SetBarcodeScanListener]]를 호출하고, 이 옵션을 사용하면 최대 512 byte크기의 barcode를 서버로 전송할 수 있습니다. \\ \\ | ||
- | 4. //treatAsCSN// \\ | ||
- | [+2.8.2] Barcode를 일반 CSN 카드와 동일하게 처리할지의 여부를 나타냅니다. \\ | ||
- | XS2-QR 1.1.3부터 적용되며, false의 경우, 이전과 동일하게 처리됩니다. \\ | ||
- | 이방식은 barcode로 처리될 수 있는 문자셋을 ASCII code 32에서 126까지 자유롭게 지정할 수 있습니다. ([[qr_code_api#BS2_WriteQRCode|BS2_WriteQRCode의 설명 참조]]) \\ | ||
- | true로 설정하면, barcode를 기존 CSN과 동일하게 숫자로만 취급하게 됩니다. \\ | ||
- | 따라서, 특수문자, 영문자가 들어있는 barcode 카드 데이터를 설정하고자 하면 오류를 반환할 수 있습니다. \\ | ||
- | 이 경우, card type만 다르게, CSN 카드와 barcode 데이터를 동일한 값으로 사용하고자하는 사용자의 목적에 부합할 수 있습니다. \\ \\ | ||
- | 5. //useVisualBarcode// \\ | ||
- | [+ 2.9.1] Visual barcode 사용여부 flag입니다. \\ | ||
- | <WRAP group 50%> | ||
- | ^지원장치 ^펌웨어 ^ | ||
- | |XS2-Finger |V1.2.0 | | ||
- | |XS2-Card |V1.2.0 | | ||
- | |BS3 |V1.1.0 | | ||
- | </WRAP> | ||
- | Visual barcode는 QR code sensor가 아닌, 일반 visual camera를 통해 QR code 읽기를 지원하며, \\ | ||
- | 이 기능을 사용하기 위해서는, 별도의 라이선스 활성화가 필요합니다. \\ | ||
- | 라이선스 활성화는 [[qr_code_api#BS2_EnableBarcodeLicense]]를 통해 지원합니다. \\ \\ | ||
- | 6. //motionSensitivity// \\ | ||
- | [+ 2.9.1] Visual barcode에 대한, 모션 센서의 감도를 설정합니다. \\ | ||
- | <WRAP group 50%> | ||
- | ^값 ^매크로 ^설명 ^ | ||
- | |0 |BS2_MOTION_SENSITIVITY_LOW |낮음 | | ||
- | |1 |BS2_MOTION_SENSITIVITY_NORMAL |중간 | | ||
- | |2 |BS2_MOTION_SENSITIVITY_HIGH |높음 | | ||
- | </WRAP> | ||
- | 7. //visualCameraScanTimeout// \\ | ||
- | [+ 2.9.1] Visual camera에대한 scan 시간을 설정합니다. 단위는 초입니다. \\ | ||
- | 기본값은 10초이며, 3~20초 범위 내로 입력 가능합니다. \\ | ||
- | <WRAP group 50%> | ||
- | ^값 ^매크로 ^설명 ^ | ||
- | |10 |BS2_VISUAL_BARCODE_TIMEOUT_DEFAULT |기본값 | | ||
- | |3 |BS2_VISUAL_BARCODE_TIMEOUT_MIN |최소값 | | ||
- | |20 |BS2_VISUAL_BARCODE_TIMEOUT_MAX |최대값 | | ||
- | </WRAP> | ||
- | 8. //reserved// \\ | ||
- | 예약된 공간입니다. \\ | ||
줄 3142: | 줄 3189: | ||
8. //reserved// \\ | 8. //reserved// \\ | ||
예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||
- | |||
- | |||
==== BS2CustomDesFireCard ==== | ==== BS2CustomDesFireCard ==== | ||
<code cpp> | <code cpp> | ||
줄 3166: | 줄 3211: | ||
사용자 인증을 위해 DESFire 카드내에 내장된 사용할 애플리케이션 식별자입니다.\\ \\ | 사용자 인증을 위해 DESFire 카드내에 내장된 사용할 애플리케이션 식별자입니다.\\ \\ | ||
4. //fileID// \\ | 4. //fileID// \\ | ||
- | DESFire 카드내에 내장된 사용할 애플리케이션가 데이터를 읽고 쓰기 위한 파일 식별자입니다.\\ \\ | + | DESFire 카드내에 내장된 사용할 애플리케이션이 데이터를 읽고 쓰기 위한 파일 식별자입니다.\\ \\ |
5. //encryptionType// \\ | 5. //encryptionType// \\ | ||
데이터 암호화 방식을 나타냅니다.\\ | 데이터 암호화 방식을 나타냅니다.\\ | ||
줄 3185: | 줄 3230: | ||
8. //skipBytes// \\ | 8. //skipBytes// \\ | ||
카드 데이터가 나타나는 위치를 의미합니다. \\ | 카드 데이터가 나타나는 위치를 의미합니다. \\ | ||
- | 카드 데이터가 저장 위치 처음부터 나타난다면 0, 이후에 나온다면 몇 byte가 skip 된 이후에 나타나는지를 의미합니다. \\ \\ | + | 카드 데이터를 읽어들일 시작점 입니다. 처음부터 읽을경우 0이고, 첫번째 이후일 경우 건너뛴 byte 수를 나타냅니다. \\ \\ |
9. //reserved// \\ | 9. //reserved// \\ | ||
예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||
10. //desfireAppKey// \\ | 10. //desfireAppKey// \\ | ||
DesFire card 정보에 접근하기 위한 키 정보를 나타냅니다. (고급설정) \\ \\ | DesFire card 정보에 접근하기 위한 키 정보를 나타냅니다. (고급설정) \\ \\ | ||
- | |||
- | |||
==== BS2CustomCardConfig ==== | ==== BS2CustomCardConfig ==== | ||
<code cpp> | <code cpp> | ||
줄 3241: | 줄 3284: | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
10. //formatID// \\ | 10. //formatID// \\ | ||
- | BioStar 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\ | + | BioStar 2 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\ |
11. //reserved5// \\ | 11. //reserved5// \\ | ||
예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ |