STMicroelectronics UM2375 Linux ड्रायव्हर वापरकर्ता मॅन्युअल

STSW-ST25R009 Linux® ड्रायव्हर Raspberry Pi 4 ला X-NUCLEO-NFC05A1 सह ऑपरेट करण्यास सक्षम करतो, ज्यामध्ये ST25R3911B उच्च कार्यक्षमता असलेले NFC युनिव्हर्सल उपकरण आहे.

हे पॅकेज X-NUCLEO-NFC4A05 फर्मवेअरसह ऑपरेट करण्यासाठी RF अॅब्स्ट्रॅक्शन लेयर (RFAL) ला Raspberry Pi 1 Linux प्लॅटफॉर्मवर पोर्ट करते. पॅकेज म्हणून प्रदान करतेampविविध प्रकारचे NFC शोधणारा le अनुप्रयोग tags आणि P2P ला सपोर्ट करणारे मोबाईल फोन. RFAL हा ST25R NFC/RFID रीडर ICs ST25R3911B, ST25R3912, ST25R3913, ST25R3914 आणि ST25R3915 साठी ST मानक ड्रायव्हर आहे. हे उदाहरणार्थ, ST25R3911B-DISCO फर्मवेअर (STSW-ST25R002) आणि X-NUCLEONFC05A1 फर्मवेअर (X-CUBE-NFC5) द्वारे वापरले जाते.

STSW-ST25R009 सर्व ST25R3911B लोअर-लेयर प्रोटोकॉल आणि संप्रेषणासाठी काही उच्च स्तर प्रोटोकॉलचे समर्थन करते. RFAL हे पोर्टेबल पद्धतीने लिहिलेले आहे, त्यामुळे ते Linux® वर आधारित उपकरणांच्या विस्तृत श्रेणीवर चालू शकते. हा दस्तऐवज NFC/RF संप्रेषणासाठी मानक लिनक्स प्रणालीवर (या प्रकरणात रास्पबेरी पाई 4) RFAL लायब्ररी कशी वापरली जाऊ शकते याचे वर्णन करतो. कोड अत्यंत पोर्टेबल आहे आणि कोणत्याही Linux प्लॅटफॉर्मवर किरकोळ बदलांसह कार्य करतो.

आकृती 1. लिनक्स प्लॅटफॉर्मवर आरएफएएल लायब्ररी

ओव्हरview

वैशिष्ट्ये

25 W पर्यंत आउटपुट पॉवरसह ST3911R25B/ST391R1.4x उच्च कार्यप्रदर्शन NFC फ्रंटएंड वापरून NFC सक्षम ऍप्लिकेशन तयार करण्यासाठी पूर्ण लिनक्स वापरकर्ता स्पेस ड्रायव्हर (RF ऍब्स्ट्रॅक्शन लेयर)

SPI इंटरफेस वापरून ST25R3911B/ST25R391x सह लिनक्स होस्ट संप्रेषण
सर्व प्रमुख तंत्रज्ञान आणि उच्च स्तर प्रोटोकॉलसाठी पूर्ण 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रास्पबेरी Pi 05 मध्ये प्लग केलेले X-NUCLEO-NFC1A4 विस्तार बोर्डसह अंमलबजावणी उपलब्ध आहे
Sampअनेक NFC शोधण्यासाठी le अनुप्रयोग tag P2P ला समर्थन देणारे प्रकार आणि मोबाईल फोन

मोफत वापरकर्ता-अनुकूल परवाना अटी

सॉफ्टवेअर आर्किटेक्चर

आकृती 2 Linux® प्लॅटफॉर्मवर RFAL लायब्ररीचे सॉफ्टवेअर आर्किटेक्चर तपशील दाखवते.

आरएफएएल तथाकथित प्लॅटफॉर्मला अनुकूल करून इतर प्लॅटफॉर्मवर सहजपणे पोर्टेबल आहे files.

शीर्षलेख file rfal_platform.h मॅक्रो व्याख्या आहेत, ज्या प्लॅटफॉर्म मालकाने प्रदान केल्या पाहिजेत आणि अंमलात आणल्या पाहिजेत. शिवाय, हे GPIO असाइनमेंट, सिस्टम संसाधने, लॉक आणि IRQs सारख्या प्लॅटफॉर्म विशिष्ट सेटिंग्ज प्रदान करते, जे RFAL च्या योग्य ऑपरेशनसाठी आवश्यक आहेत.

हे प्रात्यक्षिक प्लॅटफॉर्म फंक्शन्स लागू करते आणि Linux® च्या वापरकर्त्याच्या जागेत RFAL लायब्ररीचे पोर्ट प्रदान करते. सामायिक लायब्ररी file व्युत्पन्न केले जाते, जे RFAL लेयरद्वारे प्रदान केलेल्या कार्यक्षमतेचे प्रदर्शन करण्यासाठी डेमो अनुप्रयोगाद्वारे वापरले जाते.

