Упутство за употребу за СТМицроелецтроницс УМ2548 Линук драјвер

УМ2548 Линук драјвер
Линук® драјвер за СТ25Р3916/СТ25Р3916Б
Упутство за употребу

УМ2548 Линук драјвер

Увод
СТСВ-СТ25Р013 Линук® драјвер омогућава Распберри Пи® 4 да ради са Кс-НУЦЛЕО-НФЦО6А1 и Кс-НУЦЛЕО-НФЦО8А1 плочама, које садрже, респективно, СТ25Р3916 и СТ25Р3916Б уређаје.
Овај пакет преноси слој РФ апстракције (РФАЛ) на Распберри Пи 4 Линук платформу, ради рада са фирмвером плоче и пружа каоampапликација која открива различите типове НФЦ-а tags и мобилни телефони који подржавају П2П. РФАЛ је СТ стандардни драјвер за СТ25Р3916 и СТ25Р3916Б, НФЦ универзалне уређаје високих перформанси / ЕМВЦо читаче. Користи га, на пример, СТ25Р3916-ДИСЦО фирмвер (СТСВ-СТ25Р010) и Кс-НУЦЛЕО-НФЦО06А1 фирмвер (Кс-ЦУБЕ-НФЦ6).
СТСВ-СТ25Р013 подржава све СТ25Р3916/СТ25Р3916Б протоколе нижег слоја и неке протоколе вишег слоја за комуникацију. РФАЛ је написан на преносив начин, тако да може да ради на широком спектру уређаја заснованих на Линук-у. Овај документ описује како се библиотека РФАЛ може користити на стандардном Линук систему (у овом случају Распберри Пи 4) за НФЦ/РФ комуникацију. Код је веома преносив и ради са мањим изменама на било којој Линук платформи.

Готовоview

1.1 Карактеристике

• Комплетан Линук управљачки програм за кориснички простор (РФ апстрактни слој) за прављење НФЦ апликација помоћу уређаја СТ25Р3916 и СТ25Р3916Б
• Комуникација Линук хоста са СТ25Р3916/СТ25Р3916Б користећи СПИ интерфејс
• Потпуна РФ/НФЦ апстракција (РФАЛ) за све главне технологије и протоколе вишег слоја:
  – НФЦ-А (ИСО14443-А)
  – НФЦ-Б (ИСО14443-Б)
  – НФЦ-Ф (ФелиЦа™)
  – НФЦ-В (ИСО15693)
  – П2П (ИСО18092)
  – ИСО-ДЕП (ИСО протокол за размену података, ИСО14443-4)
  – НФЦ-ДЕП (НФЦ протокол за размену података, ИСО18092)
  – Власничке технологије, као што су Ковио, Б', иЦласс, Цалипсо®
• Sampимплементација доступна са Кс-НУЦЛЕО-НФЦ06А1 и Кс-НУЦЛЕО-НФЦ08А1 плочама за проширење, прикљученим на Распберри Пи 4
• Sampле апликација за откривање неколико НФЦ tag типови и мобилни телефони који подржавају П2П
• Бесплатни услови лиценце прилагођени корисницима

1.2 Архитектура софтвера
Слика 2 приказује детаље софтверске архитектуре РФАЛ библиотеке на Линук платформи.
РФАЛ се лако преноси на друге платформе прилагођавањем такозване платформе files.
Заглавље file рфал_платформ.х садржи макро дефиниције, које ће обезбедити и имплементирати власник платформе.
Обезбеђује подешавања специфична за платформу као што су ГПИО додељивање, системски ресурси, закључавања и ИРК-ови, који су потребни за исправан рад РФАЛ-а.
Ова демонстрација имплементира функције платформе и обезбеђује порт РФАЛ-а у кориснички простор Линук-а.
Заједничка библиотека file се генерише, што користи демонстративна апликација за приказ функционалности које пружа РФАЛ слој.
Линук хост користи сисфс интерфејс доступан из Линук корисничког простора за обављање СПИ комуникације са уређајима. Унутар Линук кернела, СПИ сисфс интерфејс користи управљачки програм Линук кернела спидев за слање/примање СПИ оквира до/са уређаја.
За руковање ИНТ линијом уређаја СТ25Р3916 и СТ25Р3916Б, управљачки програм користи либпиод сисфс да би добио обавештења о променама на овој линији.

Подешавање хардвера

2.1 Коришћена платформа
Распберри Пи 4 плоча са Распберри Пи ОС-ом се користи као Линук платформа за изградњу РФАЛ библиотеке и интеракцију са СТ25Р3916/СТ25Р3916Б преко СПИ-а.
Уређаји омогућавају апликацији на Линук платформи да открије и комуницира са НФЦ уређајима.

2.2 Хардверски захтеви

