ST X-CUBE-MEMS1 MotionFD Manyèl Itilizatè Bibliyotèk deteksyon an tan reyèl

UM2275
Manyèl itilizatè

Kòmanse ak bibliyotèk deteksyon sezon otòn an tan reyèl MotionFD nan ekspansyon X-CUBE-MEMS1 pou STM32Cube

Kontni kache

1 Entwodiksyon

2 Akwonim ak abrevyasyon

3 Bibliyotèk middleware MotionFD nan ekspansyon lojisyèl X-CUBE-MEMS1 pou STM32Cube

4 Dokiman / Resous

4.1 Referans

5 Post ki gen rapò

Entwodiksyon

MotionEC a se yon eleman bibliyotèk middleware nan lojisyèl X-CUBE-MEMS1 ak kouri sou STM3z2. Li bay enfòmasyon an tan reyèl sou oryantasyon aparèy la ak estati mouvman ki baze sou done ki sòti nan yon aparèy.
Li bay rezilta sa yo: oryantasyon aparèy (quaternions, ang Euler), wotasyon aparèy (fonksyonalite jiroskop vityèl), vektè gravite ak akselerasyon lineyè.
Bibliyotèk sa a fèt pou travay avèk ST MEMS sèlman.
Yo bay algorithm nan fòma bibliyotèk estatik epi li fèt pou itilize sou mikrokontwolè STM32 ki baze sou ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 ak ARM®. Achitekti Cortex®-M7.
Li bati sou tèt teknoloji lojisyèl STM32Cube pou fasilite portabilite atravè diferan mikrokontwolè STM32.
Lojisyèl la vini ak sample aplikasyon an kouri sou X-NUCLEO-IKS4A1 oswa X-NUCLEO-IKS01A3 tablo ekspansyon sou yon tablo devlopman NUCLEO-F401RE, NUCLEO-U575ZI-Q oswa NUCLEO-L152RE.

Akwonim ak abrevyasyon

Tablo 1. Lis akwonim yo

Akwonim	Deskripsyon
API	Koòdone pwogram aplikasyon an
BSP	Konsèy sipò pake
entèfas	Koòdone itilizatè grafik
HAL	Materyèl abstraksyon kouch
IDE	Anviwònman devlopman entegre

Bibliyotèk middleware MotionFD nan ekspansyon lojisyèl X-CUBE-MEMS1 pou STM32Cube

2.1 MotionFD finiview
Bibliyotèk MotionFD elaji fonksyonalite lojisyèl X-CUBE-MEMS1 la.
Bibliyotèk la jwenn done ki soti nan akseleromètr la ak Capteur presyon epi li bay enfòmasyon sou evènman tonbe itilizatè a ki baze sou done ki sòti nan yon aparèy.
Bibliyotèk la fèt pou ST MEMS sèlman. Fonksyonalite ak pèfòmans lè w ap itilize lòt detèktè MEMS yo pa analize epi yo ka siyifikativman diferan de sa ki dekri nan dokiman an.
Sampaplikasyon an disponib pou tablo ekspansyon X-NUCLEO-IKS4A1 ak X-NUCLEO-IKS01A3, ki monte sou yon tablo devlopman NUCLEO-F401RE, NUCLEO-U575ZI-Q oswa NUCLEO-L152RE.
2.2 Bibliyotèk MotionFD
Ou ka jwenn enfòmasyon teknik ki dekri nèt fonksyon ak paramèt API MotionFD yo nan HTML konpile MotionFD_Package.chm. file ki sitiye nan Katab Dokimantasyon an.
2.2.1 Deskripsyon bibliyotèk MotionFD
Bibliyotèk deteksyon sezon otòn MotionFD jere done yo akeri nan akseleromèt la ak Capteur presyon; li prezante:

posiblite pou distenge si wi ou non itilizatè a te fèt oswa ou pa
rekonesans ki baze sèlman sou akseleromètr ak done Capteur presyon

obligatwa akseleromètr ak presyon Capteur done sampfrekans ling se 25 Hz
kondisyon resous:
– Cortex-M3: 3.6 kB nan kòd ak 3.2 kB nan memwa done
– Cortex-M33: 3.4 kB nan kòd ak 3.2 kB nan memwa done
– Cortex-M4: 3.4 kB nan kòd ak 3.2 kB nan memwa done
– Cortex-M7: 3.4 kB nan kòd ak 3.2 nan memwa done

disponib pou ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 ak ARM Cortex-M7 achitekti

2.2.2 API MotionFD
API bibliyotèk MotionFD yo se:

