STMicroelectronics UM2548 ሊኑክስ ሾፌር የተጠቃሚ መመሪያ

UM2548 ሊኑክስ ሾፌር
ሊኑክስ® ሹፌር ለ ST25R3916/ST25R3916B
የተጠቃሚ መመሪያ

ይዘቶች መደበቅ

5 የ RFAL ቤተ-መጽሐፍትን እና መተግበሪያን ይገንቡ

6 አፕሊኬሽኑን እንዴት ማስኬድ እንደሚቻል

7 ሰነዶች / መርጃዎች

7.1 ዋቢዎች

8 ተዛማጅ ልጥፎች

UM2548 ሊኑክስ ሾፌር

መግቢያ
STSW-ST25R013 የሊኑክስ ሾፌር Raspberry Pi® 4ን ከX-NUCLEO-NFCO6A1 እና X-NUCLEO-NFCO8A1 ቦርዶች ጋር እንዲሰራ ያስችለዋል፣ እነሱም በቅደም ተከተል ST25R3916 እና ST25R3916B መሣሪያዎች።
ይህ ፓኬጅ የ RF abstraction Layer (RFAL)ን ወደ Raspberry Pi 4 Linux ፕላትፎርም ከቦርዱ firmware ጋር ለመስራት እና ያቀርባልample መተግበሪያ የተለያዩ የ NFC ዓይነቶችን መለየት tags እና P2P የሚደግፉ ሞባይል ስልኮች። RFAL ለST25R3916 እና ST25R3916B ከፍተኛ አፈጻጸም ያለው የNFC ሁለንተናዊ መሳሪያዎች/EMVCo አንባቢ የST መደበኛ ሾፌር ነው። ጥቅም ላይ የሚውለው ለምሳሌ በST25R3916-DISCO firmware (STSW-ST25R010) እና በ X-NUCLEO-NFCO06A1 firmware (X-CUBE-NFC6) ነው።
STSW-ST25R013 ሁሉንም የ ST25R3916/ST25R3916B ዝቅተኛ-ንብርብር እና አንዳንድ ከፍተኛ የንብርብር ፕሮቶኮሎችን ለግንኙነት ይደግፋል። RFAL በተንቀሳቃሽ መንገድ የተፃፈ ነው, ስለዚህ በሊኑክስ ላይ በተመሰረቱ ሰፊ መሳሪያዎች ላይ ሊሠራ ይችላል. ይህ ሰነድ የ RFAL ቤተ-መጽሐፍት በመደበኛ ሊኑክስ ሲስተም (በዚህ አጋጣሚ Raspberry Pi 4) ለNFC/RF ግንኙነት እንዴት መጠቀም እንደሚቻል ይገልጻል። ኮዱ በጣም ተንቀሳቃሽ ነው እና በማንኛውም የሊኑክስ መድረክ ላይ በትንሽ ለውጦች ይሰራል።

አልቋልview

1.1 ባህሪያት

የ ST25R3916 እና ST25R3916B መሳሪያዎችን በመጠቀም NFC የነቁ አፕሊኬሽኖችን ለመገንባት የሊኑክስ ተጠቃሚ ቦታ ነጂ (RF abstraction Layer) ያጠናቅቁ

የሊኑክስ አስተናጋጅ ግንኙነት ከST25R3916/ST25R3916B ጋር የSPI በይነገጽን በመጠቀም
የተሟላ የ RF/NFC abstraction (RFAL) ለሁሉም ዋና ዋና ቴክኖሎጂዎች እና ከፍተኛ የንብርብር ፕሮቶኮሎች፡-
- NFC-A (ISO14443-A)
- NFC-B (ISO14443-B)
- NFC-F (FeliCa™)
- NFC-V (ISO15693)
- P2P (ISO18092)
ISO-DEP (አይኤስኦ የመረጃ ልውውጥ ፕሮቶኮል ፣ ISO14443-4)
- NFC-DEP (NFC የውሂብ ልውውጥ ፕሮቶኮል ፣ ISO18092)
- እንደ Kovio ፣ B' ፣ iClass ፣ Calypso® ያሉ የባለቤትነት ቴክኖሎጂዎች
Sample ትግበራ ከX-NUCLEO-NFC06A1 እና X-NUCLEO-NFC08A1 ማስፋፊያ ቦርዶች ጋር በ Raspberry Pi 4 ላይ ተሰክቷል

