بدء استخدام Matter

  إصدار معاينة مطوّر البرامج  

يسمح برنامج مطوّري البرامج في Google Home للشركات المصنّعة للأجهزة بربط أجهزتهم المنزلية الذكية بالمنظومة المتكاملة من Google Home. نعمل على توسيع مسار تنفيذ الإجراءات المنزلية الذكية مع إمكانية إضافة أجهزة تم تفعيل Matter إليها للإعداد باستخدام Google Home app (GHA) والتحكّم فيها باستخدام Google Assistant أو GHA أو الشاشات الذكية، مثل Google Nest Hub (2nd gen).

يوضّح هذا المستند طريقة البدء في إنشاء منصّة متوافقة مع Matter ودمجها في منظومة Google Home المتكاملة.

بنود إخلاء المسؤولية

في ما يتعلق بالإجراءات الموضّحة في معاينة مطوّري البرامج هذه لتطبيق Matter، يُرجى الانتباه إلى ما يلي:

• يجب أن يتضمّن الحساب المستخدَم للتطوير مركزًا واحدًا تم تفعيل Matter فيه للاختبار. يمكن أن يؤدي ربط عدة مراكز (Matter) تم تفعيلها في الوقت نفسه أو ربطها بالبنية نفسها أثناء الاختبار إلى سلوك غير متوقّع.
• تفترض كل الإجراءات استخدام جهاز يعمل بنظام التشغيل Linux يشغّل Ubuntu 20.04 لإنشاء نماذج Matter ووميضها، والتي اختبرتها Google. على الرغم من توافق أجهزة MacOS، ننصح باستخدام نظام التشغيل Linux. ويتم ذكر التعليمات الخاصة بنظام التشغيل Mac في الإجراءات عند الحاجة.

التعريفات

يتم استخدام المصطلحات التالية في جميع هذه المستندات:

جهاز توجيه الحدود

مركز يُنفِّذ جهاز توجيه الحدود Threadلأغراض عامة على الأجهزة التي تم تفعيل Thread عليها

المحتوى الرئيسي

جهاز Google Nest متوافق، مثل Google Nest Hub (2nd gen). يجب توفّر وحدة تحكّم للتحكّم في الأجهزة التي يتم تفعيل Matter عليها من خلال مساحات العرض الأخرى، مثل Assistant وGHA والشاشات الذكية.

جهاز متوافق مع Matter

جهاز أو لوح تطوير يحتوي على إصدار Matter متوافق مع نموذج أو تطبيق متوافق.

الأجهزة الجوّالة

الهاتف التجريبي المستخدَم للمساعدة في الإقران هذا الهاتف هو Android حاليًا.

المتطلبات الأساسية

لدمج جهاز متوافق مع Matter بالكامل مع منظومة Google Home المتكاملة، يجب أن يستوفي مطوّر البرامج ما يلي:

1. مركز تحكُّم Google متوافق مع سلاسل المحادثات ليعمل كجهاز توجيه الحدود مع الأجهزة المزوّدة بسلسلة محادثات كمسار محلي لتنفيذ توجيهات المنزل الذكي.
2. جهاز جوّال (هاتف اختباري) يستوفي الحدّ الأدنى من المتطلبات:
   • Android O (الإصدار 8.1، مستوى واجهة برمجة التطبيقات 27 أو إصدار أحدث)
   • iOS (الإصدار 16.5 أو إصدار أحدث)
   • إمكانات BLE
3. معرّف المورّد (VID) ومعرّف المنتج (PID) للجهاز Matter الذي تم تفعيله.
4. جهاز متوافق مع نظام التشغيل Matter ويجب أن يكون هذا الجهاز أحد أنواع أجهزة Matter المتوافقة حاليًا مع منظومة Google Home المتكاملة، ويمكن أن يكون:
   • منتجك مع برامج ثابتة مُفعّلة Matter
   • لوحة التطوير لمنصة مورّدين معتمَدة يمكن استخدامها كجهاز Matter معتمَد بشكل شامل. تتوفّر المنصّات التالية:

جدول: Matter أمثلة من مورّدي أشباه الموصّلات

المورّد	النظام الأساسي	الأدلة	دعم بقيمة Thread
مختبر بوفالو	BL602	لمحة سريعة للبدء
	BL702	لمحة سريعة للبدء
إسبريف	منصة ESP32	لمحة سريعة للبدء اختبار العبر الهواء
شبه عواصف نوردية	nRF52840 الدانمرك	لمحة سريعة للبدء اختبار العبر الهواء
NCP	مجموعة تطوير IOTZTB-DK006	لمحة سريعة للبدء
Realtek	سلسلة أميبا دي	لمحة سريعة للبدء
ميزات السيليكون الاختبارية	مجموعة أدوات EF32MG24 Dev	لمحة سريعة للبدء
	مجموعة EFR32MG Zigbee وThread Starter	لمحة سريعة للبدء
