UM2275
صارف دستی

STM1Cube کے لیے X-CUBE-MEMS32 توسیع میں MotionFD ریئل ٹائم فال ڈٹیکشن لائبریری کے ساتھ شروعات کرنا

تعارف

MotionEC X-CUBE-MEMS1 سافٹ ویئر کا ایک مڈل ویئر لائبریری جزو ہے اور STM3z2 پر چلتا ہے۔ یہ آلے کے ڈیٹا کی بنیاد پر ڈیوائس کی واقفیت اور نقل و حرکت کی حالت کے بارے میں اصل وقت کی معلومات فراہم کرتا ہے۔
یہ مندرجہ ذیل نتائج فراہم کرتا ہے: ڈیوائس کی واقفیت (quaternions، Euler angles)، ڈیوائس کی گردش (ورچوئل گائروسکوپ کی فعالیت)، کشش ثقل ویکٹر اور لکیری سرعت۔
اس لائبریری کا مقصد صرف ST MEMS کے ساتھ کام کرنا ہے۔
الگورتھم جامد لائبریری کی شکل میں فراہم کیا گیا ہے اور اسے ARM® Cortex®-M32+، ARM® Cortex®-M0، ARM® Cortex®-M3، ARM® Cortex®-M33 اور ARM® کی بنیاد پر STM4 مائکرو کنٹرولرز پر استعمال کرنے کے لیے ڈیزائن کیا گیا ہے۔ Cortex®-M7 فن تعمیرات۔
یہ STM32Cube سافٹ ویئر ٹیکنالوجی کے اوپر بنایا گیا ہے تاکہ مختلف STM32 مائیکرو کنٹرولرز میں پورٹیبلٹی کو آسان بنایا جا سکے۔
سافٹ ویئر s کے ساتھ آتا ہے۔ampNUCLEO-F4RE، NUCLEO-U1ZI-Q یا NUCLEO-L01RE ترقیاتی بورڈ پر X-NUCLEO-IKS3A401 یا X-NUCLEO-IKS575A152 توسیعی بورڈ پر عمل درآمد۔

مخففات اور مخففات

جدول 1۔ مخففات کی فہرست

مخفف	تفصیل
API	ایپلیکیشن پروگرامنگ انٹرفیس
بی ایس پی	بورڈ سپورٹ پیکیج
GUI	گرافیکل یوزر انٹرفیس
ایچ اے ایل	ہارڈ ویئر تجریدی پرت
IDE	انٹیگریٹڈ ترقیاتی ماحول

STM1Cube کے لیے X-CUBE-MEMS32 سافٹ ویئر کی توسیع میں MotionFD مڈل ویئر لائبریری

2.1 MotionFD ختمview
MotionFD لائبریری X-CUBE-MEMS1 سافٹ ویئر کی فعالیت کو بڑھاتی ہے۔
لائبریری ایکسلرومیٹر اور پریشر سینسر سے ڈیٹا حاصل کرتی ہے اور ڈیوائس کے ڈیٹا کی بنیاد پر صارف کے زوال کے واقعے کے بارے میں معلومات فراہم کرتی ہے۔
لائبریری صرف ST MEMS کے لیے ڈیزائن کی گئی ہے۔ دیگر MEMS سینسر استعمال کرتے وقت فعالیت اور کارکردگی کا تجزیہ نہیں کیا جاتا ہے اور دستاویز میں بیان کردہ چیزوں سے نمایاں طور پر مختلف ہو سکتے ہیں۔
Sample نفاذ X-NUCLEO-IKS4A1 اور X-NUCLEO-IKS01A3 توسیعی بورڈ کے لیے دستیاب ہے، جو NUCLEO-F401RE، NUCLEO-U575ZI-Q یا NUCLEO-L152RE ترقیاتی بورڈ پر نصب ہے۔
2.2 MotionFD لائبریری
MotionFD APIs کے افعال اور پیرامیٹرز کو مکمل طور پر بیان کرنے والی تکنیکی معلومات MotionFD_Package.chm مرتب کردہ HTML میں مل سکتی ہیں۔ file دستاویزی فولڈر میں واقع ہے۔
2.2.1 MotionFD لائبریری کی تفصیل
MotionFD زوال کا پتہ لگانے والی لائبریری ایکسلرومیٹر اور پریشر سینسر سے حاصل کردہ ڈیٹا کا انتظام کرتی ہے۔ اس کی خصوصیات:

