STMicroelectronics UM2193 MotionAR गतिविधि पहिचान पुस्तकालय

परिचय

Motion AR X-CUBE-MEMS1 सफ्टवेयरको मिडलवेयर लाइब्रेरी भाग हो र STM32 मा चल्छ। यो प्रयोगकर्ता द्वारा प्रदर्शन गतिविधि को प्रकार मा वास्तविक समय जानकारी प्रदान गर्दछ। यो निम्न गतिविधिहरू छुट्याउन सक्षम छ: स्थिर, हिड्ने, छिटो हिड्ने, टहल्ने, बाइकिङ, ड्राइभिङ।

यो पुस्तकालय ST MEMS सँग मात्र काम गर्ने उद्देश्यले हो।

एल्गोरिदम स्थिर पुस्तकालय ढाँचामा प्रदान गरिएको छ र ARM® Cortex®-M32, ARM® Cortex®-M3, ARM® Cortex®-M33 वा ARM® Cortex®-M4 वास्तुकलामा आधारित STM7 माइक्रोकन्ट्रोलरहरूमा प्रयोग गर्न डिजाइन गरिएको छ।

यो STM32Cube सफ्टवेयर टेक्नोलोजीको शीर्षमा बनाइएको छ जसले विभिन्न STM32 माइक्रोकन्ट्रोलरहरूमा पोर्टेबिलिटी सहज बनाउँछ।

सफ्टवेयर एस संग आउँछampNUCLEO-F01RE, NUCLEO-L3RE वा NUCLEO-U4ZI-Q विकास बोर्डमा X-NUCLEO-IKS1A401 वा X-NUCLEO-IKS152A575 विस्तार बोर्डमा चलिरहेको le कार्यान्वयन।

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

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

एक्रोनिम	विवरण
API	अनुप्रयोग प्रोग्रामिंग इन्टरफेस
बसपा	बोर्ड समर्थन प्याकेज
GUI	ग्राफिकल प्रयोगकर्ता इन्टरफेस
HAL	हार्डवेयर अमूर्त तह
IDE	एकीकृत विकास वातावरण

X-CUBE-MEMS1 सफ्टवेयर विस्तारमा Motion AR मिडलवेयर लाइब्रेरी

Motion 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 API को कार्य र मापदण्डहरू पूर्ण रूपमा वर्णन गर्ने प्राविधिक जानकारी पाउन सकिन्छ। file कागजात फोल्डर मा स्थित छ।

Motion AR पुस्तकालय विवरण

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

• uint8_t MotionAR_GetLibVersion(char *संस्करण)
  • पुस्तकालयको संस्करण पुन: प्राप्त गर्दछ
  • *संस्करण 35 वर्णहरूको एर्रेको लागि सूचक हो
  • संस्करण स्ट्रिङमा वर्णहरूको संख्या फर्काउँछ
• void MotionAR_Initialize(void)
  • MotionAR पुस्तकालय प्रारम्भ र आन्तरिक संयन्त्रको सेटअप कार्य गर्दछ
  • STM32 माइक्रोकन्ट्रोलरमा CRC मोड्युल (RCC परिधीय घडी सक्षम दर्तामा) हुनुपर्छ।
    पुस्तकालय प्रयोग गर्नु अघि सक्षम
    नोट: एक्सेलेरोमिटर क्यालिब्रेसन लाइब्रेरी प्रयोग गर्नु अघि यो प्रकार्यलाई कल गर्नुपर्छ।
• 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 g मा X अक्षमा एक्सेलेरोमीटर सेन्सर मान हो
    • acc_y g मा Y अक्षमा एक्सेलेरोमीटर सेन्सर मान हो
    • acc_z g मा Z अक्षमा एक्सेलेरोमिटर सेन्सर मान हो
  • *डेटा_आउट प्यारामिटर निम्न वस्तुहरूसँग enum गर्न सूचक हो:
    • MAR_NOACTIVITY = ०
    • MAR_STATIONARY = 1
    • MAR_WALKING = 2
    • MAR_FASTWALKING = 3
    • MAR_JOGGING = 4
    • MAR_BIKING = 5
    • MAR_DRIVING = 6
  • टाइमस्टamp वास्तविक s को लागि एक सापेक्ष समय होampले एमएस मा
