UM2275
प्रयोगकर्ता पुस्तिका

STM1Cube को लागि X-CUBE-MEMS32 विस्तारमा MotionFD वास्तविक-समय पतन पत्ता लगाउने पुस्तकालयको साथ सुरू गर्दै

परिचय

MotionEC X-CUBE-MEMS1 सफ्टवेयरको मिडलवेयर लाइब्रेरी कम्पोनेन्ट हो र STM3z2 मा चल्छ। यसले यन्त्रको डेटामा आधारित यन्त्र अभिविन्यास र आन्दोलन स्थिति बारे वास्तविक-समय जानकारी प्रदान गर्दछ।
यसले निम्न आउटपुटहरू प्रदान गर्दछ: उपकरण अभिमुखीकरण (क्वाटेरियनहरू, यूलर कोण), उपकरण रोटेशन (भर्चुअल जाइरोस्कोप कार्यक्षमता), गुरुत्वाकर्षण भेक्टर र रैखिक प्रवेग।
यो पुस्तकालय ST MEMS सँग मात्र काम गर्ने उद्देश्यले हो।
एल्गोरिदम स्थिर पुस्तकालय ढाँचामा प्रदान गरिएको छ र ARM® Cortex®-M32+, ARM® Cortex®-M0, ARM® Cortex®-M3, ARM® Cortex®-M33 र ARM® मा आधारित STM4 माइक्रोकन्ट्रोलरहरूमा प्रयोग गर्न डिजाइन गरिएको छ। Cortex®-M7 आर्किटेक्चर।
यो विभिन्न STM32 माइक्रोकन्ट्रोलरहरूमा पोर्टेबिलिटी सहज बनाउन STM32Cube सफ्टवेयर प्रविधिको शीर्षमा बनाइएको छ।
सफ्टवेयर एस संग आउँछampNUCLEO-F4RE, NUCLEO-U1ZI-Q वा NUCLEO-L01RE विकास बोर्डमा X-NUCLEO-IKS3A401 वा X-NUCLEO-IKS575A152 विस्तार बोर्डमा चलिरहेको le कार्यान्वयन।

एक्रोनिम र संक्षिप्त रूपहरू

तालिका १. संक्षिप्त शब्दहरूको सूची

एक्रोनिम	विवरण
API	अनुप्रयोग प्रोग्रामिंग इन्टरफेस
बसपा	बोर्ड समर्थन प्याकेज
GUI	ग्राफिकल प्रयोगकर्ता इन्टरफेस
HAL	हार्डवेयर अमूर्त तह
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 API को कार्य र मापदण्डहरू पूर्ण रूपमा वर्णन गर्ने प्राविधिक जानकारी MotionFD_Package.chm कम्पाइल गरिएको HTML मा पाउन सकिन्छ। file कागजात फोल्डर मा स्थित छ।
2.2.1 MotionFD पुस्तकालय विवरण
MotionFD पतन पत्ता लगाउने पुस्तकालयले एक्सेलेरोमिटर र प्रेसर सेन्सरबाट प्राप्त डाटा व्यवस्थापन गर्छ; यो विशेषताहरु:

• प्रयोगकर्ता पतन भयो वा भएन भनेर छुट्याउन सक्ने सम्भावना
• पहिचान मात्र accelerometer र दबाव सेन्सर डाटा मा आधारित
• आवश्यक एक्सेलेरोमिटर र प्रेसर सेन्सर डाटा sampलिंग आवृत्ति 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 पुस्तकालय API हरू हुन्:

• uint8_t MotionFD_GetLibVersion(char *संस्करण)
  - पुस्तकालय संस्करण पुन: प्राप्त
  - *संस्करण 35 वर्णहरूको एर्रेको लागि सूचक हो
  - संस्करण स्ट्रिङमा क्यारेक्टरहरूको संख्या फर्काउँछ
• void MotionFD_Initialize(void)
  - MotionFD लाइब्रेरी प्रारम्भ र आन्तरिक संयन्त्रको सेटअप कार्य गर्दछ

नोट: यो प्रकार्यलाई पतन पत्ता लगाउने पुस्तकालय प्रयोग गर्नु अघि कल गर्नुपर्छ र STM32 माइक्रोकन्ट्रोलरमा (RCC परिधीय घडी सक्षम दर्तामा) CRC मोड्युल सक्षम हुनुपर्छ।

