การแก้ปัญหา 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. หากต้องการเรียกบันทึกจากฮับ คุณจะต้องส่งคำขอ GET HTTP ไปยังฮับจากคอมพิวเตอร์ในเครือข่าย 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 ของอุปกรณ์บีคอนในช่องข้อมูลบริการ

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

แอป BLE จะแสดงค่าเป็น endian เล็กๆ แต่จะแสดงค่า VID/PID ที่คุณป้อนลงในโครงการ Developer Console ของคุณเป็นบิ๊กเอนด์

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

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

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

ฮับของ Google Matter เข้ากันได้กับ 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 โปรดดูสร้างกรณี การผสานรวมเพื่อดูข้อมูลเพิ่มเติม

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

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

การทดสอบ

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมในข้อมูลอุปกรณ์

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

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

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