UM2275
Manuali i përdorimit
Fillimi me bibliotekën e zbulimit të rënies në kohë reale MotionFD në zgjerimin X-CUBE-MEMS1 për STM32Cube
Hyrje
MotionEC është një komponent i bibliotekës së softuerit X-CUBE-MEMS1 dhe funksionon në STM3z2. Ai siguron informacion në kohë reale për orientimin e pajisjes dhe statusin e lëvizjes bazuar në të dhënat nga një pajisje.
Ai siguron rezultatet e mëposhtme: orientimin e pajisjes (katernionet, këndet e Euler), rrotullimin e pajisjes (funksionaliteti i xhiroskopit virtual), vektori i gravitetit dhe nxitimi linear.
Kjo bibliotekë ka për qëllim të punojë vetëm me ST MEMS.
Algoritmi ofrohet në formatin statik të bibliotekës dhe është projektuar për t'u përdorur në mikrokontrolluesit STM32 bazuar në ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 dhe ARM® Arkitekturat Cortex®-M7.
Është ndërtuar mbi teknologjinë e softuerit STM32Cube për të lehtësuar transportueshmërinë nëpër mikrokontrollues të ndryshëm STM32.
Softueri vjen me sampimplementimi që funksionon në bordin e zgjerimit X-NUCLEO-IKS4A1 ose X-NUCLEO-IKS01A3 në një tabelë zhvillimi NUCLEO-F401RE, NUCLEO-U575ZI-Q ose NUCLEO-L152RE.
Shkurtesat dhe shkurtesat
Tabela 1. Lista e shkurtesave
| Akronimi | Përshkrimi |
| API | Ndërfaqja e programimit të aplikacionit |
| BSP | Paketa mbështetëse e bordit |
| GUI | Ndërfaqja grafike e përdoruesit |
| HAL | Shtresa e abstraksionit të harduerit |
| IDE | Mjedisi i integruar i zhvillimit |
Biblioteka e softuerit të ndërmjetëm MotionFD në zgjerimin e softuerit X-CUBE-MEMS1 për STM32Cube
2.1 MotionFD ka përfunduarview
Biblioteka MotionFD zgjeron funksionalitetin e softuerit X-CUBE-MEMS1.
Biblioteka merr të dhëna nga përshpejtuesi dhe sensori i presionit dhe ofron informacion në lidhje me ngjarjen e rënies së përdoruesit bazuar në të dhënat nga një pajisje.
Biblioteka është krijuar vetëm për ST MEMS. Funksionaliteti dhe performanca kur përdoren sensorë të tjerë MEMS nuk analizohen dhe mund të jenë dukshëm të ndryshme nga ato që përshkruhen në dokument.
SampImplementimi është i disponueshëm për bordin e zgjerimit X-NUCLEO-IKS4A1 dhe X-NUCLEO-IKS01A3, të montuar në një tabelë zhvillimi NUCLEO-F401RE, NUCLEO-U575ZI-Q ose NUCLEO-L152RE.
2.2 Biblioteka MotionFD
Informacioni teknik që përshkruan plotësisht funksionet dhe parametrat e API-ve MotionFD mund të gjendet në HTML-në e përpiluar nga MotionFD_Package.chm file ndodhet në dosjen Documentation.
2.2.1 Përshkrimi i bibliotekës MotionFD
Biblioteka e zbulimit të rënies MotionFD menaxhon të dhënat e marra nga përshpejtuesi dhe sensori i presionit; ajo përmban:
- mundësia për të dalluar nëse rënia e përdoruesit ka ndodhur apo jo
- njohja e bazuar vetëm në të dhënat e akselerometrit dhe sensorit të presionit
- Të dhënat e kërkuara të akselerometrit dhe sensorit të presionit sampFrekuenca e lidhjes është 25 Hz
- kërkesat për burime:
– Cortex-M3: 3.6 kB kod dhe 3.2 kB memorie të dhënash
– Cortex-M33: 3.4 kB kod dhe 3.2 kB memorie të dhënash
– Cortex-M4: 3.4 kB kod dhe 3.2 kB memorie të dhënash
– Cortex-M7: 3.4 kB kod dhe 3.2 memorie të dhënash - në dispozicion për arkitekturat ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 dhe ARM Cortex-M7
2.2.2 API-të MotionFD
API-të e bibliotekës MotionFD janë:
- uint8_t MotionFD_GetLibVersion (char *version)
– merr versionin e bibliotekës
– *versioni është një tregues për një grup prej 35 karakteresh
– kthen numrin e karaktereve në vargun e versionit - void MotionFD_Initialize(void)
– kryen inicializimin e bibliotekës MotionFD dhe konfigurimin e mekanizmit të brendshëm
Shënim: Ky funksion duhet të thirret përpara se të përdorni bibliotekën e zbulimit të rënies dhe duhet të aktivizohet moduli CRC në mikrokontrolluesin STM32 (në regjistrin e aktivizimit të orës periferike RCC).
- Void MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
– ekzekuton algoritmin e zbulimit të rënies
– Parametri *data_in është një tregues drejt një strukture me të dhëna hyrëse
– parametrat për llojin e strukturës MFD_input_t janë:
◦ AccX është vlera e sensorit të përshpejtuesit në boshtin X në mg
◦ AccY është vlera e sensorit të përshpejtuesit në boshtin Y në mg
◦ AccZ është vlera e sensorit të përshpejtuesit në boshtin Z në mg
◦ Press është vlera e sensorit të presionit në hPa
– Parametri *data_out është një tregues në një numër me artikujt e mëposhtëm:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs (float fall_threshold, int32_t fall_altitude_delta, float lying_time)
– vendos parametrat e konfigurimit të bibliotekës
– pragu i nxitimit të pragut të rënies në mg
– rënie_lartësi_delta diferencë lartësie në cm
– koha e shtrirjes në sekonda pa lëvizje pas një goditjeje - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
– merr parametrat e konfigurimit të bibliotekës
– pragu i nxitimit të pragut të rënies në mg
– rënie_lartësi_delta diferencë lartësie në cm
– koha e shtrirjes në sekonda pa lëvizje pas një goditjeje
2.2.3 Grafiku i rrjedhës së API
2.2.4 Kodi demo
Kodi i mëposhtëm i demonstrimit lexon të dhënat nga sensori i përshpejtuesit dhe presionit dhe merr kodin e ngjarjes së rënies.
2.2.5 Performanca e algoritmit
Algoritmi i zbulimit të rënies përdor vetëm të dhëna nga përshpejtuesi dhe sensori i presionit dhe funksionon në një frekuencë të ulët (25 Hz) për të reduktuar konsumin e energjisë.
2.3 Sampaplikimi
Softueri i mesëm MotionFD mund të manipulohet lehtësisht për të ndërtuar aplikacione të përdoruesve; siampaplikacioni ofrohet në dosjen Application.
Është projektuar të funksionojë në një tabelë zhvillimi NUCLEO-F401RE, NUCLEO-U575ZI-Q ose NUCLEO-L152RE të lidhur me një tabelë zgjerimi X-NUCLEO-IKS4A1 ose X-NUCLEO-IKS01A3.
Aplikacioni njeh ngjarjen e rënies së përdoruesit në kohë reale.
Figura e mësipërme tregon butonin e përdoruesit B1 dhe tre LED të tabelës NUCLEO-F401RE. Pasi të ndizet bordi, LED LD3 (PWR) ndizet.
Kërkohet një lidhje me kabllo USB për të monitoruar të dhënat në kohë reale. Pllaka mundësohet nga PC nëpërmjet lidhjes USB. Ky modalitet pune lejon ngjarjen e zbuluar të rënies së përdoruesit, të dhënat e sensorit të përshpejtuesit dhe presionit, kohën stamp dhe përfundimisht të dhëna të tjera të sensorëve, në kohë reale, duke përdorur MEMS-Studio.
2.4 Aplikacioni MEMS-Studio
Sampaplikacioni përdor aplikacionin MEMS-Studio, i cili mund të shkarkohet nga www.st.com.
Hapi 1. Sigurohuni që të instalohen drejtuesit e nevojshëm dhe që tabela STM32 Nucleo me tabelën e duhur të zgjerimit të jetë e lidhur me kompjuterin.
Hapi 2. Hapni aplikacionin MEMS-Studio për të hapur dritaren kryesore të aplikacionit.
Nëse një bord STM32 Nucleo me firmware të mbështetur është i lidhur me kompjuterin, ai zbulohet automatikisht.
Shtypni butonin [Connect] për të vendosur lidhjen me bordin e vlerësimit.
Hapi 3. Kur lidhet me një tabelë STM32 Nucleo me firmware të mbështetur, hapet skeda [Vlerësimi i Bibliotekës].
Për të nisur dhe ndaluar transmetimin e të dhënave, ndërroni [Fillimin] e duhur 
ose [Stop] 
butonin në shiritin e jashtëm vertikal të veglave.
Të dhënat që vijnë nga sensori i lidhur mund të jenë viewed duke zgjedhur skedën [Data Table] në veglën e brendshme vertikale ba
Hapi 4. Klikoni në [Fall Detection] për të hapur dritaren e dedikuar të aplikacionit.
Hapi 5. Klikoni në [Save To File] për të hapur dritaren e konfigurimit të të dhënave. Zgjidhni sensorin dhe të dhënat e zbulimit të rënies që do të ruhen në file. Mund të filloni ose ndaloni ruajtjen duke klikuar në butonin përkatës.
Hapi 6. Modaliteti i injektimit të të dhënave mund të përdoret për të dërguar të dhënat e marra më parë në bibliotekë dhe për të marrë rezultatin. Zgjidhni skedën [Data Injection] në shiritin vertikal të veglave për të hapur dedikuar view për këtë funksionalitet.
Hapi 7. Klikoni në butonin [Shfleto] për të zgjedhur file me të dhënat e kapura më parë në formatin CSV.
Të dhënat do të ngarkohen në tabelë në rrymën view.
Butonat e tjerë do të bëhen aktivë. Mund të klikoni në:
– Butoni [Offline Mode] për të ndezur/fikur modalitetin offline të firmuerit (modaliteti që përdor të dhënat e kapura më parë).
– Butonat [Start]/[Stop]/[Step]/[Repeat] për të kontrolluar furnizimin e të dhënave nga MEMS-Studio në bibliotekë.
2.5 Referenca
Të gjitha burimet e mëposhtme janë të disponueshme falas në www.st.com.
- UM1859: Fillimi me zgjerimin MEMS të lëvizjes X-CUBE-MEMS1 dhe sensorin mjedisor për STM32Cube
- UM1724: Pllakat STM32 Nucleo-64 (MB1136)
- UM3233: Fillimi me MEMS-Studio
Historia e rishikimit
Tabela 4. Historia e rishikimit të dokumentit
| Data | Versioni | Ndryshimet |
| 22-shtator-2017 | 1 | Lëshimi fillestar. |
| 6-shkurt-18 | 2 | Referenca të shtuara në bordin e zhvillimit NUCLEO-L152RE dhe Tabelën 2. Algoritmi i kohës së kaluar (μs). |
| 21-Mars-18 | 3 | Hyrja e përditësuar dhe seksioni 2.1 MotionFD përfundoiview. |
| 19-shkurt-19 | 4 | Tabela e përditësuar 2. Algoritmi i kohës së kaluar (μs) dhe Figura 2. Bërthama STM32: LED, butoni, kërcyes. U shtua informacion i përputhshmërisë së pllakës së zgjerimit X-NUCLEO-IKS01A3. |
| 17-shtator-24 | 5 | Hyrja e përditësuar e seksionit, Seksioni 2.1: MotionFD ka përfunduarview, Seksioni 2.2.1: Përshkrimi i bibliotekës MotionFD, Seksioni 2.2.2: API-të e MotionFD, Seksioni 2.2.5: Performanca e algoritmit, Seksioni 2.3: Sampaplikacioni, Seksioni 2.4: Aplikacioni MEMS-Studio |
NJOFTIM I RËNDËSISHËM – LEXO ME KUJDES
STMicroelectronics NV dhe filialet e saj ("ST") rezervojnë të drejtën për të bërë ndryshime, korrigjime, përmirësime, modifikime dhe përmirësime në produktet ST dhe/ose në këtë dokument në çdo kohë pa paralajmërim. Blerësit duhet të marrin informacionin më të fundit përkatës mbi produktet ST përpara se të bëjnë porosi. Produktet ST shiten në përputhje me termat dhe kushtet e shitjes të ST në fuqi në momentin e njohjes së porosisë.
Blerësit janë vetëm përgjegjës për zgjedhjen, përzgjedhjen dhe përdorimin e produkteve ST dhe ST nuk merr asnjë përgjegjësi për asistencën e aplikimit ose dizajnimin e produkteve të blerësve.
Asnjë licencë, e shprehur apo e nënkuptuar, për ndonjë të drejtë të pronësisë intelektuale nuk jepet nga ST këtu.
Rishitja e produkteve ST me dispozita të ndryshme nga informacioni i përcaktuar këtu do të anulojë çdo garanci të dhënë nga ST për këtë produkt.
ST dhe logoja ST janë marka tregtare të ST. Për informacion shtesë rreth markave tregtare ST, referojuni www.st.com/trademarks. Të gjithë emrat e tjerë të produkteve ose shërbimeve janë pronë e pronarëve të tyre përkatës.
Informacioni në këtë dokument zëvendëson dhe zëvendëson informacionin e dhënë më parë në çdo version të mëparshëm të këtij dokumenti.
© 2024 STMicroelectronics – Të gjitha të drejtat e rezervuara
Dokumentet / Burimet
 |
Biblioteka e zbulimit të rënies në kohë reale ST X-CUBE-MEMS1 MotionFD [pdf] Manuali i Përdoruesit Biblioteka e zbulimit të rënies në kohë reale X-CUBE-MEMS1 MotionFD, Biblioteka e zbulimit të rënies në kohë reale, X-CUBE-MEMS1, Biblioteka e zbulimit të rënies në kohë reale, Biblioteka e zbulimit të rënies në kohë reale, biblioteka e zbulimit të rënies, biblioteka e zbulimit, biblioteka |
