STMicroelectronics UM2375 Linux Driver Колдонуучу колдонмосу

STSW-ST25R009 Linux® драйвери Raspberry Pi 4ке ST05R1B жогорку натыйжалуу NFC универсалдуу түзүлүштү камтыган X-NUCLEO-NFC25A3911 менен иштөөгө мүмкүндүк берет.

Бул пакет X-NUCLEO-NFC4A05 микропрограммасы менен иштөө үчүн RF абстракция катмарын (RFAL) Raspberry Pi 1 Linux платформасына киргизет. Пакет s камсыз кылатampNFC ар кандай түрлөрүн аныктоочу колдонмо tags жана P2P колдогон уюлдук телефондор. RFAL ST25R NFC/RFID Reader ICs ST25R3911B, ST25R3912, ST25R3913, ST25R3914 жана ST25R3915 үчүн ST стандарттык драйвери. Ал, мисалы, ST25R3911B-DISCO микропрограммасы (STSW-ST25R002) жана X-NUCLEONFC05A1 микропрограммасы (X-CUBE-NFC5) тарабынан колдонулат.

STSW-ST25R009 бардык ST25R3911B төмөнкү катмар протоколдорун, ошондой эле байланыш үчүн кээ бир жогорку катмар протоколдорун колдойт. RFAL портативдүү түрдө жазылган, ошондуктан ал Linux® негизиндеги көптөгөн түзмөктөрдө иштей алат. Бул документ NFC/RF байланышы үчүн RFAL китепканасын стандарттык Linux тутумунда (бул учурда Raspberry Pi 4) кантип колдонсо болорун сүрөттөйт. Код абдан көчмө жана кандайдыр бир Linux платформасында кичине өзгөрүүлөр менен иштейт.

Сүрөт 1. Linux платформасындагы RFAL китепканасы

Бүттүview

Өзгөчөлүктөрү

25 Вт чыгаруу кубаттуулугу менен ST3911R25B/ST391R1.4x жогорку натыйжалуу NFC фронтондорун колдонуп, NFC иштетилген колдонмолорду куруу үчүн Linux колдонуучу мейкиндигинин толук драйвери (RF абстракция катмары)

SPI интерфейсин колдонуу менен ST25R3911B/ST25R391x менен Linux хост байланышы
Бардык негизги технологиялар жана жогорку катмар протоколдору үчүн толук 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®, ...)
Sample ишке ашыруу Raspberry Pi 05ке туташтырылган X-NUCLEO-NFC1A4 кеңейтүү тактасы менен жеткиликтүү

Sampбир нече 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. Linux боюнча RFAL программалык архитектурасы

Аппараттык камсыздоону орнотуу

Платформа колдонулат

Raspberry Pi OS менен Raspberry Pi 4 тактасы RFAL китепканасын куруу жана SPI аркылуу ST25R3911B менен өз ара аракеттенүү үчүн Linux платформасы катары колдонулат.
ST25R3911B Linux платформасындагы тиркемеге NFC түзмөктөрүн аныктоо жана байланышуу мүмкүнчүлүгүн берет.

Аппараттык талаптар

Raspberry Pi 4
Raspberry Pi OS жүктөө үчүн 8 Гбайт микро SD карта
SD карта окугуч
X-NUCLEO-NFC05A1ди Raspberry Pi үчүн Raspberry Pi Arduino адаптери менен туташтыруу үчүн көпүрө тактасы, бөлүктүн номери ARPI600.

X-NUCLEO-NFC05A1. Raspberry Pi OS акыркы талаптарын караңыз.

Аппараттык байланыштар

ARPI600 Raspberry Pi менен Arduino адаптер тактасы X-NUCLEO-NFC05A1ди Raspberry Pi менен туташтыруу үчүн колдонулат. Аны X-NUCLEO-NFC05A1 менен туташтыруу үчүн адаптер тактасынын секирүүлөрүн өзгөртүү талап кылынат.

Абайлаңыз: ARPI600 Arduino IOREF пинине 5 В туура эмес берет. X-NUCLEO-NFC05A1 түз тиркөө кээ бир төөнөгүчтөргө 5 В кайтарып берет, бул Raspberry Pi тактасына зыян келтириши мүмкүн. Айрыкча Raspberry Pi 4B+ чындыгында жок кылынганы тууралуу маалыматтар бар. Мындай абалды болтурбоо үчүн ARPI600 (бир кыйла татаал операция) же X-NUCLEO-NFC05A1 (жеңилирээк операция) ыңгайлаштырыңыз.

