What is Matter and what's the QR for?

Matter is the cross-vendor smart-home standard from the Connectivity Standards Alliance (CSA, formerly Zigbee Alliance), with founding backing from Apple, Google, Amazon, Samsung, and a long list of device makers. A Matter device works with any Matter-capable hub regardless of brand: an iPhone in HomeKit, a Google Nest Hub, an Amazon Echo, a Samsung SmartThings hub. The QR on the back of the device (or in the box, or on the rating label) is the onboarding code. Your phone's smart-home app scans it and the device gets commissioned into your Matter fabric, assigned an operational credential, joined to your network, and made addressable by every other Matter controller you have.

What's encoded inside the QR?

A Matter onboarding QR uses the MT: URI scheme followed by a Base38-encoded payload. Decoded, the payload contains: version (3 bits), vendor ID (16 bits, CSA-assigned per manufacturer), product ID (16 bits, manufacturer-assigned per model), custom-flow indicator (2 bits), discovery capabilities (8 bits: BLE / IP / soft AP / Wi-Fi PAF), discriminator (12 bits, used during discovery to disambiguate multiple unpaired devices), and a 27-bit passcode (the secret used in the PASE, Password-Authenticated Session Establishment, handshake). Optional TLV fields can extend the payload with serial numbers and rendezvous information.

Is it dangerous if someone photographs my Matter QR?

It depends on whether the device is already commissioned. Before commissioning: yes, somewhat. Whoever has the QR plus physical proximity (BLE range, or on the same Wi-Fi/Thread network) can commission the device into THEIR Matter fabric, locking you out until you factory-reset it. After commissioning: no. The QR's passcode is only used during the initial PASE handshake; once the device is paired, it's burned and the device only accepts operational credentials issued by your fabric. So the safe practice is: peel off and store the QR sticker before letting strangers (movers, repair people, AirBnB guests) into the home, or commission the device IMMEDIATELY when it's unboxed so the window is short.

How is a Matter QR different from a Wi-Fi QR?

Different layer, different purpose. A Wi-Fi QR (WIFI: scheme) tells your phone to join a specific Wi-Fi network, SSID, security type, password. A Matter QR (MT: scheme) tells your smart-home app to add a specific device to your home, vendor, model, discriminator, pairing passcode. The Matter device will then independently join Wi-Fi or Thread using credentials your hub passes to it during commissioning. They serve different layers of the same setup flow.

What about Thread Border Routers and Matter-over-Thread devices?

Many Matter devices (door locks, contact sensors, motion sensors, low-power bulbs) use Thread as their network instead of Wi-Fi. Thread is a low-power mesh radio. The Matter onboarding QR is the same regardless, vendor / product / discriminator / passcode. The commissioning hub (your Apple TV, Google Hub, Echo Hub) acts as a Thread Border Router, joining the device to your Thread network and exposing it on your Matter fabric so it's addressable from any controller in the home.

المعايير · تحويم جهاز Matter

QR لتسجيل أجهزة Matter

عند مسح QR على ظهر وحدة إضاءة ذكية أو منفذ ذكي أو مستشعر اتصال أو قفل باب يحمل شعار Matter، يمرّ هاتفك عبر مرحلة اتصال خمسية تضيف الجهاز إلى منزلك. QR يحمل كل ما يحتاجه مركز التحكم لتحديد الجهاز المحدّد، المصنّع، النموذج، مُميز جهازي، ورمز تعيين مؤقت، بالإضافة إلى قائمة بالطرق التي يمكن للجهاز الوصول بها عبر الهواء (BLE، Wi-Fi، Thread). إليك ما يتم تشفيره، وما يُعَدّل، ولماذا يُهم QR بطريقة لا تُهمها QR Wi-Fi.

التحقق من كود Matter QR → جميع المعايير →

ما هو المعيار

تم نشر Matter بواسطة الائتلاف العالمي للمعايير (CSA)، سابقًا ائتلاف Zigbee، بدعم من Apple، Google، Amazon، Samsung، Comcast، وقائمة طويلة من مصنعي الأجهزة. تم إصدار Matter 1.0 في أكتوبر 2022؛ Matter 1.4 هو الإصدار الحالي اعتبارًا من منتصف 2026، مع إضافة كاميرات، إدارة الطاقة، شواحن السيارات الكهربائية، وأجهزة إدارة المياه منذ إصدار 1.0. تغطي المواصفة بروتوكول طبقة التطبيق، والأمان، والتسجيل، وتنسيق دخول QR.

يُعتبر تنسيق رمز QR للتسجيل جزءًا من المواصفة الأساسية Matter، "قسم حمل البيانات". هناك ثلاثة أشكال من نفس البيانات:

رمز QR يحمل مسبوقًا بـ MT: ثم بيانات مُشفرة Base38. هذا هو ما يفضل معظم التطبيقات لأنه أسرع.
رمز التجميع اليدوي، سلسلة عددية بطول 11 رقمًا في حالات تكون رمز QR مُتضررًا أو الجهاز صغير جدًا للQR. يمكنك إدخاله.
خيط NFC يحمل نفس البيانات المُشفرة Base38. أقل شيوعًا على أجهزة المستهلكين ولكن يُستخدم بشكل متزايد على قفل ذكية حيث أن الضغط للربط أكثر ملاءمة.

