การแก้ปัญหา 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 ของช่อง Service Data ค่านี้ระบุ VID ของ 5A23 และ PID เป็น FFFE ซึ่งมีทั้ง 2 แบบในรูปแบบ Little Endian

แอป BLE จะแสดงค่าเป็น Litian Endian แต่ค่า VID/PID ที่คุณป้อนในโปรเจ็กต์ Developer Console เป็นไฟล์ประเภท Big Endian

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

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

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

การทดสอบ

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

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

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

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

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

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

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

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