ตั้งค่า Keycard Encoders

ตั้งค่าอย่างรวดเร็ว

เลือกประเภท encoder เลือกวิธีเชื่อมต่อ (ถ้ามี) แล้วเพิ่ม encoder เผื่อเวลาประมาณ 15 นาที

คู่มือนี้ช่วยคุณตั้งค่าการเข้ารหัส keycard แบบ encoder-first สำหรับใช้งานที่ kiosk หรือหน้าเคาน์เตอร์ ตอนนี้ครอบคลุมการตั้งค่า Be-Tech Windows Agent ด้วย Be-Tech ใช้ Windows Agent เป็นค่าเริ่มต้น เว้นแต่คุณจะกำหนด Base URL แบบ direct Kiosk routing ตอนนี้อยู่ที่ Settings → Kiosk keycard ที่เชื่อมต่อกับ PMS จะค้นหา encoder terminal จากผู้ให้บริการ PMS ก่อนที่คุณจะเพิ่มอุปกรณ์ การตั้งค่า Be-Tech Windows Agent สามารถกู้คืน client หรือ service ที่หยุดทำงานหลัง Windows รีสตาร์ทหรือหยุดด้วยตนเอง สำหรับ vendor ที่รองรับ AVA จะโหลดฟิลด์ กฎการเชื่อมต่อ และตัวเลือก routing ที่พร้อมใช้งานจาก Room Access Service ดังนั้นป้ายกำกับและฟิลด์ที่ต้องกรอกอาจแตกต่างกันตาม vendor หรือการติดตั้ง

สรุปอ้างอิง

งาน	ทำอะไร	คลิกที่ไหน
Select method	เปิดใช้งาน keycard encoding	Room Access → Keycard Encoding
Choose encoder type	เลือกระบบล็อกของคุณ	Encoder Type
Choose connection method	Direct หรือ Windows Agent (Saflok/Be-Tech/GreatLocks)	Advanced options → Enable direct communication
Configure encoder	เพิ่มเซิร์ฟเวอร์หรือข้อมูลรับรอง	ช่องเฉพาะแต่ละประเภท
Add encoders	ลงทะเบียนอุปกรณ์จริงด้วย encoder ID จริง	Physical Encoder Devices
Load PMS encoders	ดึง terminal ที่พร้อมใช้งานจาก PMS	Physical Encoder Devices → Load Encoders
Enable PMS card reading	อนุญาตให้ Entitlements อ่าน keycard จริงของ PMS	Enable physical keycard reading
Choose kiosk routing	ควบคุมกฎ routing เฉพาะ kiosk	Settings → Kiosk → Device Routing
Download Windows Agent	ดาวน์โหลด bootstrap package สำหรับ agent	Windows Agent
Check agent version	แสดงสถานะเวอร์ชันที่ติดตั้งและเวอร์ชันล่าสุด	Windows Agent
Update agent	เปิด modal คำแนะนำการอัปเดต	Update
Manage agent cards	การ์ดหลักแสดงการติดตั้ง อัปเดต หรือ reinstall	Windows Agent
Advanced agent actions	ดู logs, rotate secrets หรือลบ agents	Advanced options
Sync agent setup	ใช้การกำหนด encoder ที่บันทึกไว้กับ agent ที่รองรับ	Sync Encoder Setup
Set encoding defaults	จำนวนการ์ดต่อการเข้าพัก + เวลาหมดอายุ	Encoding Options

ตำแหน่งที่พบ

Settings → Room Access → Keycard Encoding

ขั้นตอนที่ 1: เลือกวิธี keycard

1. ไปที่ Settings → Room Access
2. เลือก Keycard Encoding เป็นวิธี room access
3. คลิก Save

ขั้นตอนที่ 2: เลือกประเภท encoder

1. เลื่อนไปที่ Keycard Encoder Settings

2. เลือก Saflok, Be-Tech, LockSDK, GreatLocks, Adem หรือ PMS Integration

   ✓ AVA จะเปิดใช้งานเฉพาะ encoder type ที่คุณเลือก

ขั้นตอนที่ 3: เลือกวิธีเชื่อมต่อ

1. ใน Select Encoder Type เปิด Advanced options
2. สำหรับ Saflok, GreatLocks, หรือ LockSDK ให้เปิด Enable direct communication เพื่อข้าม Windows Agent
3. ปิดไว้หากต้องการใช้ Windows Agent (ค่าเริ่มต้น)
4. Be-Tech ใช้ Windows Agent เว้นแต่คุณมี Base URL แบบ direct อยู่แล้ว
5. PMS Integration ใช้ direct communication เท่านั้น ดังนั้นข้ามขั้นตอนนี้ได้

ขั้นตอนที่ 4: ตั้งค่าระบบ encoder