كلها تشفّر نفس الحقول باستخدام نفس نموذج الثقة، ويمكن استبدالها من وجهة نظر التسجيل.

ما داخل QR بالفعل

الشحنة بعد الـ MT: تُفكّر إلى هيكل ثنائي معبأ. الحقول الإلزامية:

الإصدار (3 بت)

يكون دائمًا 0 للأجهزة الحالية. مُحجوز لتحسينات بروتوكولات مستقبلية.

معرف المصنّع (16 بت)

مُعرف مُخصص من قبل CSA للمصنّع. يحصل كل منظمة عضو على مُعرف مُ уникаلي؛ 0xFFF1–0xFFF4 مُحجوز لاختبار / التطوير. يحلّ مُسحّرنا معرف المصنّع ضد سجل CSA عند التعرف عليه.

معرف المنتج (16 بت)

معرف مخصص من قبل المصنّع للنموذج المحدد. مع معرف المورّد، يُحدد هذا المعرف SKU فريد (مثال: "Eve Energy 2nd gen").

تدفق مخصص (2 بت)

0 = التحويم القياسي (التوصل فقط)، 1 = يتطلب تفاعل المستخدم (مثال: الضغط على زر الجهاز أولاً)، 2 = تدفق مخصص (خطوات إعداد مصنّعة). يحدد ما يظهره تطبيق مركزيك.

مهارات الاكتشاف (8 بت)

تجميع بتات يحدد كيف يمكن اكتشاف الجهاز في حالة غير محوّم: BLE (الأكثر شيوعًا)، على شبكة Wi-Fi (уже على شبكة Wi-Fi أو Ethernet، نادر في إعدادات المستهلك)، Soft-AP (يخلق الجهاز شبكة Wi-Fi مؤقتة)، Wi-Fi PAF (اكتشاف إعلانات عامة، جديد).

مميز (12 بت)

مُعرّف قصير يُعلن به الجهاز أثناء الاكتشاف ليمكن لمركزيك اختيار الجهاز الصحيح عند وجود عدة أجهزة في نطاق BLE. غير سري، هو الإشارة "هذا هو الجهاز الذي فكناه".

شفرة مرور (27 بت)

السر المشترك المستخدم في عملية التوصيل. يثبت الهاتف للجهاز أنه يملك هذه الشفرة دون إرسالها عبر الهواء بشكل نصي. بمجرد إكمال التحويم، تصبح الشفرة غير مفيدة. النطاق: 1 إلى 99,999,998 (بعض القيم محظورة لتجنب الشفرات المُستعرضة بسهولة مثل 11111111).

مُمتد TLV (اختياري، مُتغير)

الحقول الاختيارية يمكن أن تمتد الشحنة بتحديث معلومات الاتصال بالجهاز والرقم التسلسلي وخصائص مصنّعة أخرى. معظم الأجهزة الاستهلاكية تتجاهل هذه.

الاتصال التمهيدي (لماذا تصميم رمز QR مهم)

ممر تعيين Matter هو PASE → CASE:

الاكتشاف. هاتفك يرسل مسحًا لـ BLE (أو يستمع على Wi-Fi محلي)؛ الجهاز غير المُعيّن يُعلّن بـ discriminator. هاتفك يجد discriminator من QR.
PASE، إنشاء جلسة مصادقة مُعَدّة بالكلمة السرية. هاتفك وجهازك يجرون يدويّة PASE2+ باستخدام رمز QR الـ 27 بت. بعد إكمال PASE2+، يمتلك الطرفان مفتاح جلسة مشترك، ورمز QR نفسه لا يمر عبر الهواء.
التحقق. يعرض الجهاز شهادة التحقق من الجهاز (DAC) الموقعة من جذر معتمد من CSA. تحقق مركز التحكم أن الجهاز هو جهاز Matter حقيقي مع معرف المصنّع والمنتج المُعلّن.
凭据 الشبكة. يمرّر مركز التحكم للجهاز بيانات الشبكة المُعملية (كلمة سر Wi-Fi أو بيانات الشبكة Thread) اللازمة للاتصال الفعلي.
CASE، إنشاء جلسة مصادقة مُعَدّة بالشهادة. تصدر شبكة التحكم شهادة عمل للجهاز. من الآن فصاعدًا، يُصادق كل مُتحكم في الشبكة على الجهاز عبر CASE؛ رمز QR مُحذّف.

الخصائص الرئيسية: رمز QR هو مصادقة مؤقتة، لا هووية طويلة الأمد. بمجرد تعيين الجهاز، ضع لصق QR في سلة (أو قصه وحذّفه). إعادة التعيين تتطلب إما الوصول الجسدي لمسح الجهاز بشكل أصلي، أو تعاون من الشبكة الحالية لإصدار نافذة تعيين جديدة.

نموذج التهديد: التقاط رمز QR غير مُزامن للجهاز

