NT4H NTAG® 424 DNA Tag Read/Write Software

تشير أمثلة التعليمات البرمجية المصدر للبرامج الموضحة في هذه الصفحة إلى حلول تقنية NFC NTAG® DNA. الغرض الأساسي منه هو كتابة وقراءة علامات NTAG 413 DNA و NTAG 424 DNA ، أي NXP NTAG®®® Type 4 Tag.

هذه العلامات متوافقة تماما مع:

• ISO / IEC 14443 ، جميع الأجزاء من 1 إلى 4 ، اختيار ملف ISO / IEC 7816-4 ومعالجة APDU ، والهدف السلبي المتوافق مع ISO / IEC18092
• UID 7 بايت (وفقا لمعيار ISO/IEC 14443 – 3)
• NFC Forum Tag 4 Type تكوين بنية البيانات الفنية و NDEF

ومع ذلك ، فإن السبب الرئيسي لاختيار علامات NTAG® 424 DNA بين جميع أنواع عائلات NTAG هو دعمها الأمني المتقدم. توفر علامات الحمض النووي NTAG® 424 طرق أمان متقدمة ، مثل:

• تشفير AES-128 القياسي للمصادقة / المراسلة الآمنة ، أو تشغيل AES المغلف LRP لمقاومة أقوى للهجوم
• 3-تمرير المصادقة المتبادلة للوصول إلى ملف البيانات المحمية
• رسالة NFC فريدة آمنة (SUN)
• صنابير NFC تزايدية عداد
• اتصال عادي و CMAC ومشفر (قابل للتكوين)
• توقيع أصالة NXP المستند إلى ECC
• تجميع عناوين URL للعناصر على الرقاقة مع مرايا ASCII مرنة.

وفقا لذلك ، يتضمن مثال البرنامج الخاص بنا وظائف جميع بروتوكولات أمان NTAG® 424 DNA وتنفيذ الخيارات.

مستندات واجهة برمجة التطبيقات

تنزيل البرنامج

نظرة عامة على البرنامج

وظائف البرنامج:

• الحصول على إعدادات الملفات وتحريرها
• احصل على UID
• تعيين معرف عشوائي
• تغيير مفتاح AES
• قراءة/كتابة خطية (ASCII و HEX)
• وضع المصادقة ثلاثي المستويات
• SDM (رسالة ديناميكية آمنة) قراءة / كتابة
• احصل على عداد قراءة SDM
• قم بتخزين مفتاح AES في القارئ
• قفل / إلغاء قفل القارئ
• خيارات القارئ المتقدمة (حدد منفذ Reader COM وعنوان IP و SN وما إلى ذلك)

لغات البرمجة المتوفرة:

• C (وحدة التحكم)
• C# (واجهة المستخدم الرسومية)

أنظمة التشغيل والأنظمة الأساسية والبيئات المدعومة:

• عبر منصة

العلامات والتسميات والبطاقات المدعومة:

• NXP NTAG® 21x (210 ، 213 ، 215 ، 216 ، مكبس العلامات)
• NXP NTAG® 4xx الحمض النووي (413 ، 424)

الأجهزة الموصى بها:

• μFR نانو
• μFR نانو أون لاين
• μFR كلاسيك
• μFR كلاسيك CS
• μFR أدفانس
• μFR XL

1. برنامج NT4H – وحدة تحكم C – قارئ مفتوح

تحميل: ufr-examples-c-nt4h

تم تصميم NT4H لمعالجة سلسلة علامات NXP NTAG® الجديدة. تتضمن هذه السلسلة NTAG 413 DNA و NTAG® ®424 DNA. NTAG® 424 DNA متوافق تماما مع NFC Forum Type 4 Tag IC. وهو يدعم عملية تشفير AES-128 ورسالة NFC فريدة آمنة جديدة (SUN). لا توصي NXP باستخدام علامات NTAG 413 DNA للمشاريع الجديدة نظرا لأن NTAG®® 424 DNA المتاح يوفر ميزات أمان أفضل.

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

• الخيار 1 – يفتح منفذ القارئ باستخدام الخيارات الافتراضية (الكشف التلقائي) (تستخدم عادة لقارئ USB واحد متصل بالمضيف)
• الخيار 2 – يفتح منفذ القارئ باستخدام معلمات قابلة للتكوين يدويا: reader_type و port_name و port_interface والوسيطة.

