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هڪ NUCLEO-F01RE، NUCLEO-L3RE يا NUCLEO-U4ZI-Q ڊولپمينٽ بورڊ تي X-NUCLEO-IKS1A401 يا X-NUCLEO-IKS152A575 توسيع بورڊ تي عمل درآمد.

مخففات ۽ مخففات

جدول 1. مخففات جي فهرست

مخفف	وصف
API	ايپليڪيشن پروگرامنگ انٽرفيس
بي ايس پي	بورڊ سپورٽ پيڪيج
GUI	گرافڪ يوزر انٽرفيس
HAL	هارڊويئر خلاصو پرت
IDE	مربوط ترقي ماحول

X-CUBE-MEMS1 سافٽ ويئر توسيع ۾ موشن آر مڊل ويئر لائبريري

موشن AR ختمview

Motion AR لائبريري X-CUBE-MEMS1 سافٽ ويئر جي ڪارڪردگي کي وڌايو.
لائبريري تيز رفتاري کان ڊيٽا حاصل ڪري ٿي ۽ صارف پاران ڪيل سرگرمي جي قسم تي معلومات مهيا ڪري ٿي.

لائبريري صرف ST MEMS لاءِ ٺهيل آهي. ڪارڪردگي ۽ ڪارڪردگي جڏهن ٻين MEMS سينسر استعمال ڪندي تجزيو نه ڪيو ويو آهي ۽ خاص طور تي مختلف ٿي سگهي ٿو جيڪو دستاويز ۾ بيان ڪيو ويو آهي.
Sample عملدرآمد X-NUCLEO-IKS01A3 يا X-NUCLEO-IKS4A1 توسيع بورڊ تي موجود آهي، هڪ NUCLEO-F401RE، NUCLEO-L152RE يا NUCLEO-U575ZI-Q ڊولپمينٽ بورڊ تي نصب ٿيل آهي.

موشن آر لائبريري

MotionAR_Package.chm مرتب ڪيل HTML ۾ ڳولهي سگھجي ٿو Motion AR APIs جي افعال ۽ پيرا ميٽرن کي مڪمل طور تي بيان ڪرڻ واري ٽيڪنيڪل معلومات file دستاويزي فولڊر ۾ واقع آهي.

Motion AR لائبريري جي وضاحت

• موشن اي آر سرگرمي جي سڃاڻپ لائبريري تيز رفتار کان حاصل ڪيل ڊيٽا کي منظم ڪري ٿي. اهو خاصيتون:
• ھيٺين سرگرمين ۾ فرق ڪرڻ جو امڪان: اسٽيشنري، گھمڻ، تيز ھلڻ، جاگنگ، سائيڪل هلائڻ، ڊرائيونگ
• صرف accelerometer ڊيٽا جي بنياد تي سڃاڻپ
• گهربل accelerometer ڊيٽا sampلنگ جي تعدد: 16 Hz
• وسيلن جي گهرج:
  • Cortex-M3: 8.5 kB ڪوڊ ۽ 1.4 kB ڊيٽا ياداشت
  • Cortex-M33: 7.8 kB ڪوڊ ۽ 1.4 kB ڊيٽا ياداشت
  • Cortex-M4: 7.9 kB ڪوڊ ۽ 1.4 kB ڊيٽا ياداشت
  • Cortex-M7: 8.1 kB ڪوڊ ۽ 1.4 kB ڊيٽا ياداشت
• ARM Cortex-M3، Cortex-M33، Cortex-M4 ۽ Cortex-M7 آرڪيٽيڪچرز لاءِ دستياب آهي

MotionAR APIs

MotionAR APIs آهن:

• uint8_t MotionAR_GetLibVersion (چار * ورزن)
  • لائبريري جو نسخو ٻيهر حاصل ڪري ٿو
  • *ورجن 35 اکرن جي هڪ صف ڏانهن اشارو آهي
  • ورجن اسٽرنگ ۾ اکرن جو تعداد واپس ڪري ٿو
• void MotionAR_Initialize(void)
  • MotionAR لائبريري جي شروعات ۽ اندروني ميڪانيزم جي سيٽ اپ کي انجام ڏئي ٿو
  • CRC ماڊل STM32 مائڪرو ڪنٽرولر ۾ (آر سي سي پرديري گھڙي فعال رجسٽر ۾) هجڻ گهرجي
    لائبريري استعمال ڪرڻ کان اڳ فعال
    نوٽ: هن فنڪشن کي لازمي طور تي سڏيو وڃي ٿو استعمال ڪرڻ کان اڳ accelerometer calibration لائبريري.
