يتيح برنامج المطوّرين في Google Home لصنّاع الأجهزة ربط أجهزتهم المنزلية الذكية بمنظومة 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 ونماذج 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 بالكامل مع منظومة 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 | |||
| 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.
- لأغراض التطوير وField Trial، يجب إنشاء مشروع وتكامل مع تركيبة VID وPID المقابلة في Developer Console. يجب أن يكون المستخدم الذي يُجري عملية تنشيط الجهاز إما عضوًا في المشروع أو مدرَجًا في قائمة مستخدمي Field Trial.
- لا يمكن للمستهلكين استخدام منتجك إلا بعد أن يحصل على شهادة اعتماد من العميل Alliance.
لا يمكن استخدام معرّفَي VID وPID إلا مرة واحدة لعملية دمج واحدة. إذا كنت تريد استخدام معرّف VID أو معرّف PID نفسهما في عملية الدمج، عليك إجراء أيّ مما يلي:
- عدِّل عملية الدمج باستخدام معرّف الجهاز أو معرّف الجهاز للبرنامج إلى معرّف جهاز أو معرّف برنامج مختلف.
- حذف عملية الدمج باستخدام VID أو PID
| ما هي أنواع المستخدمين الذين يمكنهم تفعيل الجهاز في منظومة Google Home المتكاملة؟ | |||
|---|---|---|---|
| نوع VID | حالة شهادة VID وحالة الدمج مع وحدة التحكّم | الإنتاج
(المستخدمون المستهلكون) |
التطوير
(المطوّرون، Field Trial مستخدم) |
| اختبار | لا يتوفّر دمج في Developer Console (لا يمكن اعتماده) | ||
| اختبار | يتوفّر الدمج في Developer Console (لا يمكن اعتماده) | ||
| الإنتاج | غير معتمَد، لا يتوفّر الدمج في Developer Console | ||
| الإنتاج | غير معتمَد، يتوفّر الدمج في Developer Console | ||
| الإنتاج | معتمَد في Alliance DCL، لا يتوفّر الدمج في Developer Console | ||
| الإنتاج | أن تكون معتمدة في Alliance DCL وأن يكون الدمج متوفّرًا في Developer Console | ||
معرّف المنتج
يتم قراءة المعلومات عن الجهاز من Matter مجموعة المعلومات الأساسية. يجب أن يتطابق معرّف المنتج المشفَّر في برمجية الثابتة للجهاز مع معرّف المنتج لعملية دمج Matter في "وحدة تحكّم المطوّر".
الميزات غير المتوافقة
لم يتم عرض بعض مجموعات Matter للمستخدمين بعد، إلا أنّه قد يستخدمها النظام. في معظم الحالات، يعني ذلك أنّ السمات المعروضة من خلال هذه المجموعات لا تظهر للمستخدمين النهائيين:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ اطّلِع على مفاتيح تشغيل/إيقاف الإضاءة لمعرفة مدى تأثير ذلك في مفاتيح تشغيل/إيقاف الإضاءة.