بدء استخدام 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 ليعمل كجهاز توجيه حدود شبكة للأجهزة المتوافقة مع 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	TLSR9518
Texas Instruments	مجموعة أدوات تطوير CC2652R7 LaunchPad

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

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

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

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

لا يمكن إقران جهاز 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) ونوع الجهاز

		ما هي أنواع المستخدمين الذين يمكنهم إعداد الجهاز في منظومة 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 للمستخدمين، مع أنّ النظام قد يستخدمها. في معظم الحالات، يعني هذا أنّ السمات المعروضة من خلال هذه المجموعات غير مرئية للمستخدمين النهائيين:

¹ يمكنك الاطّلاع على مفاتيح الإضاءة التي تعمل بلمسة واحدة لمعرفة تأثير ذلك في مفاتيح الإضاءة التي تعمل بلمسة واحدة.