ชื่อ Encoder Credentials

หากคุณใช้ encoder หลายตัว หัวข้อส่วนนี้จะแสดงเป็น Encoder Credentials & Devices

ถ้าคุณใช้ Saflok

• Direct communication
  • กรอก PMSI Server URL, Username และ Password
  • PMSI server ต้องเข้าถึงได้จากอินเทอร์เน็ต
  • คลิก Test Connection
• Windows Agent
  • กรอกเฉพาะ Username และ Password
  • agent จะจัดการ PMSI URL และการทดสอบการเชื่อมต่อ
  • AVA จะตรวจความพร้อมของ Saflok PMSI ซ้ำเรื่อย ๆ ดังนั้นการบูตช้าและการรีสตาร์ทมักจะกู้คืนได้เอง
• เพิ่มอุปกรณ์ encoder ใน Physical Encoder Devices (ต้องมี Encoder ID)
• ตัวเลือก: ตั้ง Location ให้แต่ละ encoder
• หากหลาย kiosk แชร์ encoder กัน ให้เพิ่ม routing จาก Settings → Kiosk → Device Routing

ถ้าคุณใช้ Be-Tech

• Direct communication
  • กรอก Base URL ของบริการ Be-Tech
  • บริการต้องเข้าถึงได้จากอินเทอร์เน็ต
  • กรอก Hotel Name, Chain No, Workstation และ Reader No
  • ตั้ง Category และ Card Type หากการตั้งค่า Be-Tech ของคุณต้องใช้
  • หากบันทึก Base URL แล้ว AVA จะคง Be-Tech ไว้ในโหมด direct
  • คลิก Test Connection เพื่อยืนยันว่า encoder ตอบสนอง
• Windows Agent
  • ติดตั้ง agent บน Windows PC ที่เชื่อมต่อกับ workstation ของ Be-Tech
  • กรอก Hotel Name, Chain No, Workstation และ Reader No
  • agent จะจัดการ local Be-Tech adapter และ proxy ทราฟฟิกของ vendor
  • AVA จะตรวจ agent ที่ /check ทุก 5 นาที
  • หลัง Windows รีสตาร์ทหรือหยุดด้วยตนเอง tray สามารถเริ่ม Be-Tech client และ service ได้โดยอัตโนมัติ
  • tray จะรีเฟรชความพร้อมของ Be-Tech หลังการกู้คืน โดยไม่ต้องรีสตาร์ท agent ด้วยตนเอง
  • หากไม่มีการบันทึก Base URL AVA จะย้อนกลับไปใช้ flow ของ Windows Agent
• เพิ่มอุปกรณ์ encoder ใน Physical Encoder Devices
• ตัวเลือก: เพิ่ม routing จาก Settings → Kiosk → Device Routing หากใช้ encoder หลายตัว

การติดตั้ง Be-Tech หลายชุด

agent จะค้นหาการติดตั้ง Be-Tech ปกติโดยอัตโนมัติ ขอให้ deployment admin ตั้งค่า BETECH_CLIENT_PATH เฉพาะเมื่อการติดตั้งที่มีการป้องกันหลายชุดทำให้เกิดความกำกวม ค่า override ต้องชี้ไปยังโฟลเดอร์ Program Files ที่มีการป้องกันภายใน Windows

ถ้าคุณใช้ GreatLocks

• Direct communication
  • กรอก Server Name (ไม่บังคับ), XHLSI Server IP Address และ TCP Port
  • server ต้องเข้าถึงได้จากอินเทอร์เน็ต
  • GreatLocks รองรับ encoder หนึ่งตัวต่อ server หนึ่งเครื่อง
  • คลิก Test Connection
• Windows Agent
  • agent จะจัดการรายละเอียด server ให้ ไม่ต้องกรอก IP/port
  • ติดตั้ง Universal Encoder Agent หนึ่งตัวบน PC ที่เชื่อมต่อกับ encoder GreatLocks แต่ละตัว

ใช้ GreatLocks agent หนึ่งตัวต่อ encoder

เพิ่มหนึ่งแถวใน Physical Encoder Devices สำหรับ encoder GreatLocks แต่ละตัว กรอก Encoder ID เพียงหนึ่งค่าในแต่ละแถว ใช้ ID ที่ไม่ซ้ำกันในทุกแถว เช่น front-desk หรือ lobby-pc AVA จะคง ID เดิมไว้เมื่อคุณแก้ไขแถวที่บันทึกแล้ว แถวเก่าที่ไม่มี ID จะได้รับ ID ที่คงที่เมื่อ AVA โหลดข้อมูล จากนั้นติดตั้ง Universal Encoder Agent หนึ่งตัวบน Windows PC ที่ตรงกัน agent แต่ละตัวจะให้บริการเฉพาะ encoder ที่เชื่อมโยงกับตนเอง

