UM2548 لينڪس ڊرائيور
لينڪس® ڊرائيور ST25R3916/ST25R3916B لاءِ
استعمال ڪندڙ دستي

UM2548 لينڪس ڊرائيور

تعارف
ايس ٽي ايس ڊبليو-ايس ٽي 25 آر 013 Linux® ڊرائيور Raspberry Pi® 4 کي X-NUCLEO-NFCO6A1 ۽ X-NUCLEO-NFCO8A1 بورڊن سان هلائڻ جي قابل بڻائي ٿو، جن ۾ ترتيبوار، ST25R3916 ۽ ST25R3916B ڊوائيسز شامل آهن.
هي پيڪيج RF خلاصي پرت (RFAL) کي Raspberry Pi 4 Linux پليٽ فارم تي پورٽ ڪري ٿو، بورڊ فرم ویئر سان هلائڻ لاءِ، ۽ مهيا ڪري ٿو جيئنampلي ايپليڪيشن اين ايف سي جي مختلف قسمن کي ڳولڻ tags ۽ موبائل فون P2P کي سپورٽ ڪري ٿو. RFAL ST25R3916 ۽ ST25R3916B، اعلي ڪارڪردگي NFC يونيورسل ڊوائيسز / EMVCo پڙهندڙن لاء ST معياري ڊرائيور آهي. اهو استعمال ڪيو ويندو آهي، مثال طور، ST25R3916-DISCO firmware (STSW-ST25R010) ۽ X-NUCLEO-NFCO06A1 فرمائيندڙ (X-CUBE-NFC6) پاران.
ايس ٽي ايس ڊبليو-ايس ٽي 25 آر 013 سڀني ST25R3916/ST25R3916B هيٺين پرت ۽ رابطي لاء ڪجهه اعلي پرت پروٽوڪول کي سپورٽ ڪري ٿو. RFAL هڪ پورٽبل انداز ۾ لکيو ويو آهي، تنهنڪري اهو لينڪس تي ٻڌل ڊوائيسز جي وسيع رينج تي هلائي سگھي ٿو. هي دستاويز بيان ڪري ٿو ته ڪيئن RFAL لائبريري هڪ معياري لينڪس سسٽم تي استعمال ڪري سگهجي ٿي (هن صورت ۾ Raspberry Pi 4) NFC/RF ڪميونيڪيشن لاءِ. ڪوڊ انتهائي پورٽبل آهي ۽ ڪنهن به لينڪس پليٽ فارم تي معمولي تبديلين سان ڪم ڪري ٿو.

مٿانview

1.1 خاصيتون

• مڪمل ڪريو لينڪس يوزر اسپيس ڊرائيور (RF خلاصي پرت) ST25R3916 ۽ ST25R3916B ڊوائيسز استعمال ڪندي اين ايف سي فعال ايپليڪيشنون ٺاهڻ لاءِ
• لينڪس ميزبان رابطي سان ST25R3916/ST25R3916B استعمال ڪندي SPI انٽرفيس
• مڪمل RF/NFC تجزيه (RFAL) سڀني وڏين ٽيڪنالاجيز ۽ اعليٰ پرت پروٽوڪول لاءِ:
  - NFC-A (ISO14443-A)
  - NFC-B (ISO14443-B)
  - NFC-F (FeliCa™)
  - NFC-V (ISO15693)
  - P2P (ISO18092)
  - ISO-DEP (ISO ڊيٽا ايڪسچينج پروٽوڪول، ISO14443-4)
  - NFC-DEP (NFC ڊيٽا ايڪسچينج پروٽوڪول، ISO18092)
  - ملڪيت واري ٽيڪنالاجيون، جهڙوڪ ڪوويو، بي'، iClass، Calypso®
• Sampلي تي عملدرآمد دستياب آهي X-NUCLEO-NFC06A1 ۽ X-NUCLEO-NFC08A1 توسيع بورڊن سان، هڪ راسبي پي 4 ۾ پلگ ان
• Sampلي ايپليڪيشن ڪيترن ئي اين ايف سي کي ڳولڻ لاء tag قسم ۽ موبائل فون P2P کي سپورٽ ڪري ٿو
• مفت استعمال ڪندڙ-دوست لائسنس شرطون

