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

Линук® драјвер за СТ25Р3911Б и СТ25Р3912/14/15 НФЦ фронтенде високих перформанси
Увод
СТСВ-СТ25Р009 Линук® драјвер омогућава Распберри Пи 4 да ради са Кс-НУЦЛЕО-НФЦ05А1, који садржи СТ25Р3911Б универзални НФЦ уређај високих перформанси.
Овај пакет преноси слој РФ апстракције (РФАЛ) на Распберри Пи 4 Линук платформу за рад са Кс-НУЦЛЕО-НФЦ05А1 фирмвером. Пакет пружа каоampапликација која открива различите типове НФЦ-а tags и мобилни телефони који подржавају П2П. РФАЛ је СТ стандардни драјвер за СТ25Р НФЦ/РФИД читаче ИЦ-ове СТ25Р3911Б, СТ25Р3912, СТ25Р3913, СТ25Р3914 и СТ25Р3915. Користи га, на пример, СТ25Р3911Б-ДИСЦО фирмвер (СТСВ-СТ25Р002) и Кс-НУЦЛЕОНФЦ05А1 фирмвер (Кс-ЦУБЕ-НФЦ5).
СТСВ-СТ25Р009 подржава све СТ25Р3911Б протоколе нижег слоја, као и неке протоколе вишег слоја за комуникацију. РФАЛ је написан на преносив начин, тако да може да ради на широком спектру уређаја заснованих на Линук®. Овај документ описује како се библиотека РФАЛ може користити на стандардном Линук систему (у овом случају Распберри Пи 4) за НФЦ/РФ комуникацију. Код је веома преносив и ради са мањим изменама на било којој Линук платформи.
Слика 1. РФАЛ библиотека на Линук платформи

