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เวอร์ชันใหม่
ใช้ Test Suite ใน Developer Console เพื่อส่งผลการทดสอบเพื่อรับการรับรอง หากต้องการเรียกใช้ Test Suite เพื่อวัตถุประสงค์ในการทดสอบระหว่างการพัฒนา โปรดดูหน้า Google Home Test Suite สำหรับเวอร์ชันแบบสแตนด์อโลน
เวอร์ชันการผสานรวม
เมื่อคุณสร้างแผนการทดสอบเพื่อขอการรับรอง ระบบจะสร้างการผสานรวมเวอร์ชันใหม่ เวอร์ชันที่มีหมายเลขนี้จะแสดงในรายการการผสานรวมทั้งหมดใน 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 อีกครั้ง
ดูข้อมูลเพิ่มเติมได้ที่การผสานรวมกับการจัดเวอร์ชัน
สร้างแผนการทดสอบ
เวอร์ชันการผสานรวมคือภาพรวมของการผสานรวมที่ไม่มีเวอร์ชัน ซึ่งหมายความว่าเมื่อคุณสร้างแผนทดสอบเพื่อขอการรับรองและสร้างเวอร์ชันการผสานรวม ข้อมูลเมตาทั้งหมดที่เกี่ยวข้องกับการผสานรวมนั้นต้องเป็นข้อมูลที่ต้องการใช้สำหรับการผสานรวมที่เปิดตัวแล้ว
ก่อนสร้างแผนการทดสอบเพื่อขอการรับรอง โปรดตรวจสอบว่าคุณได้ทำสิ่งต่อไปนี้แล้ว
- สร้างโปรไฟล์บริษัท
- ป้อนรหัสผู้ให้บริการ (VID) เวอร์ชันที่ใช้งานจริงสำหรับการผสานรวม
- การตั้งค่าและการสร้างแบรนด์ที่กําหนดค่าแล้ว
หากคุณยังไม่ได้ดำเนินการทั้งหมดนี้สำหรับการผสานรวม ระบบจะรับรองเวอร์ชันการผสานรวมที่สร้างสำหรับการทดสอบการรับรองไม่ได้ คุณจะต้องสร้างเวอร์ชันใหม่ ซึ่งหมายความว่าจะต้องทำตามขั้นตอนทดสอบ การทดลองใช้จริง และการรับรองอีกครั้ง
นอกจากนี้ คุณจะต้องสร้างเวอร์ชันใหม่และเริ่มใหม่หากต้องการอัปเดตการสร้างแบรนด์ก่อนที่เวอร์ชันการผสานรวมจะได้รับการรับรอง
วิธีสร้างแผนการทดสอบ
- จากรายการโปรเจ็กต์ ให้คลิกเปิดข้างโปรเจ็กต์ที่ต้องการทำงานด้วย
- ในเมนูการนำทางด้านซ้ายของหน้า ให้ไปที่ Matter > ทดสอบ
- คลิกทดสอบสําหรับการผสานรวมเวอร์ชัน N/A ที่ต้องการทดสอบ การดําเนินการนี้จะสร้างการผสานรวมเวอร์ชันใหม่
- เลือกประเภทการทดสอบเป็นการทดสอบเพื่อพัฒนาหรือการทดสอบเพื่อขอการรับรอง แล้วคลิกทดสอบ
- เลือกการทดสอบเพื่อรับการรับรองหากกำลังเตรียมตัวรับการรับรองในระบบนิเวศของ Google
- การทดสอบเพื่อการพัฒนาใช้สำหรับการรับรองไม่ได้
ในหน้าจอกําหนดค่าการทดสอบ ให้ตั้งชื่อการทดสอบแล้วคลิกจับคู่อุปกรณ์โดยอัตโนมัติเพื่อเลือกอุปกรณ์ที่จะจับคู่
- สำหรับอุปกรณ์ Android
- ตรวจสอบว่าคุณได้ติดตั้ง GHA ในโทรศัพท์แล้ว
- เชื่อมต่อโทรศัพท์กับเครื่องโฮสต์ด้วยสาย USB
- คุณต้องเปิดใช้การแก้ไขข้อบกพร่อง USB ในอุปกรณ์
APKcom.chip.interop.moblysnippetจะดาวน์โหลดและติดตั้งโดยอัตโนมัติ - เมื่อโทรศัพท์เชื่อมต่อแล้ว ให้ป้อนรหัสการจับคู่และชื่ออุปกรณ์เพื่อจับคู่อุปกรณ์โดยอัตโนมัติ
- สำหรับอุปกรณ์ iOS: คุณจะต้องจับคู่อุปกรณ์ด้วยตนเอง ดูวิธีการจับคู่ด้วยตนเองได้ในส่วนแอป Google Home
- หากมีอุปกรณ์อยู่แล้ว ระบบอาจขอให้คุณยกเลิกการจับคู่อุปกรณ์แล้วจับคู่อีกครั้งหรือจับคู่อุปกรณ์ใหม่
คลิกปุ่มถัดไป: ทดสอบแผน
ในหน้าสร้างแผนการทดสอบ ในส่วนชุดทดสอบ ให้เลือกชุดทดสอบที่ต้องการเรียกใช้
หากต้องการออกจาก Test Suite ให้คลิก กลับไปที่ศูนย์นักพัฒนาแอป
เรียกใช้แผนการทดสอบ
ใน Test Suite ให้คลิกเรียกใช้การทดสอบจากหน้าสร้างแผนการทดสอบ หน้าสภาพแวดล้อมการทดสอบจะปรากฏขึ้นพร้อมสถานะและบันทึกการทดสอบทั้งหมด
ผลการทดสอบจะปรากฏขึ้นเมื่อการทดสอบเสร็จสมบูรณ์ สถานะของการเรียกใช้ชุดทดสอบแต่ละชุดจะปรากฏข้างชุดทดสอบ (ผ่าน ไม่ผ่าน)
แผงบันทึกจะแสดงสถานะของการเรียกใช้การทดสอบแต่ละรายการ
หากต้องการทดสอบแผนทดสอบอีกครั้งจากหน้าสภาพแวดล้อมการทดสอบ ให้คลิกทดสอบอีกครั้งที่ด้านบนหลังจากการทดสอบเสร็จสมบูรณ์
เมื่อดำเนินการเสร็จแล้ว ให้ทำดังนี้
- คลิกเสร็จสิ้นเพื่อไปที่หน้าประวัติการทดสอบ หรือ
- คลิกส่งเพื่อส่งผลลัพธ์การทดสอบเพื่อรับการรับรอง
ดูและตีความผลการทดสอบ
ในหน้าประวัติการทดสอบใน Test Suite คุณสามารถดูผลการทดสอบก่อนหน้าสำหรับแผนการพัฒนาหรือแผนการทดสอบเพื่อขอการรับรองที่ยังไม่ได้ส่งได้โดยคลิกทดสอบอีกครั้งสำหรับแผนการทดสอบที่ต้องการในส่วนแผนการทดสอบ ซึ่งจะนำคุณไปยังหน้าสภาพแวดล้อมการทดสอบที่แสดงผลการทดสอบ
สำหรับแผนการรับรองที่ส่งแล้ว ให้คลิกผลลัพธ์ในส่วนบันทึกไว้สําหรับการรับรองเพื่อดูรายงานผลลัพธ์การทดสอบ
นอกจากนี้ คุณยังเข้าถึงผลการทดสอบของเวอร์ชันการผสานรวมได้จากแท็บทดสอบในDeveloper Console คลิกดูประวัติการทดสอบของเวอร์ชันการผสานรวมที่แสดงในหน้านั้นเพื่อไปยังหน้าประวัติการทดสอบในTest Suite
สถานะคอนโซล
สถานะต่อไปนี้ของคอนโซลจะปรากฏขึ้นในระยะการทดสอบ
| Section | สถานะ | คำอธิบาย | ข้อกำหนด | สิ่งที่ต้องทำต่อไป |
|---|---|---|---|---|
| พร้อมที่จะทดสอบ | พร้อม | integration เวอร์ชันนี้พร้อมให้ทดสอบแล้ว | ไม่มี | ทดสอบ integrationเวอร์ชันนี้ |
| ทดสอบแล้ว | พร้อม | integration เวอร์ชันนี้ได้รับการทดสอบแล้วและสามารถส่งเพื่อขอField Trialหรือการรับรองได้ |
ทดสอบและบันทึกเวอร์ชันแล้ว กรณีทดสอบที่ไม่ผ่านทั้งหมดจะมีเหตุผลประกอบเพื่อให้ 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สงวนไว้สำหรับการทดสอบ อุปกรณ์เหล่านี้อาจใช้สำหรับการทดสอบการเริ่มต้นใช้งานขั้นพื้นฐานและการควบคุม แต่จะใช้ไม่ได้ในขั้นตอนการพัฒนาต่อไปนี้
เมื่อใช้แอปวิศวกรรมบลูทูธ เช่น nRF Connect for Mobile คุณจะเห็น VID/PID ของอุปกรณ์บีคอนในช่องข้อมูลบริการ
ในภาพหน้าจอนี้จาก nRF Connect เวอร์ชัน Android คุณจะเห็น VID/PID แสดงเป็น 5A23FFFE โดยเริ่มจากไบต์ที่ 4 ของช่องข้อมูลบริการ ซึ่งหมายถึง VID ของ 5A23 และ PID ของ FFFE โดยทั้ง 2 รายการอยู่ในรูปแบบ Little Endian
แอป BLE จะแสดงค่าในรูปแบบ Little Endian แต่ค่า VID/PID ที่คุณป้อนลงในโปรเจ็กต์ Developer Console จะอยู่ในรูปแบบ Big Endian
ตรวจสอบว่าได้ป้อนค่าและรูปแบบที่ถูกต้องลงในโปรเจ็กต์ Actions Console ตามข้อมูลพรอมต์ที่แสดงในโปรแกรมสนิฟเฟอร์บลูทูธ
สำหรับค่าในภาพหน้าจอตัวอย่าง VID และ PID ใน Developer Console จะเป็น 235A และ FEFF ตามลำดับ