STMicroelectronics UM2193 MotionAR אַקטיוויטעט דערקענונג ביבליאָטעק

הקדמה

די Motion AR איז אַ מיטלוואַרע ביבליאָטעק טייל פון X-CUBE-MEMS1 ווייכווארג און לויפט אויף STM32. עס גיט פאַקטיש-צייט אינפֿאָרמאַציע וועגן דעם טיפּ פון אַקטיוויטעט דורכגעקאָכט דורך דער באַניצער. עס איז ביכולת צו ויסטיילן די פאלגענדע אַקטיוויטעטן: סטיישאַנערי, גיין, שנעל גיין, דזשאַגינג, בייקינג, דרייווינג.

די ביבליאָטעק איז בדעה צו אַרבעטן בלויז מיט ST MEMS.

דער אַלגערידאַם איז צוגעשטעלט אין סטאַטיק ביבליאָטעק פֿאָרמאַט און איז דיזיינד צו זיין געוויינט אויף STM32 מיקראָקאָנטראָללערס באזירט אויף די ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 אָדער ARM® Cortex®-M7 אַרקאַטעקטשער.

עס איז געבויט אויף שפּיץ פון STM32Cube ווייכווארג טעכנאָלאָגיע וואָס יזיז פּאָרטאַביליטי אַריבער פאַרשידענע STM32 מיקראָקאָנטראָללערס.

די ווייכווארג קומט מיט סampדי ימפּלאַמענטיישאַן פליסנדיק אויף אַן X-NUCLEO-IKS01A3 אָדער X-NUCLEO-IKS4A1 יקספּאַנשאַן ברעט אויף אַ NUCLEO-F401RE, NUCLEO-L152RE אָדער NUCLEO-U575ZI-Q אַנטוויקלונג ברעט.

אַקראַנימז און אַבריווייישאַנז

טיש 1. רשימה פון אַקראַנימז

אַקראַנים	באַשרייַבונג
API	אַפּפּליקאַטיאָן פּראָגראַממינג צובינד
בספּ	באָרד שטיצן פּעקל
GUI	גראַפיקאַל באַניצער צובינד
HAL	ייַזנוואַרג אַבסטראַקציע שיכטע
IDE	ינטעגראַטעד אַנטוויקלונג סוויווע

Motion AR מידוואַרע ביבליאָטעק אין X-CUBE-MEMS1 ווייכווארג יקספּאַנשאַן

באַוועגונג אַר איבערview

די Motion AR ביבליאָטעק יקספּאַנדז די פאַנגקשאַנאַליטי פון די X-CUBE-MEMS1 ווייכווארג.
די ביבליאָטעק אַקווייערז דאַטן פון די אַקסעלעראַמאַטער און גיט אינפֿאָרמאַציע וועגן דעם טיפּ פון אַקטיוויטעט דורכגעקאָכט דורך דער באַניצער.

די ביבליאָטעק איז דיזיינד בלויז פֿאַר ST MEMS. פאַנגקשאַנאַליטי און פאָרשטעלונג ווען ניצן אנדערע MEMS סענסאָרס זענען נישט אַנאַלייזד און קענען זיין באטייטיק אַנדערש פון וואָס דיסקרייבד אין דעם דאָקומענט.
Sampדי ימפּלאַמענטיישאַן איז בנימצא אויף X-NUCLEO-IKS01A3 אָדער X-NUCLEO-IKS4A1 יקספּאַנשאַן באָרדז, מאָונטעד אויף אַ NUCLEO-F401RE, NUCLEO-L152RE אָדער NUCLEO-U575ZI-Q אַנטוויקלונג ברעט.

Motion AR ביבליאָטעק

טעכניש אינפֿאָרמאַציע גאָר דיסקרייבינג די פאַנגקשאַנז און פּאַראַמעטערס פון Motion AR APIs קענען זיין געפֿונען אין די MotionAR_Package.chm קאָמפּילעד HTML file ליגן אין די דאַקיומענטיישאַן טעקע.

באַוועגונג אַר ביבליאָטעק באַשרייַבונג