Готовоview
Карактеристике
- Комплетан Линук управљачки програм за кориснички простор (РФ апстрактни слој) за прављење апликација које подржавају НФЦ користећи СТ25Р3911Б/СТ25Р391к НФЦ фронтенде високих перформанси са излазном снагом до 1.4 В
- Комуникација Линук хоста са СТ25Р3911Б/СТ25Р391к помоћу СПИ интерфејса
- Потпуна РФ/НФЦ апстракција (РФАЛ) за све главне технологије и протоколе вишег слоја:
- НФЦ-А (ИСО14443-А)
- НФЦ-Б (ИСО14443-Б)
- НФЦ-Ф (ФелиЦа™)
- НФЦ-В (ИСО15693)
- П2П (ИСО18092)
- ИСО-ДЕП (ИСО протокол за размену података, ИСО14443-4)
- НФЦ-ДЕП (НФЦ протокол за размену података, ИСО18092)
- Власничке технологије (Ковио, Б', иЦласс, Цалипсо®, …)
- Sampимплементација доступна уз Кс-НУЦЛЕО-НФЦ05А1 плочу за проширење, прикључену на Распберри Пи 4
- Sampле апликација за откривање неколико НФЦ tag типови и мобилни телефони који подржавају П2П
- Бесплатни услови лиценце прилагођени корисницима
Архитектура софтвера
Слика 2 приказује детаље софтверске архитектуре РФАЛ библиотеке на Линук® платформи.
РФАЛ се лако преноси на друге платформе прилагођавањем такозване платформе files.
Заглавље file рфал_платформ.х садржи макро дефиниције, које треба да обезбеди и примени власник платформе. Штавише, обезбеђује подешавања специфична за платформу као што су додељивање ГПИО, системски ресурси, закључавања и ИРК-ови, који су потребни за исправан рад РФАЛ-а.
Ова демонстрација имплементира функције платформе и обезбеђује порт РФАЛ библиотеке у кориснички простор Линук®. Заједничка библиотека file се генерише, што користи демо апликација за приказ функционалности које пружа РФАЛ слој.
Линук® хост користи сисфс интерфејс доступан из Линук® корисничког простора да омогући СПИ комуникацију са СТ25Р3911Б уређајем. Унутар Линук® кернела, СПИ сисфс интерфејс користи Линук® кернел драјвер спидев за слање/примање СПИ оквира на/са СТ25Р3911Б.
За руковање линијом прекида СТ25Р3911Б, драјвер користи либгпиод да би добио обавештење о променама на овој линији.
Слика 2. Архитектура РФАЛ софтвера на Линук-у

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

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

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

Слика 6. Страна за подешавање хардвера view

Подешавање Линук окружења
Покретање Распберри Пи-ја
Да бисте подесили Линук окружење, први корак је да инсталирате и покренете Распберри Пи 4 са Распберри Пи ОС као што је објашњено у наставку:
Корак 1
Преузмите најновију Распберри Пи ОС слику са везе:
Изаберите Распберри Пи ОС са радном површином. За доленаведене тестове коришћена је следећа верзија: септембар 2022. (2022-09-22-распиос-буллсеие-армхф.имг.кз).
Корак 2
Распакујте Распберри Пи слику и запишите је на СД картицу пратећи упутства доступна у одељку под називом „Писање слике на СД картицу“.
Корак 3
Повежите хардвер:
- Повежите Распберри Пи са монитором помоћу стандардног ХДМИ кабла.
- Повежите миш и тастатуру на УСБ портове Распберри Пи.
Такође је могуће радити са Распберри Пи користећи ссх. У том случају није потребно повезивање монитора, тастатуре и миша са Распберри Пи. Једини услов је да имате рачунар са ссх-ом унутар исте мреже као Распберри Пи и у складу са тим конфигуришете ИП адресу.
Корак 4
Покрените Распберри Пи са СД картицом.
Након покретања, на монитору се појављује Дебиан базирана Линук радна површина.
Напомена: Понекад се примећује да након покретања Распберри Пи-ја неки тастери на тастатури не раде. Да бисте их натерали да раде, отворите file /етц/дефаулт/кеибоард и подесите КСКБЛАИОУТ=”ус” и поново покрените Распберри Пи.
Омогућите СПИ на Распберри Пи
СПИ драјвер унутар кернела комуницира са Кс-НУЦЛЕО-НФЦ05А1 преко СПИ. Важно је проверити да ли је СПИ већ омогућен у Распберри Пи ОС/кернел конфигурацији.
Проверите да ли је /дев/спидев0.0 видљив у Распберри Пи окружењу. Ако није видљив, омогућите СПИ интерфејс помоћу услужног програма „распи-цонфиг“ пратећи кораке описане у наставку.
Корак 1
Отворите нови терминал на Распберри Пи и покрените команду „распи-цонфиг“ као роот:
судо распи-цонфиг
Овај корак отвара графички интерфејс.
Корак 2
Изаберите у графичком интерфејсу опцију под називом „Опције интерфејса“.
Корак 3
Овај корак наводи разне опције.
Изаберите опцију под називом „СПИ“.
Појављује се нови прозор са следећим текстом:
„Да ли бисте желели да СПИ интерфејс буде омогућен?“
Корак 4
Изаберите у овом прозору да бисте омогућили СПИ.
Корак 5
Поново покрените Распберри Пи.
Горе наведени кораци ће омогућити СПИ интерфејс у Распберри Пи окружењу након поновног покретања.
Израда РФАЛ библиотеке и апликације
РФАЛ демо Линук-а је обезбеђен у архиви. Претпоставимо да је његово име:
СТ25Р3911Б_в2.8.0_Линук_демо_в1.0.тар.кз.
Да бисте направили РФАЛ библиотеку и апликацију на Распберри Пи, следите доле наведене кораке:
Корак 1
Распакујте пакет на Распберри Пи користећи доњу команду из кућног директоријума:
тар -кЈвф СТ25Р3911Б_в2.8.0_Линук_демо_в1.0.тар.кз
Корак 2
Ако то нисте урадили раније, инсталирајте цмаке, користећи доњу команду:
апт-гет инсталл цмаке
РФАЛ библиотека и систем за прављење апликација засновани су на цмаке-у, из тог разлога је потребно инсталирати цмаке за компилацију пакета.
Корак 3
Да бисте направили РФАЛ библиотеку и апликацију, идите у директоријум „буилд“:
цд СТ25Р3911Б_в2.8.0_Линук_демо_в1.0/Линук_демо/буилд
и одатле покрените наредбу испод:
цмаке ..
У горњој команди „..” означава да ЦМакеЛистс.ткт највишег нивоа постоји у надређеном директоријуму, тј.
СТ25Р3911Б_в2.8.0_Линук_демо_в1.0.
Команда цмаке креира макеfile који се користи у следећем кораку за изградњу библиотеке и апликације.
Корак 4
Покрените команду „маке“ да бисте направили РФАЛ библиотеку и апликацију:
направити
Команда „маке“ прво гради РФАЛ библиотеку, а затим гради апликацију на њој.
Како покренути апликацију
Успешно надоградња генерише извршну датотеку под називом „нфц_демо_ст25р3911б“ на следећој локацији:
/буилд/апплицатионс.
Подразумевано, апликација треба да се покрене са роот правима са путање: СТ25Р3911Б_в2.8.0_Линук_демо_в1.0/линук_демо/буилд:
судо ./демо/нфц_демо_ст25р3911б
Апликација почиње да анкетира за НФЦ tags и мобилни телефони. Приказује пронађене уређаје са њиховим УИД-ом као што је приказано на слици 7.
Слика 7. Приказ пронађених уређаја

Да бисте прекинули апликацију, притисните Цтрл + Ц.
Историја ревизија
Табела 1. Историја ревизије документа

Списак табела
Табела 1. Историја ревизије документа . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Списак фигура
Слика 1. РФАЛ библиотека на Линук платформи . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Слика 2. Архитектура РФАЛ софтвера на Линук-у . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Слика 3. Исправка хардверске везе . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Слика 4. Положај краткоспојника А5, А4, А3, А2, А1 и А0 на адаптерској плочи. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Слика 5. Врх подешавања хардвера view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Слика 6. Страна за подешавање хардвера view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Слика 7. Приказ пронађених уређаја . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
ВАЖНО ОБАВЕШТЕЊЕ – ПАЖЉИВО ПРОЧИТАЈТЕ
СТМицроелецтроницс НВ и његове подружнице („СТ“) задржавају право да у било ком тренутку без претходног обавештења унесу измене, исправке, побољшања, модификације и побољшања СТ производа и/или овог документа. Купци би требало да добију најновије релевантне информације о СТ производима пре наручивања. СТ производи се продају у складу са СТ условима продаје који су на снази у тренутку потврде поруџбине.
Купци су искључиво одговорни за избор, избор и употребу СТ производа и СТ не преузима никакву одговорност за помоћ у примени или дизајн производа купаца.
СТ овде не даје никакву лиценцу, изричиту или имплицирану, за било које право интелектуалне својине.
Препродаја СТ производа са одредбама другачијим од информација наведених овде поништава сваку гаранцију коју СТ даје за такав производ.
СТ и СТ лого су заштитни знакови СТ. За додатне информације о СТ заштитним знаковима, погледајте ввв.ст.цом/традемаркс. Сви други називи производа или услуга су власништво њихових власника.
Информације у овом документу замењују и замењују информације које су претходно дате у претходним верзијама овог документа.
© 2023 СТМицроелецтроницс – Сва права задржана
Документи / Ресурси
![]() | УМ2375 Линук драјвер |
Референце
- Упутство за употребуmanual.tools