• void MotionFD_Update (MFD_input_t *data_in, MFD_output_t *डेटा_आउट)
  - पतन पत्ता लगाउने एल्गोरिथ्म कार्यान्वयन गर्दछ
  - *data_in प्यारामिटर इनपुट डाटा भएको संरचनाको लागि सूचक हो
  - MFD_input_t संरचना प्रकारका लागि प्यारामिटरहरू हुन्:
  ◦ AccX mg मा X अक्षमा एक्सेलेरोमिटर सेन्सर मान हो
  ◦ AccY mg मा Y अक्षमा एक्सेलेरोमिटर सेन्सर मान हो
  ◦ AccZ mg मा Z अक्षमा एक्सेलेरोमिटर सेन्सर मान हो
  ◦ प्रेस hPa मा दबाब सेन्सर मान हो
  - *डेटा_आउट प्यारामिटर निम्न वस्तुहरू भएको एनमको लागि सूचक हो:
  ◦ MFD_NOFALL = ०
  ◦ MFD_FALL = 1
• void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
  - पुस्तकालय कन्फिगरेसन प्यारामिटरहरू सेट गर्दछ
  - मिलिग्राम मा fall_threshold एक्सेलेरेशन थ्रेसहोल्ड
  - fall_altitude_delta cm मा उचाई भिन्नता
  - प्रभाव पछि आन्दोलन बिना सेकेन्डमा समय समय झूटो
