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 ได้รับการทดสอบอีกครั้ง
ดูข้อมูลเพิ่มเติมได้ที่การกําหนดเวอร์ชันการผสานรวม
สร้างแผนการทดสอบ
เวอร์ชันการผสานรวมคือภาพรวมของการผสานรวมที่ไม่มีเวอร์ชัน ซึ่งหมายความว่าเมื่อคุณสร้างแผนการทดสอบเพื่อรับการรับรอง และเป็นเวอร์ชันการผสานรวม ข้อมูลเมตาทั้งหมดที่เกี่ยวข้องกับการผสานรวมนั้นจะต้องเป็นข้อมูลที่คุณต้องการใช้สําหรับการผสานรวมที่เปิดตัวแล้ว
ก่อนสร้างแผนการทดสอบเพื่อรับการรับรอง โปรดตรวจสอบว่าคุณได้ทําสิ่งต่อไปนี้
- สร้างโปรไฟล์บริษัทแล้ว
- ป้อนรหัสผู้ให้บริการที่ใช้งานจริง (VID) สําหรับการผสานรวม
- กําหนดการตั้งค่าและการสร้างแบรนด์
หากคุณดําเนินการกับการผสานรวมเหล่านี้ไม่ครบถ้วน เวอร์ชันการผสานรวมที่สร้างขึ้นสําหรับการทดสอบการรับรองจะผ่านการรับรองไม่ได้ คุณจะต้องสร้างเวอร์ชันใหม่ ซึ่งหมายความว่าต้องทําซ้ําขั้นตอนทดสอบ ทดลองใช้ และรับรอง
นอกจากนี้คุณต้องสร้างเวอร์ชันใหม่และเริ่มต้นใหม่ หากต้องการอัปเดตการสร้างแบรนด์ก่อนที่เวอร์ชันการผสานรวมจะได้รับการรับรอง
วิธีสร้างแผนทดสอบ
จากรายการโปรเจ็กต์ ให้คลิกเปิดข้างโปรเจ็กต์ที่ต้องการ
ในเมนูการนําทางด้านซ้ายของหน้า ให้ไปที่ Matter > ทดสอบ
คลิกทดสอบสําหรับเวอร์ชัน N/A ของการผสานรวมที่ต้องการทดสอบ ซึ่งจะสร้างการผสานรวมเวอร์ชันใหม่
เลือกประเภทการทดสอบของการทดสอบการพัฒนาหรือการทดสอบการรับรอง
- เลือกการทดสอบการรับรองหากคุณกําลังเตรียมการรับรองในระบบนิเวศของ Google
- ไม่สามารถใช้การทดสอบการพัฒนากับการรับรอง
คลิกทดสอบ หากหน้าจอแสดงข้อผิดพลาด "ไม่พบอุปกรณ์" แสดงว่าอุปกรณ์สําหรับการผสานรวมนี้ไม่ได้รับค่าคอมมิชชันในระบบนิเวศ ดูการแก้ปัญหาเกี่ยวกับการจับคู่สําหรับข้อมูลเพิ่มเติม
ในหน้าจอกําหนดค่าการทดสอบ ให้ระบุชื่อสําหรับการทดสอบและเลือกอุปกรณ์ที่คุณต้องการทดสอบจากรายการอุปกรณ์
คลิกปุ่มถัดไป: แผนการทดสอบ
ในหน้าสร้างแผนการทดสอบ ให้เลือกชุดทดสอบที่ต้องการในส่วนชุดทดสอบ
หากต้องการออกจาก 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
ตามลําดับ