STMicroelectronics UM2375 لينڪس ڊرائيور صارف دستياب

STSW-ST25R009 Linux® ڊرائيور Raspberry Pi 4 کي X-NUCLEO-NFC05A1 سان هلائڻ جي قابل بڻائي ٿو، جنهن ۾ ST25R3911B اعلي ڪارڪردگي NFC يونيورسل ڊوائيس شامل آهي.

هي پيڪيج X-NUCLEO-NFC4A05 فرم ویئر سان هلائڻ لاءِ RF خلاصي پرت (RFAL) کي Raspberry Pi 1 Linux پليٽ فارم تي پورٽ ڪري ٿو. پيڪيج مهيا ڪري ٿو جيئنampلي ايپليڪيشن اين ايف سي جي مختلف قسمن کي ڳولڻ tags ۽ موبائل فون P2P کي سپورٽ ڪري ٿو. RFAL ST25R NFC/RFID Reader ICs ST25R3911B، ST25R3912، ST25R3913، ST25R3914 ۽ ST25R3915 لاءِ ST معياري ڊرائيور آهي. اهو استعمال ڪيو ويندو آهي، مثال طور، ST25R3911B-DISCO firmware (STSW-ST25R002) ۽ X-NUCLEONFC05A1 فرمائيندڙ (X-CUBE-NFC5) پاران.

STSW-ST25R009 سڀني ST25R3911B لوئر پرت پروٽوڪول ۽ ڪميونيڪيشن لاءِ ڪجهه اعليٰ پرت پروٽوڪول کي سپورٽ ڪري ٿو. RFAL هڪ پورٽبل انداز ۾ لکيو ويو آهي، تنهنڪري اهو Linux® تي ٻڌل ڊوائيسز جي وسيع رينج تي هلائي سگھي ٿو. هي دستاويز بيان ڪري ٿو ته ڪيئن RFAL لائبريري هڪ معياري لينڪس سسٽم تي استعمال ڪري سگهجي ٿي (هن صورت ۾ Raspberry Pi 4) NFC/RF ڪميونيڪيشن لاءِ. ڪوڊ انتهائي پورٽبل آهي ۽ ڪنهن به لينڪس پليٽ فارم تي معمولي تبديلين سان ڪم ڪري ٿو.

شڪل 1. لينڪس پليٽ فارم تي RFAL لائبريري

مٿانview

خاصيتون

مڪمل لينڪس يوزر اسپيس ڊرائيور (آر ايف ايبسٽرڪشن پرت) اين ايف سي فعال ٿيل ايپليڪيشنون ٺاهڻ لاءِ ST25R3911B/ST25R391x اعليٰ ڪارڪردگي NFC فرنٽ اينڊس کي 1.4 W تائين ٻاھرين پاور سان استعمال ڪندي.

