UM2548 Linux драйвері
Linux® ST25R3916/ST25R3916B драйвері
Пайдаланушы нұсқаулығы
UM2548 Linux драйвері
Кіріспе
STSW-ST25R013 Linux® драйвері Raspberry Pi® 4 жүйесіне сәйкесінше ST6R1 және ST8R1B құрылғыларын қамтитын X-NUCLEO-NFCO25A3916 және X-NUCLEO-NFCO25A3916 тақталарымен жұмыс істеуге мүмкіндік береді.
Бұл пакет RF абстракциялық қабатын (RFAL) Raspberry Pi 4 Linux платформасына тақтаның микробағдарламасымен жұмыс істеу үшін қосады және келесідей қамтамасыз етеді.ampNFC әртүрлі түрлерін анықтайтын қолданба tags және P2P қолдайтын ұялы телефондар. RFAL — ST25R3916 және ST25R3916B, жоғары өнімді NFC әмбебап құрылғылары / EMVCo оқырмандары үшін ST стандартты драйвері. Ол, мысалы, ST25R3916-DISCO микробағдарламасы (STSW-ST25R010) және X-NUCLEO-NFCO06A1 микробағдарламасы (X-CUBE-NFC6) арқылы пайдаланылады.
STSW-ST25R013 байланыс үшін барлық ST25R3916/ST25R3916B төменгі деңгейлі және кейбір жоғары деңгейлі протоколдарды қолдайды. RFAL портативті түрде жазылған, сондықтан ол Linux негізіндегі құрылғылардың кең ауқымында жұмыс істей алады. Бұл құжат NFC/RF байланысы үшін RFAL кітапханасын стандартты Linux жүйесінде (бұл жағдайда Raspberry Pi 4) қалай пайдалануға болатынын сипаттайды. Код өте портативті және кез келген Linux платформасында шамалы өзгерістермен жұмыс істейді.
Біттіview
1.1 Мүмкіндіктер
- ST25R3916 және ST25R3916B құрылғыларын пайдаланып NFC қосылған қолданбаларды құру үшін толық Linux пайдаланушы кеңістігі драйверін (RF абстракция қабаты) жасаңыз.
- SPI интерфейсі арқылы ST25R3916/ST25R3916B бар 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® сияқты меншікті технологиялар - Sampіске асыру Raspberry Pi 06 құрылғысына қосылған X-NUCLEO-NFC1A08 және X-NUCLEO-NFC1A4 кеңейту тақталарымен бірге қол жетімді
- Sampбірнеше NFC анықтауға арналған қолданба tag P2P қолдайтын түрлер мен ұялы телефондар
- Тегін пайдаланушыға ыңғайлы лицензия шарттары
1.2 Бағдарламалық жасақтаманың архитектурасы
2-суретте Linux платформасындағы RFAL кітапханасының бағдарламалық жасақтама архитектурасы детальдары көрсетілген.
RFAL платформа деп аталатынды бейімдеу арқылы басқа платформаларға оңай тасымалданады files.
Тақырып file rfal_platform.h платформа иесі қамтамасыз ететін және іске асыратын макрос анықтамаларын қамтиды.
Ол RFAL дұрыс жұмыс істеуі үшін қажетті GPIO тағайындауы, жүйелік ресурстар, құлыптар және IRQ сияқты платформаның арнайы параметрлерін қамтамасыз етеді.
Бұл демонстрация платформа функцияларын жүзеге асырады және Linux пайдаланушы кеңістігіне RFAL портын береді.
Ортақ кітапхана file RFAL қабаты қамтамасыз ететін функцияларды көрсету үшін демонстрациялық қолданба арқылы жасалады.
Linux хосты құрылғылармен SPI байланысын орындау үшін Linux пайдаланушы кеңістігінен қолжетімді sysfs интерфейсін пайдаланады. Linux ядросының ішінде SPI sysfs интерфейсі SPI кадрларын құрылғыларға/алу үшін Linux ядросының драйвері spidev пайдаланады.
ST25R3916 және ST25R3916B құрылғыларының INT желісін өңдеу үшін драйвер осы жолдағы өзгерістер туралы хабарландыру алу үшін libpiod sysfs пайдаланады.
Аппараттық құралды орнату
2.1 Пайдаланылған платформа
Raspberry Pi операциялық жүйесі бар Raspberry Pi 4 тақтасы RFAL кітапханасын құру және SPI арқылы ST25R3916/ST25R3916B өзара әрекеттесу үшін Linux платформасы ретінде пайдаланылады.
Құрылғылар NFC құрылғыларын анықтау және олармен байланысу үшін Linux платформасындағы қолданбаны қосады.
2.2 Аппараттық құралдарға қойылатын талаптар
- Raspberry Pi 4
- Raspberry Pi операциялық жүйесін жүктеу үшін 8 ГБ микро SD картасы (оның соңғы талаптарымен)
- SD картасын оқу құрылғысы
- X-NUCLEO-NFC06A1 немесе X-NUCLEO-NFC08A1 тақталары
- Raspberry Pi үшін Raspberry Pi Arduino™ адаптерімен тақтаны қосуға арналған көпір (бөлік нөмірі ARPI600)
2.2.1 Аппараттық құралдар қосылымдары
ARPI600 Raspberry Pi-ден Arduino адаптері тақталарды Raspberry Pi-ге қосу үшін пайдаланылады. Адаптер тақтасының секіргіштері оны X-NUCLEO-NFC06A1 немесе X-NUCLEO-NFC08A1 тақталарымен қосу үшін өзгертілуі керек.
Абайлаңыз:
ARPI600 Arduino IOREF істікшесіне 5 В дұрыс емес береді. Тақталарды тікелей бекіту кейбір түйреуіштерге 5 В кернеу береді, бұл Raspberry Pi тақтасын зақымдауы мүмкін. Бұзылған тақталар туралы хабарламалар бар (әсіресе Raspberry Pi 4B+).
Бұған жол бермеу үшін ARPI600 (өте қиын операция) немесе X-NUCLEO-NFC06A1/X-NUCLEONFC08A1 тақтасын (оңай) бейімдеңіз.
Ең оңай түзету - 6.2-суретте көрсетілгендей X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 тақталарындағы CN3 (IOREF) істікшесін кесу.
Бұл түйреуішті кесу Nucleo тақталарымен (NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB сияқты) бірге жұмыс істеуге әсер етпейді.
Секіргіш параметрі
5-суретте көрсетілген A4, A3, A2, A1, A0 және A4 секіргіштерін тиісінше P25, P24, P23, P22, P21 және CE1 етіп өзгерту керек. Бұл параметрмен Raspberry компаниясының GPIO істік нөмірі 7 X-NUCLEONFC06A1/X-NUCLEO-NFC08A1 үшін үзу сызығы ретінде пайдаланылады.
Қазіргі уақытта бұл RFAL кітапхана порты үзу сызығы ретінде GPIO7 істікшесін пайдаланады (секіргіш параметрлеріне сәйкес). Егер үзу сызығын GPIO7-ден басқа GPIO-ға өзгерту талап етілсе, платформаның арнайы коды (ішінде file pltf_gpio.h) үзу сызығы ретінде пайдалану үшін ST25R_INT_PIN макрос анықтамасын 7-ден жаңа GPIO пинге өзгерту үшін өзгертілуі керек.
Жоғарыдағы секіргіш параметрлерімен адаптер тақтасын келесі суреттерде көрсетілгендей X-NUCLEO NFC06A1 және X-NUCLEO-NFC08A1 Raspberry Pi тақтасына қосу үшін пайдалануға болады.
Linux ортасын орнату
3.1 Raspberry Pi жүктеу
Linux ортасын орнату үшін алдымен төменде түсіндірілгендей Raspberry Pi операциялық жүйесімен Raspberry Pi орнатып, жүктеңіз:
1-қадам
Raspberry Pi операциялық жүйесінің соңғы кескінін мына жерден жүктеп алыңыз https://www.raspberrypi.com, содан кейін жұмыс үстелі бар Raspberry Pi ОЖ таңдаңыз. Төмендегі сынақтар үшін 2022-09-22-raspios-bullseye-armhf.img.xz нұсқасы (2022 ж. қыркүйек) пайдаланылды.
2-қадам
Raspberry Pi OS кескінін ашыңыз және «SD картасына сурет жазу» бөліміндегі нұсқауларды орындау арқылы оны SD картасына жазыңыз.
3-қадам
Аппараттық құралды қосыңыз:
- Raspberry Pi 4 құрылғысын стандартты HDMI кабелі арқылы мониторға қосыңыз.
- Тінтуір мен пернетақтаны Raspberry Pi USB порттарына қосыңыз.
Сондай-ақ ssh көмегімен Raspberry Pi-мен жұмыс істеуге болады. Бұл жағдайда. мониторды, пернетақтаны және тінтуірді Raspberry Pi арқылы қосу қажет емес. Жалғыз талап - Raspberry Pi сияқты бір желіде ssh бар ДК болуы және сәйкесінше IP мекенжайын конфигурациялау.
4-қадам
Raspberry Pi 4 құрылғысын SD картасымен жүктеңіз. Жүктелгеннен кейін мониторда Debian негізіндегі Linux жұмыс үстелі пайда болады.
Ескерту:
Кейде Raspberry Pi операциялық жүйесін жүктегеннен кейін кейбір пернетақта пернелері жұмыс істемейді. Оларды жұмыс істеу үшін ашыңыз file /etc/default/keyboard және XKBLAYOUT=”us” орнатып, Raspberry Pi қайта жүктеңіз.
3.2 Raspberry Pi жүйесінде SPI қосыңыз
Ядро ішіндегі SPI драйвері SPI арқылы X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 тақталарымен байланысады. Raspbian Pi OS ядросының конфигурациясында SPI әлдеқашан қосылғанын тексеру маңызды.
/dev/spidev0.0 Raspberry Pi ортасында көрінетінін тексеріңіз. Егер ол көрінбесе, төменде сипатталған қадамдарды орындау арқылы «raspi-config» утилитасын пайдаланып SPI интерфейсін қосыңыз.
1-қадам
Raspberry Pi жүйесінде жаңа терминалды ашыңыз және root ретінде «raspi-config» пәрменін іске қосыңыз: sudo raspi-config
Бұл қадам графикалық интерфейсті ашады.
2-қадам
Графикалық интерфейсте «Интерфейс параметрлері» деп аталатын опцияны таңдаңыз.
3-қадам
Бұл қадам әртүрлі опцияларды тізімдейді.
«SPI» деп аталатын опцияны таңдаңыз.
Келесі мәтінмен жаңа терезе пайда болады:
«SPI интерфейсінің қосылғанын қалайсыз ба?»
4-қадам
таңдаңыз SPI қосу үшін осы терезеде.
5-қадам
Raspberry Pi қайта жүктеңіз.
Жоғарыда көрсетілген қадамдар қайта жүктеуден кейін Raspberry Pi ортасында SPI интерфейсін қосады.
RFAL кітапханасы мен қолданбасын құрастырыңыз
Linux жүйесінің 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 орнату cmake
RFAL кітапханасы және қолданбаларды құрастыру жүйесі cmake негізінде жасалған, сондықтан пакетті құрастыру үшін cmake орнату қажет.
3-қадам
RFAL кітапханасы мен қолданбасын құру үшін құрастыру каталогына өтіңіз
cd ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build
Сол жерден пәрменді іске қосыңыз
cmake..
Жоғарыдағы пәрмендегі “..” жоғарғы деңгейлі CMakeLists.txt негізгі каталогта бар екенін көрсетеді
(ST25R3916_v2.8.0_Linux_demo_v1.0).
Бұл пәрмен жасауды жасайдыfile кітапхана мен қолданбаны құру үшін келесі қадамда пайдаланылады. Сол жерден ST25R3916B демонстрациясын құру үшін келесі пәрменді орындаңыз
cmake -DRFAL_VARIANT=st25r3916b ..
4-қадам
RFAL кітапханасы мен қолданбасын құру үшін make пәрменін іске қосыңыз:
жасау
Бұл пәрмен алдымен RFAL кітапханасын, содан кейін оның үстіне қосымшаны құрастырады.
Қолданбаны қалай іске қосу керек
Сәтті құрастыру /build/demo орнында “nfc_poller_st25r3916” немесе “nfc_poller_st25r3916b” деп аталатын орындалатын файлды жасайды.
Әдепкі бойынша қолданба ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build/demo/ жолынан түбірлік құқықтармен іске қосылуы керек:
sudo ./nfc_demo_st25r3916
Қолданба NFC үшін сұрауды бастайды tags және ұялы телефондар, содан кейін 7-суретте көрсетілгендей, табылған құрылғыларды UID арқылы көрсетеді.
Қолданбаны тоқтату үшін 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 бөлімі Raspberry Pi жүйесінде SPI қосу, 4-бөлім RFAL кітапханасы мен қолданбасын құру, және 5-бөлім Қолданбаны іске қосу жолы. Жаңартылған 1-сурет. Linux платформасындағы RFAL кітапханасы, 2-сурет. RFAL бағдарламалық жасақтамасының архитектурасы Linux жүйесінде және 5-сурет. Аппараттық құралды орнатудың жоғарғы жағы view. Бүкіл құжат бойынша шағын мәтіндік өңдеулер. |
МАҢЫЗДЫ ЕСКЕРТПЕ – МҰҚИЯТ ОҚЫҢЫЗ
STMicroelectronics NV және оның еншілес компаниялары («СТ») ST өнімдеріне және/немесе осы құжатқа кез келген уақытта ескертусіз өзгерістер, түзетулер, жақсартулар, өзгертулер және жақсартулар енгізу құқығын өзіне қалдырады. Сатып алушылар тапсырыс бергенге дейін СТ өнімдері туралы соңғы ақпаратты алуы керек. СТ өнімдері тапсырысты растау кезінде қолданыстағы СТ сату шарттарына сәйкес сатылады.
Сатып алушылар СТ өнімдерін таңдауға, таңдауға және пайдалануға жауапты және СТ қолданбаға көмек көрсету немесе сатып алушылардың өнімдерінің дизайны үшін жауапкершілік көтермейді.
Осы құжатта ST компаниясы зияткерлік меншік құқығына тікелей немесе жанама түрде ешқандай лицензия бермейді.
Осы құжатта баяндалған ақпараттан өзгеше ережелері бар СТ өнімдерін қайта сату СТ осындай өнімге берген кез келген кепілдікті жояды.
ST және ST логотипі ST сауда белгілері болып табылады. ST сауда белгілері туралы қосымша ақпаратты қараңыз www.st.com/trademarks. Барлық басқа өнім немесе қызмет атаулары олардың тиісті иелерінің меншігі болып табылады.
Осы құжаттағы ақпарат осы құжаттың кез келген алдыңғы нұсқаларында бұрын берілген ақпаратты ауыстырады және ауыстырады.
© 2023 STMicroelectronics – Барлық құқықтар қорғалған
UM2548 – 2-нұсқа
Құжаттар / Ресурстар
 |
STMicroelectronics UM2548 Linux драйвері [pdf] Пайдаланушы нұсқаулығы UM2548 Linux драйвері, UM2548, Linux драйвері, драйвері |
