بدء استخدام Matter

يتيح برنامج Home Developer من Google لمصنّعي الأجهزة ربط أجهزتهم المنزلية الذكية بمنظومة 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 في الإجراءات حسب الحاجة.

طريقة الإنشاء

لبناء جهاز متوافق مع Matter ويتكامل مع منظومة Google Home المتكاملة، عليك استخدام لوحة تطوير متوافقة مع Matter وحزمة تطوير البرامج (SDK) الخاصة بـ Matter.

أسهل طريقة للبدء هي الانتقال إلى دوراتنا التدريبية المبرمَجة. ننصحك بتجربة أحد الدروس البرمجية التالية على الأقل:

بعد ذلك، اطّلِع على قائمة الأجهزة المتوافقة للتأكّد من أنّ الأجهزة التي تنوي دمجها متوافقة مع منظومة Google Home المتكاملة. بعد ذلك، اطّلِع على قائمة التحقّق الخاصة بالمطوّرين للتعرّف على عملية التطوير بأكملها، بدءًا من إنشاء المشروع وحتى إطلاقه.

الأجهزة المتوافقة قائمة التحقّق الخاصة بالمطوّرين

التعريفات

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

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

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

مركز النشاط

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

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

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

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

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

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

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

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

الجدول: Matter أمثلة من مورّدي شرائح السيليكون

المورّد	النظام الأساسي	دعم "Thread"	الدليل
Bouffalo Lab	BL602
	BL702
Espressif	ESP32		اختبار OTA
Nordic Semiconductor	nRF52840 DK		اختبار OTA
NXP	حزمة تطوير IOTZTB-DK006
Realtek	Ameba D Series
Silicon Labs	EFR32MG24 Dev Kit
	EFR32MG Zigbee and Thread Starter Kit
Telink	TLSR9528		دليل مطوّري Matter من Telink
Texas Instruments	CC2652R7 LaunchPad development kit

رقم تعريف المورّد

بشكلٍ تلقائي، يمكنك استخدام أحد أرقام تعريف الأجهزة التي خصّصها التحالف لأغراض الاختبار. اختَر أحد الخيارات التالية: 0xFFF1 أو 0xFFF2 أو 0xFFF3 أو 0xFFF4.

لاستخدام معرّف VID خاص ببيئة الإنتاج كي يتم اعتماد عملية الدمج وإطلاقها، يجب أولاً أن تتحقّق Google من صحة المعرّف للتأكّد من أنّ التحالف قد أصدره لك.

يجب تنفيذ معرّف المورّد هذا في البرامج الثابتة لجهازك.

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

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

لا يمكن استخدام معرّف المورّد ومعرّف المنتج إلا مرة واحدة لعملية دمج واحدة. إذا أردت استخدام رقم تعريف المورّد (VID) أو رقم تعريف المنتج (PID) نفسهما في عملية الدمج، عليك إجراء أحد الإجراءَين التاليَين:

• عدِّل عملية الدمج باستخدام VID أو PID إلى VID أو PID مختلف.
• احذف عملية الدمج باستخدام VID أو PID.

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

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

معرّف المنتج

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

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

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

¹ يمكنك الاطّلاع على مفاتيح تشغيل/إيقاف الإضاءة لمعرفة تأثير ذلك في مفاتيح تشغيل/إيقاف الإضاءة.