Sample መተግበሪያ በርካታ NFC ለማግኘት 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 መስመርን ለመቆጣጠር ነጂው በዚህ መስመር ላይ ስለሚደረጉ ለውጦች ማሳወቂያ ለማግኘት የሊብፒዮድ sysfs ይጠቀማል።

የሃርድዌር ማዋቀር

2.1 መድረክ ጥቅም ላይ ውሏል
Raspberry Pi 4 ቦርድ ከ Raspberry Pi OS ጋር የRFAL ቤተ-መጽሐፍትን ለመገንባት እና ከST25R3916/ST25R3916B ጋር በSPI ላይ ለመገናኘት እንደ ሊኑክስ መድረክ ያገለግላል።
መሳሪያዎቹ በሊኑክስ መድረክ ላይ ያለውን መተግበሪያ ከNFC መሳሪያዎች ጋር ለማግኘት እና ለመገናኘት ያስችላሉ።

2.2 የሃርድዌር መስፈርቶች

Raspberry Pi 4
Raspberry Pi OSን ለማስነሳት 8 ጂቢ ማይክሮ ኤስዲ ካርድ (ከቅርብ ጊዜ መስፈርቶች ጋር)

ኤስዲ ካርድ አንባቢ
X-NUCLEO-NFC06A1 ወይም X-NUCLEO-NFC08A1 ሰሌዳዎች
ቦርዱን ለማገናኘት ድልድይ ከ Raspberry Pi Arduino™ አስማሚ ለ Raspberry Pi (ክፍል ቁጥር ARPI600)

2.2.1 የሃርድዌር ግንኙነቶች
የ ARPI600 Raspberry Pi ወደ Arduino አስማሚ ሰሌዳዎቹን ከ Raspberry Pi ጋር ለማገናኘት ይጠቅማል። የአስማሚው ሰሌዳ መዝለያዎች ከ X-NUCLEO-NFC06A1 ወይም X-NUCLEO-NFC08A1 ቦርዶች ጋር ለመገናኘት መስተካከል አለባቸው።
ጥንቃቄ፡-
ARPI600 በስህተት 5V ለአርዱዪኖ IOREF ፒን ያቀርባል። በአንዳንድ ፒን ላይ የቦርዶቹን ምግቦች 5 ቮን በቀጥታ በማያያዝ ይህ የ Raspberry Pi ሰሌዳን ሊጎዳ ይችላል. የተበላሹ ሰሌዳዎች (በተለይ Raspberry Pi 4B+) ሪፖርቶች አሉ።
ይህንን ለማስቀረት ARPI600 (በጣም አስቸጋሪ የሆነ አሰራር) ወይም የ X-NUCLEO-NFC06A1/X-NUCLEONFC08A1 ሰሌዳን (ቀላል) ያመቻቹ።
በስእል 6.2 እንደሚታየው በ X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 ሰሌዳዎች ላይ በጣም ቀላሉ ማስተካከያ የ CN3 (IOREF) ፒን መቁረጥ ነው።
ይህን ፒን መቁረጥ ከኑክሊዮ ቦርዶች (እንደ NUCLO-L474RG, NUCLO-F401RE, NUCLO-8S208RB ያሉ) ጋር በመተባበር ቀዶ ጥገናውን አይጎዳውም.

የጃምፐር ቅንብር
በስእል 5 ላይ የሚታዩት የA4፣ A3፣ A2፣ A1፣ A0 እና A4 መዝለያዎች በቅደም ተከተል ወደ P25፣ P24፣ P23፣ P22፣ P21 እና CE1 መቀየር አለባቸው። በዚህ ቅንብር Raspberry's GPIO ፒን ቁጥር 7 ለX-NUCLEONFC06A1/X-NUCLEO-NFC08A1 የማቋረጫ መስመር ጥቅም ላይ ይውላል።

