يُشحن وسم NFC فارغًا. وحتى يُكتب فيه شيء، لا تفعل النقرة شيئًا: لا تُفتح صفحة، ولا يعمل إجراء، ويكتفي الهاتف بالإبلاغ عن وسم فارغ. والبرمجة هي الخطوة الوحيدة التي تحوّل ملصق NTAG213 أو خاتمًا فارغًا إلى وثيقة اعتماد أو رابط عامل. ويغطي هذا الدليل ما تكتبه فعليًا، والأدوات المناسبة لعدد قليل من الوسوم مقابل بضعة آلاف، وقرارات القفل التي لا يمكن التراجع عنها، والنقطة التي يصبح عندها ترميز الوسوم لك أرخص.
Table of Contents
كيفية برمجة ملصقات NFC، خطوة بخطوة
لبرمجة ملصق NFC، افتح تطبيق كتابة NFC مثل NFC Tools أو NXP TagWriter، وأضف سجلًا (عادة رابط URL)، وابدأ الكتابة وأمسك الملصق مقابل هوائي NFC في الهاتف حتى يؤكد التطبيق.
- جهّز الهاتف. على Android، شغّل NFC وألغِ قفل الشاشة (أساسيات NFC في Android). وعلى iPhone 7 أو أحدث، يبدأ تطبيق الكتابة المسح عند النقر على «كتابة» (Write).
- أضف السجل. اختر URL والصق عنوان
httpsالكامل. - اكتب. أمسك الملصق ثابتًا مقابل الهوائي (عادة الجزء العلوي الخلفي على Android، والحافة العلوية على iPhone) حتى يؤكد التطبيق؛ فإتحريكه أثناء الكتابة قد يسبب أخطاء (استكشاف أخطاء NFC Tools).
- تحقق بهاتف مختلف، ويفضل هاتف Android وiPhone معًا.
- احمِه وضعه في موضعه. اتركه مفتوحًا، أو عيّن كلمة مرور، أو اقفله (انظر القفل وكلمات المرور)، ثم أعد الاختبار على السطح الحقيقي.
ما الذي تكتبه: NDEF
تخزن معظم وسوم NFC الاستهلاكية — وعائلة NTAG21x خصوصًا — رسالة NDEF (صيغة تبادل بيانات NFC (NFC Data Exchange Format)). وNDEF هو الحاوية التي تفهمها الهواتف: غلاف صغير يحمل سجلًا واحدًا أو أكثر، لكل منها نوع. وأنواع السجلات الشائعة هي URI (عنوان ويب)، أو سجل نصي، أو تكوين Wi-Fi، أو بطاقة جهة اتصال vCard.
والرابط URL هو السجل الذي ستكتبه في أغلب الأحيان، ويُخزن بكفاءة. فـ NDEF يستبدل مخططًا شائعًا ببايت بادئة واحد، فتكلف https:// بايتًا واحدًا بدلًا من ثمانية، ويحمل NTAG213 بذاكرة مستخدم 144 بايتًا عنوان ويب يصل إلى 132 حرفًا بعد https://www. بعد حساب تأطير السجل (NTAG213 مقابل NTAG215 مقابل NTAG216 يشرح البايتات). أما معلمات التتبع الطويلة أو بطاقة جهة اتصال كاملة فهي ما يدفع التصميم إلى NTAG215 أو NTAG216. وعائلات الشرائح وخرائط ذاكرتها مبينة على صفحة ملصق NTAG213؛ والمهم في البرمجة أنك تكتب رسالة منظمة، لا بايتات خام، وأن الهاتف لا يقرأ إلا سجل NDEF جيد التكوين. ولرؤية البايتات الدقيقة لرابطك أو نصك أو بطاقة جهة اتصالك، ومعرفة ما إذا كانت تناسب NTAG213 أو NTAG215 أو NTAG216، الصقها في مولّد NDEF وفاحص سعة الوسم.
أنواع سجلات NDEF: قاموس بيانات موجز
يحمل كل سجل NDEF صيغة اسم نوع (Type Name Format (TNF)) من 3 بتات في ترويسته تقول كيفية قراءة نوعه (مرجع Android NdefRecord):
| TNF | الاسم | يحمل |
|---|---|---|
| 0 | فارغ | لا شيء |
| 1 | معروف لدى NFC Forum | سجلات URI وText وSmart Poster |
| 2 | وسائط MIME | بيانات مسماة حسب نوع وسائط، مثل vCard |
| 3 | URI مطلق | URI مكتوب كاملًا في حقل النوع |
| 4 | نوع خارجي لدى NFC Forum | بيانات خاصة بتطبيق مسماة حسب نطاق |
| 5 | غير معروف | حمولة دون نوع |
| 6 | دون تغيير | جزء لاحق من سجل مقسوم |
ولنقرة تعمل على المنصتين، اكتب سجل URI واحدًا معروفًا مع عنوان https: فالقراءة في الخلفية على iPhone لا تستخدم إلا سجل URI الأول ولا تدعم مخططات URL المخصصة (Apple Core NFC).
لعدد قليل من الوسوم: تطبيق هاتف
لعشرة وسوم أو اختبار سريع، يكفي هاتف وأحد تطبيقين واسعي الاستخدام:
- NFC Tools (على Android وiOS) يقرأ الوسوم ويكتبها وينسخها، ويدعم كل أنواع السجلات الشائعة، ويمكنه قفل وسم أو حمايته بكلمة مرور.
- NXP TagWriter (على Android وiOS) يكتب مجموعات بيانات مثل روابط URL وإعدادات Wi-Fi والنصوص؛ كما أن إصدار Android يدرج أيضًا جهات الاتصال والحماية من الكتابة والكتابة المتسلسلة من مجموعات بيانات CSV.
وكلاهما تطبيقان من طرف ثالث. فـ Proud Tek تورد الوسوم وقارئات/كاتبات سطح المكتب والترميز، لكنها لا تورد تطبيقات هواتف أو برامج خاصة بها؛ ويأتي SDK القارئ من صانعه.
برمجة وسوم NFC على Android وiPhone
تكتب هواتف Android المزودة بـ NFC، التي يجب أن تدعم NDEF على وسوم NFC Forum Type 1–4 (Android Ndef)، وiPhone 7 أو أحدث، ملصقات وبطاقات NTAG من تطبيق. ويحتاج iPhone إلى iOS 13 أو أحدث لـ الكتابة، وتحتاج الإصدارات الحالية من NFC Tools وTagWriter إلى iOS 15.6. والفروق هي دعم MIFARE Classic والقراءة: فعادة ما يبحث Android عن الوسوم كلما كان قفل الشاشة ملغى وكان NFC مشغلًا، بينما يقرأ iPhone XS أو أحدث وسوم URL في الخلفية.
| الموضوع | Android | iPhone |
|---|---|---|
| MIFARE Classic | اختياري ويعتمد على العتاد (Android MifareClassic) | ليس من عائلات MIFARE في Core NFC (NFCMiFareFamily) |
| القفل الدائم من تطبيق | makeReadOnly() هي «عملية في اتجاه واحد» (Android Ndef) |
writeLock هو «إجراء دائم» (Apple) |
لكميات أكبر: قارئ سطح مكتب وبرنامج
بعد بضعة عشرات من الوسوم، يصبح الهاتف مملًا وعرضة للخطأ. فقارئ USB مكتبي مثل ACR122U أو قارئ مع SDK مجاني يُوصل بالكمبيوتر ويشفّر الوسوم من سكربت. ضع الوسم على القارئ، فيبلغ البرنامج عن UID ونوع الشريحة والذاكرة الحرة، وتنشئ سجل NDEF، وتكتب. والمكسب على الهاتف هو قابلية التكرار: إذ يمكن للسكربت أن يتكرر عبر CSV أو قاعدة بيانات، ويكتب رابط URL مختلفًا في كل وسم، ويسجل كل UID مقابل القيمة التي تلقاها، فيمكن تتبع عطل ميداني لاحق إلى كتابة محددة.
وهناك عادتان تؤتيان ثمارهما عند الكميات الكبيرة. اقرأ الوسم مرة أخرى بعد كل كتابة وقارنه بالبيانات المقصودة، بدلًا من الوثوق بأن الكتابة أعادت نجاحًا. وزوّد السكربت بـ رابط الإنتاج الكامل، بمعلمات UTM كلها — فالرابط المختصر التجريبي الذي يناسب ليس دليلًا على أن الرابط الحقيقي يناسب.
كيفية برمجة بطاقات NFC
لبرمجة بطاقة NFC، افتح تطبيق كتابة مثل NFC Tools أو NXP TagWriter، وأضف سجل URL، وأمسك البطاقة مسطحة مقابل هوائي NFC في الهاتف حتى يؤكد التطبيق. وتُكتب بطاقات NFC من نوع NTAG213 وNTAG215 وNTAG216 بهذه الطريقة على Android وiPhone. وهناك استثناءان:
- بطاقات MIFARE Classic ليست من نوع NFC Forum، لذا يكون دعم الهاتف متفاوتًا (الجدول أعلاه)؛ حدّد NTAG للبطاقات التي يجب أن تقرؤها الهواتف.
- بطاقات الوصول والفنادق والدفع غير النقدي يكتبها برنامج التسجيل أو المشفر الخاص بالنظام، بمفاتيحه وتخطيط بياناته. ونورد البطاقات ويمكننا ترميزها وفق تخطيط مزود نظامك، لكننا لا نورد الأقفال أو أنظمة التحكم في الوصول أو البرامج.
القفل وكلمات المرور
بعد الكتابة، تقرر ما إذا كان يمكن تغيير الوسم مجددًا. وتمنحك شرائح NTAG21x ثلاثة مستويات، أحدها دائم:
- اتركه مفتوحًا. يمكن لأي شخص معه هاتف NFC الكتابة فوق السجل. وهذا مناسب للوسوم الشخصية والاختبار؛ وغير حكيم لأي شيء يمكن لغريب الوصول إليه.
- الحماية بكلمة مرور. تدعم NTAG21x كلمة مرور 32 بت (PWD) مع إقرار 16 بت (PACK). ويجب أن يقدم القارئ كلمة المرور قبل قبول كتابة محمية، فيتمكن الموظفون المخولون من تحديث الوسم. وهذا هو الافتراضي الصحيح لمعظم عمليات النشر التجارية.
- القفل الدائم (بتات قفل OTP). يمكن ضبط بايتات القفل الثابتة والديناميكية لتجميد صفحات الذاكرة ضد أي كتابة لاحقة. وهذا لا رجعة فيه: فمتى ضُبط بت قفل لا يمكن مسحه، والوسم المقفل الذي يحمل رابط URL خاطئًا لا يمكن إلا استبداله.
عامل كلمة المرور كرادع ضد إعادة الكتابة العابرة، لا كمصادقة. فهي لا تفعل شيئًا لمنع نسخ سجل NDEF ثابت بايتًا ببايت إلى وسم آخر — فالنسخة تُقرأ بالطريقة نفسها. والمشروع الذي يجب أن يثبت أن كل نقرة جاءت من وسم أصلي يحتاج إلى شريحة تشفيرية مثل ملصق NTAG424 DNA، الذي يوقّع كل قراءة.
أخطاء شائعة
- كتابة بايتات خام بدلًا من NDEF. قد تحللها أدوات سطح المكتب؛ وتتجاهلها الهواتف. اكتب دائمًا رسالة NDEF منسقة.
- رابط URL أطول من سعة الشريحة. قِس السجل المشفر، لا الرابط الظاهر، وحجّم الشريحة وفقه.
- تخطي إعادة القراءة. تحقق بعد الكتابة؛ فأخطاء الكتابة نادرة لكنها ليست صفرًا عبر دفعة كبيرة.
- القفل بالخطأ. ضبط بتات القفل عندما كنت تقصد ضبط كلمة مرور هو الخطأ الوحيد الذي لا تراجع عنه. تحقق مرة أخرى من تكوين القفل قبل كل كتابة.
- اختبار السطح الخاطئ. يقرأ الملصق على طاولة العمل ويفشل على جسم معدني أو عبر غطاء. اختبر على السطح الحقيقي بالهواتف الحقيقية.
متى تطلب وسومًا مشفرة مسبقًا
يناسب الترميز الداخلي الكميات المنخفضة والوجهات التي تتغير كثيرًا. وبعد ذلك، فإن ترميز الوسوم قبل شحنها يزيل القارئ والسكربت وإعادة القراءة من عبء عملك. وعندما نشفّر طلبًا، يُقرأ كل وسم بعد كتابته، ويُشحن الطلب مع تقرير بيانات إضافة إلى ملف، للوسوم المطبوعة برقم، يربط UID كل وسم بذلك الرقم؛ ويأتي كلاهما بصيغة Excel أو CSV أو XML. وهذا هو الطريق المعقول عندما يكون الحجم مرتفعًا، أو عندما يحتاج كل وسم إلى رابط URL متسلسل فريد، أو عندما تتطلب الشريحة مفاتيح لكل شريحة لا يستطيع تطبيق هاتف ضبطها — ومنها NTAG424 DNA. وإن كانت هذه حالتك، فـ خدمة ترميز RFID تغطي صيغة البيانات واعتماد العينات؛ أكّد من يملك رابط الوجهة وكيفية قفل الوسوم قبل تشغيل الدفعة.
وأيًا كان الطريق الذي تسلكه، لا يتغير اختبار القبول أبدًا: ينقر شخص حقيقي وسمًا نهائيًا بهاتف حقيقي، ويحدث الشيء الصحيح.
أسئلة شائعة
هل يمكنني إعادة برمجة ملصق أو بطاقة NFC؟
ملصق أو بطاقة NTAG21x، نعم، ما لم يكن مقفلًا بشكل دائم؛ فالوسم المحمي بكلمة مرور يقبل سجلًا جديدًا متى قُدمت كلمة المرور. أما البطاقات والوسوم التي تستخدم مفاتيح، مثل MIFARE Classic أو DESFire أو NTAG424 DNA، فلا يمكن إعادة كتابتها إلا كما تسمح مفاتيحها وإعدادات وصولها.
لماذا لا يكتب هاتفي على وسم NFC؟
عادة لأن NFC مغلق، أو تحرك الوسم أثناء الكتابة، أو تجاوز السجل ذاكرة الشريحة، أو كان الوسم مقفلًا أو محميًا بكلمة مرور، أو كان معدن أو غطاء في الطريق، أو كان الهاتف يفتقر إلى دعم الشريحة، مثل MIFARE Classic (استكشاف أخطاء NFC Tools).