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 бағдарламалық жасақтама технологиясының үстіне құрастырылған.
Бағдарламалық құрал s-мен бірге келедіampNUCLEO-F4RE, NUCLEO-U1ZI-Q немесе NUCLEO-L01RE әзірлеу тақтасындағы X-NUCLEO-IKS3A401 немесе X-NUCLEO-IKS575A152 кеңейту тақтасында орындалатын іске асыру.
Қысқартулар мен аббревиатуралар
Кесте 1. Акронимдердің тізімі
| Акроним | Сипаттама |
| API | Қолданбалы бағдарламалау интерфейсі |
| BSP | Басқарманың қолдау пакеті |
| GUI | Графикалық пайдаланушы интерфейсі |
| ХАЛ | Аппараттық абстракция қабаты |
| IDE | Интеграцияланған даму ортасы |
STM1Cube үшін X-CUBE-MEMS32 бағдарламалық құралын кеңейтудегі MotionFD аралық бағдарламалық құрал кітапханасы
2.1 MotionFD аяқталдыview
MotionFD кітапханасы X-CUBE-MEMS1 бағдарламалық құралының мүмкіндіктерін кеңейтеді.
Кітапхана акселерометр мен қысым сенсорынан деректерді алады және құрылғыдан алынған деректер негізінде пайдаланушының құлау оқиғасы туралы ақпаратты береді.
Кітапхана тек ST MEMS үшін жасалған. Басқа MEMS сенсорларын пайдалану кезіндегі функционалдылық пен өнімділік талданбайды және құжатта сипатталғаннан айтарлықтай өзгеше болуы мүмкін.
Sample іске асыру NUCLEO-F4RE, NUCLEO-U1ZI-Q немесе NUCLEO-L01RE әзірлеу тақтасына орнатылған X-NUCLEO-IKS3A401 және X-NUCLEO-IKS575A152 кеңейту тақтасы үшін қол жетімді.
2.2 MotionFD кітапханасы
MotionFD API функциялары мен параметрлерін толық сипаттайтын техникалық ақпаратты MotionFD_Package.chm құрастырылған HTML файлынан табуға болады. file Құжаттама қалтасында орналасқан.
2.2.1 MotionFD кітапханасының сипаттамасы
MotionFD құлауды анықтау кітапханасы акселерометр мен қысым сенсорынан алынған деректерді басқарады; оның ерекшеліктері:
- пайдаланушының құлағанын немесе құламағанын ажырату мүмкіндігі
- тану тек акселерометр мен қысым датчигі деректеріне негізделген
- қажетті акселерометр және қысым датчигі деректері sampжиілігі 25 Гц
- ресурстарға қойылатын талаптар:
– Cortex-M3: 3.6 кБ код және 3.2 кБ деректер жады
– Cortex-M33: 3.4 кБ код және 3.2 кБ деректер жады
– Cortex-M4: 3.4 кБ код және 3.2 кБ деректер жады
– Cortex-M7: 3.4 кБ код және 3.2 деректер жады - ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 және ARM Cortex-M7 архитектуралары үшін қол жетімді
2.2.2 MotionFD API интерфейстері
MotionFD кітапханасының API интерфейстері:
- uint8_t MotionFD_GetLibVersion(char *нұсқа)
– кітапхана нұсқасын шығарады
– *нұсқа – 35 таңбадан тұратын массивке көрсеткіш
– нұсқа жолындағы таңбалар санын қайтарады - void MotionFD_Initialize(жарамсыз)
– MotionFD кітапханасын инициализациялауды және ішкі механизмді орнатуды орындайды
Ескерту: Бұл функция құлауды анықтау кітапханасын пайдаланбас бұрын шақырылуы керек және STM32 микроконтроллеріндегі (RCC перифериялық сағатты қосу регистрінде) CRC модулін қосу керек.
- жарамсыз MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
– құлауды анықтау алгоритмін орындайды
– *data_in параметрі – кіріс деректері бар құрылымға көрсеткіш
– MFD_input_t құрылым типінің параметрлері:
◦ AccX – мг-дегі X осіндегі акселерометр сенсорының мәні
◦ AccY – Y осіндегі акселерометр сенсорының мг-дегі мәні
◦ AccZ – Z осіндегі акселерометр сенсорының мг-дегі мәні
◦ Press - гПа-дағы қысым сенсорының мәні
– *data_out параметрі келесі элементтері бар нөмірге көрсеткіш болып табылады:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs(қалқымалы құлау шегі, int32_t құлау_биіктігі_дельтасы, қалтқыдағы жату_уақыты)
– кітапхана конфигурациясының параметрлерін орнатады
– құлау_табалдырығы мг-дағы жеделдету шегі
– құлау_биіктігі_дельта биіктік айырмашылығы см
– соққыдан кейін қозғалыссыз секундтарда жату уақыты - void MotionFD_GetKnobs(float *түзу_табалдырығы, int32_t *fall_altitude_delta, float *жатқан_уақыты)
– кітапхана конфигурациясының параметрлерін алады
– құлау_табалдырығы мг-дағы жеделдету шегі
– құлау_биіктігі_дельта биіктік айырмашылығы см
– соққыдан кейін қозғалыссыз секундтарда жату уақыты
2.2.3 API ағын диаграммасы
2.2.4 Демо-код
Келесі демонстрациялық код акселерометр мен қысым сенсорынан деректерді оқиды және құлау оқиғасының кодын алады.
2.2.5 Алгоритмді орындау
Құлауды анықтау алгоритмі тек акселерометр мен қысым сенсорынан алынған деректерді пайдаланады және қуат тұтынуды азайту үшін төмен жиілікте (25 Гц) жұмыс істейді.
2.3 Сampқолданба
MotionFD аралық бағдарламалық құралын пайдаланушы қолданбаларын құру үшін оңай басқаруға болады; ретіндеample қолданбасы Қолданбалар қалтасында берілген.
Ол X-NUCLEO-IKS401A575 немесе X-NUCLEO-IKS152A4 кеңейту тақтасына қосылған NUCLEO-F1RE, NUCLEO-U01ZI-Q немесе NUCLEO-L3RE әзірлеу тақтасында жұмыс істеуге арналған.
Қолданба нақты уақытта пайдаланушының құлау оқиғасын таниды.
Жоғарыдағы суретте B1 пайдаланушы түймесі және NUCLEO-F401RE тақтасының үш жарық диоды көрсетілген. Тақтаға қуат берілгеннен кейін LD3 LED (PWR) ҚОСУ.
Нақты уақыттағы деректерді бақылау үшін USB кабелі қосылымы қажет. Тақта компьютерден USB қосылымы арқылы қуат алады. Бұл жұмыс режимі анықталған пайдаланушының құлау оқиғасы, акселерометр және қысым датчигі деректері, уақыт стamp және сайып келгенде, MEMS-Studio көмегімен нақты уақыттағы басқа сенсор деректері.
2.4 MEMS-Studio қолданбасы
Sample қолданбасы мына жерден жүктеп алуға болатын MEMS-Studio қолданбасын пайдаланады www.st.com.
1-қадам. Қажетті драйверлердің орнатылғанын және сәйкес кеңейту тақтасы бар STM32 Nucleo тақтасының компьютерге қосылғанын тексеріңіз.
2-қадам. Негізгі қолданба терезесін ашу үшін MEMS-Studio қолданбасын іске қосыңыз.
Қолдау көрсетілетін микробағдарламасы бар STM32 Nucleo тақтасы компьютерге қосылған болса, ол автоматты түрде анықталады.
Бағалау тақтасына қосылым орнату үшін [Қосылу] түймесін басыңыз.
3-қадам. Қолдау көрсетілетін микробағдарламасы бар STM32 Nucleo тақтасына қосылған кезде [Кітапхананы бағалау] қойындысы ашылады.
Деректер ағынын бастау және тоқтату үшін сәйкес [Бастау] түймесін ауыстырыңыз. 
немесе [Тоқтату] 
сыртқы тік құралдар тақтасындағы түймені басыңыз.
Қосылған сенсордан келетін деректер болуы мүмкін viewІшкі тік құралдағы [Деректер кестесі] қойындысын таңдау ba
4-қадам. Арнайы қолданба терезесін ашу үшін [Құлауды анықтау] түймесін басыңыз.
5-қадам. [Сақтау үшін] түймесін басыңыз File] деректер журналын конфигурациялау терезесін ашу үшін. ішінде сақталатын сенсор мен құлауды анықтау деректерін таңдаңыз file. Сәйкес түймені басу арқылы сақтауды бастауға немесе тоқтатуға болады.
6-қадам. Деректерді енгізу режимі бұрын алынған деректерді кітапханаға жіберу және нәтижені алу үшін пайдаланылуы мүмкін. Бөлінгенді ашу үшін тік құралдар тақтасындағы [Деректерді енгізу] қойындысын таңдаңыз view осы функция үшін.
7-қадам. таңдау үшін [Шолу] түймесін басыңыз file CSV пішімінде бұрын түсірілген деректермен.
Деректер ағымдағы уақытта кестеге жүктеледі view.
Басқа түймелер белсенді болады. Сіз мынаны баса аласыз:
– Микробағдарламаның офлайн режимін қосу/өшіру үшін [Офлайн режимі] түймесі (бұрын түсірілген деректерді пайдаланатын режим).
– [Бастау]/[Тоқтату]/[Қадам]/[Қайталау] түймелері MEMS-Studio-дан кітапханаға деректер беруді басқару үшін.
2.5 Әдебиеттер
Төмендегі ресурстардың барлығы www.st.com сайтында тегін қол жетімді.
- UM1859: STM1Cube үшін X-CUBE-MEMS32 қозғалыс MEMS және қоршаған орта сенсорының бағдарламалық құралын кеңейтуді бастау
- UM1724: STM32 Nucleo-64 тақталары (MB1136)
- UM3233: MEMS-Studio бағдарламасын іске қосу
Қайта қарау тарихы
Кесте 4. Құжатты қайта қарау тарихы
| Күн | Нұсқа | Өзгерістер |
| 22-қыркүйек-2017 ж | 1 | Бастапқы шығарылым. |
| 6 ақпан 18 ж | 2 | NUCLEO-L152RE әзірлеу тақтасына және 2-кестеге сілтемелер қосылды. Өткен уақыт (μs) алгоритмі. |
| 21-18 наурыз | 3 | Жаңартылған кіріспе және 2.1 MotionFD бөлімі аяқталдыview. |
| 19 ақпан 19 ж | 4 | Жаңартылған кесте 2. Өткен уақыт (μs) алгоритмі және 2-сурет. STM32 Nucleo: жарық диодтары, түйме, секіргіш. X-NUCLEO-IKS01A3 кеңейту тақтасының үйлесімділігі туралы ақпарат қосылды. |
| 17-қыркүйек-24 ж | 5 | Жаңартылған бөлім кіріспе, 2.1-бөлім: MotionFD аяқталдыview, 2.2.1-бөлім: MotionFD кітапханасының сипаттамасы, 2.2.2-бөлім: MotionFD API интерфейстері, 2.2.5-бөлім: Алгоритм өнімділігі, 2.3-бөлім: Sample қолданбасы, 2.4-бөлім: MEMS-Studio қолданбасы |
МАҢЫЗДЫ ЕСКЕРТПЕ – МҰҚИЯТ ОҚЫҢЫЗ
STMicroelectronics NV және оның еншілес компаниялары («СТ») 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 нақты уақыттағы құлауды анықтау кітапханасы, нақты уақытта құлауды анықтау кітапханасы, құлауды анықтау кітапханасы, анықтау кітапханасы, кітапхана |
