بدء استخدام 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 Matter في الوقت نفسه أو توصيلها بالبنية نفسها أثناء الاختبار إلى سلوك غير متوقّع.
  • تفترض جميع الإجراءات استخدام جهاز Linux يعمل بنظام التشغيل Ubuntu 20.04 لـ إنشاء نماذج 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 متوافقة مع معيار Thread لتكون بمثابة جهاز توجيه حدود للأجهزة المتوافقة مع معيار Thread ومسار تنفيذ غير مستند إلى السحابة لتوجيه الطلبات المتعلقة بالمنزل الذكي
  2. جهاز جوّال (هاتف الاختبار) يستوفي الحد الأدنى من المتطلبات:
    • ‫Android O (8.1، مستوى واجهة برمجة التطبيقات 27 أو إصدار أحدث)
    • ‫iOS (الإصدار 16.5 أو إصدار أحدث)
    • إمكانية استخدام البلوتوث المنخفض الطاقة (BLE)
  3. رقم تعريف المورّد (VID) ورقم تعريف المنتج (PID) للجهاز المتوافق مع معيار Matter
  4. جهاز متوافق مع معيار Matter يجب أن يكون هذا الجهاز أحد أنواع أجهزة Matter المتوافقة مع نظام Google Home، ويمكن أن يكون:
    • منتجك الخاص الذي يتضمّن برامج ثابتة متوافقة مع معيار Matter
    • أحد الأجهزة التالية Matter لاستخدامه في عملية التحقّق الشاملة:
الجدول: Matter أمثلة على أجهزة Matter من مورّدي السيليكون
المورّد النظام الأساسي Thread الدعم الدليل
Bouffalo Lab BL602
BL702
Espressif ESP32 اختبار التحديثات عبر الهواء
Nordic Semiconductor nRF52840 DK اختبار التحديثات عبر الهواء
NXP مجموعة تطوير IOTZTB-DK006 kit
Realtek Ameba D Series
Silicon Labs EFR32MG24 Dev Kit
EFR32MG Zigbee and Thread Starter Kit
Telink TLSR9528 دليل مطوّري أجهزة Matter من Telink
Texas Instruments مجموعة تطوير CC2652R7 LaunchPad

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

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

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

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

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

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

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

  • تعديل عملية الدمج باستخدام رقم تعريف المورّد أو رقم تعريف المنتج إلى رقم تعريف مورّد أو رقم تعريف منتج مختلفَين
  • حذف عملية الدمج باستخدام رقم تعريف المورّد أو رقم تعريف المنتج
الجدول: رقم تعريف المورّد (VID) ونوع الجهاز سيناريوهات الإقران
ما هي أنواع المستخدمين الذين يمكنهم ضبط الجهاز في منظومة Google Home المتكاملة؟
نوع رقم تعريف المورّد حالة اعتماد رقم تعريف المورّد وعملية الدمج في وحدة التحكّم الإنتاج
(المستهلكون)		 التطوير
(المطوّرون، Field Trial المستخدمون)
الاختبار بدون عملية دمج في Developer Console (لا يمكن اعتمادها)
الاختبار تتوفّر عملية الدمج في Developer Console (لا يمكن اعتمادها)
الإنتاج غير معتمَدة، لا تتوفّر عملية الدمج في Developer Console
الإنتاج غير معتمَدة، تتوفّر عملية الدمج في Developer Console
الإنتاج معتمَدة في قائمة الأجهزة المعتمدة (DCL) التابعة للتحالف، لا تتوفّر عملية الدمج في Developer ConsoleAllianceDeveloper Console
الإنتاج معتمَدة في قائمة الأجهزة المعتمدة (DCL) التابعة للتحالف وتتوفّر عملية الدمج في Developer ConsoleAllianceDeveloper Console

معرّف المنتج

تتم قراءة معلومات الجهاز من الـ Matter Basic Information Cluster. يجب أن يتطابق رقم تعريف المنتج المشفّر في البرامج الثابتة لجهازك مع رقم تعريف المنتج لعملية دمج 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.

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

التالي
قائمة التحقّق من مطوّري البرامج