차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
| 양쪽 이전 판 이전 판 다음 판 | 이전 판 다음 판 양쪽 다음 판 | ||
|
ko:configuration_api [2023/03/02 15:23] kkshin [BS2BarcodeConfig] |
ko:configuration_api [2023/08/16 14:45] 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 수를 나타냅니다. \\ \\ | ||
| + | 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 수를 나타냅니다. \\ \\ | ||
| + | 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 2 애플리케이션에서 card configuration을 데이터베이스 관리할 필요가 있을 경우 사용할 수 있는 식별자입니다. \\ \\ | ||
| + | 11. //reserved5// \\ | ||
| + | 예약된 공간입니다. \\ \\ | ||