UM2275
manual user

Di berfirehkirina X-CUBE-MEMS1-ê de ji bo STM32Cube bi pirtûkxaneya tespîtkirina payizê ya rast-a-dem-MotionFD dest pê kirin

Pêşkêş

MotionEC perçeyek pirtûkxaneya navîn a nermalava X-CUBE-MEMS1 e û li ser STM3z2 dimeşe. Ew li ser bingeha daneyên ji amûrekê di derbarê rêgez û rewşa tevgerê de agahdariya rast-ê peyda dike.
Ew derketinên jêrîn peyda dike: arastekirina cîhazê (quaternion, goşeya Euler), zivirîna cîhazê (fonksîyona gyroskopê ya virtual), vektora gravîtasyonê û lezbûna xêzik.
Ev pirtûkxane armanc e ku tenê bi ST MEMS re bixebite.
Algorithm di forma pirtûkxaneya statîk de tête peyda kirin û ji bo ku li ser mîkrokontrolerên STM32-ê li ser bingeha ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 û ARM® were bikar anîn hatî çêkirin. Mîmarên Cortex®-M7.
Ew li ser teknolojiya nermalava STM32Cube hatî çêkirin da ku veguheztina li ser mîkrokontrolerên cihêreng STM32 hêsan bike.
The software tê bi samppêkanîna li ser panelek berfirehkirina X-NUCLEO-IKS4A1 an X-NUCLEO-IKS01A3 li ser panelek pêşkeftinê ya NUCLEO-F401RE, NUCLEO-U575ZI-Q an NUCLEO-L152RE tê xebitandin.

Akronîm û kurtenivîs

Tablo 1. Lîsteya kurtenivîsan

Acronym	Terîf
API	Navbera bernamesaziya serîlêdanê
BSP	Pakêta piştgiriya panelê
GUI	Navrûya bikarhênerê ya grafîkî
HAL	Qata abstraction Hardware
IDE	hawîrdora pêşveçûna yekbûyî

Pirtûkxaneya navîn ya MotionFD di berfirehkirina nermalava X-CUBE-MEMS1 de ji bo STM32Cube

2.1 MotionFD serview
Pirtûkxaneya MotionFD fonksiyona nermalava X-CUBE-MEMS1 berfireh dike.
Pirtûkxane daneyan ji sansorê bilez û zextê werdigire û li ser bingeha daneyên amûrek li ser bûyera ketina bikarhêner agahdarî peyda dike.
Pirtûkxane tenê ji bo ST MEMS hatiye çêkirin. Fonksiyon û performans dema ku senzorên MEMS-ê yên din bikar tînin nayê analîz kirin û dikare ji ya ku di belgeyê de hatî diyar kirin cûda be.
Samppêkanîna le ji bo panela berfirehkirina X-NUCLEO-IKS4A1 û X-NUCLEO-IKS01A3 heye, ku li ser panelek pêşkeftinê NUCLEO-F401RE, NUCLEO-U575ZI-Q an NUCLEO-L152RE hatî çêkirin.
2.2 Pirtûkxaneya MotionFD
Agahdariya teknîkî ya ku bi tevahî fonksiyon û pîvanên API-yên MotionFD-ê vedibêje dikare di HTML-ya berhevkirî ya MotionFD_Package.chm de were dîtin. file di peldanka Belgekirinê de cih digire.
2.2.1 Danasîna pirtûkxaneya MotionFD
Pirtûkxaneya tespîtkirina hilweşînê ya MotionFD daneyên ku ji leza bilez û senzora zextê hatî girtin rêve dibe; ew taybetmendiyên:

• îmkana ferqkirinê ka ketina bikarhêner çêbûye an na
• naskirina tenê li ser bingeha leza sansor û daneya zextê
• Daneyên sansorê leza pîvanê û zextê sampFrekansa lingê 25 Hz e
• pêdiviyên çavkaniyên:
  - Cortex-M3: 3.6 kB kod û 3.2 kB bîra daneyê
  - Cortex-M33: 3.4 kB kod û 3.2 kB bîra daneyê
  - Cortex-M4: 3.4 kB kod û 3.2 kB bîra daneyê
  - Cortex-M7: 3.4 kB kod û 3.2 bîra daneyê
• ji bo mîmariyên ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 û ARM Cortex-M7 hene

2.2.2 MotionFD APIs
API-yên pirtûkxaneya MotionFD ev in:

• uint8_t MotionFD_GetLibVersion(char *guherto)
  - guhertoya pirtûkxaneyê vedigire
  - *Versiyon nîşanek e ku ji 35 tîpan pêk tê
  - hejmara tîpan di rêzika guhertoyê de vedigerîne
• betal MotionFD_Initialize(betal)
  - destpêkirina pirtûkxaneya MotionFD û sazkirina mekanîzmaya navxweyî pêk tîne

Not: Pêdivî ye ku ev fonksiyon berî ku pirtûkxaneya tespîtkirina payizê bikar bîne were bang kirin û pêdivî ye ku modula CRC di mîkrokontrolkera STM32 de (di qeyda demjimêra dorhêlê ya RCC de) were çalak kirin.

