UM3078 ST25DVXXKC Linux notendarýmisbílstjóri

Inngangur

Þetta skjal sýnir hvernig á að nota STSW-ST25DV009 hugbúnaðarpakkann til að stjórna ST25DVXXKC kraftmiklum NFC tag frá Linux® vettvangi. STSW-ST25DV009 hugbúnaðarpakkinn býður upp á Linux® notendarýmisrekla og nokkur tdamples sem hægt er að stilla til að keyra á hvaða Linux® vettvang sem er. ST25DVXXKC er NFC kraftmikill tag, sem hægt er að stjórna með RFID lesanda eða með NFC síma, það hefur einnig I2C tengi til að hafa samskipti við MCU eða MPU. ST25DVXXKC er fáanlegur, tdample, á X-NUCLEO-NFC07A1 stækkunarborðinu. Upplýsingar og skjöl sem tengjast NFC íhlutunum, X-NUCLEO-NFC07A1 stækkunartöflunni og STSWST25DV009 hugbúnaðinum eru fáanlegar á www.st.com.

Tilgangur

ST25DVXXKC kraftmikið NFC/RFID tags eru samþættar hringrásir sem geta átt samskipti við bæði:

• RFID lesarar og NFC símar, byggðir á ISO/IEC 15693 og NFC Forum Type 5 tag forskriftir.
• MCU eða MPU sem notar I2C tengi.

Þessi tæki er hægt að nota á Linux vettvangi til að gera þráðlaus samskipti, til að flytja gögn auðveldlega frá Linux vettvangi yfir í snjallsíma (til dæmis: URL, GPS hnit, Out-of-Band pörunargögn og svo framvegis). STSW-ST25DV009 hugbúnaðarpakkinn veitir nauðsynlegan kóða til að stjórna ST25DVXXKC tæki frá notendarými Linux vettvangs með I2C stjórnanda.

Uppbygging hugbúnaðar

STSW-ST25DV009 hugbúnaðinum er skipt í nokkur lög:

• ST25DVXXKC hluti bílstjóri
• Stuðningspakki stjórnar
• Miðhugbúnaður NDEF bókasafns
• Sample verkefnakóðar

ST25DVXXKC hluti bílstjóri
ST25DVXXKC íhlutarekillinn veitir aðferðir til að stilla og stjórna ST25DVXXKC tæki. Þessi hluti kóðans er óháður vélbúnaði og það krefst þess að nokkrar grunn IO aðgerðir séu innleiddar (sjá kafla 2.2 Stjórnarstuðningspakka) eins og I2C lestur/skrif, gpio stjórn. ST25DVXXKC íhluta bílstjóri files eru í Drivers/BSP/Components/ST25DVxxKC skránni.

Stuðningspakki stjórnar
Stjórnarstuðningspakkinn útfærir tvo mismunandi þætti:

• IO-aðgerðirnar á lágu stigi sem ST25DVXXKC íhlutarstjórinn kallar á
• API fyrir ST25DVXXKC íhluta ökumannsaðferðum

Stjórnarstuðningspakkinn files eru í Drivers/BSP/Linux skránni.

IO aðgerðir á lágu stigi
Lágmarks IO lagið útfærir allar lágstigsaðgerðir sem ST25DVXXKC bílstjórinn krefst. Þetta lag er útfært í Drivers/BSP/Linux skránni með files sem lýst er í töflu 1.

Files	Lýsing
	Þessar files innleiða aðgerðir til að:
st25dv-i2c_linux.c	• Stilla, lesa og skrifa I2C viðmótið
st25dv-i2c_linux.h	• Fáðu millisekúndu hak
	Þessi kóði byggir á /dev/i2c-X file að ná stjórn á I2C jaðartækinu.