2. برنامج NT4H – وحدة التحكم C – القائمة الرئيسية

هنا هو عرض وضع فتح القارئ البسيط. 
تحديد خيار القائمة 1. سيفتح منفذ القارئ ويقيم اتصالا بالجهاز. عند إنشاء الاتصال ، تعرض وحدة التحكم القائمة الرئيسية مع جميع وظائف البرنامج المدرجة. 

2.1 NT4H البرمجيات – وحدة التحكم C – الحصول على إعدادات الملفات

تعرض الوظيفة الأولى ، الحصول على إعدادات الملف ، إعدادات الملف المحددة. بناء على العلامة التي تستخدمها، اكتب 1 -2 ل NTAG413 و1-3 ل NTAG 424.

يحتوي NTAG413 على ملفين قياسيين للبيانات:

• يشير الملف رقم 1 إلى ملف حاوية القدرة (32 بايت) ،
• يشير الملف رقم 2 إلى ملف NDEF (128 بايت).

يحتوي NTAG424 على ثلاثة ملفات بيانات قياسية:

• يشير الملف رقم 1 إلى ملف حاوية القدرة (32 بايت) ،
• يشير الملف رقم 2 إلى ملف NDEF (256 بايت) ،
• يشير الملف رقم 3 إلى ملف الملكية (128 بايت) ،
• عدد المعلمات التي تم إرجاعها متغير.

إذا كان الملف الحالي عبارة عن ملف بيانات قياسي مع مراسلة AES الآمنة، تطبيق ما يلي:

• نوع الملف
• وضع الاتصال
• حقوق الوصول إلى الملفات.

مثال على حجم الملف:

• رقم الملف = 3 (ملف الملكية NTAG424)
• حالة وضع الاتصال المشفرة (0x03)
• تم تعطيل المراسلة الديناميكية الآمنة
• رقم مفتاح القراءة هو 2 ، رقم مفتاح الكتابة هو 3 ،
• الرقم الرئيسي للقراءة / الكتابة هو 3 ،
• رقم المفتاح لإعدادات تغيير الملف هو 0 ،
• حجم الملف هو 128 بايت.

إذا كان الملف الحالي عبارة عن ملف بيانات قياسي مع مراسلة ديناميكية آمنة ، فإنه يحتوي على المزيد من البيانات.

المثال:

• رقم الملف هو 2 (ملف NDEF) ،
• تم تمكين المراسلة الديناميكية الآمنة ،
• الوصول إلى القراءة والكتابة مجاني (المفتاح 0x0E) ،
• حجم الملف هو 256 بايت ،
• تم تمكين انعكاس UID ،
• تم تمكين عداد قراءة SDM ،
• تم تعطيل حد عداد قراءة SDM ،
• تم تنشيط جزء البيانات المشفرة من الملف ،
• الرقم الرئيسي ل SDM Meta Read هو 2 (UID ، عداد قراءة SDM ، بيانات PICC ، MAC) ،
• جزء البيانات المشفرة من رقم مفتاح الملف هو 2.
• يمكن قراءة عداد قراءة SDM بدون مصادقة ،
• إزاحة بيانات PICC (UID المشفر وعداد قراءة SDM) هو 49 ،
• إزاحة إدخال MAC هي 86 ،
• جزء البيانات المشفرة من إزاحة الملف هو 86 ،
• جزء البيانات المشفرة من طول الملف هو 32 ،
• إزاحة MAC هي 124.

2.2 برنامج NT4H – وحدة التحكم C – ضبط إعدادات الملفات

لإضافة إعدادات الملف ، حدد خيار القائمة الثاني. نظرا لعدد كبير من المعلمات ، هناك وظيفتان لإعدادات معلمات الملف.

ملف البيانات القياسي:

• الملف رقم 3 (ملف الملكية) ،
• يتم تشفير وضع الاتصال الحالي ،
• تغيير قيمة المفتاح هي 0.

الإعدادات الجديدة هي:

• وضع الاتصال العادي ،
• قراءة المفتاح 2 ،
• مفتاح الكتابة 3 ،
• مفتاح القراءة / الكتابة 3 ،
• تغيير المفتاح 0 ،
• وضع مصادقة المفتاح المقدم.

