يسمح برنامج 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.
المتطلبات الأساسية
لدمج جهاز متوافق مع "Matter" بشكل كامل مع منظومة Google Home المتكاملة، يجب أن يكون لدى المطوِّر:
- هو مركز Google يتوافق مع Thread ليعمل كجهاز توجيه الحدود للأجهزة التي تستخدم Thread وكمسار تنفيذ محلي لتوجيه أهداف المنزل المزوّد بأجهزة ذكية.
- جهاز جوّال (هاتف تجريبي) يستوفي الحدّ الأدنى من المتطلبات:
- Android O (الإصدار 8.1، المستوى 27 لواجهة برمجة التطبيقات أو إصدار أحدث)
- iOS (الإصدار 16.5 أو إصدار أحدث)
- إمكانية تقنية BLE
- معرّف المورّد (VID) ومعرّف المنتج (PID) للجهاز الذي تم تفعيل Matter
- جهاز متوافق مع "Matter" يجب أن يكون هذا الجهاز أحد Matter أنواع الأجهزة المتوافقة مع منظومة Google Home المتكاملة، ويمكن أن يكون ضمن الأنواع التالية:
- منتجك الخاص والمشتمِل على برامج ثابتة متوافقة مع "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.
| ما هي أنواع المستخدمين الذين يمكنهم تكليف الجهاز بمنظومة 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، ولكن قد يستخدمها النظام. يعني هذا في معظم الحالات أن السمات التي تظهر من خلال هذه المجموعات لن تكون مرئية للمستخدمين النهائيين:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
1 راجع مفاتيح إضاءة/تشغيل/إيقاف لمعرفة كيفية تأثير ذلك في مفاتيح إضاءة التشغيل/الإيقاف.