UM2275
Manual pangguna
Miwiti perpustakaan deteksi tiba-nyata MotionFD ing ekspansi X-CUBE-MEMS1 kanggo STM32Cube
Pambuka
MotionEC minangka komponen perpustakaan middleware saka piranti lunak X-CUBE-MEMS1 lan mlaku ing STM3z2. Nyedhiyakake informasi wektu nyata babagan orientasi piranti lan status gerakan adhedhasar data saka piranti.
Iki nyedhiyakake output ing ngisor iki: orientasi piranti (quaternions, sudut Euler), rotasi piranti (fungsi giroskop virtual), vektor gravitasi lan percepatan linear.
Pustaka iki dimaksudaké kanggo bisa karo ST MEMS mung.
Algoritma kasebut kasedhiya ing format perpustakaan statis lan dirancang kanggo digunakake ing mikrokontroler STM32 adhedhasar ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 lan ARM® Arsitèktur Cortex®-M7.
Dibangun ing ndhuwur teknologi piranti lunak STM32Cube kanggo nggampangake portabilitas ing macem-macem mikrokontroler STM32.
Piranti lunak nerangake karo sampimplementasine le mlaku ing Papan expansion X-NUCLEO-IKS4A1 utawa X-NUCLEO-IKS01A3 ing papan pangembangan NUCLEO-F401RE, NUCLEO-U575ZI-Q utawa NUCLEO-L152RE.
Akronim lan singkatan
Tabel 1. Daftar akronim
| Akronim | Katrangan |
| API | Antarmuka pemrograman aplikasi |
| BSP | Paket dukungan papan |
| GUI | Antarmuka panganggo grafis |
| HAL | Lapisan abstraksi hardware |
| IDE | Lingkungan pangembangan terpadu |
perpustakaan middleware MotionFD ing expansion software X-CUBE-MEMS1 kanggo STM32Cube
2.1 MotionFD liwatview
Perpustakaan MotionFD ngembangake fungsi piranti lunak X-CUBE-MEMS1.
Pustaka ndarbeni data saka akselerometer lan sensor tekanan lan menehi informasi babagan acara tiba pangguna adhedhasar data saka piranti.
Perpustakaan iki dirancang kanggo ST MEMS mung. Fungsi lan kinerja nalika nggunakake sensor MEMS liyane ora analisa lan bisa Ngartekno beda saka apa diterangake ing document.
Sampimplementasine le kasedhiya kanggo Papan expansion X-NUCLEO-IKS4A1 lan X-NUCLEO-IKS01A3, dipasang ing Papan pangembangan NUCLEO-F401RE, NUCLEO-U575ZI-Q utawa NUCLEO-L152RE.
2.2 Pustaka MotionFD
Informasi teknis kanthi lengkap njlèntrèhaké fungsi lan paramèter saka MotionFD API bisa ditemokaké ing MotionFD_Package.chm dikompilasi HTML file dumunung ing folder Dokumentasi.
2.2.1 MotionFD gambaran perpustakaan
Perpustakaan deteksi tiba MotionFD ngatur data sing dipikolehi saka akselerometer lan sensor tekanan; iku fitur:
- kamungkinan kanggo mbedakake yen pangguna tiba utawa ora
- pangenalan mung adhedhasar data tembang macapat lan sensor tekanan
- data tembang macapat lan sensor meksa dibutuhake sampfrekuensi ling punika 25 Hz
- syarat sumber daya:
- Cortex-M3: 3.6 kB kode lan 3.2 kB memori data
- Cortex-M33: 3.4 kB kode lan 3.2 kB memori data
- Cortex-M4: 3.4 kB kode lan 3.2 kB memori data
- Cortex-M7: 3.4 kB kode lan 3.2 memori data - kasedhiya kanggo arsitektur ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 lan ARM Cortex-M7
2.2.2 MotionFD API
API perpustakaan MotionFD yaiku:
- uint8_t MotionFD_GetLibVersion(char *versi)
– retrieves versi perpustakaan
– *Versi minangka pointer menyang array saka 35 karakter
– ngasilake nomer karakter ing senar versi - void MotionFD_Initialize(void)
- nindakake initialization perpustakaan MotionFD lan persiyapan mekanisme internal
Cathetan: Fungsi iki kudu disebut sadurunge nggunakake perpustakaan deteksi tiba lan modul CRC ing STM32 mikrokontroler (ing RCC jam peripheral ngaktifake register) kudu aktif.
- void MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
- nglakokake algoritma deteksi tiba
– *parameter data_in minangka penunjuk menyang struktur kanthi data input
– paramèter kanggo jinis struktur MFD_input_t yaiku:
◦ AccX minangka nilai sensor accelerometer ing sumbu X ing mg
◦ AccY minangka nilai sensor akselerometer ing sumbu Y ing mg
◦ AccZ minangka nilai sensor accelerometer ing sumbu Z ing mg
◦ Press minangka nilai sensor tekanan ing hPa
– *parameter data_out minangka pointer menyang enum kanthi item ing ngisor iki:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
- nyetel paramèter konfigurasi perpustakaan
– ambang akselerasi fall_threshold ing mg
– fall_altitude_delta prabédan dhuwur ing cm
– wektu ngapusi ing detik tanpa gerakan sawise impact - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
- entuk paramèter konfigurasi perpustakaan
– ambang akselerasi fall_threshold ing mg
– fall_altitude_delta prabédan dhuwur ing cm
– wektu ngapusi ing detik tanpa gerakan sawise impact
2.2.3 diagram alur API
2.2.4 Kode demo
Kode demonstrasi ing ngisor iki maca data saka akselerometer lan sensor tekanan lan entuk kode acara tiba.
2.2.5 Kinerja algoritma
Algoritma deteksi tiba mung nggunakake data saka accelerometer lan sensor tekanan lan mlaku ing frekuensi kurang (25 Hz) kanggo ngurangi konsumsi daya.
2.3 Sampl aplikasi
Middleware MotionFD bisa gampang dimanipulasi kanggo mbangun aplikasi pangguna; minangkaampAplikasi kasedhiya ing folder Aplikasi.
Iki dirancang kanggo mlaku ing papan pangembangan NUCLEO-F401RE, NUCLEO-U575ZI-Q utawa NUCLEO-L152RE sing disambungake menyang papan ekspansi X-NUCLEO-IKS4A1 utawa X-NUCLEO-IKS01A3.
Aplikasi ngenali acara tiba pangguna ing wektu nyata.
Tokoh ing ndhuwur nuduhake tombol pangguna B1 lan telung LED saka papan NUCLEO-F401RE. Sawise papan diuripake, LED LD3 (PWR) diuripake.
Sambungan kabel USB dibutuhake kanggo ngawasi data wektu nyata. Papan didhukung dening PC liwat sambungan USB. Mode kerja iki ngidini pangguna tiba acara sing dideteksi, tembang macapat lan data sensor tekanan, wektu stamp lan pungkasanipun data sensor liyane, ing wektu nyata, nggunakake MEMS-Studio.
2.4 Aplikasi MEMS-Studio
Para sampaplikasi le nggunakake aplikasi MEMS-Studio, kang bisa diundhuh saka www.st.com.
Langkah 1. Priksa manawa driver sing dibutuhake wis diinstal lan papan STM32 Nucleo kanthi papan ekspansi sing cocog disambungake menyang PC.
Langkah 2. Bukak aplikasi MEMS-Studio kanggo mbukak jendhela aplikasi utama.
Yen papan STM32 Nucleo kanthi perangkat kukuh sing didhukung disambungake menyang PC, dideteksi kanthi otomatis.
Pencet tombol [Sambungake] kanggo nggawe sambungan menyang papan evaluasi.
Langkah 3. Nalika disambungake menyang papan STM32 Nucleo karo firmware didhukung tab [Evaluasi Pustaka] dibukak.
Kanggo miwiti lan mungkasi streaming data, pilih [Mulai] sing cocog. 
utawa [Stop] 
tombol ing toolbar vertikal njaba.
Data sing teka saka sensor sing disambungake bisa viewed milih tab [Tabel Data] ing alat vertikal batin
Langkah 4. Klik ing [Deteksi Tiba] kanggo mbukak jendhela aplikasi khusus.
Langkah 5. Klik ing [Simpen Kanggo File] kanggo mbukak jendhela konfigurasi dataloging. Pilih sensor lan data deteksi tiba kanggo disimpen ing file. Sampeyan bisa miwiti utawa mungkasi nyimpen kanthi ngeklik tombol sing cocog.
Langkah 6. Mode Injeksi Data bisa digunakake kanggo ngirim data sing dipikolehi sadurunge menyang perpustakaan lan nampa asil. Pilih tab [Data Injection] ing toolbar vertikal kanggo mbukak darmabakti view kanggo fungsi iki.
Langkah 7. Klik tombol [Browse] kanggo milih file karo data sing dijupuk sadurunge ing format CSV.
Data bakal dimuat menyang tabel ing saiki view.
Tombol liyane bakal aktif. Sampeyan bisa klik ing:
- Tombol [Mode Offline] kanggo ngaktifake / mateni mode offline perangkat kukuh (mode nggunakake data sing dijupuk sadurunge).
– Tombol [Mulai]/[Stop]/[Langkah]/[Baleni] kanggo ngontrol feed data saka MEMS-Studio menyang perpustakaan.
2.5 Referensi
Kabeh sumber daya ing ngisor iki kasedhiya gratis ing www.st.com.
- UM1859: Miwiti gerakan X-CUBE-MEMS1 MEMS lan ekspansi piranti lunak sensor lingkungan kanggo STM32Cube
- UM1724: Papan STM32 Nucleo-64 (MB1136)
- UM3233: Miwiti karo MEMS-Studio
Riwayat revisi
Tabel 4. Riwayat revisi dokumen
| Tanggal | Versi | Owah-owahan |
| 22-Sep-2017 | 1 | Rilis wiwitan. |
| 6-Feb-18 | 2 | Referensi sing ditambahake menyang papan pangembangan NUCLEO-L152RE lan Tabel 2. Algoritma wektu (μs). |
| 21-Mar-18 | 3 | Dianyari Pambuka lan Bagean 2.1 MotionFD liwatview. |
| 19-Feb-19 | 4 | Dianyari Tabel 2. Algoritma wektu suwene (μs) lan Gambar 2. STM32 Nucleo: LED, tombol, jumper. Ditambahake informasi kompatibilitas papan ekspansi X-NUCLEO-IKS01A3. |
| 17-Sep-24 | 5 | Dianyari bagean Pambuka, bagean 2.1: MotionFD liwatview, Bagean 2.2.1: Deskripsi perpustakaan MotionFD, Bagean 2.2.2: API MotionFD, Bagean 2.2.5: Kinerja algoritma, Bagean 2.3: Sampaplikasi le, bagean 2.4: aplikasi MEMS-Studio |
WARTA PENTING - Wacan kanthi ati-ati
STMicroelectronics NV lan anak perusahaan ("ST") nduweni hak kanggo nggawe owahan, koreksi, dandan, modifikasi, lan dandan kanggo produk ST lan / utawa dokumen iki sawayah-wayah tanpa kabar. Para panuku kudu entuk informasi paling anyar babagan produk ST sadurunge nggawe pesenan. Produk ST didol miturut syarat lan kahanan adol ST nalika diakoni pesenan.
Para panuku mung tanggung jawab kanggo milih, milih, lan nggunakake produk ST lan ST ora duwe tanggung jawab kanggo pitulung aplikasi utawa desain produk para panuku.
Ora ana lisensi, nyata utawa diwenehake, kanggo hak properti intelektual sing diwenehake dening ST ing kene.
Adol maneh produk ST kanthi pranata sing beda karo informasi sing kasebut ing kene bakal ngilangi garansi sing diwenehake dening ST kanggo produk kasebut.
ST lan logo ST iku merek dagang saka ST. Kanggo informasi tambahan babagan merek dagang ST, waca www.st.com/trademarks. Kabeh jeneng produk utawa layanan liyane minangka properti sing nduweni.
Informasi ing dokumen iki ngganti lan ngganti informasi sing diwenehake sadurunge ing versi sadurunge dokumen iki.
© 2024 STMicroelectronics – Kabeh hak dilindhungi undhang-undhang
Dokumen / Sumber Daya
 |
ST X-CUBE-MEMS1 MotionFD Perpustakaan Deteksi Tiba Wektu Nyata [pdf] Manual pangguna 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, Deteksi Pustaka, Library |
