UM2548 לינוקס דרייווער
לינוקס® שאָפער פֿאַר ST25R3916/ST25R3916B
באַניצער מאַנואַל

UM2548 לינוקס דרייווער

הקדמה
STSW-ST25R013 Linux® שאָפער ינייבאַלז די Raspberry Pi® 4 צו אַרבעטן מיט די X-NUCLEO-NFCO6A1 און X-NUCLEO-NFCO8A1 באָרדז, וואָס אַנטהאַלטן ריספּעקטיוולי די ST25R3916 און ST25R3916B דעוויסעס.
דער פּעקל פּאָרץ די רף אַבסטראַקציע שיכטע (RFAL) אַנטו אַ Raspberry Pi 4 לינוקס פּלאַטפאָרמע, צו אַרבעטן מיט די ברעט פירמוואַרע, און גיט וויampדי אַפּלאַקיישאַן דיטעקטינג פאַרשידענע טייפּס פון NFC tags און רירעוודיק פאָנעס וואָס שטיצן P2P. די RFAL איז די ST נאָרמאַל דרייווער פֿאַר ST25R3916 און ST25R3916B, הויך פאָרשטעלונג NFC וניווערסאַל דעוויסעס / EMVCo לייענער. עס איז געניצט, פֿאַר בייַשפּיל, דורך די ST25R3916-DISCO פירמוואַרע (STSW-ST25R010) און דורך די X-NUCLEO-NFCO06A1 פירמוואַרע (X-CUBE-NFC6).
STSW-ST25R013 שטיצט אַלע די ST25R3916/ST25R3916B נידעריקער שיכטע און עטלעכע העכער שיכטע פּראָטאָקאָלס פֿאַר קאָמוניקאַציע. די RFAL איז געשריבן אויף אַ פּאָרטאַטיוו שטייגער, אַזוי עס קענען לויפן אויף אַ ברייט קייט פון דעוויסעס באזירט אויף לינוקס. דער דאָקומענט באשרייבט ווי די RFAL ביבליאָטעק קענען זיין געוויינט אויף אַ נאָרמאַל לינוקס סיסטעם (אין דעם פאַל די Raspberry Pi 4) פֿאַר NFC / רף קאָמוניקאַציע. דער קאָד איז העכסט פּאָרטאַטיוו און אַרבעט מיט מינערווערטיק ענדערונגען אויף קיין לינוקס פּלאַטפאָרמע.

איבערview

1.1 פֿעיִקייטן

• גאַנץ לינוקס באַניצער פּלאַץ דרייווער (RF אַבסטראַקציע שיכטע) צו בויען NFC ענייבאַלד אַפּלאַקיישאַנז ניצן די ST25R3916 און ST25R3916B דעוויסעס
• לינוקס באַלעבאָס קאָמוניקאַציע מיט די ST25R3916/ST25R3916B ניצן SPI צובינד
• גאַנץ 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די ימפּלאַמענטיישאַן בנימצא מיט די X-NUCLEO-NFC06A1 און X-NUCLEO-NFC08A1 יקספּאַנשאַן באָרדז, פּלאַגד אין אַ Raspberry Pi 4
• Sampדי אַפּלאַקיישאַן צו דעטעקט עטלעכע NFC tag טייפּס און רירעוודיק פאָנעס וואָס שטיצן P2P
• פריי באַניצער-פרייַנדלעך דערלויבעניש טערמינען

