การแก้ปัญหา Matter

สร้าง

ยืนยันว่าโทรศัพท์ของคุณใช้งานร่วมกันได้

อุปกรณ์ Android O (8.1, API ระดับ 27) ขึ้นไปทั้งหมดเข้ากันได้กับ Matter ทำตามขั้นตอนด้านล่างเพื่อตรวจสอบว่าโทรศัพท์มีโมดูลที่จำเป็นหรือไม่

ตั้งค่า Android Debug Bridge

ควรตั้งค่า Android Debug Bridge (adb) ก่อนแก้ปัญหา ขั้นตอนจัดการประชุมมีดังนี้

  1. ติดตั้ง "adb" ในคอมพิวเตอร์ ของคุณ
  2. เปิดตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์และการแก้ไขข้อบกพร่อง USB ในโทรศัพท์ Android

ยืนยันโมดูล Matter ของบริการ Google Play (GPS)

หากต้องการตรวจสอบว่าคุณมีโมดูล Google Play services Matter หรือไม่ ให้ทำดังนี้

  1. ตั้งค่า Android Debug Bridge
  2. ใช้สาย USB เพื่อเชื่อมต่อโทรศัพท์ Android กับคอมพิวเตอร์
  3. เรียกใช้คำสั่งนี้ในเทอร์มินัลเพื่อยืนยันว่ามีการติดตั้งโมดูล Matter ที่จำเป็นแล้ว 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    หากคุณเห็นเอาต์พุตคล้ายกับด้านล่างนี้ แสดงว่าคุณติดตั้งโมดูล Matter แล้ว 
    com.google.android.gms.home [v222110900]
    โปรดทราบว่าหมายเลขเวอร์ชันด้านบนอาจแตกต่างจากอุปกรณ์ของคุณ
  4. เรียกใช้คำสั่งนี้ในเทอร์มินัลเพื่อยืนยันว่ามีการติดตั้งโมดูล Thread ที่จำเป็นแล้ว 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    หากคุณเห็นเอาต์พุตคล้ายกับในตัวอย่างต่อไปนี้ แสดงว่าคุณติดตั้งโมดูล Thread แล้ว 
    com.google.android.gms.threadnetwork [v222106301]
    โปรดทราบว่าหมายเลขเวอร์ชันในอุปกรณ์อาจแตกต่างออกไป

หากโมดูลไม่แสดงอยู่ในรายการ อาจหมายความว่า

  1. คุณใช้ Android เวอร์ชันเก่าอยู่ โปรดตรวจสอบว่าเป็น Android O (8.1) ขึ้นไป
  2. ยังไม่ได้ดาวน์โหลดโมดูล Matter รออย่างน้อย 24 ชั่วโมงเพื่อให้ผู้เข้าชมดาวน์โหลด โปรดตรวจสอบว่าอุปกรณ์เปิดอยู่และชาร์จไฟในระหว่างนี้ เพื่อให้การดาวน์โหลดไม่ล่าช้า หากคุณยังไม่ได้รับโมดูลภายใน 24 ชั่วโมง คุณสามารถลองรีเซ็ตข้อมูลของอุปกรณ์เป็นค่าเริ่มต้นเพื่อบังคับให้ดาวน์โหลดโมดูลดังกล่าวได้

บันทึกของอุปกรณ์ฮับ Fuchsia

