UM2275
User manual
Pagsugod sa MotionFD real-time fall detection library sa X-CUBE-MEMS1 pagpalapad para sa STM32Cube
Pasiuna
Ang MotionEC usa ka middleware library component sa X-CUBE-MEMS1 software ug nagdagan sa STM3z2. Naghatag kini og real-time nga impormasyon bahin sa oryentasyon sa device ug status sa paglihok base sa datos gikan sa usa ka device.
Kini naghatag sa mosunod nga mga output: device orientation (quaternions, Euler angles), device rotation (virtual gyroscope functionality), gravity vector ug linear acceleration.
Kini nga librarya gituyo sa pagtrabaho uban sa ST MEMS lamang.
Ang algorithm gihatag sa static nga format sa librarya ug gidisenyo nga gamiton sa STM32 microcontrollers base sa ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 ug ARM® Mga arkitektura sa Cortex®-M7.
Gitukod kini sa ibabaw sa teknolohiya sa software sa STM32Cube aron mapagaan ang pagdala sa lainlaing mga microcontroller sa STM32.
Ang software adunay sampAng pagpatuman nga nagdagan sa X-NUCLEO-IKS4A1 o X-NUCLEO-IKS01A3 expansion board sa NUCLEO-F401RE, NUCLEO-U575ZI-Q o NUCLEO-L152RE development board.
Mga acronym ug abbreviation
Talaan 1. Listahan sa mga acronym
| Acronym | Deskripsyon |
| API | Application programming interface |
| BSP | Pakete sa suporta sa board |
| GUI | Graphical nga user interface |
| HAL | Hardware abstraction layer |
| IDE | Integrated development environment |
MotionFD middleware library sa X-CUBE-MEMS1 software expansion para sa STM32Cube
2.1 Natapos ang MotionFDview
Ang MotionFD library nagpalapad sa gamit sa X-CUBE-MEMS1 software.
Ang librarya nagkuha og datos gikan sa accelerometer ug pressure sensor ug naghatag og impormasyon mahitungod sa user fall event base sa data gikan sa usa ka device.
Ang librarya gidisenyo alang sa ST MEMS lamang. Ang pag-andar ug pasundayag kung gigamit ang ubang mga sensor sa MEMS wala gisusi ug mahimong lahi kaayo sa gihulagway sa dokumento.
SampAng pagpatuman magamit alang sa X-NUCLEO-IKS4A1 ug X-NUCLEO-IKS01A3 expansion board, nga gitaod sa NUCLEO-F401RE, NUCLEO-U575ZI-Q o NUCLEO-L152RE development board.
2.2 MotionFD librarya
Ang teknikal nga impormasyon nga hingpit nga naghulagway sa mga gimbuhaton ug mga parameter sa MotionFD APIs makita sa MotionFD_Package.chm compiled HTML file nahimutang sa folder sa Dokumentasyon.
2.2.1 Deskripsyon sa librarya sa MotionFD
Ang MotionFD fall detection library nagdumala sa datos nga nakuha gikan sa accelerometer ug pressure sensor; kini adunay:
- posibilidad nga mailhan kung ang pagkahulog sa tiggamit nahitabo o wala
- pag-ila base lamang sa accelerometer ug pressure sensor data
- gikinahanglan accelerometer ug pressure sensor data sampling frequency mao ang 25 Hz
- kinahanglanon sa mga kapanguhaan:
– Cortex-M3: 3.6 kB sa code ug 3.2 kB sa data memory
– Cortex-M33: 3.4 kB sa code ug 3.2 kB sa data memory
– Cortex-M4: 3.4 kB sa code ug 3.2 kB sa data memory
– Cortex-M7: 3.4 kB sa code ug 3.2 sa data memory - magamit alang sa ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 ug ARM Cortex-M7 nga mga arkitektura
2.2.2 MotionFD nga mga API
Ang MotionFD library API mao ang:
- uint8_t MotionFD_GetLibVersion(char *bersyon)
- Gikuha ang bersyon sa librarya
– *bersyon kay pointer sa han-ay sa 35 ka karakter
– ibalik ang gidaghanon sa mga karakter sa bersyon string - void MotionFD_Initialize(wala)
– naghimo sa MotionFD library initialization ug setup sa internal nga mekanismo
Mubo nga sulat: Kini nga function kinahanglan nga tawagan sa dili pa gamiton ang fall detection library ug ang CRC module sa STM32 microcontroller (sa RCC peripheral clock enable register) kinahanglang ma-enable.
- bakante ang MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
- Nagpatuman sa algorithm sa pagtuki sa pagkahulog
- *data_in parameter kay usa ka pointer sa usa ka istruktura nga adunay input data
- ang mga parametro alang sa istruktura nga tipo MFD_input_t mao ang:
◦ AccX mao ang accelerometer sensor bili sa X axis sa mg
◦ Ang AccY mao ang bili sa sensor sa accelerometer sa Y axis sa mg
◦ Ang AccZ mao ang bili sa sensor sa accelerometer sa Z axis sa mg
◦ Press mao ang pressure sensor value sa hPa
- *data_out parameter kay usa ka pointer sa usa ka enum nga adunay mosunod nga mga butang:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
- nagtakda sa mga parameter sa pagsumpo sa librarya
– fall_threshold acceleration threshold sa mg
– fall_altitude_delta altitude kalainan sa cm
- oras sa pagpamakak sa mga segundo nga wala’y paglihok pagkahuman sa usa ka epekto - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
- Nakakuha mga parameter sa pagsumpo sa librarya
– fall_threshold acceleration threshold sa mg
– fall_altitude_delta altitude kalainan sa cm
- oras sa pagpamakak sa mga segundo nga wala’y paglihok pagkahuman sa usa ka epekto
2.2.3 API flow chart
2.2.4 Demo code
Ang mosunod nga demonstration code nagbasa sa datos gikan sa accelerometer ug pressure sensor ug nakuha ang fall event code.
2.2.5 Algorithm performance
Ang fall detection algorithm naggamit lang og data gikan sa accelerometer ug pressure sensor ug nagdagan sa ubos nga frequency (25 Hz) aron makunhuran ang konsumo sa kuryente.
2.3 Sampang aplikasyon
Ang MotionFD middleware mahimong dali nga mamaniobra sa paghimo og mga aplikasyon sa user; ingonampAng aplikasyon gihatag sa folder sa Application.
Gidisenyo kini nga modagan sa NUCLEO-F401RE, NUCLEO-U575ZI-Q o NUCLEO-L152RE development board nga konektado sa X-NUCLEO-IKS4A1 o X-NUCLEO-IKS01A3 expansion board.
Giila sa aplikasyon ang panghitabo sa pagkahulog sa tiggamit sa tinuud nga oras.
Ang numero sa ibabaw nagpakita sa user button B1 ug ang tulo ka LEDs sa NUCLEO-F401RE board. Kung ang board gipaandar, ang LED LD3 (PWR) mo-ON.
Ang koneksyon sa USB cable gikinahanglan aron mamonitor ang real-time nga datos. Ang board gipadagan sa PC pinaagi sa koneksyon sa USB. Kini nga working mode nagtugot sa nakit-an nga user fall event, accelerometer ug pressure sensor data, time stamp ug sa kadugayan ang ubang data sa sensor, sa tinuod nga panahon, gamit ang MEMS-Studio.
2.4 MEMS-Studio nga aplikasyon
Ang sampAng aplikasyon naggamit sa MEMS-Studio nga aplikasyon, nga mahimong ma-download gikan sa www.st.com.
Lakang 1. Siguroha nga ang gikinahanglan nga mga drayber na-install ug ang STM32 Nucleo board nga adunay tukma nga expansion board konektado sa PC.
Lakang 2. Ilunsad ang MEMS-Studio nga aplikasyon aron maablihan ang nag-unang bintana sa aplikasyon.
Kung ang usa ka STM32 Nucleo board nga adunay gisuportahan nga firmware konektado sa PC, awtomatiko kini nga makit-an.
Pindota ang [Connect] nga buton aron ma-establisar ang koneksyon sa evaluation board.
Lakang 3. Kung konektado sa usa ka STM32 Nucleo board nga adunay suportadong firmware [Library Evaluation] tab giablihan.
Sa pagsugod ug pagpahunong sa data streaming, i-toggle ang angay [Start] 
o [Hunong] 
buton sa gawas nga bertikal nga tool bar.
Ang datos nga gikan sa konektado nga sensor mahimong viewed pagpili sa [Data Table] tab sa sulod nga bertikal tool ba
Lakang 4. Pag-klik sa [Fall Detection] aron maablihan ang gipahinungod nga bintana sa aplikasyon.
Lakang 5. I-klik ang [Save To File] aron ablihan ang dataloging configuration window. Pilia ang data sa sensor ug pag-ila sa pagkahulog aron ma-save sa file. Mahimo ka magsugod o mohunong sa pagtipig pinaagi sa pag-klik sa katugbang nga buton.
Lakang 6. Mahimong gamiton ang Data Injection mode aron ipadala ang nakuha nga datos sa library ug madawat ang resulta. Pilia ang tab nga [Data Injection] sa bertikal nga tool bar aron maablihan ang gipahinungod view alang niini nga pagpaandar.
Lakang 7. I-klik ang [Browse] nga buton para mapili ang file uban sa nakuha na nga datos sa CSV format.
Ang datos i-load sa lamesa sa kasamtangan view.
Ang ubang mga buton mahimong aktibo. Mahimo nimong i-klik ang:
- Butang [Offline Mode] aron i-on/off ang firmware offline mode (mode nga gigamit ang nakuha nga datos kaniadto).
– [Start]/[Stop]/[Lakang]/[Repeat] nga buton para makontrol ang data feed gikan sa MEMS-Studio ngadto sa library.
2.5 Mga Reperensya
Ang tanan nga mosunod nga mga kapanguhaan libre nga magamit sa www.st.com.
- UM1859: Pagsugod sa X-CUBE-MEMS1 motion MEMS ug environmental sensor software expansion para sa STM32Cube
- UM1724: STM32 Nucleo-64 nga mga tabla (MB1136)
- UM3233: Pagsugod sa MEMS-Studio
Kasaysayan sa rebisyon
Talaan 4. Kasaysayan sa pagbag-o sa dokumento
| Petsa | Bersyon | Mga kausaban |
| 22-Sept-2017 | 1 | Inisyal nga pagpagawas. |
| 6-Peb-18 | 2 | Gidugang nga mga pakisayran sa NUCLEO-L152RE development board ug Table 2. Elapsed time (μs) algorithm. |
| 21-Mar-18 | 3 | Gi-update nga Pasiuna ug Seksyon 2.1 MotionFD sa ibabawview. |
| 19-Peb-19 | 4 | Gi-update nga Talaan 2. Algoritmo sa Elapsed time (μs) ug Figure 2. STM32 Nucleo: LEDs, button, jumper. Gidugang ang X-NUCLEO-IKS01A3 nga impormasyon sa pagpaangay sa expansion board. |
| 17-Sept-24 | 5 | Gi-update nga Seksyon Pasiuna, Seksyon 2.1: MotionFD mataposview, Seksyon 2.2.1: Deskripsyon sa library sa MotionFD, Seksyon 2.2.2: Mga MotionFD API, Seksyon 2.2.5: Pagpasundayag sa algorithm, Seksyon 2.3: SampAng aplikasyon, Seksyon 2.4: MEMS-Studio nga aplikasyon |
IMPORTANTE NGA PAHIBALO – BASAHA NGA MAAYO
Ang STMicroelectronics NV ug ang mga subsidiary niini ("ST") nagreserba sa katungod sa paghimo og mga pagbag-o, pagkorihir, pagpauswag, pagbag-o, ug pagpaayo sa mga produkto sa ST ug/o niini nga dokumento bisan unsang orasa nga wala’y pahibalo. Ang mga pumapalit kinahanglan nga makakuha sa pinakabag-o nga may kalabutan nga impormasyon sa mga produkto sa ST sa dili pa magbutang og mga order. Ang mga produkto sa ST gibaligya subay sa mga termino ug kondisyon sa pagbaligya sa ST sa panahon sa pag-ila sa order.
Ang mga pumapalit mao ray responsable sa pagpili, pagpili, ug paggamit sa mga produkto sa ST ug walay tulubagon ang ST alang sa tabang sa aplikasyon o sa disenyo sa mga produkto sa mga pumapalit.
Walay lisensya, gipahayag o gipasabot, sa bisan unsang katungod sa intelektwal nga kabtangan ang gihatag sa ST dinhi.
Ang pagbaligya pag-usab sa mga produkto sa ST nga adunay mga probisyon nga lahi sa impormasyon nga gilatid dinhi magwagtang sa bisan unsang warranty nga gihatag sa ST alang sa maong produkto.
Ang ST ug ang ST logo kay mga marka sa ST. Para sa dugang nga impormasyon bahin sa ST trademarks, tan-awa ang www.st.com/trademarks. Ang tanan nga ubang mga ngalan sa produkto o serbisyo gipanag-iya sa ilang tag-iya.
Ang impormasyon niini nga dokumento mopuli ug mopuli sa impormasyon nga gihatag kaniadto sa bisan unsang naunang bersyon niini nga dokumento.
© 2024 STMicroelectronics – Tanang katungod gigahin
Mga Dokumento / Mga Kapanguhaan
 |
ST X-CUBE-MEMS1 MotionFD Real Time Fall Detection Library [pdf] Manwal sa Gumagamit 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 |