st25dv-i2c-gpo.c st25dv-i2c-gpo.h	Þessar files innleiða aðgerðir til að stilla og taka á móti truflunum frá GPO pinna á ST25DVXXKC. Þessi kóði notar /dev/gpiochipX file og sérstakur þráður til að skoða viðburð á GPIO.
st25dv-i2c-lpd.c st25dv-i2c-lpd.h	Þessar files innleiða aðgerðirnar til að stilla og stjórna lágspennu á ST25DVXXKC. Þessi kóði notar eftirfarandi files til að stjórna GPIO: •/sys/class/gpio/export •/sys/class/gpio/gpioXX/átt • /sys/class/gpio/gpioXX/value.

Þessar aðgerðir eru sértækar fyrir borðið sem notað er og verður að aðlaga að þeim vettvangi sem þær eru notaðar á (sjá kafla 3 Hvernig á að stilla borð).

API við ST25DVXXKC ökumannsaðferðirnar
Þetta API er aðeins umbúðir utan um ST25DVXXKC íhluta rekilinn. Það er útfært í Drivers/BSP/Linux/bsp_nfctag.c og Drivers/BSP/Linux/bsp_nfctag.h files.

Miðhugbúnaður NDEF bókasafns
NFC Forum skilgreinir staðlað snið til að nota þegar lesið er/skrifað NFC tæki. Þetta snið er þekkt sem
NDEF skilaboð. NDEF bókasafnið útfærir hágæða aðferðir til að forsníða gögn auðveldlega í NDEF samhæft
hátt. Þetta STMicroelectronics bókasafn er afhent sem millihugbúnaður, algjörlega óháður vélbúnaði og
koma með viðmóti file á að innleiða fyrir markvettvanginn.
Í STSW-ST25DV009 hugbúnaðarpakkanum eru þessi viðmót files eru útfærð í:

• Verkefni\NDEF_URI\Src\lib_NDEF_config.c
• Verkefni\NDEF_BLUETOOTH\Src\lib_NDEF_config.c

Miðbúnaður NDEF bókasafnsins files eru í Middlewares/ST/lib_nfc skránni

Sample verkefni
Í þessum kafla, stutt yfirview á sampLe verkefni sem eru innifalin í STSW-ST25DV009 pakkanum eru veitt. sampLe verkefni:

• verður að aðlaga að markvissa Linux pallinum (eins og útskýrt er í kafla 3 Hvernig á að stilla borð)
• sýna notandanum hvernig á að nota API til að frumstilla og nota kraftmikið NFC/RFID á réttan hátt tag IC (ST25DVxxKC tæki)

SampLe verkefnin eru í ./Projects skránni.

• NDEF_URI
  Þetta forrit sýnir hvernig á að skrifa einföld URI NDEF skilaboð á ST25DVXXKC EEPROM með því að nota NDEF lib millihugbúnaðinn. Skilaboð birtast þegar búið er að skrifa skilaboðin. Hægt er að nota snjallsíma eða NFC lesanda til að lesa NDEF_URI skilaboðin.
• NDEF_BLUETOOTH
  Þetta forrit sýnir hvernig á að skrifa Bluetooth® OOB NDEF skilaboð á ST25DVXXKC EEPROM með því að nota NDEF lib millihugbúnaðinn. Skilaboð birtast þegar búið er að skrifa skilaboðin. Hægt er að nota snjallsíma eða NFC lesanda til að lesa NDEF_BLUETOOTH skilaboðin.
• GPO (úttak fyrir almennan tilgang)
  Þetta frvampLe sýnir hvernig á að virkja og nota GPO. Eftir frumstillingu er truflun forrituð til að greina svæðisbreytingar í nálægð við ST25DVXXKC. Skilaboð birtast þegar reiturinn greinist og þegar reiturinn hverfur.
• I2CVERND
  Þetta frvampLe sýnir hvernig á að búa til svæði í ST25DVXXKC og hvernig á að vernda þau. Texti birtist á stjórnborðinu.