หากต้องการเปิดใช้ฮับสำหรับการดึงข้อมูลบันทึกในเครื่อง ให้ทำดังนี้

  1. ส่งอีเมลพร้อมหมายเลขซีเรียลและรุ่นของอุปกรณ์ไปยัง Google Technical Account Manager (TAM) โดยจะเห็นเป็นตัวอักษรขนาดเล็กใต้อุปกรณ์
  2. เมื่ออยู่ในรายการที่อนุญาตแล้ว คุณจะต้องเปิดใช้ฟีเจอร์ดังกล่าวโดยทำตามขั้นตอนต่อไปนี้
    • จากฮับ ให้ทำดังนี้
      1. เลื่อนนิ้วลงจากด้านบนของหน้าจอ
      2. แตะไอคอนการตั้งค่า
      3. ค้นหาเวอร์ชัน Fuchsia: ใน Google Nest Hub (2nd gen) ให้ไปที่ ข้อมูลอุปกรณ์ > ข้อมูลทางเทคนิค > เวอร์ชัน Fuchsia
      4. แตะ "เวอร์ชัน Fuchsia" 7 ครั้ง การดำเนินการนี้จะเปิดใช้ตัวเลือกสำหรับนักพัฒนาแอป
      5. กลับไปที่เมนูระดับบนสุด
      6. แตะ "ตัวเลือกสำหรับนักพัฒนาแอป"
      7. แตะ "การบันทึกของพาร์ทเนอร์"
    • ฟีเจอร์นี้จะเปิดใช้เป็นเวลา 24 ชั่วโมง หลังจากนั้น ให้เปิดใช้ฟีเจอร์การบันทึกอีกครั้งตั้งแต่ขั้นตอนที่ 5 เป็นต้นไป
  3. รับที่อยู่ IP ของฮับ โดยทำดังนี้
    • จากฮับ หากมีหน้าจอ ให้ทำดังนี้
      1. เลื่อนนิ้วลงจากด้านบนของหน้าจอ
      2. แตะไอคอนการตั้งค่า
      3. ค้นหาที่อยู่ IP ของอุปกรณ์: ใน Nest Hub (2nd gen) ให้ไปที่ ข้อมูลอุปกรณ์ > ข้อมูลทางเทคนิค > ที่อยู่ IP
    • จาก Google Home app (GHA) บนโทรศัพท์ของคุณ:
      1. แตะอุปกรณ์เพื่อแสดงหน้ารายละเอียดของอุปกรณ์
      2. แตะไอคอนการตั้งค่า เพื่อเรียกหน้าการตั้งค่า
      3. ค้นหาที่อยู่ IP ของอุปกรณ์โดยไปที่ข้อมูลอุปกรณ์ > ข้อมูลทางเทคนิค > ที่อยู่ IP
  4. ในการเรียกบันทึกจากฮับ คุณจะส่งคำขอ HTTP แบบ GET ไปยังฮับจากคอมพิวเตอร์ที่อยู่ในเครือข่าย Wi-Fi เดียวกัน
    • จดพอร์ตและเส้นทางของปลายทาง 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • ระบบจะเปิดการเชื่อมต่อไว้เป็นเวลาเพียง 1 นาที แต่ข้อมูลที่ดึงมาจากบัฟเฟอร์มักมีเหตุการณ์ที่ผ่านมาประมาณ 20-30 นาที
      • โดยหลักการแล้ว ระบบจะแยกบันทึกโดยใช้วิธีการนี้ทันทีหลังจากที่ดำเนินขั้นตอนการทดสอบเสร็จสิ้น เพื่อให้มั่นใจว่าบัฟเฟอร์มีเนื้อหาที่เกี่ยวข้องกับการทดสอบ (คล้ายกับรายงานข้อบกพร่องของ Android)

ปิดใช้การปกปิดข้อมูลบางส่วนในบันทึก Android

  • คุณควรใช้ฟีเจอร์นี้เพื่อการทดสอบทางวิศวกรรมเท่านั้นเพื่อความเป็นส่วนตัวและความปลอดภัย
  • อย่าใช้ตัวเลือกนี้กับอุปกรณ์หรือผู้ใช้เวอร์ชันที่ใช้งานจริง
  • ขั้นตอน
    1. ส่งบัญชี Google ของผู้ใช้ที่จะมีบันทึกที่ไม่มีการปรับปรุงไปยัง Google TAM
    2. หลังจากยืนยันว่าระบบเพิ่มบัญชีไปยังรายการที่อนุญาตแล้ว ให้รีบูตโทรศัพท์

ยืนยัน VID/PID ของอุปกรณ์

หากต้องการเริ่มพัฒนาการผสานรวมกับ Google คุณต้องสร้างโปรเจ็กต์และการผสานรวมในคอนโซล Google Home

การแก้ปัญหา Bluetooth Sniffer

ค่า VID/PID ที่บีคอนของอุปกรณ์ควรตรงกับ VID/PID ที่ป้อนลงในโปรเจ็กต์ Google Home Developer Console

  • VID 0xFFF1 — 0xFFF4 สงวนไว้สําหรับการทดสอบ พารามิเตอร์เหล่านี้อาจใช้สำหรับการสั่งงานพื้นฐานและการทดสอบการควบคุม แต่จะใช้ไม่ได้ในระหว่างขั้นตอนการพัฒนาต่อไปนี้

เมื่อใช้แอปวิศวกรรมบลูทูธ เช่น nRF Connect for Mobile คุณจะดู VID/PID ของอุปกรณ์บีคอนได้ในช่อง Service Data

ในภาพหน้าจอนี้จาก nRF Connect เวอร์ชัน Android คุณจะเห็น VID/PID แสดงเป็น 5A23FFFE โดยเริ่มที่ไบต์ที่ 4 ของช่อง Service Data ซึ่งแสดงถึง VID เป็น 5A23 และ PID เป็น FFFE ซึ่งอยู่ในรูปแบบ little endian ของ

แอป BLE แสดงค่าเป็น Endian ตัวเล็ก แต่ค่า VID/PID ที่คุณป้อนลงในโปรเจ็กต์ Developer Console จะเป็นค่าใหญ่

ตรวจสอบว่าได้ป้อนค่าและรูปแบบที่ถูกต้องในโปรเจ็กต์ Actions Console แล้วโดยอิงตามสิ่งที่ตัวตรวจจับบลูทูธกำลังแสดงอยู่

สำหรับค่าในภาพหน้าจอตัวอย่าง VID และ PID ใน Developer Console จะเป็น 235A และ FEFF ตามลำดับ

ยืนยันว่าอุปกรณ์ของคุณสร้างโดยใช้สาขา Matter SDK ที่เข้ากันได้