Linux® होस्ट ST25R3911B डिव्हाइससह SPI संप्रेषण सक्षम करण्यासाठी Linux® वापरकर्ता जागेवरून उपलब्ध sysfs इंटरफेस वापरतो. Linux® कर्नलच्या आत SPI sysfs इंटरफेस ST25R3911B वर/वरून SPI फ्रेम्स पाठवण्यासाठी/प्राप्त करण्यासाठी Linux® कर्नल ड्रायव्हर spidev चा वापर करतो.

ST25R3911B ची इंटरप्ट लाइन हाताळण्यासाठी, ड्रायव्हर libgpiod चा वापर करून या लाईनवरील बदलांची सूचना मिळवतो.

आकृती 2. लिनक्सवरील RFAL सॉफ्टवेअर आर्किटेक्चर

हार्डवेअर सेटअप

प्लॅटफॉर्म वापरले

RFAL लायब्ररी तयार करण्यासाठी आणि SPI वर ST4R25B शी संवाद साधण्यासाठी Raspberry Pi OS सह रास्पबेरी Pi 3911 बोर्ड लिनक्स प्लॅटफॉर्म म्हणून वापरला जातो.
ST25R3911B लिनक्स प्लॅटफॉर्मवरील ऍप्लिकेशनला NFC डिव्हाइसेस शोधण्यासाठी आणि त्यांच्याशी संवाद साधण्यासाठी सक्षम करते.

हार्डवेअर आवश्यकता

रास्पबेरी पाई 4
रास्पबेरी Pi OS बूट करण्यासाठी 8 GBytes मायक्रो SD कार्ड
SD कार्ड रीडर
X-NUCLEO-NFC05A1 ला Raspberry Pi Arduino Adapter सह Raspberry Pi साठी जोडण्यासाठी ब्रिज बोर्ड, भाग क्रमांक ARPI600.
X-NUCLEO-NFC05A1. नवीनतम रास्पबेरी Pi OS आवश्यकतांचा संदर्भ घ्या.

हार्डवेअर कनेक्शन

ARPI600 Raspberry Pi ते Arduino अडॅप्टर बोर्डचा वापर X-NUCLEO-NFC05A1 ला रास्पबेरी Pi शी जोडण्यासाठी केला जातो. X-NUCLEO-NFC05A1 शी जोडण्यासाठी अडॅप्टर बोर्डच्या जंपर्समध्ये बदल करणे आवश्यक आहे.

खबरदारी: ARPI600 चुकीच्या पद्धतीने Arduino IOREF पिनला 5 V पुरवते. X-NUCLEO-NFC05A1 थेट संलग्न केल्याने काही पिनवर 5 V फीड बॅक होतो, यामुळे रास्पबेरी Pi बोर्ड खराब होऊ शकतो. विशेषत: Raspberry Pi 4B+ प्रत्यक्षात नष्ट झाल्याच्या बातम्या आहेत. ही परिस्थिती टाळण्यासाठी एकतर ARPI600 (एक कठीण ऑपरेशन) किंवा X-NUCLEO-NFC05A1 (सोपे ऑपरेशन) जुळवून घ्या.

आकृती 6.2 मध्ये दर्शविल्याप्रमाणे X-NUCLEO-NFC05A1 वरील CN3 (IOREF) पिन कट करणे सर्वात सोपा उपाय आहे.

हा पिन कापल्याने न्यूक्लियो बोर्ड (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB, इ.) च्या संयोगाने ऑपरेशनवर परिणाम होत नाही.

आकृती 3. हार्डवेअर कनेक्शन निराकरण

जम्पर सेटिंग

आकृती 5 मध्ये दर्शविलेले A4, A3, A2, A1, A0 आणि A4 चे जंपर्स P23, P22, P21 आणि CE1 मध्ये बदलले पाहिजेत. या जंपर सेटिंगसह, रास्पबेरीचा 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 पिनमध्ये बदलण्यासाठी, इंटरप्ट लाइन म्हणून वापरण्यासाठी सुधारित करणे आवश्यक आहे.

वरील जंपर सेटिंग्जसह, आकृती 05 मध्ये दर्शविल्याप्रमाणे X-NUCLEO-NFC1A5 ला रास्पबेरी पाई बोर्डसह जोडण्यासाठी अडॅप्टर बोर्ड वापरला जाऊ शकतो.

आकृती 5. हार्डवेअर सेटअप टॉप view

आकृती 6. हार्डवेअर सेटअप बाजू view

लिनक्स पर्यावरण सेटअप

रास्पबेरी पाईचे बूटिंग

