ทดสอบการผสานรวม Matter

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

Google Home Developer Console provides a Test page where you can configure and run tests against your Matter integration using the Google Home Test Suite . The Test Suite is a separate application built into the Developer Console that handles all integration testing.

อุปกรณ์สําหรับรหัสผู้ให้บริการและรหัสผลิตภัณฑ์ของการผสานรวมต้องมีค่าคอมมิชชันและพร้อมใช้งานใน Google Home app (GHA) for the account being used with the Developer Console in order to be tested. See Pair a Matter device for more information.

Test Suite สามารถเรียกใช้ในชุดอุปกรณ์ที่เป็นของการกําหนดค่าโปรเจ็กต์ Matter หนึ่งๆ ได้ คุณควรเรียกใช้ Test Suite ในการผสานรวมของคุณเพื่อให้แน่ใจว่าทุกอย่างทํางานได้อย่างถูกต้อง

ในหน้าทดสอบ การผสานรวม Matter ที่เสร็จสมบูรณ์และพร้อมทดสอบจะแสดงอยู่ในพร้อมทดสอบ

การผสานรวม Matter ที่ได้รับการทดสอบจะแสดงอยู่ในส่วนทดสอบ

ประเภทแผนการทดสอบ

แผนการทดสอบมี 2 ประเภท ได้แก่

  • แผนการทดสอบการพัฒนาจะใช้เพื่อทดสอบการควบคุมอุปกรณ์โดยใช้ Matter คําบรรยายเหล่านี้แก้ไขได้ แต่ส่งสําหรับ Matter การรับรองไม่ได้

  • แผนการทดสอบการรับรองมีไว้สําหรับ การรับรอง Matter โดยเฉพาะ และไม่สามารถแก้ไขได้ การเลือกตัวเลือกนี้จะสร้างการผสานรวม Matter เวอร์ชันใหม่

เวอร์ชันการผสานรวม

เมื่อสร้างแผนการทดสอบสําหรับการรับรอง ระบบจะสร้างการผสานรวมเวอร์ชันใหม่ เวอร์ชันที่มีตัวเลขนี้จะแสดงอยู่ในรายการการผสานรวมทั้งหมดใน Developer Console จากแท็บทดสอบเป็นต้นไป

ระบบจะไม่สร้างเวอร์ชันใหม่จากเวอร์ชันที่มีหมายเลขอื่นๆ เช่น แผนการทดสอบแรกที่คุณสร้างสําหรับการผสานรวมจะสร้างเวอร์ชัน v.1 สําหรับการผสานรวมนั้น การสร้างแผนการทดสอบอื่นจะสร้างเวอร์ชัน v.2 สําหรับการผสานรวมนั้น แต่เวอร์ชันนี้จะไม่อิงตาม v.1 แต่เวอร์ชันนี้จะอิงตามอินสแตนซ์ที่ไม่ผสานรวมของการผสานรวม เช่นเดียวกับ v.1

การผสานรวมเวอร์ชัน N/A แสดงถึงอินสแตนซ์ที่ไม่มีการผสานรวมของการผสานรวม ซึ่งจัดการได้ในแท็บพัฒนา

กล่าวคือ ใน Matter > ทดสอบใน Developer Console:

  • หากคลิกทดสอบของเวอร์ชัน N/A ของการผสานรวม ระบบจะสร้างเวอร์ชันใหม่ หมายเลขเวอร์ชันจะสูงกว่าเวอร์ชันที่เรียงลําดับอยู่ทั้งหมด
    • หากไม่มีเวอร์ชันที่เป็นตัวเลข ระบบจะสร้างเวอร์ชัน v.1
    • หากมีเวอร์ชัน v.1 อยู่ ระบบจะสร้างเวอร์ชัน v.2 ไว้ หากมีเวอร์ชัน v.2 อยู่ ระบบจะสร้างเวอร์ชัน v.3 แบบนี้ไปเรื่อยๆ
  • หากคลิกทดสอบเพื่อผสานรวมเวอร์ชันที่มีตัวเลข (เช่น v.1) ระบบจะไม่สร้างเวอร์ชันใหม่ แต่เวอร์ชัน v.1 ได้รับการทดสอบอีกครั้ง

