UM2275
Brûkershânlieding
Te begjinnen mei MotionFD real-time faldeteksjebibleteek yn X-CUBE-MEMS1 útwreiding foar STM32Cube
Ynlieding
De MotionEC is in middleware-bibleteekkomponint fan 'e X-CUBE-MEMS1-software en rint op STM3z2. It jout real-time ynformaasje oer it apparaat oriïntaasje en beweging status basearre op gegevens fan in apparaat.
It jout de folgjende útgongen: apparaat oriïntaasje (quaternions, Euler hoeken), apparaat rotaasje (virtuele gyroscope funksjonaliteit), swiertekrêft vector en lineêre fersnelling.
Dizze bibleteek is bedoeld om allinich te wurkjen mei ST MEMS.
It algoritme wurdt levere yn statysk bibleteekformaat en is ûntworpen om te brûken op STM32 mikrocontrollers basearre op de ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 en ARM® Cortex®-M7 arsjitektuer.
It is boud boppe op STM32Cube-softwaretechnology om portabiliteit oer ferskate STM32-mikrocontrollers makliker te meitsjen.
De software komt mei sample ymplemintaasje rint op X-NUCLEO-IKS4A1 of X-NUCLEO-IKS01A3 útwreiding board op in NUCLEO-F401RE, NUCLEO-U575ZI-Q of NUCLEO-L152RE ûntwikkeling board.
Acronyms en ôfkoartings
Tabel 1. List fan akronyms
| Acronym | Beskriuwing |
| API | Applikaasje programmearring ynterface |
| BSP | Board stipe pakket |
| GUI | Grafyske brûkersynterface |
| HAL | Hardware abstraksje laach |
| IDE | Yntegreare ûntwikkelingsomjouwing |
MotionFD middleware bibleteek yn X-CUBE-MEMS1 software útwreiding foar STM32Cube
2.1 MotionFD oerview
De MotionFD-bibleteek wreidet de funksjonaliteit fan 'e X-CUBE-MEMS1-software út.
De bibleteek krijt gegevens fan 'e accelerometer en druksensor en jout ynformaasje oer it fallevenemint fan 'e brûker basearre op gegevens fan in apparaat.
De bibleteek is allinich ûntwurpen foar ST MEMS. Funksjonaliteit en prestaasjes by it brûken fan oare MEMS-sensors wurde net analysearre en kinne signifikant ferskille fan wat beskreaun yn it dokumint.
Sample ymplemintaasje is beskikber foar de X-NUCLEO-IKS4A1 en X-NUCLEO-IKS01A3 útwreiding board, fêstmakke op in NUCLEO-F401RE, NUCLEO-U575ZI-Q of NUCLEO-L152RE ûntwikkeling board.
2.2 MotionFD bibleteek
Technyske ynformaasje dy't de funksjes en parameters fan 'e MotionFD API's folslein beskriuwt, is te finen yn 'e MotionFD_Package.chm kompilearre HTML file leit yn de dokumintaasje map.
2.2.1 MotionFD bibleteek beskriuwing
De MotionFD falldeteksjebibleteek beheart de gegevens dy't krigen binne fan 'e accelerometer en druksensor; it hat:
- mooglikheid om te ûnderskieden oft de brûker falle barde of net
- erkenning basearre allinnich op accelerometer en druk sensor gegevens
- fereaske accelerometer en druk sensor gegevens sampling frekwinsje is 25 Hz
- boarne easken:
- Cortex-M3: 3.6 kB koade en 3.2 kB gegevensûnthâld
- Cortex-M33: 3.4 kB koade en 3.2 kB gegevensûnthâld
- Cortex-M4: 3.4 kB koade en 3.2 kB gegevensûnthâld
- Cortex-M7: 3.4 kB fan koade en 3.2 fan gegevens ûnthâld - beskikber foar ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 en ARM Cortex-M7 arsjitektuer
2.2.2 MotionFD APIs
De MotionFD-bibleteek API's binne:
- uint8_t MotionFD_GetLibVersion(char *ferzje)
- helje de biblioteekferzje op
- *ferzje is in oanwizer nei in array fan 35 tekens
- jout it oantal karakters werom yn 'e ferzjestring - void MotionFD_Initialize(void)
- fiert inisjalisaasje fan MotionFD-biblioteek en opset fan it ynterne meganisme
Noat: Dizze funksje moat oproppen wurde foardat de faldeteksjebibleteek brûkt wurdt en de CRC-module yn 'e STM32 mikrocontroller (yn RCC perifeare klok ynskeakelje register) moat ynskeakele wurde.
- void MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
- fiert faldeteksjealgoritme út
- * data_in parameter is in oanwizer nei in struktuer mei ynfier gegevens
- de parameters foar it struktuertype MFD_input_t binne:
◦ AccX is de wearde fan de accelerometersensor yn X-as yn mg
◦ AccY is de wearde fan de accelerometersensor yn Y-as yn mg
◦ AccZ is de wearde fan de accelerometersensor yn Z-as yn mg
◦ Druk is de wearde fan de druksensor yn hPa
– *data_out parameter is in oanwizer nei in enum mei de folgjende items:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
- stelt biblioteekkonfiguraasjeparameters yn
- fall_threshold fersnellingsdrompel yn mg
- fall_altitude_delta hichteferskil yn cm
- lizze tiid yn sekonden sûnder beweging nei in ynfloed - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
- krijt biblioteekkonfiguraasjeparameters
- fall_threshold fersnellingsdrompel yn mg
- fall_altitude_delta hichteferskil yn cm
- lizze tiid yn sekonden sûnder beweging nei in ynfloed
2.2.3 API flow chart
2.2.4 Demo koade
De folgjende demonstraasjekoade lêst gegevens fan 'e accelerometer en druksensor en krijt de falleventskoade.
2.2.5 Algoritme prestaasjes
It faldeteksjealgoritme brûkt allinich gegevens fan 'e accelerometer en druksensor en rint op in lege frekwinsje (25 Hz) om enerzjyferbrûk te ferminderjen.
2.3 Sample applikaasje
De MotionFD-middleware kin maklik manipulearre wurde om brûkersapplikaasjes te bouwen; asampDe applikaasje wurdt levere yn 'e applikaasje map.
It is ûntworpen om te rinnen op in NUCLEO-F401RE, NUCLEO-U575ZI-Q of NUCLEO-L152RE ûntwikkeling board ferbûn mei in X-NUCLEO-IKS4A1 of X-NUCLEO-IKS01A3 útwreidingsplan.
De applikaasje herkent it fallevenemint fan 'e brûker yn realtime.
De boppesteande figuer toant de brûker knop B1 en de trije LED's fan it NUCLEO-F401RE board. Sadree't it bestjoer wurdt powered, LED LD3 (PWR) ON.
In USB-kabelferbining is nedich om realtime gegevens te kontrolearjen. It bestjoer wurdt oandreaun troch de PC fia USB ferbining. Dit wurk modus lit de ûntdutsen brûker falle evenemint, accelerometer en druk sensor data, tiid stamp en úteinlik oare sensorgegevens, yn real-time, mei it MEMS-Studio.
2.4 MEMS-Studio applikaasje
De sample applikaasje brûkt MEMS-Studio applikaasje, dat kin wurde ynladen fan www.st.com.
Stap 1. Soargje derfoar dat de nedige bestjoerders binne ynstalleare en it STM32 Nucleo-boerd mei passende útwreidingsboerd is ferbûn mei de PC.
Stap 2. Starte de MEMS-Studio-applikaasje om it haadapplikaasjefinster te iepenjen.
As in STM32 Nucleo-boerd mei stipe firmware is ferbûn mei de PC, wurdt it automatysk ûntdutsen.
Druk op de knop [Ferbine] om ferbining te meitsjen mei it evaluaasjeboerd.
Stap 3. As ferbûn mei in STM32 Nucleo board mei stipe firmware [Bibliotheek Evaluaasje] ljepper wurdt iepene.
Om gegevensstreaming te begjinnen en te stopjen, skeakelje de passende [Start] 
of [Stopje] 
knop op 'e bûtenste fertikale arkbalke.
De gegevens dy't komme fan 'e ferbûne sensor kinne wêze viewed selektearjen de ljepper [Data Tabel] op de binnenste fertikale ark ba
Stap 4. Klikje op de [Fall Detection] om it tawijd applikaasjefinster te iepenjen.
Stap 5. Klikje op de [Bewarje nei File] om it konfiguraasjefinster foar dataloging te iepenjen. Selektearje de sensor en falldetection gegevens wurde bewarre yn de file. Jo kinne opslaan begjinne of stopje troch te klikken op de byhearrende knop.
Stap 6. Gegevensynjeksjemodus kin brûkt wurde om de earder krigen gegevens nei de bibleteek te stjoeren en it resultaat te ûntfangen. Selektearje de ljepper [Data-ynjeksje] op 'e fertikale arkbalke om de tawijde te iepenjen view foar dizze funksjonaliteit.
Stap 7. Klikje op de knop [Blêdzje] om de file mei de earder opnommen gegevens yn CSV-formaat.
De gegevens wurde laden yn 'e tabel yn' e aktuele view.
Oare knoppen wurde aktyf. Jo kinne klikke op:
- Knop [Offline modus] om de firmware offline modus oan/út te skeakeljen (modus mei de earder fêstleine gegevens).
- Knoppen [Start]/[Stopje]/[Stap]/[Werhelje] om de gegevensfeed fan MEMS-Studio nei de bibleteek te kontrolearjen.
2.5 Referinsjes
Alle folgjende boarnen binne frij beskikber op www.st.com.
- UM1859: Te begjinnen mei de X-CUBE-MEMS1 beweging MEMS en miljeu sensor software útwreiding foar STM32Cube
- UM1724: STM32 Nucleo-64 boards (MB1136)
- UM3233: Te begjinnen mei MEMS-Studio
Revision skiednis
Tabel 4. Document revyzje skiednis
| Datum | Ferzje | Feroarings |
| 22-Sep-2017 | 1 | Inisjele release. |
| 6 febrewaris 18 | 2 | Added ferwizings nei NUCLEO-L152RE ûntwikkeling board en tabel 2. Ferline tiid (μs) algoritme. |
| 21-Mar-18 | 3 | Updated Ynlieding en Seksje 2.1 MotionFD oerview. |
| 19 febrewaris 19 | 4 | Updated tabel 2. Ferline tiid (μs) algoritme en figuer 2. STM32 Nucleo: LEDs, knop, jumper. Added X-NUCLEO-IKS01A3 útwreiding board komptabiliteit ynformaasje. |
| 17-Sep-24 | 5 | Updated Seksje Ynlieding, Seksje 2.1: MotionFD oerview, Seksje 2.2.1: MotionFD bibleteek beskriuwing, Seksje 2.2.2: MotionFD APIs, Seksje 2.2.5: Algoritme prestaasjes, Seksje 2.3: Sample applikaasje, Seksje 2.4: MEMS-Studio applikaasje |
WICHTICH NOTICE - LÊS FERGESE
STMicroelectronics NV en har dochterûndernimmingen ("ST") behâlde it rjocht foar om feroarings, korreksjes, ferbetterings, oanpassings en ferbetterings oan ST-produkten en / of oan dit dokumint op elk momint sûnder notice te meitsjen. Keapers moatte de lêste relevante ynformaasje krije oer ST-produkten foardat se oarders pleatse. ST-produkten wurde ferkocht yn oerienstimming mei ST's ferkeapbetingsten en -betingsten yn plak op it momint fan bestellingserkenning.
Keapers binne allinich ferantwurdlik foar de kar, seleksje en gebrûk fan ST-produkten en ST nimt gjin oanspraaklikens oan foar help by oanfraach of it ûntwerp fan produkten fan keapers.
Gjin lisinsje, útdruklik of ymplisearre, foar in yntellektueel eigendomsrjocht wurdt hjiryn ferliend troch ST.
Wederferkeap fan ST-produkten mei bepalingen dy't ferskille fan 'e ynformaasje dy't hjiryn oanjûn binne, sil gjin garânsje ferliend troch ST foar sa'n produkt ûnjildich meitsje.
ST en it ST-logo binne hannelsmerken fan ST. Foar oanfoljende ynformaasje oer ST hannelsmerken, ferwize nei www.st.com/trademarks. Alle oare nammen fan produkten of tsjinsten binne it eigendom fan har respektive eigners.
Ynformaasje yn dit dokumint ferfangt en ferfangt ynformaasje earder levere yn alle eardere ferzjes fan dit dokumint.
© 2024 STMicroelectronics - Alle rjochten foarbehâlden
Dokuminten / Resources
 |
ST X-CUBE-MEMS1 MotionFD Real Time Fall Detection Library [pdf] Brûkershânlieding X-CUBE-MEMS1 MotionFD Real Time Fall Detection Library, X-CUBE-MEMS1, MotionFD Real Time Fall Detection Library, Real Time Fall Detection Library, Fall Detection Library, Detection Library, Library |
