यूएम 2201
वापरकर्ता मॅन्युअल
NUCLEO-F401RE MotionGR रिअल टाइम जेश्चर रेकग्निशन लायब्ररी
STM1Cube साठी X-CUBEMEMS32 विस्तारामध्ये MotionGR रिअल-टाइम जेश्चर रेकग्निशन लायब्ररीसह सुरुवात करणे
परिचय
मोशनजीआर हा मिडलवेअर लायब्ररीचा भाग आहे X-CUBE-MEMS1 सॉफ्टवेअर आणि STM32 वर चालते. ते रिअल-टाइम माहिती प्रदान करते
वापरकर्त्याने मोबाईल फोनसारख्या उपकरणाद्वारे केलेल्या जेश्चरबद्दल.
ते खालील हावभावांमध्ये फरक करण्यास सक्षम आहे: उचलणे, पाहणे, जागे होणे.
हे लायब्ररी फक्त ST MEMS सोबत काम करण्याच्या उद्देशाने आहे.
हे अल्गोरिथम स्टॅटिक लायब्ररी फॉरमॅटमध्ये प्रदान केले आहे आणि ते ARM® Cortex® -M32, ARM® Cortex® -M3, ARM® Cortex® -M33 किंवा ARM® Cortex® -M4 आर्किटेक्चरवर आधारित STM7 मायक्रोकंट्रोलर्सवर वापरण्यासाठी डिझाइन केलेले आहे.
ते वर बांधले आहे STM32Cube वेगवेगळ्या STM32 मायक्रोकंट्रोलर्समध्ये पोर्टेबिलिटी सुलभ करणारी सॉफ्टवेअर तंत्रज्ञान.
सॉफ्टवेअर s सह येतोampअंमलबजावणी सुरू आहे X-NUCLEO-IKS4A1 or X-NUCLEO-IKS01A3 विस्तार बोर्ड वर NUCLEO-F401RE, NUCLEO-U575ZI-Q or NUCLEO-L152RE विकास मंडळ
परिवर्णी शब्द आणि संक्षेप
तक्ता 1. परिवर्णी शब्दांची सूची
| परिवर्णी शब्द | वर्णन |
| API | अनुप्रयोग प्रोग्रामिंग इंटरफेस |
| बसपा | बोर्ड समर्थन पॅकेज |
| GUI | ग्राफिकल यूजर इंटरफेस |
| एचएएल | हार्डवेअर अॅब्स्ट्रॅक्शन लेयर |
| IDE | एकात्मिक विकास वातावरण |
STM1Cube साठी X-CUBE-MEMS32 सॉफ्टवेअर विस्तारामध्ये MotionGR मिडलवेअर लायब्रे
२.१ मोशनजीआर ओव्हरview
मोशनजीआर लायब्ररी ची कार्यक्षमता वाढवते X-CUBE-MEMS1 सॉफ्टवेअर.
लायब्ररी अ‍ॅक्सिलरोमीटरवरून डेटा मिळवते आणि वापरकर्त्याने डिव्हाइस वापरून केलेल्या जेश्चरबद्दल माहिती प्रदान करते.
लायब्ररीची रचना फक्त ST MEMS साठी केली आहे. इतर MEMS सेन्सर वापरताना कार्यक्षमता आणि कार्यप्रदर्शनाचे विश्लेषण केले जात नाही आणि दस्तऐवजात वर्णन केलेल्या गोष्टींपेक्षा लक्षणीय भिन्न असू शकतात.
Sampअंमलबजावणी उपलब्ध आहे X-NUCLEO-IKS4A1 आणि X-NUCLEO-IKS01A3 विस्तार बोर्ड, वर बसवलेले NUCLEO-F401RE, NUCLEO-U575ZI-Q or NUCLEO-L152RE विकास मंडळ
२.२ मोशनजीआर लायब्ररी
MotionGR API ची कार्ये आणि पॅरामीटर्सचे पूर्णपणे वर्णन करणारी तांत्रिक माहिती MotionGR_Package.chm संकलित HTML मध्ये आढळू शकते. file दस्तऐवजीकरण फोल्डरमध्ये स्थित आहे.
२.२.१ मोशनजीआर लायब्ररीचे वर्णन
मोशनजीआर जेश्चर रेकग्निशन लायब्ररी अ‍ॅक्सिलरोमीटरमधून मिळवलेला डेटा व्यवस्थापित करते; त्यात खालील वैशिष्ट्ये आहेत:
- खालील क्रियाकलापांमध्ये फरक करण्याची शक्यता: उचलणे, पाहणे, जागे होणे
- केवळ अ‍ॅक्सिलरोमीटर डेटावर आधारित ओळख
- आवश्यक प्रवेगमापक डेटा sampलिंग वारंवारता 50 Hz आहे
- संसाधन आवश्यकता:
– कॉर्टेक्स-एम३: ३.६ kB कोड आणि ३.२ kB डेटा मेमरी
– कॉर्टेक्स-एम३: ३.६ kB कोड आणि ३.२ kB डेटा मेमरी
– कॉर्टेक्स-एम३: ३.६ kB कोड आणि ३.२ kB डेटा मेमरी
– कॉर्टेक्स-एम३: ३.६ kB कोड आणि ३.२ kB डेटा मेमरी - ARM® Cortex®-M3, ARM® Cortex® -M33, ARM® Cortex® -M4 आणि ARM® Cortex® -M7 आर्किटेक्चरसाठी उपलब्ध.
२.२.२ मोशनजीआर एपीआय
मोशनजीआर लायब्ररी एपीआय आहेत:
- uint8_t MotionGR_GetLibVersion(अक्षर *आवृत्ती)
- लायब्ररी आवृत्ती पुनर्प्राप्त करते
- *आवृत्ती 35 वर्णांच्या ॲरेसाठी पॉइंटर आहे
- आवृत्ती स्ट्रिंगमधील वर्णांची संख्या परत करते - void MotionGR_Initialize(void)
- मोशनजीआर लायब्ररी इनिशिएलायझेशन आणि अंतर्गत यंत्रणेचे सेटअप करते.
टीप: जेश्चर रेकग्निशन लायब्ररी वापरण्यापूर्वी हे फंक्शन कॉल करणे आवश्यक आहे आणि STM32 मायक्रोकंट्रोलरमधील (RCC पेरिफेरल क्लॉक इनॅबल रजिस्टरमध्ये) CRC मॉड्यूल सक्षम करणे आवश्यक आहे.
- व्हॉइड मोशनजीआर_अपडेट(एमजीआर_इनपुट_टी *डेटा_इन, एमजीआर_आउटपुट_टी *डेटा_आउट)
- जेश्चर ओळख अल्गोरिथम कार्यान्वित करते
- *data_in पॅरामीटर हे इनपुट डेटासह संरचनेचे सूचक आहे
– MGR_input_t या स्ट्रक्चर प्रकारासाठी पॅरामीटर्स आहेत:
◦ AccX हे g मध्ये X अक्षातील अ‍ॅक्सिलरोमीटर सेन्सर मूल्य आहे.
◦ AccY हे g मध्ये Y अक्षातील अ‍ॅक्सिलरोमीटर सेन्सर मूल्य आहे.
◦ AccZ हे g मध्ये Z अक्षातील अ‍ॅक्सिलरोमीटर सेन्सर मूल्य आहे.
- *डेटा_आउट पॅरामीटर खालील आयटमसह एनमसाठी एक पॉइंटर आहे:
◦ एमजीआर_नोगेस्ट्युर = ०
◦ एमजीआर_पिकअप = १
◦ एमजीआर_ग्लानस = २
◦ एमजीआर_वेकअप = ३ - रिक्त मोशनजीआर_सेटओरिएंटेशन_अ‍ॅक (कॉन्स्ट कॅर *अ‍ॅक_ओरिएंटेशन)
- हे फंक्शन अ‍ॅक्सिलरोमीटर डेटा ओरिएंटेशन सेट करण्यासाठी वापरले जाते.
- कॉन्फिगरेशन सहसा MotionGR_Initialize फंक्शन कॉल नंतर लगेच केले जाते.
– *acc_orientation पॅरामीटर हा तीन वर्णांच्या स्ट्रिंगचा पॉइंटर आहे जो एक्सेलेरोमीटर डेटा आउटपुटसाठी वापरल्या जाणाऱ्या संदर्भ फ्रेमच्या प्रत्येक सकारात्मक अभिमुखतेची दिशा दर्शवितो, x, y, z या क्रमाने. वैध मूल्ये आहेत: n (उत्तर) किंवा s (दक्षिण), w (पश्चिम) किंवा e (पूर्व), u (वर) किंवा d (खाली).
– खालील आकृतीत दाखवल्याप्रमाणे, X-NUCLEO-IKS4A1 अ‍ॅक्सिलरोमीटर सेन्सरमध्ये SEU (x – दक्षिण, y – पूर्व, z – वर) आहे, म्हणून स्ट्रिंग आहे: “seu”.
आकृती 1. उदाampसेन्सर अभिमुखतेचे नियम
2.2.3 API फ्लो चार्ट
आकृती २. मोशनजीआर एपीआय लॉजिक सीक्वेन्स
2.2.4 डेमो कोड
खालील प्रात्यक्षिक कोड अ‍ॅक्सिलरोमीटर सेन्सरमधील डेटा वाचतो आणि जेश्चर कोड मिळवतो.
2.2.5 अल्गोरिदम कामगिरी
जेश्चर रेकग्निशन अल्गोरिथम फक्त अ‍ॅक्सिलरोमीटरमधील डेटा वापरतो आणि वीज वापर कमी करण्यासाठी कमी फ्रिक्वेन्सीवर (५० हर्ट्झ) चालतो.
हे खालील वापरकर्त्याच्या जेश्चरची रिअल-टाइम माहिती शोधते आणि प्रदान करते:
- उचलणे: टेबलावरून बोर्ड उचलणे/उचलणे;
- नजर: बोर्डचे अंदाजे ३०° फिरवणे, फोन फिरवून त्यावर एक नजर टाकण्याच्या हावभावासारखेच;
- जागे व्हा: थरथरणारी क्रिया.
तक्ता २. अल्गोरिदम कालबाह्य वेळ (µs) कॉर्टेक्स-M2, कॉर्टेक्स-M4
| कॉर्टेक्स-M4 STM32F401RE 84 MHz वर | Cortex-M3 STM32L152RE 32 MHz वर | ||||
| मि | सरासरी | कमाल | मि | सरासरी | कमाल |
| 136 | 240 | 341 | 473 | 870 | 1235 |
तक्ता ३. अल्गोरिदम कालबाह्य वेळ (µs) कॉर्टेक्स-M3 आणि कॉर्टेक्स-M33
| १६० मेगाहर्ट्झवर कॉर्टेक्स- M33 STM32U575ZI-Q | कॉर्टेक्स- M7 STM32F767ZI 96 MHz वर | ||||
| मि | सरासरी | कमाल | मि | सरासरी | कमाल |
| 87 | 140 | 191 | 459 | 504 | 808 |
2.3 एसample अर्ज
वापरकर्ता अनुप्रयोग तयार करण्यासाठी मोशनजीआर मिडलवेअर सहजपणे हाताळता येते; जसे कीample ऍप्लिकेशन ऍप्लिकेशन फोल्डरमध्ये प्रदान केले आहे.
हे a वर चालण्यासाठी डिझाइन केलेले आहे NUCLEO-F401RE, NUCLEO-U575ZI-Q or NUCLEO-L152RE X-NUCLEO-IKS4A1 किंवा X-NUCLEO-IKS01A3 विस्तार बोर्डशी जोडलेले डेव्हलपमेंट बोर्ड.
हे अॅप्लिकेशन रिअल-टाइममध्ये केलेले जेश्चर ओळखते.
आकृती ३. STM3 न्यूक्लियो: LEDs, बटण, जंपर
वरील आकृती वापरकर्ता बटण B1 आणि NUCLEO-F401RE बोर्डचे तीन LEDs दाखवते. बोर्ड चालू झाल्यावर, LED LD3 (PWR) चालू होते.
रिअल-टाइम डेटाचे निरीक्षण करण्यासाठी USB केबल कनेक्शन आवश्यक आहे. बोर्ड USB कनेक्शनद्वारे PC द्वारे समर्थित आहे. हा कार्यरत मोड वापरकर्त्याला शोधलेला जेश्चर, एक्सेलेरोमीटर डेटा, वेळ st प्रदर्शित करण्यास अनुमती देतो.amp आणि अखेरीस इतर सेन्सर डेटा, रिअल-टाइममध्ये, वापरून एमईएमएस-स्टुडिओ.
२.४ एमईएमएस स्टुडिओ अॅप्लिकेशन
एसampअनुप्रयोगाचे उपयोग एमईएमएस-स्टुडिओ अनुप्रयोग, जो येथून डाउनलोड केला जाऊ शकतो www.st.com.
पायरी १. आवश्यक ड्रायव्हर्स स्थापित केले आहेत याची खात्री करा आणि STM32 Nucleo योग्य विस्तार बोर्ड असलेला बोर्ड पीसीशी जोडलेला असतो.
पायरी 2. लाँच करा एमईएमएस-स्टुडिओ मुख्य अनुप्रयोग विंडो उघडण्यासाठी अनुप्रयोग.
समर्थित फर्मवेअरसह STM32 Nucleo बोर्ड PC शी कनेक्ट केलेले असल्यास, ते आपोआप ओळखले जाते.
मूल्यांकन मंडळाशी कनेक्शन स्थापित करण्यासाठी [कनेक्ट] बटण दाबा.
आकृती 4. MEMS-स्टुडिओ – कनेक्ट करा
पायरी 3. समर्थित फर्मवेअरसह STM32 न्यूक्लिओ बोर्डशी कनेक्ट केल्यावर [लायब्ररी मूल्यांकन] टॅब उघडला जातो.
डेटा प्रवाह सुरू करण्यासाठी आणि थांबवण्यासाठी, योग्य टॉगल करा [प्रारंभ] 
किंवा [थांबा] 
बाहेरील उभ्या टूलबारवरील बटण.
कनेक्टेड सेन्सरमधून येणारा डेटा असू शकतो viewed अंतर्गत उभ्या टूलबारवरील [डेटा टेबल] टॅब निवडणे.
आकृती 5. MEMS-स्टुडिओ – लायब्ररी मूल्यांकन – डेटा सारणी
पायरी 4. समर्पित अॅप्लिकेशन विंडो उघडण्यासाठी [जेश्चर रिकग्निशन] वर क्लिक करा.
आकृती ६. एमईएमएस-स्टुडिओ - ग्रंथालय मूल्यांकन - जेश्चर ओळख
पायरी 5. [Save To वर क्लिक करा File] डेटालॉगिंग कॉन्फिगरेशन विंडो उघडण्यासाठी. सेव्ह करायचा सेन्सर आणि जेश्चर रेकग्निशन डेटा निवडा file. तुम्ही संबंधित बटणावर क्लिक करून बचत सुरू करू शकता किंवा थांबवू शकता.
आकृती ७. एमईएमएस-स्टुडिओ - ग्रंथालय मूल्यांकन - येथे जतन करा File
पायरी 6. डेटा इंजेक्शन मोडचा वापर पूर्वी मिळवलेला डेटा लायब्ररीला पाठवण्यासाठी आणि परिणाम प्राप्त करण्यासाठी केला जाऊ शकतो. समर्पित उघडण्यासाठी उभ्या टूलबारवरील [डेटा इंजेक्शन] टॅब निवडा view या कार्यक्षमतेसाठी.
आकृती ८. एमईएमएस-स्टुडिओ - ग्रंथालय मूल्यांकन - डेटा इंजेक्शन
पायरी 7. निवडण्यासाठी [ब्राउझ] बटणावर क्लिक करा file CSV फॉरमॅटमध्ये पूर्वी कॅप्चर केलेल्या डेटासह.
डेटा करंटमध्ये टेबलमध्ये लोड केला जाईल view.
इतर बटणे सक्रिय होतील. आपण यावर क्लिक करू शकता:
– फर्मवेअर ऑफलाइन मोड चालू/बंद करण्यासाठी [ऑफलाइन मोड] बटण (पूर्वी कॅप्चर केलेला डेटा वापरणारा मोड).
– MEMS-Studio वरून लायब्ररीमध्ये डेटा फीड नियंत्रित करण्यासाठी [प्रारंभ]/[थांबा]/[चरण]/[पुनरावृत्ती] बटणे.
संदर्भ
खालील सर्व संसाधने www.st.com वर विनामूल्य उपलब्ध आहेत.
- UM1859: X-CUBE-MEMS1 मोशन MEMS आणि STM32Cube साठी पर्यावरणीय सेन्सर सॉफ्टवेअर विस्तारासह प्रारंभ करणे
- UM1724: STM32 Nucleo-64 बोर्ड (MB1136)
- UM3233: MEMS-Studio सह प्रारंभ करणे
पुनरावृत्ती इतिहास
तक्ता 4. दस्तऐवज पुनरावृत्ती इतिहास
| तारीख | आवृत्ती | बदल |
| 06-जून-2017 | 1 | प्रारंभिक प्रकाशन. |
| 26-जानेवारी-2018 | 2 | NUCLEO-L152RE डेव्हलपमेंट बोर्ड आणि तक्ता 2 मध्ये संदर्भ जोडले गेले. वेळ (μs) अल्गोरिदम. |
| 20-मार्च-2018 | 3 | प्रस्तावना आणि विभाग २.१ अपडेट केला मोशनजीआर संपलाview. |
| 21-फेब्रु-2019 | 4 | अद्यतनित आकृती 1. उदाampसेन्सर ओरिएंटेशनचे ले, तक्ता २. गेलेला वेळ (µs) अल्गोरिदम आणि आकृती ३. STM2 न्यूक्लियो: LEDs, बटण, जंपर. X-NUCLEO-IKS01A3 विस्तार बोर्ड सुसंगतता माहिती जोडली. |
| 24-मार्च-2020 | 5 | अपडेट केलेला परिचय, विभाग २.२.१ मोशनजीआर लायब्ररी वर्णन आणि विभाग २.२.५ अल्गोरिथम कामगिरी. ARM Cortex-M7 आर्किटेक्चर सुसंगतता माहिती जोडली. |
| 17-सप्टे-2024 | 6 | अपडेट केले विभाग परिचय, विभाग २.१: मोशनजीआर संपलाview, विभाग २.२.१: मोशनजीआर लायब्ररी वर्णन, विभाग २.२.२: मोशनजीआर एपीआय, विभाग 2.2.5: अल्गोरिदम कामगिरी, कलम 2.3: एसample अर्ज, विभाग २.४: एमईएमएस स्टुडिओ अर्ज |
महत्वाची सूचना – काळजीपूर्वक वाचा
STMicroelectronics NV आणि त्याच्या उपकंपन्या (“ST”) ST उत्पादनांमध्ये आणि/किंवा या दस्तऐवजात कोणत्याही वेळी सूचना न देता बदल, सुधारणा, सुधारणा, सुधारणा आणि सुधारणा करण्याचा अधिकार राखून ठेवतात. खरेदीदारांनी ऑर्डर देण्यापूर्वी एसटी उत्पादनांची नवीनतम माहिती मिळवावी. ऑर्डर पावतीच्या वेळी एसटी उत्पादनांची विक्री एसटीच्या अटी आणि नियमांनुसार केली जाते.
एसटी उत्पादनांची निवड, निवड आणि वापर यासाठी खरेदीदार पूर्णपणे जबाबदार आहेत आणि एसटी अर्ज सहाय्यासाठी किंवा खरेदीदारांच्या उत्पादनांच्या डिझाइनसाठी कोणतेही दायित्व गृहीत धरत नाही.
कोणताही बौद्धिक संपदा अधिकाराचा कोणताही परवाना, व्यक्त किंवा निहित, येथे एसटीकडून मंजूर नाही.
येथे नमूद केलेल्या माहितीपेक्षा वेगळ्या तरतुदींसह एसटी उत्पादनांची पुनर्विक्री अशा उत्पादनासाठी एसटीने दिलेली कोणतीही हमी रद्द करेल.
एसटी आणि एसटी लोगो हे एसटीचे ट्रेडमार्क आहेत. एसटी ट्रेडमार्कबद्दल अतिरिक्त माहितीसाठी, पहा www.st.com/trademarks. इतर सर्व उत्पादन किंवा सेवा नावे त्यांच्या संबंधित मालकांची मालमत्ता आहेत.
या दस्तऐवजातील माहिती या दस्तऐवजाच्या कोणत्याही आधीच्या आवृत्त्यांमध्ये पूर्वी पुरवलेल्या माहितीची जागा घेते आणि पुनर्स्थित करते.
© 2024 STMicroelectronics – सर्व हक्क राखीव
UM2201 – Rev 6 – सप्टेंबर 2024
अधिक माहितीसाठी तुमच्या स्थानिकांशी संपर्क साधा
एसटीमायक्रोइलेक्ट्रॉनिक्स विक्री कार्यालय.
www.st.com
कागदपत्रे / संसाधने
 |
ST NUCLEO-F401RE MotionGR रिअल टाइम जेश्चर रेकग्निशन लायब्ररी [pdf] वापरकर्ता मॅन्युअल NUCLEO-F401RE, NUCLEO-U575ZI-Q, NUCLEO-L152RE, NUCLEO-F401RE MotionGR रिअल टाइम जेश्चर रिकग्निशन लायब्ररी, NUCLEO-F401RE, MotionGR रिअल टाइम जेश्चर रिकग्निशन लायब्ररी, टाइम जेश्चर रिकग्निशन लायब्ररी, जेश्चर रिकग्निशन लायब्ररी, रेकग्निशन लायब्ररी |