• די Motion AR טעטיקייט דערקענונג ביבליאָטעק מאַנידזשיז דאַטן קונה פֿון אַקסעלעראַמאַטער; עס פֿעיִקייטן:
• מעגלעכקייט צו ויסטיילן די פאלגענדע אַקטיוויטעטן: סטיישאַנערי, גיין, שנעל גיין, דזשאַגינג, בייקינג, דרייווינג
• דערקענונג באזירט אויף אַקסעלעראַמאַטער דאַטן בלויז
• פארלאנגט אַקסעלעראַמאַטער דאַטן סampלינג אָפטקייַט: 16 הז
• רעסורסן באדערפענישן:
  • קאָרטעקס-מ3: 8.5 קב פון קאָד און 1.4 קב פון דאַטן זכּרון
  • קאָרטעקס-מ33: 7.8 קב פון קאָד און 1.4 קב פון דאַטן זכּרון
  • קאָרטעקס-מ4: 7.9 קב פון קאָד און 1.4 קב פון דאַטן זכּרון
  • קאָרטעקס-מ7: 8.1 קב פון קאָד און 1.4 קב פון דאַטן זכּרון
• בנימצא פֿאַר ARM Cortex-M3, Cortex-M33, Cortex-M4 און Cortex-M7 אַרקאַטעקטשערז

MotionAR APIs

די MotionAR APIs זענען:

• uint8_t MotionAR_GetLibVersion (char *version)
  • ריטריווז די ווערסיע פון ​​דער ביבליאָטעק
  • * ווערסיע איז אַ טייַטל צו אַ מענגע פון ​​35 אותיות
  • קערט די נומער פון אותיות אין די ווערסיע שטריקל
• void MotionAR_Initialize (פּאָסל)
  • פּערפאָרמז MotionAR ביבליאָטעק יניטיאַליזאַטיאָן און סעטאַפּ פון די ינערלעך מעקאַניזאַם
  • די CRC מאָדולע אין STM32 מיקראָקאָנטראָללער (אין RCC פּעריפעראַל זייגער געבן רעגיסטרירן) מוזן זיין
    ענייבאַלד איידער ניצן די ביבליאָטעק
    באַמערקונג: די פֿונקציע מוזן זיין גערופֿן איידער איר נוצן די אַקסעלעראַמאַטער קאַלאַבריישאַן ביבליאָטעק.
• void MotionAR_Reset (פּאָסל)
  • ריסעץ אַקטיוויטעט דערקענונג אַלגערידאַמז
• void MotionAR_Update (MAR_input_t *data_in, MAR_output_t *data_out, int64_t
  צייטamp)
  • עקסאַקיוץ אַקטיוויטעט דערקענונג אַלגערידאַם
  • * דאַטע_אין פּאַראַמעטער איז אַ טייַטל צו אַ סטרוקטור מיט אַרייַנשרייַב דאַטן
  • די פּאַראַמעטערס פֿאַר די סטרוקטור טיפּ MAR_input_t זענען:
    • אַקק_קס איז אַקסעלעראַמאַטער סענסער ווערט אין X אַקס אין ג
    • אַקק_י איז אַקסעלעראַמאַטער סענסער ווערט אין י אַקס אין ג
    • אַקק_ז איז אַקסעלעראַמאַטער סענסער ווערט אין ז אַקס אין ג
  • * דאַטן_אָוט פּאַראַמעטער איז אַ טייַטל צו ענום מיט די פאלגענדע זאכן:
    • MAR_NOACTIVITY = 0
    • MAR_STATIONARY = 1
    • MAR_WALKING = 2
    • MAR_FASTWALKING = 3
    • MAR_JOGGING = 4
    • MAR_BIKING = 5
    • MAR_DRIVING = 6
  • צייטamp איז אַ רעלאַטיוו צייט פֿאַר פאַקטיש sampאין מיז
• void MotionAR_ Set Orientation_ Acc(const char *acc_ orientation)
  • שטעלט די אַקסעלעראַמאַטער דאַטן אָריענטירונג
  • קאַנפיגיעריישאַן איז יוזשאַוואַלי געטאן מיד נאָך די Motion AR_ Initialize פונקציע רופן
  • *acc_ אָריענטירונג פּאַראַמעטער איז אַ טייַטל צו אַ שטריקל פון דריי אותיות וואָס ינדיקייץ די ריכטונג פון יעדער פון די positive אָריענטיישאַנז פון די רעפֿערענץ ראַם געניצט פֿאַר אַקסעלעראַמאַטער דאַטן רעזולטאַט, אין די סיקוואַנס רענטגענ, י, ז. גילטיק וואַלועס זענען: n (צפון) אָדער s (דרום), וו (מערב) אָדער E (מזרח), ו (אַרויף) אָדער ד (אַראָפּ)
  • ווי געוויזן אין די פיגור אונטן, די X-NUCLEO-IKS4A1 אַקסעלעראַמאַטער סענסער האט אַ SEU (X-South, y-East, z-Up), אַזוי די שטריקל איז: "סו".

פיגורע 1. סענסאָר אָריענטירונג עקסample