1.2 سافٽ ويئر آرڪيٽيڪچر
شڪل 2 لينڪس پليٽ فارم تي RFAL لائبريري جي سافٽ ويئر آرڪيٽيڪچر جي تفصيل ڏيکاري ٿي.
RFAL آساني سان ٻين پليٽ فارمن ڏانهن پورٽبل آهي جنهن کي نام نهاد پليٽ فارم کي ترتيب ڏيڻ سان files.
مٿو file rfal_platform.h ۾ ميڪرو وصفون شامل آهن، جيڪي پليٽ فارم جي مالڪ طرفان مهيا ڪيل ۽ لاڳو ڪيون وينديون.
اهو پليٽ فارم جي مخصوص سيٽنگون مهيا ڪري ٿو جهڙوڪ GPIO تفويض، سسٽم وسيلن، تالا ۽ IRQs، جيڪي RFAL جي صحيح آپريشن لاء گهربل آهن.
هي مظاهرو پليٽ فارم جي ڪمن کي لاڳو ڪري ٿو ۽ لينڪس جي صارف جي جاء تي RFAL جو بندرگاهه مهيا ڪري ٿو.
گڏيل لائبريري file ٺاھيو ويو آھي، جيڪو استعمال ڪيو ويندو آھي نمائشي ايپليڪيشن پاران مهيا ڪيل ڪارڪردگي کي ڏيکارڻ لاءِ RFAL پرت پاران.
لينڪس ميزبان ڊوائيسز سان SPI ڪميونيڪيشن انجام ڏيڻ لاءِ لينڪس يوزر اسپيس مان موجود sysfs انٽرفيس استعمال ڪري ٿو. لينڪس ڪرنل جي اندر SPI sysfs انٽرفيس لينڪس ڪنيل ڊرائيور اسپيڊيو استعمال ڪري ٿو SPI فريم موڪلڻ/ وصول ڪرڻ لاءِ ڊوائيسز کان.
ST25R3916 ۽ ST25R3916B ڊوائيسز جي INT لائن کي سنڀالڻ لاء، ڊرائيور استعمال ڪري ٿو libpiod sysfs هن لائن تي تبديلين جي اطلاع حاصل ڪرڻ لاء.

هارڊويئر سيٽ اپ

2.1 پليٽ فارم استعمال ڪيو
Raspberry Pi 4 بورڊ Raspberry Pi OS سان لينڪس پليٽ فارم طور استعمال ڪيو ويو آهي RFAL لائبريري ٺاهڻ ۽ SPI مٿان ST25R3916/ST25R3916B سان رابطو ڪرڻ لاءِ.
ڊوائيس لينڪس پليٽ فارم تي اين ايف سي ڊوائيسز کي ڳولڻ ۽ گفتگو ڪرڻ لاء هڪ ايپليڪيشن کي فعال ڪن ٿا.

2.2 هارڊويئر گهرجون

• راسبي پي 4
• 8 GB مائڪرو ايس ڊي ڪارڊ Raspberry Pi OS کي بوٽ ڪرڻ لاءِ (ان جي جديد ضرورتن سان)
• SD ڪارڊ پڙهندڙ
• X-NUCLEO-NFC06A1 يا X-NUCLEO-NFC08A1 بورڊ
• Raspberry Pi Arduino™ اڊاپٽر سان بورڊ کي ڳنڍڻ لاءِ پل Raspberry Pi (حصو نمبر ARPI600)

2.2.1 هارڊويئر ڪنيڪشن
ARPI600 Raspberry Pi کان Arduino اڊاپٽر استعمال ڪيو ويندو آھي بورڊن کي راسبي پي سان ڳنڍڻ لاءِ. اڊاپٽر بورڊ جي جمپرز کي تبديل ڪيو وڃي ان کي X-NUCLEO-NFC06A1 يا X-NUCLEO-NFC08A1 بورڊن سان ڳنڍڻ لاءِ.
احتياط:
ARPI600 غلط طور تي 5 V کي Arduino IOREF پن کي فراهم ڪري ٿو. سڌو سنئون بورڊن کي ڳنڍڻ سان ڪجهه پنن تي 5 V واپس اچي ٿو، اهو Raspberry Pi بورڊ کي نقصان پهچائي سگھي ٿو. تباھ ٿيل بورڊن جون رپورٽون آھن (خاص طور تي Raspberry Pi 4B+).
هن کان بچڻ لاء، ARPI600 (هڪ بلڪه ڏکيو آپريشن)، يا X-NUCLEO-NFC06A1 / X-NUCLEONFC08A1 بورڊ (آسان) کي ترتيب ڏيو.
X-NUCLEO-NFC6.2A06/X-NUCLEO-NFC1A08 بورڊن تي CN1 (IOREF) پن کي ڪٽڻ جو آسان ترين حل آهي، جيئن تصوير 3 ۾ ڏيکاريل آهي.
هن پن کي ڪٽڻ سان نيوڪليو بورڊ (جهڙوڪ NUCLEO-L474RG، NUCLEO-F401RE، NUCLEO-8S208RB) سان گڏ آپريشن تي اثر نٿو پوي.