• void MotionAR_Reset(void)
  • سرگرمي جي سڃاڻپ جي الگورتھم کي بحال ڪري ٿو
• void MotionAR_Update(MAR_input_t *data_in، MAR_output_t *ڊيٽا_آئوٽ، int64_t
  ٽائيمamp)
  • سرگرمي جي سڃاڻپ جي الگورتھم تي عمل ڪري ٿو
  • *data_in پيٽرولر ان پٽ ڊيٽا سان گڏ ھڪڙي جوڙجڪ ڏانھن ھڪڙو اشارو آھي
  • ساخت جي قسم MAR_input_t جا پيرا ميٽر آهن:
    • acc_x x محور ۾ accelerometer sensor value g ۾ آهي
    • acc_y accelerometer sensor value آهي Y axis in g ۾
    • acc_z آهي accelerometer sensor value in Z axis in g
  • *ڊيٽا_ آئوٽ پيٽرولر ھيٺ ڏنل شيون سان اينم ڏانھن اشارو ڪندڙ آھي:
    • MAR_NOACTIVITY = 0
    • MAR_STATIONARY = 1
    • MAR_WALKING = 2
    • MAR_FASTWALKING = 3
    • مار_جوگنگ = 4
    • مار_بائڪنگ = 5
    • مار_ڊرائيونگ = 6
  • ٽائيمamp حقيقي s لاء هڪ لاڳاپيل وقت آهيampلي ايم ۾
• void MotionAR_ Set Orientation_ Acc (const char *acc_ orientation)
  • accelerometer ڊيٽا جي رخ کي سيٽ ڪري ٿو
  • ترتيب عام طور تي فوري طور تي ڪئي ويندي آهي Motion AR_ Initialize function call کان پوءِ
  • *acc_ orientation parameter ٽن اکرن جي اسٽرنگ ڏانھن اشارو آھي جيڪو اشارو فريم جي ھر ھڪ مثبت رخ جي طرف اشارو ڪري ٿو جيڪو ايڪسليروميٽر ڊيٽا آئوٽ پٽ لاءِ استعمال ڪيو ويو آھي، تسلسل ۾ x، y، z. صحيح قدر آهن: n (اتر) يا s (ڏکڻ)، w (اولهه) يا اي (اوڀر)، يو (اوڀر) يا ڊي (هيٺ)
  • جيئن هيٺ ڏنل شڪل ۾ ڏيکاريل آهي، X-NUCLEO-IKS4A1 تيز رفتار سينسر وٽ هڪ SEU (x-ڏکڻ، y- اوڀر، z-Up) آهي، تنهنڪري تار آهي: "seu".

شڪل 1. سينسر اورينٽيشن Example

API فلو چار

شڪل 2. Motion AR API منطق ترتيب

ڊيمو ڪوڊ

هيٺ ڏنل مظاهري ڪوڊ تيز رفتار سينسر مان ڊيٽا پڙهي ٿو ۽ سرگرمي ڪوڊ حاصل ڪري ٿو

[...] # define VERSION_STR_LENG 35 […] /*** شروعات ***/ char lib_version[VERSION_STR_LENG]؛ char acc_orientation[] = "seu"؛ /* سرگرمي جي سڃاڻپ API شروعاتي فنڪشن */ MotionAR_Initialize()؛ /* اختياري: ورزن حاصل ڪريو */ MotionAR_GetLibVersion(lib_version)؛ /* accelerometer orientation سيٽ ڪريو */ MotionAR_SetOrientation_Acc(acc_orientation)؛ [...] /*** استعمال ڪندي سرگرمي جي سڃاڻپ الورورٿم ***/ ٽائمر_ يا_ ڊيٽا جي شرح_ مداخلت_ هينڊلر () {

MAR_input_t ڊيٽا_ ۾؛ MAR_ output_t سرگرمي؛ /* ايڪسلريشن حاصل ڪريو X/Y/Z ۾ g */ MEMS_Read_AccValue(&data_in.acc_x, &data_in.acc_y, &data_in.acc_z); /* موجوده وقت حاصل ڪريو ms ۾ */ TIMER_Get_TimeValue(×tamp_ms)؛ /* سرگرمي جي سڃاڻپ الگورتھم اپڊيٽ */ MotionAR_Update(data_in, data_out, timestamp_ms)؛ }

الگورتھم ڪارڪردگي

سرگرمي جي سڃاڻپ وارو الگورٿم صرف ايڪليروميٽر مان ڊيٽا استعمال ڪري ٿو ۽ بجلي جي استعمال کي گھٽائڻ لاءِ گھٽ فريڪوئنسي (16 Hz) تي هلندو آهي.