• LPD (lágt rafmagnsleysi)
  Þetta frvampLe sýnir hvernig á að virkja lágspennu (LPD) pinna. Með því að slá inn „1“ eða „0“ er LPD pinninn virkjaður eða óvirkur. Þegar LPD pinnan er virkjuð er ST25DVXXKC VCC slökkt, orkunotkunin er í lágmarki og samskipti í gegnum I2C eru ekki tiltæk.
  Athugið: Ekki er hægt að keyra þessa prófun með X-NUCLEO-NFC07A1 stækkunarborðinu þar sem borðið tengir ekki slíkan pinna.
• Pósthólf
  Þetta frvampLe sýnir hvernig á að skrifa skilaboð í pósthólfið og hvernig á að lesa pósthólfsstöðuskrá ST25DVXXKC tækisins. Textinn birtist.
• I2CCrás
  Þetta frvampLe sýnir hvernig á að breyta I2C þrælsfangi og sýnir að það að skrifa skilaboð í pósthólfið og lesa pósthólfsstöðuskrá ST25DVXXKC tækisins virkar bæði með nýju þrælsfangi. Textinn birtist og I2C þrælsfangið er breytt í sjálfgefið gildi.
  Athugið: Ef notandi stöðvar forritið áður en því lýkur, þarf að nota viðeigandi I2C þrælsfang fyrir síðari samskipti við ST25DVXXKC.
• I2CMode
  Þetta frvampLe sýnir hvernig á að breyta I2C þrælastillingu (venjulegur/RF slökktur) og að með I2C þrælastillingu stillt á 'RFOFF' er ekki lengur sinnt NFC samskiptum á meðan með I2C þrælastillingu stillt á 'Eðlilegt' er unnið úr NFC samskiptum.

Hvernig á að stilla borð

Stuðningspakkalagið verður að aðlagast örlítið að Linux pallinum sem miðar á, til að velja I2C jaðartæki til að hafa samskipti við ST25DVXXKC og GPIO eru tengd við ST25DVXXKC GPO og LPD pinna. Allar nauðsynlegar skilgreiningar eru taldar upp hér á eftir file: Ökumenn/BSP/Linux/hwconfig.h.

Tafla 2. Skilgreining vélbúnaðarstillingar:

Eiginleiki	Skilgreina	Lýsing
I2C	ST25DV_I2C_NR	Það skilgreinir I2C jaðarnúmerið sem notað er til að hafa samskipti við ST25DVXXKC. Gildið er notað til að klára slóðina að /dev/i2c-X file.
GPO	ST25DV_GPO_GPIOCHIP	Það skilgreinir GPIOCHIP númerið sem er tengt við ST25DVXXKC GPO pinna. Gildið er notað til að klára slóðina að /dev/gpiochipX file.
	ST25DV_GPO_PIN	Það skilgreinir GPIO pinnanúmer GPIOCHIP sem er tengt við ST25DVXXKC GPO pinna.
LPD	ST25DV_LPD_PIN	Það skilgreinir alþjóðlega GPIO pinnanúmerið sem er tengt við ST25DVXXKC LPD pinna. Það er notað til að flytja út þennan GPIO.
	ST25DV_LPD_DIRECTION	Það skilgreinir leiðina að Linux file skilgreina GPIO stefnuna sem er tengd við ST25DVXXKC LPD pinna eins og: /sys/class/gpio/gpioXX/átt
	ST25DV_LPD_VALUE	Það skilgreinir leiðina að Linux file skilgreina GPIO gildi sem er tengt við ST25DVXXKC LPD pinna eins og: /sys/class/gpio/gpioXX/value

Uppsetning vélbúnaðar

Vélbúnaðarkröfur:

• Ubuntu-undirstaða PC/Virtual-machine útgáfa 16.04 eða nýrri
• STM32MP157F-DK2 borð (uppgötvunarsett)
• X-NUCLEO-NFC07A1
• 8 GB micro SD kort til að ræsa STM32MP157F-DK2
• SD kortalesari / LAN tenging
• USB Type-A til Type-micro B USB snúru (valfrjálst)
• USB Type A til Type-C USB snúru
• USB PD-samhæft 5V 3A aflgjafi