uint8_t MotionFD_GetLibVersion(char *vèsyon)
– rekipere vèsyon bibliyotèk la
– *vèsyon se yon konsèy sou yon etalaj 35 karaktè
– retounen kantite karaktè nan kòd vèsyon an
anile MotionFD_Initialize(anile)
– fè inisyalizasyon bibliyotèk MotionFD ak konfigirasyon mekanis entèn la

Nòt: Fonksyon sa a dwe rele anvan ou sèvi ak bibliyotèk deteksyon sezon otòn la ak modil CRC nan mikrokontroleur STM32 la (nan revèy periferik RCC pèmèt enskri) dwe pèmèt.

anile MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
– egzekite algorithm deteksyon tonbe
– *data_in paramèt se yon konsèy sou yon estrikti ki gen done antre
– paramèt yo pou kalite estrikti MFD_input_t yo se:
◦ AccX se valè Capteur akseleromèt la nan aks X an mg
◦ AccY se valè Capteur akseleromètr nan aks Y an mg
◦ AccZ se valè Capteur akseleromètr nan Z aks an mg
◦ Press se valè Capteur presyon an nan hPa
– * paramèt data_out se yon konsèy sou yon enum ak atik sa yo:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1

void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
– mete paramèt konfigirasyon bibliyotèk yo
– Fall_threshold papòt akselerasyon an mg
– Fall_altitude_delta diferans altitid an cm
- tan tan kouche an segonn san mouvman apre yon enpak
void MotionFD_GetKnobs(flote *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
– jwenn paramèt konfigirasyon bibliyotèk yo
– Fall_threshold papòt akselerasyon an mg
– Fall_altitude_delta diferans altitid an cm
- tan tan kouche an segonn san mouvman apre yon enpak

2.2.3 Tablo koule API

2.2.4 Demo kòd
Kòd demonstrasyon sa a li done ki soti nan akseleromètr la ak Capteur presyon epi li jwenn kòd evènman sezon otòn la.

2.2.5 Pèfòmans algorithm
Algorithm deteksyon sezon otòn la sèlman sèvi ak done ki soti nan akseleromètr la ak Capteur presyon ak kouri nan yon frekans ki ba (25 Hz) diminye konsomasyon pouvwa.

2.3 Sample aplikasyon
Ka middleware MotionFD fasil manipile pou konstwi aplikasyon pou itilizatè; kòmampAplikasyon an bay nan katab aplikasyon an.
Li fèt pou kouri sou yon tablo devlopman NUCLEO-F401RE, NUCLEO-U575ZI-Q oswa NUCLEO-L152RE ki konekte ak yon tablo ekspansyon X-NUCLEO-IKS4A1 oswa X-NUCLEO-IKS01A3.
Aplikasyon an rekonèt evènman tonbe itilizatè a an tan reyèl.

Figi ki anwo a montre bouton itilizatè B1 ak twa LED tablo NUCLEO-F401RE. Yon fwa tablo a mache, LED LD3 (PWR) limen.
Yon koneksyon kab USB oblije kontwole done an tan reyèl. Komisyon Konsèy la mache pa PC a atravè koneksyon USB. Mòd k ap travay sa a pèmèt itilizatè a detekte tonbe evènman, akseleromètr ak done Capteur presyon, tan stamp ak evantyèlman lòt done Capteur, an tan reyèl, lè l sèvi avèk MEMS-Studio la.
2.4 Aplikasyon MEMS-Studio
S laampAplikasyon an sèvi ak aplikasyon MEMS-Studio, ki ka telechaje nan www.st.com.
Etap 1. Asire w ke chofè ki nesesè yo enstale epi STM32 Nucleo tablo a ak tablo ekspansyon apwopriye konekte ak PC a.
Etap 2. Lanse aplikasyon MEMS-Studio pou louvri fenèt aplikasyon prensipal la.
Si yon tablo STM32 Nucleo ak firmwèr sipòte konekte ak PC a, li otomatikman detekte.
Peze bouton [Konekte] pou etabli koneksyon ak tablo evalyasyon an.

Etap 3. Lè yo konekte ak yon tablo STM32 Nucleo ak firmwèr sipòte [Evalyasyon bibliyotèk] tab la louvri.
Pou kòmanse epi sispann difizyon done, aktive [Kòmanse] ki apwopriye a. oswa [sispann] bouton sou ba zouti ekstèn vètikal la.
Done ki soti nan Capteur konekte a kapab viewed chwazi tab la [Tablo Done] sou zouti vètikal enteryè ba a

Etap 4. Klike sou [Deteksyon otòn la] pou ouvri fenèt aplikasyon dedye a.

Etap 5. Klike sou [Save To File] pou louvri fennèt konfigirasyon dataloging la. Chwazi Capteur a ak done deteksyon tonbe yo dwe sove nan la file. Ou ka kòmanse oswa sispann ekonomize lè w klike sou bouton ki koresponn lan.

Etap 6. Mòd Piki Done yo ka itilize pou voye done yo te deja pran nan bibliyotèk la epi resevwa rezilta a. Chwazi tab la [Piki Done] sou ba zouti vètikal la pou louvri dedye a view pou fonksyonalite sa a.

Etap 7. Klike sou bouton [Browse] pou chwazi file ak done yo te deja kaptire nan fòma CSV.
Done yo pral chaje nan tablo a nan aktyèl la view.
Lòt bouton ap vin aktif. Ou ka klike sou:
– Bouton [Offline Mode] pou chanje mikrolojisyèl mòd offline limen/desen (mòd ki itilize done yo te deja kaptire).
– Bouton [Kòmanse]/[Stop]/[Etap]/[Repete] pou kontwole done ki soti nan MEMS-Studio nan bibliyotèk la.

2.5 Referans
Tout resous sa yo disponib gratis sou www.st.com.

UM1859: Kòmanse ak MEMS mouvman X-CUBE-MEMS1 ak ekspansyon lojisyèl Capteur anviwònman an pou STM32Cube
UM1724: STM32 Nucleo-64 tablo (MB1136)
UM3233: Kòmanse ak MEMS-Studio

Istwa revizyon

Tablo 4. Istwa revizyon dokiman yo

Dat	Version	Chanjman
22-Sep-2017	1	Premye lage.
6-fevriye-18	2	Te ajoute referans sou tablo devlopman NUCLEO-L152RE ak Tablo 2. Algorithm tan ki pase (μs).
21-Mar-18	3	Mete ajou Entwodiksyon ak Seksyon 2.1 MotionFD souview.
19-fevriye-19	4	Mete ajou Tablo 2. Algorithm tan ki pase (μs) ak Figi 2. STM32 Nucleo: LED, bouton, kavalye. Te ajoute enfòmasyon sou konpatibilite tablo ekspansyon X-NUCLEO-IKS01A3.
17-Sep-24	5	Mete ajou Seksyon Entwodiksyon, Seksyon 2.1: MotionFD finiview, Seksyon 2.2.1: Deskripsyon bibliyotèk MotionFD, Seksyon 2.2.2: API MotionFD, Seksyon 2.2.5: Pèfòmans algorithm, Seksyon 2.3: Sample aplikasyon, Seksyon 2.4: MEMS-Studio aplikasyon

AVI ENPÒTAN – LI AK ATANSYON
STMicroelectronics NV ak filiales li yo ("ST") rezève dwa pou fè chanjman, koreksyon, amelyorasyon, modifikasyon, ak amelyorasyon nan pwodwi ST ak/oswa nan dokiman sa a nenpòt ki lè san avètisman. Achtè yo ta dwe jwenn dènye enfòmasyon enpòtan sou pwodwi ST yo anvan yo mete lòd. Pwodwi ST yo vann daprè tèm ak kondisyon pou vann ST ki an plas nan moman rekonesans lòd la.
Achtè yo se sèl responsab pou chwa, seleksyon, ak itilizasyon pwodwi ST yo epi ST pa sipoze okenn responsablite pou asistans aplikasyon oswa konsepsyon pwodwi achtè yo.
Pa gen okenn lisans, eksprime oswa implicite, sou okenn dwa pwopriyete entelektyèl akòde pa ST nan la a.
Revann pwodwi ST ak dispozisyon ki diferan de enfòmasyon ki endike nan la a pral anile nenpòt garanti ST akòde pou pwodui sa a.
ST ak logo ST a se mak komèsyal ST. Pou plis enfòmasyon sou mak ST, al gade nan www.st.com/trademarks. Tout lòt non pwodwi oswa sèvis yo se pwopriyete pwopriyetè respektif yo.
Enfòmasyon ki nan dokiman sa a ranplase epi ranplase enfòmasyon yo te bay anvan nan nenpòt vèsyon anvan dokiman sa a.

Dokiman / Resous

ST X-CUBE-MEMS1 MotionFD Bibliyotèk deteksyon otòn an tan reyèl [pdfManyèl Itilizatè
X-CUBE-MEMS1 Bibliyotèk deteksyon otòn MotionFD an tan reyèl, X-CUBE-MEMS1, Bibliyotèk deteksyon otòn an tan reyèl MotionFD, bibliyotèk deteksyon otòn an tan reyèl, bibliyotèk deteksyon otòn, bibliyotèk deteksyon, bibliyotèk

Referans

Manyèl itilizatè

Entwodiksyon

Akwonim ak abrevyasyon

Bibliyotèk middleware MotionFD nan ekspansyon lojisyèl X-CUBE-MEMS1 pou STM32Cube

Dokiman / Resous

Referans

Kite yon kòmantè

Anile repons