UM2275
User manual
Pagsisimula sa MotionFD real-time fall detection library sa X-CUBE-MEMS1 expansion para sa STM32Cube
Panimula
Ang MotionEC ay isang middleware library component ng X-CUBE-MEMS1 software at tumatakbo sa STM3z2. Nagbibigay ito ng real-time na impormasyon tungkol sa oryentasyon ng device at status ng paggalaw batay sa data mula sa isang device.
Nagbibigay ito ng mga sumusunod na output: oryentasyon ng device (quaternions, mga anggulo ng Euler), pag-ikot ng device (function na virtual na gyroscope), gravity vector at linear acceleration.
Ang library na ito ay nilayon na magtrabaho sa ST MEMS lamang.
Ang algorithm ay ibinigay sa static na format ng library at idinisenyo upang magamit sa mga STM32 microcontroller batay sa ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 at ARM® Mga arkitektura ng Cortex®-M7.
Ito ay binuo sa ibabaw ng teknolohiya ng software ng STM32Cube upang mapagaan ang portability sa iba't ibang STM32 microcontroller.
Ang software ay may kasamang sampAng pagpapatupad na tumatakbo sa X-NUCLEO-IKS4A1 o X-NUCLEO-IKS01A3 expansion board sa isang NUCLEO-F401RE, NUCLEO-U575ZI-Q o NUCLEO-L152RE development board.
Mga acronym at pagdadaglat
Talahanayan 1. Listahan ng mga acronym
| Acronym | Paglalarawan |
| API | Application programming interface |
| BSP | Pakete ng suporta sa board |
| GUI | Graphical na interface ng gumagamit |
| HAL | Layer ng abstraction ng hardware |
| IDE | Pinagsamang kapaligiran sa pag-unlad |
MotionFD middleware library sa X-CUBE-MEMS1 software expansion para sa STM32Cube
2.1 Tapos na ang MotionFDview
Pinapalawak ng MotionFD library ang functionality ng X-CUBE-MEMS1 software.
Ang library ay nakakakuha ng data mula sa accelerometer at pressure sensor at nagbibigay ng impormasyon tungkol sa user fall event batay sa data mula sa isang device.
Ang aklatan ay idinisenyo para sa ST MEMS lamang. Ang pag-andar at pagganap kapag gumagamit ng iba pang mga sensor ng MEMS ay hindi sinusuri at maaaring malaki ang pagkakaiba sa inilarawan sa dokumento.
SampAng pagpapatupad ay magagamit para sa X-NUCLEO-IKS4A1 at X-NUCLEO-IKS01A3 expansion board, na naka-mount sa isang NUCLEO-F401RE, NUCLEO-U575ZI-Q o NUCLEO-L152RE development board.
2.2 MotionFD library
Ang teknikal na impormasyon na ganap na naglalarawan sa mga function at parameter ng MotionFD API ay matatagpuan sa MotionFD_Package.chm compiled HTML file matatagpuan sa folder ng Dokumentasyon.
2.2.1 Paglalarawan ng MotionFD library
Pinamamahalaan ng MotionFD fall detection library ang data na nakuha mula sa accelerometer at pressure sensor; nagtatampok ito ng:
- posibilidad na makilala kung naganap ang pagkahulog ng gumagamit o hindi
- pagkilala batay lamang sa data ng accelerometer at pressure sensor
- kinakailangang data ng accelerometer at pressure sensor sampAng dalas ng ling ay 25 Hz
- mga kinakailangan sa mapagkukunan:
– Cortex-M3: 3.6 kB ng code at 3.2 kB ng data memory
– Cortex-M33: 3.4 kB ng code at 3.2 kB ng data memory
– Cortex-M4: 3.4 kB ng code at 3.2 kB ng data memory
– Cortex-M7: 3.4 kB ng code at 3.2 ng memorya ng data - magagamit para sa mga arkitekturang ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 at ARM Cortex-M7
2.2.2 MotionFD API
Ang MotionFD library API ay:
- uint8_t MotionFD_GetLibVersion(char *bersyon)
– kinukuha ang bersyon ng library
– *Ang bersyon ay isang pointer sa isang array ng 35 character
– ibinabalik ang bilang ng mga character sa string ng bersyon - void MotionFD_Initialize(void)
– nagsasagawa ng pagsisimula ng MotionFD library at pag-setup ng panloob na mekanismo
Tandaan: Ang function na ito ay dapat na tawagan bago gamitin ang fall detection library at ang CRC module sa STM32 microcontroller (sa RCC peripheral clock enable register) ay kailangang paganahin.
- void MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
- nagsasagawa ng algorithm ng pag-detect ng pagkahulog
– *data_in parameter ay isang pointer sa isang istraktura na may input data
– ang mga parameter para sa uri ng istraktura MFD_input_t ay:
◦ AccX ay ang accelerometer sensor value sa X axis sa mg
◦ Ang AccY ay ang halaga ng sensor ng accelerometer sa Y axis sa mg
◦ Ang AccZ ay ang accelerometer sensor value sa Z axis sa mg
◦ Ang press ay ang halaga ng pressure sensor sa hPa
– *data_out parameter ay isang pointer sa isang enum na may mga sumusunod na item:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
– nagtatakda ng mga parameter ng pagsasaayos ng library
– fall_threshold acceleration threshold sa mg
– fall_altitude_delta pagkakaiba sa altitude sa cm
– oras ng pagsisinungaling sa mga segundo nang walang paggalaw pagkatapos ng epekto - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
– nakakakuha ng mga parameter ng configuration ng library
– fall_threshold acceleration threshold sa mg
– fall_altitude_delta pagkakaiba sa altitude sa cm
– oras ng pagsisinungaling sa mga segundo nang walang paggalaw pagkatapos ng epekto
2.2.3 Tsart ng daloy ng API
2.2.4 Demo code
Ang sumusunod na demonstration code ay nagbabasa ng data mula sa accelerometer at pressure sensor at nakukuha ang code ng kaganapan sa taglagas.
2.2.5 Pagganap ng algorithm
Gumagamit lang ng data mula sa accelerometer at pressure sensor ang fall detection algorithm at tumatakbo sa mababang frequency (25 Hz) upang bawasan ang pagkonsumo ng kuryente.
2.3 Sampang aplikasyon
Ang MotionFD middleware ay madaling manipulahin upang bumuo ng mga application ng user; bilangampAng application ay ibinigay sa folder ng Application.
Ito ay dinisenyo upang tumakbo sa isang NUCLEO-F401RE, NUCLEO-U575ZI-Q o NUCLEO-L152RE development board na konektado sa isang X-NUCLEO-IKS4A1 o X-NUCLEO-IKS01A3 expansion board.
Kinikilala ng application ang kaganapan ng pagkahulog ng user sa real-time.
Ipinapakita ng figure sa itaas ang user button B1 at ang tatlong LED ng NUCLEO-F401RE board. Kapag ang board ay pinapagana, ang LED LD3 (PWR) ay naka-ON.
Ang isang koneksyon sa USB cable ay kinakailangan upang masubaybayan ang real-time na data. Ang board ay pinapagana ng PC sa pamamagitan ng USB connection. Ang working mode na ito ay nagbibigay-daan sa nakitang user fall event, accelerometer at pressure sensor data, time stamp at kalaunan ang iba pang data ng sensor, sa real-time, gamit ang MEMS-Studio.
2.4 MEMS-Studio application
Ang sampAng application ay gumagamit ng MEMS-Studio application, na maaaring ma-download mula sa www.st.com.
Hakbang 1. Tiyaking naka-install ang mga kinakailangang driver at nakakonekta sa PC ang STM32 Nucleo board na may naaangkop na expansion board.
Hakbang 2. Ilunsad ang MEMS-Studio application upang buksan ang pangunahing window ng application.
Kung nakakonekta sa PC ang isang STM32 Nucleo board na may suportadong firmware, awtomatiko itong matutukoy.
Pindutin ang [Connect] na buton para magtatag ng koneksyon sa evaluation board.
Hakbang 3. Kapag nakakonekta sa isang STM32 Nucleo board na may suportadong firmware na tab na [Library Evaluation] ay bubukas.
Upang simulan at ihinto ang streaming ng data, i-toggle ang naaangkop na [Start] 
o [Stop] 
button sa panlabas na patayong tool bar.
Ang data na nagmumula sa konektadong sensor ay maaaring viewed pagpili sa tab na [Data Table] sa panloob na vertical tool ba
Hakbang 4. Mag-click sa [Fall Detection] para buksan ang nakalaang application window.
Hakbang 5. Mag-click sa [Save To File] upang buksan ang window ng pagsasaayos ng dataloging. Piliin ang data ng sensor at fall detection na ise-save sa file. Maaari kang magsimula o huminto sa pag-save sa pamamagitan ng pag-click sa kaukulang button.
Hakbang 6. Maaaring gamitin ang Data Injection mode para ipadala ang dating nakuhang data sa library at matanggap ang resulta. Piliin ang tab na [Data Injection] sa vertical tool bar para buksan ang nakalaan view para sa functionality na ito.
Hakbang 7. Mag-click sa [Browse] na buton upang piliin ang file gamit ang dating nakuhang data sa CSV format.
Ang data ay mai-load sa talahanayan sa kasalukuyang view.
Magiging aktibo ang iba pang mga button. Maaari kang mag-click sa:
– Button na [Offline Mode] upang i-on/off ang offline mode ng firmware (mode na gumagamit ng dating nakuhang data).
– Mga button na [Start]/[Stop]/[Step]/[Repeat] para kontrolin ang data feed mula sa MEMS-Studio hanggang sa library.
2.5 Mga Sanggunian
Ang lahat ng sumusunod na mapagkukunan ay malayang makukuha sa www.st.com.
- UM1859: Pagsisimula sa X-CUBE-MEMS1 motion MEMS at environmental sensor software expansion para sa STM32Cube
- UM1724: STM32 Nucleo-64 boards (MB1136)
- UM3233: Pagsisimula sa MEMS-Studio
Kasaysayan ng rebisyon
Talahanayan 4. Kasaysayan ng rebisyon ng dokumento
| Petsa | Bersyon | Mga pagbabago |
| 22-Sep-2017 | 1 | Paunang paglabas. |
| 6-Peb-18 | 2 | Nagdagdag ng mga reference sa NUCLEO-L152RE development board at Table 2. Elapsed time (μs) algorithm. |
| 21-Mar-18 | 3 | Nai-update na Panimula at Seksyon 2.1 MotionFD tapos naview. |
| 19-Peb-19 | 4 | Updated Table 2. Elapsed time (μs) algorithm at Figure 2. STM32 Nucleo: LEDs, button, jumper. Nagdagdag ng impormasyon sa compatibility ng expansion board ng X-NUCLEO-IKS01A3. |
| 17-Sep-24 | 5 | Na-update na Panimula ng Seksyon, Seksyon 2.1: Tapos na ang MotionFDview, Seksyon 2.2.1: Deskripsyon ng library ng MotionFD, Seksyon 2.2.2: Mga MotionFD API, Seksyon 2.2.5: Pagganap ng algorithm, Seksyon 2.3: Sample application, Seksyon 2.4: MEMS-Studio application |
MAHALAGANG PAUNAWA – MAGBASA NG MABUTI
Inilalaan ng STMicroelectronics NV at ng mga subsidiary nito (“ST”) ang karapatang gumawa ng mga pagbabago, pagwawasto, pagpapahusay, pagbabago, at pagpapahusay sa mga produkto ng ST at/o sa dokumentong ito anumang oras nang walang abiso. Dapat makuha ng mga mamimili ang pinakabagong may-katuturang impormasyon sa mga produkto ng ST bago maglagay ng mga order. Ang mga produkto ng ST ay ibinebenta alinsunod sa mga tuntunin at kundisyon ng pagbebenta ng ST sa oras ng pag-acknowledge ng order.
Ang mga mamimili ay tanging responsable para sa pagpili, pagpili, at paggamit ng mga produkto ng ST at walang pananagutan ang ST para sa tulong sa aplikasyon o disenyo ng mga produkto ng mga mamimili.
Walang lisensya, hayag o ipinahiwatig, sa anumang karapatan sa intelektwal na ari-arian ang ipinagkaloob ng ST dito.
Ang muling pagbebenta ng mga produktong ST na may mga probisyon na iba sa impormasyong nakasaad dito ay magpapawalang-bisa sa anumang warranty na ibinigay ng ST para sa naturang produkto.
Ang ST at ang ST logo ay mga trademark ng ST. Para sa karagdagang impormasyon tungkol sa mga trademark ng ST, sumangguni sa www.st.com/trademarks. Ang lahat ng iba pang pangalan ng produkto o serbisyo ay pag-aari ng kani-kanilang mga may-ari.
Ang impormasyon sa dokumentong ito ay pinapalitan at pinapalitan ang impormasyong dating ibinigay sa anumang mga naunang bersyon ng dokumentong ito.
© 2024 STMicroelectronics – Nakalaan ang lahat ng karapatan
Mga Dokumento / Mga Mapagkukunan
 |
ST X-CUBE-MEMS1 MotionFD Real Time Fall Detection Library [pdf] User Manual X-CUBE-MEMS1 MotionFD Real Time Fall Detection Library, X-CUBE-MEMS1, MotionFD Real Time Fall Detection Library, Real Time Fall Detection Library, Fall Detection Library, Detection Library, Library |