1.2 ווייכווארג אַרקאַטעקטשער
פיגורע 2 ווייזט די ווייכווארג אַרקאַטעקטשער דעטאַילס פון RFAL ביבליאָטעק אויף אַ לינוקס פּלאַטפאָרמע.
די RFAL איז לייכט פּאָרטאַטיוו צו אנדערע פּלאַטפאָרמס דורך אַדאַפּטינג די אַזוי גערופענע פּלאַטפאָרמע files.
די קאָפּ file rfal_platform.h כּולל מאַקראָו דעפֿיניציע, צו זיין צוגעשטעלט און ימפּלאַמענאַד דורך די פּלאַטפאָרמע באַזיצער.
עס גיט פּלאַטפאָרמע ספּעציפיש סעטטינגס ווי GPIO אַסיינמאַנט, סיסטעם רעסורסן, לאַקס און ירקס, וואָס זענען פארלאנגט פֿאַר ריכטיק אָפּעראַציע פון ​​די RFAL.
די דעמאַנסטריישאַן ימפּלאַמאַנץ די פּלאַטפאָרמע פאַנגקשאַנז און גיט אַ פּאָרט פון די RFAL אין באַניצער פּלאַץ פון לינוקס.
א שײדענ ע ביבליאטעק file איז דזשענערייטאַד, וואָס איז געניצט דורך אַ דעמאָנסטראַטיווע אַפּלאַקיישאַן צו וויטרינע די פאַנגקשאַנאַליטי צוגעשטעלט דורך די RFAL שיכטע.
לינוקס באַלעבאָס ניצט sysfs צובינד בנימצא פון לינוקס באַניצער פּלאַץ פֿאַר פּערפאָרמינג SPI קאָמוניקאַציע מיט די דעוויסעס. ין די לינוקס קערן די SPI sysfs צובינד ניצט לינוקס קערן שאָפער ספּידעוו צו שיקן / באַקומען די SPI ראָמען צו / פֿון די דעוויסעס.
פֿאַר האַנדלינג די INT שורה פון ST25R3916 און ST25R3916B דעוויסעס, דער שאָפער ניצט די libpiod sysfs צו באַקומען נאָוטאַפייד פון ענדערונגען אויף דעם שורה.

ייַזנוואַרג סעטאַפּ

2.1 פּלאַטפאָרמע געניצט
א Raspberry Pi 4 ברעט מיט Raspberry Pi OS איז געניצט ווי לינוקס פּלאַטפאָרמע צו בויען די RFAL ביבליאָטעק און ינטעראַקט מיט די ST25R3916/ST25R3916B איבער SPI.
די דעוויסעס געבן אַן אַפּלאַקיישאַן אויף לינוקס פּלאַטפאָרמע צו דעטעקט און יבערגעבן מיט NFC דעוויסעס.

2.2 האַרדוואַרע באדערפענישן

• Raspberry Pi 4
• 8 גיגאבייט מיקראָ סד קאָרט צו שטיוול Raspberry Pi OS (מיט די לעצטע רעקווירעמענץ)
• סד קאָרט לייענער
• X-NUCLEO-NFC06A1 אָדער X-NUCLEO-NFC08A1 באָרדז
• בריק צו פאַרבינדן די ברעט מיט Raspberry Pi Arduino ™ אַדאַפּטער פֿאַר Raspberry Pi (טייל נומער ARPI600)

2.2.1 האַרדוואַרע קאַנעקשאַנז
די ARPI600 Raspberry Pi צו Arduino אַדאַפּטער איז געניצט צו פאַרבינדן די באָרדז מיט די Raspberry Pi. די דזשאַמפּערז פון די אַדאַפּטער ברעט מוזן זיין מאַדאַפייד צו פאַרבינדן עס מיט די X-NUCLEO-NFC06A1 אָדער X-NUCLEO-NFC08A1 באָרדז.
וואָרענען:
די ARPI600 ינקערעקטלי סאַפּלייז 5 V צו די Arduino IOREF שטיפט. גלייך אַטאַטשינג די באָרדז פידז צוריק 5 V אויף עטלעכע פּינס, דאָס קען שעדיקן די Raspberry Pi ברעט. עס זענען ריפּאָרץ פון חרובֿ באָרדז (ספּעציעל Raspberry Pi 4B +).
צו ויסמיידן דעם, אַדאַפּט די ARPI600 (אַ גאַנץ שווער אָפּעראַציע), אָדער די X-NUCLEO-NFC06A1/X-NUCLEONFC08A1 ברעט (גרינגער).
די יזיאַסט פאַרריכטן איז צו שנייַדן די CN6.2 (IOREF) שטיפט אויף די X-NUCLEO-NFC06A1 / X-NUCLEO-NFC08A1 באָרדז, ווי געוויזן אין פיגורע 3.
קאַטינג דעם שטיפט טוט נישט ווירקן די אָפּעראַציע אין קאַנדזשאַנגקשאַן מיט נוקלעאָ באָרדז (אַזאַ ווי NUCLEO-L474RG, NUCLEO-F401RE, NUCLEO-8S208RB).