PC/Virtual-vélin myndar krossþróunarvettvanginn til að byggja upp sampumsóknarkóði le projects. Vélbúnaðurinn er tengdur sem hér segir:

1. Það fer eftir STM32MP157F-DK2 uppgötvunarborði I2C stillingarham (venjulegt, hratt, hratt+), X-NUCLEO-NFC07A1 stækkunarborð I2C uppdráttarviðnám (R5 og R6) má auka allt að 10 kΩ.
   
2. Tengdu X-NUCLEO-NFC07A1 stækkunartöfluna við Arduino® tengin neðst á STM32MP157F-DK2 uppgötvunarspjaldinu.
   
3. Ef þörf krefur, tengdu ST-LINK forritarann/kembiforritið sem er innbyggður á uppgötvunarspjaldið við hýsingartölvu í gegnum USB micro B tegund tengi (CN11).
4. Kveiktu á uppgötvunarspjaldinu í gegnum USB Type C tengið (CN6).
   

Að setja saman og keyra sample verkefni

Hver STSW-ST25DV009 sampLe verkefnið kemur með gerðfile og hægt er að safna saman með C þýðanda eins og GCC. pthread Linux bókasafnið er notað til að búa til þráð sem greinir atburð á GPO línunni, þetta bókasafn er nauðsynlegt fyrir rétta tengingu við samantektartíma. Samantekt og keyrsluferli:

1. Á PC gestgjafa:
   • afritaðu allt ST25DVLinux tré files í tölvu/sýndarvél: scp -r :.
2. Á tölvu/sýndarvél:
   • krosssamstilla forritið (þetta býr til statískt tengda keyrslu file): cd ~//Projects/ gera allt hreint
   • afrita exe file á Linux markborð (RPi, STM32MP157F-DK2, …): scp ~//Projects//st25dv-i2c_ root@:.
3. Á STM32MP157F-DK2 borði:
   • keyra afritað exe file: chmod +x st25dv-i2c_ ./st25dv-i2c_

Endurskoðunarsaga 

MIKILVÆG TILKYNNING - LESIÐU VARLEGA

STMicroelectronics NV og dótturfélög þess („ST“) áskilja sér rétt til að gera breytingar, leiðréttingar, endurbætur, breytingar og endurbætur á ST
vörur og/eða þessu skjali hvenær sem er án fyrirvara. Kaupendur ættu að fá nýjustu viðeigandi upplýsingar um ST vörur áður en þeir leggja inn pantanir. ST vörur eru seldar í samræmi við söluskilmála ST sem eru í gildi þegar pöntun er staðfest. Kaupendur bera einir ábyrgð á vali, vali og notkun ST vara og ST tekur enga ábyrgð á umsóknaraðstoð eða hönnun vöru kaupenda. Ekkert leyfi, óbeint eða óbeint, til nokkurs hugverkaréttar er veitt af ST hér. Endursala á ST vörum með öðrum ákvæðum en upplýsingarnar sem settar eru fram hér ógilda alla ábyrgð sem ST veitir fyrir slíka vöru. ST og ST merkið eru vörumerki ST. Fyrir frekari upplýsingar um ST vörumerki, sjá www.st.com/trademarks. Öll önnur vöru- eða þjónustuheiti eru eign viðkomandi eigenda. Upplýsingar í þessu skjali koma í stað og koma í stað upplýsinga sem áður hafa verið gefnar í fyrri útgáfum þessa skjals.
© 2022 STMicroelectronics – Allur réttur áskilinn

Skjöl / auðlindir

ST UM3078 ST25DVXXKC Linux notendarýmisbílstjóri [pdfNotendahandbók UM3078 ST25DVXXKC Linux User Space Driver, UM3078 ST25DVXXKC, UM3078, ST25DVXXKC, Linux User Space Driver, UM3078 Linux User Space Driver, ST25DVXXKC Linux User Space Driver, Linux User Driver, Linux User Drive Driver, Linux User Space Driver, Space Driver

Heimildir

• Notendahandbók