• betal MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
  - algorîtmaya tespîtkirina ketinê pêk tîne
  - * Parametreya data_in nîşanek e ku avahiyek bi daneya têketinê ye
  - Parametreyên ji bo celebê strukturê MFD_input_t ev in:
  ◦ AccX nirxa senzorê ya leza mîzê ya di X eksê de bi mg e
  ◦ AccY nirxa senzorê ya lezapîrê ya di eksê Y de bi mg e
  ◦ AccZ nirxa senzorê ya lezevaniyê ya di axa Z de bi mg e
  ◦ Press nirxa sensora zextê ya di hPa de ye
  - * Parametreya data_out nîşanek e ku bi hêmanên jêrîn ve girêdayî ye:
  ◦ MFD_NOFALL = 0
  ◦ MFD_FALL = 1
• void MotionFD_SetKnobs (float fall_threshold, int32_t fall_altitude_delta, float lying_time)
  - Parametreyên veavakirina pirtûkxaneyê destnîşan dike
  - bendava lezbûnê ya payîzê bi mg
  - ferqa bilindahiya payîzê_delta bi cm
  - dema derewan di çirkeyan de bêyî tevgerê piştî bandorê
• void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *Ling_time)
  - Parametreyên veavakirina pirtûkxaneyê digire
  - bendava lezbûnê ya payîzê bi mg
  - ferqa bilindahiya payîzê_delta bi cm
  - dema derewan di çirkeyan de bêyî tevgerê piştî bandorê

2.2.3 Tabloya herikîna API

2.2.4 Koda Demo
Koda xwenîşandanê ya jêrîn daneyan ji sansorê bilez û zextê dixwîne û koda bûyera payîzê digire.

2.2.5 Performansa Algorîtmayê
Algorîtmaya tespîtkirina payîzê tenê daneyên ji leza bilez û senora zextê bikar tîne û bi frekansek nizm (25 Hz) dimeşîne da ku xerckirina hêzê kêm bike.

2.3 Sample sepanê
Navgîniya MotionFD dikare bi hêsanî were manîpule kirin da ku serîlêdanên bikarhêner ava bike; demaample sepanê di peldanka Serlêdanê de tê peyda kirin.
Ew hatî sêwirandin ku li ser panelek pêşkeftinê ya NUCLEO-F401RE, NUCLEO-U575ZI-Q an NUCLEO-L152RE ve girêdayî ye ku bi panelek berfirehkirina X-NUCLEO-IKS4A1 an X-NUCLEO-IKS01A3 ve girêdayî ye.
Serlêdan bûyera ketina bikarhêner di demek rast de nas dike.

Nîgara jorîn bişkoja bikarhêner B1 û sê LED-ên panela NUCLEO-F401RE nîşan dide. Dema ku panel tê hêz kirin, LED LD3 (PWR) vedibe.
Têkiliyek kabloya USB-ê hewce ye ku daneyên rast-dem-ê bişopîne. Destûr ji hêla PC-ê ve bi girêdana USB-ê ve tê hêz kirin. Ev moda xebitandinê rê dide bûyera ketinê ya bikarhênerê hatî tespîtkirin, daneyên sansorê bilez û zextê, ​​dema stamp û di dawiyê de daneyên din ên sensor, di dema rast de, bi karanîna MEMS-Studio.
2.4 Serlêdana MEMS-Studio
The sample sepanê serîlêdana MEMS-Studio bikar tîne, ku dikare jê were dakêşandin www.st.com.
Asta 1ê. Piştrast bikin ku ajokarên pêwîst hatine saz kirin û panela STM32 Nucleo bi panela berfirehkirina guncan re bi PC-yê ve girêdayî ye.
Asta 2ê. Serlêdana MEMS-Studio dest pê bikin da ku pencereya serîlêdanê ya sereke vekin.
Ger panelek STM32 Nucleo ya bi firmware-ya piştgirîkirî bi PC-yê ve girêdayî be, ew bixweber tê tespît kirin.
Bişkojka [Girêdan] bikirtînin da ku girêdana bi panela nirxandinê re saz bikin.

Asta 3ê. Dema ku bi panelek STM32 Nucleo ya bi firmware-ya piştgirîkirî ve girêdayî ye tabloya [Nirxandina Pirtûkxaneyê] tê vekirin.
Ji bo destpêkirin û rawestandina weşana daneyê, ya guncan biguherîne [Destpêk] an [Raweste]   bişkojka li ser bar tool vertical derve.
Daneyên ku ji senzorê ve girêdayî têne dikarin bibin viewed hilbijêre tabloya [Tabloya Daneyên] li ser amûra vertîkal a hundurîn

Asta 4ê. Ji bo vekirina pencereya serîlêdanê ya veqetandî li ser [Tesbîtkirina Fall] bikirtînin.

Asta 5ê. Li ser [Save To File] ji bo vekirina pencereya veavakirina datalogê. Sensor û daneyên tespîtkirina ketinê hilbijêrin ku di nav de bêne tomar kirin file. Hûn dikarin bi tikandina bişkojka têkildar dest bi tomarkirinê bikin an rawestînin.