• void MotionAR_ Set Orientation_ Acc (const char *acc_ अभिविन्यास)
  • एक्सेलेरोमीटर डेटा अभिमुखीकरण सेट गर्दछ
  • कन्फिगरेसन सामान्यतया Motion AR_ Initialize प्रकार्य कल पछि तुरुन्तै गरिन्छ
  • *acc_ अभिमुखीकरण प्यारामिटर एक्सेलेरोमिटर डेटा आउटपुटको लागि प्रयोग गरिएको सन्दर्भ फ्रेमको प्रत्येक सकारात्मक अभिमुखीकरणको दिशा संकेत गर्ने तीन क्यारेक्टरहरूको स्ट्रिङको सूचक हो, अनुक्रम x, y, z मा। मान्य मानहरू हुन्: n (उत्तर) वा s (दक्षिण), w (पश्चिम) वा e (पूर्व), u (माथि) वा d (डाउन)
  • तलको चित्रमा देखाइए अनुसार, X-NUCLEO-IKS4A1 एक्सेलेरोमिटर सेन्सरमा SEU (x-दक्षिण, y-पूर्व, z-अप) छ, त्यसैले स्ट्रिङ हो: "seu"।

चित्र १. सेन्सर अभिमुखीकरण पूर्वample

API प्रवाह char

चित्र 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); /* एक्सेलेरोमीटर अभिमुखीकरण सेट गर्नुहोस् */ MotionAR_SetOrientation_Acc(acc_orientation); [...] /*** गतिविधि पहिचान एल्गोरिदम प्रयोग गर्दै ***/ टाइमर_ वा_ डाटा दर_ अवरोध_ ह्यान्डलर () {

MAR_input_t data_ in; 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_सुश्री); /* गतिविधि पहिचान एल्गोरिदम अपडेट */ MotionAR_Update(data_in, data_out, timestamp_सुश्री); }

एल्गोरिदम प्रदर्शन

गतिविधि पहिचान एल्गोरिथ्मले एक्सेलेरोमिटरबाट मात्र डेटा प्रयोग गर्छ र कम फ्रिक्वेन्सी (१६ हर्ट्ज) मा पावर खपत घटाउँछ।

तालिका 2. एल्गोरिदम प्रदर्शन

गतिविधि	पत्ता लगाउने सम्भावना (सामान्य)(०३०३२५)	उत्कृष्ट प्रदर्शन	संवेदनशील	पदहरू बोक्नुहोस्
स्थिर	८६%		हातमा समातेर भारी टेक्स्टिङ	सबै: ट्राउजरको खल्ती, शर्टको खल्ती, पछाडिको खल्ती, टाउकोको नजिक, आदि।
हिँड्दै	८६%	चरण दर ≥ १.४ कदम/सेकेन्ड	चरण दर ≤ १.२ कदम/सेकेन्ड	सबै
छिटो हिड्ने	८६%	चरण दर ≥ १.४ कदम/सेकेन्ड		सबै
जोगिङ	८६%	चरण दर ≥ १.४ कदम/सेकेन्ड	अवधि <1 मिनेट; गति <8 किमी/घन्टा	ट्राउजरको खल्ती, आर्म स्विङ, हातमा
बाइकिङ	८६%	बाहिरी गति ≥11 किमी/घन्टा	यात्रु सीट, पन्जा डिब्बा	झोला, शर्टको खल्ती, ट्राउजरको खल्ती
ड्राइभिङ	८६%	गति ≥ ४८ किमी/घन्टा	यात्रु सीट, पन्जा डिब्बा	कप होल्डर, ड्यास बोर्ड, शर्टको खल्ती, ट्राउजरको खल्ती

1. सामान्य विशिष्टताहरू ग्यारेन्टी छैनन्