ملف المراسلة الديناميكية الآمنة:

• رقم الملف هو 2 ،
• وضع الاتصال عادي,
• قراءة المفتاح هو 14 ،
• مفتاح الكتابة هو 14 ،
• مفتاح القراءة / الكتابة هو 14 ،
• تغيير قيمة المفتاح هي 0 ،
• تم تمكين انعكاس UID ،
• تم تمكين عداد قراءة SDM ،
• تم تعطيل عداد القراءة SDM ،
• تم تنشيط جزء البيانات المشفرة من الملف ،
• مفتاح قراءة ميتا SDM هو 2 ،
• قراءة ملف SDM هي 2 ،
• مفتاح عداد قراءة SDM هو 2 ،
• إزاحة بيانات PICC المشفرة 49 ،
• ماك إدخال البيانات إزاحة 86 ،
• إزاحة جزء البيانات المشفرة 86 ،
• ماك إزاحة 124.

2.3 برنامج NT4H – وحدة التحكم C – احصل على UID (NTAG 424 فقط)

إذا كنت تستخدم علامات NTAG® 424 مع تمكين وضع أمان المصادقة ، فإن خيار القائمة 3. سيعرض العلامة UID.

تقوم الدالة بإرجاع UID للبطاقة 7 بايت. من المفيد إذا تم تنشيط خيارات المعرف العشوائي. مطلوب مصادقة صالحة مع أي مفتاح بطاقة.

2.4 برنامج NT4H – وحدة التحكم C – تعيين UID عشوائي (NTAG® 424 فقط)

يسمح NTAG® 424 DNA بأمان إضافي للعلامة من خلال إعداد UID العشوائي (خيار القائمة 4).
تعيين UID عشوائي يستبدل UID فريد 7 بايت مع UID عشوائي 4 بايت. وبالتالي ، ترجع العلامة UID عشوائيا 4 بايت في كل قراءة. ترجع العلامة الآن معرفا عشوائيا 4 بايت بدلا من معرف فريد 7 بايت.
تتطلب هذه الوظيفة مصادقة المفتاح الرئيسي (رقم 0).

تحذير: هذه العملية لا رجعة فيها!

2.5 برنامج NT4H – وحدة التحكم C – تغيير مفتاح AES

يسمح خيار القائمة 5 بتغيير مفتاح AES.
تتطلب هذه الوظيفة مصادقة المفتاح الرئيسي (رقم 0).
أدخل مفتاح AES الجديد عن طريق كتابة 16 بايت سداسي عشري.
إذا لم يكن المفتاح المراد تغييره مفتاحا رئيسيا، فإن قيمة المفتاح السابقة إلزامية.

مثال على تغيير مفتاح AES:

• المفتاح رقم 4.
• 0x00000000000000000000000000000000 قيمة المفتاح الرئيسي للتطبيق
• قيمة المفتاح القديم 4 0x00000000000000000000000000000000
• 0x11111111111111111111111111111111 قيمة المفتاح 4 الجديد.

2.6 برنامج NT4H – وحدة تحكم C – قراءة خطية

تتضمن وظيفة القراءة الخطية وضع القراءة العادي والمشفر والمشفر. أيضا ، تسمح مصادقة قراءة المحتوى في وضع المفتاح المتوفر ووضع المفتاح الداخلي بالوصول إلى المحتوى إذا كانت العلامة محمية. بخلاف ذلك ، يمكن قراءة محتوى العلامة غير المؤمن دون إدخال المفتاح (الخيار: بدون مصادقة). ستعرض وحدة التحكم المحتوى القابل للقراءة في وضع المصادقة المحدد كرقم سداسي عشري وتدوين ASCI.

2.6.1 برنامج NT4H – وحدة التحكم C – القراءة الخطية

تتضمن وظيفة القراءة الخطية وضع القراءة العادي و mac (رمز مصادقة الرسالة) ووضع القراءة المشفرة. أيضا ، تسمح مصادقة قراءة المحتوى في وضع المفتاح المتوفر ووضع المفتاح الداخلي بالوصول إلى المحتوى إذا كانت العلامة محمية. وإلا، يمكن الوصول إلى محتوى العلامة غير المؤمن دون إدخال المفتاح (الخيار: بدون مصادقة). ستعرض وحدة التحكم المحتوى القابل للقراءة في وضع المصادقة المحدد كرقم سداسي عشري وتدوين ASCI.

