بدء استخدام Matter

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

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

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

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

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

كيفية الإنشاء

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

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

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

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

التعريفات

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

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

مركز ينفِّذ Thread Border Router للأغراض العامة للأجهزة المزوّدة بتقنية 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
	EFR32MG Zigbee and Thread Starter Kit
Telink	TLSR9518
Texas Instruments	مجموعة تطوير LaunchPad لشريحة CC2652R7

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

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

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

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

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

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

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

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

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

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

معرّف المنتج

يتم قراءة المعلومات عن الجهاز من Matter مجموعة المعلومات الأساسية. يجب أن يتطابق معرّف المنتج المشفَّر في برمجية ‎ الثابتة مع معرّف المنتج لعملية دمج Matter في "وحدة تحكّم المطوّر".

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

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

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