جمپر سيٽنگ
تصوير 5 ۾ ڏيکاريل A4، A3، A2، A1، A0 ۽ A4 لاءِ جمپر، ترتيبوار، P25، P24، P23، P22، P21 ۽ CE1 ۾ تبديل ٿيڻ گهرجن. هن ترتيب سان Raspberry جي GPIO پن نمبر 7 استعمال ڪيو ويندو آهي مداخلت واري لائن لاءِ X-NUCLEONFC06A1/X-NUCLEO-NFC08A1.

في الحال، هي RFAL لائبريري پورٽ پن GPIO7 کي مداخلت واري لائن طور استعمال ڪري ٿو (جمپر سيٽنگن جي مطابق). جيڪڏهن GPIO7 کان مختلف GPIO ۾ مداخلت واري لائن کي تبديل ڪرڻ جي ضرورت آهي، پليٽ فارم مخصوص ڪوڊ (ان ۾ file pltf_gpio.h) کي تبديل ڪيو وڃي macro ST25R_INT_PIN جي تعريف کي 7 کان نئين GPIO پن ۾ تبديل ڪرڻ لاءِ، مداخلت واري لائن طور استعمال ٿيڻ لاءِ.
مٿي ڏنل جمپر سيٽنگن سان، اڊاپٽر بورڊ استعمال ڪري سگھجي ٿو X-NUCLEO NFC06A1 ۽ X-NUCLEO-NFC08A1 کي Raspberry Pi بورڊ سان ڳنڍڻ لاءِ، جيئن هيٺ ڏنل انگن اکرن ۾ ڏيکاريل آهي.

لينڪس ماحول جي جوڙجڪ

3.1 بوٽنگ Raspberry Pi
لينڪس ماحول کي سيٽ ڪرڻ لاء، پهرين انسٽال ڪريو ۽ بوٽ ڪريو Raspberry Pi Raspberry Pi OS سان، جيئن هيٺ بيان ڪيو ويو آهي:
قدم 1
تان جديد Raspberry Pi OS تصوير ڊائون لوڊ ڪريو https://www.raspberrypi.com، پوء چونڊيو Raspberry Pi OS ڊيسڪ ٽاپ سان. هيٺ ڏنل ٽيسٽن لاءِ نسخو 2022-09-22-raspios-bullseye-armhf.img.xz (سيپٽمبر 2022) استعمال ڪيو ويو آهي.
قدم 2
Raspberry Pi OS تصوير کي ان زپ ڪريو ۽ ان کي SD ڪارڊ تي لکو سيڪشن ۾ موجود هدايتن تي عمل ڪندي "SD ڪارڊ تي تصوير لکڻ" جي نالي سان.
قدم 3
هارڊويئر ڳنڍيو:

• Raspberry Pi 4 کي معياري HDMI ڪيبل استعمال ڪندي مانيٽر سان ڳنڍيو.
• Raspberry Pi جي USB بندرگاهن تي ماؤس ۽ ڪيبورڊ جوڙيو.

