@samlab-corp/sfm-node 0.1.0

package/dist/constants/protocol.d.ts

@@ -0,0 +1,653 @@
+/**
+ * SFM Protocol Manual V3.6.0
+ * 프로토콜 레벨 상수 (에러 코드, 플래그, 명령어, 시스템 파라미터)
+ */
+export declare const SFM_ERROR: {
+    readonly SUCCESS: 97;
+    readonly SCAN_SUCCESS: 98;
+    readonly SCAN_FAIL: 99;
+    readonly NOT_FOUND: 105;
+    readonly NOT_MATCH: 106;
+    readonly TRY_AGAIN: 107;
+    readonly TIME_OUT: 108;
+    readonly MEM_FULL: 109;
+    readonly EXIST_ID: 110;
+    readonly CONTINUE: 116;
+    readonly UNSUPPORTED: 117;
+};
+export declare const SFM_FLAG: {
+    readonly NONE: 0;
+    readonly CHECK_ID: 112;
+    readonly ADD_NEW: 113;
+    readonly AUTO_ID: 121;
+    readonly CHECK_FINGER: 132;
+};
+export declare const COMM_ERROR: {
+    readonly SUCCESS: 0;
+    readonly PACKET_FORMAT_ERROR: -3;
+    readonly INVALID_PACKET_SIZE: -4;
+    readonly WRITE_TIMEOUT: -5;
+    readonly READ_TIMEOUT: -6;
+    readonly CHECKSUM_MISMATCH: -7;
+    readonly PROBE_TIMEOUT: -102;
+    readonly MEMORY_ALLOC_FAILED: -200;
+    readonly INVALID_FILE_SIZE: -202;
+    readonly INVALID_FIRMWARE_HEADER: -203;
+    readonly SECURE_PACKET_TIMEOUT: -305;
+    readonly SECURE_CODE_MISMATCH: -501;
+};
+export declare const SFM_CMD: {
+    readonly SW: 1;
+    readonly SF: 2;
+    readonly SR: 3;
+    readonly SS: 4;
+    readonly RS: 208;
+    readonly SDB: 212;
+    readonly LDB: 211;
+    readonly ES: 5;
+    readonly ESA: 112;
+    readonly EI: 6;
+    readonly EIX: 128;
+    readonly ET: 7;
+    readonly ETX: 135;
+    readonly VS: 8;
+    readonly VI: 9;
+    readonly VIX: 130;
+    readonly VT: 16;
+    readonly VH: 34;
+    readonly IS: 17;
+    readonly II: 18;
+    readonly IIX: 129;
+    readonly IT: 19;
+    readonly DA: 23;
+    readonly DT: 22;
+    readonly DS: 30;
+    readonly LT: 24;
+    readonly LTX: 134;
+    readonly RI: 32;
+    readonly RIX: 132;
+    readonly SI: 21;
+    readonly SIX: 131;
+    readonly RT: 20;
+    readonly RTX: 137;
+    readonly ST: 33;
+    readonly KW: 52;
+    readonly AW: 101;
+    readonly AR: 102;
+    readonly ABL: 243;
+    readonly DBL: 244;
+    readonly PKE: 42;
+};
+export declare const SFM_PARAM: {
+    /** 입력 대기 시간 */
+    readonly TIMEOUT: {
+        readonly id: 98;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "INFINITE";
+        }, {
+            readonly value: 49;
+            readonly alias: "1S";
+        }, {
+            readonly value: 50;
+            readonly alias: "2S";
+        }, {
+            readonly value: 51;
+            readonly alias: "3S";
+        }, {
+            readonly value: 52;
+            readonly alias: "4S";
+        }, {
+            readonly value: 53;
+            readonly alias: "5S";
+        }, {
+            readonly value: 58;
+            readonly alias: "10S";
+        }, {
+            readonly value: 63;
+            readonly alias: "15S";
+        }, {
+            readonly value: 68;
+            readonly alias: "20S";
+        }];
+    };
+    /** 템플릿 크기 */
+    readonly TEMPLATE_SIZE: {
+        readonly id: 100;
+    };
+    /** 등록 모드 */
+    readonly ENROLL_MODE: {
+        readonly id: 101;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "SCAN1";
+        }, {
+            readonly value: 49;
+            readonly alias: "SCAN2_MERGE";
+        }, {
+            readonly value: 65;
+            readonly alias: "SCAN2_DUAL";
+        }];
+    };
+    /** 보안 등급 (FAR) */
+    readonly SECURITY_LEVEL: {
+        readonly id: 102;
+        readonly options: readonly [{
+            readonly value: 50;
+            readonly alias: "LOW";
+        }, {
+            readonly value: 51;
+            readonly alias: "NORMAL";
+        }, {
+            readonly value: 52;
+            readonly alias: "HIGH";
+        }, {
+            readonly value: 53;
+            readonly alias: "HIGHEST";
+        }, {
+            readonly value: 80;
+            readonly alias: "AUTO_NORMAL";
+        }, {
+            readonly value: 81;
+            readonly alias: "AUTO_SECURE";
+        }, {
+            readonly value: 82;
+            readonly alias: "AUTO_MORE_SECURE";
+        }];
+    };
+    /** 암호화 모드 */
+    readonly ENCRYPTION_MODE: {
+        readonly id: 103;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OFF";
+        }, {
+            readonly value: 49;
+            readonly alias: "ON";
+        }];
+    };
+    /** 센서 타입 */
+    readonly SENSOR_TYPE: {
+        readonly id: 104;
+        readonly options: readonly [{
+            readonly value: 49;
+            readonly alias: "FC";
+        }, {
+            readonly value: 51;
+            readonly alias: "OPTICAL";
+        }, {
+            readonly value: 52;
+            readonly alias: "TC";
+        }, {
+            readonly value: 56;
+            readonly alias: "OC";
+        }, {
+            readonly value: 57;
+            readonly alias: "OL";
+        }, {
+            readonly value: 59;
+            readonly alias: "FOH02";
+        }, {
+            readonly value: 60;
+            readonly alias: "TS4";
+        }];
+    };
+    /** 이미지 전송 포맷 */
+    readonly IMAGE_FORMAT: {
+        readonly id: 108;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "RAW_GRAY";
+        }, {
+            readonly value: 49;
+            readonly alias: "BINARY";
+        }, {
+            readonly value: 50;
+            readonly alias: "GRAY_4BIT";
+        }, {
+            readonly value: 51;
+            readonly alias: "WSQ";
+        }];
+    };
+    /** 모듈 ID */
+    readonly MODULE_ID: {
+        readonly id: 109;
+    };
+    /** 펌웨어 버전 */
+    readonly FIRMWARE_VERSION: {
+        readonly id: 110;
+    };
+    /** 시리얼 넘버 */
+    readonly SERIAL_NUMBER: {
+        readonly id: 111;
+    };
+    /** 통신 속도 */
+    readonly BAUDRATE: {
+        readonly id: 113;
+        readonly options: readonly [{
+            readonly value: 49;
+            readonly alias: "9600";
+        }, {
+            readonly value: 50;
+            readonly alias: "19200";
+        }, {
+            readonly value: 51;
+            readonly alias: "38400";
+        }, {
+            readonly value: 52;
+            readonly alias: "57600";
+        }, {
+            readonly value: 53;
+            readonly alias: "115200";
+        }, {
+            readonly value: 54;
+            readonly alias: "230400";
+        }, {
+            readonly value: 55;
+            readonly alias: "460800";
+        }, {
+            readonly value: 56;
+            readonly alias: "921600";
+        }];
+    };
+    /** 보조 통신 속도 */
+    readonly BAUDRATE2: {
+        readonly id: 114;
+    };
+    /** 등록된 지문 수 */
+    readonly ENROLLED_FINGER: {
+        readonly id: 115;
+    };
+    /** 등록 가능한 지문 수 */
+    readonly AVAILABLE_FINGER: {
+        readonly id: 116;
+    };
+    /** SCAN_SUCCESS 응답 전송 */
+    readonly SEND_SCAN_SUCCESS: {
+        readonly id: 117;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OFF";
+        }, {
+            readonly value: 49;
+            readonly alias: "ON";
+        }];
+    };
+    /** 패킷 교환 형식 */
+    readonly ASCII_PACKET: {
+        readonly id: 118;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "HEX";
+        }, {
+            readonly value: 49;
+            readonly alias: "ASCII";
+        }];
+    };
+    /** 센서 이미지 회전 */
+    readonly ROTATE_IMAGE: {
+        readonly id: 119;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "NORMAL";
+        }, {
+            readonly value: 49;
+            readonly alias: "FLIP";
+        }];
+    };
+    /** 매칭 허용 회전 각도 */
+    readonly ROTATION: {
+        readonly id: 120;
+        readonly options: readonly [{
+            readonly value: 49;
+            readonly alias: "DEG15";
+        }, {
+            readonly value: 50;
+            readonly alias: "DEG30";
+        }, {
+            readonly value: 51;
+            readonly alias: "DEG45";
+        }, {
+            readonly value: 52;
+            readonly alias: "DEG60";
+        }, {
+            readonly value: 53;
+            readonly alias: "DEG75";
+        }, {
+            readonly value: 54;
+            readonly alias: "DEG90";
+        }];
+    };
+    /** 센서 감도 */
+    readonly SENSITIVITY: {
+        readonly id: 128;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "LV0";
+        }, {
+            readonly value: 49;
+            readonly alias: "LV1";
+        }, {
+            readonly value: 50;
+            readonly alias: "LV2";
+        }, {
+            readonly value: 51;
+            readonly alias: "LV3";
+        }, {
+            readonly value: 52;
+            readonly alias: "LV4";
+        }, {
+            readonly value: 53;
+            readonly alias: "LV5";
+        }, {
+            readonly value: 54;
+            readonly alias: "LV6";
+        }, {
+            readonly value: 55;
+            readonly alias: "LV7";
+        }];
+    };
+    /** 이미지 품질 기준 */
+    readonly IMAGE_QUALITY: {
+        readonly id: 129;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "WEAK";
+        }, {
+            readonly value: 49;
+            readonly alias: "MODERATE";
+        }, {
+            readonly value: 50;
+            readonly alias: "STRONG";
+        }, {
+            readonly value: 51;
+            readonly alias: "STRONGEST";
+        }];
+    };
+    /** GPIO/FreeScan 자동 응답 */
+    readonly AUTO_RESPONSE: {
+        readonly id: 130;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OFF";
+        }, {
+            readonly value: 49;
+            readonly alias: "HOST";
+        }, {
+            readonly value: 50;
+            readonly alias: "AUX";
+        }, {
+            readonly value: 51;
+            readonly alias: "BOTH";
+        }];
+    };
+    /** 네트워크 통신 모드 */
+    readonly NETWORK_MODE: {
+        readonly id: 131;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "SINGLE";
+        }, {
+            readonly value: 49;
+            readonly alias: "NETWORK";
+        }];
+    };
+    /** 유휴 상태 자동 스캔 */
+    readonly FREE_SCAN: {
+        readonly id: 132;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OFF";
+        }, {
+            readonly value: 50;
+            readonly alias: "ON";
+        }];
+    };
+    /** 임시 등록 모드 */
+    readonly PROVISIONAL_ENROLL: {
+        readonly id: 133;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "PERMANENT";
+        }, {
+            readonly value: 49;
+            readonly alias: "TEMPORARY";
+        }];
+    };
+    /** DB 비어있을 때 인증 결과 */
+    readonly PASS_WHEN_EMPTY: {
+        readonly id: 134;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "FAIL";
+        }, {
+            readonly value: 49;
+            readonly alias: "PASS";
+        }];
+    };
+    /** 응답 딜레이 */
+    readonly RESPONSE_DELAY: {
+        readonly id: 135;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "NONE";
+        }, {
+            readonly value: 49;
+            readonly alias: "20MS";
+        }, {
+            readonly value: 50;
+            readonly alias: "40MS";
+        }, {
+            readonly value: 51;
+            readonly alias: "60MS";
+        }, {
+            readonly value: 52;
+            readonly alias: "80MS";
+        }, {
+            readonly value: 53;
+            readonly alias: "100MS";
+        }, {
+            readonly value: 58;
+            readonly alias: "200MS";
+        }];
+    };
+    /** 매칭 타임아웃 */
+    readonly MATCHING_TIMEOUT: {
+        readonly id: 136;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "INFINITE";
+        }, {
+            readonly value: 49;
+            readonly alias: "1S";
+        }, {
+            readonly value: 51;
+            readonly alias: "3S";
+        }, {
+            readonly value: 53;
+            readonly alias: "5S";
+        }, {
+            readonly value: 58;
+            readonly alias: "10S";
+        }, {
+            readonly value: 68;
+            readonly alias: "20S";
+        }];
+    };
+    /** 빌드 넘버 */
+    readonly BUILD_NUMBER: {
+        readonly id: 137;
+    };
+    /** 등록 시 지문 이동 거리 */
+    readonly ENROLL_DISPLACEMENT: {
+        readonly id: 138;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "NONE";
+        }, {
+            readonly value: 49;
+            readonly alias: "1MM";
+        }, {
+            readonly value: 51;
+            readonly alias: "3MM";
+        }, {
+            readonly value: 53;
+            readonly alias: "5MM";
+        }, {
+            readonly value: 58;
+            readonly alias: "10MM";
+        }];
+    };
+    /** 조명 환경 */
+    readonly LIGHTING_CONDITION: {
+        readonly id: 144;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OUTDOOR";
+        }, {
+            readonly value: 49;
+            readonly alias: "INDOOR";
+        }];
+    };
+    /** Free Scan 연속 인식 딜레이 */
+    readonly FREE_SCAN_DELAY: {
+        readonly id: 145;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "NONE";
+        }, {
+            readonly value: 49;
+            readonly alias: "1S";
+        }, {
+            readonly value: 50;
+            readonly alias: "2S";
+        }, {
+            readonly value: 51;
+            readonly alias: "3S";
+        }, {
+            readonly value: 53;
+            readonly alias: "5S";
+        }, {
+            readonly value: 58;
+            readonly alias: "10S";
+        }];
+    };
+    /** 1:N 매칭 속도 향상 */
+    readonly FAST_MODE: {
+        readonly id: 147;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OFF";
+        }, {
+            readonly value: 49;
+            readonly alias: "LV1";
+        }, {
+            readonly value: 50;
+            readonly alias: "LV2";
+        }, {
+            readonly value: 51;
+            readonly alias: "LV3";
+        }, {
+            readonly value: 52;
+            readonly alias: "LV4";
+        }, {
+            readonly value: 53;
+            readonly alias: "FASTEST";
+        }, {
+            readonly value: 54;
+            readonly alias: "AUTO";
+        }];
+    };
+    /** 워치독 타이머 */
+    readonly WATCHDOG: {
+        readonly id: 148;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OFF";
+        }, {
+            readonly value: 49;
+            readonly alias: "ON";
+        }];
+    };
+    /** 템플릿 타입 */
+    readonly TEMPLATE_TYPE: {
+        readonly id: 150;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "SUPREMA";
+        }, {
+            readonly value: 49;
+            readonly alias: "ISO";
+        }, {
+            readonly value: 50;
+            readonly alias: "ANSI";
+        }];
+    };
+    /** 개인정보 보호 모드 */
+    readonly ENHANCED_PRIVACY: {
+        readonly id: 151;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OFF";
+        }, {
+            readonly value: 49;
+            readonly alias: "ON";
+        }];
+    };
+    /** 위조 지문 감지 */
+    readonly FAKE_FINGER_DETECTION: {
+        readonly id: 152;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "OFF";
+        }, {
+            readonly value: 49;
+            readonly alias: "WEAK";
+        }, {
+            readonly value: 50;
+            readonly alias: "NORMAL";
+        }, {
+            readonly value: 51;
+            readonly alias: "STRONG";
+        }];
+    };
+    /** 잔류 지문 감지 */
+    readonly CHECK_LATENT_FINGERPRINT: {
+        readonly id: 154;
+        readonly options: readonly [{
+            readonly value: 48;
+            readonly alias: "ENROLL_ONLY";
+        }, {
+            readonly value: 49;
+            readonly alias: "NEVER";
+        }, {
+            readonly value: 50;
+            readonly alias: "ALWAYS";
+        }];
+    };
+    /** 전압 경고 임계값 */
+    readonly VOLTAGE_WARNING: {
+        readonly id: 155;
+    };
+    /** 자동 전원 차단 타임아웃 */
+    readonly POWER_OFF: {
+        readonly id: 156;
+    };
+};
+export type SfmParamKey = keyof typeof SFM_PARAM;
+type ExtractAliases<T> = T extends {
+    readonly options: readonly {
+        readonly alias: infer A;
+    }[];
+} ? A : never;
+type HasOptions = {
+    [K in SfmParamKey]: ExtractAliases<(typeof SFM_PARAM)[K]> extends never ? never : K;
+}[SfmParamKey];
+export type SfmParamAliasMap = {
+    [K in HasOptions]: ExtractAliases<(typeof SFM_PARAM)[K]>;
+};
+/** alias 문자열 → hex value 변환 */
+export declare function resolveParamAlias<K extends keyof SfmParamAliasMap>(key: K, alias: SfmParamAliasMap[K]): number;
+export declare const FIRMWARE_MAGIC = 523190095;
+export {};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/constants/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/constants/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,SAAS;;;;;;;;;;;;CAYZ,CAAC;AAIX,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAIX,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAab,CAAC;AAIX,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDV,CAAC;AAIX,eAAO,MAAM,SAAS;IACpB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAef,aAAa;;;;IAEb,YAAY;;;;;;;;;;;;;;IASZ,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;IAalB,aAAa;;;;;;;;;;;IAQb,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;IAaZ,gBAAgB;;;;;;;;;;;;;;;;;IAUhB,YAAY;;;;IAEZ,aAAa;;;;IAEb,aAAa;;;;IAEb,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcZ,eAAe;;;;IAEf,eAAe;;;;IAEf,kBAAkB;;;;IAElB,yBAAyB;;;;;;;;;;;IAQzB,eAAe;;;;;;;;;;;IAQf,gBAAgB;;;;;;;;;;;IAQhB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;IAYlB,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAcZ,gBAAgB;;;;;;;;;;;;;;;;;IAUhB,0BAA0B;;;;;;;;;;;;;;;;;IAU1B,iBAAiB;;;;;;;;;;;IAQjB,kBAAkB;;;;;;;;;;;IAQlB,eAAe;;;;;;;;;;;IAQf,sBAAsB;;;;;;;;;;;IAQtB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;IAab,cAAc;;;;;;;;;;;;;;;;;;;;;;;IAYd,YAAY;;;;IAEZ,oBAAoB;;;;;;;;;;;;;;;;;;;;IAWpB,YAAY;;;;;;;;;;;IAQZ,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;IAY1B,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;IAanB,cAAc;;;;;;;;;;;IAQd,aAAa;;;;;;;;;;;;;;IASb,iBAAiB;;;;;;;;;;;IAQjB,eAAe;;;;;;;;;;;;;;;;;IAUf,eAAe;;;;;;;;;;;;;;IASf,gBAAgB;;;;IAEhB,oBAAoB;;;;CAEZ,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAIjD,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;KAAE,EAAE,CAAC;CAC1D,GACG,CAAC,GACD,KAAK,CAAC;AAEV,KAAK,UAAU,GAAG;KACf,CAAC,IAAI,WAAW,GAAG,cAAc,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GACnE,KAAK,GACL,CAAC;CACN,CAAC,WAAW,CAAC,CAAC;AAEf,MAAM,MAAM,gBAAgB,GAAG;KAC5B,CAAC,IAAI,UAAU,GAAG,cAAc,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;CACzD,CAAC;AAEF,+BAA+B;AAC/B,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAChE,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GACzB,MAAM,CAWR;AAID,eAAO,MAAM,cAAc,YAAa,CAAC"}