หมายเหตุ: AVA ใช้รายการ GreatLocks server ที่คุณบันทึกไว้ใน Room Access หากคุณอัปเดตการตั้งค่าเก่า ให้คลิก Save ก่อน Test Connection หากเปิดใช้ inventory sync AVA จะอ่านข้อมูล building, floor และ room ผ่าน agent tunnel ที่ใช้งานอยู่ ให้ agent ออนไลน์ไว้เพื่อให้รายการห้องเป็นปัจจุบัน หากการตั้งค่า GreatLocks รองรับ lift access ให้เปิด Enable lift access จากนั้นเลือกโหมดที่ vendor รองรับ:

• Room floor mapping ใช้ค่า building และ floor จาก room mappings ของคุณ
• Access code groups ใช้ Common access codes สำหรับประตูที่ใช้ร่วมกันหรือกลุ่มลิฟต์

AVA จะส่งประเภทตัวเลือก lift เพียงหนึ่งประเภทต่อการ์ด เมื่อใช้ access code groups AVA จะบันทึกเลขหลักเดียวเป็นรหัสสองหลัก คุณสามารถพิมพ์ 1,2,3 หรือ 01,02,03 ใช้รหัสให้อยู่ในช่วงที่ vendor รองรับ

ถ้าคุณใช้ LockSDK

• Direct communication
  • เพิ่ม LockSDK encoder แต่ละตัวใน Physical Encoder Devices
  • กรอก Encoder ID และ Service URL สำหรับแต่ละ encoder
  • คลิก Test Connection หลังเพิ่มรายการ encoder
• Windows Agent
  • เพิ่ม LockSDK encoder แต่ละตัวใน Physical Encoder Devices
  • ลงทะเบียน Windows Agent หนึ่งตัวต่อ LockSDK encoder หนึ่งตัว
  • การ์ด agent จะแสดง encoder ที่ตรงกันและสถานะสด
• ตัวเลือก: เพิ่ม routing จาก Settings → Kiosk → Device Routing หากใช้ encoder หลายตัว
• สำหรับห้องที่รวมกัน LockSDK รองรับได้สูงสุด 4 ห้อง และต้องใช้ประเภทล็อก RF50/Mifare 5

ถ้าคุณใช้ Adem

การตั้งค่า Adem encoder

Adem ใช้ Windows Universal Encoder Agent เพื่อโหลด SDK แบบ 32 บิต แพ็กเกจ agent ไม่ได้ติดตั้งเซิร์ฟเวอร์ระบบล็อก Adem, reader driver หรือ encoder AVA รับฟิลด์ กฎการเพิ่ม encoder โหมดการเชื่อมต่อ และตัวเลือกการลงทะเบียน agent ของ Adem จาก Room Access Service ให้ยึดฟิลด์ที่แสดงบนหน้าจอของคุณเมื่อแตกต่างจากตัวอย่างนี้

1. เลือก Adem ใต้ Encoder Type

2. เลือกวิธีเชื่อมต่อตามที่แสดงสำหรับการติดตั้งของคุณ โดยทั่วไป PC ที่ใช้กับ encoder ควรเลือกโหมด Windows Agent

3. กรอก Lock Software ตั้งแต่ 1 ถึง 6

4. กรอก Version เป็น 8 หรือ 9

5. กรอกชื่อ Server ของ Adem และ Log User

6. คลิก Save ก่อนทดสอบการเชื่อมต่อ

   ✓ AVA จะตรวจสอบการตั้งค่า Adem ที่จำเป็นก่อนบันทึก

7. เปิด Physical Encoder Devices แล้วคลิก Add Encoder

8. กรอก Encoder ID ที่ไม่ซ้ำกัน และกรอก Name กับ Location ได้หากต้องการ

9. กรอก Port ของ encoder

Port	ความหมาย
0	เครื่องอ่าน USB แบบ native
1	COM1
2	COM2
3	COM3

10. สำหรับเครื่องอ่านแบบ serial ให้ใช้หมายเลข COM จริงของ Windows
11. ในโหมด direct ให้กรอก service URL ที่ AVA แสดงสำหรับ encoder แต่ละตัว ฟิลด์นี้จำเป็นเฉพาะเมื่อวิธีเชื่อมต่อที่เลือกต้องใช้
12. คลิก Save แล้วคลิก Test Connection

✓ AVA จะบันทึกการตั้งค่า Adem ปัจจุบันก่อนทดสอบการตั้งค่าที่บันทึกไว้ ✓ หากเปลี่ยน vendor, การตั้งค่า SDK, รายการ encoder หรือ routing ผลการทดสอบก่อนหน้าจะใช้ไม่ได้