• Распберри Пи 4
• 8 ГБ микро СД картица за покретање Распберри Пи ОС-а (са најновијим захтевима)
• Читач СД картица
• Кс-НУЦЛЕО-НФЦ06А1 или Кс-НУЦЛЕО-НФЦ08А1 плоче
• Мост за повезивање плоче са Распберри Пи Ардуино™ адаптером за Распберри Пи (број дела АРПИ600)

2.2.1 Хардверске везе
АРПИ600 Распберри Пи на Ардуино адаптер се користи за повезивање плоча са Распберри Пи. Џампери адаптерске плоче морају бити модификовани да би се повезали са Кс-НУЦЛЕО-НФЦ06А1 или Кс-НУЦЛЕО-НФЦ08А1 плочама.
Опрез:
АРПИ600 неисправно снабдева 5 В на Ардуино ИОРЕФ пин. Директно причвршћивање плоча враћа 5 В на неке пинове, што може оштетити Распберри Пи плочу. Постоје извештаји о уништеним плочама (нарочито Распберри Пи 4Б+).
Да бисте то избегли, прилагодите АРПИ600 (прилично тешка операција) или плочу Кс-НУЦЛЕО-НФЦ06А1/Кс-НУЦЛЕОНФЦ08А1 (лакше).
Најлакше решење је да исечете ЦН6.2 (ИОРЕФ) пин на Кс-НУЦЛЕО-НФЦ06А1/Кс-НУЦЛЕО-НФЦ08А1 плочама, као што је приказано на слици 3.
Сечење ове игле не утиче на рад у комбинацији са Нуцлео плочама (као што су НУЦЛЕО-Л474РГ, НУЦЛЕО-Ф401РЕ, НУЦЛЕО-8С208РБ).

Постављање краткоспојника
Џампери за А5, А4, А3, А2, А1 и А0 приказани на слици 4 морају се променити у П25, П24, П23, П22, П21 и ЦЕ1. Са овим подешавањем Распберри-јев ГПИО пин број 7 се користи као прекидна линија за Кс-НУЦЛЕОНФЦ06А1/Кс-НУЦЛЕО-НФЦ08А1.

Тренутно, овај порт библиотеке РФАЛ користи пин ГПИО7 као линију прекида (према поставкама краткоспојника). Ако постоји захтев за промену линије прекида са ГПИО7 на други ГПИО, код специфичан за платформу (у file плтф_гпио.х) мора бити измењен да би се променила дефиниција макроа СТ25Р_ИНТ_ПИН са 7 на нови ГПИО пин, који ће се користити као линија прекида.
Са горњим подешавањима краткоспојника, адаптерска плоча се може користити за повезивање Кс-НУЦЛЕО НФЦ06А1 и Кс-НУЦЛЕО-НФЦ08А1 са Распберри Пи плочом, као што је приказано на следећим сликама.

Подешавање Линук окружења

3.1 Покретање Распберри Пи-ја
Да бисте подесили Линук окружење, прво инсталирајте и покрените Распберри Пи са Распберри Пи ОС-ом, као што је објашњено у наставку:
Корак 1
Преузмите најновију слику Распберри Пи ОС са https://www.raspberrypi.com, а затим изаберите Распберри Пи ОС са радном површином. За тестове испод коришћена је верзија 2022-09-22-распиос-буллсеие-армхф.имг.кз (септембар 2022).
Корак 2
Распакујте Распберри Пи ОС слику и запишите је на СД картицу пратећи упутства доступна у одељку под називом „Писање слике на СД картицу“.
Корак 3
Повежите хардвер:

• Повежите Распберри Пи 4 са монитором помоћу стандардног ХДМИ кабла.
• Повежите миш и тастатуру на УСБ портове Распберри Пи.

Такође је могуће радити са Распберри Пи користећи ссх. У овом случају. није потребно повезати монитор, тастатуру и миш са Распберри Пи. Једини услов је да имате рачунар са ссх-ом унутар исте мреже као Распберри Пи и да у складу са тим конфигуришете ИП адресу.
Корак 4
Покрените Распберри Пи 4 са СД картицом. Након покретања, Линук десктоп заснована на Дебиан-у се појављује на монитору.
Напомена:
Понекад, након покретања Распберри Пи ОС-а, неки тастери на тастатури не раде. Да бисте их натерали да раде, отворите file /етц/дефаулт/кеибоард и подесите КСКБЛАИОУТ=”ус”, и поново покрените Распберри Пи.
3.2 Омогућите СПИ на Распберри Пи
СПИ драјвер унутар кернела комуницира са Кс-НУЦЛЕО-НФЦ06А1/Кс-НУЦЛЕО-НФЦ08А1 плочама преко СПИ. Важно је проверити да ли је СПИ већ омогућен у конфигурацији језгра Распбиан Пи ОС-а.
Проверите да ли је /дев/спидев0.0 видљив у Распберри Пи окружењу. Ако није видљив, омогућите СПИ интерфејс помоћу услужног програма „распи-цонфиг“ пратећи кораке описане у наставку.
Корак 1
Отворите нови терминал на Распберри Пи и покрените команду „распи-цонфиг“ као роот: судо распи-цонфиг
Овај корак отвара графички интерфејс.
Корак 2
Изаберите у графичком интерфејсу опцију под називом „Опције интерфејса“.
Корак 3
Овај корак наводи разне опције.
Изаберите опцију под називом „СПИ“.
Појављује се нови прозор са следећим текстом:
„Да ли бисте желели да СПИ интерфејс буде омогућен?“
Корак 4
Изаберите у овом прозору да бисте омогућили СПИ.
Корак 5
Поново покрените Распберри Пи.
Горе наведени кораци ће омогућити СПИ интерфејс у ​​Распберри Пи окружењу након поновног покретања.