በአሁኑ ጊዜ፣ ይህ የ RFAL ቤተ-መጽሐፍት ወደብ ፒን GPIO7ን እንደ ማቋረጫ መስመር (በ jumper መቼቶች) ይጠቀማል። የማቋረጥ መስመርን ከ GPIO7 ወደ ሌላ GPIO ለመቀየር አስፈላጊ ከሆነ የመድረክ ልዩ ኮድ (በ file pltf_gpio.h) የማክሮ 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 ምስልን ይንቀሉት እና "ምስል ወደ ኤስዲ ካርድ መፃፍ" በሚለው ክፍል ውስጥ ያሉትን መመሪያዎች በመከተል በኤስዲ ካርዱ ላይ ይፃፉ።
ደረጃ 3
ሃርድዌሩን ያገናኙ፡

መደበኛ የኤችዲኤምአይ ገመድ በመጠቀም Raspberry Pi 4ን ከአንድ ማሳያ ጋር ያገናኙ።

መዳፊት እና የቁልፍ ሰሌዳ ከ Raspberry Pi ዩኤስቢ ወደቦች ጋር ያገናኙ።

እንዲሁም ssh በመጠቀም ከ Raspberry Pi ጋር መስራት ይቻላል. በዚህ ጉዳይ ላይ. ሞኒተሩን፣ ኪቦርድ እና መዳፊትን ከ Raspberry Pi ጋር ማገናኘት አያስፈልግም። ብቸኛው መስፈርት ፒሲ ከ ssh ጋር እንደ Raspberry Pi በተመሳሳይ አውታረ መረብ ውስጥ እንዲኖር ማድረግ እና የአይፒ አድራሻውን በዚህ መሠረት ማዋቀር ነው።
ደረጃ 4
Raspberry Pi 4ን በኤስዲ ካርድ ያስነሱ። ከተነሳ በኋላ በዴቢያን ላይ የተመሰረተ ሊኑክስ ዴስክቶፕ በማሳያው ላይ ይታያል።
ማስታወሻ፡-
አንዳንድ ጊዜ Raspberry Pi OSን ከጫኑ በኋላ አንዳንድ የቁልፍ ሰሌዳ ቁልፎች አይሰሩም። እንዲሰሩ ለማድረግ, ይክፈቱ file /ወዘተ/ነባሪ/የቁልፍ ሰሌዳ እና XKBLAYOUT=”እኛን” አዘጋጅ እና Raspberry Pi ን እንደገና አስነሳው።
3.2 SPI በ Raspberry Pi ላይ አንቃ
በከርነል ውስጥ ያለው የSPI ሾፌር ከX-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 ሰሌዳዎች በ SPI በኩል ይገናኛል። በ Raspbian Pi OS kernel ውቅር ውስጥ SPI አስቀድሞ መንቃቱን ማረጋገጥ አስፈላጊ ነው።
/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 ን ዳግም አስነሳ።
ከላይ ያሉት እርምጃዎች ዳግም ከተነሱ በኋላ በ 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 cmmake
የ RFAL ቤተ-መጽሐፍት እና የመተግበሪያ ግንባታ ስርዓት በ cmake ላይ የተመሰረቱ ናቸው, በዚህ ምክንያት ጥቅሉን ለማጠናቀር cmake መጫን ያስፈልጋል.
ደረጃ 3
የ RFAL ቤተ-መጽሐፍትን እና መተግበሪያን ለመገንባት፣ ወደ የግንባታ ማውጫ ይሂዱ
ሲዲ ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build
ከዚያ, ትዕዛዙን ያሂዱ
ማቅ..
ከላይ ባለው ትዕዛዝ "..." ከፍተኛ ደረጃ CMakeLists.txt በወላጅ ማውጫ ውስጥ መኖሩን ያመለክታል.
(ST25R3916_v2.8.0_Linux_demo_v1.0)።
ይህ ትእዛዝ ፈጠራን ይፈጥራልfile ቤተ-መጽሐፍትን እና መተግበሪያን ለመገንባት በሚቀጥለው ደረጃ ጥቅም ላይ ይውላል. ከዚያ ለST25R3916B ማሳያውን ለመገንባት የሚከተለውን ትዕዛዝ ያሂዱ
cmake -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
ማመልከቻው ለ NFC ድምጽ መስጠት ይጀምራል 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 SPI በ Raspberry Pi ላይ አንቃ፣ ክፍል 4 የ RFAL ቤተ-መጽሐፍትን እና መተግበሪያን ይገንቡ፣ እና ክፍል 5 አፕሊኬሽኑን እንዴት ማስኬድ እንደሚቻል። የተሻሻለ ምስል 1. የ RFAL ቤተ-መጽሐፍት በሊኑክስ መድረክ ላይ, ምስል 2. RFAL ሶፍትዌር አርክቴክቸር በሊኑክስ ላይ, እና ምስል 5. የሃርድዌር ማዋቀር ከፍተኛ view. በጠቅላላው ሰነድ ላይ አነስተኛ የጽሑፍ አርትዖቶች።