ดูข้อมูลเพิ่มเติมได้ที่การกําหนดเวอร์ชันการผสานรวม

สร้างแผนการทดสอบ

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

ก่อนสร้างแผนการทดสอบเพื่อรับการรับรอง โปรดตรวจสอบว่าคุณได้ทําสิ่งต่อไปนี้

  1. สร้างโปรไฟล์บริษัทแล้ว
  2. ป้อนรหัสผู้ให้บริการที่ใช้งานจริง (VID) สําหรับการผสานรวม
  3. กําหนดการตั้งค่าและการสร้างแบรนด์

หากคุณดําเนินการกับการผสานรวมเหล่านี้ไม่ครบถ้วน เวอร์ชันการผสานรวมที่สร้างขึ้นสําหรับการทดสอบการรับรองจะผ่านการรับรองไม่ได้ คุณจะต้องสร้างเวอร์ชันใหม่ ซึ่งหมายความว่าต้องทําซ้ําขั้นตอนทดสอบ ทดลองใช้ และรับรอง

นอกจากนี้คุณต้องสร้างเวอร์ชันใหม่และเริ่มต้นใหม่ หากต้องการอัปเดตการสร้างแบรนด์ก่อนที่เวอร์ชันการผสานรวมจะได้รับการรับรอง

วิธีสร้างแผนทดสอบ

ไปที่ Developers Console

  1. จากรายการโปรเจ็กต์ ให้คลิกเปิดข้างโปรเจ็กต์ที่ต้องการ

  2. ในเมนูการนําทางด้านซ้ายของหน้า ให้ไปที่ Matter > ทดสอบ

  3. คลิกทดสอบสําหรับเวอร์ชัน N/A ของการผสานรวมที่ต้องการทดสอบ ซึ่งจะสร้างการผสานรวมเวอร์ชันใหม่

  4. เลือกประเภทการทดสอบของการทดสอบการพัฒนาหรือการทดสอบการรับรอง การสร้างแผนการทดสอบใหม่

    • เลือกการทดสอบการรับรองหากคุณกําลังเตรียมการรับรองในระบบนิเวศของ Google
    • ไม่สามารถใช้การทดสอบการพัฒนากับการรับรอง
  5. คลิกทดสอบ หากหน้าจอแสดงข้อผิดพลาด "ไม่พบอุปกรณ์" แสดงว่าอุปกรณ์สําหรับการผสานรวมนี้ไม่ได้รับค่าคอมมิชชันในระบบนิเวศ ดูการแก้ปัญหาเกี่ยวกับการจับคู่สําหรับข้อมูลเพิ่มเติม

  6. ในหน้าจอกําหนดค่าการทดสอบ ให้ระบุชื่อสําหรับการทดสอบและเลือกอุปกรณ์ที่คุณต้องการทดสอบจากรายการอุปกรณ์

  7. คลิกปุ่มถัดไป: แผนการทดสอบ

  8. ในหน้าสร้างแผนการทดสอบ ให้เลือกชุดทดสอบที่ต้องการในส่วนชุดทดสอบ

สร้างแผนการทดสอบ

หากต้องการออกจาก Test Suite ให้คลิก กลับไปที่ศูนย์ นักพัฒนาซอฟต์แวร์

ใช้แผนการทดสอบ

ใน Test Suite จากหน้าสร้างแผนทดสอบ ให้คลิกทําการทดสอบ หน้าสภาพแวดล้อมการทดสอบจะปรากฏขึ้น พร้อมด้วยสถานะและบันทึกการทดสอบทั้งหมด