ٽيبل 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 MHz تي			Cortex-M3 STM32L152RE 32 MHz تي
منٽ	سراسري	وڌ	منٽ	سراسري	وڌ
2	6	153	8	130	4883

ٽيبل 4. Cortex-M33 ۽ Cortex-M7: گذري ويل وقت (μs) الگورتھم 

Cortex-M33 STM32U575ZI-Q 160 MHz تي			Cortex-M7 STM32F767ZI 96 MHz تي
منٽ	سراسري	وڌ	منٽ	سراسري	وڌ
<1	2	74	5	9	145

Sampدرخواست

MotionAR مڊل ويئر آساني سان ٺاهي سگھجن ٿيون صارف ايپليڪيشنون ٺاهڻ لاءِ؛ جيئنample ايپليڪيشن ايپليڪيشن فولڊر ۾ مهيا ڪئي وئي آهي.
اهو ٺهيل آهي NUCLEO-F401RE، NUCLEO-L152RE يا NUCLEO-U575ZI-Q ڊولپمينٽ بورڊ تي هلائڻ لاءِ جيڪو X-NUCLEO-IKS01A3 يا X-NUCLEO-IKS4A1 توسيع بورڊ سان ڳنڍيل آهي.

اپليڪيشن حقيقي وقت ۾ ڪيل سرگرمين کي سڃاڻي ٿو. ڊيٽا کي GUI ذريعي ڏيکاري سگھجي ٿو. الورورٿم اسٽيشنري، هلڻ، تيز هلڻ، جاگنگ، سائيڪل سواري ۽ ڊرائيونگ سرگرمين کي سڃاڻي ٿو. حقيقي وقت ڊيٽا جي نگراني ڪرڻ لاء USB ڪيبل ڪنيڪشن جي ضرورت آهي. بورڊ پي سي ذريعي USB ڪنيڪشن ذريعي هلائي ٿو. هي استعمال ڪندڙ کي ڏيکاريل سرگرمي کي ظاهر ڪرڻ جي اجازت ڏئي ٿو، accelerometer ڊيٽا، وقت stamp ۽ آخرڪار ٻين سينسر ڊيٽا، حقيقي وقت ۾، MEMS-Studio GUI ايپليڪيشن استعمال ڪندي.

MEMS-اسٽوڊيو ايپليڪيشن

جيample ايپليڪيشن MEMS-Studio GUI ايپليڪيشن استعمال ڪري ٿي، جيڪا ڊائون لوڊ ڪري سگھجي ٿي www.st.com.

قدم 1. پڪ ڪريو ته ضروري ڊرائيور نصب ٿيل آهن ۽ مناسب توسيع بورڊ سان STM32 نيوڪليو بورڊ PC سان ڳنڍيل آهي.
قدم 2. مين ايپليڪيشن ونڊو کولڻ لاءِ MEMS-Studio ايپليڪيشن لانچ ڪريو.

جيڪڏهن هڪ STM32 Nucleo بورڊ سپورٽ ٿيل فرم ويئر سان پي سي سان ڳنڍيل آهي، اهو خودڪار طور تي مناسب COM بندرگاهن کي معلوم ڪيو ويو آهي. ھن پورٽ کي کولڻ لاءِ ڪنيڪٽ بٽڻ کي دٻايو.

شڪل 3. MEMS-اسٽوڊيو - ڪنيڪٽ 

قدم 3. جڏهن STM32 سان ڳنڍيل آهي نيوڪليو بورڊ سپورٽ ٿيل فرم ويئر سان لائبريري جي تشخيص ٽيب کوليو ويندو آهي.

شروع ڪرڻ ۽ بند ڪرڻ لاءِ ڊيٽا اسٽريمنگ کي ٽوگل ڪريو مناسب شروع / اسٽاپ بٽڻ کي ٻاهرين عمودي ٽول بار تي.
ڳنڍيل سينسر مان اچڻ واري ڊيٽا ٿي سگهي ٿي viewed اندرين عمودي ٽول بار تي ڊيٽا ٽيبل ٽيب کي چونڊيو.

شڪل 4. MEMS-اسٽوڊيو - لائبريري اڀياس - ڊيٽا ٽيبل 

شڪل 5. MEMS-اسٽوڊيو - لائبريري جي تشخيص - سرگرمي جي سڃاڻپ