लिनक्स वातावरण सेटअप करण्यासाठी, पहिली पायरी म्हणजे Raspberry Pi OS सह Raspberry Pi 4 स्थापित करणे आणि बूट करणे खालीलप्रमाणे आहे:

पायरी 1

दुव्यावरून नवीनतम रास्पबेरी Pi OS प्रतिमा डाउनलोड करा:

https://www.raspberrypi.com

डेस्कटॉपसह रास्पबेरी Pi OS निवडा. खालील चाचण्यांसाठी खालील आवृत्ती वापरली गेली: सप्टेंबर 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).

पायरी 2

Raspberry Pi प्रतिमा अनझिप करा आणि "SD कार्डवर प्रतिमा लिहिणे" नावाच्या विभागात उपलब्ध असलेल्या सूचनांचे अनुसरण करून ती SD कार्डमध्ये लिहा.

पायरी 3

हार्डवेअर कनेक्ट करा:

मानक HDMI केबल वापरून Raspberry Pi ला मॉनिटरशी कनेक्ट करा.

Raspberry Pi च्या USB पोर्टशी माउस आणि कीबोर्ड कनेक्ट करा.

ssh वापरून रास्पबेरी पाई सह कार्य करणे देखील शक्य आहे. अशावेळी मॉनिटर, कीबोर्ड आणि माऊसला Raspberry Pi सह कनेक्ट करण्याची आवश्यकता नाही. Raspberry Pi सारख्या नेटवर्कमध्ये ssh सह PC असणे आणि त्यानुसार IP पत्ता कॉन्फिगर करणे ही एकमेव आवश्यकता आहे.

पायरी 4

रास्पबेरी पाई SD कार्डने बूट करा.

बूट केल्यानंतर, मॉनिटरवर डेबियन आधारित लिनक्स डेस्कटॉप दिसतो.

टीप: कधीकधी असे दिसून येते की रास्पबेरी पाई बूट केल्यानंतर, काही कीबोर्ड की कार्य करत नाहीत. त्यांना कार्य करण्यासाठी, उघडा file /etc/default/keyboard आणि XKBLAYOUT=”us” सेट करा आणि Raspberry Pi रीबूट करा.

रास्पबेरी पाई वर SPI सक्षम करा

कर्नलमधील SPI ड्रायव्हर X-NUCLEO-NFC05A1 सह SPI द्वारे संवाद साधतो. Raspberry Pi OS/kernel कॉन्फिगरेशनमध्ये SPI आधीच सक्षम आहे का हे तपासणे महत्त्वाचे आहे.
रास्पबेरी पाई वातावरणात /dev/spidev0.0 दृश्यमान आहे का ते तपासा. ते दृश्यमान नसल्यास, खाली वर्णन केलेल्या चरणांचे अनुसरण करून “raspi-config” उपयुक्तता वापरून SPI इंटरफेस सक्षम करा.

पायरी 1

रास्पबेरी पाई वर नवीन टर्मिनल उघडा आणि रूट म्हणून “raspi-config” कमांड चालवा:

sudo raspi-config

ही पायरी ग्राफिकल इंटरफेस उघडते.

पायरी 2

ग्राफिकल इंटरफेसमध्ये "इंटरफेसिंग पर्याय" नावाचा पर्याय निवडा.

पायरी 3

ही पायरी विविध पर्यायांची यादी करते.
“SPI” नावाचा पर्याय निवडा.
खालील मजकूरासह एक नवीन विंडो दिसेल:
"तुम्हाला SPI इंटरफेस सक्षम करायला आवडेल का?"

पायरी 4

निवडा SPI सक्षम करण्यासाठी या विंडोमध्ये.

पायरी 5

रास्पबेरी पाई रीबूट करा.
वरील पायऱ्या रीबूट केल्यानंतर रास्पबेरी पाई वातावरणात SPI इंटरफेस सक्षम करतील.

आरएफएएल लायब्ररी आणि अनुप्रयोग तयार करा

लिनक्सचा आरएफएएल डेमो एका संग्रहात प्रदान केला आहे. त्याचे नाव असे गृहीत धरूया:
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
रास्पबेरी पाई वर आरएफएएल लायब्ररी आणि अनुप्रयोग तयार करण्यासाठी, खालील चरणांचे अनुसरण करा:

पायरी 1

होम डिरेक्ट्रीमधून खालील कमांड वापरून रास्पबेरी पाईवरील पॅकेज अनझिप करा:

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

पायरी 2

आधी केले नसल्यास, खालील कमांड वापरून cmake स्थापित करा:

apt-get install cmake

RFAL लायब्ररी आणि ऍप्लिकेशन बिल्ड सिस्टम cmake वर आधारित आहे, या कारणास्तव पॅकेजच्या संकलनासाठी cmake स्थापित करणे आवश्यक आहे.