اهو پڻ ممڪن آهي ته Raspberry Pi سان ڪم ڪرڻ ssh استعمال ڪندي. هن معاملي ۾. اهو ضروري ناهي ته مانيٽر، ڪيبورڊ ۽ مائوس کي Raspberry Pi سان ڳنڍڻ. ضرورت صرف اها آهي ته PC وٽ ssh سان ساڳي نيٽ ورڪ اندر Raspberry Pi، ۽ IP پتي مطابق ترتيب ڏيو.
قدم 4
هڪ SD ڪارڊ سان Raspberry Pi 4 بوٽ ڪريو. بوٽ ڪرڻ کان پوء، هڪ ديبين جي بنياد تي لينڪس ڊيسڪ مانيٽر تي ظاهر ٿئي ٿو.
نوٽ:
ڪڏهن ڪڏهن، Raspberry Pi OS کي بوٽ ڪرڻ کان پوء، ڪي ڪي بورڊ ڪيبورڊ ڪم نه ڪندا آهن. انھن کي ڪم ڪرڻ لاء، کوليو file /etc/default/keyboard ۽ سيٽ ڪريو XKBLAYOUT=”us”، ۽ ريبوٽ ڪريو Raspberry Pi.
3.2 Raspberry Pi تي SPI کي فعال ڪريو
ايس پي آئي ڊرائيور ڪرنل اندر X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 بورڊن سان SPI ذريعي رابطو ڪري ٿو. اهو چيڪ ڪرڻ ضروري آهي ته ڇا SPI اڳ ۾ ئي فعال آهي Raspbian Pi OS ڪنييل ترتيب ۾.
چيڪ ڪريو ته ڇا /dev/spidev0.0 Raspberry Pi ماحول ۾ نظر اچي ٿو. جيڪڏهن اهو نظر نه اچي رهيو آهي، هيٺ بيان ڪيل قدمن تي عمل ڪندي يوٽيلٽي "raspi-config" استعمال ڪندي SPI انٽرفيس کي فعال ڪريو.
قدم 1
Raspberry Pi تي هڪ نئون ٽرمينل کوليو ۽ ڪمانڊ ”raspi-config“ کي روٽ طور هلايو: sudo raspi-config
هي قدم هڪ گرافڪ انٽرفيس کوليندو آهي.
قدم 2
گرافڪ انٽرفيس ۾ "انٽرفيسنگ آپشنز" نالي آپشن کي چونڊيو.
قدم 3
هي قدم مختلف اختيارن کي لسٽ ڪري ٿو.
"SPI" نالي اختيار چونڊيو.
هيٺ ڏنل متن سان هڪ نئين ونڊو ظاهر ٿئي ٿي:
"ڇا توھان چاھيو ٿا ته SPI انٽرفيس کي فعال ڪيو وڃي؟"
قدم 4
چونڊيو SPI کي فعال ڪرڻ لاءِ ھن ونڊو ۾.
قدم 5
ريبوٽ Raspberry Pi.
مٿين قدمن کي ريبوٽ ڪرڻ کانپوءِ راسبي پي ماحول ۾ SPI انٽرفيس کي فعال ڪندو.

تعمير ڪريو RFAL لائبريري ۽ ايپليڪيشن

لينڪس جو RFAL مظاهرو آرڪائيو ۾ مهيا ڪيو ويو آهي، جهڙوڪ ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz.
Raspberry Pi تي RFAL لائبريري ۽ ايپليڪيشن ٺاهڻ لاءِ، ھيٺ ڏنل قدمن ذريعي وڃو:
قدم 1
گھر ڊاريڪٽري مان ھيٺ ڏنل حڪم استعمال ڪندي Raspberry Pi تي پيڪيج کي انزپ ڪريو
tar -xJvf ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz
قدم 2
انسٽال ڪريو cmake (جيڪڏهن اڳ نه ڪيو ويو) حڪم استعمال ڪندي
apt-get install cmake
RFAL لائبريري ۽ ايپليڪيشن بلڊ سسٽم cmake تي ٻڌل آهن، انهي سبب لاء ان کي انسٽال ڪرڻ جي ضرورت آهي cmake پيڪيج کي گڏ ڪرڻ لاء.
قدم 3
RFAL لائبريري ۽ ايپليڪيشن کي تعمير ڪرڻ لاء، تعمير ڊاريڪٽري ڏانهن وڃو
سي ڊي ST25R3916_v2.8.0_لينڪس_ڊيمو_v1.0/لينڪس_ڊيمو/بلڊ
اتان کان، حڪم هلائي
cmake ..
مٿين حڪم ۾ ".." ظاهر ڪري ٿو ته مٿين سطح جي CMakeLists.txt موجود آهي والدين ڊاريڪٽري ۾
(ST25R3916_v2.8.0_Linux_demo_v1.0).
هي حڪم ٺاهي ٿو ٺاهيfile لائبريري ۽ ايپليڪيشن ٺاهڻ لاءِ ايندڙ قدم ۾ استعمال ڪيو. اتان کان، ST25R3916B لاء مظاهرين کي تعمير ڪرڻ لاء ھيٺ ڏنل حڪم هلائي
ڪي ميڪ -DRFAL_VARIANT=st25r3916b ..
قدم 4
RFAL لائبريري ۽ ايپليڪيشن ٺاهڻ لاءِ ميڪ ڪمانڊ کي هلايو:
ٺاهڻ
هي حڪم پهريون ٺاهي ٿو RFAL لائبريري، ۽ پوء ايپليڪيشن ان جي چوٽي تي.

ايپليڪيشن کي ڪيئن هلائڻ

