UM2275
Gebruikershandleiding
Aan die gang met MotionFD intydse valbespeuringsbiblioteek in X-CUBE-MEMS1-uitbreiding vir STM32Cube
Inleiding
Die MotionEC is 'n middelware-biblioteekkomponent van die X-CUBE-MEMS1-sagteware en loop op STM3z2. Dit verskaf intydse inligting oor die toestel se oriëntasie en bewegingstatus gebaseer op data vanaf 'n toestel.
Dit verskaf die volgende uitsette: toesteloriëntasie (quaternions, Euler-hoeke), toestelrotasie (virtuele giroskoopfunksionaliteit), swaartekragvektor en lineêre versnelling.
Hierdie biblioteek is bedoel om slegs met ST MEMS te werk.
Die algoritme word in statiese biblioteekformaat verskaf en is ontwerp om gebruik te word op STM32 mikrobeheerders gebaseer op die ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 en ARM® Cortex®-M7-argitekture.
Dit is bo-op STM32Cube-sagtewaretegnologie gebou om oordraagbaarheid oor verskillende STM32-mikrobeheerders te vergemaklik.
Die sagteware kom met sample implementering loop op X-NUCLEO-IKS4A1 of X-NUCLEO-IKS01A3 uitbreidingsbord op 'n NUCLEO-F401RE, NUCLEO-U575ZI-Q of NUCLEO-L152RE ontwikkelingsbord.
Akronieme en afkortings
Tabel 1. Lys van akronieme
| Akroniem | Beskrywing |
| API | Toepassingsprogrammeringskoppelvlak |
| BSP | Raadsondersteuningspakket |
| GUI | Grafiese gebruikerskoppelvlak |
| HAL | Hardeware-abstraksie-laag |
| IDE | Geïntegreerde ontwikkelings omgewing |
MotionFD middelware-biblioteek in X-CUBE-MEMS1 sagteware-uitbreiding vir STM32Cube
2.1 MotionFD verbyview
Die MotionFD-biblioteek brei die funksionaliteit van die X-CUBE-MEMS1-sagteware uit.
Die biblioteek verkry data van die versnellingsmeter en druksensor en verskaf inligting oor die gebruikervalgebeurtenis gebaseer op data van 'n toestel.
Die biblioteek is slegs vir ST MEMS ontwerp. Funksionaliteit en werkverrigting wanneer ander MEMS-sensors gebruik word, word nie ontleed nie en kan aansienlik verskil van wat in die dokument beskryf word.
Sample implementering is beskikbaar vir die X-NUCLEO-IKS4A1 en X-NUCLEO-IKS01A3 uitbreidingsbord, gemonteer op 'n NUCLEO-F401RE, NUCLEO-U575ZI-Q of NUCLEO-L152RE ontwikkelingsbord.
2.2 MotionFD-biblioteek
Tegniese inligting wat die funksies en parameters van die MotionFD API's volledig beskryf, kan gevind word in die MotionFD_Package.chm saamgestelde HTML file geleë in die Documentation-lêergids.
2.2.1 MotionFD-biblioteekbeskrywing
Die MotionFD-valbespeuringsbiblioteek bestuur die data wat van die versnellingsmeter en druksensor verkry word; dit bevat:
- moontlikheid om te onderskei of die gebruikerval plaasgevind het of nie
- herkenning slegs gebaseer op versnellingsmeter- en druksensordata
- vereiste versnellingsmeter en druksensor data sampling frekwensie is 25 Hz
- hulpbronne vereistes:
– Cortex-M3: 3.6 kB kode en 3.2 kB datageheue
– Cortex-M33: 3.4 kB kode en 3.2 kB datageheue
– Cortex-M4: 3.4 kB kode en 3.2 kB datageheue
– Cortex-M7: 3.4 kB kode en 3.2 datageheue - beskikbaar vir ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 en ARM Cortex-M7 argitekture
2.2.2 MotionFD API's
Die MotionFD biblioteek API's is:
- uint8_t MotionFD_GetLibVersion(char *weergawe)
– haal die biblioteekweergawe op
– *weergawe is 'n wyser na 'n skikking van 35 karakters
– gee die aantal karakters in die weergawestring terug - void MotionFD_Initialize(void)
- voer MotionFD biblioteek inisialisering en opstelling van die interne meganisme uit
Let wel: Hierdie funksie moet geroep word voordat die valbespeuringsbiblioteek gebruik word en die CRC-module in die STM32-mikrobeheerder (in RCC perifere klokaktiveerregister) moet geaktiveer word.
- void MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
- voer valbespeuringsalgoritme uit
– *data_in parameter is 'n wyser na 'n struktuur met invoerdata
– die parameters vir die struktuurtipe MFD_input_t is:
◦ AccX is die versnellingsmetersensorwaarde in X-as in mg
◦ AccY is die versnellingsmetersensorwaarde in Y-as in mg
◦ AccZ is die versnellingsmetersensorwaarde in Z-as in mg
◦ Druk is die druksensorwaarde in hPa
– *data_out parameter is 'n wyser na 'n opsomming met die volgende items:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
- stel biblioteekkonfigurasieparameters in
– val_drempel versnellingsdrempel in mg
– val_hoogte_delta hoogte verskil in cm
– lêtyd in sekondes sonder beweging na 'n impak - void MotionFD_GetKnobs(float *val_drempel, int32_t *val_hoogte_delta, dryf *leegtyd)
– kry biblioteekkonfigurasieparameters
– val_drempel versnellingsdrempel in mg
– val_hoogte_delta hoogte verskil in cm
– lêtyd in sekondes sonder beweging na 'n impak
2.2.3 API-vloeidiagram
2.2.4 Demo-kode
Die volgende demonstrasiekode lees data van die versnellingsmeter en druksensor en kry die valgebeurteniskode.
2.2.5 Algoritmeprestasie
Die valbespeuringsalgoritme gebruik slegs data van die versnellingsmeter en druksensor en loop teen 'n lae frekwensie (25 Hz) om kragverbruik te verminder.
2.3 Sample aansoek
Die MotionFD-middelware kan maklik gemanipuleer word om gebruikerstoepassings te bou; asampDie toepassing word in die toepassingslêergids verskaf.
Dit is ontwerp om te loop op 'n NUCLEO-F401RE, NUCLEO-U575ZI-Q of NUCLEO-L152RE ontwikkelingsbord wat gekoppel is aan 'n X-NUCLEO-IKS4A1 of X-NUCLEO-IKS01A3 uitbreidingsbord.
Die toepassing herken die gebruikervalgebeurtenis intyds.
Die figuur hierbo toon die gebruikerknoppie B1 en die drie LED's van die NUCLEO-F401RE-bord. Sodra die bord aangedryf is, skakel LED LD3 (PWR) AAN.
'n USB-kabelverbinding word benodig om intydse data te monitor. Die bord word aangedryf deur die rekenaar via USB-verbinding. Hierdie werkmodus laat die bespeurde gebruikervalgebeurtenis, versnellingsmeter en druksensordata, tyd stamp en uiteindelik ander sensordata, intyds, met behulp van die MEMS-Studio.
2.4 MEMS-Studio-toepassing
Die sample toepassing gebruik MEMS-Studio toepassing, wat afgelaai kan word vanaf www.st.com.
Stap 1. Maak seker dat die nodige drywers geïnstalleer is en dat die STM32 Nucleo-bord met toepaslike uitbreidingsbord aan die rekenaar gekoppel is.
Stap 2. Begin die MEMS-Studio-toepassing om die hooftoepassingsvenster oop te maak.
As 'n STM32 Nucleo-bord met ondersteunde firmware aan die rekenaar gekoppel is, word dit outomaties bespeur.
Druk die [Connect]-knoppie om verbinding met die evalueringsbord te bewerkstellig.
Stap 3. Wanneer gekoppel aan 'n STM32 Nucleo-bord met ondersteunde firmware, word [Biblioteek-evaluering]-oortjie oopgemaak.
Om datastroom te begin en te stop, skakel die toepaslike [Begin] 
of [Stop] 
knoppie op die buitenste vertikale nutsbalk.
Die data wat van die gekoppelde sensor kom, kan wees viewed kies die [Datatabel]-oortjie op die binneste vertikale nutsding ba
Stap 4. Klik op die [Valopsporing] om die toegewyde toepassingsvenster oop te maak.
Stap 5. Klik op die [Save To File] om die datalogering-konfigurasievenster oop te maak. Kies die sensor en valbespeuringsdata wat gestoor moet word in die file. U kan stoor begin of stop deur op die ooreenstemmende knoppie te klik.
Stap 6. Data-inspuitmodus kan gebruik word om die voorheen verkry data na die biblioteek te stuur en die resultaat te ontvang. Kies die [Data-inspuiting]-oortjie op die vertikale nutsbalk om die toegewyde oop te maak view vir hierdie funksionaliteit.
Stap 7. Klik op die [Blaai]-knoppie om die file met die voorheen vasgelê data in CSV-formaat.
Die data sal in die huidige in die tabel gelaai word view.
Ander knoppies sal aktief word. Jy kan klik op:
– [Vanlynmodus]-knoppie om die firmware-aflynmodus aan/af te skakel (modus wat die voorheen vasgelê data gebruik).
– [Begin]/[Stop]/[Stap]/[Herhaal]-knoppies om die datatoevoer vanaf MEMS-Studio na die biblioteek te beheer.
2.5 Verwysings
Al die volgende hulpbronne is vrylik beskikbaar op www.st.com.
- UM1859: Aan die gang met die X-CUBE-MEMS1 beweging MEMS en omgewingsensor sagteware uitbreiding vir STM32Cube
- UM1724: STM32 Nucleo-64-borde (MB1136)
- UM3233: Aan die gang met MEMS-Studio
Hersieningsgeskiedenis
Tabel 4. Dokumenthersieningsgeskiedenis
| Datum | Weergawe | Veranderinge |
| 22-Sep-2017 | 1 | Aanvanklike vrystelling. |
| 6-18 Feb | 2 | Bygevoeg verwysings na NUCLEO-L152RE ontwikkelingsbord en Tabel 2. Verstreke tyd (μs) algoritme. |
| 21-Mrt-18 | 3 | Opgedateerde inleiding en afdeling 2.1 MotionFD verbyview. |
| 19-19 Feb | 4 | Opgedateer Tabel 2. Verstreke tyd (μs) algoritme en Figuur 2. STM32 Nucleo: LED's, knoppie, jumper. Bygevoeg X-NUCLEO-IKS01A3 uitbreiding bord verenigbaarheid inligting. |
| 17-Sep-24 | 5 | Opgedateerde Afdeling Inleiding, Afdeling 2.1: MotionFD verbyview, Afdeling 2.2.1: MotionFD-biblioteekbeskrywing, Afdeling 2.2.2: MotionFD API's, Afdeling 2.2.5: Algoritmeprestasie, Afdeling 2.3: Sample aansoek, Afdeling 2.4: MEMS-Studio aansoek |
BELANGRIKE KENNISGEWING – LEES SORGVULDIG
STMicroelectronics NV en sy filiale (“ST”) behou die reg voor om enige tyd sonder kennisgewing veranderinge, regstellings, verbeterings, wysigings en verbeterings aan ST-produkte en/of hierdie dokument aan te bring. Kopers moet die nuutste relevante inligting oor ST-produkte bekom voordat hulle bestellings plaas. ST-produkte word verkoop ingevolge ST se verkoopsbepalings en -voorwaardes wat ten tyde van bestellingserkenning in plek is.
Kopers is alleen verantwoordelik vir die keuse, seleksie en gebruik van ST-produkte en ST aanvaar geen aanspreeklikheid vir aansoekbystand of die ontwerp van kopers se produkte nie.
Geen lisensie, uitdruklik of geïmpliseer, tot enige intellektuele eiendomsreg word hierin deur ST toegestaan nie.
Herverkoop van ST-produkte met bepalings anders as die inligting wat hierin uiteengesit word, sal enige waarborg wat deur ST vir sodanige produk verleen word, nietig verklaar.
ST en die ST-logo is handelsmerke van ST. Vir bykomende inligting oor ST-handelsmerke, verwys na www.st.com/handelsmerke. Alle ander produk- of diensname is die eiendom van hul onderskeie eienaars.
Inligting in hierdie dokument vervang en vervang inligting wat voorheen in enige vorige weergawes van hierdie dokument verskaf is.
© 2024 STMicroelectronics – Alle regte voorbehou
Dokumente / Hulpbronne
 |
ST X-CUBE-MEMS1 MotionFD Real Time Fall Detection Library [pdfGebruikershandleiding 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, Biblioteek |
