차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
ko:configuration_api [2023/03/02 15:23] kkshin [BS2BarcodeConfig] |
ko:configuration_api [2023/08/09 16:41] mashin |
||
---|---|---|---|
줄 89: | 줄 89: | ||
* [[BS2_GetOsdpStandardConfig]]: [+ 2.9.1] 장치의 OSDP 설정 정보를 가져옵니다. | * [[BS2_GetOsdpStandardConfig]]: [+ 2.9.1] 장치의 OSDP 설정 정보를 가져옵니다. | ||
* [[BS2_GetOsdpStandardActionConfig]]: [+ 2.9.1] OSDP 장치의 action별 LED/buzzer 설정을 가져옵니다. | * [[BS2_GetOsdpStandardActionConfig]]: [+ 2.9.1] OSDP 장치의 action별 LED/buzzer 설정을 가져옵니다. | ||
- | * [[BS2_SetOsdpStandardActionConfig]]: [+ 2.9.1] OSDP 장치의 action별 LED/buzzer 설정을 지정합니다. | + | * [[BS2_SetOsdpStandardActionConfig]]: [+ 2.9.1] OSDP 장치의 action별 LED/buzzer 설정을 저장합니다. |
+ | * [[BS2_GetCustomCardConfig]]: [+ 2.9.4] Custom smart card 설정을 가져옵니다. | ||
+ | * [[BS2_SetCustomCardConfig]]: [+ 2.9.4] Custom smart card 설정을 저장합니다. | ||
===== 구조체 ===== | ===== 구조체 ===== | ||
==== BS2FactoryConfig ==== | ==== BS2FactoryConfig ==== | ||
줄 3109: | 줄 3110: | ||
29. //actions// \\ | 29. //actions// \\ | ||
OSDP 장치에 대한 LED/buzzer 정보이며, 최대 32개 까지 지정할 수 있습니다. \\ \\ | OSDP 장치에 대한 LED/buzzer 정보이며, 최대 32개 까지 지정할 수 있습니다. \\ \\ | ||
+ | |||
+ | |||
+ | ==== BS2CustomMifareCard ==== | ||
+ | <code cpp> | ||
+ | typedef struct { | ||
+ | uint8_t primaryKey[6]; | ||
+ | uint8_t reserved1[2]; | ||
+ | uint8_t secondaryKey[6]; | ||
+ | uint8_t reserved2[2]; | ||
+ | uint16_t startBlockIndex; | ||
+ | uint8_t dataSize; | ||
+ | uint8_t skipBytes; | ||
+ | uint8_t reserved[4]; | ||
+ | } BS2CustomMifareCard; | ||
+ | </code> | ||
+ | 1. //primaryKey// \\ | ||
+ | Mifare card 정보에 접근하기 위한 첫번째 암호화 키입니다. \\ \\ | ||
+ | 2. //reserved1// \\ | ||
+ | 예약된 공간입니다.\\ \\ | ||
+ | 3. //secondaryKey// \\ | ||
+ | Mifare card 정보에 접근하기 위한 두번째 암호화 키입니다. \\ \\ | ||
+ | 4. //reserved2// \\ | ||
+ | 예약된 공간입니다.\\ \\ | ||
+ | 5. //startBlockIndex// \\ | ||
+ | Mifare data storage에서의 start block index입니다.\\ \\ | ||
+ | 6. //dataSize// \\ | ||
+ | 카드 데이터가 몇 byte의 크기를 갖는지를 나타냅니다. \\ \\ | ||
+ | 7. //skipBytes// \\ | ||
+ | 카드 데이터가 나타나는 위치를 의미합니다. \\ | ||
+ | 카드 데이터가 저장 위치 처음부터 나타난다면 0, 이후에 나온다면 몇 byte가 skip 된 이후에 나타나는지를 의미합니다. \\ \\ | ||
+ | 8. //reserved// \\ | ||
+ | 예약된 공간입니다.\\ \\ | ||
+ | |||
+ | |||
+ | ==== BS2CustomDesFireCard ==== | ||
+ | <code cpp> | ||
+ | typedef struct { | ||
+ | uint8_t primaryKey[16]; | ||
+ | uint8_t secondaryKey[16]; | ||
+ | uint8_t appID[3]; | ||
+ | uint8_t fileID; | ||
+ | uint8_t encryptionType; // 0: DES/3DES, 1: AES | ||
+ | uint8_t operationMode; // 0: legacy(use picc master key), 1: new mode(use app master, file read, file write key) | ||
+ | uint8_t dataSize; | ||
+ | uint8_t skipBytes; | ||
+ | uint8_t reserved[4]; | ||
+ | BS2DesFireAppLevelKey desfireAppKey; ///<52 bytes | ||
+ | } BS2CustomDesFireCard; ///<96 Bytes | ||
+ | </code> | ||
+ | 1. //primaryKey// \\ | ||
+ | DesFire card 정보에 접근하기 위한 첫번째 암호화 키입니다. (일반설정) \\ \\ | ||
+ | 2. //secondaryKey// \\ | ||
+ | DesFire card 정보에 접근하기 위한 두번째 암호화 키입니다. (일반설정) \\ \\ | ||
+ | 3. //appID// \\ | ||
+ | 사용자 인증을 위해 DESFire 카드내에 내장된 사용할 애플리케이션 식별자입니다.\\ \\ | ||
+ | 4. //fileID// \\ | ||
+ | DESFire 카드내에 내장된 사용할 애플리케이션가 데이터를 읽고 쓰기 위한 파일 식별자입니다.\\ \\ | ||
+ | 5. //encryptionType// \\ | ||
+ | 데이터 암호화 방식을 나타냅니다.\\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |DES/3DES | | ||
+ | |1 |AES | | ||
+ | </WRAP> | ||
+ | 6. //operationMode// \\ | ||
+ | 운영 방식을 지정합니다. \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |일반설정 사용 (PICC master key를 사용) | | ||
+ | |1 |고급설정 사용 (App master key를 사용) | | ||
+ | </WRAP> | ||
+ | 7. //dataSize// \\ | ||
+ | 카드 데이터가 몇 byte의 크기를 갖는지를 나타냅니다. \\ \\ | ||
+ | 8. //skipBytes// \\ | ||
+ | 카드 데이터가 나타나는 위치를 의미합니다. \\ | ||
+ | 카드 데이터가 저장 위치 처음부터 나타난다면 0, 이후에 나온다면 몇 byte가 skip 된 이후에 나타나는지를 의미합니다. \\ \\ | ||
+ | 9. //reserved// \\ | ||
+ | 예약된 공간입니다.\\ \\ | ||
+ | 10. //desfireAppKey// \\ | ||
+ | DesFire card 정보에 접근하기 위한 키 정보를 나타냅니다. (고급설정) \\ \\ | ||
+ | |||
+ | |||
+ | ==== BS2CustomCardConfig ==== | ||
+ | <code cpp> | ||
+ | typedef struct { | ||
+ | BS2_CARD_DATA_TYPE dataType; | ||
+ | BS2_BOOL useSecondaryKey; | ||
+ | uint8_t reserved1[2]; | ||
+ | |||
+ | BS2CustomMifareCard mifare; | ||
+ | BS2CustomDesFireCard desfire; | ||
+ | uint8_t reserved2[24]; | ||
+ | uint8_t reserved3[96]; | ||
+ | |||
+ | BS2_CARD_BYTE_ORDER smartCardByteOrder; | ||
+ | uint8_t reserved4[3]; | ||
+ | BS2_UID formatID; | ||
+ | uint8_t reserved5[8]; | ||
+ | } BS2CustomCardConfig; | ||
+ | </code> | ||
+ | 1. //dataType// \\ | ||
+ | Card의 데이터 유형입니다. \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |바이너리 | | ||
+ | |1 |아스키 | | ||
+ | |2 |UTF16 | | ||
+ | |3 |BCD | | ||
+ | </WRAP> | ||
+ | 2. //useSecondaryKey// \\ | ||
+ | 두번째 암호화 키 사용 유무를 결정하는 flag입니다. \\ \\ | ||
+ | 3. //reserved1// \\ | ||
+ | 예약된 공간입니다. \\ \\ | ||
+ | 4. //mifare// \\ | ||
+ | Mifare custom card 정보를 설정합니다. \\ \\ | ||
+ | 5. //desfire// \\ | ||
+ | DESFire custom card 정보를 설정합니다. \\ \\ | ||
+ | 6. //reserved2// \\ | ||
+ | 예약된 공간입니다. \\ \\ | ||
+ | 7. //reserved3// \\ | ||
+ | 예약된 공간입니다. \\ \\ | ||
+ | 8. //smartCardByteOrder// \\ | ||
+ | MSB 또는 LSB로 출력을 지정할 수 있습니다. \\ | ||
+ | <WRAP group 50%> | ||
+ | ^값 ^설명 ^ | ||
+ | |0 |MSB | | ||
+ | |1 |LSB | | ||
+ | </WRAP> | ||
+ | 9. //reserved4// \\ | ||
+ | 예약된 공간입니다. \\ \\ | ||
+ | 10. //formatID// \\ | ||
+ | BioStar 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\ | ||
+ | 11. //reserved5// \\ | ||
+ | 예약된 공간입니다. \\ \\ |