STMicroelectronics UM2375 Linux Driver User Manual

இந்த தொகுப்பு X-NUCLEO-NFC4A05 firmware உடன் செயல்பட RF சுருக்க அடுக்கை (RFAL) ஒரு Raspberry Pi 1 Linux தளத்திற்கு கொண்டு செல்கிறது. தொகுப்பு பின்வருவனவற்றை வழங்குகிறது:ampபல்வேறு வகையான NFC களைக் கண்டறியும் பயன்பாடு tags மற்றும் P2P ஐ ஆதரிக்கும் மொபைல் போன்கள். RFAL என்பது ST25R NFC/RFID ரீடர் ICகள் ST25R3911B, ST25R3912, ST25R3913, ST25R3914 மற்றும் ST25R3915 ஆகியவற்றுக்கான ST தரநிலை இயக்கியாகும். உதாரணமாக, இது ST25R3911B-DISCO firmware (STSW-ST25R002) மற்றும் X-NUCLEONFC05A1 firmware (X-CUBE-NFC5) ஆகியவற்றால் பயன்படுத்தப்படுகிறது.

STSW-ST25R009 அனைத்து ST25R3911B கீழ்-அடுக்கு நெறிமுறைகளையும், தகவல்தொடர்புக்கான சில உயர்-அடுக்கு நெறிமுறைகளையும் ஆதரிக்கிறது. RFAL ஒரு சிறிய முறையில் எழுதப்பட்டுள்ளது, எனவே இது Linux® ஐ அடிப்படையாகக் கொண்ட பரந்த அளவிலான சாதனங்களில் இயங்க முடியும். NFC/RF தகவல்தொடர்புக்காக RFAL நூலகத்தை ஒரு நிலையான Linux அமைப்பில் (இந்த விஷயத்தில் Raspberry Pi 4) எவ்வாறு பயன்படுத்தலாம் என்பதை இந்த ஆவணம் விவரிக்கிறது. குறியீடு மிகவும் சிறியது மற்றும் எந்த Linux தளத்திலும் சிறிய மாற்றங்களுடன் செயல்படுகிறது.

படம் 1. லினக்ஸ் இயங்குதளத்தில் RFAL நூலகம்

முடிந்துவிட்டதுview

அம்சங்கள்

25 W வரை வெளியீட்டு சக்தியுடன் ST3911R25B/ST391R1.4x உயர் செயல்திறன் கொண்ட NFC முன்பக்கங்களைப் பயன்படுத்தி NFC செயல்படுத்தப்பட்ட பயன்பாடுகளை உருவாக்க முழுமையான Linux பயனர் இட இயக்கி (RF சுருக்க அடுக்கு)