กฎการใช้ Adem agent ร่วมกัน

Windows Agent หนึ่งตัวให้บริการ serial encoder หลายตัวได้ encoder แต่ละตัวต้องใช้ COM port ที่แตกต่างกันและมีค่ามากกว่า 0 ไม่รองรับเครื่องอ่าน USB แบบ native หลายตัวบน agent เดียวกัน สำหรับการเชื่อมต่อแบบ static รายการที่ใช้ agent URL เดียวกันต้องปฏิบัติตามกฎเดียวกัน PC ของ encoder คนละเครื่องสามารถใช้หมายเลข COM เดียวกันได้ เพราะหมายเลขนี้เป็นค่าภายในแต่ละ PC

13. ดาวน์โหลดและติดตั้งแพ็กเกจ Windows Agent ที่สร้างขึ้นบน PC ของ encoder
14. ลงทะเบียน agent จากส่วน Windows Agent
15. กำหนด Adem encoder และ kiosk ที่พร้อมใช้งานโดยใช้ตัวเลือก routing ที่ AVA แสดง agent ที่ใช้ร่วมกันหนึ่งตัวสามารถให้บริการ Adem encoder หลายตัวได้เมื่อ Room Access Service เปิดใช้การลงทะเบียนร่วม
16. ลงทะเบียน kiosk ที่ Settings → Kiosk → Device Routing เมื่อ AVA แนะนำให้ไปที่นั่น
17. จับคู่ชื่อห้อง PMS กับหมายเลขห้อง Adem ใน การจับคู่ห้อง Keycard เมื่อชื่อแตกต่างกัน

ตรวจสอบเครื่องอ่าน Adem ก่อนเข้ารหัส

ใช้ตัวช่วยวินิจฉัยที่ให้มาเมื่อต้องการหลักฐานจาก Windows encoder PC ตัวช่วยนี้จะไม่เข้ารหัสหรือลบข้อมูลจากการ์ด

1. เปิด 32-bit Windows PowerShell บน encoder PC

   C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell.exe -NoProfile

2. ตรวจรายการ COM port ในเครื่องก่อนกำหนดพอร์ตใน AVA

   .\scripts\test-adem-encoder.ps1 -Json

   ใช้ -Watch เฉพาะขณะที่พนักงานเชื่อมต่อเครื่องอ่านที่ยังไม่ได้ใช้งานทีละตัว ชื่อ driver ใช้ระบุอุปกรณ์ Windows ไม่ได้ยืนยันว่าเป็นเครื่องอ่าน Adem

3. บันทึกหมายเลข COM ที่ยืนยันแล้วในฟิลด์ Port ของ AVA แต่ละรายการ หมายเลข COM เป็นของ Windows PC เครื่องนั้น ไม่ใช่ Encoder ID เชิงตรรกะ

4. หากต้องการ ให้อ่านจากพอร์ตที่เลือกโดยไม่ใส่การ์ด ใช้ค่า software, version และ SQL server ของ Adem จริงของโรงแรม

   .\scripts\test-adem-encoder.ps1 -Read -Port 3,4 `
     -AppRoot 'C:\Vouch\Universal Encoder Agent' `
     -LockSoftware 2 -Version 9 -Server 'LOCK-PC' -EncoderIdle -Json

   ตัวช่วยจะอ่านพอร์ตที่เลือกตามลำดับ และต้องมีการยืนยัน -EncoderIdle อย่างชัดเจน ห้ามเข้ารหัสการ์ดหรือใช้เครื่องอ่านของ vendor ระหว่างการตรวจสอบนี้

5. ตรวจสอบ SessionSucceeded, Code และ Status ของแต่ละพอร์ต รวมถึง CleanupError หากหยุด UEA ไว้ ให้เปิดกลับ แล้วตรวจสอบ tunnel ก่อนให้พนักงานใช้ PC

ผลลัพธ์	ความหมาย
0x00000000 / card_read	เครื่องอ่านที่เลือกอ่านการ์ดแล้ว และส่งคืนสถานะห้องกับการ์ด
0x8010000C / no_card	SDK รายงานว่าไม่มีการ์ด ยืนยันการตอบสนองของเครื่องอ่าน ไม่ใช่การอ่านข้อมูลการ์ดกลับ
port_open_error	พอร์ตอาจถูกใช้งานอยู่ ไม่มีอยู่ หรือไม่พร้อมใช้งาน ไม่ได้พิสูจน์ว่า encoder เสีย
communication_error	การสื่อสารกับเครื่องอ่านล้มเหลว ให้ตรวจสอบเครื่องอ่านและ driver
ข้อผิดพลาด SQL, session หรือไม่ทราบสาเหตุ	แก้เงื่อนไขเบื้องต้นที่รายงานก่อนประเมินการเชื่อมต่อทางกายภาพ