تقرأ الوظيفة البيانات المسجلة للملف. المعلمات المطلوبة هي:

• رقم الملف،
• مفتاح الوصول للقراءة أو القراءة / الكتابة ،
• وضع الاتصال ،
• وضع المصادقة (إذا كان مفتاح القراءة هو 14 ، فحدد خيار بدون مصادقة) ،
• عنوان البدء (0 – الحد الأقصى للعنوان) ،
• طول البيانات.

2.7 برنامج NT4H – وحدة التحكم C – الكتابة الخطية

كما هو الحال مع وظيفة القراءة الخطية ، تسمح وظيفة الكتابة الخطية بثلاثة أوضاع اتصال وتنسيق سداسي عشري أو ASCII لكتابة المحتوى أيضا. أيضا ، ينطبق وضع المصادقة المحدد على المحتوى المسجل. 

تكتب الوظيفة البيانات في الملف. المعلمات المطلوبة هي:

• رقم الملف،
• مفتاح الوصول للقراءة أو القراءة / الكتابة ،
• وضع الاتصال ،
• وضع المصادقة (إذا كان مفتاح القراءة هو 14 ، فحدد خيار No Authentication ) ،
• عنوان البدء (0 – الحد الأقصى للعنوان) ،
• أدخل البيانات بتنسيق ASCII أو سداسي عشري.

2.8 برنامج NT4H – وحدة التحكم C – قراءة الرسالة الديناميكية الآمنة

تتيح المراسلة الديناميكية الآمنة (SDM) على علامات NT4H DNA ميزة SUN. يشير إلى النص (ASCII) في رسالة NDEF.
لتطبيق وظيفة قراءة الرسالة الديناميكية الآمنة ، قم بتمكين الملف الرسالة الديناميكية الآمنة. أيضا ، اضبط الوصول للقراءة على مجاني (المفتاح 14 – لا يوجد خيار مصادقة).

2.9 برنامج NT4H – وحدة التحكم C – كتابة الرسائل الديناميكية الآمنة

كما هو الحال مع قراءة الرسالة الديناميكية الآمنة ، بالنسبة لوظيفة كتابة الرسالة الديناميكية الآمنة ، قم بتمكين الملف الرسالة الديناميكية الآمنة. أيضا ، اضبط الوصول للقراءة على مجاني (المفتاح 14 – لا يوجد خيار مصادقة).

2.10 برنامج NT4H – وحدة التحكم C – احصل على عداد قراءة SDM

يوجد عداد قراءة الرسائل الديناميكية الآمنة فقط إذا تم تمكين ملف SDM. المصادقة مطلوبة أو غير مطلوبة، اعتمادا على إعداد الوصول إلى عداد القراءة SDM للملف.

2.11 برنامج NT4H – وحدة التحكم C – قم بتخزين مفتاح AES في القارئ

يمكن لجهاز القارئ تخزين 16 مفتاح AES بقيم فهرس من 0 إلى 15. هذا يعني أن مؤشر المفتاح قد يكون أي قيمة بين 0 و 15.

يوضح المثال كيفية تخزين المفتاح بقيمة 0 x 00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

يتم إلغاء قفل مفتاح AES المخزن في القارئ افتراضيا.

يمكنك قفل المفتاح المخزن بأي كلمة مرور 8 بايت.

مثل:
كلمة المرور 12345678

في حال كان المفتاح المخزن محميا بكلمة مرور (مقفل) ، فأنت بحاجة إلى إلغاء قفله من خلال توفير كلمة مرور 8 بايت.

مثل:
كلمة المرور 12345678

يقدم هذا الدليل مثال البرنامج بلغة البرمجة C. ومع ذلك ، فإن جميع برامج التعليمات البرمجية المصدر ذات الصلة بلغات البرمجة الأخرى تحتوي على نفس الوظائف. حيثما أمكن ، تم تطوير واجهة المستخدم الرسومية.
من فضلك ، تحقق من مستودع GitLab الخاص بنا للحصول على أمثلة التعليمات البرمجية المصدر المتاحة بلغات البرمجة الأخرى.

المنزل

منتجات الأجهزة

برنامج SDK