@samlab-corp/sfm-node 0.2.0 → 0.3.0

package/dist/commands/fingerprint.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Fingerprint enroll/verify/identify/capture commands
+ * 지문 등록/검증/식별/캡처 명령
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FingerprintCommands = void 0;
@@ -11,12 +11,12 @@ class FingerprintCommands {
         this.client = client;
         this.system = null;
     }
-    /** @internal Set SystemCommands reference */
+    /** @internal SystemCommands 참조 설정 */
     _setSystemCommands(system) {
         this.system = system;
     }
     /**
-     * Enroll scan 1 - send ES command + read 0x62 (scan success) + 0x61 (template 1 saved)
+     * 등록 스캔 1 - ES 명령 전송 + 0x62 (스캔 성공) + 0x61 (템플릿 1 저장) 수신
      */
     async enrollScan1(userId, flag = index_js_1.SFM_FLAG.NONE, { onLog } = {}) {
         if (userId == null) {
@@ -25,9 +25,9 @@ class FingerprintCommands {
         const log = (msg) => {
             onLog?.(msg);
         };
-        log(`[ENROLL] Scan 1 started - userId: ${userId}`);
+        log(`[ENROLL] 스캔 1 시작 - userId: ${userId}`);
         const response = await this.client.sendCommand(index_js_1.SFM_CMD.ES, userId, 0, flag);
-        log(`[ENROLL] Response: flag=0x${response.flag?.toString(16)}, param=${response.param}, valid=${response.valid}`);
+        log(`[ENROLL] 응답: flag=0x${response.flag?.toString(16)}, param=${response.param}, valid=${response.valid}`);
         if (!response.valid) {
             return { success: false, step: 1, error: response.error || "unknown error" };
         }
@@ -35,33 +35,33 @@ class FingerprintCommands {
             return {
                 success: false,
                 step: 1,
-                error: `Scan 1 failed: 0x${response.flag?.toString(16) ?? "??"}`,
+                error: `스캔 1 실패: 0x${response.flag?.toString(16) ?? "??"}`,
             };
         }
-        log(`[ENROLL] Scan 1 success (0x62), waiting for template save...`);
+        log(`[ENROLL] 스캔 1 성공 (0x62), 템플릿 저장 대기 중...`);
         const saveResponse = await this.client.receiveResponse(this.client.commandTimeout);
-        log(`[ENROLL] Save 1 response: flag=0x${saveResponse.flag?.toString(16)}, valid=${saveResponse.valid}`);
+        log(`[ENROLL] 저장 1 응답: flag=0x${saveResponse.flag?.toString(16)}, valid=${saveResponse.valid}`);
         if (!saveResponse.valid || saveResponse.flag !== index_js_1.SFM_ERROR.SUCCESS) {
             return {
                 success: false,
                 step: 1,
                 error: saveResponse.error ||
-                    `Save 1 failed: 0x${saveResponse.flag?.toString(16)}`,
+                    `저장 1 실패: 0x${saveResponse.flag?.toString(16)}`,
             };
         }
-        log(`[ENROLL] Template 1 saved`);
+        log(`[ENROLL] 템플릿 1 저장 완료`);
         return { success: true, step: 1, userId: saveResponse.param ?? 0 };
     }
     /**
-     * Enroll scan 2 - read 0x62 (scan success) + 0x61 (template 2 saved)
+     * 등록 스캔 2 - 0x62 (스캔 성공) + 0x61 (템플릿 2 저장) 수신
      */
     async enrollScan2({ onLog } = {}) {
         const log = (msg) => {
             onLog?.(msg);
         };
-        log(`[ENROLL] Waiting for scan 2...`);
+        log(`[ENROLL] 스캔 2 대기 중...`);
         const scanResponse = await this.client.receiveResponse(this.client.commandTimeout);
-        log(`[ENROLL] Scan 2 response: flag=0x${scanResponse.flag?.toString(16)}, valid=${scanResponse.valid}`);
+        log(`[ENROLL] 스캔 2 응답: flag=0x${scanResponse.flag?.toString(16)}, valid=${scanResponse.valid}`);
         if (!scanResponse.valid) {
             return { success: false, step: 2, error: scanResponse.error || "unknown error" };
         }
@@ -69,35 +69,35 @@ class FingerprintCommands {
             return {
                 success: false,
                 step: 2,
-                error: `Scan 2 failed: 0x${scanResponse.flag?.toString(16) ?? "??"}`,
+                error: `스캔 2 실패: 0x${scanResponse.flag?.toString(16) ?? "??"}`,
             };
         }
-        log(`[ENROLL] Scan 2 success (0x62), waiting for template save...`);
+        log(`[ENROLL] 스캔 2 성공 (0x62), 템플릿 저장 대기 중...`);
         const saveResponse = await this.client.receiveResponse(this.client.commandTimeout);
-        log(`[ENROLL] Save 2 response: flag=0x${saveResponse.flag?.toString(16)}, valid=${saveResponse.valid}`);
+        log(`[ENROLL] 저장 2 응답: flag=0x${saveResponse.flag?.toString(16)}, valid=${saveResponse.valid}`);
         if (!saveResponse.valid || saveResponse.flag !== index_js_1.SFM_ERROR.SUCCESS) {
             return {
                 success: false,
                 step: 2,
                 error: saveResponse.error ||
-                    `Save 2 failed: 0x${saveResponse.flag?.toString(16)}`,
+                    `저장 2 실패: 0x${saveResponse.flag?.toString(16)}`,
             };
         }
-        log(`[ENROLL] Template 2 saved - enrollment complete`);
+        log(`[ENROLL] 템플릿 2 저장 완료 - 등록 완료`);
         return { success: true, step: 2, userId: saveResponse.param ?? 0 };
     }
     /**
-     * Enroll (automatically adapts to current ENROLL_MODE setting)
+     * 등록 (현재 ENROLL_MODE 설정에 자동 적응)
      *
-     * - SCAN1 (0x30): 1 scan only
-     * - SCAN2_MERGE (0x31) / SCAN2_DUAL (0x41): scan 1 + scan 2
+     * - SCAN1 (0x30): 1회 스캔만
+     * - SCAN2_MERGE (0x31) / SCAN2_DUAL (0x41): 스캔 1 + 스캔 2
      */
     async enroll(userId, flag = index_js_1.SFM_FLAG.NONE, { onLog } = {}) {
         const log = (msg) => {
             onLog?.(msg);
         };
-        // Read current ENROLL_MODE from device
-        let enrollMode = 0x31; // default: SCAN2_MERGE
+        // 디바이스에서 현재 ENROLL_MODE 읽기
+        let enrollMode = 0x31; // 기본값: SCAN2_MERGE
         if (this.system) {
             const param = await this.system.getParam("ENROLL_MODE");
             if (!param.error && param.value != null) {
@@ -108,12 +108,12 @@ class FingerprintCommands {
         const result1 = await this.enrollScan1(userId, flag, { onLog });
         if (!result1.success)
             return result1;
-        // SCAN1 mode: single scan is enough
+        // SCAN1 모드: 1회 스캔으로 충분
         if (enrollMode === 0x30) {
-            log("[ENROLL] SCAN1 mode — enrollment complete");
+            log("[ENROLL] SCAN1 모드 — 등록 완료");
             return result1;
         }
-        // SCAN2_MERGE / SCAN2_DUAL: need second scan
+        // SCAN2_MERGE / SCAN2_DUAL: 2차 스캔 필요
         return this.enrollScan2({ onLog });
     }
     /**
@@ -126,19 +126,19 @@ class FingerprintCommands {
         const log = (msg) => {
             onLog?.(msg);
         };
-        log(`[VERIFY] 1:1 verification started - userId: ${userId}`);
+        log(`[VERIFY] 1:1 검증 시작 - userId: ${userId}`);
         const response = await this.client.sendCommand(index_js_1.SFM_CMD.VS, userId, 0, 0);
-        log(`[VERIFY] Response: flag=0x${response.flag?.toString(16)}, param=${response.param}, valid=${response.valid}`);
+        log(`[VERIFY] 응답: flag=0x${response.flag?.toString(16)}, param=${response.param}, valid=${response.valid}`);
         if (!response.valid) {
             return { success: false, error: response.error || "unknown error" };
         }
         let lastResponse = response;
         let scanCount = 1;
         while (lastResponse.flag === index_js_1.SFM_ERROR.SCAN_SUCCESS) {
-            log(`[VERIFY] Scan #${scanCount} success (0x62), waiting for match...`);
+            log(`[VERIFY] 스캔 #${scanCount} 성공 (0x62), 매칭 대기 중...`);
             lastResponse = await this.client.receiveResponse(this.client.commandTimeout);
             scanCount++;
-            log(`[VERIFY] Response #${scanCount}: flag=0x${lastResponse.flag?.toString(16)}, param=${lastResponse.param}, valid=${lastResponse.valid}`);
+            log(`[VERIFY] 응답 #${scanCount}: flag=0x${lastResponse.flag?.toString(16)}, param=${lastResponse.param}, valid=${lastResponse.valid}`);
             if (!lastResponse.valid) {
                 return { success: false, error: lastResponse.error || "unknown error" };
             }
@@ -147,7 +147,7 @@ class FingerprintCommands {
             success: lastResponse.flag === index_js_1.SFM_ERROR.SUCCESS,
             userId: lastResponse.param,
             error: lastResponse.flag !== index_js_1.SFM_ERROR.SUCCESS
-                ? `Verification failed: 0x${lastResponse.flag?.toString(16) ?? "??"}`
+                ? `검증 실패: 0x${lastResponse.flag?.toString(16) ?? "??"}`
                 : null,
         };
     }
@@ -158,19 +158,19 @@ class FingerprintCommands {
         const log = (msg) => {
             onLog?.(msg);
         };
-        log(`[IDENTIFY] 1:N identification started`);
+        log(`[IDENTIFY] 1:N 식별 시작`);
         const response = await this.client.sendCommand(index_js_1.SFM_CMD.IS, 0, 0, 0);
-        log(`[IDENTIFY] Response: flag=0x${response.flag?.toString(16)}, param=${response.param}, valid=${response.valid}`);
+        log(`[IDENTIFY] 응답: flag=0x${response.flag?.toString(16)}, param=${response.param}, valid=${response.valid}`);
         if (!response.valid) {
             return { success: false, userId: 0, error: response.error || "unknown error" };
         }
         let lastResponse = response;
         let scanCount = 1;
         while (lastResponse.flag === index_js_1.SFM_ERROR.SCAN_SUCCESS) {
-            log(`[IDENTIFY] Scan #${scanCount} success (0x62), waiting for match...`);
+            log(`[IDENTIFY] 스캔 #${scanCount} 성공 (0x62), 매칭 대기 중...`);
             lastResponse = await this.client.receiveResponse(this.client.commandTimeout);
             scanCount++;
-            log(`[IDENTIFY] Response #${scanCount}: flag=0x${lastResponse.flag?.toString(16)}, param=${lastResponse.param}, valid=${lastResponse.valid}`);
+            log(`[IDENTIFY] 응답 #${scanCount}: flag=0x${lastResponse.flag?.toString(16)}, param=${lastResponse.param}, valid=${lastResponse.valid}`);
             if (!lastResponse.valid) {
                 return { success: false, userId: 0, error: lastResponse.error || "unknown error" };
             }
@@ -179,12 +179,12 @@ class FingerprintCommands {
             success: lastResponse.flag === index_js_1.SFM_ERROR.SUCCESS,
             userId: lastResponse.param ?? 0,
             error: lastResponse.flag !== index_js_1.SFM_ERROR.SUCCESS
-                ? `Identification failed: 0x${lastResponse.flag?.toString(16) ?? "??"}`
+                ? `식별 실패: 0x${lastResponse.flag?.toString(16) ?? "??"}`
                 : null,
         };
     }
     /**
-     * Delete specific template (DT: 0x16)
+     * 특정 템플릿 삭제 (DT: 0x16)
      */
     async deleteTemplate(userId) {
         if (userId == null) {
@@ -197,12 +197,12 @@ class FingerprintCommands {
         return {
             success: response.flag === index_js_1.SFM_ERROR.SUCCESS,
             error: response.flag !== index_js_1.SFM_ERROR.SUCCESS
-                ? `Delete failed: 0x${response.flag?.toString(16) ?? "??"}`
+                ? `삭제 실패: 0x${response.flag?.toString(16) ?? "??"}`
                 : null,
         };
     }
     /**
-     * Delete all templates (DA: 0x17)
+     * 전체 템플릿 삭제 (DA: 0x17)
      */
     async deleteAllTemplates() {
         const response = await this.client.sendCommand(index_js_1.SFM_CMD.DA, 0, 0, 0);
@@ -211,17 +211,17 @@ class FingerprintCommands {
         }
         return {
             success: response.flag === index_js_1.SFM_ERROR.SUCCESS,
-            error: response.flag !== index_js_1.SFM_ERROR.SUCCESS ? "Delete all failed" : null,
+            error: response.flag !== index_js_1.SFM_ERROR.SUCCESS ? "전체 삭제 실패" : null,
         };
     }
     /**
-     * List enrolled user IDs (LT: 0x18)
+     * 등록된 사용자 ID 목록 조회 (LT: 0x18)
      */
     async listUserIds({ onLog } = {}) {
         const log = (msg) => {
             onLog?.(msg);
         };
-        log("[LIST] Fetching user ID list");
+        log("[LIST] 사용자 ID 목록 조회 중");
         const response = await this.client.sendCommand(index_js_1.SFM_CMD.LT, 0, 0, 0);
         if (!response.valid) {
             return { success: false, userIds: [], count: 0, error: response.error || "unknown error" };
@@ -231,36 +231,36 @@ class FingerprintCommands {
                 success: false,
                 userIds: [],
                 count: 0,
-                error: `List failed: 0x${response.flag?.toString(16) ?? "??"}`,
+                error: `목록 조회 실패: 0x${response.flag?.toString(16) ?? "??"}`,
             };
         }
         const count = response.param ?? 0;
         const dataSize = response.size ?? 0;
-        log(`[LIST] Enrolled users: ${count}, data size: ${dataSize}`);
+        log(`[LIST] 등록 사용자: ${count}, 데이터 크기: ${dataSize}`);
         if (count === 0 || dataSize === 0) {
             return { success: true, userIds: [], count: 0, error: null };
         }
         const rawData = await this.client.serial.read(dataSize, this.client.commandTimeout);
         if (rawData.length < dataSize) {
-            return { success: false, userIds: [], count: 0, error: `Incomplete data: received ${rawData.length}/${dataSize} bytes` };
+            return { success: false, userIds: [], count: 0, error: `불완전한 데이터: ${rawData.length}/${dataSize} 바이트 수신` };
         }
-        log(`[LIST] Raw data (hex): ${Buffer.from(rawData).toString("hex").match(/../g)?.join(" ") ?? ""}`);
+        log(`[LIST] 원시 데이터 (hex): ${Buffer.from(rawData).toString("hex").match(/../g)?.join(" ") ?? ""}`);
         const allIds = [];
         for (let i = 0; i + 4 <= rawData.length; i += 4) {
             allIds.push(rawData.readUInt32LE(i));
         }
         const userIds = [...new Set(allIds)];
-        log(`[LIST] Templates: ${count}, unique users: ${userIds.length}, IDs: [${userIds.join(", ")}]`);
+        log(`[LIST] 템플릿: ${count}, 고유 사용자: ${userIds.length}, ID: [${userIds.join(", ")}]`);
         return { success: true, userIds, count, error: null };
     }
     /**
-     * Read template from device (RTX: 0x89, ping-pong protocol)
+     * 디바이스에서 템플릿 읽기 (RTX: 0x89, 핑퐁 프로토콜)
      *
-     * RTX response Size field: (templateCount << 16) | templateSize
-     *   e.g. 131456 = 0x00020180 → count=2, size=384
+     * RTX 응답 Size 필드: (templateCount << 16) | templateSize
+     *   예: 131456 = 0x00020180 → count=2, size=384
      *
-     * Flow: send RTX → read 384B data → send ACK (RTX) → read 384B data → ...
-     * Device flag: 0x74 (CONTINUE) = more chunks, 0x61 (SUCCESS) = last chunk.
+     * 흐름: RTX 전송 → 384B 데이터 수신 → ACK (RTX) 전송 → 384B 데이터 수신 → ...
+     * 디바이스 flag: 0x74 (CONTINUE) = 추가 청크 있음, 0x61 (SUCCESS) = 마지막 청크.
      */
     async readTemplate(userId, { onLog } = {}) {
         if (userId == null) {
@@ -269,10 +269,10 @@ class FingerprintCommands {
         const log = (msg) => {
             onLog?.(msg);
         };
-        // Flag=0: read all templates for this userId
-        log(`[RTX] Reading template for userId: ${userId}`);
+        // Flag=0: 해당 userId의 모든 템플릿 읽기
+        log(`[RTX] userId: ${userId} 템플릿 읽기`);
         const response = await this.client.sendCommand(index_js_1.SFM_CMD.RTX, userId, 384, 0);
-        log(`[RTX] Response: flag=0x${response.flag?.toString(16)}, param=${response.param}, size=${response.size}, valid=${response.valid}`);
+        log(`[RTX] 응답: flag=0x${response.flag?.toString(16)}, param=${response.param}, size=${response.size}, valid=${response.valid}`);
         if (!response.valid) {
             return { success: false, templateData: null, error: response.error || "unknown error" };
         }
@@ -280,39 +280,39 @@ class FingerprintCommands {
             return {
                 success: false,
                 templateData: null,
-                error: `Read template failed: 0x${response.flag?.toString(16) ?? "??"}`,
+                error: `템플릿 읽기 실패: 0x${response.flag?.toString(16) ?? "??"}`,
             };
         }
-        // Parse RTX response size: (templateCount << 16) | templateSize
+        // RTX 응답 size 파싱: (templateCount << 16) | templateSize
         const rawSize = response.size ?? 0;
         const templateCount = (rawSize >>> 16) & 0xffff;
         const templateSize = rawSize & 0xffff;
         log(`[RTX] templateCount=${templateCount}, templateSize=${templateSize}B`);
         if (templateSize === 0) {
-            return { success: false, templateData: null, error: "No template data (size=0)" };
+            return { success: false, templateData: null, error: "템플릿 데이터 없음 (size=0)" };
         }
         const chunks = [];
         const MAX_TEMPLATE_CHUNKS = 100;
         const totalChunks = templateCount || 1;
         if (totalChunks > MAX_TEMPLATE_CHUNKS) {
-            return { success: false, templateData: null, error: `Unreasonable chunk count: ${totalChunks} (max ${MAX_TEMPLATE_CHUNKS})` };
+            return { success: false, templateData: null, error: `비정상적인 청크 수: ${totalChunks} (최대 ${MAX_TEMPLATE_CHUNKS})` };
         }
         for (let i = 0; i < totalChunks; i++) {
-            log(`[RTX] Receiving chunk ${i + 1}/${totalChunks}...`);
+            log(`[RTX] 청크 ${i + 1}/${totalChunks} 수신 중...`);
             const readTimeout = Math.max(this.client.commandTimeout, Math.ceil(templateSize / 100) + 5000);
-            // Extended Data Transfer Protocol:
-            // Data Packet Header(13B) + Data Body(templateSize) + Data Checksum(4B)
+            // 확장 데이터 전송 프로토콜:
+            // 데이터 패킷 헤더(13B) + 데이터 본문(templateSize) + 데이터 체크섬(4B)
             const dataPacketHeader = await this.client.serial.read(13, readTimeout);
-            log(`[RTX] Data packet header: ${Buffer.from(dataPacketHeader).toString("hex")}`);
+            log(`[RTX] 데이터 패킷 헤더: ${Buffer.from(dataPacketHeader).toString("hex")}`);
             const chunkData = await this.client.serial.read(templateSize, readTimeout);
             if (!chunkData || chunkData.length < templateSize) {
                 return {
                     success: false,
                     templateData: null,
-                    error: `Incomplete read: ${chunkData?.length ?? 0}/${templateSize}B`,
+                    error: `불완전한 읽기: ${chunkData?.length ?? 0}/${templateSize}B`,
                 };
             }
-            // Read and validate 4-byte checksum
+            // 4바이트 체크섬 읽기 및 검증
             const checksumData = await this.client.serial.read(4, readTimeout);
             const receivedChecksum = checksumData.readUInt32LE(0);
             let calculatedChecksum = 0;
@@ -320,30 +320,30 @@ class FingerprintCommands {
                 calculatedChecksum += chunkData[j];
             }
             calculatedChecksum = calculatedChecksum >>> 0;
-            log(`[RTX] Chunk ${i + 1} received: ${chunkData.length}B, checksum: received=0x${receivedChecksum.toString(16)}, calculated=0x${calculatedChecksum.toString(16)}`);
+            log(`[RTX] 청크 ${i + 1} 수신: ${chunkData.length}B, 체크섬: received=0x${receivedChecksum.toString(16)}, calculated=0x${calculatedChecksum.toString(16)}`);
             if (receivedChecksum !== calculatedChecksum) {
                 return {
                     success: false,
                     templateData: null,
-                    error: `Checksum mismatch at chunk ${i + 1}: received=0x${receivedChecksum.toString(16)}, calculated=0x${calculatedChecksum.toString(16)}`,
+                    error: `청크 ${i + 1} 체크섬 불일치: received=0x${receivedChecksum.toString(16)}, calculated=0x${calculatedChecksum.toString(16)}`,
                 };
             }
             chunks.push(chunkData.subarray(0, templateSize));
-            // Send DATA_OK(0x83) ACK to trigger next data packet
+            // DATA_OK(0x83) ACK 전송하여 다음 데이터 패킷 트리거
             const DATA_OK = 0x83;
-            log(`[RTX] Sending DATA_OK ACK...`);
+            log(`[RTX] DATA_OK ACK 전송 중...`);
             const ackPacket = (0, packet_js_1.buildNormalPacket)(index_js_1.SFM_CMD.RTX, 0, 0, DATA_OK);
             await this.client._writePacket(ackPacket);
-            log(`[RTX] ACK sent: ${Buffer.from(ackPacket).toString("hex")}`);
+            log(`[RTX] ACK 전송: ${Buffer.from(ackPacket).toString("hex")}`);
         }
         const templateData = Buffer.concat(chunks);
-        log(`[RTX] Template received: ${templateData.length}B (${chunks.length} chunks)`);
+        log(`[RTX] 템플릿 수신 완료: ${templateData.length}B (${chunks.length}개 청크)`);
         return { success: true, templateData, error: null };
     }
     /**
-     * Write template to device (ET: 0x07 — Simple Template Enrollment)
+     * 디바이스에 템플릿 쓰기 (ET: 0x07 — 단순 템플릿 등록)
      *
-     * Kiosk 호환 프로토콜 (rs232/fingerPrinter.js enrollByTemplate):
+     * 키오스크 호환 프로토콜 (rs232/fingerPrinter.js enrollByTemplate):
      * 1. [Command Packet 13B] + [Template Data] + [END 0x0A] 를 한 번에 전송
      * 2. 디바이스로부터 2개 응답 수신 (스캔 처리 + 최종 결과)
      *
@@ -360,55 +360,55 @@ class FingerprintCommands {
         const CHUNK = 384;
         const totalSize = templateData.length;
         const chunkCount = Math.ceil(totalSize / CHUNK);
-        log(`[ET] Writing template for userId: ${userId}, totalSize: ${totalSize}B, chunks: ${chunkCount}`);
+        log(`[ET] userId: ${userId} 템플릿 쓰기, totalSize: ${totalSize}B, chunks: ${chunkCount}`);
         let lastResponseParam = userId;
         for (let i = 0; i < chunkCount; i++) {
             const offset = i * CHUNK;
             const currentChunkSize = Math.min(CHUNK, totalSize - offset);
             const chunkData = templateData.subarray(offset, offset + currentChunkSize);
-            log(`[ET] Sending chunk ${i + 1}/${chunkCount}: ${currentChunkSize}B`);
-            // Build command packet (13B)
+            log(`[ET] 청크 ${i + 1}/${chunkCount} 전송: ${currentChunkSize}B`);
+            // 명령 패킷 생성 (13B)
             const cmdPacket = (0, packet_js_1.buildNormalPacket)(index_js_1.SFM_CMD.ET, userId, currentChunkSize, flag);
             // ET 프로토콜: [Command 13B] + [Template Data] + [END 0x0A]
             const endByte = Buffer.from([0x0a]);
             const combined = Buffer.concat([cmdPacket, chunkData, endByte]);
-            log(`[ET] Packet: ${Buffer.from(combined).toString("hex")}`);
+            log(`[ET] 패킷: ${Buffer.from(combined).toString("hex")}`);
             await this.client.serial.write(combined);
             // ET는 2개 응답을 수신
             // 응답 1: 처리 중간 응답
             const response1 = await this.client.receiveResponse(this.client.commandTimeout);
-            log(`[ET] Response 1: flag=0x${response1.flag?.toString(16)}, param=${response1.param}, valid=${response1.valid}`);
+            log(`[ET] 응답 1: flag=0x${response1.flag?.toString(16)}, param=${response1.param}, valid=${response1.valid}`);
             if (!response1.valid) {
-                return { success: false, error: `ET chunk ${i + 1} response 1 invalid: ${response1.error}` };
+                return { success: false, error: `ET 청크 ${i + 1} 응답 1 무효: ${response1.error}` };
             }
             // 응답 2: 최종 결과
             const response2 = await this.client.receiveResponse(this.client.commandTimeout);
-            log(`[ET] Response 2: flag=0x${response2.flag?.toString(16)}, param=${response2.param}, valid=${response2.valid}`);
+            log(`[ET] 응답 2: flag=0x${response2.flag?.toString(16)}, param=${response2.param}, valid=${response2.valid}`);
             if (!response2.valid) {
-                return { success: false, error: `ET chunk ${i + 1} response 2 invalid: ${response2.error}` };
+                return { success: false, error: `ET 청크 ${i + 1} 응답 2 무효: ${response2.error}` };
             }
             if (response2.flag !== index_js_1.SFM_ERROR.SUCCESS) {
                 return {
                     success: false,
-                    error: `ET chunk ${i + 1} failed: 0x${response2.flag?.toString(16) ?? "??"}`,
+                    error: `ET 청크 ${i + 1} 실패: 0x${response2.flag?.toString(16) ?? "??"}`,
                 };
             }
             lastResponseParam = response2.param ?? userId;
-            log(`[ET] Chunk ${i + 1}/${chunkCount} enrolled successfully`);
+            log(`[ET] 청크 ${i + 1}/${chunkCount} 등록 성공`);
         }
-        log(`[ET] Template written successfully (${chunkCount} chunks, ${totalSize}B)`);
+        log(`[ET] 템플릿 쓰기 성공 (${chunkCount}개 청크, ${totalSize}B)`);
         return { success: true, userId: lastResponseParam, error: null };
     }
     /**
-     * Write template to device (ETX: 0x87 — Extended Template Enrollment)
+     * 디바이스에 템플릿 쓰기 (ETX: 0x87 — 확장 템플릿 등록)
      *
-     * Extended Data Transfer Protocol (Appendix B):
-     * Supports multi-chunk: 768B → 2 chunks of 384B sent in one ETX session.
+     * 확장 데이터 전송 프로토콜 (Appendix B):
+     * 멀티 청크 지원: 768B → 384B 2개 청크를 하나의 ETX 세션에서 전송.
      *
      * 1. sendCommand(ETX, userId, sizeField, flag) → SUCCESS(0x61)
      *    sizeField: (templateCount << 24) | (enrollCount << 16) | chunkSize
-     * 2. For each chunk:
-     *    Data Packet Header(13B) + Data Body(384B) + Data Checksum(4B)
+     * 2. 각 청크별:
+     *    데이터 패킷 헤더(13B) + 데이터 본문(384B) + 데이터 체크섬(4B)
      *    → DATA_OK(0x83) 응답 수신
      */
     async writeTemplateMulti(userId, templateData, flag = index_js_1.SFM_FLAG.NONE, { onLog } = {}) {
@@ -423,34 +423,34 @@ class FingerprintCommands {
         const templateCount = Math.ceil(totalSize / CHUNK);
         const chunkSize = Math.min(totalSize, CHUNK);
         if (templateCount > 255) {
-            return { success: false, error: `Template too large: ${templateCount} chunks exceeds 255 max` };
+            return { success: false, error: `템플릿이 너무 큼: ${templateCount}개 청크가 최대 255 초과` };
         }
         // ETX Size: (templateCount << 24) | (enrollCount << 16) | chunkSize
         // enrollCount=1: 각 템플릿을 1번씩만 저장
         const sizeField = (templateCount << 24) | (1 << 16) | chunkSize;
-        log(`[ETX] Writing template for userId: ${userId}, totalSize: ${totalSize}B, chunks: ${templateCount}, sizeField=0x${sizeField.toString(16)}`);
-        // Step 1: ETX 명령 패킷 전송 + SUCCESS(0x61) 응답 대기
+        log(`[ETX] userId: ${userId} 템플릿 쓰기, totalSize: ${totalSize}B, chunks: ${templateCount}, sizeField=0x${sizeField.toString(16)}`);
+        // 1단계: ETX 명령 패킷 전송 + SUCCESS(0x61) 응답 대기
         const cmdResponse = await this.client.sendCommand(index_js_1.SFM_CMD.ETX, userId, sizeField, flag);
-        log(`[ETX] Command response: flag=0x${cmdResponse.flag?.toString(16)}, param=${cmdResponse.param}, valid=${cmdResponse.valid}`);
+        log(`[ETX] 명령 응답: flag=0x${cmdResponse.flag?.toString(16)}, param=${cmdResponse.param}, valid=${cmdResponse.valid}`);
         if (!cmdResponse.valid) {
             return { success: false, error: cmdResponse.error || "unknown error" };
         }
         if (cmdResponse.flag !== index_js_1.SFM_ERROR.SUCCESS) {
             return {
                 success: false,
-                error: `ETX command failed: 0x${cmdResponse.flag?.toString(16) ?? "??"}`,
+                error: `ETX 명령 실패: 0x${cmdResponse.flag?.toString(16) ?? "??"}`,
             };
         }
-        // Step 2: Send each chunk with Extended Data Transfer Protocol
+        // 2단계: 확장 데이터 전송 프로토콜로 각 청크 전송
         const DATA_OK = 0x83;
         for (let i = 0; i < templateCount; i++) {
             const offset = i * CHUNK;
             const currentChunkSize = Math.min(CHUNK, totalSize - offset);
             const chunkData = templateData.subarray(offset, offset + currentChunkSize);
-            // Data Packet Header param: (totalPackets & 0xFFFF) | ((packetIndex & 0xFFFF) << 16)
+            // 데이터 패킷 헤더 param: (totalPackets & 0xFFFF) | ((packetIndex & 0xFFFF) << 16)
             const dataPacketParam = (templateCount & 0xFFFF) | ((i & 0xFFFF) << 16);
             const dataHeader = (0, packet_js_1.buildNormalPacket)(index_js_1.SFM_CMD.ETX, dataPacketParam, currentChunkSize, 0);
-            // Data Checksum: full byte sum (NOT & 0xFF)
+            // 데이터 체크섬: 전체 바이트 합 (& 0xFF 아님)
             let checksum = 0;
             for (let j = 0; j < currentChunkSize; j++) {
                 checksum += chunkData[j];
@@ -458,35 +458,35 @@ class FingerprintCommands {
             const checksumBuf = Buffer.alloc(4);
             checksumBuf.writeUInt32LE(checksum >>> 0, 0);
             const combined = Buffer.concat([dataHeader, chunkData, checksumBuf]);
-            log(`[ETX] Sending chunk ${i + 1}/${templateCount}: ${combined.length}B (header:13 + data:${currentChunkSize} + checksum:4, checksum=${checksum})`);
+            log(`[ETX] 청크 ${i + 1}/${templateCount} 전송: ${combined.length}B (header:13 + data:${currentChunkSize} + checksum:4, checksum=${checksum})`);
             await this.client.serial.write(combined);
-            // Wait for DATA_OK(0x83) response
+            // DATA_OK(0x83) 응답 대기
             const ackResponse = await this.client.receiveResponse(this.client.commandTimeout);
-            log(`[ETX] Chunk ${i + 1} ACK: flag=0x${ackResponse.flag?.toString(16)}, param=${ackResponse.param}, valid=${ackResponse.valid}`);
+            log(`[ETX] 청크 ${i + 1} ACK: flag=0x${ackResponse.flag?.toString(16)}, param=${ackResponse.param}, valid=${ackResponse.valid}`);
             if (!ackResponse.valid) {
-                return { success: false, error: `Chunk ${i + 1} ACK invalid: ${ackResponse.error}` };
+                return { success: false, error: `청크 ${i + 1} ACK 무효: ${ackResponse.error}` };
             }
             if (ackResponse.flag !== index_js_1.SFM_ERROR.SUCCESS && ackResponse.flag !== DATA_OK) {
                 return {
                     success: false,
-                    error: `ETX chunk ${i + 1} failed: 0x${ackResponse.flag?.toString(16) ?? "??"}`,
+                    error: `ETX 청크 ${i + 1} 실패: 0x${ackResponse.flag?.toString(16) ?? "??"}`,
                 };
             }
         }
-        log(`[ETX] Template written successfully (${templateCount} chunks, ${totalSize}B)`);
-        // Drain residual responses from device (e.g. SCAN_SUCCESS after write)
+        log(`[ETX] 템플릿 쓰기 성공 (${templateCount}개 청크, ${totalSize}B)`);
+        // 디바이스의 잔여 응답 소진 (예: 쓰기 후 SCAN_SUCCESS)
         await new Promise((r) => setTimeout(r, 100));
         await this.client.serial.purgeRX();
         return { success: true, userId: cmdResponse.param, error: null };
     }
     /**
-     * Capture fingerprint image (SI: 0x15)
+     * 지문 이미지 캡처 (SI: 0x15)
      */
     async captureImage({ onLog } = {}) {
         const log = (msg) => {
             onLog?.(msg);
         };
-        log("[CAPTURE] Fingerprint scan started (SI: 0x15)");
+        log("[CAPTURE] 지문 스캔 시작 (SI: 0x15)");
         const siResponse = await this.client.sendCommand(index_js_1.SFM_CMD.SI, 0, 0, 0);
         log(`[CAPTURE] SI 응답: flag=0x${siResponse.flag?.toString(16)}, param=${siResponse.param}, size=${siResponse.size}, valid=${siResponse.valid}`);
         if (!siResponse.valid) {
@@ -500,9 +500,9 @@ class FingerprintCommands {
         }
         let lastResponse = siResponse;
         while (lastResponse.flag === index_js_1.SFM_ERROR.SCAN_SUCCESS) {
-            log("[CAPTURE] Scan success (0x62), waiting for next response...");
+            log("[CAPTURE] 스캔 성공 (0x62), 다음 응답 대기 중...");
             lastResponse = await this.client.receiveResponse(this.client.commandTimeout);
-            log(`[CAPTURE] Response: flag=0x${lastResponse.flag?.toString(16)}, param=${lastResponse.param}, size=${lastResponse.size}, valid=${lastResponse.valid}`);
+            log(`[CAPTURE] 응답: flag=0x${lastResponse.flag?.toString(16)}, param=${lastResponse.param}, size=${lastResponse.size}, valid=${lastResponse.valid}`);
             if (!lastResponse.valid) {
                 return {
                     success: false,
@@ -519,7 +519,7 @@ class FingerprintCommands {
                 imageData: null,
                 width: 0,
                 height: 0,
-                error: `Scan failed: 0x${lastResponse.flag?.toString(16) ?? "??"}`,
+                error: `스캔 실패: 0x${lastResponse.flag?.toString(16) ?? "??"}`,
             };
         }
         const imageSize = lastResponse.size ?? 0;
@@ -530,10 +530,10 @@ class FingerprintCommands {
                 imageData: null,
                 width: 0,
                 height: 0,
-                error: "No image data (size=0)",
+                error: "이미지 데이터 없음 (size=0)",
             };
         }
-        log(`[CAPTURE] Receiving image data: ${imageSize}B`);
+        log(`[CAPTURE] 이미지 데이터 수신: ${imageSize}B`);
         const readTimeout = Math.max(this.client.commandTimeout, Math.ceil(imageSize / 100) + 5000);
         const imageData = await this.client.serial.read(imageSize, readTimeout);
         if (!imageData || imageData.length < imageSize) {
@@ -542,10 +542,10 @@ class FingerprintCommands {
                 imageData: null,
                 width: 0,
                 height: 0,
-                error: `Incomplete read: ${imageData?.length ?? 0}/${imageSize}B`,
+                error: `불완전한 읽기: ${imageData?.length ?? 0}/${imageSize}B`,
             };
         }
-        log(`[CAPTURE] Image received: ${imageData.length}B`);
+        log(`[CAPTURE] 이미지 수신 완료: ${imageData.length}B`);
         const sqrt = Math.sqrt(imageSize);
         let width, height;
         if (Number.isInteger(sqrt)) {
@@ -576,7 +576,7 @@ class FingerprintCommands {
                 }
             }
         }
-        log(`[CAPTURE] Image resolution: ${width}x${height} (${width * height} vs ${imageSize})`);
+        log(`[CAPTURE] 이미지 해상도: ${width}x${height} (${width * height} vs ${imageSize})`);
         return { success: true, imageData, width, height, error: null };
     }
 }