• void MotionFD_GetKnobs (float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
  - पुस्तकालय कन्फिगरेसन प्यारामिटरहरू प्राप्त गर्दछ
  - मिलिग्राम मा fall_threshold एक्सेलेरेशन थ्रेसहोल्ड
  - fall_altitude_delta cm मा उचाई भिन्नता
  - प्रभाव पछि आन्दोलन बिना सेकेन्डमा समय समय झूटो

2.2.3 API प्रवाह चार्ट

2.2.4 डेमो कोड
निम्न प्रदर्शन कोडले एक्सेलेरोमिटर र प्रेसर सेन्सरबाट डाटा पढ्छ र पतन घटना कोड प्राप्त गर्दछ।

2.2.5 एल्गोरिदम प्रदर्शन
पतन पत्ता लगाउने एल्गोरिदमले एक्सेलेरोमिटर र प्रेसर सेन्सरबाट मात्र डेटा प्रयोग गर्छ र कम फ्रिक्वेन्सी (२५ हर्ट्ज) मा पावर खपत कम गर्न चलाउँछ।

१० एसampआवेदन
MotionFD मिडलवेयर प्रयोगकर्ता अनुप्रयोगहरू निर्माण गर्न सजिलैसँग हेरफेर गर्न सकिन्छ; जस्तैample आवेदन एप्लिकेसन फोल्डरमा प्रदान गरिएको छ।
यो NUCLEO-F401RE, NUCLEO-U575ZI-Q वा NUCLEO-L152RE विकास बोर्डलाई X-NUCLEO-IKS4A1 वा X-NUCLEO-IKS01A3 विस्तार बोर्डमा जडान गर्न डिजाइन गरिएको छ।
अनुप्रयोगले वास्तविक समयमा प्रयोगकर्ता पतन घटना पहिचान गर्दछ।

माथिको चित्रले प्रयोगकर्ता बटन B1 र NUCLEO-F401RE बोर्डको तीन LED हरू देखाउँछ। बोर्ड पावर भएपछि, LED LD3 (PWR) सक्रिय हुन्छ।
वास्तविक-समय डाटा निगरानी गर्न USB केबल जडान आवश्यक छ। बोर्ड USB जडान मार्फत पीसी द्वारा संचालित छ। यो काम गर्ने मोडले पत्ता लगाइएको प्रयोगकर्ता पतन घटना, एक्सेलेरोमिटर र प्रेसर सेन्सर डेटा, समय st अनुमति दिन्छamp र अन्ततः अन्य सेन्सर डेटा, वास्तविक समयमा, MEMS-Studio प्रयोग गरेर।
2.4 MEMS-स्टुडियो आवेदन
एसample अनुप्रयोगले MEMS-Studio अनुप्रयोग प्रयोग गर्दछ, जुन बाट डाउनलोड गर्न सकिन्छ www.st.com.
चरण 1। सुनिश्चित गर्नुहोस् कि आवश्यक ड्राइभरहरू स्थापित छन् र उपयुक्त विस्तार बोर्डको साथ STM32 Nucleo बोर्ड PC मा जडान गरिएको छ।
चरण 2। मुख्य एप्लिकेसन विन्डो खोल्नको लागि MEMS-Studio एप सुरु गर्नुहोस्।
यदि समर्थित फर्मवेयरको साथ STM32 Nucleo बोर्ड PC मा जडान गरिएको छ भने, यो स्वचालित रूपमा पत्ता लगाइन्छ।
मूल्याङ्कन बोर्डमा जडान स्थापित गर्न [जडान] बटन थिच्नुहोस्।

चरण 3। समर्थित फर्मवेयर [पुस्तकालय मूल्याङ्कन] ट्याबको साथ STM32 Nucleo बोर्डमा जडान हुँदा खोलिएको छ।
डाटा स्ट्रिमिङ सुरु गर्न र रोक्न, उपयुक्त टगल गर्नुहोस् [सुरु गर्नुहोस्] वा [रोक्नुहोस्]   बाहिरी ठाडो उपकरण पट्टीमा बटन।
जडान गरिएको सेन्सरबाट आउने डाटा हुन सक्छ viewed भित्री ठाडो उपकरण ba मा [डेटा तालिका] ट्याब चयन गर्दै

चरण 4। समर्पित अनुप्रयोग विन्डो खोल्न [पतन पत्ता लगाउने] मा क्लिक गर्नुहोस्।

चरण 5। मा क्लिक गर्नुहोस् [मा बचत गर्नुहोस् File] डाटालगिङ कन्फिगरेसन विन्डो खोल्न। सेन्सर चयन गर्नुहोस् र सेन्सर पत्ता लगाउनुहोस् file। तपाईं सम्बन्धित बटनमा क्लिक गरेर बचत सुरु गर्न वा रोक्न सक्नुहुन्छ।

चरण 6। डेटा इंजेक्शन मोड पुस्तकालयमा पहिले प्राप्त डाटा पठाउन र परिणाम प्राप्त गर्न प्रयोग गर्न सकिन्छ। समर्पित खोल्न ठाडो उपकरण पट्टीमा [डेटा इंजेक्शन] ट्याब चयन गर्नुहोस् view यो कार्यक्षमता को लागी।

चरण 7। चयन गर्न [ब्राउज] बटनमा क्लिक गर्नुहोस् file CSV ढाँचामा पहिले कैद गरिएको डाटासँग।
डाटा हालको तालिकामा लोड हुनेछ view.
अन्य बटनहरू सक्रिय हुनेछन्। तपाईं क्लिक गर्न सक्नुहुन्छ:
- [अफलाइन मोड] बटन फर्मवेयर अफलाइन मोड अन/अफ गर्न (पहिले क्याप्चर गरिएको डाटा प्रयोग गर्ने मोड)।
- [स्टार्ट]/[रोक्नुहोस्]/[चरण]/[दोहोर्याउनुहोस्] बटनहरू MEMS-स्टुडियोबाट लाइब्रेरीमा डेटा फिड नियन्त्रण गर्न।

2.5 सन्दर्भहरू
तलका सबै स्रोतहरू www.st.com मा स्वतन्त्र रूपमा उपलब्ध छन्।

1. UM1859: X-CUBE-MEMS1 गति MEMS र STM32Cube को लागि वातावरणीय सेन्सर सफ्टवेयर विस्तारको साथ सुरु गर्दै
2. UM1724: STM32 Nucleo-64 बोर्डहरू (MB1136)
3. UM3233: MEMS-Studio को साथ सुरु गर्दै

संशोधन इतिहास

तालिका 4. कागजात संशोधन इतिहास

मिति	संस्करण	परिवर्तनहरू
६-सेप्टेम्बर-१८	1	प्रारम्भिक रिलीज।
०८-फेब्रुअरी-२०२४	2	NUCLEO-L152RE विकास बोर्ड र तालिका 2 मा सन्दर्भहरू थपियो। बितेको समय (μs) एल्गोरिदम।
21-मार्च-18	3	अपडेट गरिएको परिचय र खण्ड २.१ MotionFD ओभरview.
०८-फेब्रुअरी-२०२४	4	अपडेट गरिएको तालिका २. बितेको समय (μs) एल्गोरिदम र चित्र २. STM2 न्यूक्लियो: LEDs, बटन, जम्पर। X-NUCLEO-IKS01A3 विस्तार बोर्ड अनुकूलता जानकारी थपियो।
६-सेप्टेम्बर-१८	5	अपडेट गरिएको खण्ड परिचय, खण्ड २.१: MotionFD ओभरview, खण्ड 2.2.1: MotionFD पुस्तकालय विवरण, खण्ड 2.2.2: MotionFD APIs, खण्ड 2.2.5: एल्गोरिदम प्रदर्शन, खण्ड 2.3: Sample आवेदन, खण्ड 2.4: MEMS-स्टुडियो आवेदन

महत्त्वपूर्ण सूचना - ध्यानपूर्वक पढ्नुहोस्
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 वास्तविक समय पतन पत्ता लगाउने पुस्तकालय [pdf] प्रयोगकर्ता पुस्तिका X-CUBE-MEMS1 MotionFD वास्तविक समय पतन पत्ता लगाउने पुस्तकालय, X-CUBE-MEMS1, MotionFD वास्तविक समय पतन पत्ता लगाउने पुस्तकालय, वास्तविक समय पतन पत्ता लगाउने पुस्तकालय, पतन पत्ता लगाउने पुस्तकालय, पत्ता लगाउने पुस्तकालय, पुस्तकालय

सन्दर्भहरू

• प्रयोगकर्ता पुस्तिका