API לויפן טשאַר

פיגורע 2. באַוועגונג אַר אַפּי לאָגיק סיקוואַנס

דעמאָ קאָד

די פאלגענדע דעמאַנסטריישאַן קאָד לייענט דאַטן פון אַקסעלעראַמאַטער סענסער און באַקומען די טעטיקייט קאָד

[…] #define VERSION_STR_LENG 35 […] /*** יניטיאַליזאַטיאָן ***/ char lib_version[VERSION_STR_LENG]; char acc_orientation[] = "סו"; /* אַקטיוויטעט דערקענונג אַפּי יניטיאַליזאַטיאָן פֿונקציע */ MotionAR_Initialize(); /* אָפּטיאָנאַל: באַקומען ווערסיע */ MotionAR_GetLibVersion(lib_version); /* שטעלן אַקסעלעראַמאַטער אָריענטירונג */ מאָטיאָןאַר_סעטאָריענטאַטיאָן_אַקק(אַקק_אָריענטאַטיאָן); […] /*** ניצן אַקטיוויטעט דערקענונג אַלגערידאַם ***/ Timer_ OR_ Data Rate_ Interrupt_ Handler() {

MAR_ינפּוט_ט דאַטן_ אין; MAR_ רעזולטאַט_ ה טעטיקייט; /* באַקומען אַקסעלעריישאַן X/Y/Z אין ג */ MEMS_Read_AccValue(&data_in.acc_x, &data_in.acc_y, &data_in.acc_z); /* באַקומען קראַנט צייט אין מיז */ TIMER_Get_TimeValue(×tamp_מיס); /* אַקטיוויטעט דערקענונג אַלגערידאַם דערהייַנטיקן */ MotionAR_Update (דאַטאַ_ין, דאַטן_אָוט, צייטamp_מיס); }

אַלגערידאַם פאָרשטעלונג

דער אַלגערידאַם פֿאַר אַקטיוויטעט דערקענונג ניצט בלויז דאַטן פון די אַקסעלעראַמאַטער און לויפט מיט אַ נידעריק אָפטקייַט (16 הז) צו רעדוצירן מאַכט קאַנסאַמשאַן.

טיש 2. אַלגערידאַם פאָרשטעלונג

אַקטיוויטעט	דעטעקשאַן מאַשמאָעס (טיפּיש)(1)	בעסטער פאָרשטעלונג	סאַסעפּטאַבאַל	פירן שטעלעס
סטיישאַנערי	92.27%		האלטן אין האַנט און שווער טעקסטינג	אַלע: הויזן קעשענע, העמד קעשענע, צוריק קעשענע, לעבן די קאָפּ, עטק.
גיין	99.44%	שריט קורס ≥ 1.4 שריט / s	שריט קורס ≤ 1.2 שריט / s	אַלע
שנעל גיין	95.94%	שריט קורס ≥ 2.0 שריט / s		אַלע
דזשאַגינג	98.49%	שריט קורס ≥ 2.2 שריט / s	געדויער <1 מינוט; גיכקייַט < 8 קילאמעטער/ה	הויזן קעשענע, אָרעם מאַך, אין האַנט
בייקינג	91.93%	דרויסנדיק גיכקייַט ≥11 קילאמעטער/ה	פּאַסאַזשיר אַוועקזעצן, הענטשקע אָפּטייל	באַקפּאַק, העמד קעשענע, הויזן קעשענע
דרייווינג	78.65%	גיכקייַט ≥ 48 קילאמעטער/ה	פּאַסאַזשיר אַוועקזעצן, הענטשקע אָפּטייל	גלעזל האָלדער, דאַש ברעט, העמד קעשענע, הויזן קעשענע

1. טיפּיש ספּעסאַפאַקיישאַנז זענען נישט געראַנטיד

טיש 3. Cortex-M4 און Cortex-M3: ילאַפּסט צייט (µs) אַלגערידאַם 

Cortex-M4 STM32F401RE ביי 84 מהז			Cortex-M3 STM32L152RE ביי 32 מהז
מין	אַווג	מאַקס	מין	אַווג	מאַקס
2	6	153	8	130	4883

טיש 4. קאָרטעקס-מ33 און קאָרטעקס-מ7: ילאַפּסט צייט (μs) אַלגערידאַם 

Cortex-M33 STM32U575ZI-Q ביי 160 מהז			Cortex-M7 STM32F767ZI ביי 96 מהז
מין	אַווג	מאַקס	מין	אַווג	מאַקס
<1	2	74	5	9	145

Sampדי אַפּלאַקיישאַן