لينڪس ميزبان رابطي سان ST25R3911B/ST25R391x 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)
- ملڪيت واري ٽيڪنالاجيون (Kovio, B', iClass, Calypso®, …)

Sampلي تي عملدرآمد دستياب آهي X-NUCLEO-NFC05A1 توسيع بورڊ سان، هڪ راسبي پي 4 ۾ پلگ ان
Sampلي ايپليڪيشن ڪيترن ئي اين ايف سي کي ڳولڻ لاء tag قسم ۽ موبائل فون P2P کي سپورٽ ڪري ٿو

مفت استعمال ڪندڙ-دوست لائسنس شرطون

سافٽ ويئر فن تعمير

شڪل 2 هڪ Linux® پليٽ فارم تي RFAL لائبريري جي سافٽ ويئر آرڪيٽيڪچر جا تفصيل ڏيکاري ٿو.

RFAL آساني سان ٻين پليٽ فارمن ڏانهن پورٽبل آهي جنهن کي نام نهاد پليٽ فارم کي ترتيب ڏيڻ سان files.

مٿو file rfal_platform.h macro وصفن تي مشتمل آهي، جنهن کي پليٽ فارم جي مالڪ طرفان مهيا ڪيل ۽ لاڳو ڪرڻ جي ضرورت آهي. ان کان علاوه، اهو پليٽ فارم جي مخصوص سيٽنگون مهيا ڪري ٿو جهڙوڪ GPIO تفويض، سسٽم وسيلن، تالا ۽ IRQs، جيڪي RFAL جي صحيح آپريشن لاء گهربل آهن.

هي مظاهرو پليٽ فارم جي ڪمن کي لاڳو ڪري ٿو ۽ RFAL لائبريري جو هڪ پورٽ مهيا ڪري ٿو Linux® جي صارف جي جاءِ ۾. گڏيل لائبريري file ٺاھيو ويو آھي، جيڪو استعمال ڪيو ويندو آھي ڊيمو ايپليڪيشن پاران RFAL پرت پاران مهيا ڪيل ڪارڪردگي کي ڏيکارڻ لاء.

Linux® ميزبان ST25R3911B ڊوائيس سان SPI رابطي کي فعال ڪرڻ لاءِ Linux® يوزر اسپيس مان دستياب sysfs انٽرفيس استعمال ڪري ٿو. Linux® kernel جي اندر SPI sysfs انٽرفيس ST25R3911B کان SPI فريم موڪلڻ/وصول ڪرڻ لاءِ Linux® ڪرنل ڊرائيور اسپائيڊ استعمال ڪري ٿو.

ST25R3911B جي مداخلت واري لائن کي سنڀالڻ لاءِ، ڊرائيور libgpiod استعمال ڪري ٿو ھن لائن تي تبديلين جي اطلاع حاصل ڪرڻ لاءِ.

شڪل 2. لينڪس تي RFAL سافٽ ويئر آرڪيٽيڪچر

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

پليٽ فارم استعمال ڪيو

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

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

راسبي پي 4
Raspberry Pi OS کي بوٽ ڪرڻ لاءِ 8 GBytes مائڪرو ايس ڊي ڪارڊ
SD ڪارڊ پڙهندڙ
X-NUCLEO-NFC05A1 کي ڳنڍڻ لاءِ پل جو بورڊ Raspberry Pi Arduino Adapter سان Raspberry Pi لاءِ، حصو نمبر ARPI600.
X-NUCLEO-NFC05A1. تازه ترين Raspberry Pi OS گهرجن ڏانهن رجوع ڪريو.

هارڊ ويئر ڪنيڪشن

ARPI600 Raspberry Pi کان Arduino اڊاپٽر بورڊ استعمال ڪيو ويندو آھي X-NUCLEO-NFC05A1 کي Raspberry Pi سان ڳنڍڻ لاءِ. ان کي X-NUCLEO-NFC05A1 سان ڳنڍڻ لاء اڊاپٽر بورڊ جي جمپر کي تبديل ڪرڻ جي ضرورت آهي.

احتياط: ARPI600 غلط طور تي 5 V کي Arduino IOREF پن کي فراهم ڪري ٿو. X-NUCLEO-NFC05A1 کي سڌو سنئون ڳنڍڻ سان ڪجهه پنن تي 5 V واپس اچي ٿو، اهو شايد Raspberry Pi بورڊ کي نقصان پهچائي سگھي ٿو. خاص طور تي رپورٽون آهن Raspberry Pi 4B+ اصل ۾ تباهه ٿي رهيو آهي. هن صورتحال کان بچڻ لاءِ يا ته ARPI600 (بلڪه مشڪل آپريشن) يا X-NUCLEO-NFC05A1 (آسان آپريشن) کي ترتيب ڏيو.

سڀ کان آسان حل X-NUCLEO-NFC6.2A05 تي CN1 (IOREF) پن کي ڪٽڻ آهي جيئن تصوير 3 ۾ ڏيکاريل آهي.

هن پن کي ڪٽڻ سان آپريشن متاثر نه ٿيندو آهي نيوڪليو بورڊز (NUCLEO-L474RG، NUCLEO-F401RE، NUCLEO-8S208RB، وغيره).

شڪل 3. هارڊويئر ڪنيڪشن ٺيڪ

جمپر سيٽنگ

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

شڪل 4. اڊاپٽر بورڊ تي جمپر A5، A4، A3، A2، A1 ۽ A0 جي پوزيشن

في الحال، هي RFAL لائبريري پورٽ استعمال ڪري ٿو پن GPIO7 کي مداخلت واري لائن طور، جمپر سيٽنگن جي مطابق. جيڪڏهن GPIO7 کان مختلف GPIO ۾ مداخلت واري لائن کي تبديل ڪرڻ جي ضرورت آهي، پليٽ فارم مخصوص ڪوڊ (ان ۾ file pltf_gpio.h) کي تبديل ڪرڻ جي ضرورت آهي ميڪرو جي تعريف کي تبديل ڪرڻ لاءِ “ST25R_INT_PIN” 7 کان نئين GPIO پن تائين، مداخلت واري لائن طور استعمال ٿيڻ لاءِ.

مٿين جمپر سيٽنگن سان، اڊاپٽر بورڊ استعمال ڪري سگھجي ٿو X-NUCLEO-NFC05A1 کي Raspberry Pi بورڊ سان ڳنڍڻ لاءِ جيئن تصوير 5 ۾ ڏيکاريل آهي.

شڪل 5. هارڊويئر سيٽ اپ ٽاپ view

شڪل 6. هارڊويئر سيٽ اپ سائڊ view

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

Raspberry Pi جي بوٽنگ

لينڪس ماحول کي سيٽ ڪرڻ لاء، پهريون قدم نصب ڪرڻ ۽ بوٽ ڪرڻ آهي Raspberry Pi 4 Raspberry Pi OS سان جيئن هيٺ بيان ڪيو ويو آهي:

قدم 1

لنڪ تان جديد Raspberry Pi OS تصوير ڊائون لوڊ ڪريو:

https://www.raspberrypi.com

ڊيسڪ ٽاپ سان Raspberry Pi OS چونڊيو. ٽيسٽن لاءِ ھيٺ ڏنل نسخو استعمال ڪيو ويو: سيپٽمبر 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).