पायरी 3

आरएफएएल लायब्ररी आणि अनुप्रयोग तयार करण्यासाठी, "बिल्ड" निर्देशिकेवर जा:

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

आरएफएएल लायब्ररी आणि अनुप्रयोग तयार करण्यासाठी "मेक" कमांड चालवा:

बनवणे

“मेक” कमांड प्रथम आरएफएएल लायब्ररी तयार करते आणि नंतर त्याच्या वर अनुप्रयोग तयार करते.

अर्ज कसा चालवायचा

यशस्वी बिल्ड-अप खालील ठिकाणी “nfc_demo_st25r3911b” नावाचे एक एक्झिक्यूटेबल व्युत्पन्न करते:
/बिल्ड/अनुप्रयोग.

डीफॉल्टनुसार ऍप्लिकेशनला मार्गावरून रूट अधिकारांसह चालवणे आवश्यक आहे: ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build:

sudo ./demo/nfc_demo_st25r3911b

अनुप्रयोग NFC साठी मतदान सुरू करतो tags आणि मोबाईल फोन. ते आकृती 7 मध्ये दर्शविल्याप्रमाणे त्यांच्या UID सह सापडलेली उपकरणे प्रदर्शित करते.

आकृती 7. सापडलेल्या उपकरणांचे प्रदर्शन

अनुप्रयोग समाप्त करण्यासाठी Ctrl + C दाबा.

पुनरावृत्ती इतिहास

तक्ता 1. दस्तऐवज पुनरावृत्ती इतिहास

सारण्यांची यादी

तक्ता 1. दस्तऐवज पुनरावृत्ती इतिहास. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

आकृत्यांची यादी

आकृती 1. लिनक्स प्लॅटफॉर्मवर RFAL लायब्ररी. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . १
आकृती 2. लिनक्सवरील RFAL सॉफ्टवेअर आर्किटेक्चर. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
आकृती 3. हार्डवेअर कनेक्शन निराकरण. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
आकृती 4. अडॅप्टर बोर्डवर A5, A4, A3, A2, A1 आणि A0 जंपर्सची स्थिती. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ५
आकृती 5. हार्डवेअर सेटअप टॉप view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ५६५०७३३
आकृती 6. हार्डवेअर सेटअप बाजू view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
आकृती 7. सापडलेल्या उपकरणांचे प्रदर्शन. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

महत्वाची सूचना – काळजीपूर्वक वाचा

STMicroelectronics NV आणि त्याच्या उपकंपन्या (“ST”) ST उत्पादनांमध्ये आणि/किंवा या दस्तऐवजात कोणत्याही वेळी सूचना न देता बदल, सुधारणा, सुधारणा, सुधारणा आणि सुधारणा करण्याचा अधिकार राखून ठेवतात. खरेदीदारांनी ऑर्डर देण्यापूर्वी एसटी उत्पादनांची नवीनतम माहिती मिळवावी. ऑर्डर पावतीच्या वेळी एसटी उत्पादनांची विक्री एसटीच्या अटी आणि नियमांनुसार केली जाते.

एसटी उत्पादनांची निवड, निवड आणि वापर यासाठी खरेदीदार पूर्णपणे जबाबदार आहेत आणि एसटी अर्ज सहाय्यासाठी किंवा खरेदीदारांच्या उत्पादनांच्या डिझाइनसाठी कोणतेही दायित्व गृहीत धरत नाही.

कोणताही बौद्धिक संपदा अधिकाराचा कोणताही परवाना, व्यक्त किंवा निहित, येथे एसटीकडून मंजूर नाही.

येथे नमूद केलेल्या माहितीपेक्षा वेगळ्या तरतुदींसह एसटी उत्पादनांची पुनर्विक्री अशा उत्पादनासाठी एसटीने दिलेली कोणतीही हमी रद्द करेल.

एसटी आणि एसटी लोगो हे एसटीचे ट्रेडमार्क आहेत. एसटी ट्रेडमार्कबद्दल अतिरिक्त माहितीसाठी, पहा www.st.com/trademarks. इतर सर्व उत्पादन किंवा सेवा नावे त्यांच्या संबंधित मालकांची मालमत्ता आहेत.

या दस्तऐवजातील माहिती या दस्तऐवजाच्या कोणत्याही आधीच्या आवृत्त्यांमध्ये पूर्वी पुरवलेल्या माहितीची जागा घेते आणि पुनर्स्थित करते.

कागदपत्रे / संसाधने

STMicroelectronics UM2375 Linux ड्रायव्हर [pdf] वापरकर्ता मॅन्युअल
UM2375 लिनक्स ड्रायव्हर, UM2375, लिनक्स ड्रायव्हर, ड्रायव्हर

संदर्भ

वापरकर्ता मॅन्युअल