די MotionAR מידוואַרע קענען זיין מאַניפּיאַלייטיד צו בויען באַניצער אַפּלאַקיישאַנז; וויampדי אַפּלאַקיישאַן איז צוגעשטעלט אין די אַפּפּליקאַטיאָן טעקע.
עס איז דיזיינד צו לויפן אויף אַ NUCLEO-F401RE, NUCLEO-L152RE אָדער NUCLEO-U575ZI-Q אַנטוויקלונג ברעט קאָננעקטעד צו אַן X-NUCLEO-IKS01A3 אָדער X-NUCLEO-IKS4A1 יקספּאַנשאַן ברעט.

די אַפּלאַקיישאַן אנערקענט דורכגעקאָכט אַקטיוויטעטן אין פאַקטיש-צייט. דאַטן קענען זיין געוויזן דורך אַ GUI. דער אַלגערידאַם אנערקענט סטיישאַנערי, גיין, שנעל גיין, דזשאַגינג, בייק ריידינג און דרייווינג אַקטיוויטעטן. וסב קאַבלע קשר איז פארלאנגט צו מאָניטאָר פאַקטיש-צייט דאַטן. די ברעט איז פּאַוערד דורך די פּיסי דורך וסב קשר. דעם אַלאַוז דער באַניצער צו ווייַזן די דיטעקטאַד טעטיקייט, אַקסעלעראַמאַטער דאַטן, צייט סטamp און יווענטשאַוואַלי אנדערע סענסער דאַטן, אין פאַקטיש-צייט, ניצן די MEMS-Studio GUI אַפּלאַקיישאַן.

MEMS-Studio אַפּלאַקיישאַן

די sampדי אַפּלאַקיישאַן ניצט די MEMS-Studio GUI אַפּלאַקיישאַן, וואָס קענען זיין דאַונלאָודיד פֿון www.st.com.

שריט 1. פאַרזיכערן אַז די נויטיק דריווערס זענען אינסטאַלירן און די STM32 Nucleo ברעט מיט די צונעמען יקספּאַנשאַן ברעט איז קאָננעקטעד צו די פּיסי.
שריט 2. קאַטער די MEMS-Studio אַפּלאַקיישאַן צו עפֿענען די הויפּט אַפּלאַקיישאַן פֿענצטער.

אויב אַ STM32 Nucleo ברעט מיט שטיצט פירמוואַרע איז קאָננעקטעד צו די פּיסי, עס איז אויטאָמאַטיש דיטעקטאַד די צונעמען קאַם פּאָרט. דרוק קאָננעקט קנעפּל צו עפֿענען דעם פּאָרט.

פיגורע 3. מעמס-סטודיאָ - קאָננעקט 

שריט 3. ווען קאָננעקטעד צו STM32 Nucleo ברעט מיט שטיצט פירמוואַרע ביבליאָטעק עוואַלואַטיאָן קוויטל איז געעפנט.

צו אָנהייבן און האַלטן דאַטן סטרימינג טאַגאַל די צונעמען אָנהייב / האַלטן קנעפּל אויף די ויסווייניקסט ווערטיקאַל געצייַג באַר.
די דאַטן קומען פון די קאָננעקטעד סענסער קענען זיין viewסאַלעקטינג די דאַטאַ טאַבלע קוויטל אויף די ינער ווערטיקאַל געצייַג באַר.

פיגורע 4. מעמס-סטודיאָ - ביבליאָטעק עוואַלואַטיאָן - דאַטאַ טיש 

פיגורע 5. MEMS-Studio - ביבליאָטעק אפשאצונג - אַקטיוויטעט דערקענונג

שריט 5. אויסקלייַבן די היט צו File קוויטל אויף די ינער ווערטיקאַל געצייַג באַר צו עפֿענען די דאַטן לאָגינג קאַנפיגיעריישאַן פֿענצטער. אויסקלייַבן וואָס סענסער און טעטיקייט דאַטן צו ראַטעווען צו קלאָץ file. איר קענען אָנהייבן אָדער האַלטן שפּאָרן דורך געבן אַ קליק אויף די קאָראַספּאַנדינג אָנהייב / האַלטן קנעפּל.

פיגורע 6. מעמס-סטודיאָ - ביבליאָטעק עוואַלואַטיאָן - היט צו File

רעפערענצן

אַלע די פאלגענדע רעסורסן זענען פריי בנימצא אויף www.st.com.

1. UM1859: אָנהייב מיט די X-CUBE-MEMS1 באַוועגונג MEMS און ינווייראַנמענאַל סענסער ווייכווארג יקספּאַנשאַן פֿאַר STM32Cube
2. UM1724: STM32 Nucleo-64 באָרדז (MB1136)
3. UM3233: אָנהייב מיט MEMS-Studio