قدم 2

Raspberry Pi تصوير کي ان زپ ڪريو ۽ "SD ڪارڊ تي تصوير لکڻ" نالي سيڪشن ۾ موجود هدايتن تي عمل ڪندي ان کي SD ڪارڊ ۾ لکو.

قدم 3

هارڊويئر ڳنڍيو:

Raspberry Pi کي معياري HDMI ڪيبل استعمال ڪندي مانيٽر سان ڳنڍيو.

Raspberry Pi جي USB بندرگاهن تي ماؤس ۽ ڪيبورڊ جوڙيو.

اهو پڻ ممڪن آهي ته Raspberry Pi سان ڪم ڪرڻ ssh استعمال ڪندي. انهي صورت ۾ اهو ضروري ناهي ته مانيٽر، ڪيبورڊ ۽ مائوس کي Raspberry Pi سان ڳنڍڻ جي ضرورت آهي. ضرورت صرف اها آهي ته PC وٽ ssh سان ساڳي نيٽ ورڪ اندر Raspberry Pi ۽ IP پتي مطابق ترتيب ڏيو.

قدم 4

SD ڪارڊ سان Raspberry Pi بوٽ ڪريو.

بوٽ ڪرڻ کان پوء، هڪ ديبين جي بنياد تي لينڪس ڊيسڪ مانيٽر تي ظاهر ٿئي ٿو.

نوٽ: ڪڏهن ڪڏهن، اهو مشاهدو ڪيو ويو آهي ته Raspberry Pi کي بوٽ ڪرڻ کان پوء، ڪي ڪي بورڊ ڪيبورڊ ڪم نه ڪندا آهن. انھن کي ڪم ڪرڻ لاء، کوليو file /etc/default/keyboard ۽ سيٽ ڪريو XKBLAYOUT=”us” ۽ ريبوٽ ڪريو Raspberry Pi.

Raspberry Pi تي SPI کي فعال ڪريو

ايس پي آئي ڊرائيور ڪرنل اندر X-NUCLEO-NFC05A1 سان SPI ذريعي رابطو ڪري ٿو. اهو چيڪ ڪرڻ ضروري آهي ته ڇا SPI اڳ ۾ ئي فعال آهي Raspberry Pi OS/kernel configuration ۾.
چيڪ ڪريو ته ڇا /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 ڊيمو آرڪائيو ۾ مهيا ڪيل آهي. اچو ته فرض ڪريون ته ان جو نالو آهي:
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
Raspberry Pi تي RFAL لائبريري ۽ ايپليڪيشن ٺاهڻ لاءِ، ھيٺ ڏنل قدمن تي عمل ڪريو:

قدم 1

گھر ڊاريڪٽري مان ھيٺ ڏنل حڪم استعمال ڪندي Raspberry Pi تي پيڪيج کي انزپ ڪريو:

tar -xJvf ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz

قدم 2

جيڪڏهن اڳ نه ڪيو ويو آهي، cmake انسٽال ڪريو، هيٺ ڏنل حڪم استعمال ڪندي:

apt-get install cmake

RFAL لائبريري ۽ ايپليڪيشن بلڊنگ سسٽم cmake تي ٻڌل آهي، انهي سبب لاء اهو ضروري آهي ته پيڪيج جي تاليف لاء cmake کي نصب ڪيو وڃي.

قدم 3

RFAL لائبريري ۽ ايپليڪيشن کي تعمير ڪرڻ لاء، "تعمير" ڊاريڪٽري ڏانهن وڃو:

cd ST25R3911B_v2.8.0_Linux_demo_v1.0/Linux_demo/build

۽ اتان کان هيٺ ڏنل حڪم هلائي:

cmake ..