تيك لينك	TLSR9518	لمحة سريعة للبدء
آلات تكساس	مجموعة تطوير CC2652R7 LaunchPad	لمحة سريعة للبدء

معرّف المورّد

يمكنك استخدام أحد معرّفات VID التي خصّصتها CSA لأغراض الاختبار بشكل تلقائي. اختَر إحدى الطرق التالية: 0xFFF1 أو 0xFFF2 أو 0xFFF3 أو 0xFFF4.

لاستخدام معرّف المورّد (VID) للإنتاج بحيث يكون معتمدًا ودمجًا، يجب أولاً أن تتحقّق Google منه من أجل ضمان حصول محرّك البحث Google على هذا الرقم.

يجب تنفيذ معرِّف VID هذا في البرامج الثابتة على جهازك.

يمكن إقران جهاز Matter فقط بالمنظومة المتكاملة لخدمة Google Home في حالات معيّنة من معرّف المورّد ونوع الجهاز.

• لا يمكن استخدام معرِّف المورِّد (VID) التجريبي على جهاز مستهلك.
• يجب أن يكون CID للإنتاج صادرًا عن وكالة CSA. ستتأكّد Google من أنّك مالك معرّف المورّد هذا (VID) قبل أن تتمكّن من استخدامه في Google Home Developer Console. وبعد حدوث ذلك، ستتمكّن من إنشاء عمليات دمج لمعرّف الفيديو هذا (VID).
• لأغراض التطوير والتجربة الميدانية، يجب إنشاء مشروع في "Developer Console" مع دمج معرِّف المورِّد (VID) ومعرِّف المنتج (PID) المقابلين له. يجب أن يكون المستخدم الذي ي عبارة عن تشغيل الجهاز عضوًا في المشروع أو مدرجًا في قائمة مستخدمي التجربة الميدانية.
• لا يمكن للمستخدمين المستهلكين استخدام منتجك إلا بعد اعتماده من جانب CSA.

الجدول: معرّف المورّد (VID) وسيناريوهات إقران نوع الجهاز

		ما هي أنواع المستخدمين الذين يمكنهم استخدام الجهاز في منظومة Google Home المتكاملة؟
نوع معرِّف المورّد (VID)	شهادة VID وحالة دمج وحدة التحكّم	الإنتاج (المستخدمون المستهلكون)	التطوير (مطوّرو البرامج والمستخدمون في المرحلة التجريبية)
Test	ما مِن دمج في Developer Console (لا يمكن الاعتماد)
Test	الدمج مضبوط على Developer Console (لا يمكن اعتماده)
الإنتاج	غير معتمد، الدمج غير موجود في Developer Console
الإنتاج	غير معتمد، الدمج موجود في Developer Console
الإنتاج	معتمد في CSA DCL، وليس هناك دمج في Developer Console
الإنتاج	تم اعتماد الشهادة في CSA DCL ودمجها في Developer Console

معرّف المنتج

تتم قراءة المعلومات الخاصة بالجهاز من "مجموعة المعلومات الأساسية" Matter. يجب أن يتطابق معرّف المنتج المشفّر في البرامج الثابتة على جهازك مع معرّف المنتج لدمج Matter في Play Console.

الميزات غير المتوافقة

لم تظهر بعض مجموعات Matter للمستخدمين بعد، ولكن قد يستخدمها النظام. ويعني ذلك في معظم الحالات أنّ السمات التي يتم عرضها عبر هذه المجموعات لن تكون مرئية للمستخدمين:

جدول: Matter المجموعات التي لا تظهر للمستخدمين في منظومة Google Home المتكاملة

نوع المجموعة	المجموعات
Core	ربط 1 التصنيف تصنيف ثابت تصنيف المستخدم الإجراءات مفتاح المجموعة إعدادات الأقلمة أقلمة تنسيق الوقت أقلمة الوحدة إعداد مصدر الطاقة مصدر الطاقة مجموعات بيانات التشخيص (سجلات بيانات التشخيص، بيانات التشخيص العامة، بيانات تشخيص البرامج، بيانات تشخيص شبكة سلاسل المحادثات/بيانات تشخيص شبكة Wi-Fi وبيانات تشخيص شبكة إيثرنت) مزامنة الوقت اختيار الوضع
طلب الانضمام	المجموعات والمَشاهد غير متاحة مباشرةً. وتتوفّر وظائف مماثلة من خلال سلاسل الإجراءات. جميع مجموعات الوسائط. تتوفّر ميزة مكافئة من خلال Google Cast.

1 يُرجى الاطّلاع على مفاتيح التحكّم بالإضاءة/الإيقاف لمعرفة كيفية تأثير هذه الميزة على مفاتيح التشغيل والإيقاف.