UM2275
Упатство за употреба
Започнуваме со MotionFD библиотека за откривање пад во реално време во експанзијата X-CUBE-MEMS1 за STM32Cube
Вовед
MotionEC е библиотечна компонента на среден софтвер на софтверот X-CUBE-MEMS1 и работи на STM3z2. Обезбедува информации во реално време за ориентацијата на уредот и статусот на движење врз основа на податоците од уредот.
Ги обезбедува следните излези: ориентација на уредот (кватерниони, Ојлерови агли), ротација на уредот (функционалност на виртуелен жироскоп), вектор на гравитација и линеарно забрзување.
Оваа библиотека е наменета да работи само со ST MEMS.
Алгоритмот е обезбеден во формат на статична библиотека и е дизајниран да се користи на STM32 микроконтролери базирани на ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 и ARM® Архитектури на Cortex®-M7.
Изграден е на врвот на софтверската технологија STM32Cube за да ја олесни преносливоста преку различни микроконтролери STM32.
Софтверот доаѓа со сampимплементацијата работи на X-NUCLEO-IKS4A1 или X-NUCLEO-IKS01A3 плочка за проширување на развојна табла NUCLEO-F401RE, NUCLEO-U575ZI-Q или NUCLEO-L152RE.
Акроними и кратенки
Табела 1. Список на акроними
| Акроним | Опис |
| API | Програмски интерфејс за апликации |
| БСП | Пакет за поддршка на одборот |
| GUI | Графички кориснички интерфејс |
| ХАЛ | Хардверски апстракциски слој |
| IDE | Интегрирана развојна средина |
MotionFD среден софтвер библиотека во проширување на софтверот X-CUBE-MEMS1 за STM32Cube
2.1 MotionFD завршиview
Библиотеката MotionFD ја проширува функционалноста на софтверот X-CUBE-MEMS1.
Библиотеката добива податоци од акцелерометарот и сензорот за притисок и обезбедува информации за настанот на пад на корисникот врз основа на податоците од уредот.
Библиотеката е дизајнирана само за ST MEMS. Функционалноста и перформансите при користење на други MEMS сензори не се анализираат и може значително да се разликуваат од она што е опишано во документот.
SampИмплементацијата е достапна за експанзионата плоча X-NUCLEO-IKS4A1 и X-NUCLEO-IKS01A3, монтирана на развојна табла NUCLEO-F401RE, NUCLEO-U575ZI-Q или NUCLEO-L152RE.
2.2 MotionFD библиотека
Техничките информации кои целосно ги опишуваат функциите и параметрите на MotionFD API може да се најдат во составениот HTML на MotionFD_Package.chm file се наоѓа во папката Documentation.
2.2.1 Опис на библиотеката MotionFD
Библиотеката за откривање пад на MotionFD управува со податоците добиени од акцелерометарот и сензорот за притисок; се одликува со:
- можност да се направи разлика дали падот на корисникот се случил или не
- препознавање само врз основа на податоците од акцелерометарот и сензорот за притисок
- потребни податоци за акцелерометарот и сензорот за притисок sampЛинг фреквенцијата е 25 Hz
- барања за ресурси:
– Cortex-M3: 3.6 kB код и 3.2 kB меморија за податоци
– Cortex-M33: 3.4 kB код и 3.2 kB меморија за податоци
– Cortex-M4: 3.4 kB код и 3.2 kB меморија за податоци
– Cortex-M7: 3.4 kB код и 3.2 меморија за податоци - достапни за архитектури ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 и ARM Cortex-M7
2.2.2 MotionFD API
API-ите на библиотеката MotionFD се:
- uint8_t MotionFD_GetLibVersion(char *верзија)
– ја враќа верзијата на библиотеката
– *верзијата е покажувач на низа од 35 знаци
– го враќа бројот на знаци во низата на верзијата - void MotionFD_Initialize(неважечки)
– врши иницијализација на библиотеката MotionFD и поставување на внатрешниот механизам
Забелешка: Оваа функција мора да се повика пред да се користи библиотеката за откривање пад и мора да се вклучи CRC модулот во микроконтролерот STM32 (во регистарот за овозможување на периферниот часовник RCC).
- void MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
– извршува алгоритам за откривање пад
– *параметарот data_in е покажувач на структура со влезни податоци
– параметрите за типот на структурата MFD_input_t се:
◦ AccX е вредноста на сензорот за акцелерометар во X оската во mg
◦ AccY е вредноста на сензорот за акцелерометар во Y оската во mg
◦ AccZ е вредноста на сензорот за акцелерометар во оската Z во mg
◦ Притиснете е вредноста на сензорот за притисок во hPa
– Параметарот *data_out е покажувач на нуме со следните ставки:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs (float fall_threshold, int32_t fall_altitude_delta, float lying_time)
– поставува параметри за конфигурација на библиотеката
– праг на забрзување на падот во mg
– пад_висина_делта висинска разлика во cm
– време на лежење во секунди без движење по удар - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
– добива параметри за конфигурација на библиотеката
– праг на забрзување на падот во mg
– пад_висина_делта висинска разлика во cm
– време на лежење во секунди без движење по удар
2.2.3 Графикон на тек на API
2.2.4 Демо код
Следниот демонстративен код ги чита податоците од акцелерометарот и сензорот за притисок и ја добива шифрата за настанот на падот.
2.2.5 Изведба на алгоритам
Алгоритмот за откривање пад користи само податоци од акцелерометарот и сензорот за притисок и работи на мала фреквенција (25 Hz) за да ја намали потрошувачката на енергија.
2.3 Сampле апликација
Средниот софтвер MotionFD може лесно да се манипулира за да се изградат кориснички апликации; какоampАпликацијата е обезбедена во папката Апликација.
Дизајниран е да работи на развојна плочка NUCLEO-F401RE, NUCLEO-U575ZI-Q или NUCLEO-L152RE поврзана со плочка за проширување X-NUCLEO-IKS4A1 или X-NUCLEO-IKS01A3.
Апликацијата го препознава настанот за пад на корисникот во реално време.
На горната слика е прикажано корисничкото копче B1 и трите LED диоди на плочката NUCLEO-F401RE. Откако ќе се напојува плочата, LED LD3 (PWR) се вклучува.
Потребна е врска со USB кабел за следење на податоците во реално време. Плочката се напојува од компјутер преку USB конекција. Овој работен режим овозможува откриениот настан на корисникот пад, податоци за акцелерометарот и сензорот за притисок, време улamp и на крајот други податоци од сензорот, во реално време, користејќи го MEMS-Studio.
2.4 Апликација MEMS-Studio
С.ampLe апликацијата користи апликација MEMS-Studio, која може да се преземе од www.st.com.
Чекор 1. Проверете дали се инсталирани потребните драјвери и дека плочата STM32 Nucleo со соодветна плоча за проширување е поврзана со компјутерот.
Чекор 2. Стартувајте ја апликацијата MEMS-Studio за да го отворите главниот прозорец на апликацијата.
Ако на компјутерот е поврзана плочка STM32 Nucleo со поддржан фирмвер, таа автоматски се открива.
Притиснете го копчето [Поврзи] за да воспоставите врска со таблата за оценување.
Чекор 3. Кога е поврзан на плочка STM32 Nucleo со поддржан фирмвер, се отвора табот [Evaluation на библиотеката].
За да започнете и прекинете преносот на податоци, вклучете го соодветното [Start] 
или [Стоп] 
копче на надворешната вертикална лента со алатки.
Податоците кои доаѓаат од поврзаниот сензор може да бидат viewed избирање на јазичето [Data Table] на внатрешната вертикална алатка ba
Чекор 4. Кликнете на [Откривање паѓање] за да го отворите прозорецот посветен на апликацијата.
Чекор 5. Кликнете на [Зачувај во File] за да го отворите прозорецот за конфигурација на даталог. Изберете го сензорот и податоците за откривање пад што ќе се зачуваат во file. Можете да започнете или прекинете со зачувувањето со кликнување на соодветното копче.
Чекор 6. Режимот за вбризгување на податоци може да се користи за испраќање на претходно добиените податоци во библиотеката и примање на резултатот. Изберете го табот [Data Injection] на вертикалната лента со алатки за да ја отворите посветената view за оваа функционалност.
Чекор 7. Кликнете на копчето [Browse] за да го изберете file со претходно снимените податоци во CSV формат.
Податоците ќе бидат вчитани во табелата во тековната view.
Другите копчиња ќе станат активни. Можете да кликнете на:
– Копче [Offline Mode] за вклучување/исклучување на офлајн режимот на фирмверот (режим што ги користи претходно снимените податоци).
– Копчињата [Start]/[Stop]/[Step]/[Repeat] за да го контролираат доводот на податоци од MEMS-Studio до библиотеката.
2.5 Користена литература
Сите следни ресурси се слободно достапни на www.st.com.
- UM1859: Започнуваме со X-CUBE-MEMS1 движење MEMS и проширување на софтверот за сензори за животна средина за STM32Cube
- 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: LED диоди, копче, скокач. Додадени се информации за компатибилност на плочата за проширување X-NUCLEO-IKS01A3. |
| 17-сеп-24 година | 5 | Ажуриран вовед во делот, Дел 2.1: MotionFD завршиview, Дел 2.2.1: Опис на библиотеката MotionFD, Дел 2.2.2: API-и на MotionFD, Дел 2.2.5: Изведба на алгоритам, Дел 2.3: Сampле апликација, Дел 2.4: Апликација MEMS-Studio |
ВАЖНО НАПОМЕНА – ПРОЧИТАЈТЕ ВНИМАТЕЛНО
STMicroelectronics NV и нејзините подружници („ST“) го задржуваат правото да прават промени, корекции, подобрувања, модификации и подобрувања на производите на ST и/или на овој документ во секое време без најава. Купувачите треба да ги добијат најновите релевантни информации за производите на ST пред да направат нарачки. Производите на ST се продаваат во согласност со одредбите и условите за продажба на ST кои се на сила во моментот на потврдата на нарачката.
Набавувачите се единствено одговорни за изборот, изборот и употребата на производите на ST и ST не презема никаква одговорност за помош при апликација или дизајнирање на производите на купувачите.
Ниту една лиценца, експлицитна или имплицитна, за кое било право на интелектуална сопственост не е дадена од страна на ST овде.
Препродажбата на производите на 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 библиотека за откривање пад во реално време, библиотека за откривање пад во реално време, библиотека за откривање пад, библиотека за откривање, библиотека |
