מנהל התקן UM3078 ST25DVXXKC Linux Space User

מָבוֹא

מסמך זה מראה כיצד להשתמש בחבילת התוכנה STSW-ST25DV009 כדי לשלוט ב-ST25DVXXKC NFC דינמי tag מפלטפורמת Linux®. חבילת התוכנה STSW-ST25DV009 מספקת מנהל התקן מרחב משתמש של Linux® וכמה דגמיםampקבצים שניתן להגדיר לרוץ על כל פלטפורמת Linux®. ST25DVXXKC הוא דינמי NFC tag, שניתן לנהל על ידי קורא RFID או על ידי טלפון NFC, יש לו גם ממשק I2C לתקשורת עם MCU או MPU. ST25DVXXKC זמין, למשלample, על לוח ההרחבה X-NUCLEO-NFC07A1. מידע ותיעוד הקשורים לרכיבי NFC, לוח ההרחבה X-NUCLEO-NFC07A1 ותוכנת STSWST25DV009 זמינים ב- www.st.com.

מַטָרָה

ST25DVXXKC NFC/RFID דינמי tags הם מעגלים משולבים שיכולים לתקשר עם שניהם:

• קוראי RFID וטלפונים NFC, מבוססים על ISO/IEC 15693 ו-NFC Forum Type 5 tag מפרטים.
• MCU או MPU באמצעות ממשק I2C.

ניתן להשתמש במכשירים אלה בפלטפורמת לינוקס כדי לאפשר תקשורת אלחוטית, כדי להעביר בקלות נתונים מפלטפורמת לינוקס לסמארטפון (לדוגמה: URL, קואורדינטות GPS, נתוני התאמה מחוץ לפס וכן הלאה). חבילת התוכנה STSW-ST25DV009 מספקת את הקוד הדרוש לשליטה במכשיר ST25DVXXKC ממרחב המשתמש של פלטפורמת לינוקס בעלת בקר I2C.

מבנה תוכנה

תוכנת STSW-ST25DV009 מחולקת למספר שכבות:

• מנהל התקן רכיב ST25DVXXKC
• חבילת תמיכה לדירקטוריון
• תווך ספריית NDEF
• Sampקודי הפרויקט

מנהל התקן רכיב ST25DVXXKC
מנהל ההתקן של הרכיב ST25DVXXKC מספק את השיטות להגדרה ובקרה של התקן ST25DVXXKC. חלק זה של הקוד אינו תלוי בחומרה, והוא דורש כמה פונקציות IO בסיסיות ליישום (ראה סעיף 2.2 חבילת תמיכה בלוח) כגון I2C קריאה/כתיבה, בקרת gpio. מנהל ההתקן של הרכיב ST25DVXXKC files נמצאים בספריה Drivers/BSP/Components/ST25DVxxKC.

חבילת תמיכה לדירקטוריון
חבילת התמיכה של הלוח מיישמת שני היבטים שונים:

• פונקציות ה-IO ברמה נמוכה הנקראות על ידי מנהל ההתקן של הרכיב ST25DVXXKC
• API לשיטות מנהל ההתקן של רכיב ST25DVXXKC

חבילת התמיכה בלוח files נמצאים בספריית Drivers/BSP/Linux.

פונקציות IO ברמה נמוכה
שכבת ה-IO ברמה נמוכה מיישמת את כל הפונקציות ברמה הנמוכה הנדרשת על ידי מנהל ההתקן ST25DVXXKC. שכבה זו מיושמת בספריית Drivers/BSP/Linux עם ה fileהמתוארים בטבלה 1.

Files	תֵאוּר
	אֵלֶה files ליישם את הפונקציות כדי:
st25dv-i2c_linux.c	• הגדר, קרא וכתוב את ממשק I2C
st25dv-i2c_linux.h	• קבל סימון של אלפית שנייה
	קוד זה מסתמך על /dev/i2c-X file להשתלט על הציוד ההיקפי של I2C.
st25dv-i2c-gpo.c st25dv-i2c-gpo.h	אֵלֶה files ליישם את הפונקציות לקביעת תצורה וקבלת הפרעות מסיכת ה-GPO של ST25DVXXKC. קוד זה משתמש ב-/dev/gpiochipX file ושרשור ייעודי לסקר עבור אירוע ב-GPIO.
st25dv-i2c-lpd.c st25dv-i2c-lpd.h	אֵלֶה files ליישם את הפונקציות לקביעת התצורה והשליטה של ​​פין הפחתת הספק נמוך של ST25DVXXKC. קוד זה משתמש בדברים הבאים files כדי לשלוט ב-GPIO: •/sys/class/gpio/export •/sys/class/gpio/gpioXX/direction • /sys/class/gpio/gpioXX/value.

פונקציות אלו הן ספציפיות ללוח המשמש וחייבות להיות מותאמות לפלטפורמה שבה הן משמשות (ראה סעיף 3 כיצד להגדיר לוח).