ขอบเขตของการวินิจฉัยแบบอ่านอย่างเดียว

การตรวจสอบนี้เรียกใช้เฉพาะฟังก์ชัน SDK สำหรับเริ่ม session, อ่านการ์ด และจบ session ไม่มีการลองซ้ำ ไม่สแกนพอร์ตอื่น และไม่มีการเขียนหรือลบข้อมูล การที่ UEA หรือแอปของ vendor กำลังทำงาน ไม่ได้ยืนยันว่าแอปนั้นถือครองเครื่องอ่านอยู่ในขณะนี้

การเลือก kiosk สำหรับ agent ที่ใช้ร่วมกัน

AVA จะแสดงตัวเลือก kiosk หลายรายการเฉพาะเมื่อ Room Access Service ประกาศว่าการตั้งค่า Adem ของคุณรองรับ agent ที่ใช้ร่วมกัน หากเห็น kiosk เพียงรายการเดียว ให้ลงทะเบียน kiosk นั้นและขอให้ทีมติดตั้งยืนยันข้อมูลความสามารถของ RAS

✓ การ์ดทดสอบควรเข้ารหัสได้สำหรับห้องที่จับคู่ไว้หนึ่งห้อง

ลักษณะการทำงานของ Adem card

AVA จะเข้ารหัสหนึ่งห้องต่อการ์ดหนึ่งใบ การ์ดใบแรกใช้ NEW และอาจทำให้การ์ดผู้เข้าพักใบก่อนหน้าใช้ไม่ได้ การ์ดเพิ่มเติมใช้ DUPLICATE และทำให้การ์ดก่อนหน้ายังคงใช้งานได้

ถ้าคุณใช้ PMS Integration

• ตรวจสอบให้แน่ใจว่ามี PMS integration ที่ active อยู่ (Cloudbeds หรือ Opera)
• ตั้งค่า PMS vendor ให้ตรงกับที่พักของคุณก่อนโหลด encoder
• เปิด Enable PMS Encoder Integration
• ใน Physical Encoder Devices ให้ทำอย่างใดอย่างหนึ่ง:
  • คลิก Load Encoders แล้ว Add Selected หรือ
  • คลิก Add Encoder แล้วกรอก Encoder ID และ PMS Encoder ID
• อุปกรณ์ที่โหลดจะเก็บ provider encoder ID ไว้โดยตรง
• การค้นพบใหม่จะบันทึก workstation, encoder, interface และ outbound-code details ที่จำเป็นสำหรับการอ่านบัตร PMS
• การอ่านของ Opera จะทำงานเฉพาะเมื่อรายละเอียดเหล่านั้นระบุ Door Lock route ที่ตรงกันเพียงรายการเดียว
• ใช้ Active เพื่อปิด encoder ที่ไม่ต้องการใช้
• เปิด Enable physical keycard reading เฉพาะหลังจากตรวจสอบ PMS read API แล้ว
• คลิก Save หลังเปลี่ยนการตั้งค่าการอ่าน
• หากรายการว่าง ให้ตรวจสอบการตั้งค่า PMS vendor ก่อน
• หากยังไม่พบ encoder ให้อ่าน การค้นหา PMS encoder ไม่พบผลลัพธ์

การอ่านบัตร PMS แยกจากการเข้ารหัส

การเข้ารหัส PMS ยังทำงานต่อได้แม้ปิดการอ่านบัตรจริงไว้ Entitlements จะซ่อนตัวควบคุมการสแกนจนกว่าความสามารถของ PMS และ Room Access จะอนุญาตให้อ่านได้ ปิดการอ่านไว้จนกว่าผู้ให้บริการ PMS จะยืนยันว่า read API ใช้งานได้สำหรับที่พักของคุณ

การรองรับการอ่านบัตร PMS

ผู้ให้บริการ PMS	การอ่านบัตรจริง	สิ่งที่ควรทำ
Opera Cloud (OHIP)	รองรับเมื่อ adapter ประกาศความสามารถนี้	ดำเนินการยอมรับฮาร์ดแวร์ให้เสร็จก่อนเปิดการอ่าน
ผู้ให้บริการ PMS อื่น	ไม่พร้อมใช้งาน เว้นแต่ vendor จะประกาศว่ารองรับ	ใช้การค้นหาห้องหรือ confirmation ด้วยตนเอง

AVA จะปิดการทำงานเมื่อ PMS ของคุณไม่ประกาศว่ารองรับการอ่านบัตรจริง ขั้นตอนการเข้ารหัส keycard เดิมของคุณยังคงใช้งานได้