አስፈላጊ ማስታወቂያ - በጥንቃቄ ያንብቡ
STMicroelectronics NV እና ተባባሪዎቹ ("ST") በST ምርቶች እና/ወይም በዚህ ሰነድ ላይ ያለማሳወቂያ በማንኛውም ጊዜ ለውጦችን፣ እርማቶችን፣ ማሻሻያዎችን፣ ማሻሻያዎችን እና ማሻሻያዎችን የማድረግ መብታቸው የተጠበቀ ነው። ገዢዎች ትእዛዝ ከማስገባታቸው በፊት ስለ ST ምርቶች ወቅታዊ መረጃ ማግኘት አለባቸው። የST ምርቶች የሚሸጡት በትእዛዙ እውቅና ጊዜ በ ST የሽያጭ ውሎች እና ሁኔታዎች መሠረት ነው።
ገዥዎች የST ምርቶችን የመምረጥ፣ የመምረጥ እና የመጠቀም ሃላፊነት አለባቸው እና ST ለትግበራ እርዳታ ወይም ለገዥዎች ምርቶች ዲዛይን ምንም አይነት ሃላፊነት አይወስድም።
ለማንኛውም የአእምሯዊ ንብረት መብት ምንም አይነት ፍቃድ፣ ግልጽ ወይም በተዘዋዋሪ በST አይሰጥም።
የ ST ምርቶችን እንደገና መሸጥ በዚህ ውስጥ ከተገለጸው መረጃ የተለየ አቅርቦት በ ST ለእንደዚህ ዓይነቱ ምርት የሚሰጠውን ማንኛውንም ዋስትና ዋጋ ያጣል።
ST እና ST አርማ የST የንግድ ምልክቶች ናቸው። ስለ ST የንግድ ምልክቶች ተጨማሪ መረጃ ለማግኘት ይመልከቱ www.st.com/trademarks. ሁሉም ሌሎች የምርት ወይም የአገልግሎት ስሞች የየባለቤቶቻቸው ንብረት ናቸው።
በዚህ ሰነድ ውስጥ ያለው መረጃ ከዚህ ቀደም በማንኛውም የዚህ ሰነድ ቀደምት ስሪቶች ውስጥ የቀረበውን መረጃ ይተካዋል እና ይተካል።
© 2023 STMicroelectronics - ሁሉም መብቶች የተጠበቁ ናቸው

UM2548 - ራዕይ 2

ሰነዶች / መርጃዎች

STMicroelectronics UM2548 ሊኑክስ ነጂ [pdf] የተጠቃሚ መመሪያ
UM2548 ሊኑክስ ሾፌር፣ UM2548፣ ሊኑክስ ሾፌር፣ ሹፌር

ዋቢዎች

የተጠቃሚ መመሪያ