• صارف زوال واقع ہوئی ہے یا نہیں تمیز کرنے کا امکان
• شناخت صرف ایکسلرومیٹر اور پریشر سینسر کے ڈیٹا پر مبنی ہے۔
• مطلوبہ ایکسلرومیٹر اور پریشر سینسر ڈیٹاampلنگ فریکوئنسی 25 ہرٹج ہے۔
• وسائل کی ضروریات:
  Cortex-M3: 3.6 kB کوڈ اور 3.2 kB ڈیٹا میموری
  Cortex-M33: 3.4 kB کوڈ اور 3.2 kB ڈیٹا میموری
  Cortex-M4: 3.4 kB کوڈ اور 3.2 kB ڈیٹا میموری
  Cortex-M7: 3.4 kB کوڈ اور 3.2 ڈیٹا میموری
• ARM Cortex-M3، ARM Cortex-M33، ARM Cortex-M4 اور ARM Cortex-M7 فن تعمیر کے لیے دستیاب ہے۔

2.2.2 MotionFD APIs
MotionFD لائبریری APIs ہیں:

• uint8_t MotionFD_GetLibVersion(char *ورژن)
  - لائبریری ورژن بازیافت کرتا ہے۔
  - *ورژن 35 حروف کی صف کی طرف اشارہ کرتا ہے۔
  - ورژن سٹرنگ میں حروف کی تعداد لوٹاتا ہے۔
• void MotionFD_Initialize(void)
  - MotionFD لائبریری کی شروعات اور اندرونی میکانزم کا سیٹ اپ انجام دیتا ہے۔

نوٹ: اس فنکشن کو فال ڈٹیکشن لائبریری کو استعمال کرنے سے پہلے کال کرنا ضروری ہے اور STM32 مائیکرو کنٹرولر میں CRC ماڈیول (RCC پیری فیرل کلاک ایبل رجسٹر میں) کو فعال کرنا ہوگا۔

• void MotionFD_update (MFD_input_t *data_in, MFD_output_t *ڈیٹا_آؤٹ)
  - زوال کا پتہ لگانے کے الگورتھم کو انجام دیتا ہے۔
  - *data_in پیرامیٹر ان پٹ ڈیٹا والے ڈھانچے کی طرف اشارہ کرتا ہے۔
  - ساخت کی قسم MFD_input_t کے پیرامیٹرز ہیں:
  ◦ AccX ایم جی میں ایکس محور میں ایکسلرومیٹر سینسر کی قدر ہے۔
  ◦ AccY mg میں Y محور میں ایکسلرومیٹر سینسر کی قدر ہے۔
  ◦ AccZ ایم جی میں Z محور میں ایکسلرومیٹر سینسر کی قدر ہے۔
  ◦ پریس hPa میں پریشر سینسر کی قدر ہے۔
  - *data_out پیرامیٹر درج ذیل آئٹمز کے ساتھ ایک اینوم کی طرف اشارہ کرتا ہے۔
  ◦ MFD_NOFALL = 0
  ◦ MFD_FALL = 1
• void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
  - لائبریری کنفیگریشن کے پیرامیٹرز سیٹ کرتا ہے۔
  - فال_تھریشولڈ ایکسلریشن تھریشولڈ ملی گرام میں
  - زوال_اونچائی_ڈیلٹا سینٹی میٹر میں اونچائی کا فرق
  - اثر کے بعد حرکت کے بغیر سیکنڈوں میں جھوٹ بولنے کا وقت