เปิดใช้การอ่านบัตร PMS

การอ่านบัตร PMS ใช้ PMS transport โดยตรง ไม่จำเป็นต้องมี Universal Encoder Agent session AVA จะเปิดใช้การสแกนเมื่อทั้ง merchant setting และความสามารถของ PMS อนุญาต

1. เลือก PMS Integration ใต้ Encoder Type

2. ยืนยันว่าเปิด Enable PMS Encoder Integration อยู่

3. ยืนยันว่ามี encoder ที่ค้นพบอย่างน้อยหนึ่งตัวเป็น Active

4. เปิด Enable physical keycard reading

5. คลิก Save

6. เปิด Entitlements แล้วโหลดหน้าใหม่

   ✓ Start scanning จะปรากฏเมื่อ PMS รายงานว่ารองรับการอ่านบัตรจริง ✓ การค้นหาห้องและ confirmation ด้วยตนเองยังใช้งานได้เมื่อการสแกนไม่พร้อม

การจับคู่ kiosk ของ PMS

สำหรับ PMS Integration, AVA จะค้นหา Device Model mapping ของ kiosk กับอุปกรณ์ PMS encoder ที่ active ก่อน หาก mapping นั้นใช้ไม่ได้หรือไม่ตรงกัน AVA จะใช้ kiosk mapping แบบเดิม ให้ encoder เป้าหมายเป็น Active และใช้ชื่อ PMS encoder ปัจจุบันใน Device Routing

การจับคู่ route ของ Opera ต้องตรงกันทุกประการ

การอ่านบัตรของ Opera ต้องมี workstation, encoder ID, interface และ Door Lock outbound code ที่ตรงกันหนึ่งชุด หาก Opera ส่ง route ที่ซ้ำกันหรือข้อมูลไม่ครบ AVA จะปิดการอ่านแทนการเดา ขอให้ผู้ดูแล Opera แก้ไข encoder catalog แล้วคลิก Load Encoders อีกครั้ง

ค่า interface ของ Saflok

Opera อาจแสดงค่า encoder interface เช่น SL01 AVA ใช้ค่านั้นเพื่อเลือก Door Lock route ที่ตรงกัน คำขออ่านจะใช้ numeric outbound code ที่ค้นพบแทน คุณไม่จำเป็นต้องเปลี่ยนค่านี้ด้วยตนเอง

ย้าย routing แล้ว

ตอนนี้ AVA จัดการ kiosk routing ที่ Settings → Kiosk → Device Routing หน้า Room Access ยังคงเก็บการตั้งค่า encoder และชี้มาที่หน้านี้สำหรับ routing

ขั้นตอนที่ 5: ตั้งค่า kiosk routing (ไม่บังคับ)

ใช้ส่วนนี้เฉพาะเมื่อต้องการพฤติกรรม routing เฉพาะ kiosk:

1. ไปที่ Settings → Kiosk

2. เปิด Device Routing

3. เปิด Enable guest selection เพื่อให้ผู้เข้าพักเลือก encoder ที่ kiosk ได้

4. ปิดไว้หากต้องการเพิ่มกฎ routing สำหรับแต่ละ kiosk

5. AVA จะบันทึกกฎ kiosk เหล่านั้นกับ Mini MDM Device ID

6. device ID mapping รุ่นเก่าจะอัปเดตเองเมื่อคุณบันทึก

   ✓ เมื่อเปิด guest selection AVA จะซ่อนกฎ routing แบบ manual ⚠️ ยังต้องมี encoder device อย่างน้อยหนึ่งตัวใน Physical Encoder Devices ✓ AVA สามารถส่งคำขอเข้ารหัสด้วย encoderId โดยไม่ต้องมี kiosk mapping

พฤติกรรมการเลือก encoder ในการทำงาน

• ถ้ามี encoder ออนไลน์เพียงตัวเดียว AVA จะเลือกให้อัตโนมัติ
• ถ้ามี encoder ออนไลน์หลายตัว พนักงานต้องเลือกหนึ่งตัวอย่างชัดเจน
• เมื่อ physical encoder หลายตัวใช้ Windows Agent เดียวกัน แต่ละตัวเลือกจะแสดงชื่อ encoder AVA จะแสดงชื่อ agent เป็นข้อความขนาดเล็กเมื่อจำเป็นต้องแยกกลุ่ม agent ที่ใช้ร่วมกันหลายกลุ่ม
• encoder ที่ใช้ร่วมกันแต่ไม่มีชื่อจะแสดง Encoder ID เพื่อให้ยังระบุอุปกรณ์ได้
• ใน ACI แบบสองอุปกรณ์ AVA สามารถเลือกค่าเริ่มต้นที่ใช้งานอยู่ซึ่งบันทึกไว้สำหรับ Guest Tablet ที่เลือกไว้ล่วงหน้าได้
• หากไม่มีค่าเริ่มต้นนั้นหรือไม่ได้เปิดใช้งาน พนักงานสามารถเลือก encoder ที่ใช้งานอยู่ด้วยตนเอง
• สำหรับ GreatLocks ให้ใช้แถวที่ตรงกันเมื่อต้องการดูสถานะแบบไดนามิกหรือดำเนินการตั้งค่า
• AVA ไม่สามารถอนุมานเป้าหมายได้เมื่อมี GreatLocks server หรือ agent หลายรายการพร้อมใช้งาน

