ST X-CUBE-MEMS1 सेन्सर आणि मोशन अल्गोरिथम सॉफ्टवेअर एक्सपेंशन वापरकर्ता मॅन्युअल

The MotionPW library expands the functionality of the X-CUBE-MEMS1 software by acquiring data from the accelerometer to provide information about the number of steps and cadence performed with the wearable device.

परिचय

The MotionPW middleware library is part of the X-CUBE-MEMS1 software and runs on STM32 Nucleo. It provides real-time information about the number of steps and cadence which the user just performed with the wearable device (e.g. a smart watch).

हे लायब्ररी फक्त ST MEMS सोबत काम करण्याच्या उद्देशाने आहे.
The algorithm is provided in static library format and is designed to be used on STM32 microcontrollers based on the ARM® Cortex®-M3, ARM Cortex®-M33, ARM® Cortex®-M4, ARM® Cortex®-M7 architecture.

विविध STM32 मायक्रोकंट्रोलरमध्ये पोर्टेबिलिटी सुलभ करण्यासाठी हे STM32Cube सॉफ्टवेअर तंत्रज्ञानाच्या वर तयार केले आहे.

सॉफ्टवेअर s सह येतोampNUCLEO-F4RE, NUCLEO-U1ZI-Q किंवा NUCLEO-L01RE डेव्हलपमेंट बोर्डवर X-NUCLEO-IKS3A401 किंवा X-NUCLEO-IKS575A152 विस्तार बोर्डवर चालणारी अंमलबजावणी.

1. परिवर्णी शब्द आणि संक्षेप

तक्ता 1. परिवर्णी शब्दांची सूची

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

2. MotionPW middleware library in X-CUBE-MEMS1 software expansion for STM32Cube

2.1 MotionPW overview

MotionPW लायब्ररी X-CUBE-MEMS1 सॉफ्टवेअरची कार्यक्षमता वाढवते.

लायब्ररी अ‍ॅक्सिलरोमीटरवरून डेटा मिळवते आणि वापरकर्त्याने घालण्यायोग्य उपकरणासह केलेल्या पायऱ्या आणि गतीची संख्या याबद्दल माहिती प्रदान करते.
लायब्ररीची रचना फक्त ST MEMS साठी केली आहे. इतर MEMS सेन्सर वापरताना कार्यक्षमता आणि कार्यप्रदर्शनाचे विश्लेषण केले जात नाही आणि दस्तऐवजात वर्णन केलेल्या गोष्टींपेक्षा लक्षणीय भिन्न असू शकतात.
ए एसampहे अंमलबजावणी X-NUCLEO-IKS4A1 आणि X-NUCLEO-IKS01A3 विस्तार बोर्डांसाठी उपलब्ध आहे, जे aNUCLEO-F401RE, NUCLEO-U575ZI-Q किंवा NUCLEO-L152RE विकास बोर्डवर बसवलेले आहेत.

2.2 MotionPW library

Technical information fully describing the functions and parameters of the MotionPW APIs can be found in the
MotionPW_Package.chm compiled HTML file दस्तऐवजीकरण फोल्डरमध्ये स्थित आहे.

2.2.1 MotionPW library description

मोशनपीडब्ल्यू पेडोमीटर लायब्ररी अ‍ॅक्सिलरोमीटरमधून मिळवलेला डेटा व्यवस्थापित करते; त्यात खालील वैशिष्ट्ये आहेत:

पावलांची संख्या, लय आणि आत्मविश्वास शोधण्याची शक्यता
केवळ एक्सीलरोमीटर डेटावर आधारित ओळख
आवश्यक प्रवेगमापक डेटा samp50 Hz ची लिंग वारंवारता
संसाधन आवश्यकता:
– कॉर्टेक्स-एम३: ३.६ kB कोड आणि ३.२ kB डेटा मेमरी
– कॉर्टेक्स-एम३: ३.६ kB कोड आणि ३.२ kB डेटा मेमरी
– कॉर्टेक्स-एम३: ३.६ kB कोड आणि ३.२ kB डेटा मेमरी
– कॉर्टेक्स-एम३: ३.६ kB कोड आणि ३.२ kB डेटा मेमरी

ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 आणि ARM® Cortex®-M7 आर्किटेक्चरसाठी उपलब्ध

2.2.2 MotionPW APIs

MotionPW लायब्ररी API हे आहेत:

uint8_t MotionPW_GetLibVersion(अक्षर *आवृत्ती)
- लायब्ररी आवृत्ती पुनर्प्राप्त करते
- *आवृत्ती 35 वर्णांच्या ॲरेसाठी पॉइंटर आहे
- आवृत्ती स्ट्रिंगमधील वर्णांची संख्या परत करते

void MotionPW_Initialize(void)
– performs MotionPW library initialization and setup of the internal mechanism including the dynamic memory allocation