דזשאַמפּער באַשטעטיקן
די דזשאַמפּערז פֿאַר A5, A4, A3, A2, A1 און A0 געוויזן אין פיגורע 4 מוזן זיין ריספּעקטיוולי טשיינדזשד צו P25, P24, P23, P22, P21 און CE1. מיט דעם באַשטעטיקן Raspberry's 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 ברעט, ווי געוויזן אין די פאלגענדע פיגיערז.

סעטאַפּ לינוקס סוויווע

3.1 בוטינג Raspberry Pi
צו סעטאַפּ די לינוקס סוויווע, ערשטער ינסטאַלירן און שטיוול די Raspberry Pi מיט Raspberry Pi OS, ווי דערקלערט אונטן:
שריט 1
אראפקאפיע די לעצטע Raspberry Pi OS בילד פֿון https://www.raspberrypi.com, דעמאָלט קלייַבן Raspberry Pi OS מיט דעסקטאַפּ. פֿאַר די טעסץ אונטן, די ווערסיע 2022-09-22-raspios-bullseye-armhf.img.xz (סעפטעמבער 2022) איז געניצט.
שריט 2
אַנזיפּ די Raspberry Pi OS בילד און שרייַבן עס אויף די סד קאָרט דורך נאָכפאָלגן די אינסטרוקציעס בנימצא אין דער אָפּטיילונג "שרייבן אַ בילד צו די סד קאָרט".
שריט 3
פאַרבינדן די ייַזנוואַרג:

• פאַרבינדן די Raspberry Pi 4 צו אַ מאָניטאָר מיט אַ נאָרמאַל הדמי קאַבלע.
• פאַרבינדן מויז און קלאַוויאַטור צו די וסב פּאָרץ פון Raspberry Pi.

עס איז אויך מעגלעך צו אַרבעטן מיט Raspberry Pi ניצן ssh. אין דעם פאַל. עס איז ניט פארלאנגט צו פאַרבינדן די מאָניטאָר, קלאַוויאַטור און מויז מיט Raspberry Pi. דער בלויז פאָדערונג איז צו האָבן די פּיסי מיט ssh אין דער זעלביקער נעץ ווי די Raspberry Pi, און קאַנפיגיער די IP אַדרעס אַקאָרדינגלי.
שריט 4
שטיוול די Raspberry Pi 4 מיט אַ סד קאָרט. נאָך בוטינג, אַ דעביאַן באזירט לינוקס דעסקטאַפּ אויס אויף מאָניטאָר.
באַמערקונג:
מאל, נאָך בוטינג Raspberry Pi OS, עטלעכע קלאַוויאַטור קיז טאָן ניט אַרבעט. צו מאַכן זיי אַרבעט, עפענען די file /etc/default/keyboard און שטעלן XKBLAYOUT = "אונדז", און רעבאָאָט די Raspberry Pi.
3.2 געבן SPI אויף Raspberry Pi
די SPI שאָפער ין דער קערן קאַמיונאַקייץ מיט די X-NUCLEO-NFC06A1/X-NUCLEO-NFC08A1 באָרדז דורך SPI. עס איז וויכטיק צו קאָנטראָלירן אויב SPI איז שוין ענייבאַלד אין די Raspbian Pi OS קערן קאַנפיגיעריישאַן.
קוק אויב /dev/spidev0.0 איז קענטיק אין די Raspberry Pi סוויווע. אויב עס איז ניט קענטיק, געבן די SPI צובינד ניצן די נוצן "raspi-config" דורך נאָכפאָלגן די סטעפּס דיסקרייבד אונטן.
שריט 1
עפֿענען אַ נייַע וואָקזאַל אויף די Raspberry Pi און לויפן די באַפֿעל "raspi-config" ווי וואָרצל: sudo raspi-config
דעם שריט אָפּענס אַ גראַפיקאַל צובינד.
שריט 2
סעלעקטירן אין די גראַפיקאַל צובינד די אָפּציע מיט די נאָמען "ינטערפאַסינג אָפּציעס".
שריט 3
דעם שריט ליסטעד פאַרשידן אָפּציעס.
סעלעקטירן דעם אָפּציע מיטן נאָמען "SPI".
א נייַע פֿענצטער איז ארויס מיט דעם טעקסט:
"וואָלט איר ווילט אַז די SPI צובינד זאָל זיין ענייבאַלד?"
שריט 4
אויסקלייַבן אין דעם פֿענצטער צו געבן SPI.
שריט 5
רעבאָאָט Raspberry Pi.
די אויבן סטעפּס וועט געבן די SPI צובינד אין Raspberry Pi סוויווע נאָך אַ רעבאָאָט.

