بدء استخدام 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 يعمل بالإصدار 20.04 من نظام التشغيل Ubuntu لإنشاء عيّنات من 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.

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

إضافات IDE المقترَحة لتطوير 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
اسبريسيف ESP32 الاختبار عبر الهواء
صناعة أشباه الموصلات في الشمال nRF52840 DK الاختبار عبر الهواء
عملة NXP مجموعة تطوير البرامج IOTZTB-DK006
Realtek سلسلة Ameba D
مختبرات السيليكون مجموعة أدوات مطوّري البرامج EFR32MG24
مجموعة أدوات Zigbee وThread للمبتدئين EFR32MG
تيلينك TLSR9518
آلات تكساس للآلات مجموعة أدوات التطوير CC2652R7 LaunchPad

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

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

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

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

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

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

معرّف المنتج

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

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

لا يظهر للمستخدمين بعد بعض مجموعات 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.

1 راجع مفاتيح إضاءة/تشغيل/إيقاف لمعرفة كيفية تأثير ذلك في مفاتيح إضاءة التشغيل/الإيقاف.