UM2225
Lámhleabhar úsáideora
Ag tosú le leabharlann fíor-ama E-Compass MotionEC i leathnú X-CUBE-MEMS1 do STM32Cube
Réamhrá
Is comhpháirt leabharlainne meánearraí é an MotionEC de na bogearraí X-CUBE-MEMS1 agus ritheann sé ar STM3z2. Soláthraíonn sé faisnéis fíor-ama maidir le treoshuíomh feiste agus stádas gluaiseachta bunaithe ar shonraí ó fheiste.
Soláthraíonn sé na haschuir seo a leanas: treoshuíomh feiste (ceathrúna, uillinneacha Euler), rothlú feiste (feidhmiúlacht giroscóip fhíorúil), veicteoir domhantarraingthe agus luasghéarú líneach.
Tá sé i gceist go n-oibreoidh an leabharlann seo le ST MEMS amháin.
Cuirtear an algartam ar fáil i bhformáid leabharlainne statach agus tá sé deartha le húsáid ar mhicririalaitheoirí STM32 bunaithe ar ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 agus ARM® Ailtireacht Cortex®-M7.
Tá sé tógtha ar bharr na teicneolaíochta bogearraí STM32Cube chun inaistritheacht a éascú ar fud micrea-rialaitheoirí STM32 éagsúla.
Tagann na bogearraí le sample feidhmiú ar siúl ar X-NUCLEO-IKS01A3 , X-NUCLEO-IKS4A1 nó X-NUCLEO-IKS02A1 bord leathnaithe ar bhord forbartha NUCLEO-F401RE, NUCLEO-U575ZI-Q, NUCLEO-L152RE nó NUCLEO-L073RZ.
Acrainmneacha agus giorrúcháin
Tábla 1. Liosta acrainmneacha
| Acrainm | Cur síos |
| API | Comhéadan cláir feidhmchláir |
| BSP | Pacáiste tacaíochta an Bhoird |
| GUI | Comhéadan grafach úsáideora |
| HAL | Ciseal astarraingthe crua-earraí |
| IDE | Timpeallacht forbartha comhtháite |
Leabharlann lárearraí MotionEC i leathnú bogearraí X-CUBE-MEMS1 do STM32Cube
2.1 MotionEC os a chionnview
Leathnaíonn leabharlann MotionEC feidhmiúlacht na mbogearraí X-CUBE-MEMS1.
Faigheann an leabharlann sonraí ón méadair luasghéaraithe agus ón maighnéadiméadar agus soláthraíonn sí faisnéis maidir le treoshuíomh an fheiste agus stádas gluaiseachta bunaithe ar shonraí ó fheiste.
Tá an leabharlann deartha do ST MEMS amháin. Ní dhéantar anailís ar fheidhmiúlacht agus ar fheidhmíocht nuair a bhíonn braiteoirí MEMS eile á n-úsáid agus is féidir leo a bheith difriúil go suntasach ón méid a thuairiscítear sa doiciméad.
A sample cur i bhfeidhm ar fáil ar bhord leathnaithe X-NUCLEO-IKS01A3 , X-NUCLEO-IKS4A1 agus X-NUCLEO-IKS02A1, suite ar bhord forbartha NUCLEO-F401RE, NUCLEO-U575ZI-Q, NUCLEO-L152RE nó NUCLEOZ-L073R.
2.2 Leabharlann MotionEC
Tá faisnéis theicniúil a thugann cur síos iomlán ar fheidhmeanna agus pharaiméadair APIanna MotionEC le fáil san HTML tiomsaithe MotionEC_Package.chm file lonnaithe san fhillteán Doiciméadúcháin.
2.2.1 Cur síos ar leabharlann MotionEC
Bainistíonn leabharlann E-Compass MotionEC sonraí a fuarthas ón luasmhéadair agus ón maighnéadiméadar; gnéithe sé:
- treoshuíomh feiste (ceathrúna, uillinneacha Euler), rothlú feiste (feidhmiúlacht ghireascóp fhíorúil), veicteoir domhantarraingthe agus aschuir luasghéaraithe líneacha
- feidhmiúlacht atá bunaithe ar shonraí an luasmhéadair agus an maighnéadiméadar amháin
- sonraí luasmhéadair agus maighnéadiméadar riachtanach sampminicíocht teanga suas le 100 Hz
- riachtanais acmhainní:
– Cortex-M0+: 3.7 kB de chód agus 0.1 kB de chuimhne sonraí
– Cortex-M3: 3.8 kB de chód agus 0.1 kB de chuimhne sonraí
– Cortex-M33: 2.8 kB de chód agus 0.1 kB de chuimhne sonraí
– Cortex-M4: 2.9 kB de chód agus 0.1 kB de chuimhne sonraí
– Cortex-M7: 2.8 kB de chód agus 0.1 kB de chuimhne sonraí - ar fáil le haghaidh ailtireachtaí ARM Cortex M0+, Cortex-M3, Cortex-M33, Cortex-M4 agus Cortex M7
2.2.2 MotionEC APIs
Is iad APIanna MotionEC:
- uint8_t MotionEC_GetLibVersion(char *leagan)
– an leagan den leabharlann a aisghabháil
– *Is pointeoir é an leagan ar raon 35 carachtar
– filleann sé líon na gcarachtar sa teaghrán leagain
• neamhní MotionEC_Initialize(MEC_mcu_type_t mcu_type, snámhphointe)
– cuireann sé tús le leabharlann MotionEC agus socróidh sé an mheicníocht inmheánach.
– is é mcu_type an cineál MCU:
◦ Tá MFX_CM0P_MCU_STM32 caighdeánach STM32 MCU
◦ Is BlueNRG-0 é MFX_CM1P_MCU_BLUE_NRG1
◦ Is BlueNRG-0 é MFX_CM2P_MCU_BLUE_NRG2
◦ Is BlueNRG -LP é MFX_CM0P_MCU_BLUE_NRG_LP
– is é freq an braiteoir sampminicíocht teanga [Hz]
Nóta: Ní mór an fheidhm seo a ghlaoch roimh úsáid a bhaint as an leabharlann E-Compass agus ní mór an modúl CRC i micrea-rialtóir STM32 (i gclár cumasaithe clog forimeallach RCC) a chumasú roimh an leabharlann a úsáid
- ar neamhní MotionEC_SetFrequency(freq snámhphointe)
– socraíonn na sampminicíocht ling (na paraiméadair scagtha a mhodhnú)
– is é freq an braiteoir sampminicíocht teanga [Hz] • ar neamhní MotionEC_Run(MEC_input_t *data_in, MEC_output_t *data_out)
– a reáchtálann an t-algartam E-Compass (comhleá sonraí luasmhéadair agus maighnéadiméadar)
– *Is pointeoir é data_in ar struchtúr le sonraí ionchuir
– is iad na paraiméadair don chineál struchtúir MEC_input_t:
Is éard atá in ◦ acc[3] ná sraith sonraí méadair luasghéaraithe sa choinbhinsiún ENU, arna dtomhas i g
◦ Is éard atá i mag[3] ná sraith de shonraí calabraithe maighnéadiméadar i gcoinbhinsiún ENU, arna dtomhas i μT/50
◦ is é deilttime s an t-am deilte (.i. moill ama idir an sean tacair sonraí agus an tacar sonraí nua) arna thomhas in s
– *Is pointeoir é data_out ar struchtúr le sonraí aschuir
– is iad seo a leanas na paraiméadair don chineál struchtúir MEC_output_t:
◦ is eagar é ceathairnion[4] ina bhfuil ceathartha i gCoinbhinsiún ENU, a léiríonn treoshuíomh 3Duilleogach na feiste sa spás; Is é ord na n-eilimintí ná: X, Y, Z, W, agus an eilimint W i gcónaí dearfach
◦ Is éard atá i euler[3] ná sraith uillinneacha Euler i gcoinbhinsiún ENU, a léiríonn treoshuíomh 3D-uilleach na feiste sa spás; is é ord na n-eilimintí ná: yaw, pitch, roll, tomhaiste i deg
◦ Is éard atá i i_gyro[3] ná sraith rátaí uilleacha sa choinbhinsiún ENU, arb ionann é agus braiteoir gíreascóip fíorúil, arna thomhas i dps
◦ is sraith luasghéaruithe é domhantarraingthe[3] i gcoinbhinsiún ENU, a ionadaíonn veicteoir an domhantarraingthe, arna thomhas i g
◦ líneach[3] is ea raon luasghéaruithe i gcoinbhinsiún ENU, a sheasann do luasghéarú líneach na feiste, arna thomhas i g
- ar neamhní MotionEC_GetOrientationEnable(MEC_state_t *luaigh)
– faigheann sé staid chumasaithe/díchumasaithe ríomh na huillinne Euler
– *tá an stát ina phointeoir don staid reatha cumasaithe/díchumasaithe - ar neamhní MotionEC_SetOrientationEnable(MEC_state_t state)
– socraítear staid chumasaithe/díchumasaithe ríomh na huillinne Euler
– is é an stát an stát cumasaithe/díchumasaithe nua atá le socrú - ar neamhní MotionEC_GetVirtualGyroEnable(MEC_state_t *luaigh)
– faigheann sé staid chumasaithe/díchumasaithe ríomh an ghirscóp fíorúil
– *tá an stát ina phointeoir don staid reatha cumasaithe/díchumasaithe - ar neamhní MotionEC_SetVirtualGyroEnable(MEC_state_t state)
– socraíonn sé staid chumasaithe/díchumasaithe ríomh an ghireascóp fhíorúil
– is é an stát an stát cumasaithe/díchumasaithe nua atá le socrú - ar neamhní MotionEC_GetGravityEnable(MEC_state_t *luaigh)
– faigheann sé staid chumasaithe/díchumasaithe ríomh an veicteora domhantarraingthe
– *tá an stát ina phointeoir don staid reatha cumasaithe/díchumasaithe - ar neamhní MotionEC_SetGravityEnable(MEC_state_t state)
– socraítear staid chumasaithe/díchumasaithe ríomh an veicteora domhantarraingthe
– is é an stát an stát cumasaithe/díchumasaithe nua atá le socrú - ar neamhní MotionEC_GetLinearAccEnable(MEC_state_t *luaigh)
– faigheann sé staid chumasaithe/díchumasaithe ríomh an luasghéaraithe líneach
– *tá an stát ina phointeoir don staid reatha cumasaithe/díchumasaithe - ar neamhní MotionEC_SetLinearAccEnable(MEC_state_t state)
– socraítear staid chumasaithe/díchumasaithe ríomh an luasghéaraithe líneach
– is é an stát an stát cumasaithe/díchumasaithe nua atá le socrú
2.2.3 sreabhchairt API
2.2.4 Cód taispeána
Léann an cód taispeána seo a leanas sonraí ó na braiteoirí méadair luasghéaraithe agus maighnéadiméadar agus faigheann sé na sonraí ECompass (.i. ceathairnion, uillinneacha Euler, etc.).
2.2.5 Feidhmíocht algartam
Úsáideann an t-algartam E-Compass sonraí ón méadair luasghéaraithe agus ón maighnéadiméadar amháin. Ritheann sé ag minicíocht íseal (suas le 100 Hz) chun tomhaltas cumhachta a laghdú.
Sample hiarratas
Is féidir lárearraí MotionEC a ionramháil go héasca chun feidhmchláir úsáideoirí a thógáil; marample application ar fáil san fhillteán Feidhmchláir.
Tá sé deartha chun reáchtáil ar bhord forbartha NUCLEO-F401RE, NUCLEO-U575ZI-Q, NUCLEO-L152RE nó NUCLEO-L073RZ ceangailte le bord X-NUCLEO-IKS01A3, X-NUCLEO-IKS4A1or X-NUCLEO-IKS02A1expansion.
Aithníonn an feidhmchlár treoshuíomh agus rothlú an fheiste i bhfíor-am. Is féidir na sonraí a thaispeáint trí GUI.
Soláthraíonn an t-algartam na haschuir seo a leanas: treoshuíomh feiste (ceathrúna, uillinneacha Euler), rothlú gléas (feidhmiúlacht ghirscóp fíorúil), veicteoir domhantarraingthe agus luasghéarú líneach.
3.1 MEMS-iarratas stiúideo
An sample application úsáideann an feidhmchlár MEMS-Studio, ar féidir é a íoslódáil ó www.st.com.
Céim 1. Cinntigh go bhfuil na tiománaithe riachtanacha suiteáilte agus go bhfuil an bord STM32 Nucleo le bord leathnaithe cuí ceangailte leis an ríomhaire.
Céim 2. Seoladh an feidhmchlár MEMS-Studio chun príomhfhuinneog an fheidhmchláir a oscailt.
Má tá bord STM32 Nucleo le firmware tacaithe ceangailte leis an ríomhaire, aimsítear an calafort COM cuí go huathoibríoch. Brúigh an cnaipe [Ceangail] chun nasc leis an mbord meastóireachta a bhunú.
Céim 3. Nuair a bhíonn sé ceangailte le bord Núicléach STM32 le cluaisín firmware tacaithe [Meastóireacht Leabharlainne] osclaítear é.
Chun sruthú sonraí a thosú agus a stopadh, scoránaigh an [Start] cuí 
nó [Stop] 
cnaipe ar an mbarra uirlisí ingearach seachtrach.
Is féidir na sonraí a thagann ón braiteoir nasctha viewed ag roghnú an táb [Tábla Sonraí] ar an mbarra uirlisí ceartingearach istigh.
Céim 4. Cliceáil ar an [E-Compass] chun an leathanach tiomnaithe don leabharlann seo a oscailt.
Taispeánann an figiúr thuas múnla grafach Núicléach STM32. Tá treoshuíomh agus rothlú na samhla bunaithe ar shonraí E-Compáis (ceathrúna) arna ríomh ag an algartam.
Chun fíorghluaiseacht an ghléis a ailíniú leis an múnla grafach, cuir an gléas i dtreo an scáileáin agus brúigh an [Múnla Athshocraigh].
Léiríonn an luach ceannteidil fíor-cheannteideal an fheiste.
Má dhéantar an fheiste a dhíriú díreach suas nó síos (ar feadh Aise Suas an fhráma tagartha ENU, le lamháltas ±5 céim) tugtar luach N/A don cheannteideal: ní féidir idirdhealú a dhéanamh ar an bpríomhphointe a bhfuil an gléas ag díriú air.
Tugann an luach maitheasa 0 go 3 luachanna agus tá baint aige leis an gcalabrú maighnéadiméadar: dá airde an luach, is fearr torthaí an algartam sonraí E-Compass.
Céim 5. Cliceáil ar [Save to File] chun an fhuinneog chumraíochta logála sonraí a oscailt. Roghnaigh an braiteoir agus sonraí E-Compass a shábháil sa file. Is féidir leat tosú nó stop a shábháil trí chliceáil ar an gcnaipe comhfhreagrach.
Céim 6 . Is féidir modh Instealladh Sonraí a úsáid chun na sonraí a fuarthas roimhe seo a sheoladh chuig an leabharlann agus an toradh a fháil. Roghnaigh an táb [Instealladh Sonraí] ar an mbarra uirlisí ingearach chun an ceann tiomnaithe a oscailt view don fheidhmiúlacht seo.
Céim 7 . Cliceáil ar an gcnaipe [Brabhsáil] chun an file leis na sonraí a gabhadh roimhe seo i bhformáid CSV.
Déanfar na sonraí a luchtú isteach sa tábla sa sruth view.
Beidh cnaipí eile gníomhach. Is féidir leat cliceáil ar:
– [Mód As Líne] cnaipe chun an mód as líne firmware a chur ar siúl / as (mód ag baint úsáide as na sonraí a gabhadh roimhe seo).
– Cnaipí [Tosaigh]/[Stop]/[Céim]/[Athghairm] chun an fotha sonraí ó MEMS-Studio go dtí an leabharlann a rialú.
Tagairtí
Tá na hacmhainní seo a leanas ar fad ar fáil saor in aisce ar www.st.com.
- UM1859: Ag tosú leis an tairiscint MEMS X-CUBE-MEMS1 agus leathnú bogearraí braiteoir comhshaoil do STM32Cube
- UM1724: boird Núicléo-32 STM64 (MB1136)
- UM3233: Ag tosú le MEMS-Studio
Stair athbhreithnithe
Tábla 4 . Stair athbhreithnithe doiciméad
| Dáta | Leagan | Athruithe |
| 18-Bealtaine-17 | 1 | Eisiúint tosaigh. |
| 25-Ean-18 | 2 | Tagairtí curtha le bord forbartha NUCLEO-L152RE agus Tábla 2. Am caite (μs) algartam. |
| 21-Már-18 | 3 | Réamhrá Nuashonraithe agus Mír 2.1 MotionEC thallview. |
| 26-Samhain-18 | 4 | Tábla 3 curtha leis. Cortex -M0+: algartam ama caite (µs). Cuireadh tagairtí do ARM® leis Cortex® - bord forbartha M0+ agus NUCLEO-L073RZ. |
| 19-19 Feabhra | 5 | Nuashonraithe Fíor 1. Fráma tagartha ENU, Tábla 2. Cortex -M4 agus Cortex-M3: algartam ama caite (µs), Tábla 3. Cortex -M0+: algartam ama caite (µs), Fíor 3. Adaptóir bord leathnaithe braiteoir ceangailte leis an STM32 Nucleo, Fíor 4. Príomhfhuinneog Unicleo, Fíor 5. Cluaisín Teachtaireachtaí Úsáideora, Fíor 6. Fuinneog E-Compass agus Fíor 7. Fuinneog Datalog. Cuireadh faisnéis comhoiriúnachta bord leathnaithe X-NUCLEO-IKS01A3 leis. |
| 25-Már-20 | 6 | Réamhrá Nuashonraithe, Cuid 2.2.1: Cur síos ar leabharlann MotionEC agus Cuid 2.2.5: Feidhmíocht algartam. Cuireadh faisnéis faoi chomhoiriúnacht ailtireachta ARM Cortex-M7 leis. |
| 17-Meán Fómhair-24 | 7 | Réamhrá na Rannóige Nuashonraithe, Roinn 2.1: MotionEC thallview, Roinn 2.2.1: Leabharlann MotionEC tuairisc, Roinn 2.2.2: TairiscintEC APIs, Roinn 2.2.5: Algartam feidhmíocht, Roinn 3: Sample iarratas, Roinn 3.1: Feidhmchlár MEMS-Studio |
FÓGRA TÁBHACHTACH – LÉIGH GO CÚRAMACH
Coimeádann STMicroelectronics NV agus a fochuideachtaí (“ST”) an ceart chun athruithe, ceartúcháin, feabhsuithe, modhnuithe agus feabhsuithe a dhéanamh ar tháirgí ST agus/nó ar an doiciméad seo tráth ar bith gan fógra. Ba cheart do cheannaitheoirí an fhaisnéis ábhartha is déanaí maidir le táirgí ST a fháil sula ndéanann siad orduithe. Díoltar táirgí ST de bhun théarmaí agus choinníollacha díolacháin ST atá i bhfeidhm tráth admháil an ordaithe.
Is iad na ceannaitheoirí amháin atá freagrach as roghnú, roghnú agus úsáid táirgí ST agus ní ghlacann ST aon dliteanas as cúnamh iarratais ná as dearadh táirgí ceannaitheoirí.
Ní dheonaíonn ST anseo ceadúnas, sainráite nó intuigthe, d'aon cheart maoine intleachtúla.
Cuirfidh athdhíol táirgí ST a bhfuil forálacha éagsúla acu leis an bhfaisnéis atá leagtha amach anseo ar neamhní aon bharántas arna dheonú ag ST don táirge sin.
Is trádmharcanna de chuid ST iad ST agus an lógó ST. Le haghaidh faisnéise breise faoi thrádmharcanna ST, déan tagairt do www.st.com/trademarks. Is leis na húinéirí faoi seach gach ainm táirge nó seirbhíse eile.
Tagann an fhaisnéis sa doiciméad seo in ionad na faisnéise a soláthraíodh roimhe seo in aon leaganacha roimhe seo den doiciméad seo.
© 2024 STMicroelectronics – Gach ceart ar cosaint
Doiciméid / Acmhainní
 |
Is Leabharlann Meánearraí í ST X-CUBE-MEMS1 MotionEC [pdfLámhleabhar Úinéara X-CUBE-MEMS1 Is Leabharlann Meán-Earraí é MotionEC, X-CUBE-MEMS1, is Leabharlann Meán-earraí é MotionEC, Leabharlann Meánearraí, Leabharlann |