רעוויזיע געשיכטע

טיש 5. דאָקומענט רעוויזיע געשיכטע

טאָג	ווערסיע	ענדערונגען
10-אפריל-2017	1	ערשט מעלדונג.
26-2018 יאנואר	2	דערהייַנטיקט אָפּטיילונג 3 שampדי אַפּלאַקיישאַן. צוגעגעבן רעפערענצן צו NUCLEO-L152RE אַנטוויקלונג ברעט און טיש 3. ילאַפּסט צייט (μs) אַלגערידאַם.
19-מערץ 2018	3	דערהייַנטיקט הקדמה, אָפּטיילונג 2.1 מאָטיאָן AR איבערview און אָפּטיילונג 2.2.5 אַלגערידאַם פאָרשטעלונג.
14-פעברואר-2019	4	דערהייַנטיקט פיגורע 1. סענסאָר אָריענטירונג עקסampלע, טיש 3. ילאַפּסט צייט (µs) אַלגערידאַם און פיגורע 3. STM32 Nucleo: לעדס, קנעפּל, דזשאַמפּער. צוגעגעבן X-NUCLEO-IKS01A3 יקספּאַנשאַן ברעט קאַמפּאַטאַבילאַטי אינפֿאָרמאַציע.
20-מערץ 2019	5	דערהייַנטיקט אָפּטיילונג 2.2.2 מאָטיאָן אַר אַפּיס, פיגורע 3. מעמס-סטודיאָ - קאָננעקט, פיגורע 4. מעמס-סטודיאָ - ביבליאָטעק עוואַלואַטיאָן - דאַטאַ טיש, פיגורע 5. מעמס-סטודיאָ - ביבליאָטעק עוואַלואַטיאָן - אַקטיוויטעט דערקענונג און פיגורע 6. מעמס-סטודיאָ - ביבליאָטעק עוואַלואַטיאָן - היט צו File.
04-אפריל-2024	6	דערהייַנטיקן אָפּטיילונג הקדמה, אָפּטיילונג 2.1: MotionAR איבערview, אָפּטיילונג 2.2.1: MotionAR ביבליאָטעק באַשרייַבונג, MotionAR APIs, אָפּטיילונג 2.2.4: דעמאָ קאָד, אָפּטיילונג 2.2.5: אַלגערידאַם פאָרשטעלונג, אָפּטיילונג 3: שampדי אַפּלאַקיישאַן און אָפּטיילונג 4: MEMS-Studio אַפּלאַקיישאַן.

וויכטיק אָנזאָג - לייענען קערפאַלי

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

פּערטשאַסערז זענען בלויז פאַראַנטוואָרטלעך פֿאַר די ברירה, סעלעקציע און נוצן פון ST פּראָדוקטן און ST אַסומז קיין אַכרייַעס פֿאַר אַפּלאַקיישאַן הילף אָדער די פּלאַן פון פּערטשאַסערז פּראָדוקטן.

קיין דערלויבעניש, אויסדריקן אָדער ימפּלייד, צו קיין אינטעלעקטואַל פאַרמאָג רעכט איז דערלויבט דורך ST.

ריסייל פון ST פּראָדוקטן מיט פּראַוויזשאַנז אַנדערש פון די אינפֿאָרמאַציע געשטעלט דאָ וועט פּאָסל קיין וואָראַנטי געגעבן דורך ST פֿאַר אַזאַ פּראָדוקט.

ST און די ST לאָגאָ זענען טריידמאַרקס פון ST. פֿאַר נאָך אינפֿאָרמאַציע וועגן ST טריידמאַרקס, אָפּשיקן צו www.st.com/trademarks. אַלע אנדערע פּראָדוקט אָדער דינסט נעמען זענען די פאַרמאָג פון זייער ריספּעקטיוו אָונערז.

אינפֿאָרמאַציע אין דעם דאָקומענט סאַפערז און ריפּלייסיז אינפֿאָרמאַציע ביז אַהער סאַפּלייד אין קיין פריערדיקע ווערסיעס פון דעם דאָקומענט.

© 2024 STMicroelectronics - כל רעכט רעזערווירט

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

STMicroelectronics UM2193 MotionAR אַקטיוויטעט דערקענונג ביבליאָטעק [pdfבאַניצער מאַנואַל UM2193 MotionAR Activity Recognition Library, UM2193, MotionAR Activity Recognition Library, Activity Recognition Library, Recognition Library, Library

רעפערענצן

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