UM2275
Panduan pengguna
Memulai dengan pustaka deteksi jatuh waktu nyata MotionFD dalam ekspansi X-CUBE-MEMS1 untuk STM32Cube
Perkenalan
MotionEC adalah komponen pustaka middleware dari perangkat lunak X-CUBE-MEMS1 dan berjalan pada STM3z2. Komponen ini menyediakan informasi real-time tentang orientasi perangkat dan status pergerakan berdasarkan data dari perangkat.
Memberikan keluaran berikut: orientasi perangkat (kuaternion, sudut Euler), rotasi perangkat (fungsionalitas giroskop virtual), vektor gravitasi dan percepatan linear.
Perpustakaan ini dimaksudkan untuk bekerja dengan ST MEMS saja.
Algoritma ini disediakan dalam format pustaka statis dan dirancang untuk digunakan pada mikrokontroler STM32 berdasarkan arsitektur ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 dan ARM® Cortex®-M7.
Ini dibangun di atas teknologi perangkat lunak STM32Cube untuk memudahkan portabilitas di berbagai mikrokontroler STM32.
Perangkat lunak ini dilengkapi dengan sampImplementasinya berjalan pada papan ekspansi X-NUCLEO-IKS4A1 atau X-NUCLEO-IKS01A3 pada papan pengembangan NUCLEO-F401RE, NUCLEO-U575ZI-Q atau NUCLEO-L152RE.
Akronim dan singkatan
Tabel 1. Daftar akronim
| Akronim | Keterangan |
| API | Antarmuka pemrograman aplikasi |
| BSP | Paket dukungan papan |
| Antarmuka Pengguna (GUI) | Antarmuka pengguna grafis |
| HAL | Lapisan abstraksi perangkat keras |
| ide | Lingkungan pengembangan terintegrasi |
Pustaka middleware MotionFD dalam perluasan perangkat lunak X-CUBE-MEMS1 untuk STM32Cube
2.1 MotionFD selesaiview
Pustaka MotionFD memperluas fungsionalitas perangkat lunak X-CUBE-MEMS1.
Pustaka memperoleh data dari akselerometer dan sensor tekanan serta menyediakan informasi tentang kejadian terjatuhnya pengguna berdasarkan data dari perangkat.
Perpustakaan dirancang hanya untuk ST MEMS. Fungsionalitas dan kinerja saat menggunakan sensor MEMS lainnya tidak dianalisis dan mungkin berbeda secara signifikan dari yang dijelaskan dalam dokumen.
SampImplementasinya tersedia untuk papan ekspansi X-NUCLEO-IKS4A1 dan X-NUCLEO-IKS01A3, yang dipasang pada papan pengembangan NUCLEO-F401RE, NUCLEO-U575ZI-Q atau NUCLEO-L152RE.
2.2 Perpustakaan MotionFD
Informasi teknis yang sepenuhnya menjelaskan fungsi dan parameter API MotionFD dapat ditemukan di HTML MotionFD_Package.chm yang dikompilasi file terletak di folder Dokumentasi.
2.2.1 Deskripsi pustaka MotionFD
Pustaka deteksi jatuh MotionFD mengelola data yang diperoleh dari akselerometer dan sensor tekanan; pustaka ini menampilkan:
- kemungkinan untuk membedakan apakah pengguna terjatuh atau tidak
- pengenalan hanya berdasarkan data accelerometer dan sensor tekanan
- data sensor accelerometer dan tekanan yang diperlukanampfrekuensi ling adalah 25 Hz
- kebutuhan sumber daya:
– Cortex-M3: 3.6 kB kode dan 3.2 kB memori data
– Cortex-M33: 3.4 kB kode dan 3.2 kB memori data
– Cortex-M4: 3.4 kB kode dan 3.2 kB memori data
– Cortex-M7: 3.4 kB kode dan 3.2 memori data - tersedia untuk arsitektur ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 dan ARM Cortex-M7
2.2.2 API MotionFD
API pustaka MotionFD adalah:
- uint8_t MotionFD_GetLibVersion(char *versi)
– mengambil versi perpustakaan
– *version adalah penunjuk ke array 35 karakter
– mengembalikan jumlah karakter dalam string versi - batalkan MotionFD_Initialize(batalkan)
– melakukan inisialisasi pustaka MotionFD dan pengaturan mekanisme internal
Catatan: Fungsi ini harus dipanggil sebelum menggunakan pustaka deteksi jatuh dan modul CRC dalam mikrokontroler STM32 (dalam register pengaktifan jam periferal RCC) harus diaktifkan.
- void MotionFD_Update (MFD_input_t *data_masuk, MFD_output_t *data_keluar)
– menjalankan algoritma deteksi jatuh
– *Parameter data_in adalah penunjuk ke struktur dengan data masukan
– parameter untuk tipe struktur MFD_input_t adalah:
◦ AccX adalah nilai sensor accelerometer pada sumbu X dalam mg
◦ AccY adalah nilai sensor accelerometer pada sumbu Y dalam mg
◦ AccZ adalah nilai sensor accelerometer pada sumbu Z dalam mg
◦ Press adalah nilai sensor tekanan dalam hPa
– *parameter data_out adalah penunjuk ke enum dengan item berikut:
◦ MFD_TIDAK JATUH = 0
◦ MFD_JATUH = 1 - void MotionFD_SetKnobs(float ambang batas jatuh, int32_t delta_ketinggian_jatuh, float waktu_berbaring)
– mengatur parameter konfigurasi perpustakaan
– ambang batas jatuh ambang batas percepatan dalam mg
– fall_altitude_delta perbedaan ketinggian dalam cm
– waktu berbaring dalam detik tanpa gerakan setelah benturan - void MotionFD_GetKnobs(float *ambang_jatuh, int32_t *delta_ketinggian_jatuh, float *waktu_berbaring)
– mendapatkan parameter konfigurasi perpustakaan
– ambang batas jatuh ambang batas percepatan dalam mg
– fall_altitude_delta perbedaan ketinggian dalam cm
– waktu berbaring dalam detik tanpa gerakan setelah benturan
2.2.3 Diagram alir API
2.2.4 Kode demo
Kode demonstrasi berikut membaca data dari akselerometer dan sensor tekanan dan mendapatkan kode kejadian jatuh.
2.2.5 Kinerja algoritma
Algoritma deteksi jatuh hanya menggunakan data dari akselerometer dan sensor tekanan dan berjalan pada frekuensi rendah (25 Hz) untuk mengurangi konsumsi daya.
tahun 2.3ampaplikasi
Middleware MotionFD dapat dengan mudah dimanipulasi untuk membangun aplikasi pengguna;ample aplikasi disediakan di folder Aplikasi.
Ia dirancang untuk berjalan pada papan pengembangan NUCLEO-F401RE, NUCLEO-U575ZI-Q atau NUCLEO-L152RE yang terhubung ke papan ekspansi X-NUCLEO-IKS4A1 atau X-NUCLEO-IKS01A3.
Aplikasi mengenali kejadian terjatuhnya pengguna secara real-time.
Gambar di atas menunjukkan tombol pengguna B1 dan tiga LED pada papan NUCLEO-F401RE. Setelah papan diberi daya, LED LD3 (PWR) menyala.
Koneksi kabel USB diperlukan untuk memantau data waktu nyata. Papan ini ditenagai oleh PC melalui koneksi USB. Mode kerja ini memungkinkan data kejadian jatuh pengguna yang terdeteksi, accelerometer dan sensor tekanan, waktu stamp dan akhirnya data sensor lainnya, secara real-time, menggunakan MEMS-Studio.
2.4 Aplikasi MEMS-Studio
SampAplikasi ini menggunakan aplikasi MEMS-Studio yang dapat didownload di www.st.com.
Langkah 1. Pastikan driver yang diperlukan telah diinstal dan papan Nukleo STM32 dengan papan ekspansi yang sesuai terhubung ke PC.
Langkah 2. Luncurkan aplikasi MEMS-Studio untuk membuka jendela aplikasi utama.
Jika papan STM32 Nucleo dengan firmware yang didukung terhubung ke PC, maka secara otomatis terdeteksi.
Tekan tombol [Hubungkan] untuk membuat koneksi ke papan evaluasi.
Langkah 3. Saat terhubung ke papan STM32 Nucleo dengan firmware yang didukung, tab [Evaluasi Perpustakaan] dibuka.
Untuk memulai dan menghentikan streaming data, alihkan tombol [Mulai] yang sesuai 
atau [Berhenti] 
tombol pada bilah alat vertikal luar.
Data yang berasal dari sensor yang terhubung bisa berupa viewdengan memilih tab [Tabel Data] pada alat vertikal bagian dalam
Langkah 4. Klik [Deteksi Jatuh] untuk membuka jendela aplikasi khusus.
Langkah 5. Klik [Simpan Ke File] untuk membuka jendela konfigurasi pencatatan data. Pilih sensor dan data deteksi jatuh yang akan disimpan di fileAnda dapat memulai atau menghentikan penyimpanan dengan mengklik tombol yang sesuai.
Langkah 6. Mode Injeksi Data dapat digunakan untuk mengirim data yang diperoleh sebelumnya ke perpustakaan dan menerima hasilnya. Pilih tab [Injeksi Data] pada bilah alat vertikal untuk membuka menu khusus view untuk fungsi ini.
Langkah 7. Klik tombol [Browse] untuk memilih file dengan data yang diambil sebelumnya dalam format CSV.
Data akan dimuat ke dalam tabel di saat ini view.
Tombol lainnya akan aktif. Anda dapat mengklik:
– Tombol [Mode Offline] untuk menghidupkan/mematikan mode offline firmware (mode yang memanfaatkan data yang diambil sebelumnya).
– Tombol [Mulai]/[Berhenti]/[Langkah]/[Ulangi] untuk mengontrol umpan data dari MEMS-Studio ke perpustakaan.
2.5 Referensi
Semua sumber daya berikut tersedia secara gratis di www.st.com.
- UM1859: Memulai dengan MEMS gerak X-CUBE-MEMS1 dan perluasan perangkat lunak sensor lingkungan untuk STM32Cube
- UM1724: Papan Nukleo-32 STM64 (MB1136)
- UM3233: Memulai MEMS-Studio
Riwayat revisi
Tabel 4. Riwayat revisi dokumen
| Tanggal | Versi | Perubahan |
| 22 September 2017 | 1 | Rilis awal. |
| 6 Februari 18 | 2 | Menambahkan referensi ke papan pengembangan NUCLEO-L152RE dan Tabel 2. Algoritma waktu berlalu (μs). |
| 21 Maret 18 | 3 | Pengenalan dan Bagian 2.1 MotionFD yang Diperbaruiview. |
| 19 Februari 19 | 4 | Tabel yang Diperbarui 2. Algoritma waktu berlalu (μs) dan Gambar 2. Inti STM32: LED, tombol, jumper. Menambahkan informasi kompatibilitas papan ekspansi X-NUCLEO-IKS01A3. |
| 17 September 24 | 5 | Bagian Pendahuluan yang Diperbarui, Bagian 2.1: MotionFD berakhirview, Bagian 2.2.1: Deskripsi pustaka MotionFD, Bagian 2.2.2: API MotionFD, Bagian 2.2.5: Kinerja algoritma, Bagian 2.3: Sampaplikasi, Bagian 2.4: Aplikasi MEMS-Studio |
PEMBERITAHUAN PENTING – BACA DENGAN SEKSAMA
STMicroelectronics NV dan anak perusahaannya (“ST”) berhak melakukan perubahan, koreksi, penyempurnaan, modifikasi, dan perbaikan pada produk ST dan/atau dokumen ini kapan saja tanpa pemberitahuan. Pembeli harus memperoleh informasi relevan terkini tentang produk ST sebelum melakukan pemesanan. Produk ST dijual sesuai dengan syarat dan ketentuan penjualan ST yang berlaku pada saat konfirmasi pemesanan.
Pembeli bertanggung jawab penuh atas pilihan, pemilihan, dan penggunaan produk ST dan ST tidak bertanggung jawab atas bantuan aplikasi atau desain produk pembeli.
Tidak ada lisensi, tersurat maupun tersirat, terhadap hak kekayaan intelektual apa pun yang diberikan oleh ST di sini.
Penjualan kembali produk ST dengan ketentuan yang berbeda dari informasi yang ditetapkan di sini akan membatalkan garansi apa pun yang diberikan oleh ST untuk produk tersebut.
ST dan logo ST adalah merek dagang ST. Untuk informasi tambahan tentang merek dagang ST, lihat www.st.com/merek dagangSemua nama produk atau layanan lainnya adalah milik pemiliknya masing-masing.
Informasi dalam dokumen ini menggantikan dan mengganti informasi yang sebelumnya diberikan dalam versi dokumen ini sebelumnya.
© 2024 STMicroelectronics – Semua hak dilindungi undang-undang
Dokumen / Sumber Daya
 |
ST X-CUBE-MEMS1 Perpustakaan Deteksi Jatuh MotionFD Secara Real Time [Bahasa Indonesia:] Panduan Pengguna Pustaka Deteksi Jatuh MotionFD Real Time X-CUBE-MEMS1, Pustaka Deteksi Jatuh MotionFD Real Time, Pustaka Deteksi Jatuh Real Time, Pustaka Deteksi Jatuh, Pustaka Deteksi, Pustaka |