API לשיטות מנהל ההתקן ST25DVXXKC
API זה הוא רק מעטפת סביב מנהל ההתקן של הרכיב ST25DVXXKC. זה מיושם ב-Drivers/BSP/Linux/bsp_nfctag.c ומנהלי התקנים/BSP/Linux/bsp_nfctag.h files.

תווך ספריית NDEF
פורום NFC מגדיר פורמט סטנדרטי לשימוש בעת קריאה/כתיבה של מכשיר NFC. פורמט זה ידוע בשם
הודעות NDEF. ספריית NDEF מיישמת שיטות ברמה גבוהה לעיצוב נתונים בקלות לתואם NDEF
דֶרֶך. ספריית STMicroelectronics זו מסופקת בתור תוכנת ביניים, בלתי תלויה לחלוטין בחומרה וב
מגיע עם ממשק file ליישום עבור הפלטפורמה הממוקדת.
בחבילת התוכנה STSW-ST25DV009 ממשק אלה files מיושמים ב:

• Projects\NDEF_URI\Src\lib_NDEF_config.c
• Projects\NDEF_BLUETOOTH\Src\lib_NDEF_config.c

תוכנת התווך של ספריית NDEF files נמצאים בספריית Middlewares/ST/lib_nfc

Sample פרויקטים
בחלק זה, סיכום קצרview של ה-sampהפרויקטים הכלולים בחבילת STSW-ST25DV009 מסופקים. ה-sample פרויקטים:

• חייב להיות מותאם לפלטפורמת לינוקס הממוקדת (כפי שמוסבר בסעיף 3 כיצד להגדיר לוח)
• הראה למשתמש כיצד להשתמש בממשקי ה-API כדי לאתחל ולהשתמש נכון ב-NFC/RFID הדינמי tag IC (מכשיר ST25DVxxKC)

שלampהפרויקטים נמצאים בספריית ./Projects.

• NDEF_URI
  יישום זה מראה כיצד לכתוב הודעת URI NDEF פשוטה ל-ST25DVXXKC EEPROM באמצעות תוכנת האמצע NDEF lib. הודעה מוצגת כאשר ההודעה נכתבה בהצלחה. ניתן להשתמש בסמארטפון או בקורא NFC לקריאת הודעת NDEF_URI.
• NDEF_BLUETOOTH
  יישום זה מראה כיצד לכתוב הודעת Bluetooth® OOB NDEF ל-ST25DVXXKC EEPROM באמצעות תוכנת האמצע NDEF lib. הודעה מוצגת כאשר ההודעה נכתבה בהצלחה. ניתן להשתמש בסמארטפון או בקורא NFC לקריאת הודעת NDEF_BLUETOOTH.
• GPO (פלט למטרות כלליות)
  האקסית הזוample מראה כיצד להפעיל ולהשתמש ב-GPO. לאחר האתחול, פסיקה מתוכנתת לזהות שינויים בשדה בקרבת ה-ST25DVXXKC. הודעה מוצגת כאשר השדה מזוהה וכאשר השדה נעלם.
• I2CPROTECTION
  האקסית הזוample מראה כיצד ליצור אזורים ב-ST25DVXXKC וכיצד להגן עליהם. טקסט מוצג בקונסולה.
• LPD (הפסקת צריכת חשמל נמוכה)
  האקסית הזוample מראה כיצד להפעיל פין ירידה בצריכת חשמל נמוכה (LPD). על ידי הזנת "1" או "0", סיכת ה-LPD מופעלת או מושבתת. כאשר סיכת ה-LPD מופעלת, ה-ST25DVXXKC VCC מנותק, צריכת החשמל מינימלית ותקשורת באמצעות I2C אינה זמינה.
  פֶּתֶק: לא ניתן להפעיל בדיקה זו עם לוח ההרחבה X-NUCLEO-NFC07A1 מכיוון שהלוח אינו מחבר פין כזה.
• תיבת דואר
  האקסית הזוample מראה כיצד לכתוב הודעה לתיבת הדואר וכיצד לקרוא את רישום מצב תיבת הדואר של התקן ST25DVXXKC. הטקסט מוצג.
• I2CChannel
  האקסית הזוample מראה כיצד לשנות את כתובת העבד של I2C ומראה שכתיבת הודעה לתיבת הדואר וקריאה של מצב תיבת הדואר של התקן ST25DVXXKC פועלים שניהם עם כתובת עבד חדשה. הטקסט מוצג וכתובת העבדים של I2C הוחזרה לערך ברירת המחדל.
  פֶּתֶק: אם המשתמש עוצר את היישום לפני סיומו, יש להשתמש בכתובת עבד I2C המתאימה לתקשורת הבאה עם ST25DVXXKC.
• I2CMod
  האקסית הזוample מראה כיצד לשנות את מצב העבדות של I2C (רגיל/RF כבוי) ושעם מצב עבדות I2C מוגדר ל-'RFOFF' לא מטופלת יותר תקשורת NFC בעוד שעם מצב עבדות I2C מוגדר ל'רגיל' התקשורת NFC מעובדת.

כיצד להגדיר לוח

