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

Google Home Developer Console มีหน้าทดสอบซึ่งคุณสามารถกำหนดค่าและเรียกใช้การทดสอบกับการผสานรวม Matter โดยใช้ Google Home Test Suite Test Suite เป็นแอปพลิเคชันแยกต่างหากที่สร้างไว้ใน Developer Console เพื่อจัดการการทดสอบการผสานรวมทั้งหมด

อุปกรณ์สำหรับรหัสผู้ให้บริการและรหัสผลิตภัณฑ์ของการผสานรวมต้องได้รับการมอบหมายและพร้อมใช้งานใน Google Home app (GHA) สำหรับบัญชีที่ใช้กับ Developer Console จึงจะทดสอบได้ ดูข้อมูลเพิ่มเติมที่จับคู่อุปกรณ์ Matter

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ไปที่ Developer Console

  1. จากรายการโปรเจ็กต์ ให้คลิกเปิดถัดจากโปรเจ็กต์ที่คุณต้องการใช้งาน

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

  3. คลิกทดสอบเพื่อหาเวอร์ชันไม่มีของการผสานรวมที่ต้องการทดสอบ การดำเนินการนี้จะสร้างการผสานรวมเวอร์ชันใหม่

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

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

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

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

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

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

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

เรียกใช้แผนทดสอบ

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

ผลการทดสอบจะปรากฏขึ้นเมื่อการทดสอบเสร็จสมบูรณ์ สถานะของการดำเนินการชุดทดสอบแต่ละรายการจะปรากฏอยู่ข้างๆ (ผ่าน, ล้มเหลว)

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

ผลการทดสอบ

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

เมื่อดำเนินการเสร็จแล้ว ให้ทำดังนี้

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

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

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

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

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

สถานะของคอนโซล

สถานะของคอนโซลต่อไปนี้จะพบในระยะทดสอบ

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

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

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

ทดสอบอีกครั้ง หากต้องการ

การแก้ปัญหา

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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