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.
Праграмнае забеспячэнне пастаўляецца з sample рэалізацыя працуе на плаце пашырэння 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
Тэхнічную інфармацыю з поўным апісаннем функцый і параметраў API MotionFD можна знайсці ў скампіляваным HTML MotionFD_Package.chm file знаходзіцца ў тэчцы Дакументацыя.
2.2.1 Апісанне бібліятэкі MotionFD
Бібліятэка выяўлення падзення MotionFD кіруе данымі, атрыманымі з акселерометра і датчыка ціску; гэта асаблівасці:
- магчымасць адрозніць, адбылося падзенне карыстальніка ці не
- распазнаванне толькі па дадзеных акселерометра і датчыка ціску
- неабходныя даныя акселерометра і датчыка ціскуampчастата 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 API MotionFD
API бібліятэкі MotionFD:
- uint8_t MotionFD_GetLibVersion(знак *версія)
– здабывае версію бібліятэкі
– *версія - гэта паказальнік на масіў з 35 знакаў
– вяртае колькасць сімвалаў у радку версіі - несапраўдны 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 - гэта значэнне датчыка акселерометра па восі Х у мг
◦ AccY — значэнне датчыка акселерометра па восі Y у мг
◦ AccZ - гэта значэнне датчыка акселерометра па восі Z у мг
◦ Press - значэнне датчыка ціску ў гПа
– Параметр *data_out з'яўляецца паказальнікам на пералік з наступнымі элементамі:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
– задае параметры канфігурацыі бібліятэкі
– fall_threshold парог паскарэння ў мг
– розніца вышынь fall_altitude_delta у см
– час ляжання час у секундах без руху пасля ўдару - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
– атрымлівае параметры канфігурацыі бібліятэкі
– fall_threshold парог паскарэння ў мг
– розніца вышынь fall_altitude_delta у см
– час ляжання час у секундах без руху пасля ўдару
2.2.3 Блок-схема API
2.2.4 Дэма-код
Наступны дэманстрацыйны код счытвае даныя з акселерометра і датчыка ціску і атрымлівае код падзеі падзення.
2.2.5 Прадукцыйнасць алгарытму
Алгарытм выяўлення падзення выкарыстоўвае толькі даныя акселерометра і датчыка ціску і працуе на нізкай частаце (25 Гц), каб знізіць энергаспажыванне.
2.3 Сampпрыкладанне
Прамежкавым праграмным забеспячэннем MotionFD можна лёгка маніпуляваць для стварэння карыстальніцкіх прыкладанняў; якampПрыкладанне знаходзіцца ў тэчцы Application.
Ён прызначаны для працы на плаце распрацоўкі NUCLEO-F401RE, NUCLEO-U575ZI-Q або NUCLEO-L152RE, падключанай да платы пашырэння X-NUCLEO-IKS4A1 або X-NUCLEO-IKS01A3.
Прыкладанне распазнае падзенне карыстальніка ў рэжыме рэальнага часу.
На малюнку вышэй паказана карыстацкая кнопка B1 і тры святлодыёда платы NUCLEO-F401RE. Пасля ўключэння платы святлодыёд LD3 (PWR) загараецца.
Для маніторынгу даных у рэжыме рэальнага часу патрабуецца злучэнне праз кабель USB. Плата сілкуецца ад ПК праз USB-злучэнне. Гэты працоўны рэжым дазваляе выяўленае падзенне карыстальніка, даныя акселерометра і датчыка ціску, час стamp і, у рэшце рэшт, іншыя даныя датчыкаў у рэжыме рэальнага часу з дапамогай MEMS-Studio.
2.4 Праграма MEMS-Studio
У ыampДадатак le выкарыстоўвае прыкладанне MEMS-Studio, якое можна загрузіць з www.st.com.
Крок 1. Пераканайцеся, што неабходныя драйверы ўсталяваны і плата STM32 Nucleo з адпаведнай платай пашырэння падключана да ПК.
Крок 2. Запусціце праграму MEMS-Studio, каб адкрыць галоўнае акно праграмы.
Калі плата STM32 Nucleo з падтрымліваемым прашыўкай падключана да ПК, яна вызначаецца аўтаматычна.
Націсніце кнопку [Connect], каб усталяваць злучэнне з ацэначнай платай.
Крок 3. Пры падключэнні да платы STM32 Nucleo з падтрымліваемым прашыўкай адкрываецца ўкладка [Library Evaluation].
Каб пачаць і спыніць струменевую перадачу даных, пераключыце адпаведны [Пуск] 
або [Стоп] 
кнопка на знешняй вертыкальнай панэлі інструментаў.
Дадзеныя, якія паступаюць з падлучанага датчыка, могуць быць viewвыбраўшы ўкладку [Табліца даных] на ўнутраным вертыкальным інструменте ba
Крок 4. Націсніце на [Fall Detection], каб адкрыць спецыяльнае акно прыкладання.
Крок 5. Націсніце кнопку [Захаваць у File], каб адкрыць акно канфігурацыі рэгістрацыі даных. Выберыце датчык і дадзеныя выяўлення падзення, якія будуць захаваны ў file. Вы можаце пачаць або спыніць захаванне, націснуўшы на адпаведную кнопку.
Крок 6. Рэжым ін'екцыі даных можна выкарыстоўваць для адпраўкі раней атрыманых даных у бібліятэку і атрымання выніку. Абярыце ўкладку [Увядзенне даных] на вертыкальнай панэлі інструментаў, каб адкрыць спецыяльную view для гэтай функцыі.
Крок 7. Націсніце на кнопку [Агляд], каб выбраць file з раней атрыманымі дадзенымі ў фармаце CSV.
Дадзеныя будуць загружаны ў табліцу ў бягучым view.
Іншыя кнопкі стануць актыўнымі. Вы можаце націснуць на:
– Кнопка [Аўтаномны рэжым] для ўключэння/выключэння аўтаномнага рэжыму ўбудаванага праграмнага забеспячэння (рэжым з выкарыстаннем раней атрыманых дадзеных).
– Кнопкі [Пуск]/[Стоп]/[Крок]/[Паўтарыць] для кіравання падачай даных з MEMS-Studio у бібліятэку.
2.5 Спіс літаратуры
Усе наступныя рэсурсы знаходзяцца ў вольным доступе на www.st.com.
- UM1859: Пачатак працы з MEMS руху X-CUBE-MEMS1 і праграмным забеспячэннем датчыка навакольнага асяроддзя для STM32Cube
- UM1724: платы STM32 Nucleo-64 (MB1136)
- UM3233: Пачатак працы з MEMS-Studio
Гісторыя версій
Табліца 4. Гісторыя рэдагавання дакумента
| Дата | Версія | Змены |
| 22-2017 верасня | 1 | Першапачатковы выпуск. |
| 6-лютага-18 | 2 | Дададзены спасылкі на плату распрацоўкі NUCLEO-L152RE і табліцу 2. Алгарытм часу, які прайшоў (мкс). |
| 21-сакавіка-18 | 3 | Абноўлены Уводзіны і раздзел 2.1 MotionFDview. |
| 19-лютага-19 | 4 | Абноўленая табліца 2. Алгарытм затрачанага часу (мкс) і малюнак 2. STM32 Nucleo: святлодыёды, кнопка, перамычка. Дададзена інфармацыя аб сумяшчальнасці платы пашырэння X-NUCLEO-IKS01A3. |
| 17-24 верасня | 5 | Абноўлены раздзел Уводзіны, раздзел 2.1: MotionFD скончаныview, Раздзел 2.2.1: Апісанне бібліятэкі MotionFD, Раздзел 2.2.2: API MotionFD, Раздзел 2.2.5: Прадукцыйнасць алгарытму, Раздзел 2.3: Sample дадатак, Раздзел 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 Бібліятэка выяўлення падзення ў рэальным часе, Бібліятэка выяўлення падзення ў рэальным часе, Бібліятэка выяўлення падзення, Бібліятэка выяўлення, Бібліятэка |
