STMicroelectronics UM2193 MotionAR ॲक्टिव्हिटी रेकग्निशन लायब्ररी
परिचय
मोशन एआर हा X-CUBE-MEMS1 सॉफ्टवेअरचा मिडलवेअर लायब्ररी भाग आहे आणि STM32 वर चालतो. हे वापरकर्त्याद्वारे केलेल्या क्रियाकलापांच्या प्रकारावर रिअल-टाइम माहिती प्रदान करते. हे खालील क्रियाकलापांमध्ये फरक करण्यास सक्षम आहे: स्थिर, चालणे, जलद चालणे, जॉगिंग, बाइक चालवणे, वाहन चालवणे.
हे लायब्ररी फक्त ST MEMS सोबत काम करण्याच्या उद्देशाने आहे.
अल्गोरिदम स्टॅटिक लायब्ररी फॉरमॅटमध्ये प्रदान केले आहे आणि ARM® Cortex®-M32, ARM® Cortex®-M3, ARM® Cortex®-M33 किंवा ARM® Cortex®-M4 आर्किटेक्चरवर आधारित STM7 मायक्रोकंट्रोलरवर वापरण्यासाठी डिझाइन केले आहे.
हे STM32Cube सॉफ्टवेअर तंत्रज्ञानाच्या वर तयार केले आहे जे विविध STM32 मायक्रोकंट्रोलरवर पोर्टेबिलिटी सुलभ करते.
सॉफ्टवेअर s सह येतोampNUCLEO-F01RE, NUCLEO-L3RE किंवा NUCLEO-U4ZI-Q विकास मंडळावर X-NUCLEO-IKS1A401 किंवा X-NUCLEO-IKS152A575 विस्तार मंडळावर चालणारी अंमलबजावणी.
परिवर्णी शब्द आणि संक्षेप
तक्ता 1. परिवर्णी शब्दांची सूची
| परिवर्णी शब्द | वर्णन |
| API | अनुप्रयोग प्रोग्रामिंग इंटरफेस |
| बसपा | बोर्ड समर्थन पॅकेज |
| GUI | ग्राफिकल यूजर इंटरफेस |
| एचएएल | हार्डवेअर अॅब्स्ट्रॅक्शन लेयर |
| IDE | एकात्मिक विकास वातावरण |
X-CUBE-MEMS1 सॉफ्टवेअर विस्तारामध्ये मोशन एआर मिडलवेअर लायब्ररी
मोशन एआर संपलेview
मोशन एआर लायब्ररी 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 दस्तऐवजीकरण फोल्डरमध्ये स्थित आहे.
मोशन एआर लायब्ररीचे वर्णन
- मोशन एआर ॲक्टिव्हिटी रेकग्निशन लायब्ररी एक्सेलेरोमीटरवरून मिळवलेला डेटा व्यवस्थापित करते; त्याची वैशिष्ट्ये:
- खालील क्रियाकलापांमध्ये फरक करण्याची शक्यता: स्थिर, चालणे, जलद चालणे, जॉगिंग, बाइक चालवणे, वाहन चालवणे
- केवळ एक्सीलरोमीटर डेटावर आधारित ओळख
- आवश्यक प्रवेगमापक डेटा 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 API
MotionAR API आहेत:
- uint8_t MotionAR_GetLibVersion(char *आवृत्ती)
- लायब्ररीची आवृत्ती पुनर्प्राप्त करते
- *आवृत्ती 35 वर्णांच्या ॲरेसाठी पॉइंटर आहे
- आवृत्ती स्ट्रिंगमधील वर्णांची संख्या परत करते
- void MotionAR_Initialize(void)
- MotionAR लायब्ररी इनिशिएलायझेशन आणि अंतर्गत यंत्रणा सेटअप करते
- STM32 मायक्रोकंट्रोलरमधील सीआरसी मॉड्यूल (आरसीसी परिधीय घड्याळ सक्षम रजिस्टरमध्ये) असणे आवश्यक आहे
लायब्ररी वापरण्यापूर्वी सक्षम
टीप: एक्सीलरोमीटर कॅलिब्रेशन लायब्ररी वापरण्यापूर्वी हे फंक्शन कॉल करणे आवश्यक आहे.
- void MotionAR_Reset(void)
- क्रियाकलाप ओळख अल्गोरिदम रीसेट करते
- void MotionAR_Update(MAR_input_t *data_in, MAR_output_t *डेटा_आउट, int64_t
वेळamp)- क्रियाकलाप ओळख अल्गोरिदम कार्यान्वित करते
- *डेटा_इन पॅरामीटर हे इनपुट डेटासह संरचनेचे सूचक आहे
- MAR_input_t रचना प्रकारासाठी पॅरामीटर्स आहेत:
- acc_x हे एक्स अक्ष g मध्ये एक्सीलरोमीटर सेन्सर मूल्य आहे
- acc_y हे g मधील Y अक्षातील एक्सेलेरोमीटर सेन्सर मूल्य आहे
- acc_z हे g मधील Z अक्षातील एक्सीलरोमीटर सेन्सर मूल्य आहे
- *data_out पॅरामीटर खालील आयटमसह enum करण्यासाठी एक पॉइंटर आहे:
- MAR_NOACTIVITY = 0
- MAR_STATIONARY = 1
- MAR_WALKING = 2
- MAR_FASTWALKING = 3
- मार_जॉगिंग = ४
- MAR_BIKING = 5
- MAR_DRIVING = 6
- वेळamp वास्तविक s साठी सापेक्ष वेळ आहेampले एमएस मध्ये
- void MotionAR_ सेट ओरिएंटेशन_ Acc(const char *acc_ ओरिएंटेशन)
- एक्सीलरोमीटर डेटा अभिमुखता सेट करते
- कॉन्फिगरेशन सहसा Motion AR_ इनिशियल फंक्शन कॉल नंतर लगेच केले जाते
- *acc_ ओरिएंटेशन पॅरामीटर हा एक्स, y, z या क्रमाने एक्सीलरोमीटर डेटा आउटपुटसाठी वापरल्या जाणाऱ्या संदर्भ फ्रेमच्या प्रत्येक सकारात्मक अभिमुखतेची दिशा दर्शविणारा तीन वर्णांच्या स्ट्रिंगचा पॉइंटर आहे. वैध मूल्ये आहेत: n (उत्तर) किंवा s (दक्षिण), w (पश्चिम) किंवा e (पूर्व), u (वर) किंवा d (खाली)
- खालील आकृतीत दाखवल्याप्रमाणे, X-NUCLEO-IKS4A1 एक्सेलेरोमीटर सेन्सरमध्ये SEU (x-दक्षिण, y-पूर्व, z-अप) आहे, म्हणून स्ट्रिंग आहे: “seu”.
आकृती 1. सेन्सर अभिमुखता उदाample
API प्रवाह चार
आकृती 2. मोशन एआर 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 डेटा_ मध्ये; 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. अल्गोरिदम कामगिरी
| क्रियाकलाप | शोधण्याची संभाव्यता (सामान्य)(१) | सर्वोत्तम कामगिरी | संवेदनशील | पोझिशन्स घ्या |
| स्थिर | 92.27% | हातात धरून जड मजकूर पाठवणे | सर्व: ट्राउजर पॉकेट, शर्ट पॉकेट, मागचा खिसा, डोक्याजवळ इ. | |
| चालणे | 99.44% | चरण दर ≥ 1.4 चरण/से | चरण दर ≤ 1.2 चरण/से | सर्व |
| जलद चालणे | 95.94% | चरण दर ≥ 2.0 चरण/से | सर्व | |
| जॉगिंग | 98.49% | चरण दर ≥ 2.2 चरण/से | कालावधी < 1 मिनिट; वेग < 8 किमी/ता | पायघोळ खिसा, आर्म स्विंग, हातात |
| दुचाकी चालवणे | 91.93% | बाहेरचा वेग ≥11 किमी/ता | पॅसेंजर सीट, ग्लोव्ह कंपार्टमेंट | बॅकपॅक, शर्टचा खिसा, पँटचा खिसा |
| ड्रायव्हिंग | 78.65% | वेग ≥ 48 किमी/ता | पॅसेंजर सीट, ग्लोव्ह कंपार्टमेंट | कप होल्डर, डॅश बोर्ड, शर्ट पॉकेट, ट्राउजर पॉकेट |
- ठराविक वैशिष्ट्यांची हमी दिली जात नाही
तक्ता 3. कॉर्टेक्स-एम4 आणि कॉर्टेक्स-एम3: निघून गेलेला वेळ (µs) अल्गोरिदम
| कॉर्टेक्स-M4 STM32F401RE 84 MHz वर | Cortex-M3 STM32L152RE 32 MHz वर | ||||
| मि | सरासरी | कमाल | मि | सरासरी | कमाल |
| 2 | 6 | 153 | 8 | 130 | 4883 |
तक्ता 4. कॉर्टेक्स-एम33 आणि कॉर्टेक्स-एम7: निघून गेलेला वेळ (μs) अल्गोरिदम
| Cortex-M33 STM32U575ZI-Q 160 MHz वर | Cortex-M7 STM32F767ZI 96 MHz वर | ||||
| मि | सरासरी | कमाल | मि | सरासरी | कमाल |
| < १.२ | 2 | 74 | 5 | 9 | 145 |
Sample अर्ज
वापरकर्ता अनुप्रयोग तयार करण्यासाठी MotionAR मिडलवेअर सहजपणे हाताळले जाऊ शकते; म्हणूनample ऍप्लिकेशन ऍप्लिकेशन फोल्डरमध्ये प्रदान केले आहे.
हे X-NUCLEO-IKS401A152 किंवा X-NUCLEO-IKS575A01 विस्तार मंडळाशी जोडलेल्या NUCLEO-F3RE, NUCLEO-L4RE किंवा NUCLEO-U1ZI-Q विकास मंडळावर चालण्यासाठी डिझाइन केलेले आहे.
अनुप्रयोग रिअल-टाइममध्ये केलेल्या क्रियाकलापांना ओळखतो. डेटा GUI द्वारे प्रदर्शित केला जाऊ शकतो. अल्गोरिदम स्थिर, चालणे, जलद चालणे, जॉगिंग, बाईक चालवणे आणि ड्रायव्हिंग क्रियाकलाप ओळखतो. रिअल-टाइम डेटाचे निरीक्षण करण्यासाठी USB केबल कनेक्शन आवश्यक आहे. बोर्ड यूएसबी कनेक्शनद्वारे पीसीद्वारे समर्थित आहे. हे वापरकर्त्याला आढळलेली क्रियाकलाप, एक्सेलेरोमीटर डेटा, वेळ st प्रदर्शित करण्यास अनुमती देतेamp आणि अखेरीस इतर सेन्सर डेटा, रिअल-टाइममध्ये, MEMS-Studio GUI अनुप्रयोग वापरून.
एमईएमएस-स्टुडिओ अनुप्रयोग
एसample ऍप्लिकेशन MEMS-Studio GUI ऍप्लिकेशन वापरते, जे येथून डाउनलोड केले जाऊ शकते www.st.com.
पायरी 1. आवश्यक ड्रायव्हर्स स्थापित केले आहेत याची खात्री करा आणि योग्य विस्तार बोर्डसह STM32 न्यूक्लिओ बोर्ड पीसीशी जोडला गेला आहे.
पायरी 2. मुख्य ऍप्लिकेशन विंडो उघडण्यासाठी MEMS-Studio ऍप्लिकेशन लाँच करा.
समर्थित फर्मवेअरसह STM32 न्यूक्लिओ बोर्ड पीसीशी कनेक्ट केलेले असल्यास, ते योग्य COM पोर्ट स्वयंचलितपणे शोधले जाते. हे पोर्ट उघडण्यासाठी कनेक्ट बटण दाबा.
आकृती 3. MEMS-स्टुडिओ – कनेक्ट करा
पायरी 3. समर्थित फर्मवेअरसह STM32 Nucleo बोर्डशी कनेक्ट केल्यावर लायब्ररी मूल्यांकन टॅब उघडला जातो.
डेटा प्रवाह सुरू करण्यासाठी आणि थांबविण्यासाठी योग्य टॉगल करा 
प्रारंभ / 
बाहेरील उभ्या टूलबारवरील स्टॉप बटण.
कनेक्टेड सेन्सरमधून येणारा डेटा असू शकतो viewed अंतर्गत उभ्या टूलबारवरील डेटा टेबल टॅब निवडणे.
आकृती 4. MEMS-स्टुडिओ – लायब्ररी मूल्यांकन – डेटा सारणी
आकृती 5. एमईएमएस-स्टुडिओ - लायब्ररी मूल्यांकन - क्रियाकलाप ओळख
पायरी 5. सेव्ह टू निवडा File डेटा लॉगिंग कॉन्फिगरेशन विंडो उघडण्यासाठी आतील उभ्या टूलबारवरील टॅब. लॉग करण्यासाठी कोणता सेन्सर आणि क्रियाकलाप डेटा जतन करायचा ते निवडा file. तुम्ही संबंधित स्टार्ट/स्टॉप बटणावर क्लिक करून बचत सुरू करू शकता किंवा थांबवू शकता.
आकृती 6. MEMS-स्टुडिओ – लायब्ररी मूल्यांकन – यामध्ये जतन करा File
संदर्भ
खालील सर्व संसाधने विनामूल्य उपलब्ध आहेत www.st.com.
- UM1859: X-CUBE-MEMS1 मोशन MEMS आणि STM32Cube साठी पर्यावरणीय सेन्सर सॉफ्टवेअर विस्तारासह प्रारंभ करणे
- UM1724: STM32 Nucleo-64 बोर्ड (MB1136)
- UM3233: MEMS-Studio सह प्रारंभ करणे
पुनरावृत्ती इतिहास
तक्ता 5. दस्तऐवज पुनरावृत्ती इतिहास
| तारीख | आवृत्ती | बदल |
| 10-एप्रिल-2017 | 1 | प्रारंभिक प्रकाशन. |
| 26-जानेवारी-2018 | 2 | अद्यतनित विभाग 3 एसample अर्ज. NUCLEO-L152RE डेव्हलपमेंट बोर्ड आणि तक्ता 3 मध्ये संदर्भ जोडले गेले. वेळ (μs) अल्गोरिदम. |
| 19-मार्च-2018 | 3 | अद्यतनित परिचय, विभाग 2.1 मोशन एआर ओव्हरview आणि विभाग 2.2.5 अल्गोरिदम कार्यप्रदर्शन. |
| 14-फेब्रु-2019 | 4 | अद्यतनित आकृती 1. सेन्सर अभिमुखता उदाample, तक्ता 3. निघून गेलेला वेळ (µs) अल्गोरिदम आणि आकृती 3. STM32 Nucleo: LEDs, बटन, जंपर. X-NUCLEO-IKS01A3 विस्तार बोर्ड सुसंगतता माहिती जोडली. |
| 20-मार्च-2019 | 5 | अद्यतनित विभाग 2.2.2 Motion AR API, आकृती 3. MEMS-Studio – कनेक्ट करा, आकृती 4. MEMS-स्टुडिओ – लायब्ररी मूल्यमापन – डेटा सारणी, आकृती 5. MEMS-स्टुडिओ – लायब्ररी मूल्यमापन – क्रियाकलाप ओळख आणि आकृती-6. – लायब्ररी मूल्यांकन – यामध्ये जतन करा File. |
| 04-एप्रिल-2024 | 6 | अपडेट करा विभाग परिचय, विभाग 2.1: MotionAR ओव्हरview, विभाग 2.2.1: MotionAR लायब्ररी वर्णन, MotionAR API, विभाग 2.2.4: डेमो कोड, विभाग 2.2.5: अल्गोरिदम कामगिरी, कलम 3: एसample अर्ज आणि विभाग 4: MEMS-स्टुडिओ अनुप्रयोग. |
महत्वाची सूचना – काळजीपूर्वक वाचा
STMicroelectronics NV आणि त्याच्या उपकंपन्या (“ST”) ST उत्पादनांमध्ये आणि/किंवा या दस्तऐवजात कोणत्याही वेळी सूचना न देता बदल, सुधारणा, सुधारणा, सुधारणा आणि सुधारणा करण्याचा अधिकार राखून ठेवतात. खरेदीदारांनी ऑर्डर देण्यापूर्वी एसटी उत्पादनांची नवीनतम माहिती मिळवावी. ऑर्डर पावतीच्या वेळी एसटी उत्पादनांची विक्री एसटीच्या अटी आणि नियमांनुसार केली जाते.
एसटी उत्पादनांची निवड, निवड आणि वापर यासाठी खरेदीदार पूर्णपणे जबाबदार आहेत आणि एसटी अर्ज सहाय्यासाठी किंवा खरेदीदारांच्या उत्पादनांच्या डिझाइनसाठी कोणतेही दायित्व गृहीत धरत नाही.
कोणताही बौद्धिक संपदा अधिकाराचा कोणताही परवाना, व्यक्त किंवा निहित, येथे एसटीकडून मंजूर नाही.
येथे नमूद केलेल्या माहितीपेक्षा वेगळ्या तरतुदींसह एसटी उत्पादनांची पुनर्विक्री अशा उत्पादनासाठी एसटीने दिलेली कोणतीही हमी रद्द करेल.
एसटी आणि एसटी लोगो हे एसटीचे ट्रेडमार्क आहेत. एसटी ट्रेडमार्कबद्दल अतिरिक्त माहितीसाठी, पहा www.st.com/trademarks. इतर सर्व उत्पादन किंवा सेवा नावे त्यांच्या संबंधित मालकांची मालमत्ता आहेत.
या दस्तऐवजातील माहिती या दस्तऐवजाच्या कोणत्याही आधीच्या आवृत्त्यांमध्ये पूर्वी पुरवलेल्या माहितीची जागा घेते आणि पुनर्स्थित करते.
© 2024 STMicroelectronics – सर्व हक्क राखीव
कागदपत्रे / संसाधने
 |
STMicroelectronics UM2193 MotionAR ॲक्टिव्हिटी रेकग्निशन लायब्ररी [pdf] वापरकर्ता मॅन्युअल UM2193 MotionAR क्रियाकलाप ओळख लायब्ररी, UM2193, MotionAR क्रियाकलाप ओळख लायब्ररी, क्रियाकलाप ओळख लायब्ररी, ओळख लायब्ररी, लायब्ररी |
