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

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

กล่าวคือ ใน 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. คลิกทดสอบเพื่อดูการผสานรวมเวอร์ชันไม่มีที่ต้องการทดสอบ ช่วงเวลานี้ action จะสร้างเวอร์ชันการผสานรวมใหม่

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

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

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

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

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

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

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

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

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

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

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

ผลการทดสอบ

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

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

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

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

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

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

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

สถานะคอนโซล

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

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

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

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

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

การแก้ปัญหา

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

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

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

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

โปรดดูข้อมูลเพิ่มเติมในข้อมูลอุปกรณ์

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

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

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

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

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

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

ในภาพหน้าจอจาก nRF Connect เวอร์ชัน Android คุณจะเห็น VID/PID แสดงเป็น 5A23FFFE เริ่มตั้งแต่ไบต์ที่ 4 ของ ช่องข้อมูลบริการ ค่านี้ระบุ VID เป็น 5A23 และ PID เป็น FFFE — ทั้งในรูปแบบ Litle Endian

แอป BLE จะแสดงค่าในรูปแบบ endian เล็กๆ แต่จะแสดงค่า VID/PID ที่คุณป้อนลงในโครงการ Developer Console ของคุณเป็นบิ๊กเอนด์

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

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