مميزة لـ Matter، يكون الرمز QR مهما من حيث العمليات قبل التسجيل. مقارنة مع فئات أخرى:

رمز QR Wi-Fi يُعدّل كلمة المرور ولكن الانضمام إلى الشبكة هو إجراء "ضعيف"، يحتاج المهاجم إلى أن يكون في نطاق جسدي.
رمز QR للتأشيرات يُعدّل مرجع الحجز ولكن المهاجم يحتاج إلى اسم العميل الأخير وقناة منفصلة.
رمز قار QR + الاتصال الجسدي (BLE / نفس Wi-Fi) = التسجيل الكامل. يستطيع المهاجم إدراج الجهاز ضمن نسيجهم، مما يمنعك من الوصول حتى تقوم بإعادة الضبط إلى المصنع. بالنسبة لقفل ذكي، هذه حالة خطيرة.

السيناريوهات الواقعية التي تهم هذه المسألة:

المovers، العمال المصلحين، ضيوف AirBnB مع رؤية مباشرة لجهاز غير مُزامن وغير مُزامن.
مبيعات العودة / إعادة التصنيع حيث يتم إرجاع الجهاز إلى المصنّع أو المشتري في السوق مع شريط QR سليم وعدم إعادة الضبط إلى المصنع.
صور عبوات الأجهزة الجديدة المُشاركة على وسائل التواصل الاجتماعي (المنشور "أنا حصلت على قفل Matter الخاص بي!" مع ظهور الرمز QR).
التركيبات العامة (الإنارة الذكية التجارية، غرف فنادق) حيث يكون الرمز QR ملتصقًا بالجهاز وقابل للوصول لأي شخص باستخدام BLE.

الدفاع: قم بتسجيل الجهاز فور فتح العبوة (يغلق النافذة)، ثم ازيل الشريط واحرقه. بالنسبة للجهاز المُ triển في مساحات مشتركة / عامة، تأكد من تسجيله ضمن نسيج، مما يمنع التزام جديد بدون إعادة الضبط إلى المصنع.

ما الذي يظهره ماسحنا لك

الآن، أرفق رمز QR Matter (صورة، لصق، أو كاميرا) في ماسحنا. سيُظهر لك النتيجة:

النسخة، وهي دائمًا 0 في الوقت الحالي.
رقم المُصنِّع، واسم الشركة المصنعة المحدَّد إذا كانت الشركة مسجلة لدى CSA.
رقم المنتج، ونصائح فئة الجهاز إذا أمكن تحديدها.
التدفق المخصص، المعيار / التصرفات المستخدم / المخصص.
القدرات على الاكتشاف، التي تحدد الإشعارات التي يرغب الجهاز في استخدامها للاكتشاف.
المُميِّز، هوية الاكتشاف (غير سرية).
الكلمة السرية، مخفية بشكل افتراضي (اضغط للحصول على المجال السري). مفيدة لكتابة رمز التجميع اليدوي إذا كان رمز QR غير قابل للقراءة، وخطيرة إذا لم يكن QR لك.

نحن لا نتصل بالخادم الخاص بك أو نحاول التسجيل. يتم فك الشفرة محليًا؛ فقط البيانات الوصفية تصل إلى خادمنا لتصنيف السلامة.

قبل تحويم جهاز Matter غير المعروف

هل تعرف من شحن هذا الجهاز؟ إذا اشتريته مستعملًا أو كان مثبتًا بالفعل عند استلامك المنزل، قم بإعادة ضبطه إلى حالته المصنعية قبل التحоيم. قد لا يزال يحتفظ مالك سابق ببيانات دخول.
هل يتطابق معرف المورّد مع العلامة التجارية على العلبة؟ يُستخدم أجهزة Matter المُزيفة معرفات مورّدين اختبارية (0xFFF1–0xFFF4) لأن الاشتراك الحقيقي في CSA يتطلب دفع مال. لدينا ماسح يُحدد هذه المعرفات الاختبارية.
هل يتطابق شرط التدفق المخصص مع التوقعات؟ جهاز يتطلب تدفقًا مخصصًا (الشرطة = 2) عند كتابة العلبة "المسح للتوصل" هو مثير للشك.
هل تحويمك في مكان موثوق؟ يمكن للجيران في نطاق BLE التصوير للحصول على جهاز غير محوّم. قم بالتحويم في المنزل، وليس في مقهى، مع إطفاء Wi-Fi وتفعيل BLE فقط لضمان اكتشاف غير مُضطرب.
بعد التحويم، افصح عن الورقة الملصقة واحفظها. الشفرة مرتبطة، لكن معلومات المميز + المورّد + المنتج كافية للخوارزمية لسرقة الأجهزة في المنزل.

المتعلقة

التحقق من كود QR لتسجيل جهاز Matter

الصق الكود (صورة، لصق، أو كاميرا). يُظهر التقرير معرف المورّد، المنتج، المميز، المهارات، وشفرة مرور مُخفي. لا نتحدث إلى مركزيك ولا نحاول التحويم، فإن التشفير محلي وتحصل فقط على البيانات المُسجّلة في المُصنّف الآمن.

فتح المسح →