Asta 6ê. Moda Injection Data dikare were bikar anîn da ku daneyên ku berê hatine bidestxistin ji pirtûkxaneyê re bişînin û encamê bistînin. Li ser barika amûrê ya vertîkal tabloya [Injection Data] hilbijêrin da ku vekêşana veqetandî vekin view ji bo vê fonksiyonê.

Asta 7ê. Bişkojka [Browse] bikirtînin da ku hilbijêrin file bi daneyên berê yên di formata CSV de hatine girtin.
Daneyên di dema niha de dê di tabloyê de werin barkirin view.
Bişkokên din dê çalak bibin. Hûn dikarin li ser bikirtînin:
- Bişkojka [Moda Offline] ji bo guheztina moda negirêdayî ya firmware-yê çalak/çalak bike (moda ku daneyên berê hatine girtin bikar tîne).
- Bişkojkên [Destpêk]/[Rawestandin]/[Gavek]/[Dîbare] ji bo kontrolkirina daneya ji MEMS-Studio ber bi pirtûkxaneyê ve.

2.5 Çavkanî
Hemî çavkaniyên jêrîn bi serbestî li ser www.st.com hene.

1. UM1859: Destpêkirina bi X-CUBE-MEMS1 tevgera MEMS û berbelavkirina nermalava sensora jîngehê ji bo STM32Cube
2. UM1724: Desteyên STM32 Nucleo-64 (MB1136)
3. UM3233: Destpêkirina bi MEMS-Studio

Dîroka Revision

Tablo 4. Dîroka guhertoya belgeyê

Rojek	Awa	Changes
22-Sep-2017	1	Serbestberdana destpêkê.
6-Seb-18	2	Referansên li ser panela pêşkeftinê ya NUCLEO-L152RE û Tabloya 2 zêde kirin. Algorîtmaya dema derbasbûyî (μs).
21-Adar-18	3	Destpêka nûvekirî û Beşa 2.1 MotionFD bi dawî bûview.
19-Seb-19	4	Tabloya nûvekirî 2. Algorîtmaya dema derbasbûyî (μs) û wêne 2. STM32 Nucleo: LED, bişkok, jumper. Agahdariya lihevhatina panela berfirehkirina X-NUCLEO-IKS01A3 zêde kir.
17-Sep-24	5	Destpêka Beşa Nûvekirî, Beş 2.1: MotionFD bi dawî bûview, Beş 2.2.1: Danasîna pirtûkxaneya MotionFD, Beş 2.2.2: API-yên MotionFD, Beş 2.2.5: Performansa algorîtmayê, Beş 2.3: Sampserîlêdana le, Beş 2.4: Serîlêdana MEMS-Studio

BİXWÎNE BİXWÎNE - BİXWÎNE BİXWÎNE
STMicroelectronics NV û şaxên wê ("ST") mafê ku di her kêliyê de bêyî agahdarî li ser hilberên ST-ê û / an jî vê belgeyê biguhezînin, rastkirin, çêtirkirin, guheztin û çêtirkirinan diparêzin. Pêdivî ye ku kirrûbir berî ku fermanan bidin agahdariya herî dawî ya têkildar li ser hilberên ST bistînin. Berhemên ST di dema pejirandina fermanê de li gorî şert û mercên firotanê yên ST têne firotin.
Kiryar bi tenê ji bijartin, hilbijartin û karanîna hilberên ST berpirsiyar in û ST ji bo arîkariya serîlêdanê an sêwirana hilberên kirrûbiran berpirsiyarî nagire.
Li vir ji hêla ST ve ti destûrek, eşkere an jî têgihîştî, ji tu mafek milkê rewşenbîrî re nayê dayîn.
Ji nû ve firotina hilberên ST bi şertên ku ji agahdariya ku li vir hatî destnîşan kirin cûdatir dê garantiyek ku ST ji bo hilberek weha hatî dayîn betal bike.
ST û logoya ST marqeyên ST ne. Ji bo bêtir agahdarî li ser marqeyên ST, serî li www.st.com/trademarks. Hemî navên hilber an karûbarê din milkê xwediyên wan ên têkildar in.
Agahdariya di vê belgeyê de agahdariya ku berê di guhertoyên berê yên vê belgeyê de hatine peyda kirin digire û diguhezîne.

© 2024 STMicroelectronics - Hemî maf parastî ne

Belge / Çavkanî

ST X-CUBE-MEMS1 MotionFD Pirtûkxaneya Dîtina Fall Time-a Rast [pdf] Rêbernameya Bikarhêner Pirtûkxaneya Tespîtkirina Payîzê ya Rastî ya X-CUBE-MEMS1 MotionFD, X-CUBE-MEMS1, Pirtûkxaneya Tespîtkirina Payîzê ya Rastî ya MotionFD, Pirtûkxaneya Tespîtkirina Payîzê ya Rastî, Pirtûkxaneya Tespîtkirina Payîzê, Pirtûkxaneya Tespîtkirinê, Pirtûkxane

Çavkanî

• Manual Bikarhêner