مٿي ڏنل حڪم ۾ ".." ظاهر ڪري ٿو ته مٿين سطح جي CMakeLists.txt والدين ڊاريڪٽري ۾ موجود آهي، يعني
ST25R3911B_v2.8.0_Linux_demo_v1.0.

cmake حڪم ٺاهي ٿو ٺاهيfile جيڪو لائبريري ۽ ايپليڪيشن ٺاهڻ لاءِ ايندڙ قدم ۾ استعمال ڪيو ويندو.

قدم 4

RFAL لائبريري ۽ ايپليڪيشن ٺاهڻ لاءِ ”ٺاهيو“ حڪم هلايو:

ٺاهڻ

"ٺاهيو" حڪم پهريون ڀيرو RFAL لائبريري ٺاهي ٿو ۽ پوء ان جي چوٽي تي ايپليڪيشن ٺاهي ٿو.

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

ڪامياب ٺاھڻ ھيٺ ڏنل جڳھ تي "nfc_demo_st25r3911b" نالي ھڪڙي قابل عمل ٺاھي ٿو:
/تعمير / ايپليڪيشنون.

ڊفالٽ طور ايپليڪيشن کي روٽ رائٽس سان هلڻ جي ضرورت آهي رستي کان: ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build:

sudo ./demo/nfc_demo_st25r3911b

ايپليڪيشن اين ايف سي لاءِ پولنگ شروع ٿئي ٿي tags ۽ موبائل فون. اهو ڏيکاري ٿو مليل ڊوائيسز انهن جي UID سان جيئن تصوير 7 ۾ ڏيکاريل آهي.

شڪل 7. مليل ڊوائيسز جي ڊسپلي

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

نظرثاني جي تاريخ

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

جدولن جي فهرست

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

انگن اکرن جي فهرست

شڪل 1. لينڪس پليٽ فارم تي RFAL لائبريري. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
شڪل 2. لينڪس تي RFAL سافٽ ويئر آرڪيٽيڪچر. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
شڪل 3. هارڊويئر ڪنيڪشن ٺيڪ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
شڪل 4. اڊاپٽر بورڊ تي جمپر A5، A4، A3، A2، A1 ۽ A0 جي پوزيشن. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
شڪل 5. هارڊويئر سيٽ اپ ٽاپ view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
شڪل 6. هارڊويئر سيٽ اپ سائڊ view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
شڪل 7. مليل ڊوائيسز جي ڊسپلي. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

اهم نوٽيس - غور سان پڙهو

STMicroelectronics NV ۽ ان جا ماتحت ادارا (“ST”) ST پروڊڪٽس ۽/يا هن دستاويز ۾ بغير اطلاع جي ڪنهن به وقت تبديليون، سڌارا، واڌايون، ترميمون ۽ سڌارا ڪرڻ جو حق محفوظ رکن ٿا. خريد ڪندڙن کي آرڊر ڏيڻ کان پهريان ST شين تي تازي لاڳاپيل معلومات حاصل ڪرڻ گهرجي. ايس ٽي پروڊڪٽس وڪرو ڪيا وڃن ٿا ايس ٽي جي شرطن ۽ وڪري جي شرطن جي مطابق آرڊر جي اقرار جي وقت تي.

خريدار مڪمل طور تي ST پروڊڪٽس جي چونڊ، چونڊ ۽ استعمال جا ذميوار آهن ۽ ST درخواست جي مدد يا خريد ڪندڙن جي پروڊڪٽس جي ڊيزائن لاءِ ڪا به ذميواري قبول نه ڪندو آهي.

ڪو به لائسنس، ظاهر يا تقاضا، ڪنهن به دانشورانه ملڪيت جو حق ST پاران ڏنل ناهي.

ايس ٽي پروڊڪٽس جو ريزيل شقن سان مختلف معلومات ھتي بيان ڪيل معلومات کان مختلف آھي ايس ٽي پاران ڏنل ڪنھن به وارنٽي کي رد ڪندي اھڙي پراڊڪٽ لاءِ.

ST ۽ ST لوگو ST جا ٽريڊ مارڪ آھن. ST ٽريڊ مارڪ بابت اضافي معلومات لاءِ، ڏسو www.st.com/trademarks. ٻيا سڀئي پراڊڪٽ يا خدمت جا نالا انهن جي لاڳاپيل مالڪن جي ملڪيت آهن.

هن دستاويز ۾ معلومات هن دستاويز جي ڪنهن به اڳوڻي نسخن ۾ اڳ ۾ فراهم ڪيل معلومات کي ختم ڪري ٿو ۽ تبديل ڪري ٿو.

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

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

حوالو

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