UM2275
Llawlyfr defnyddiwr
Dechrau arni gyda llyfrgell canfod cwymp amser real MotionFD yn ehangiad X-CUBE-MEMS1 ar gyfer STM32Cube
Rhagymadrodd
Mae'r MotionEC yn elfen llyfrgell nwyddau canol o feddalwedd X-CUBE-MEMS1 ac mae'n rhedeg ar STM3z2. Mae'n darparu gwybodaeth amser real am gyfeiriadedd dyfais a statws symud yn seiliedig ar ddata o ddyfais.
Mae'n darparu'r allbynnau canlynol: cyfeiriadedd dyfais (cwaternau, onglau Euler), cylchdroi dyfais (ymarferoldeb gyrosgop rhithwir), fector disgyrchiant a chyflymiad llinellol.
Bwriad y llyfrgell hon yw gweithio gyda ST MEMS yn unig.
Darperir yr algorithm mewn fformat llyfrgell sefydlog ac fe'i cynlluniwyd i'w ddefnyddio ar ficroreolyddion STM32 yn seiliedig ar ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 ac ARM® Pensaernïaeth Cortex®-M7.
Mae wedi'i adeiladu ar ben technoleg meddalwedd STM32Cube i hwyluso hygludedd ar draws gwahanol ficroreolyddion STM32.
Daw'r meddalwedd gyda sampgyda gweithrediad sy'n rhedeg ar fwrdd ehangu X-NUCLEO-IKS4A1 neu X-NUCLEO-IKS01A3 ar fwrdd datblygu NUCLEO-F401RE, NUCLEO-U575ZI-Q neu NUCLEO-L152RE.
Acronymau a byrfoddau
Tabl 1. Rhestr o acronymau
| Acronym | Disgrifiad |
| API | Rhyngwyneb rhaglennu cais |
| BSP | Pecyn cymorth y Bwrdd |
| GUI | Rhyngwyneb defnyddiwr graffigol |
| HAL | Haen tynnu caledwedd |
| IDE | Amgylchedd datblygu integredig |
Llyfrgell nwyddau canol MotionFD yn ehangu meddalwedd X-CUBE-MEMS1 ar gyfer STM32Cube
2.1 MotionFD drosoddview
Mae llyfrgell MotionFD yn ehangu ymarferoldeb meddalwedd X-CUBE-MEMS1.
Mae'r llyfrgell yn caffael data o'r cyflymromedr a'r synhwyrydd pwysau ac yn darparu gwybodaeth am y digwyddiad cwymp defnyddiwr yn seiliedig ar ddata o ddyfais.
Mae'r llyfrgell wedi'i chynllunio ar gyfer ST MEMS yn unig. Nid yw ymarferoldeb a pherfformiad wrth ddefnyddio synwyryddion MEMS eraill yn cael eu dadansoddi a gallant fod yn sylweddol wahanol i'r hyn a ddisgrifir yn y ddogfen.
SampMae gweithredu ar gael ar gyfer bwrdd ehangu X-NUCLEO-IKS4A1 a X-NUCLEO-IKS01A3, wedi'i osod ar fwrdd datblygu NUCLEO-F401RE, NUCLEO-U575ZI-Q neu NUCLEO-L152RE.
2.2 Llyfrgell MotionFD
Gellir dod o hyd i wybodaeth dechnegol sy'n disgrifio swyddogaethau a pharamedrau'r APIs MotionFD yn llawn yn HTML a luniwyd gan MotionFD_Package.chm file wedi'i leoli yn y ffolder Dogfennaeth.
2.2.1 Disgrifiad llyfrgell MotionFD
Mae llyfrgell canfod cwymp MotionFD yn rheoli'r data a gafwyd o'r cyflymromedr a'r synhwyrydd pwysau; mae'n cynnwys:
- posibilrwydd i wahaniaethu a yw'r cwymp defnyddiwr wedi digwydd ai peidio
- cydnabyddiaeth yn seiliedig ar ddata cyflymromedr a synhwyrydd pwysau yn unig
- data cyflymromedr a synhwyrydd pwysau gofynnol sampamledd ling yw 25 Hz
- gofynion adnoddau:
- Cortex-M3: 3.6 kB o god a 3.2 kB o gof data
- Cortex-M33: 3.4 kB o god a 3.2 kB o gof data
- Cortex-M4: 3.4 kB o god a 3.2 kB o gof data
– Cortex-M7: 3.4 kB o god a 3.2 o gof data - ar gael ar gyfer pensaernïaeth ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 ac ARM Cortex-M7
2.2.2 MotionFD APIs
APIs llyfrgell MotionFD yw:
- uint8_t MotionFD_GetLibVersion(toriad *fersiwn)
- yn adfer fersiwn y llyfrgell
– *fersiwn yn bwyntydd i amrywiaeth o 35 nod
– yn dychwelyd nifer y cymeriadau yn y llinyn fersiwn - MotionFD_Initialize(gwag) gwag
- yn perfformio cychwyniad llyfrgell MotionFD a gosod y mecanwaith mewnol
Nodyn: Rhaid galw'r swyddogaeth hon cyn defnyddio'r llyfrgell canfod cwympiadau ac mae'n rhaid galluogi'r modiwl CRC yn y microreolydd STM32 (yng nghofrestr galluogi cloc ymylol RCC).
- MotionFD_Diweddariad gwag (MFD_input_t *data_in, MFD_output_t *data_out)
- yn gweithredu algorithm canfod cwympiadau
- * mae paramedr data_in yn bwyntydd i strwythur gyda data mewnbwn
– y paramedrau ar gyfer y math o strwythur MFD_input_t yw:
◦ AccX yw gwerth y synhwyrydd cyflymromedr yn echel X mewn mg
◦ AccY yw gwerth y synhwyrydd cyflymromedr yn echel Y mewn mg
◦ AccZ yw gwerth y synhwyrydd cyflymromedr yn echel Z mewn mg
◦ Y wasg yw gwerth y synhwyrydd pwysau yn hPa
- * mae paramedr data_out yn bwyntydd i enum gyda'r eitemau canlynol:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - gwag MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, arnofio lying_time)
- yn gosod paramedrau cyfluniad llyfrgell
– trothwy cyflymiad cwymp_trothwy mewn mg
– gwahaniaeth uchder fall_altitude_delta mewn cm
– amser gorwedd amser mewn eiliadau heb symud ar ôl trawiad - gwag MotionFD_GetKnobs (arnofio *fall_throthwy, int32_t *fall_altitude_delta, arnofio * gorwedd_amser)
- yn cael paramedrau cyfluniad llyfrgell
– trothwy cyflymiad cwymp_trothwy mewn mg
– gwahaniaeth uchder fall_altitude_delta mewn cm
– amser gorwedd amser mewn eiliadau heb symud ar ôl trawiad
2.2.3 Siart llif API
2.2.4 Cod demo
Mae'r cod arddangos canlynol yn darllen data o'r cyflymromedr a'r synhwyrydd pwysau ac yn cael y cod digwyddiad cwympo.
2.2.5 Perfformiad algorithm
Mae'r algorithm canfod cwympiadau yn defnyddio data o'r cyflymromedr a'r synhwyrydd pwysau yn unig ac mae'n rhedeg ar amledd isel (25 Hz) i leihau'r defnydd o bŵer.
2.3 Sampgyda cais
Gellir trin offer canol MotionFD yn hawdd i adeiladu cymwysiadau defnyddwyr; felampdarperir le application yn y ffolder Cais.
Fe'i cynlluniwyd i redeg ar fwrdd datblygu NUCLEO-F401RE, NUCLEO-U575ZI-Q neu NUCLEO-L152RE sy'n gysylltiedig â bwrdd ehangu X-NUCLEO-IKS4A1 neu X-NUCLEO-IKS01A3.
Mae'r cais yn cydnabod digwyddiad cwymp defnyddiwr mewn amser real.
Mae'r ffigur uchod yn dangos y botwm defnyddiwr B1 a'r tri LED o fwrdd NUCLEO-F401RE. Unwaith y bydd y bwrdd wedi'i bweru, mae LED LD3 (PWR) yn troi YMLAEN.
Mae angen cysylltiad cebl USB i fonitro data amser real. Mae'r bwrdd yn cael ei bweru gan y PC trwy gysylltiad USB. Mae'r modd gweithio hwn yn caniatáu i'r digwyddiad cwymp defnyddiwr a ganfuwyd, cyflymromedr a data synhwyrydd pwysau, amser stamp ac yn y pen draw data synhwyrydd arall, mewn amser real, gan ddefnyddio'r MEMS-Studio.
2.4 MEMS-Cymhwysiad Stiwdio
Y sampMae'r cais yn defnyddio rhaglen MEMS-Studio, y gellir ei lawrlwytho o www.st.com.
Cam 1. Sicrhewch fod y gyrwyr angenrheidiol yn cael eu gosod a bod y bwrdd Niwcleo STM32 gyda bwrdd ehangu priodol wedi'i gysylltu â'r PC.
Cam 2. Lansiwch y cymhwysiad MEMS-Studio i agor y brif ffenestr ymgeisio.
Os yw bwrdd Niwcleo STM32 gyda firmware â chymorth wedi'i gysylltu â'r PC, caiff ei ganfod yn awtomatig.
Pwyswch y botwm [Cysylltu] i sefydlu cysylltiad â'r bwrdd gwerthuso.
Cam 3. Pan fydd wedi'i gysylltu â bwrdd Niwcleo STM32 gyda thab cadarnwedd a gefnogir [Gwerthusiad Llyfrgell] yn cael ei agor.
I ddechrau a stopio ffrydio data, toglo'r [Cychwyn] priodol 
neu [Stop] 
botwm ar y bar offer fertigol allanol.
Gall y data sy'n dod o'r synhwyrydd cysylltiedig fod viewed dewis y tab [Tabl Data] ar yr offeryn fertigol mewnol ba
Cam 4. Cliciwch ar y [Canfod Cwymp] i agor y ffenestr ymgeisio bwrpasol.
Cam 5. Cliciwch ar y [Save To File] i agor y ffenestr ffurfweddu logio data. Dewiswch y synhwyrydd a data canfod cwymp i'w cadw yn y file. Gallwch chi ddechrau neu stopio arbed trwy glicio ar y botwm cyfatebol.
Cam 6. Gellir defnyddio modd Chwistrellu Data i anfon y data a gafwyd yn flaenorol i'r llyfrgell a derbyn y canlyniad. Dewiswch y tab [ Chwistrelliad Data ] ar y bar offer fertigol i agor yr un pwrpasol view ar gyfer y swyddogaeth hon.
Cam 7. Cliciwch ar y botwm [Pori] i ddewis y file gyda'r data a gasglwyd yn flaenorol mewn fformat CSV.
Bydd y data yn cael ei lwytho i mewn i'r tabl yn y cerrynt view.
Bydd botymau eraill yn dod yn weithredol. Gallwch glicio ar:
– botwm [Modd All-lein] i droi'r modd all-lein firmware ymlaen / i ffwrdd (modd gan ddefnyddio'r data a ddaliwyd yn flaenorol).
– [Cychwyn]/[Stop]/[Cam]/[Ailadrodd] botymau i reoli'r porthiant data o MEMS-Studio i'r llyfrgell.
2.5 Cyfeiriadau
Mae'r holl adnoddau canlynol ar gael am ddim ar www.st.com.
- UM1859: Dechrau arni gyda'r cynnig X-CUBE-MEMS1 MEMS ac ehangu meddalwedd synhwyrydd amgylcheddol ar gyfer STM32Cube
- UM1724: Byrddau Niwcleo-32 STM64 (MB1136)
- UM3233: Dechrau arni gyda MEMS-Studio
Hanes adolygu
Tabl 4. Hanes adolygu'r ddogfen
| Dyddiad | Fersiwn | Newidiadau |
| 22-Medi-2017 | 1 | Rhyddhad cychwynnol. |
| 6-Chwefror-18 | 2 | Ychwanegwyd cyfeiriadau at fwrdd datblygu NUCLEO-L152RE a Thabl 2. Algorithm amser a aeth heibio (μs). |
| 21-Maw-18 | 3 | Cyflwyniad wedi'i Ddiweddaru ac Adran 2.1 MotionFD drosoddview. |
| 19-Chwefror-19 | 4 | Tabl 2 wedi'i ddiweddaru. Algorithm amser a aeth heibio (μs) a Ffigur 2. Niwcleo STM32: LEDs, botwm, siwmper. Ychwanegwyd gwybodaeth gydnawsedd bwrdd ehangu X-NUCLEO-IKS01A3. |
| 17-Medi-24 | 5 | Cyflwyniad Adran wedi'i Ddiweddaru, Adran 2.1: MotionFD drosoddview, Adran 2.2.1: Disgrifiad llyfrgell MotionFD, Adran 2.2.2: APIs MotionFD, Adran 2.2.5: Perfformiad Algorithm, Adran 2.3: Sampgyda'r cais, Adran 2.4: cais MEMS-Studio |
HYSBYSIAD PWYSIG – DARLLENWCH YN OFALUS
Mae STMicroelectronics NV a'i is-gwmnïau (“ST”) yn cadw'r hawl i wneud newidiadau, cywiriadau, gwelliannau, addasiadau a gwelliannau i gynhyrchion ST a/neu i'r ddogfen hon ar unrhyw adeg heb rybudd. Dylai prynwyr gael y wybodaeth berthnasol ddiweddaraf am gynhyrchion ST cyn gosod archebion. Gwerthir cynhyrchion ST yn unol â thelerau ac amodau gwerthu ST sydd ar waith ar adeg cydnabod yr archeb.
Prynwyr yn unig sy'n gyfrifol am ddewis, dewis a defnyddio cynhyrchion ST ac nid yw ST yn cymryd unrhyw atebolrwydd am gymorth ymgeisio neu ddyluniad cynhyrchion prynwyr.
Ni roddir trwydded, yn benodol nac yn oblygedig, i unrhyw hawl eiddo deallusol gan ST yma.
Bydd ailwerthu cynhyrchion ST gyda darpariaethau gwahanol i'r wybodaeth a nodir yma yn dileu unrhyw warant a roddir gan ST ar gyfer cynnyrch o'r fath.
Mae ST a'r logo ST yn nodau masnach ST. I gael gwybodaeth ychwanegol am nodau masnach ST, cyfeiriwch at www.st.com/trademarks. Mae pob enw cynnyrch neu wasanaeth arall yn eiddo i'w perchnogion priodol.
Mae gwybodaeth yn y ddogfen hon yn disodli ac yn disodli gwybodaeth a ddarparwyd yn flaenorol mewn unrhyw fersiynau blaenorol o'r ddogfen hon.
© 2024 STMicroelectroneg – Cedwir pob hawl
Dogfennau / Adnoddau
 |
ST X-CUBE-MEMS1 Llyfrgell Canfod Cwymp Amser Real MotionFD [pdfLlawlyfr Defnyddiwr X-CUBE-MEMS1 Llyfrgell Canfod Cwymp Amser Real MotionFD, X-CUBE-MEMS1, Llyfrgell Canfod Cwymp Amser Real MotionFD, Llyfrgell Canfod Cwymp Amser Real, Llyfrgell Canfod Cwymp, Llyfrgell Canfod, Llyfrgell |
