차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
| 양쪽 이전 판 이전 판 다음 판 | 이전 판 | ||
|
ko:configuration_api [2025/06/11 13:20] mwkim |
ko:configuration_api [2026/01/20 17:07] (현재) mwkim [BS2SystemConfig] |
||
|---|---|---|---|
| 줄 94: | 줄 94: | ||
| * [[BS2_GetMifareCardConfigEx]]: [+ 2.9.9] 장치의 Mifare 카드 중 AES128 암호화 된 카드에 사용되는 설정 정보를 가져옵니다. | * [[BS2_GetMifareCardConfigEx]]: [+ 2.9.9] 장치의 Mifare 카드 중 AES128 암호화 된 카드에 사용되는 설정 정보를 가져옵니다. | ||
| * [[BS2_SetMifareCardConfigEx]]: [+ 2.9.9] 장치의 Mifare 카드 중 AES128 암호화 된 카드에 사용되는 설정 정보를 저장합니다. | * [[BS2_SetMifareCardConfigEx]]: [+ 2.9.9] 장치의 Mifare 카드 중 AES128 암호화 된 카드에 사용되는 설정 정보를 저장합니다. | ||
| + | * [[BS2_GetFacilityCodeConfig]]: [+ 2.9.9] ''Door Interface(DI-24)''와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용되는 BS2FacilityCode를 가져옵니다. | ||
| + | * [[BS2_SetFacilityCodeConfig]]: [+ 2.9.9] ''Door Interface(DI-24)''와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용되는 BS2FacilityCode 설정을 저장합니다. | ||
| + | * [[BS2_GetRS485ConfigExDynamic]]: [+ 2.9.9] ''CoreStation''일 경우 RS485 네트워크 설정 정보를 가져옵니다. | ||
| + | * [[BS2_SetRS485ConfigExDynamic]]: [+ 2.9.9] ''CoreStation''일 경우 RS485 네트워크 설정 정보를 저장합니다. | ||
| ===== 구조체 ===== | ===== 구조체 ===== | ||
| ==== BS2FactoryConfig ==== | ==== BS2FactoryConfig ==== | ||
| 줄 161: | 줄 165: | ||
| bool reserved0; // (write protected) | bool reserved0; // (write protected) | ||
| uint8_t reserved[2]; | uint8_t reserved[2]; | ||
| - | uint32_t useCardOperationMask; | + | uint32_t useCardOperationMask; ///< 4 bytes (bitmask , no use 0 position bit - 0~30 bit, valid data - 31 bit) |
| - | uint8_t reserved2[16]; | + | uint8_t reserved1[6]; ///< 6 bytes |
| + | BS2_BOOL adminTwoStepAuth; ///< 1 byte , BDP-788 | ||
| + | uint8_t reserved2[9]; ///< 8 bytes (reserved) | ||
| } BS2SystemConfig; | } BS2SystemConfig; | ||
| </code> | </code> | ||
| 줄 223: | 줄 229: | ||
| |0x00000001 |CARD_OPERATION_MASK_EM | | |0x00000001 |CARD_OPERATION_MASK_EM | | ||
| </WRAP> | </WRAP> | ||
| - | 16. //reserved2// \\ | + | 16. //reserved1// \\ |
| + | 예약된 공간입니다. \\ \\ | ||
| + | 17. //adminTwoStepAuth// \\ | ||
| + | 2단계에 걸친 마스터 관리자(Master Admin) 인증을 수행할 지 여부를 나타냅니다. \\ | ||
| + | CE RED(유럽 무선기기 지침) 준수를 위해, 마스터 관리자(Master Admin) 기능을 지원하는 장치(하단 표 참조)는 해당 값을 변경할 수 없습니다. \\ | ||
| + | 단, 해당 기능을 지원하지 않는 장치에서 업그레이드를 진행한 경우에 한해 설정 변경이 가능합니다. \\ | ||
| + | false로 설정하면 1단계 인증을 수행합니다. 일반 사용자 인증 설정인 BS2AuthConfig 또는 BS2AuthConfigEx의 영향을 받지 않으며, 마스터 관리자(Master Admin)에게 할당된 크리덴셜 정보만으로 인증을 진행합니다. \\ | ||
| + | true로 설정하면 2단계 인증을 수행합니다. 장치에 등록된 크리덴셜이 부족하거나하는 등의 이유로 인해 1단계 인증까지만 수행 가능한 상태일 경우, 인증 실패로 처리될 수 있습니다. \\ \\ | ||
| + | 18. //reserved2// \\ | ||
| 예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
| ==== BS2AuthConfig ==== | ==== BS2AuthConfig ==== | ||
| 줄 711: | 줄 725: | ||
| uint8_t smartCardByteOrder; | uint8_t smartCardByteOrder; | ||
| uint8_t reserved[1]; | uint8_t reserved[1]; | ||
| - | BS2_MIFARE_ENCRYPTION mifareEncType; | + | uint8_t mifareEncType; |
| - | uint8_t reserved[20]; | + | uint8_t reserved[20]; |
| } BS2CardConfig; | } BS2CardConfig; | ||
| </code> | </code> | ||
| 줄 796: | 줄 810: | ||
| 예약된 공간입니다. \\ | 예약된 공간입니다. \\ | ||
| 26. //mifareEncType// \\ | 26. //mifareEncType// \\ | ||
| - | [+2.9.9] Mifare Card의 암호화 방식을 지정합니다. Mifare Classic 카드는 CRYPTO1만 지원하며, Mifare Plus 카드는 CRYPTO1과 AES128 모두 지원합니다. \\ | + | [+2.9.9] Mifare Card의 암호화 방식을 지정합니다. Mifare Classic 카드는 CRYPTO1만 지원하며, \\ |
| - | CRYPTO1으로 설정하면 BS2MifareCard의 Mifare 설정이 적용되고, AES128로 설정하면 BS2_SetMifareCardConfigEx 및 BS2_GetMifareCardConfigEx를 통해 설정할 수 있는 BS2MifareCardConfigEx 설정이 적용됩니다. \\ | + | Mifare Plus 카드는 CRYPTO1과 AES128 모두 지원합니다. \\ |
| + | CRYPTO1으로 설정하면 BS2MifareCard의 Mifare 설정이 적용되고, AES128로 설정하면 \\ | ||
| + | BS2_SetMifareCardConfigEx 및 BS2_GetMifareCardConfigEx를 통해 설정할 수 있는 \\ | ||
| + | BS2MifareCardConfigEx 설정이 적용됩니다. \\ | ||
| <WRAP group 50%> | <WRAP group 50%> | ||
| ^값 ^설명 ^ | ^값 ^설명 ^ | ||
| 줄 3404: | 줄 3421: | ||
| 3. //BS2FacilityCode// \\ | 3. //BS2FacilityCode// \\ | ||
| Door Interface(DI-24)와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용됩니다. \\ \\ | Door Interface(DI-24)와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용됩니다. \\ \\ | ||
| - | 4. //reserved0// \\ | + | 4. //reserved1// \\ |
| 예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
| + | |||
| + | ==== BS2Rs485ConfigEXDynamic ==== | ||
| + | <code cpp> | ||
| + | typedef struct { | ||
| + | uint32_t deviceID; ///< | ||
| + | uint16_t deviceType; ///< 2 bytes | ||
| + | uint8_t enableOSDP; ///< 1 byte | ||
| + | uint8_t connected; ///< 1 bytes (packing) | ||
| + | |||
| + | union { | ||
| + | uint8_t channelInfo; | ||
| + | uint32_t parentID; | ||
| + | }; | ||
| + | } BS2Rs485SlaveDeviceEX; | ||
| + | |||
| + | typedef struct { | ||
| + | uint32_t baudRate; | ||
| + | uint8_t channelIndex; | ||
| + | uint8_t useRegistance; | ||
| + | uint8_t numOfDevices; | ||
| + | uint8_t channelType; | ||
| + | BS2Rs485SlaveDeviceEX *slaveDevices; | ||
| + | } BS2Rs485ChannelEXDynamic; | ||
| + | |||
| + | typedef struct { | ||
| + | BS2_RS485_MODE mode[8]; | ||
| + | uint16_t numOfChannels; | ||
| + | uint8_t reserved[2]; | ||
| + | uint8_t reserved1[32]; | ||
| + | BS2Rs485ChannelEXDynamic channels[8]; | ||
| + | } BS2Rs485ConfigEXDynamic; | ||
| + | </code> | ||
| + | <WRAP info> | ||
| + | baudRate을 제외한 모든 값은 읽기 전용으로 변경이 불가능합니다. \\ | ||
| + | ''지원 장치'': CoreStation 20(CS-20, CS-20P), Door Interface(DI-24) | ||
| + | </WRAP> | ||
| + | 1. //baudRate// \\ | ||
| + | RS485 통신 속도이며 설정할 수 있는 범위는 다음과 같습니다. \\ | ||
| + | <WRAP group 50%> | ||
| + | ^값 ^ | ||
| + | |9600 | | ||
| + | |19200 | | ||
| + | |38400 | | ||
| + | |57600 | | ||
| + | |115200 | | ||
| + | </WRAP> | ||
| + | 2. //channelIndex// \\ | ||
| + | RS485 network의 통신 채널 번호입니다. \\ \\ | ||
| + | 3. //useRegistance// \\ | ||
| + | 종단 저항을 설정할지 결정하는 flag입니다. \\ \\ | ||
| + | 4. //numOfDevices// \\ | ||
| + | 슬레이브 장치의 개수입니다. \\ \\ | ||
| + | 5. //channelType// \\ | ||
| + | 해당 포트에 연결된 슬레이브 장치타입을 나타냅니다. \\ | ||
| + | <WRAP group 50%> | ||
| + | ^값 ^설명 ^ | ||
| + | |0 |연결이 없음 | | ||
| + | |1 |슈프리마 장치 | | ||
| + | |2 |OSDP 표준 장치 | | ||
| + | |3 |더 이상 연결할 수 없음 | | ||
| + | </WRAP> | ||
| + | 6. //slaveDevices// \\ | ||
| + | 장치에 연결된 슬레이브 장치를 나열한 포인터 \\ | ||
| + | <WRAP group 50%> | ||
| + | 포트별 연결가능한 최대 장치 | ||
| + | |Host 포트 |16개 | | ||
| + | |0번 포트 |2개 | | ||
| + | |1번 포트 |2개 | | ||
| + | </WRAP> | ||
| + | 7. //mode// \\ | ||
| + | RS485 네트워크에서 어떤 모드로 동작할지 결정하는 flag입니다. \\ | ||
| + | <WRAP group 50%> | ||
| + | ^값 ^설명 ^ | ||
| + | |1 |Master | | ||
| + | |2 |Slave | | ||
| + | |3 |Standalone | | ||
| + | </WRAP> | ||
| + | <WRAP info> | ||
| + | CoreStation은 Master로만 사용 가능합니다. 다른 값은 설정할 수 없습니다. | ||
| + | </WRAP> | ||
| + | 8. //numOfChannels// \\ | ||
| + | RS485 채널의 개수입니다.\\ \\ | ||
| + | 9. //reserved// \\ | ||
| + | 예약된 공간입니다.\\ \\ | ||
| + | 10. //reserved1// \\ | ||
| + | 예약된 공간입니다.\\ \\ | ||
| + | 11. //channels// \\ | ||
| + | RS485 채널을 나열한 리스트로 최대 8개까지 설정할 수 있습니다.\\ \\ | ||
| + | |||