차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
| 양쪽 이전 판 이전 판 다음 판 | 이전 판 | ||
|
ko:configuration_api [2025/06/11 13:49] 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_GetFacilityCodeConfig]]: [+ 2.9.9] ''Door Interface(DI-24)''와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용되는 BS2FacilityCode를 가져옵니다. |
| - | * [[BS2_SetFacilityCodeConfig]]: [+ 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_GetRS485ConfigExDynamic]]: [+ 2.9.9] ''CoreStation''일 경우 RS485 네트워크 설정 정보를 가져옵니다. |
| - | * [[BS2_SetRS485ConfigExDynamic]]: [+ 2.9.9] CoreStation일 경우 RS485 네트워크 설정 정보를 저장합니다. | + | * [[BS2_SetRS485ConfigExDynamic]]: [+ 2.9.9] ''CoreStation''일 경우 RS485 네트워크 설정 정보를 저장합니다. |
| ===== 구조체 ===== | ===== 구조체 ===== | ||
| ==== BS2FactoryConfig ==== | ==== BS2FactoryConfig ==== | ||
| 줄 165: | 줄 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> | ||
| 줄 227: | 줄 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 ==== | ||
| 줄 715: | 줄 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> | ||
| 줄 800: | 줄 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%> | ||
| ^값 ^설명 ^ | ^값 ^설명 ^ | ||
| 줄 3408: | 줄 3421: | ||
| 3. //BS2FacilityCode// \\ | 3. //BS2FacilityCode// \\ | ||
| Door Interface(DI-24)와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용됩니다. \\ \\ | Door Interface(DI-24)와 마스터 장치의 OSDP 연결이 끊어진 경우 인증코드로 사용됩니다. \\ \\ | ||
| - | 4. //reserved0// \\ | + | 4. //reserved1// \\ |
| 예약된 공간입니다. \\ \\ | 예약된 공간입니다. \\ \\ | ||
| 줄 3414: | 줄 3427: | ||
| <code cpp> | <code cpp> | ||
| typedef struct { | typedef struct { | ||
| - | BS2_DEVICE_ID deviceID; ///< | + | uint32_t deviceID; ///< |
| - | BS2_DEVICE_TYPE deviceType; ///< 2 bytes | + | uint16_t deviceType; ///< 2 bytes |
| - | BS2_BOOL enableOSDP; ///< 1 byte | + | uint8_t enableOSDP; ///< 1 byte |
| - | BS2_BOOL connected; ///< 1 bytes (packing) | + | uint8_t connected; ///< 1 bytes (packing) |
| union { | union { | ||
| uint8_t channelInfo; | uint8_t channelInfo; | ||
| - | BS2_DEVICE_ID parentID; | + | uint32_t parentID; |
| }; | }; | ||
| } BS2Rs485SlaveDeviceEX; | } BS2Rs485SlaveDeviceEX; | ||
| 줄 3430: | 줄 3443: | ||
| uint8_t useRegistance; | uint8_t useRegistance; | ||
| uint8_t numOfDevices; | uint8_t numOfDevices; | ||
| - | BS2_OSDP_CHANNEL_TYPE channelType; | + | uint8_t channelType; |
| BS2Rs485SlaveDeviceEX *slaveDevices; | BS2Rs485SlaveDeviceEX *slaveDevices; | ||
| } BS2Rs485ChannelEXDynamic; | } BS2Rs485ChannelEXDynamic; | ||
| 줄 3443: | 줄 3456: | ||
| </code> | </code> | ||
| <WRAP info> | <WRAP info> | ||
| - | baudRate을 제외한 모든 값은 읽기 전용으로 변경이 불가능합니다. | + | baudRate을 제외한 모든 값은 읽기 전용으로 변경이 불가능합니다. \\ |
| ''지원 장치'': CoreStation 20(CS-20, CS-20P), Door Interface(DI-24) | ''지원 장치'': CoreStation 20(CS-20, CS-20P), Door Interface(DI-24) | ||
| </WRAP> | </WRAP> | ||
| 줄 3461: | 줄 3474: | ||
| 종단 저항을 설정할지 결정하는 flag입니다. \\ \\ | 종단 저항을 설정할지 결정하는 flag입니다. \\ \\ | ||
| 4. //numOfDevices// \\ | 4. //numOfDevices// \\ | ||
| - | 슬레이브 장치의 개수입니다.\\ \\ | + | 슬레이브 장치의 개수입니다. \\ \\ |
| - | 5. //slaveDevices// \\ | + | 5. //channelType// \\ |
| - | 슬레이브 장치를 나열한 리스트로 최대 32개까지 정의할 수 있습니다.\\ \\ | + | 해당 포트에 연결된 슬레이브 장치타입을 나타냅니다. \\ |
| - | 6. //mode// \\ | + | <WRAP group 50%> |
| - | RS485 네트워크에서 어떤 모드로 동작할지 결정하는 flag입니다 .\\ | + | ^값 ^설명 ^ |
| + | |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%> | <WRAP group 50%> | ||
| ^값 ^설명 ^ | ^값 ^설명 ^ | ||
| 줄 3475: | 줄 3503: | ||
| CoreStation은 Master로만 사용 가능합니다. 다른 값은 설정할 수 없습니다. | CoreStation은 Master로만 사용 가능합니다. 다른 값은 설정할 수 없습니다. | ||
| </WRAP> | </WRAP> | ||
| - | 7. //numOfChannels// \\ | + | 8. //numOfChannels// \\ |
| RS485 채널의 개수입니다.\\ \\ | RS485 채널의 개수입니다.\\ \\ | ||
| - | 8. //reserved// \\ | + | 9. //reserved// \\ |
| 예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||
| - | 9. //reserved1// \\ | + | 10. //reserved1// \\ |
| 예약된 공간입니다.\\ \\ | 예약된 공간입니다.\\ \\ | ||
| - | 10. //channels// \\ | + | 11. //channels// \\ |
| RS485 채널을 나열한 리스트로 최대 8개까지 설정할 수 있습니다.\\ \\ | RS485 채널을 나열한 리스트로 최대 8개까지 설정할 수 있습니다.\\ \\ | ||