तालिका ३. Cortex-M3 र Cortex-M4: बितेको समय (µ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 जडान मार्फत पीसी द्वारा संचालित छ। यसले प्रयोगकर्तालाई पत्ता लगाइएको गतिविधि, एक्सेलेरोमिटर डेटा, समय st प्रदर्शन गर्न अनुमति दिन्छamp र अन्ततः अन्य सेन्सर डेटा, वास्तविक समयमा, MEMS-Studio GUI अनुप्रयोग प्रयोग गरेर।

MEMS-स्टुडियो आवेदन

एसample अनुप्रयोगले MEMS-Studio GUI अनुप्रयोग प्रयोग गर्दछ, जुन बाट डाउनलोड गर्न सकिन्छ www.st.com.

चरण 1। सुनिश्चित गर्नुहोस् कि आवश्यक ड्राइभरहरू स्थापित छन् र उपयुक्त विस्तार बोर्डको साथ STM32 Nucleo बोर्ड PC मा जडान गरिएको छ।
चरण 2। मुख्य एप्लिकेसन विन्डो खोल्नको लागि MEMS-Studio एप सुरु गर्नुहोस्।

यदि समर्थित फर्मवेयरको साथ एक STM32 Nucleo बोर्ड PC मा जडान गरिएको छ भने, यो स्वचालित रूपमा उपयुक्त COM पोर्ट पत्ता लगाइएको छ। यो पोर्ट खोल्नको लागि जडान बटन थिच्नुहोस्।

चित्र 3. MEMS-Studio - जडान गर्नुहोस् 

चरण 3। समर्थित फर्मवेयर लाइब्रेरी मूल्याङ्कन ट्याबको साथ STM32 Nucleo बोर्डमा जडान हुँदा खोलिएको छ।

डाटा स्ट्रिमिङ सुरु गर्न र रोक्न उपयुक्त टगल गर्नुहोस् सुरु / बाहिरी ठाडो उपकरण पट्टीमा रोक्नुहोस् बटन।
जडान गरिएको सेन्सरबाट आउने डाटा हुन सक्छ viewed भित्री ठाडो उपकरण पट्टीमा डाटा तालिका ट्याब चयन गर्दै।

चित्र 4. MEMS-स्टुडियो - पुस्तकालय मूल्याङ्कन - डाटा तालिका 

चित्र १। 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. कागजात संशोधन इतिहास

मिति	संस्करण	परिवर्तनहरू
०७-अप्रिल-२०२३	1	प्रारम्भिक रिलीज।
26-जनवरी-2018	2	खण्ड 3 S अद्यावधिक गरिएकोampआवेदन। NUCLEO-L152RE विकास बोर्ड र तालिका 3 मा सन्दर्भहरू थपियो। बितेको समय (μs) एल्गोरिदम।
19-मार्च-2018	3	अपडेट गरिएको परिचय, खण्ड २.१ मोशन एआर ओभरview र खण्ड 2.2.5 एल्गोरिदम प्रदर्शन।
०८-फेब्रुअरी-२०२४	4	अद्यावधिक गरिएको चित्र १। सेन्सर अभिमुखीकरण पूर्वample, तालिका 3. बितेको समय (µs) एल्गोरिदम र चित्र 3. STM32 Nucleo: LEDs, बटन, जम्पर। X-NUCLEO-IKS01A3 विस्तार बोर्ड अनुकूलता जानकारी थपियो।
20-मार्च-2019	5	अद्यावधिक गरिएको खण्ड 2.2.2 Motion AR APIs, चित्र 3. MEMS-Studio - जडान, चित्र 4. MEMS-Studio - पुस्तकालय मूल्याङ्कन - डेटा तालिका, चित्र 5. MEMS-स्टुडियो - पुस्तकालय मूल्याङ्कन - गतिविधि पहिचान र चित्र 6.MEMS-Studio। - पुस्तकालय मूल्याङ्कन - मा बचत गर्नुहोस् File.
०७-अप्रिल-२०२३	6	अपडेट गर्नुहोस् खण्ड परिचय, खण्ड २.१: MotionAR ओभरview, खण्ड २.२.१: MotionAR पुस्तकालय विवरण, MotionAR APIs, खण्ड २.२.४: डेमो कोड, खण्ड 2.2.5: एल्गोरिदम प्रदर्शन, खण्ड 3: एसampआवेदन र खण्ड 4: MEMS-स्टुडियो आवेदन.

महत्त्वपूर्ण सूचना - ध्यानपूर्वक पढ्नुहोस्

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 गतिविधि पहिचान पुस्तकालय, UM2193, MotionAR गतिविधि पहिचान पुस्तकालय, गतिविधि पहिचान पुस्तकालय, मान्यता पुस्तकालय, पुस्तकालय

सन्दर्भहरू

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