การแก้ปัญหา 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 ชั่วโมง คุณสามารถลองรีเซ็ตข้อมูลของอุปกรณ์เป็นค่าเริ่มต้นเพื่อบังคับให้ดาวน์โหลดโมดูลได้

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

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

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

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

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

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

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

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

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

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

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

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

กำลังจับคู่

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

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

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

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

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

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

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