בויען RFAL ביבליאָטעק און אַפּלאַקיישאַן

די RFAL דעמאַנסטריישאַן פון לינוקס איז צוגעשטעלט אין אַן אַרקייוו, אַזאַ ווי ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz.
צו בויען די RFAL ביבליאָטעק און אַפּלאַקיישאַן אויף Raspberry Pi, גיין דורך די פאלגענדע סטעפּס:
שריט 1
אַנזיפּ דעם פּעקל אויף Raspberry Pi ניצן די פאלגענדע באַפֿעל פון די היים וועגווייַזער
tar -xJvf ST25R3916_v2.8.0_Linux_demo_v1.0.tar.xz
שריט 2
ינסטאַלירן קמאַקע (אויב נישט געטאן פריער) ניצן די באַפֿעל
apt-get install cmake
RFAL ביבליאָטעק און אַפּלאַקיישאַן בויען סיסטעם זענען באזירט אויף קמאַקע, פֿאַר דעם סיבה עס איז פארלאנגט צו ינסטאַלירן קמאַקע צו צונויפנעמען דעם פּעקל.
שריט 3
צו בויען די RFAL ביבליאָטעק און אַפּלאַקיישאַן, גיין צו די בויען וועגווייַזער
cd ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build
פֿון דאָרט, לויפן די באַפֿעל
קענסט ..
אין די אויבן באַפֿעל ".." ינדיקייץ אַז די שפּיץ מדרגה CMakeLists.txt יגזיסץ אין די פאָטער וועגווייַזער
(ST25R3916_v2.8.0_Linux_demo_v1.0).
דעם באַפֿעל קריייץ די מאַכןfile געניצט אין דער ווייַטער שריט צו בויען די ביבליאָטעק און אַפּלאַקיישאַן. פֿון דאָרט, לויפן די פאלגענדע באַפֿעל צו בויען די דעמאַנסטריישאַן פֿאַר ST25R3916B
קמאַקע -DRFAL_VARIANT=st25r3916b ..
שריט 4
לויפן די מאַכן באַפֿעל צו בויען די RFAL ביבליאָטעק און אַפּלאַקיישאַן:
מאַכן
דער באַפֿעל ערשטער בויען די RFAL ביבליאָטעק, און דערנאָך די אַפּלאַקיישאַן אויף שפּיץ.

ווי צו לויפן די אַפּלאַקיישאַן