قدم 5. منتخب ڪريو محفوظ ڪريو File ڊيٽا لاگنگ ڪنفيگريشن ونڊو کولڻ لاءِ اندروني عمودي ٽول بار تي ٽيب. چونڊيو جيڪو سينسر ۽ سرگرمي ڊيٽا کي محفوظ ڪرڻ لاء لاگ ان ڪريو file. توھان شروع ڪري سگھوٿا يا بچاءُ بند ڪري سگھوٿا لاڳاپيل شروع / اسٽاپ بٽڻ تي ڪلڪ ڪري.

شڪل 6. MEMS-اسٽوڊيو - لائبريري اڀياس - محفوظ ڪريو 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 موشن آر اوورview ۽ سيڪشن 2.2.5 الگورتھم ڪارڪردگي.
14-فيبروري-2019	4	تازه ٿيل شڪل 1. سينسر جي ورهاڱي exampلي، ٽيبل 3. گذري ويل وقت (µs) الگورتھم ۽ شڪل 3. STM32 نيوڪليو: LEDs، بٽڻ، جمپر. شامل ڪيو ويو X-NUCLEO-IKS01A3 توسيع بورڊ مطابقت جي معلومات.
20-مارچ-2019	5	اپڊيٽ ٿيل سيڪشن 2.2.2 Motion AR APIs، شڪل 3. MEMS-Studio – Connect، Figure 4. MEMS-Studio – Library Evaluation – Data Table, Figure 5. MEMS-Studio – Library Evaluation – Activity Recognition and Figure 6MEMS-Studio. - لائبريري جي تشخيص - محفوظ ڪريو File.
04-اپريل-2024	6	تازه ڪاري حصو تعارف, سيڪشن 2.1: MotionAR ختمview, سيڪشن 2.2.1: MotionAR لائبريري وضاحت, MotionAR APIs، سيڪشن 2.2.4: ڊيمو ڪوڊ, سيڪشن 2.2.5: الگورتھم ڪارڪردگي, سيڪشن 3: ايسampدرخواست ۽ سيڪشن 4: MEMS-اسٽوڊيو ايپليڪيشن.

اهم نوٽيس - غور سان پڙهو

STMicroelectronics NV ۽ ان جا ماتحت ادارا (“ST”) ST پروڊڪٽس ۽/يا هن دستاويز ۾ بغير اطلاع جي ڪنهن به وقت تبديليون، سڌارا، واڌايون، ترميمون ۽ سڌارا ڪرڻ جو حق محفوظ رکن ٿا. خريد ڪندڙن کي آرڊر ڏيڻ کان پهريان ST شين تي تازي لاڳاپيل معلومات حاصل ڪرڻ گهرجي. ايس ٽي پروڊڪٽس وڪرو ڪيا وڃن ٿا ايس ٽي جي شرطن ۽ وڪري جي شرطن جي مطابق آرڊر جي اقرار جي وقت تي.

خريدار مڪمل طور تي ST پروڊڪٽس جي چونڊ، چونڊ ۽ استعمال جا ذميوار آهن ۽ ST درخواست جي مدد يا خريد ڪندڙن جي پروڊڪٽس جي ڊيزائن لاءِ ڪا به ذميواري قبول نه ڪندو آهي.

ڪو به لائسنس، ظاهر يا تقاضا، ڪنهن به دانشورانه ملڪيت جو حق ST پاران ڏنل ناهي.

ايس ٽي پروڊڪٽس جو ريزيل شقن سان مختلف معلومات ھتي بيان ڪيل معلومات کان مختلف آھي ايس ٽي پاران ڏنل ڪنھن به وارنٽي کي رد ڪندي اھڙي پراڊڪٽ لاءِ.

ST ۽ ST لوگو ST جا ٽريڊ مارڪ آھن. ST ٽريڊ مارڪ بابت اضافي معلومات لاءِ، ڏسو www.st.com/trademarks. ٻيا سڀئي پراڊڪٽ يا خدمت جا نالا انهن جي لاڳاپيل مالڪن جي ملڪيت آهن.

هن دستاويز ۾ معلومات هن دستاويز جي ڪنهن به اڳوڻي نسخن ۾ اڳ ۾ فراهم ڪيل معلومات کي ختم ڪري ٿو ۽ تبديل ڪري ٿو.

© 2024 STMicroelectronics – سڀ حق محفوظ آهن

دستاويز / وسيلا

STMicroelectronics UM2193 MotionAR سرگرمي سڃاڻڻ واري لائبريري [pdf] استعمال ڪندڙ دستياب UM2193 MotionAR سرگرمي سڃاڻڻ واري لائبريري، UM2193، MotionAR سرگرمي سڃاڻڻ واري لائبريري، سرگرمي جي سڃاڻپ لائبريري، سڃاڻپ لائبريري، لائبريري

حوالو

• استعمال ڪندڙ دستي