टीप: फिटनेस अ‍ॅक्टिव्हिटी लायब्ररी वापरण्यापूर्वी हे फंक्शन कॉल करणे आवश्यक आहे आणि STM32 मायक्रोकंट्रोलरमधील (RCC पेरिफेरल क्लॉक इनॅबल रजिस्टरमध्ये) CRC मॉड्यूल सक्षम करणे आवश्यक आहे.

व्हॉइड मोशन पीडब्ल्यू_अपडेट (एमपीडब्ल्यू_इनपुट_टी *डेटा_इन, एमपीडब्ल्यू_आउटपुट_टी *डेटा_आउट)
– executes pedometer for wrist algorithm
- *data_in पॅरामीटर हे इनपुट डेटासह संरचनेचे सूचक आहे
– the parameters for the structure type MPW_input_t are:
◦ AccX हे g मध्ये X अक्षातील अ‍ॅक्सिलरोमीटर सेन्सर मूल्य आहे.
◦ AccY हे g मध्ये Y अक्षातील अ‍ॅक्सिलरोमीटर सेन्सर मूल्य आहे.
◦ AccZ हे g मध्ये Z अक्षातील अ‍ॅक्सिलरोमीटर सेन्सर मूल्य आहे.
– CurrentActivity is the enumerated input type MPW_activity_t with the following values:
◦ MPW_UNKNOWN_ACTIVITY = 0x00
◦ MPW_WALKING = 0x01
◦ MPW_FASTWALKING = 0x02
◦ MPW_JOGGING = 0x03
- *डेटा_आउट पॅरामीटर हे आउटपुट डेटासह संरचनेचे सूचक आहे
– the parameters for the structure type MPW_output_t are:
◦ Nsteps is number of steps performed by user
◦ Cadence is the cadence of user steps
◦ Confidence is the confidence of calculated output parameter
void MotionPW_ResetPedometerLibrary(void)
– resets the library internal variables and mechanism into default values (including current step count)

शून्य मोशनपीडब्ल्यू_रिसेटस्टेपकाउंट(शून्य)
– resets the current step count
शून्य मोशनपीडब्ल्यू_अपडेटएनर्जीथ्रेशोल्ड(फ्लोट *एनर्जी_थ्रेशोल्ड)
– updated energy threshold to fine tune step detection algorithm
– *energy_threshold parameter is a pointer to energy threshold value

2.2.3 API फ्लो चार्ट

2.2.4 डेमो कोड
The following demonstration code example अ‍ॅक्सिलरोमीटर सेन्सरमधून डेटा वाचतो, MotionAW लायब्ररीमधून चालू क्रियाकलाप मिळवतो आणि MotionPW लायब्ररीमधून चरणांची संख्या, लय आणि आत्मविश्वास मिळवतो.

2.2.5 अल्गोरिदम कामगिरी
The pedometer for wrist algorithm uses data from the accelerometer only and runs at a low frequency (50 Hz) to reduce power consumption.
When replicating fitness activity with the STM32 Nucleo board, ensure the board is oriented perpendicularly to the forearm, to simulate the wristband position.

2.3 एसample अर्ज

वापरकर्ता अनुप्रयोग तयार करण्यासाठी MotionPW मिडलवेअर सहजपणे हाताळले जाऊ शकते.
ए एसample application is provided in the Application folder. It is designed to run on a NUCLEO-F401RE, NUCLEOU575ZI- Q or NUCLEO-L152RE development board connected to an X-NUCLEO-IKS4A1 or X-NUCLEO-IKS01A3 expansion board.

हे अॅप्लिकेशन रिअल-टाइममध्ये पायऱ्या, लय आणि आत्मविश्वास ओळखते. डेटा GUI द्वारे प्रदर्शित केला जाऊ शकतो.

वरील आकृती वापरकर्ता बटण B1 आणि NUCLEO-F401RE बोर्डचे तीन LEDs दाखवते. बोर्ड चालू झाल्यावर, LED LD3 (PWR) चालू होते.
रिअल-टाइम डेटाचे निरीक्षण करण्यासाठी USB केबल कनेक्शन आवश्यक आहे. बोर्ड USB कनेक्शनद्वारे PC द्वारे समर्थित आहे. या वर्किंग मोडमुळे वापरकर्त्याला शोधलेले चरण, लय आणि आत्मविश्वास, एक्सेलेरोमीटर डेटा, वेळ st प्रदर्शित करण्याची परवानगी मिळते.amp आणि शेवटी इतर सेन्सर डेटा, रिअल-टाइममध्ये, MEMS-Studio वापरून.

२.४ एमईएमएस स्टुडिओ अॅप्लिकेशन

एसample ऍप्लिकेशन MEMS-Studio ऍप्लिकेशन वापरते, जे येथून डाउनलोड केले जाऊ शकते www.st.com.