สถานะออนไลน์แบบสด

Online หมายถึง AVA ตรวจสอบ encoder และ agent tunnel แล้ว Unknown หมายถึง AVA ไม่สามารถตรวจสอบสถานะ encoder ได้ Unknown ไม่ได้ยืนยันว่า encoder ออฟไลน์ บรรทัด Status: จะแสดง online ต่อเมื่อการเชื่อมต่อนั้น live แล้ว หาก encoder หลุด offline ให้แก้ agent หรือ tunnel ก่อน

ขั้นตอนที่ 6: ตั้งค่า Windows Agent (เฉพาะ Windows Agent)

หากคุณไม่ได้เปิด Direct communication ให้ติดตั้ง Windows Agent:

1. ไปที่ Windows Agent

2. คลิก Download Windows Agent บนการ์ดใหม่ หรือ Reinstall บนการ์ดที่มีอยู่

3. ติดตั้ง agent บน Windows PC ที่เชื่อมต่อกับ encoder

4. หากการ์ดแสดง Not connected หรือ Never online ให้แตกไฟล์ zip ที่ดาวน์โหลดมา แล้วรัน download-installer.bat

5. เมื่อดาวน์โหลดเสร็จ ให้รันไฟล์ติดตั้ง .exe ที่บันทึกไว้

   ✓ agent จะปรากฏใต้ Registered Agents พร้อมรายละเอียดสถานะ ✓ AVA ใช้สถานะสดนี้เมื่อตัดสินว่า encoder ใช้ได้หรือไม่ ✓ การ์ดแต่ละใบจะแสดง Installed version และเมื่อมี Latest version ✓ หาก agent เป็นเวอร์ชันล่าสุด คุณจะเห็น Latest version installed ✓ หาก agent ล้าสมัย ให้คลิก Update ก่อน Reinstall

Be-Tech, Saflok, GreatLocks และ LockSDK ใช้ Windows Agent ได้ทั้งหมด สำหรับ GreatLocks ให้ทำขั้นตอนตั้งค่า agent ซ้ำสำหรับ encoder และ PC ที่เชื่อมต่อแต่ละชุด ตรวจสอบว่า agent แต่ละตัวใช้ Encoder ID ที่ตรงกัน เมื่อ agent ล้าสมัย Update จะปรากฏก่อน Reinstall บนการ์ดหลัก เปิด Advanced options เพื่อใช้ View Logs, Rotate Secret หรือ Delete Rotate Secret จะเปิดหน้าต่างยืนยันก่อนที่ AVA จะตัดการเชื่อมต่อ agent ปัจจุบัน

การควบคุม service

การกู้คืน Be-Tech โดยปกติจะเริ่ม client หรือ service ที่หยุดทำงานโดยอัตโนมัติ ใช้ Start, Stop หรือ Restart ใน Windows Agent tray เมื่อต้องการควบคุม service ด้วยตนเอง หาก Windows ขอสิทธิ์ ให้ยืนยันคำขอ UAC เพื่อดำเนินการต่อ หากคุณยกเลิกคำขอ ให้ทำซ้ำและยืนยันคำขอ

สิ่งที่เห็นเมื่อเวอร์ชันล้าสมัย

สิ่งที่เห็น: การ์ดแสดง Outdated หรือแจ้งว่า heartbeat ไม่ได้รายงานเวอร์ชันที่ติดตั้ง

วิธีแก้:

1. คลิก Update
2. อ่าน modal อัปเดต
3. เปิดแอป Windows Agent
4. คลิก Check for Update
5. ติดตั้งอัปเดตที่เสนอ
6. รีเฟรช Settings → Room Access และยืนยันว่าสถานะเวอร์ชันเป็นปัจจุบัน

สถานะเวอร์ชันเดียวกันนี้จะแสดงบนการ์ด agent ของ LockSDK ด้วย

ใช้การเปลี่ยนแปลงกับ encoder หรือ kiosk ของ agent

สำหรับ native Windows UEA รุ่นที่ประกาศว่ารองรับการซิงก์การตั้งค่าระยะไกล:

