بدء استخدام 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 وفلاشها، والتي اختبرتَها 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 باستخدام بيئة تطوير متكاملة

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

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

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