पायरी 1. आवश्यक ड्रायव्हर्स स्थापित केले आहेत याची खात्री करा आणि योग्य विस्तार बोर्डसह STM32 न्यूक्लिओ बोर्ड पीसीशी जोडला गेला आहे.

पायरी 2. मुख्य ऍप्लिकेशन विंडो उघडण्यासाठी MEMS-Studio ऍप्लिकेशन लाँच करा.

समर्थित फर्मवेअरसह STM32 Nucleo बोर्ड PC शी कनेक्ट केलेले असल्यास, ते आपोआप ओळखले जाते.
Press the [Connect] button to establish connection to the evaluation board

पायरी 3. समर्थित फर्मवेअरसह STM32 न्यूक्लिओ बोर्डशी कनेक्ट केल्यावर [लायब्ररी मूल्यांकन] टॅब उघडला जातो.

डेटा प्रवाह सुरू करण्यासाठी आणि थांबवण्यासाठी, योग्य टॉगल करा [प्रारंभ] किंवा [थांबा] बाहेरील उभ्या टूलबारवरील बटण.

कनेक्टेड सेन्सरमधून येणारा डेटा असू शकतो viewed अंतर्गत उभ्या टूलबारवरील [डेटा टेबल] टॅब निवडणे.

पायरी 4. Click on the [Pedometer] to open the dedicated application window.

पायरी 5. [Save To वर क्लिक करा File] डेटालॉगिंग कॉन्फिगरेशन विंडो उघडण्यासाठी. सेव्ह करायचा सेन्सर आणि पेडोमीटर डेटा निवडा file. तुम्ही संबंधित बटणावर क्लिक करून बचत सुरू करू शकता किंवा थांबवू शकता.

पायरी 6. डेटा इंजेक्शन मोडचा वापर पूर्वी मिळवलेला डेटा लायब्ररीला पाठवण्यासाठी आणि परिणाम प्राप्त करण्यासाठी केला जाऊ शकतो. समर्पित उघडण्यासाठी उभ्या टूलबारवरील [डेटा इंजेक्शन] टॅब निवडा view या कार्यक्षमतेसाठी

पायरी 7. निवडण्यासाठी [ब्राउझ] बटणावर क्लिक करा file CSV फॉरमॅटमध्ये पूर्वी कॅप्चर केलेल्या डेटासह.

डेटा करंटमध्ये टेबलमध्ये लोड केला जाईल view.

इतर बटणे सक्रिय होतील. आपण यावर क्लिक करू शकता:
– [Offline Mode] button to switch the firmware offline mode on/off (mode utilizing the previously captured data).
– MEMS-Studio वरून लायब्ररीमध्ये डेटा फीड नियंत्रित करण्यासाठी [प्रारंभ]/[थांबा]/[चरण]/[पुनरावृत्ती] बटणे.

3. संदर्भ

खालील सर्व संसाधने www.st.com वर विनामूल्य उपलब्ध आहेत.

1. UM1859: Getting started with the X-CUBE-MEMS1 motion MEMS and environmental sensor software expansion for STM32Cube
2. UM1724: STM32 Nucleo-64 boards (MB1136)
3. UM3233: Getting started with MEMS-Studio

पुनरावृत्ती इतिहास

तक्ता 4. दस्तऐवज पुनरावृत्ती इतिहास

तारीख	आवृत्ती	बदल
24-जानेवारी-18	1	प्रारंभिक प्रकाशन.
21-मार्च-18	2	Updated Introduction and Section 2.1 MotionPW overview.
20-फेब्रु-19	3	Updated Section 2.2.5: Algorithm performance and Figure 3. STM32 Nucleo: LEDs, button, jumper. X-NUCLEO-IKS01A3 विस्तार बोर्ड सुसंगतता माहिती जोडली.
०१-मे-२०२३	4	अपडेटेड सेक्शन परिचय, सेक्शन २.१: मोशनपीडब्ल्यू संपलाview, Section 2.2.1: MotionPW library description, Section 2.2.2: MotionPW APIs, Section 2.2.4: Demo code, Section 2.2.5: Algorithm performance, Section 2.3: Sample application, Section 2.4: MEMS Studio applica

महत्वाची सूचना – काळजीपूर्वक वाचा

STMicroelectronics NV आणि त्याच्या उपकंपन्या (“ST”) ST उत्पादनांमध्ये आणि/किंवा या दस्तऐवजात कोणत्याही वेळी सूचना न देता बदल, सुधारणा, सुधारणा, सुधारणा आणि सुधारणा करण्याचा अधिकार राखून ठेवतात. खरेदीदारांनी ऑर्डर देण्यापूर्वी एसटी उत्पादनांची नवीनतम माहिती मिळवावी. ऑर्डर पावतीच्या वेळी एसटी उत्पादनांची विक्री एसटीच्या अटी आणि नियमांनुसार केली जाते.
एसटी उत्पादनांची निवड, निवड आणि वापर यासाठी खरेदीदार पूर्णपणे जबाबदार आहेत आणि एसटी अर्ज सहाय्यासाठी किंवा खरेदीदारांच्या उत्पादनांच्या डिझाइनसाठी कोणतेही दायित्व गृहीत धरत नाही.