1. บันทึกการกำหนด encoder และ kiosk ของ agent ใน AVA

2. หลังบันทึก การกำหนด Adem ที่เปลี่ยนแปลงจะพยายามซิงก์โดยอัตโนมัติ vendor อื่นที่รองรับยังต้องดำเนินการด้วยตนเอง

3. ใช้ Sync Encoder Setup บนการ์ด agent เพื่อลองใหม่ด้วยตนเอง

4. คุณยังใช้ Advanced options → Registered Agents ได้

5. รีเฟรชสถานะ agent ใน AVA หลังซิงก์

   ✓ Pending encoder setup sync จะหายไปหลัง agent รายงานการกำหนดที่บันทึกไว้ ✓ AVA จะแสดงเวลาซิงก์การตั้งค่าล่าสุดเมื่อมีข้อมูล

การบันทึกยังสำเร็จแม้ยืนยันการซิงก์อัตโนมัติไม่ได้ ตรวจสอบการเชื่อมต่อ แล้วลองใหม่ด้วยตนเอง การบันทึกขณะออฟไลน์จะไม่ถูกเข้าคิวไว้อย่างเงียบ ๆ เพื่อใช้ภายหลัง

การรีเฟรชสถานะทั่วไปไม่ได้นำการเปลี่ยนแปลงการกำหนดไปใช้ การซิงก์ไม่ค้นหาอุปกรณ์ USB และไม่เปลี่ยนการตั้งค่าภายในของ vendor นอกจากนี้ยังไม่รีสตาร์ท UEA หรือขัดจังหวะการทำงานเข้ารหัสการ์ดที่กำลังดำเนินอยู่

เมื่อใดที่การซิงก์อัตโนมัติทำงาน

การซิงก์อัตโนมัติทำงานเฉพาะเมื่อชุดการกำหนด Adem encoder หรือ kiosk เปลี่ยนแปลง การเปลี่ยนชื่อ การเรียงลำดับ การจับคู่ห้อง การรีเฟรชสถานะ และการเปลี่ยนแปลง vendor อื่น ๆ จะไม่เรียกใช้การซิงก์

การดำเนินการด้วยตนเองต้องใช้ agent หรือ tunnel ที่ออนไลน์ หากไม่พร้อมใช้งาน ให้อัปเดต UEA หรือใช้ Reinstall พร้อมแพ็กเกจใหม่ การรีสตาร์ทเพียงอย่างเดียวจะไม่ดึงการกำหนดใหม่ Node agent รุ่นเก่ายังคงใช้การตั้งค่า .env ภายในเครื่อง

ขั้นตอนที่ 7: ตั้งค่า default สำหรับการเข้ารหัส

1. ตั้ง Number of Cards to Encode (โดยทั่วไป 1–2)
2. ตั้ง Keycard Expiration Time (ค่าเริ่มต้น: 11:00 AM) เวลานี้จะเติมค่าใน Valid Until อัตโนมัติระหว่างการเข้ารหัส keycard แบบ manual

การจองแบบใช้ระหว่างวัน

หาก reservation ระบุเป็น day use อย่างชัดเจนและเปิดใช้ day use อยู่ AVA จะใช้เวลา checkout ที่แก้ไขแล้วแทน reservation แบบค้างคืนยังคงใช้ Keycard Expiration Time

ตัวเลือก: ขยาย Advanced options เพื่อเปิด Heartbeat Monitor

ตัวเลือก: จับคู่ห้อง PMS กับชื่อ encoder

หาก encoder ของคุณใช้ชื่อห้องต่างจาก PMS:

• ใช้ การจับคู่ห้อง Keycard

การแก้ปัญหา

หาก encoder ไม่ตอบสนองหรือการ์ดเข้ารหัสไม่ผ่าน ให้ดู checklist ฉบับเต็ม:

• การแก้ปัญหา Keycard Encoder

ยังติดปัญหาอยู่?

ติดต่อ success@vouch-technologies.com หาก:

• ❌ บันทึกการตั้งค่า encoder ได้ แต่อุปกรณ์ยัง offline
• ❌ ไม่สามารถเข้ารหัสการ์ดสำหรับห้องใด ๆ ได้
• ❌ agent ไม่แสดง online ใน Registered Agents เลย

ข้อมูลที่ควรแนบ:

• ประเภทและรุ่นของ encoder
• ภาพหน้าจอ Keycard Encoder Settings
• เวลาที่ปัญหาเริ่มเกิดขึ้น

คู่มือที่เกี่ยวข้อง

• ภาพรวม Keycard Encoders
• การจับคู่ห้อง Keycard
• คำแนะนำสำหรับผู้เข้าพักเกี่ยวกับ Keycard
• การแก้ปัญหา Keycard Encoder