Направите РФАЛ библиотеку и апликацију

РФАЛ демонстрација Линук-а је обезбеђена у архиви, као што је СТ25Р3916_в2.8.0_Линук_демо_в1.0.тар.кз.
Да бисте направили РФАЛ библиотеку и апликацију на Распберри Пи, прођите кроз следеће кораке:
Корак 1
Распакујте пакет на Распберри Пи користећи следећу команду из кућног директоријума
тар -кЈвф СТ25Р3916_в2.8.0_Линук_демо_в1.0.тар.кз
Корак 2
Инсталирајте цмаке (ако то нисте урадили раније) користећи команду
апт-гет инсталл цмаке
РФАЛ библиотека и систем за прављење апликација засновани су на цмаке-у, из тог разлога је потребно инсталирати цмаке за компајлирање пакета.
Корак 3
Да бисте направили РФАЛ библиотеку и апликацију, идите у директоријум за прављење
цд СТ25Р3916_в2.8.0_Линук_демо_в1.0/линук_демо/буилд
Одатле покрените команду
цмаке ..
У горњој команди „..” означава да ЦМакеЛистс.ткт највишег нивоа постоји у надређеном директоријуму
(СТ25Р3916_в2.8.0_Линук_демо_в1.0).
Ова команда креира макеfile користи се у следећем кораку за прављење библиотеке и апликације. Одатле покрените следећу команду да бисте направили демонстрацију за СТ25Р3916Б
цмаке -ДРФАЛ_ВАРИАНТ=ст25р3916б ..
Корак 4
Покрените команду маке да бисте направили РФАЛ библиотеку и апликацију:
направити
Ова команда прво гради РФАЛ библиотеку, а затим апликацију на њој.

Како покренути апликацију

Успешно надоградња генерише извршну датотеку под називом „нфц_поллер_ст25р3916“ или „нфц_поллер_ст25р3916б“ на локацији /буилд/демо.
Подразумевано, апликација треба да се покреће са роот правима са путање СТ25Р3916_в2.8.0_Линук_демо_в1.0/линук_демо/буилд/демо/:
судо ./нфц_демо_ст25р3916
Апликација почиње да анкетира за НФЦ tags и мобилних телефона, затим приказује пронађене уређаје са њиховим УИД-ом, као што је приказано на слици 7.

Да бисте прекинули апликацију, притисните Цтрл + Ц.

Историја ревизија
Табела 1. Историја ревизије документа

ВАЖНО ОБАВЕШТЕЊЕ – ПАЖЉИВО ПРОЧИТАЈТЕ
СТМицроелецтроницс НВ и његове подружнице („СТ“) задржавају право да у било ком тренутку без претходног обавештења унесу измене, исправке, побољшања, модификације и побољшања СТ производа и/или овог документа. Купци би требало да добију најновије релевантне информације о СТ производима пре наручивања. СТ производи се продају у складу са СТ условима продаје који су на снази у тренутку потврде поруџбине.
Купци су искључиво одговорни за избор, избор и употребу СТ производа и СТ не преузима никакву одговорност за помоћ у примени или дизајн производа купаца.
СТ овде не даје никакву лиценцу, изричиту или имплицирану, за било које право интелектуалне својине.
Препродаја СТ производа са одредбама другачијим од информација наведених овде поништава сваку гаранцију коју СТ даје за такав производ.
СТ и СТ лого су заштитни знакови СТ. За додатне информације о СТ заштитним знаковима, погледајте ввв.ст.цом/традемаркс. Сви други називи производа или услуга су власништво њихових власника.
Информације у овом документу замењују и замењују информације које су претходно дате у претходним верзијама овог документа.
© 2023 СТМицроелецтроницс – Сва права задржана

УМ2548 – Рев 2