การแก้ปัญหาตัวเข้ารหัสคีย์การ์ด
ตรวจเครือข่ายและไฟก่อน จากนั้นลองเข้ารหัสการ์ดใบเดียวอีกครั้ง ใช้เวลาประมาณ 2 นาที
คู่มือนี้ช่วยให้คุณแก้ปัญหาตัวเข้ารหัสคีย์การ์ดที่พบบ่อย
สรุปอย่างย่อ
| สิ่งที่เห็น | สาเหตุ | วิธีทำ |
|---|---|---|
| Encoder not responding | ปัญหาไฟหรือเครือข่าย | Check connectivity |
| Cards not encoding | ปัญหาการ์ดหรืออุปกรณ์ | Verify card and device |
| "UserCredentialsNotProvided.NotApplicable" | ข้อมูลรับรอง Saflok หายหรือไม่ครบ | Add Saflok credentials |
| Encoder type change does not stick | การบันทึกก่อนหน้าทำให้สถานะ encoder ปนกัน | Re-save encoder type |
| "Test Connection" fails (Be-Tech) | ปัญหา Base URL หรือบริการ | Fix Be-Tech connection |
| "Service URL is required" (LockSDK) | โหมด direct ต้องมี Service URL ต่อ encoder | Add LockSDK service URL |
| LockSDK agent shows Not registered | ยังไม่มี device agent สำหรับแต่ละ encoder | Register LockSDK agent |
| Heartbeat Monitor turns off after save | บันทึกไม่ติดใน session โรงแรมปัจจุบัน | Re-save Heartbeat Monitor |
| Heartbeat shows unreachable | agent ออฟไลน์หรือ tunnel มีปัญหา | Check agent status |
| Encoder stays unavailable | connected state เป็น false แม้ heartbeat ปกติ | Check live encoder status |
| Windows Agent shows Not connected | agent ไม่รันหรือ install ไม่สมบูรณ์ | Reconnect agent |
Encoder ไม่ตอบสนอง
สิ่งที่เห็น: encoder แสดงออฟไลน์หรือไม่มีการตอบสนองใน AVA
วิธีแก้:
- ตรวจไฟและสายของ encoder
- ตรวจการเชื่อมต่อเครือข่ายระหว่างคีออสก์กับ encoder (เฉพาะ Direct Connection)
- ยืนยันว่า IP และ port ของ server ถูกต้อง
- รีสตาร์ทซอฟต์แวร์ของ encoder
การ์ดไม่เข้ารหัส
สิ่งที่เห็น: การเขียนคีย์การ์ดล้มเหลว หรือได้การ์ดเปล่า
วิธีแก้:
- ยืนยันว่าชนิดการ์ดตรงกับ encoder
- ใส่การ์ดใหม่แล้วลองอีกครั้ง
- ทดสอบด้วยการ์ดเปล่าใบใหม่
- หาก Enable guest selection ปิดอยู่ ให้ยืนยันว่าคีออสก์ถูก route ไปยัง encoder ที่ถูกต้อง
- หาก Enable guest selection เปิดอยู่ ให้ยืนยันว่าผู้เข้าพักเลือก encoder ที่ออนไลน์อยู่ที่คีออสก์
ไม่ได้ใส่ Saflok credentials
สิ่งที่เห็น: "UserCredentialsNotProvided.NotApplicable" ปรากฏระหว่างการเข้ารหัสคีย์การ์ด
วิธีแก้:
- ไปที่ Settings → Room Access → Key Card Encoding (Kiosk)
- ตั้ง Encoder Type เป็น Saflok
- กรอก Username และ Password ใน Encoder Credentials
- หากเปิด direct communication ให้กรอก PMSI Server URL
- คลิก Save
- คลิก Test Connection แล้วลองเข้ารหัสการ์ดทดสอบ 1 ใบ
การเปลี่ยน encoder type ไม่ค้าง
สิ่งที่เห็น: คุณเลือก encoder type หนึ่ง แต่มี encoder อื่นยัง active อยู่
วิธีแก้:
- ไปที่ Settings → Room Access → Key Card Encoding (Kiosk)
- ใน Keycard Encoder Settings เลือก encoder type ที่ต้องการ
- คลิก Save เพียงครั้งเดียวแล้วรอข้อความสำเร็จ
- รีเฟรชหน้าและยืนยันว่า active อยู่แค่ encoder type นั้น
- หากปัญหาเกิดซ้ำ ให้สลับ type, บันทึก, แล้วสลับกลับและบันทึกอีกครั้ง
ทดสอบการเชื่อมต่อ Be-Tech ล้มเหลว
สิ่งที่เห็น: Test Connection ล้มเหลว หรือปุ่มยังถูกปิดใช้งาน
วิธีแก้:
- ยืนยันว่า Base URL เริ่มด้วย
http://หรือhttps:// - ตรวจว่าบริการ Be-Tech รันอยู่บนเครื่อง workstation ของ encoder
- ตรวจว่า workstation กับคีออสก์อยู่ในเครือข่ายเดียวกัน
- กรอก Hotel Name, Chain No, Workstation, และ Reader No ใหม่
- คลิก Test Connection อีกครั้ง
ต้องใช้ LockSDK Service URL
สิ่งที่เห็น: บันทึกถูกบล็อก หรือฟอร์ม encoder แสดง "Service URL is required."
วิธีแก้:
- ไปที่ Settings → Room Access → Key Card Encoding (Kiosk)
- เลือก LockSDK
- เปิด Physical Encoder Devices แล้วแก้ไข encoder
- กรอก Service URL ที่ถูกต้อง เช่น
http://127.0.0.1:8092 - คลิก Save แล้วรัน Test Connection
LockSDK agent ยังไม่ลงทะเบียน
สิ่งที่เห็น: การ์ด encoder ของ LockSDK แสดง Not registered ใน Windows Agent
วิธีแก้:
- ยืนยันว่ามี LockSDK encoder ใน Physical Encoder Devices
- ไปที่ Windows Agent แล้วหา card ของ encoder
- คลิก Download Windows Agent
- แตกไฟล์แพ็กเกจแล้วรันไฟล์
.batบนเครื่อง Windows ที่เชื่อมต่ออยู่ - รีเฟรชสถานะและยืนยันว่า card เปลี่ยนจาก Not registered เป็น Connected หรือ Not connected
Heartbeat Monitor ปิดหลังบันทึก
สิ่งที่เห็น: คุณเปิด Heartbeat Monitor, คลิก Save, แล้วมันปิดกลับเอง
วิธีแก้:
- ไปที่ Settings → Room Access → Key Card Encoding (Kiosk)
- เปิด Encoding Options → Advanced options
- เปิด Heartbeat Monitor
- คลิก Save เพียงครั้งเดียวแล้วรอข้อความสำเร็จ
- รีเฟรชหน้าและยืนยันว่า Heartbeat Monitor ยังเปิดอยู่
- หากยังปิดอยู่ ให้ทำตาม Settings Not Saving After Switching Hotels
ความล้มเหลวของ Heartbeat
สิ่งที่เห็น: Heartbeat Monitor แสดง unreachable
วิธีแก้:
- ยืนยันว่า agent รันอยู่บนคีออสก์/พีซี
- ตรวจ Registered Agents ว่ามีสถานะออนไลน์และ tunnel ติดต่อได้
- ตรวจ log ของ agent เพื่อหาข้อผิดพลาด
- ติดตั้ง agent ใหม่หากจำเป็น
สถานะ encoder จริงไม่ตรงกับที่แสดง
สิ่งที่เห็น: encoder ดูเหมือนตั้งค่าแล้ว แต่ AVA ยังระบุว่าใช้ไม่ได้
สาเหตุ: AVA จะแสดง online ก็ต่อเมื่อ agent เชื่อมต่อได้และ tunnel ติดต่อถึง
วิธีแก้:
- ตรวจ Registered Agents สำหรับการ์ดของ encoder
- ยืนยันว่าอุปกรณ์เชื่อมต่ออยู่และ tunnel ติดต่อได้
- แก้ปัญหา agent หรือเครือข่ายก่อน
- รีเฟรช Settings → Room Access
- ลองเข้ารหัสอีกครั้ง
- ตรวจบรรทัด Status: บนหน้าการตั้งค่าอีกครั้ง
Windows Agent ไม่เชื่อมต่อ
สิ่งที่เห็น: สถานะแสดง Not connected หรือ "Never online."
วิธีแก้:
- เปิด zip ที่ดาวน์โหลดแล้วรันไฟล์
.bat - ตรวจว่าเครื่อง Windows มีอินเทอร์เน็ต
- คลิก Reinstall ใน Windows Agent หากจำเป็น
- รีเฟรชสถานะ Registered Agents
- กลับไปที่ Settings → Room Access และยืนยันว่า Status: เปลี่ยนเป็น online
ไม่เห็นกฎ routing ของคีออสก์
สิ่งที่เห็น: หา routing rules ใน Kiosk to Encoder Routing ไม่เจอ
วิธีแก้:
- ตรวจว่า Enable guest selection เปิดอยู่หรือไม่
- ปิดเพื่อให้แสดงกฎ routing แบบ manual
- เพิ่ม device อย่างน้อย 1 ตัวใน Physical Encoder Devices
ยังติดปัญหาอยู่?
ติดต่อ success@vouch-technologies.com หาก:
- ❌ encoder ยังออฟไลน์แม้ตรวจไฟและเครือข่ายแล้ว
- ❌ การเข้ารหัสการ์ดล้มเหลวบนหลายคีออสก์
- ❌ heartbeat ยังไม่ดีเกิน 30 นาที
ข้อมูลที่ควรแนบ:
- ประเภทและรุ่นของ encoder
- ภาพหน้าจอ Registered Agents และ Heartbeat Monitor
- เวลาที่เริ่มเกิดปัญหา