कोणताही बौद्धिक संपदा अधिकाराचा कोणताही परवाना, व्यक्त किंवा निहित, येथे एसटीकडून मंजूर नाही.
येथे नमूद केलेल्या माहितीपेक्षा वेगळ्या तरतुदींसह एसटी उत्पादनांची पुनर्विक्री अशा उत्पादनासाठी एसटीने दिलेली कोणतीही हमी रद्द करेल.
एसटी आणि एसटी लोगो हे एसटीचे ट्रेडमार्क आहेत. ST ट्रेडमार्कबद्दल अतिरिक्त माहितीसाठी, www.st.com/trademarks पहा. इतर सर्व उत्पादन किंवा सेवा नावे त्यांच्या संबंधित मालकांची मालमत्ता आहेत.

या दस्तऐवजातील माहिती या दस्तऐवजाच्या कोणत्याही आधीच्या आवृत्त्यांमध्ये पूर्वी पुरवलेल्या माहितीची जागा घेते आणि पुनर्स्थित करते.

अंमलबजावणी

ए एसample implementation is available for X-NUCLEO-IKS4A1 and X-NUCLEO-IKS01A3 expansion boards mounted on specified development boards.

तांत्रिक माहिती

For detailed functions and parameters of the MotionPW APIs, refer to the MotionPW_Package.chm compiled HTML file दस्तऐवजीकरण फोल्डरमध्ये स्थित आहे.

API

MotionPW_GetLibVersion(अक्षर *आवृत्ती)
MotionPW_Initialize(रिकामा)
MotionPW_Update(MPW_input_t *data_in, MPW_output_t *data_out)
मोशनपीडब्ल्यू_रीसेटपेडोमीटरलायब्ररी(रिकामा)
मोशनपीडब्ल्यू_रीसेटस्टेपकाउंट(रिकामा)
मोशनपीडब्ल्यू_अपडेटएनर्जीथ्रेशोल्ड(फ्लोट *एनर्जी_थ्रेशोल्ड)

तपशील

उत्पादनाचे नाव: मोशनपीडब्ल्यू रिअल-टाइम पेडोमीटर
सुसंगतता: STM1Cube साठी X-CUBE-MEMS32 विस्तार
निर्माता: STMicroelectronics
ग्रंथालय: मोशनपीडब्ल्यू मिडलवेअर ग्रंथालय
डेटा संपादन: अ‍ॅक्सिलरोमीटर
Sampलिंग वारंवारता: 50 Hz

वारंवार विचारले जाणारे प्रश्न (FAQ)

प्रश्न: मी नॉन-एसटी एमईएमएस सेन्सर्ससह मोशनपीडब्ल्यू लायब्ररी वापरू शकतो का?

अ: लायब्ररी फक्त ST MEMS सेन्सर्ससाठी डिझाइन केलेली आहे.
इतर MEMS सेन्सर्ससह सुसंगततेची हमी नाही.

प्रश्न: आवश्यक एक्सलेरोमीटर डेटा s काय आहेampलिंग वारंवारता?

A: आवश्यक एसampling frequency is 50 Hz for accurate detection of steps and cadence.

प्रश्न: मी MotionPW लायब्ररी कशी सुरू करू?

A: Call the MotionPW_Initialize() function before using the fitness activity library. Ensure the CRC module in the STM32 microcontroller is enabled.

कागदपत्रे / संसाधने

ST X-CUBE-MEMS1 सेन्सर आणि मोशन अल्गोरिथम सॉफ्टवेअर विस्तार [pdf] वापरकर्ता मॅन्युअल
STM32 न्यूक्लियो, X-NUCLEO-IKS4A1, X-NUCLEO-IKS01A3, X-CUBE-MEMS1 सेन्सर आणि मोशन अल्गोरिथम सॉफ्टवेअर एक्सपेंशन, X-CUBE-MEMS1, सेन्सर आणि मोशन अल्गोरिथम सॉफ्टवेअर एक्सपेंशन, मोशन अल्गोरिथम सॉफ्टवेअर एक्सपेंशन, अल्गोरिथम सॉफ्टवेअर एक्सपेंशन, सॉफ्टवेअर एक्सपेंशन

संदर्भ

वापरकर्ता मॅन्युअल

ST X-CUBE-MEMS1 सेन्सर आणि मोशन अल्गोरिथम सॉफ्टवेअर विस्तार