ทดสอบการผสานรวม 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:

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

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

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

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

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

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

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

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

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

ไปที่ Developer Console

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

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

  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 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 ตามลำดับ