ทดสอบการผสานรวม 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เวอร์ชันใหม่

ใช้ 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 อีกครั้ง

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

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

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

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

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

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

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

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

ไปที่คอนโซลนักพัฒนาซอฟต์แวร์

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

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

  3. คลิกทดสอบสําหรับการผสานรวมเวอร์ชัน N/A ที่ต้องการทดสอบ การดําเนินการนี้จะสร้างการผสานรวมเวอร์ชันใหม่

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

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

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

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

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

สร้างแผนการทดสอบ หากต้องการออกจาก Test Suite ให้คลิก กลับไปที่ศูนย์นักพัฒนาแอป

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

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

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

แผงบันทึกจะแสดงสถานะของการเรียกใช้การทดสอบแต่ละรายการ

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

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

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

ในหน้าประวัติการทดสอบใน 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 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 ตามลำดับ