Эң оңой оңдоо - 6.2-сүрөттө көрсөтүлгөндөй X-NUCLEO-NFC05A1деги CN3 (IOREF) пинди кесүү.

Бул төөнөгүчтү кесүү Nucleo такталары (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB ж.б.) менен бирге иштөөгө таасирин тийгизбейт.

Сүрөт 3. Аппараттык байланышты оңдоо

Jumper жөндөө

5-сүрөттө көрсөтүлгөн A4, A3, A2, A1, A0 жана A4 үчүн секирүүчүлөрдү P23, P22, P21 жана CE1ге өзгөртүү керек. Бул секирүү жөндөөлөрү менен, Raspberry's GPIO PIN саны 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

Linux чөйрөсүн орнотуу

Raspberry Pi жүктөө

Linux чөйрөсүн орнотуу үчүн, биринчи кадам төмөндө түшүндүрүлгөндөй Raspberry Pi OS менен Raspberry Pi 4 орнотуу жана жүктөө болуп саналат:

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 портторуна туташтырыңыз.

Ошондой эле ssh аркылуу Raspberry Pi менен иштөөгө болот. Мындай учурда мониторду, клавиатураны жана чычканды Raspberry Pi менен туташтыруу талап кылынбайт. Жалгыз талап - Raspberry Pi менен бир тармактын ичинде ssh менен PC болушу жана IP дарегин ошого жараша конфигурациялоо.

4-кадам

SD карта менен Raspberry Pi жүктөө.

Жүктөөдөн кийин монитордо Debian негизиндеги Linux иш тактасы пайда болот.

Эскертүү: Кээде Raspberry Pi жүктөлгөндөн кийин кээ бир клавиатура баскычтары иштебей калганы байкалат. Аларды иштетүү үчүн, ачыңыз file /etc/default/keyboard жана XKBLAYOUT=”us” орнотуп, Raspberry Piди кайра жүктөңүз.

Raspberry Pi боюнча SPI иштетүү

Ядронун ичиндеги SPI драйвери SPI аркылуу X-NUCLEO-NFC05A1 менен байланышат. Raspberry Pi OS/ядро конфигурациясында SPI мурунтан эле иштетилгенин текшерүү маанилүү.
/dev/spidev0.0 Raspberry Pi чөйрөсүндө көрүнөөрүн текшериңиз. Эгер ал көрүнбөсө, төмөндө сүрөттөлгөн кадамдарды аткаруу менен “raspi-config” утилитасын колдонуп SPI интерфейсин иштетиңиз.

1-кадам

Raspberry Piде жаңы терминал ачып, "raspi-config" буйругун тамыр катары иштетиңиз:

sudo raspi-конфигурация

Бул кадам графикалык интерфейсти ачат.

2-кадам

Графикалык интерфейстен "Интерфейсация параметрлери" деп аталган параметрди тандаңыз.

3-кадам

Бул кадам ар кандай варианттарды тизмелейт.
"SPI" деп аталган параметрди тандаңыз.
Төмөнкү текст менен жаңы терезе пайда болот:
"SPI интерфейсинин иштетилишин каалайсызбы?"

4-кадам

Тандоо SPI иштетүү үчүн бул терезеде.

5-кадам

Raspberry Pi кайра жүктөө.
Жогорудагы кадамдар кайра жүктөөдөн кийин Raspberry Pi чөйрөсүндө SPI интерфейсин иштетет.

RFAL китепканасын жана тиркемесин түзүү

Linuxтун 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 орнотуу 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 китепканасын жана тиркемесин түзүү үчүн "жазуу" буйругун иштетиңиз:

жасоо

"Make" буйругу адегенде RFAL китепканасын курат, андан кийин анын үстүнө тиркемени курат.

Тиркемени кантип иштетүү керек

Ийгиликтүү куруу төмөнкү жерде “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. Linux платформасындагы RFAL китепканасы. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Сүрөт 2. Linux боюнча 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 Linux драйвери [pdf] Колдонуучунун колдонмосу
UM2375 Linux Driver, UM2375, Linux Driver, Driver

Шилтемелер

User Manual