การแก้ปัญหา 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 Android O (8.1) ขึ้นไป
  2. ยังไม่ได้ดาวน์โหลดโมดูล Matter รออย่างน้อย 24 ชั่วโมงเพื่อให้ระบบดาวน์โหลด ตรวจสอบว่าอุปกรณ์เปิดเครื่องและชาร์จอยู่ในช่วงเวลานี้เพื่อไม่ให้การดาวน์โหลดล่าช้า หากไม่ได้รับข้อบังคับภายใน 24 ชั่วโมง ให้ลองรีเซ็ตข้อมูลของอุปกรณ์เป็นค่าเริ่มต้นเพื่อบังคับให้ดาวน์โหลดข้อบังคับ

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

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

  1. ส่งอีเมลพร้อมหมายเลขซีเรียลและรุ่นของอุปกรณ์ไปยัง Technical Account Manager (TAM) ของ Google หมายเลขดังกล่าวจะแสดงเป็นตัวอักษรขนาดเล็กใต้อุปกรณ์
  2. เมื่ออยู่ในรายการที่อนุญาตแล้ว คุณต้องเปิดใช้ฟีเจอร์โดยทำตามขั้นตอนต่อไปนี้
    • จากฮับ ให้ทำดังนี้
      1. เลื่อนนิ้วลงจากด้านบนของหน้าจอ
      2. แตะไอคอนการตั้งค่า
      3. ดูเวอร์ชัน Fuchsia: ใน Google Nest Hub (2nd gen) ให้ไปที่ ข้อมูลอุปกรณ์ > ข้อมูลทางเทคนิค > เวอร์ชัน Fuchsia
      4. แตะ "Fuchsia Version" 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 ของผู้ใช้ที่จะได้บันทึกที่ไม่มีการปกปิดไปยัง TAM ของ Google
    2. หลังจากยืนยันว่าบัญชีของคุณเพิ่มลงในรายการที่อนุญาตแล้ว ให้รีบูตโทรศัพท์

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

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

การแก้ปัญหาเกี่ยวกับโปรแกรมสนิฟเฟอร์บลูทูธ

ค่า 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 ซึ่งทั้ง 2 รายการอยู่ในรูปแบบ Little Endian

แอป BLE จะแสดงค่าในรูปแบบ Little Endian แต่ค่า VID/PID ที่คุณป้อนในโปรเจ็กต์ Developer Console อยู่ในรูปแบบ Big Endian

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

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

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

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

กำลังจับคู่

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

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

  • การประกาศการรับรอง (CD)
  • ใบรับรองการรับรองอุปกรณ์ (DAC) และชุดใบรับรอง

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

ยืนยันฮับที่เข้ากันได้กับ Matter

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

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

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

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

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

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

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

การทดสอบ

อุปกรณ์ที่ตรวจสอบแล้วไม่ปรากฏในชุดทดสอบ

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลอุปกรณ์

หากยังคงมีปัญหา

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

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