بدء استخدام Matter

يتيح برنامج مطوّري برامج Home من 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 وMatter حزمة تطوير البرامج (SDK).

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

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

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

التعريفات

تُستخدم المصطلحات التالية في هذه الوثائق:

جهاز توجيه الحدود
مركز ينفّذ جهاز توجيه الحدود Thread للأغراض العامة للأجهزة التي تستخدم Thread.
المحتوى الرئيسي
يجب توفُّر جهاز Google Nest متوافق، مثل Google Nest Hub (2nd gen). يجب توفّر موزّع للتحكّم في الأجهزة المزوّدة بـ Matter من خلال مساحات عرض أخرى، مثل Assistant وGHA والشاشات الذكية.
جهاز متوافق مع "Matter"
يشير هذا المصطلح إلى جهاز أو لوح تطوير تم تثبيت عليه إصدار Matter أو نموذج تطبيق تم تفعيلهما فيه.
الأجهزة الجوّالة
الهاتف الاختباري المستخدَم للمساعدة في الاقتران هذا الهاتف حاليًا هو هاتف Android.

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

إضافات IDE المقترَحة لتطوير معيار Matter

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

  1. مركز Google Hub مع Thread ليعمل كجهاز توجيه الحدود للأجهزة التي تستخدم شبكة Thread وكمسار تنفيذ محلي لتوجيه أهداف المنزل الذكي.
  2. جهاز جوّال (هاتف اختباري) يستوفي الحد الأدنى من المتطلبات:
    • Android O (الإصدار 8.1، المستوى 27 من واجهة برمجة التطبيقات أو الإصدارات الأحدث)
    • iOS (الإصدار 16.5 أو إصدار أحدث)
    • إمكانات البلوتوث منخفض الطاقة
  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
مجموعة أدوات بدء تشغيل Threads وZigbee 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
الإنتاج معتمَد في Alliance DCL وتتوفّر عملية الدمج في Developer Console

معرّف المنتج

تتم قراءة معلومات حول الجهاز من مجموعة المعلومات الأساسية في Matter. يجب أن يتطابق معرّف المنتج المُرمّز في البرامج الثابتة على جهازك مع معرّف المنتج الخاص بدمج Matter في Play 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 راجِع مفاتيح التشغيل/الإيقاف للتعرّف على كيفية تأثير ذلك في مفاتيح الإضاءة.