א געראָטן בויען-אַרויף דזשענערייץ אַ עקסעקוטאַבלע מיטן נאָמען "nfc_poller_st25r3916" אָדער "nfc_poller_st25r3916b" אין אָרט /build/demo.
דורך פעליקייַט, די אַפּלאַקיישאַן דאַרף זיין לויפן מיט וואָרצל רעכט פֿון דעם דרך ST25R3916_v2.8.0_Linux_demo_v1.0/linux_demo/build/demo/:
sudo ./nfc_demo_st25r3916
די אַפּלאַקיישאַן סטאַרץ צו אַנקעטע פֿאַר NFC tags און רירעוודיק פאָנעס, דעמאָלט דיספּלייז די געפֿונען דעוויסעס מיט זייער UID, ווי געוויזן אין פיגורע 7.

צו פאַרענדיקן די אַפּלאַקיישאַן דריקן 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 געבן SPI אויף Raspberry Pi, אָפּטיילונג 4 בויען RFAL ביבליאָטעק און אַפּלאַקיישאַן, און אָפּטיילונג 5 ווי צו לויפן די אַפּלאַקיישאַן. דערהייַנטיקט פיגורע 1. RFAL ביבליאָטעק אויף לינוקס פּלאַטפאָרמע, פיגורע 2. RFAL ווייכווארג אַרקאַטעקטשער אויף לינוקס, און פיגורע 5. ייַזנוואַרג סעטאַפּ שפּיץ view. מינערווערטיק טעקסט עדיטינג איבער די גאנצע דאָקומענט.

וויכטיק אָנזאָג - לייענען קערפאַלי
STMicroelectronics NV און זייַן סאַבסידיעריז ("ST") רעזערווירן די רעכט צו מאַכן ענדערונגען, קערעקשאַנז, ימפּרווומאַנץ, מאָדיפיקאַטיאָנס און ימפּרווומאַנץ צו ST פּראָדוקטן און / אָדער דעם דאָקומענט אין קיין צייט אָן באַמערקן. פּערטשאַסערז זאָל באַקומען די לעצטע באַטייַטיק אינפֿאָרמאַציע אויף ST פּראָדוקטן איידער פּלייסינג אָרדערס. ST פּראָדוקטן זענען סאָלד לויט צו ST ס טערמינען און באדינגונגען פון פאַרקויף אין דער צייט פון דער דערקענטעניש פון סדר.
פּערטשאַסערז זענען בלויז פאַראַנטוואָרטלעך פֿאַר די ברירה, סעלעקציע און נוצן פון ST פּראָדוקטן און ST אַסומז קיין אַכרייַעס פֿאַר אַפּלאַקיישאַן הילף אָדער די פּלאַן פון פּערטשאַסערז פּראָדוקטן.
קיין דערלויבעניש, אויסדריקן אָדער ימפּלייד, צו קיין אינטעלעקטואַל פאַרמאָג רעכט איז דערלויבט דורך ST.
ריסייל פון ST פּראָדוקטן מיט פּראַוויזשאַנז אַנדערש פון די אינפֿאָרמאַציע געשטעלט דאָ וועט פּאָסל קיין וואָראַנטי געגעבן דורך ST פֿאַר אַזאַ פּראָדוקט.
ST און די ST לאָגאָ זענען טריידמאַרקס פון ST. פֿאַר נאָך אינפֿאָרמאַציע וועגן ST טריידמאַרקס, אָפּשיקן צו www.st.com/trademarks. אַלע אנדערע פּראָדוקט אָדער דינסט נעמען זענען די פאַרמאָג פון זייער ריספּעקטיוו אָונערז.
אינפֿאָרמאַציע אין דעם דאָקומענט סאַפערז און ריפּלייסיז אינפֿאָרמאַציע ביז אַהער סאַפּלייד אין קיין פריערדיקע ווערסיעס פון דעם דאָקומענט.
© 2023 STMicroelectronics - כל רעכט רעזערווירט

UM2548 - רעוו 2

דאָקומענטן / רעסאָורסעס

STMicroelectronics UM2548 Linux דרייווער [pdfבאַניצער מאַנואַל UM2548 לינוקס דרייווער, UM2548, לינוקס דרייווער, דרייווער

רעפערענצן

• באַניצער מאַנואַל