هڪ ڪامياب بلڊ اپ ٺاهي ٿو هڪ قابل عمل نالو "nfc_poller_st25r3916" يا "nfc_poller_st25r3916b" جڳهه تي /build/demo.
ڊفالٽ طور، ايپليڪيشن کي روٽ حقن سان هلائڻ جي ضرورت آهي ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build/demo/:
sudo./nfc_demo_st25r3916
ايپليڪيشن اين ايف سي لاءِ پولنگ شروع ٿئي ٿي tags ۽ موبائيل فون، پوءِ مليل ڊوائيسز کي سندن UID سان ڏيکاري ٿو، جيئن تصوير 7 ۾ ڏيکاريل آهي.

ايپليڪيشن کي ختم ڪرڻ لاء Ctrl + C کي دٻايو.

نظرثاني جي تاريخ
جدول 1. دستاويز جي نظرثاني جي تاريخ

تاريخ	نظرثاني	تبديليون
1-مارچ-19	1	شروعاتي ڇڏڻ.
4-اپريل-23	2	تازه ٿيل دستاويز جو عنوان، سيڪشن جو تعارف، سيڪشن 1.1 خاصيتون، سيڪشن 1.2 سافٽ ويئر آرڪيٽيڪچر، سيڪشن 2.1 پليٽ فارم استعمال ٿيل، سيڪشن 2.2 هارڊويئر گهرجون، سيڪشن 2.2.1 هارڊويئر ڪنيڪشن، سيڪشن 3.1 بوٽنگ Raspberry Pi، سيڪشن 3.2 Raspberry Pi تي SPI کي فعال ڪريو، سيڪشن 4 تعمير ڪريو RFAL لائبريري ۽ ايپليڪيشن، ۽ سيڪشن 5 ايپليڪيشن کي ڪيئن هلائڻ. اپڊيٽ ٿيل شڪل 1. RFAL لائبريري لينڪس پليٽ فارم تي، تصوير 2. RFAL سافٽ ويئر آرڪيٽيڪچر لينڪس تي، ۽ شڪل 5. هارڊويئر سيٽ اپ ٽاپ view. سموري دستاويز ۾ ننڍيون ٽيڪسٽ تبديليون.

اهم نوٽيس - غور سان پڙهو
STMicroelectronics NV ۽ ان جا ماتحت ادارا (“ST”) ST پروڊڪٽس ۽/يا هن دستاويز ۾ بغير اطلاع جي ڪنهن به وقت تبديليون، سڌارا، واڌايون، ترميمون ۽ سڌارا ڪرڻ جو حق محفوظ رکن ٿا. خريد ڪندڙن کي آرڊر ڏيڻ کان پهريان ST شين تي تازي لاڳاپيل معلومات حاصل ڪرڻ گهرجي. ايس ٽي پروڊڪٽس وڪرو ڪيا وڃن ٿا ايس ٽي جي شرطن ۽ وڪري جي شرطن جي مطابق آرڊر جي اقرار جي وقت تي.
خريدار مڪمل طور تي ST پروڊڪٽس جي چونڊ، چونڊ ۽ استعمال جا ذميوار آهن ۽ ST درخواست جي مدد يا خريد ڪندڙن جي پروڊڪٽس جي ڊيزائن لاءِ ڪا به ذميواري قبول نه ڪندو آهي.
ڪو به لائسنس، ظاهر يا تقاضا، ڪنهن به دانشورانه ملڪيت جو حق ST پاران ڏنل ناهي.
ايس ٽي پروڊڪٽس جو ريزيل شقن سان مختلف معلومات ھتي بيان ڪيل معلومات کان مختلف آھي ايس ٽي پاران ڏنل ڪنھن به وارنٽي کي رد ڪندي اھڙي پراڊڪٽ لاءِ.
ST ۽ ST لوگو ST جا ٽريڊ مارڪ آھن. ST ٽريڊ مارڪ بابت اضافي معلومات لاءِ، ڏسو www.st.com/trademarks. ٻيا سڀئي پراڊڪٽ يا خدمت جا نالا انهن جي لاڳاپيل مالڪن جي ملڪيت آهن.
هن دستاويز ۾ معلومات هن دستاويز جي ڪنهن به اڳوڻي نسخن ۾ اڳ ۾ فراهم ڪيل معلومات کي ختم ڪري ٿو ۽ تبديل ڪري ٿو.
© 2023 STMicroelectronics – سڀ حق محفوظ آهن

UM2548 - Rev 2

دستاويز / وسيلا

STMicroelectronics UM2548 لينڪس ڊرائيور [pdf] استعمال ڪندڙ دستياب UM2548 لينڪس ڊرائيور، UM2548، لينڪس ڊرائيور، ڊرائيور

حوالو

• استعمال ڪندڙ دستي