ผลการทดสอบจะปรากฏขึ้นเมื่อการทดสอบเสร็จสิ้น สถานะของการดําเนินการของชุดทดสอบแต่ละรายการจะปรากฏถัดจากการทดสอบ (ผ่าน ไม่สําเร็จ)

แผงบันทึกจะแสดงสถานะของการดําเนินการทดสอบแต่ละรายการ

ผลการทดสอบ

หากต้องการทดสอบแผนทดสอบอีกครั้งจากหน้าสภาพแวดล้อมการทดสอบ ให้คลิกทดสอบอีกครั้งที่ด้านบนหลังจากดําเนินการทดสอบเสร็จสิ้นแล้ว

เมื่อดําเนินการเสร็จแล้ว

ดูและตีความผลการทดสอบ

ในหน้าประวัติการทดสอบใน Test Suite คุณสามารถดูผลการทดสอบก่อนหน้าสําหรับแผนการพัฒนาหรือแผนการทดสอบการรับรองที่ไม่ได้ส่งได้โดยคลิกทดสอบอีกครั้งสําหรับแผนการทดสอบที่ต้องการในส่วนแผนการทดสอบ การดําเนินการนี้จะนําคุณไปยังหน้าสภาพแวดล้อมการทดสอบ ซึ่งแสดงผลลัพธ์ของการทดสอบดังกล่าว

ประวัติการทดสอบ

สําหรับแผนการรับรองที่ส่ง ให้คลิกผลลัพธ์ในส่วนบันทึกสําหรับการรับรองเพื่อดูรายงานผลการทดสอบ

หรืออาจเข้าถึงผลการทดสอบเวอร์ชันผสานรวมได้จากแท็บทดสอบใน Developer Console คลิกดูสําหรับประวัติการทดสอบของเวอร์ชันการผสานรวมที่ระบุในหน้านั้นเพื่อไปยังหน้าประวัติการทดสอบใน Test Suite

สถานะคอนโซล

สถานะของ Console ต่อไปนี้จะอยู่ในระยะทดสอบ

Section สถานะ คำอธิบาย ข้อกําหนด สิ่งที่ต้องทําต่อไป
พร้อมทดสอบ พร้อม การผสานรวมเวอร์ชันนี้พร้อมที่จะทดสอบแล้ว ไม่มีข้อมูล ทดสอบการผสานรวมเวอร์ชันนี้
พร้อมรับการรับรอง พร้อม การผสานรวมเวอร์ชันนี้ผ่านการทดสอบและส่งไปยังช่วงทดลองใช้หรือการรับรองภาคสนามได้

เวอร์ชันนี้มีการทดสอบและบันทึก

กรอบการทดสอบทั้งหมดที่ล้มเหลวจะมีเหตุผลรองรับให้ Google ตรวจสอบ

ทดสอบอีกครั้ง หากจําเป็น

การแก้ปัญหา

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

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

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

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

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

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

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

การแก้ปัญหานักต่อบลูทูธ

ค่า VID/PID ที่อุปกรณ์บีคอนควรตรงกับ VID/PID ที่ป้อนไว้ในโปรเจ็กต์ Developer Console ของคุณ - VID 0xFFF1-0xFFF4 สงวนไว้สําหรับการทดสอบ อาจใช้ได้กับการทดสอบค่าคอมมิชชันและการควบคุมพื้นฐาน แต่ใช้กับการทดสอบไม่ได้ - การทดสอบในสนาม - OTA

เมื่อใช้แอปวิศวกรรมบลูทูธ เช่น nRF Connect สําหรับอุปกรณ์เคลื่อนที่ คุณจะเห็น VID/PID ของอุปกรณ์บีคอนในช่องข้อมูลบริการ

ในภาพหน้าจอนี้จาก Android version of nRF Connect, you'll see the VID/PID is listed as 5A23FFFE in the last four bytes of the Service Data field. This indicates a VID of 5A23 and a PID of FFFE — both in little endian format.

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

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

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