SPI இடைமுகத்தைப் பயன்படுத்தி ST25R3911B/ST25R391x உடன் லினக்ஸ் ஹோஸ்ட் தொடர்பு.
அனைத்து முக்கிய தொழில்நுட்பங்கள் மற்றும் உயர் அடுக்கு நெறிமுறைகளுக்கான முழுமையான RF/NFC சுருக்கம் (RFAL):
- NFC-A (ISO14443-A)
- NFC-B (ISO14443-B)
- NFC-F (ஃபெலிகா™)
- NFC-V (ISO15693)
- P2P (ISO18092)
- ISO-DEP (ISO தரவு பரிமாற்ற நெறிமுறை, ISO14443-4)
- NFC-DEP (NFC தரவு பரிமாற்ற நெறிமுறை, ISO18092)
- தனியுரிம தொழில்நுட்பங்கள் (கோவியோ, பி', ஐகிளாஸ், கலிப்சோ®, …)
SampX-NUCLEO-NFC05A1 விரிவாக்கப் பலகையுடன் le செயல்படுத்தல் கிடைக்கிறது, இது ராஸ்பெர்ரி பை 4 இல் செருகப்பட்டுள்ளது.

Sample பயன்பாடு பல NFC கண்டறிய tag P2P ஐ ஆதரிக்கும் வகைகள் மற்றும் மொபைல் போன்கள்
இலவச பயனர் நட்பு உரிம விதிமுறைகள்

மென்பொருள் கட்டமைப்பு

படம் 2, Linux® தளத்தில் RFAL நூலகத்தின் மென்பொருள் கட்டமைப்பு விவரங்களைக் காட்டுகிறது.

RFAL எனப்படும் தளத்தை மாற்றியமைப்பதன் மூலம் மற்ற தளங்களுக்கு எளிதாக எடுத்துச் செல்ல முடியும். files.

தலைப்பு file rfal_platform.h பற்றி மேக்ரோ வரையறைகளைக் கொண்டுள்ளது, அவை தள உரிமையாளரால் வழங்கப்பட்டு செயல்படுத்தப்பட வேண்டும். மேலும், இது RFAL இன் சரியான செயல்பாட்டிற்குத் தேவையான GPIO ஒதுக்கீடு, கணினி வளங்கள், பூட்டுகள் மற்றும் IRQகள் போன்ற தளம் சார்ந்த அமைப்புகளை வழங்குகிறது.

இந்த செயல்விளக்கம் இயங்குதள செயல்பாடுகளை செயல்படுத்துகிறது மற்றும் Linux® இன் பயனர் இடத்திற்கு RFAL நூலகத்தின் ஒரு போர்ட்டை வழங்குகிறது. ஒரு பகிரப்பட்ட நூலகம். file உருவாக்கப்படுகிறது, இது RFAL லேயரால் வழங்கப்படும் செயல்பாடுகளைக் காண்பிக்க டெமோ பயன்பாட்டால் பயன்படுத்தப்படுகிறது.

Linux® ஹோஸ்ட், ST25R3911B சாதனத்துடன் SPI தொடர்பை இயக்க Linux® பயனர் இடத்திலிருந்து கிடைக்கும் sysfs இடைமுகத்தைப் பயன்படுத்துகிறது. Linux® கர்னலின் உள்ளே, SPI sysfs இடைமுகம், SPI பிரேம்களை ST25R3911B க்கு/இருந்து அனுப்ப/பெற Linux® கர்னல் இயக்கி spidev ஐப் பயன்படுத்துகிறது.

ST25R3911B இன் குறுக்கீடு வரியைக் கையாள, இந்த வரியில் ஏற்படும் மாற்றங்கள் குறித்த அறிவிப்பைப் பெற இயக்கி libgpiod ஐப் பயன்படுத்துகிறது.

படம் 2. லினக்ஸில் RFAL மென்பொருள் கட்டமைப்பு

வன்பொருள் அமைப்பு

இயங்குதளம் பயன்படுத்தப்பட்டது

ராஸ்பெர்ரி பை OS உடன் கூடிய ராஸ்பெர்ரி பை 4 பலகை, RFAL நூலகத்தை உருவாக்கவும், SPI வழியாக ST25R3911B உடன் தொடர்பு கொள்ளவும் லினக்ஸ் தளமாகப் பயன்படுத்தப்படுகிறது.
ST25R3911B, லினக்ஸ் இயங்குதளத்தில் உள்ள ஒரு பயன்பாட்டை NFC சாதனங்களைக் கண்டறிந்து தொடர்பு கொள்ள உதவுகிறது.

வன்பொருள் தேவைகள்

ராஸ்பெர்ரி பை 4
ராஸ்பெர்ரி பை OS ஐ துவக்க 8 ஜிபி மைக்ரோ எஸ்டி கார்டு
SD கார்டு ரீடர்
X-NUCLEO-NFC05A1 ஐ ராஸ்பெர்ரி பைக்கான ராஸ்பெர்ரி பை அர்டுயினோ அடாப்டருடன் இணைக்கும் பிரிட்ஜ் போர்டு, பகுதி எண் ARPI600.

X-NUCLEO-NFC05A1. சமீபத்திய Raspberry Pi OS தேவைகளைப் பார்க்கவும்.

வன்பொருள் இணைப்புகள்

X-NUCLEO-NFC600A05 ஐ Raspberry Pi உடன் இணைக்க ARPI1 Raspberry Pi முதல் Arduino அடாப்டர் பலகை பயன்படுத்தப்படுகிறது. X-NUCLEO-NFC05A1 உடன் இணைக்க அடாப்டர் பலகையின் ஜம்பர்களை மாற்றியமைக்க வேண்டியது அவசியம்.

எச்சரிக்கை: ARPI600, Arduino IOREF பின்னுக்கு 5 V தவறாக வழங்குகிறது. X-NUCLEO-NFC05A1 ஐ சில பின்களில் நேரடியாக இணைப்பது 5 V பின்னூட்டங்களை மீண்டும் தருகிறது, இது ராஸ்பெர்ரி பை பலகையை சேதப்படுத்தக்கூடும். குறிப்பாக ராஸ்பெர்ரி பை 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

லினக்ஸ் சூழல் அமைப்பு

ராஸ்பெர்ரி பை துவக்குதல்

லினக்ஸ் சூழலை அமைக்க, முதல் படி, கீழே விளக்கப்பட்டுள்ளபடி, ராஸ்பெர்ரி பை OS உடன் ராஸ்பெர்ரி பை 4 ஐ நிறுவி துவக்க வேண்டும்:

படி 1

இணைப்பிலிருந்து சமீபத்திய Raspberry Pi OS படத்தைப் பதிவிறக்கவும்:

https://www.raspberrypi.com

டெஸ்க்டாப்புடன் கூடிய Raspberry Pi OS ஐத் தேர்வுசெய்யவும். கீழே உள்ள சோதனைகளுக்கு பின்வரும் பதிப்பு பயன்படுத்தப்பட்டது: செப்டம்பர் 2022 (2022-09-22-raspios-bullseye-armhf.img.xz).

படி 2

"SD அட்டைக்கு ஒரு படத்தை எழுதுதல்" என்ற பிரிவில் உள்ள வழிமுறைகளைப் பின்பற்றி, Raspberry Pi படத்தை அவிழ்த்து SD அட்டையில் எழுதவும்.

படி 3

வன்பொருளை இணைக்கவும்:

ஒரு நிலையான HDMI கேபிளைப் பயன்படுத்தி ராஸ்பெர்ரி பை-ஐ ஒரு மானிட்டருடன் இணைக்கவும்.
ராஸ்பெர்ரி பையின் USB போர்ட்களுடன் மவுஸ் மற்றும் கீபோர்டை இணைக்கவும்.

ssh ஐப் பயன்படுத்தி Raspberry Pi உடன் வேலை செய்வதும் சாத்தியமாகும். அந்தச் சூழ்நிலையில், Raspberry Pi உடன் மானிட்டர், விசைப்பலகை மற்றும் மவுஸை இணைக்க வேண்டிய அவசியமில்லை. ஒரே தேவை என்னவென்றால், ssh உடன் கூடிய PC ஐ Raspberry Pi போன்ற அதே நெட்வொர்க்கிற்குள் வைத்திருப்பது மற்றும் அதற்கேற்ப IP முகவரியை உள்ளமைப்பதுதான்.

படி 4

SD கார்டு மூலம் ராஸ்பெர்ரி பை-ஐ துவக்கவும்.

துவக்கிய பிறகு, டெபியன் அடிப்படையிலான லினக்ஸ் டெஸ்க்டாப் மானிட்டரில் தோன்றும்.

குறிப்பு: சில நேரங்களில், ராஸ்பெர்ரி பை-ஐ துவக்கிய பிறகு, சில விசைப்பலகை விசைகள் வேலை செய்யாமல் போவதைக் காணலாம். அவற்றை வேலை செய்ய, திறக்கவும் file /etc/default/keyboard ஐ அழுத்தி XKBLAYOUT=”us” என அமைத்து Raspberry Pi ஐ மீண்டும் துவக்கவும்.

ராஸ்பெர்ரி பை-யில் SPI-ஐ இயக்கு.

கர்னலுக்குள் இருக்கும் SPI இயக்கி, SPI வழியாக X-NUCLEO-NFC05A1 உடன் தொடர்பு கொள்கிறது. Raspberry Pi OS/kernel உள்ளமைவில் SPI ஏற்கனவே இயக்கப்பட்டுள்ளதா என்பதைச் சரிபார்க்க வேண்டியது அவசியம்.
Raspberry Pi சூழலில் /dev/spidev0.0 தெரிகிறதா என்று சரிபார்க்கவும். அது தெரியவில்லை என்றால், கீழே விவரிக்கப்பட்டுள்ள படிகளைப் பின்பற்றி “raspi-config” பயன்பாட்டைப் பயன்படுத்தி SPI இடைமுகத்தை இயக்கவும்.

படி 1

ராஸ்பெர்ரி பை-யில் ஒரு புதிய முனையத்தைத் திறந்து, "raspi-config" கட்டளையை ரூட்டாக இயக்கவும்:

sudo raspi-config

இந்தப் படி ஒரு வரைகலை இடைமுகத்தைத் திறக்கிறது.

படி 2

வரைகலை இடைமுகத்தில் “இடைமுக விருப்பங்கள்” என்ற விருப்பத்தைத் தேர்ந்தெடுக்கவும்.

படி 3

இந்தப் படிநிலை பல்வேறு விருப்பங்களை பட்டியலிடுகிறது.
"SPI" என்ற பெயரிடப்பட்ட விருப்பத்தைத் தேர்ந்தெடுக்கவும்.
பின்வரும் உரையுடன் ஒரு புதிய சாளரம் தோன்றும்:
"SPI இடைமுகம் இயக்கப்பட வேண்டுமா?"

படி 4

தேர்ந்தெடுக்கவும் இந்த சாளரத்தில் SPI ஐ இயக்க.

படி 5

ராஸ்பெர்ரி பையை மீண்டும் துவக்கவும்.
மேலே உள்ள படிகள் மறுதொடக்கத்திற்குப் பிறகு ராஸ்பெர்ரி பை சூழலில் SPI இடைமுகத்தை இயக்கும்.

RFAL நூலகம் மற்றும் பயன்பாட்டின் கட்டமைப்பு

லினக்ஸின் RFAL டெமோ ஒரு காப்பகத்தில் வழங்கப்பட்டுள்ளது. அதன் பெயர்: என்று வைத்துக்கொள்வோம்.
ST25R3911B_v2.8.0_Linux_demo_v1.0.tar.xz.
ராஸ்பெர்ரி பையில் RFAL நூலகத்தையும் பயன்பாட்டையும் உருவாக்க, பின்வரும் படிகளைப் பின்பற்றவும்:

படி 1

முகப்பு கோப்பகத்திலிருந்து கீழே உள்ள கட்டளையைப் பயன்படுத்தி ராஸ்பெர்ரி பையில் தொகுப்பை அன்சிப் செய்யவும்:

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

படி 2

முன்பு செய்யவில்லை என்றால், கீழே உள்ள கட்டளையைப் பயன்படுத்தி cmake ஐ நிறுவவும்:

apt-get நிறுவ cmake

RFAL நூலகம் மற்றும் பயன்பாட்டு உருவாக்க அமைப்பு cmake ஐ அடிப்படையாகக் கொண்டது, இந்த காரணத்திற்காக தொகுப்பைத் தொகுக்க cmake ஐ நிறுவ வேண்டியது அவசியம்.

படி 3

RFAL நூலகம் மற்றும் பயன்பாட்டை உருவாக்க, “build” கோப்பகத்திற்குச் செல்லவும்:

சிடி ST25R3911B_v2.8.0_லினக்ஸ்_டெமோ_v1.0/லினக்ஸ்_டெமோ/கட்டமைப்பு

கீழே உள்ள கட்டளையை அங்கிருந்து இயக்கவும்:

சிமேக் ..

மேலே உள்ள கட்டளையில் “..” என்பது உயர் நிலை CMakeLists.txt என்பது பெற்றோர் கோப்பகத்தில் இருப்பதைக் குறிக்கிறது, அதாவது
ST25R3911B_v2.8.0_Linux_demo_v1.0.

cmake கட்டளை make ஐ உருவாக்குகிறது.file இது நூலகம் மற்றும் பயன்பாட்டை உருவாக்க அடுத்த கட்டத்தில் பயன்படுத்தப்படுகிறது.

படி 4

RFAL நூலகம் மற்றும் பயன்பாட்டை உருவாக்க “make” கட்டளையை இயக்கவும்:

செய்ய

"make" கட்டளை முதலில் RFAL நூலகத்தை உருவாக்குகிறது, பின்னர் அதன் மேல் பயன்பாட்டை உருவாக்குகிறது.

பயன்பாட்டை எவ்வாறு இயக்குவது

வெற்றிகரமான உருவாக்கம் பின்வரும் இடத்தில் “nfc_demo_st25r3911b” என்ற பெயரிடப்பட்ட ஒரு இயங்கக்கூடியதை உருவாக்குகிறது:
/கட்டமைப்பு/பயன்பாடுகள்.

முன்னிருப்பாக, பயன்பாடு ST25R3911B_v2.8.0_Linux_demo_v1.0/linux_demo/build: என்ற பாதையிலிருந்து ரூட் உரிமைகளுடன் இயக்கப்பட வேண்டும்.

சூடோ ./டெமோ/nfc_டெமோ_st25r3911b

பயன்பாடு NFC-க்காக வாக்களிக்கத் தொடங்குகிறது. tags மற்றும் மொபைல் போன்கள். படம் 7 இல் காட்டப்பட்டுள்ளபடி, இது கண்டுபிடிக்கப்பட்ட சாதனங்களை அவற்றின் UID உடன் காட்டுகிறது.

படம் 7. கண்டுபிடிக்கப்பட்ட சாதனங்களின் காட்சி

பயன்பாட்டை முடிக்க Ctrl + C ஐ அழுத்தவும்.

சரிபார்ப்பு வரலாறு

அட்டவணை 1. ஆவண திருத்த வரலாறு

அட்டவணைகள் பட்டியல்

அட்டவணை 1. ஆவண திருத்த வரலாறு . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

புள்ளிவிவரங்களின் பட்டியல்

படம் 1. லினக்ஸ் இயங்குதளத்தில் RFAL நூலகம் .
படம் 2. லினக்ஸில் RFAL மென்பொருள் கட்டமைப்பு .
படம் 3. வன்பொருள் இணைப்பு சரிசெய்தல் .
படம் 4. அடாப்டர் போர்டில் A5, A4, A3, A2, A1 மற்றும் A0 ஜம்பர்களின் நிலை.
படம் 5. வன்பொருள் அமைவு மேல் view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
படம் 6. வன்பொருள் அமைவு பக்கம் view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
படம் 7. கண்டுபிடிக்கப்பட்ட சாதனங்களின் காட்சி .

முக்கிய அறிவிப்பு - கவனமாகப் படியுங்கள்

STMicroelectronics NV மற்றும் அதன் துணை நிறுவனங்கள் ("ST") எந்த நேரத்திலும் அறிவிப்பு இல்லாமல் ST தயாரிப்புகள் மற்றும்/அல்லது இந்த ஆவணத்தில் மாற்றங்கள், திருத்தங்கள், மேம்பாடுகள், மாற்றங்கள் மற்றும் மேம்பாடுகளைச் செய்வதற்கான உரிமையை கொண்டுள்ளது. ஆர்டர் செய்வதற்கு முன், ST தயாரிப்புகள் குறித்த சமீபத்திய தொடர்புடைய தகவலை வாங்குபவர்கள் பெற வேண்டும். ஆர்டர் ஒப்புகையின் போது ST இன் விதிமுறைகள் மற்றும் விற்பனை நிபந்தனைகளுக்கு இணங்க ST தயாரிப்புகள் விற்கப்படுகின்றன.

ST தயாரிப்புகளின் தேர்வு, தேர்வு மற்றும் பயன்பாட்டிற்கு வாங்குபவர்கள் மட்டுமே பொறுப்பாவார்கள் மற்றும் விண்ணப்ப உதவி அல்லது வாங்குபவர்களின் தயாரிப்புகளின் வடிவமைப்பிற்கு ST எந்தப் பொறுப்பையும் ஏற்காது.

எந்தவொரு அறிவுசார் சொத்துரிமைக்கான உரிமம், வெளிப்படையான அல்லது மறைமுகமாக, இங்கு எஸ்டியால் வழங்கப்படவில்லை.

இங்கு குறிப்பிடப்பட்டுள்ள தகவலில் இருந்து வேறுபட்ட விதிமுறைகளுடன் ST தயாரிப்புகளை மறுவிற்பனை செய்வது, அத்தகைய தயாரிப்புக்கு ST வழங்கிய எந்த உத்தரவாதத்தையும் ரத்து செய்யும்.

ST மற்றும் ST லோகோ ST இன் வர்த்தக முத்திரைகள். ST வர்த்தக முத்திரைகள் பற்றிய கூடுதல் தகவலுக்கு, பார்க்கவும் www.st.com/trademarks. மற்ற அனைத்து தயாரிப்பு அல்லது சேவை பெயர்களும் அந்தந்த உரிமையாளர்களின் சொத்து.

இந்த ஆவணத்தில் உள்ள தகவல், இந்த ஆவணத்தின் முந்தைய பதிப்புகளில் வழங்கப்பட்ட தகவலை மாற்றியமைக்கிறது மற்றும் மாற்றுகிறது.

ஆவணங்கள் / ஆதாரங்கள்

STMicroelectronics UM2375 Linux இயக்கி [pdf] பயனர் கையேடு
UM2375 லினக்ஸ் டிரைவர், UM2375, லினக்ஸ் டிரைவர், டிரைவர்

குறிப்புகள்

பயனர் கையேடு