ฮับ Matter ของ Google เข้ากันได้กับ Matter 1.0 และผ่านการทดสอบกับบิลด์ที่ใช้คอมมิตจาก Branch ที่มีความเสถียร v1.0-branch ตรวจสอบหมายเหตุการเผยแพร่ต่อสาธารณะเพื่อดูสัญญาผูกมัดเฉพาะที่แนะนำสำหรับการใช้ฮับใหม่แต่ละรุ่น

กำลังจับคู่

ยืนยันข้อมูลเข้าสู่ระบบของอุปกรณ์

เมื่อใช้ VID ที่ Alliance กําหนด โปรดตรวจสอบว่าคุณมีข้อมูลเข้าสู่ระบบที่ถูกต้องในอุปกรณ์ ดังนี้

  • คำประกาศการรับรอง (CD)
  • ใบรับรองเอกสารรับรองอุปกรณ์ (DAC) และเชนใบรับรอง

ดูข้อมูลเพิ่มเติมได้ที่สร้างใบรับรองการทดสอบอุปกรณ์ Matter

ยืนยันว่าฮับที่ใช้กับ Matter ได้

ฮับ Matter ต้องเป็นหนึ่งในฮับที่ Google รองรับ และต้องอยู่ในบิลด์ที่เข้ากันได้กับ Matter

ฮับบางอย่างก็เป็น Thread Border Router จึงพัฒนาและทดสอบอุปกรณ์ Thread ได้ ฮับอื่นๆ รองรับเฉพาะอุปกรณ์ Wi-Fi และอีเทอร์เน็ต Matter เท่านั้น เว้นแต่คุณจะมี Border Router ประเภทอื่นในเครือข่ายเพื่อเปิดใช้การเชื่อมต่อเทรด

บิลด์ของฮับอาจได้รับการยืนยันโดยเลื่อนนิ้วลงจากขอบด้านบน > วงล้อการกำหนดค่า > ข้อมูลอุปกรณ์ > ข้อมูลทางเทคนิค > เวอร์ชันเฟิร์มแวร์ของ Chromecast

การจัดเตรียมไม่สำเร็จโดยมีข้อความแสดงข้อผิดพลาด "ติดต่อ Google ไม่ได้"

ตรวจสอบว่าคุณได้สร้างการผสานรวมด้วยชุดค่าผสม VID/PID ที่ถูกต้องใน Developer Console แล้ว ดูข้อมูลเพิ่มเติมได้ที่สร้างการผสานรวม Matter

การจัดเตรียมอุปกรณ์ไม่สำเร็จโดยมีข้อความแสดงข้อผิดพลาด "เข้าถึงอุปกรณ์ไม่ได้"

หากคุณยังคงได้รับข้อความแสดงข้อผิดพลาด "เข้าถึงอุปกรณ์ไม่ได้" ในขณะจัดเตรียมอุปกรณ์ Thread และได้นำตัวเลือกการแก้ไขข้อบกพร่องที่มีไปหมดแล้ว คุณอาจต้องล้างข้อมูลเข้าสู่ระบบ Thread ที่เลือกไว้ในโทรศัพท์ Android เพื่อการตั้งค่าที่ปลอดภัยผ่านการตั้งค่า > แอป > แอปของแอป > บริการ Google Play > พื้นที่เก็บข้อมูลและแคช > ล้างข้อมูลทั้งหมด

การทดสอบ

อุปกรณ์ที่ได้รับการมอบหมายจะไม่ปรากฏในชุดทดสอบ

หากคุณจับคู่อุปกรณ์ที่มีรหัสผู้ให้บริการทดสอบ (VID) และรหัสผลิตภัณฑ์ (PID) แล้ว แต่อุปกรณ์ไม่ปรากฏเมื่อคุณพยายามทดสอบอุปกรณ์กับชุดทดสอบใน Developer Console ปัญหานี้อาจเกิดจากการใช้ VID และ PID การทดสอบชุดเดียวกันในการผสานรวมหลายรายการ

หากต้องการแก้ปัญหา ให้นำอุปกรณ์ทดสอบทั้งหมดออกจาก Developer Console และจับคู่อุปกรณ์ที่คุณต้องการทดสอบอีกครั้ง

หากต้องการตรวจสอบว่าคุณได้จับคู่อุปกรณ์ที่ถูกต้องแล้ว ให้ตั้งค่าข้อมูลผู้ผลิตและรุ่น (ค่า CHIP_DEVICE_CONFIG_DEVICE_*) ของอุปกรณ์เป็นค่าที่ไม่ซ้ำกันในเฟิร์มแวร์ทดสอบ

ดูข้อมูลอุปกรณ์สำหรับข้อมูลเพิ่มเติม

หากยังพบปัญหาอยู่

หากยังคงแก้ปัญหาไม่ได้หลังจากทำตามขั้นตอนการแก้ปัญหาข้างต้นแล้ว ก็ไม่มีปัญหา

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