שכבת חבילת התמיכה של הלוח חייבת להיות מותאמת מעט לפלטפורמת לינוקס הממוקדת, על מנת לבחור את הציוד ההיקפי של I2C לתקשורת עם ST25DVXXKC וה-GPIOs מחוברים לפינים ST25DVXXKC GPO ו-LPD. כל ההגדרות הנדרשות מפורטות להלן file: מנהלי התקנים/BSP/Linux/hwconfig.h.

טבלה 2. הגדרת תצורת החומרה:

תכונה	לְהַגדִיר	תֵאוּר
I2C	ST25DV_I2C_NR	זה מגדיר את המספר ההיקפי של I2C המשמש לתקשורת עם ST25DVXXKC. הערך משמש להשלמת הנתיב ל-/dev/i2c-X file.
לע"מ	ST25DV_GPO_GPIOCHIP	הוא מגדיר את מספר ה-GPIOCHIP המחובר לפין ST25DVXXKC GPO. הערך משמש להשלמת הנתיב אל /dev/gpiochipX file.
	ST25DV_GPO_PIN	הוא מגדיר את מספר ה-GPIO של ה-GPIOCHIP המחובר לפין ST25DVXXKC GPO.
LPD	ST25DV_LPD_PIN	הוא מגדיר את מספר ה-GPIO העולמי המחובר לפין ST25DVXXKC LPD. הוא משמש לייצוא GPIO זה.
	ST25DV_LPD_DIRECTION	זה מגדיר את הנתיב ללינוקס file הגדרת כיוון GPIO המחובר לפין ST25DVXXKC LPD כגון: /sys/class/gpio/gpioXX/direction
	ST25DV_LPD_VALUE	זה מגדיר את הנתיב ללינוקס file הגדרת ערך GPIO המחובר לפין ST25DVXXKC LPD כגון: /sys/class/gpio/gpioXX/value

הגדרת חומרה

דרישות חומרה:

• מחשב אישי/מחשב וירטואלי מבוסס אובונטו גרסה 16.04 ומעלה
• לוח STM32MP157F-DK2 (ערכת גילוי)
• X-NUCLEO-NFC07A1
• כרטיס מיקרו SD בנפח 8 GB לאתחול ה- STM32MP157F-DK2
• קורא כרטיסי SD / קישוריות LAN
• כבל USB מסוג USB מסוג A לסוג מיקרו B (אופציונלי)
• כבל USB מסוג A ל-C Type-C
• ספק כוח 5V 3A תואם USB PD

המחשב האישי/וירטואלי מהווה את פלטפורמת הפיתוח הצולבת לבניית ה-sampקוד יישום le projects. החומרה מחוברת באופן הבא:

1. בהתאם למצב התצורה של לוח הגילוי STM32MP157F-DK2 I2C (רגיל, מהיר, מהיר+), ניתן להגדיל את נגדי המשיכה של לוח ההרחבה X-NUCLEO-NFC07A1 I2C (R5 ו-R6) עד ל-10 kΩ.
   
2. חבר את לוח ההרחבה X-NUCLEO-NFC07A1 למחברי Arduino® בצד התחתון של לוח הגילוי STM32MP157F-DK2.
   
3. במידת הצורך, חבר את מתכנת/מאתר הבאגים ST-LINK המוטבע בלוח הגילוי למחשב מארח באמצעות יציאת USB מסוג micro B (CN11).
4. הפעל את לוח הגילוי דרך יציאת USB Type C (CN6).
   

הידור והרצה של ה-sample פרויקטים

כל STSW-ST25DV009 sample project מגיע עם מותגfile וניתן להידור באמצעות מהדר C כמו GCC. ספריית Linux pthread משמשת ליצירת שרשור שמזהה אירוע בקו GPO, ספרייה זו נדרשת לקישור נכון בזמן ההידור. נהלי איסוף והרצה:

1. על מארח המחשב:
   • העתק את כל העץ ST25DVLinux files למחשב/מכונה וירטואלית: scp -r :.
2. במחשב/מחשב וירטואלי:
   • הידור צולב של היישום (זה יוצר קובץ הפעלה מקושר סטטית file): cd ~//Projects/ make clean all
   • העתק exe file ללוח היעד של לינוקס (RPi, STM32MP157F-DK2, …): scp ~//Projects//st25dv-i2c_ root@:.
3. בלוח STM32MP157F-DK2:
   • הפעל את ה-exe המועתק file: chmod +x st25dv-i2c_ ./st25dv-i2c_

היסטוריית גרסאות 

הודעה חשובה - קרא בעיון

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

מסמכים / משאבים

ST UM3078 ST25DVXXKC Linux Driver Space User [pdfמדריך למשתמש מנהל התקן UM3078 ST25DVXXKC Linux Space User, UM3078 ST25DVXXKC, UM3078, ST25DVXXKC, Linux Driver Space User, UM3078 Linux Space User Driver, ST25DVXXKC Linux Driver Space User, Driver Linux, Driver Space User, Driver Linux, Driver Space User, Driver Linux

הפניות

• מדריך למשתמש