• void MotionFD_GetKnobs (float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
  - لائبریری کنفیگریشن کے پیرامیٹرز حاصل کرتے ہیں۔
  - فال_تھریشولڈ ایکسلریشن تھریشولڈ ملی گرام میں
  - زوال_اونچائی_ڈیلٹا سینٹی میٹر میں اونچائی کا فرق
  - اثر کے بعد حرکت کے بغیر سیکنڈوں میں جھوٹ بولنے کا وقت

2.2.3 API فلو چارٹ

2.2.4 ڈیمو کوڈ
درج ذیل ڈیموسٹریشن کوڈ ایکسلرومیٹر اور پریشر سینسر سے ڈیٹا پڑھتا ہے اور فال ایونٹ کوڈ حاصل کرتا ہے۔

2.2.5 الگورتھم کی کارکردگی
زوال کا پتہ لگانے والا الگورتھم صرف ایکسلرومیٹر اور پریشر سینسر کا ڈیٹا استعمال کرتا ہے اور بجلی کی کھپت کو کم کرنے کے لیے کم فریکوئنسی (25 ہرٹز) پر چلتا ہے۔

2.3 ایسampدرخواست
MotionFD مڈل ویئر کو صارف کی ایپلی کیشنز بنانے کے لیے آسانی سے جوڑ توڑ کیا جا سکتا ہے۔ کے طور پرample ایپلیکیشن ایپلی کیشن فولڈر میں فراہم کی گئی ہے۔
اسے NUCLEO-F401RE، NUCLEO-U575ZI-Q یا NUCLEO-L152RE ترقیاتی بورڈ پر چلانے کے لیے ڈیزائن کیا گیا ہے جو X-NUCLEO-IKS4A1 یا X-NUCLEO-IKS01A3 توسیعی بورڈ سے منسلک ہے۔
ایپلی کیشن صارف کے زوال کے واقعہ کو حقیقی وقت میں پہچانتی ہے۔

مندرجہ بالا اعداد و شمار صارف بٹن B1 اور NUCLEO-F401RE بورڈ کے تین ایل ای ڈی دکھاتا ہے۔ بورڈ کے چلنے کے بعد، LED LD3 (PWR) آن ہو جاتا ہے۔
ریئل ٹائم ڈیٹا کی نگرانی کے لیے USB کیبل کنکشن درکار ہے۔ بورڈ USB کنکشن کے ذریعے PC کے ذریعے چلتا ہے۔ یہ ورکنگ موڈ صارف کے زوال کے واقعات، ایکسلرومیٹر اور پریشر سینسر کے ڈیٹا، ٹائم سینٹ کی اجازت دیتا ہے۔amp اور آخر کار دیگر سینسر ڈیٹا، ریئل ٹائم میں، MEMS-Studio کا استعمال کرتے ہوئے۔
2.4 MEMS-Studio ایپلیکیشن
ایسample ایپلیکیشن MEMS-Studio ایپلی کیشن کا استعمال کرتی ہے، جس سے ڈاؤن لوڈ کیا جا سکتا ہے۔ www.st.com.
مرحلہ 1۔ یقینی بنائیں کہ ضروری ڈرائیور نصب ہیں اور مناسب توسیعی بورڈ کے ساتھ STM32 نیوکلیو بورڈ پی سی سے منسلک ہے۔
مرحلہ 2۔ مین ایپلیکیشن ونڈو کھولنے کے لیے MEMS-Studio ایپلیکیشن لانچ کریں۔
اگر سپورٹ شدہ فرم ویئر کے ساتھ ایک STM32 نیوکلیو بورڈ پی سی سے منسلک ہے، تو اس کا خود بخود پتہ چل جاتا ہے۔
ایویلیویشن بورڈ سے کنکشن قائم کرنے کے لیے [کنیکٹ] بٹن کو دبائیں۔

مرحلہ 3۔ معاون فرم ویئر کے ساتھ STM32 نیوکلیو بورڈ سے منسلک ہونے پر [لائبریری ایویلیوایشن] ٹیب کھل جاتا ہے۔
ڈیٹا سٹریمنگ شروع کرنے اور روکنے کے لیے، مناسب کو ٹوگل کریں [Start] یا [روکیں]   بیرونی عمودی ٹول بار پر بٹن۔
منسلک سینسر سے آنے والا ڈیٹا ہو سکتا ہے۔ viewاندرونی عمودی ٹول ba پر [ڈیٹا ٹیبل] ٹیب کو منتخب کرنا

مرحلہ 4۔ وقف شدہ ایپلیکیشن ونڈو کو کھولنے کے لیے [فال ڈیٹیکشن] پر کلک کریں۔

مرحلہ 5۔ [Save To پر کلک کریں۔ File] ڈیٹالاگنگ کنفیگریشن ونڈو کھولنے کے لیے۔ میں محفوظ کرنے کے لیے سینسر اور گرنے کا پتہ لگانے والے ڈیٹا کو منتخب کریں۔ file. آپ متعلقہ بٹن پر کلک کرکے بچت شروع یا روک سکتے ہیں۔

مرحلہ 6۔ ڈیٹا انجیکشن موڈ کا استعمال پہلے سے حاصل کردہ ڈیٹا کو لائبریری کو بھیجنے اور نتیجہ وصول کرنے کے لیے کیا جا سکتا ہے۔ وقف شدہ کو کھولنے کے لیے عمودی ٹول بار پر [ڈیٹا انجیکشن] ٹیب کو منتخب کریں۔ view اس فعالیت کے لیے۔

مرحلہ 7۔ کو منتخب کرنے کے لیے [براؤز] بٹن پر کلک کریں۔ file CSV فارمیٹ میں پہلے کیپچر کیے گئے ڈیٹا کے ساتھ۔
ڈیٹا کرنٹ میں ٹیبل میں لوڈ ہو جائے گا۔ view.
دوسرے بٹن فعال ہو جائیں گے۔ آپ کلک کر سکتے ہیں:
– فرم ویئر آف لائن موڈ کو آن/آف کرنے کے لیے [آف لائن موڈ] بٹن (پہلے کیپچر کیے گئے ڈیٹا کو استعمال کرنے والا موڈ)۔
– MEMS-Studio سے لائبریری تک ڈیٹا فیڈ کو کنٹرول کرنے کے لیے [Start]/[Stop]/[Step]/[دوہرائیں] بٹن۔

2.5 حوالہ جات
درج ذیل تمام وسائل www.st.com پر آزادانہ طور پر دستیاب ہیں۔

1. UM1859: X-CUBE-MEMS1 موشن MEMS اور STM32Cube کے لیے ماحولیاتی سینسر سافٹ ویئر کی توسیع کے ساتھ شروعات کرنا
2. UM1724: STM32 Nucleo-64 بورڈز (MB1136)
3. UM3233: MEMS-Studio کے ساتھ شروعات کرنا

نظرثانی کی تاریخ

جدول 4۔ دستاویز پر نظر ثانی کی تاریخ

تاریخ	ورژن	تبدیلیاں
22-ستمبر-2017	1	ابتدائی رہائی۔
6-فروری-18	2	NUCLEO-L152RE ڈویلپمنٹ بورڈ اور ٹیبل 2 کے حوالے شامل کیے گئے۔ گزرے ہوئے وقت (μs) الگورتھم۔
21-مارچ-18	3	اپ ڈیٹ شدہ تعارف اور سیکشن 2.1 MotionFD ختمview.
19-فروری-19	4	تازہ کاری شدہ جدول 2۔ گزرا ہوا وقت (μs) الگورتھم اور شکل 2۔ STM32 نیوکلیو: ایل ای ڈی، بٹن، جمپر۔ X-NUCLEO-IKS01A3 توسیعی بورڈ کی مطابقت کی معلومات شامل کی گئی۔
17-ستمبر-24	5	اپ ڈیٹ شدہ سیکشن کا تعارف، سیکشن 2.1: MotionFD ختمview, سیکشن 2.2.1: MotionFD لائبریری کی تفصیل، سیکشن 2.2.2: MotionFD APIs، سیکشن 2.2.5: الگورتھم کی کارکردگی، سیکشن 2.3: Sample درخواست، سیکشن 2.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 – جملہ حقوق محفوظ ہیں۔

دستاویزات / وسائل

ST X-CUBE-MEMS1 MotionFD ریئل ٹائم فال ڈیٹیکشن لائبریری [پی ڈی ایف] یوزر مینوئل X-CUBE-MEMS1 MotionFD ریئل ٹائم فال ڈیٹیکشن لائبریری، X-CUBE-MEMS1، MotionFD ریئل ٹائم فال ڈیٹیکشن لائبریری، ریئل ٹائم فال ڈیٹیکشن لائبریری، فال ڈیٹیکشن لائبریری، ڈیٹیکشن لائبریری، لائبریری

حوالہ جات

• صارف دستی