UM2275
Manual pengguna
Bermula dengan perpustakaan pengesanan jatuh masa nyata MotionFD dalam pengembangan X-CUBE-MEMS1 untuk STM32Cube
pengenalan
MotionEC ialah komponen perpustakaan middleware bagi perisian X-CUBE-MEMS1 dan berjalan pada STM3z2. Ia menyediakan maklumat masa nyata tentang orientasi peranti dan status pergerakan berdasarkan data daripada peranti.
Ia menyediakan output berikut: orientasi peranti (quaternions, sudut Euler), putaran peranti (fungsi giroskop maya), vektor graviti dan pecutan linear.
Pustaka ini bertujuan untuk berfungsi dengan ST MEMS sahaja.
Algoritma disediakan dalam format perpustakaan statik dan direka bentuk untuk digunakan pada mikropengawal STM32 berdasarkan ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 dan ARM® Seni bina Cortex®-M7.
Ia dibina di atas teknologi perisian STM32Cube untuk memudahkan kemudahalihan merentas mikropengawal STM32 yang berbeza.
Perisian ini disertakan dengan samppelaksanaan yang dijalankan pada papan pengembangan X-NUCLEO-IKS4A1 atau X-NUCLEO-IKS01A3 pada papan pembangunan NUCLEO-F401RE, NUCLEO-U575ZI-Q atau NUCLEO-L152RE.
Akronim dan singkatan
Jadual 1. Senarai akronim
| Akronim | Penerangan |
| API | Antara muka pengaturcaraan aplikasi |
| BSP | Pakej sokongan papan |
| GUI | Antara muka pengguna grafik |
| HAL | Lapisan abstraksi perkakasan |
| IDE | Persekitaran pembangunan bersepadu |
Pustaka middleware MotionFD dalam pengembangan perisian X-CUBE-MEMS1 untuk STM32Cube
2.1 MotionFD tamatview
Pustaka MotionFD mengembangkan fungsi perisian X-CUBE-MEMS1.
Perpustakaan memperoleh data daripada pecutan dan penderia tekanan dan menyediakan maklumat tentang peristiwa kejatuhan pengguna berdasarkan data daripada peranti.
Perpustakaan ini direka untuk ST MEMS sahaja. Kefungsian dan prestasi apabila menggunakan penderia MEMS lain tidak dianalisis dan boleh berbeza dengan ketara daripada apa yang diterangkan dalam dokumen.
Samppelaksanaan tersedia untuk papan pengembangan X-NUCLEO-IKS4A1 dan X-NUCLEO-IKS01A3, yang dipasang pada papan pembangunan NUCLEO-F401RE, NUCLEO-U575ZI-Q atau NUCLEO-L152RE.
2.2 Perpustakaan MotionFD
Maklumat teknikal yang menerangkan sepenuhnya fungsi dan parameter API MotionFD boleh didapati dalam HTML tersusun MotionFD_Package.chm file terdapat dalam folder Dokumentasi.
2.2.1 Penerangan perpustakaan MotionFD
Pustaka pengesanan jatuh MotionFD menguruskan data yang diperoleh daripada pecutan dan sensor tekanan; ia mempunyai ciri:
- kemungkinan untuk membezakan sama ada kejatuhan pengguna berlaku atau tidak
- pengecaman hanya berdasarkan data pecutan dan penderia tekanan
- data pecutan dan penderia tekanan yang diperlukan sampfrekuensi ling ialah 25 Hz
- keperluan sumber:
– Korteks-M3: 3.6 kB kod dan 3.2 kB memori data
– Korteks-M33: 3.4 kB kod dan 3.2 kB memori data
– Korteks-M4: 3.4 kB kod dan 3.2 kB memori data
– Cortex-M7: 3.4 kB kod dan 3.2 memori data - tersedia untuk seni bina ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 dan ARM Cortex-M7
2.2.2 MotionFD API
API perpustakaan MotionFD ialah:
- uint8_t MotionFD_GetLibVersion(char *versi)
– mendapatkan semula versi perpustakaan
– *versi ialah penunjuk kepada tatasusunan 35 aksara
– mengembalikan bilangan aksara dalam rentetan versi - void MotionFD_Initialize(void)
– melakukan permulaan perpustakaan MotionFD dan persediaan mekanisme dalaman
Nota: Fungsi ini mesti dipanggil sebelum menggunakan pustaka pengesanan jatuh dan modul CRC dalam mikropengawal STM32 (dalam RCC periferal clock enable register) perlu didayakan.
- batalkan MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
– melaksanakan algoritma pengesanan jatuh
– *parameter data_in ialah penunjuk kepada struktur dengan data input
– parameter untuk jenis struktur MFD_input_t ialah:
◦ AccX ialah nilai sensor pecutan dalam paksi X dalam mg
◦ AccY ialah nilai sensor pecutan dalam paksi Y dalam mg
◦ AccZ ialah nilai sensor pecutan dalam paksi Z dalam mg
◦ Tekan ialah nilai sensor tekanan dalam hPa
– *parameter data_out ialah penunjuk ke enum dengan item berikut:
◦ MFD_NOFALL = 0
◦ MFD_JATUH = 1 - void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
– menetapkan parameter konfigurasi perpustakaan
– jatuh_ambang ambang pecutan dalam mg
– fall_altitude_delta perbezaan ketinggian dalam cm
– masa masa berbaring dalam beberapa saat tanpa pergerakan selepas hentaman - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
– mendapat parameter konfigurasi perpustakaan
– jatuh_ambang ambang pecutan dalam mg
– fall_altitude_delta perbezaan ketinggian dalam cm
– masa masa berbaring dalam beberapa saat tanpa pergerakan selepas hentaman
2.2.3 Carta alir API
2.2.4 Kod demo
Kod demonstrasi berikut membaca data daripada pecutan dan penderia tekanan dan mendapat kod peristiwa jatuh.
2.2.5 Prestasi algoritma
Algoritma pengesanan jatuh hanya menggunakan data daripada pecutan dan sensor tekanan dan berjalan pada frekuensi rendah (25 Hz) untuk mengurangkan penggunaan kuasa.
2.3 Samppermohonan itu
Perisian tengah MotionFD boleh dimanipulasi dengan mudah untuk membina aplikasi pengguna; sebagaiampaplikasi disediakan dalam folder Aplikasi.
Ia direka bentuk untuk dijalankan pada papan pembangunan NUCLEO-F401RE, NUCLEO-U575ZI-Q atau NUCLEO-L152RE yang disambungkan kepada papan pengembangan X-NUCLEO-IKS4A1 atau X-NUCLEO-IKS01A3.
Aplikasi ini mengiktiraf peristiwa kejatuhan pengguna dalam masa nyata.
Rajah di atas menunjukkan butang pengguna B1 dan tiga LED papan NUCLEO-F401RE. Setelah papan dikuasakan, LED LD3 (PWR) dihidupkan.
Sambungan kabel USB diperlukan untuk memantau data masa nyata. Papan dikuasakan oleh PC melalui sambungan USB. Mod kerja ini membolehkan peristiwa kejatuhan pengguna yang dikesan, pecutan dan data sensor tekanan, masa stamp dan akhirnya data sensor lain, dalam masa nyata, menggunakan MEMS-Studio.
2.4 Aplikasi MEMS-Studio
SampAplikasi ini menggunakan aplikasi MEMS-Studio, yang boleh dimuat turun dari www.st.com.
Langkah 1. Pastikan pemacu yang diperlukan dipasang dan papan Nucleo STM32 dengan papan pengembangan yang sesuai disambungkan ke PC.
Langkah 2. Lancarkan aplikasi MEMS-Studio untuk membuka tetingkap aplikasi utama.
Jika papan Nukleo STM32 dengan perisian tegar yang disokong disambungkan ke PC, ia dikesan secara automatik.
Tekan butang [Sambung] untuk mewujudkan sambungan ke papan penilaian.
Langkah 3. Apabila disambungkan ke papan Nukleo STM32 dengan tab perisian tegar yang disokong [Penilaian Perpustakaan] dibuka.
Untuk memulakan dan menghentikan penstriman data, togol [Mula] yang sesuai 
atau [Berhenti] 
butang pada bar alat menegak luar.
Data yang datang dari sensor yang disambungkan boleh viewed memilih tab [Data Table] pada ba alat menegak dalam
Langkah 4. Klik pada [Fall Detection] untuk membuka tetingkap aplikasi khusus.
Langkah 5. Klik pada [Simpan Ke File] untuk membuka tetingkap konfigurasi dataloging. Pilih data pengesanan penderia dan jatuh untuk disimpan dalam file. Anda boleh mula atau berhenti menyimpan dengan mengklik pada butang yang sepadan.
Langkah 6. Mod Suntikan Data boleh digunakan untuk menghantar data yang diperoleh sebelum ini ke perpustakaan dan menerima hasilnya. Pilih tab [Suntikan Data] pada bar alat menegak untuk membuka khusus view untuk fungsi ini.
Langkah 7. Klik pada butang [Semak imbas] untuk memilih file dengan data yang ditangkap sebelum ini dalam format CSV.
Data akan dimuatkan ke dalam jadual dalam arus view.
Butang lain akan menjadi aktif. Anda boleh klik pada:
– Butang [Mod Luar Talian] untuk menghidupkan/mematikan mod luar talian perisian tegar (mod menggunakan data yang ditangkap sebelum ini).
– Butang [Mula]/[Berhenti]/[Langkah]/[Ulang] untuk mengawal suapan data daripada MEMS-Studio ke pustaka.
2.5 Rujukan
Semua sumber berikut tersedia secara percuma di www.st.com.
- UM1859: Bermula dengan MEMS gerakan X-CUBE-MEMS1 dan pengembangan perisian sensor alam sekitar untuk STM32Cube
- UM1724: Papan STM32 Nucleo-64 (MB1136)
- UM3233: Bermula dengan MEMS-Studio
Sejarah semakan
Jadual 4. Sejarah semakan dokumen
| tarikh | Versi | Perubahan |
| 22-Sep-2017 | 1 | Keluaran awal. |
| 6-Feb-18 | 2 | Menambahkan rujukan kepada papan pembangunan NUCLEO-L152RE dan Jadual 2. Algoritma masa berlalu (μs). |
| 21-Mac-18 | 3 | Pengenalan yang dikemas kini dan Bahagian 2.1 MotionFD berakhirview. |
| 19-Feb-19 | 4 | Jadual 2 yang dikemas kini. Algoritma masa berlalu (μs) dan Rajah 2. Nukleo STM32: LED, butang, pelompat. Menambah maklumat keserasian papan pengembangan X-NUCLEO-IKS01A3. |
| 17-Sep-24 | 5 | Pengenalan Bahagian Kemas Kini, Bahagian 2.1: MotionFD berakhirview, Bahagian 2.2.1: Penerangan perpustakaan MotionFD, Bahagian 2.2.2: MotionFD API, Bahagian 2.2.5: Prestasi algoritma, Bahagian 2.3: Sampaplikasi, Bahagian 2.4: Aplikasi MEMS-Studio |
NOTIS PENTING – BACA DENGAN TELITI
STMicroelectronics NV dan anak syarikatnya (“ST”) berhak untuk membuat perubahan, pembetulan, penambahbaikan, pengubahsuaian dan penambahbaikan pada produk ST dan/atau pada dokumen ini pada bila-bila masa tanpa notis. Pembeli hendaklah mendapatkan maklumat terkini berkaitan produk ST sebelum membuat pesanan. Produk ST dijual menurut terma dan syarat jualan ST yang ada pada masa penerimaan pesanan.
Pembeli bertanggungjawab sepenuhnya untuk pilihan, pemilihan dan penggunaan produk ST dan ST tidak bertanggungjawab untuk bantuan permohonan atau reka bentuk produk pembeli.
Tiada lesen, nyata atau tersirat, kepada mana-mana hak harta intelek diberikan oleh ST di sini.
Jualan semula produk ST dengan peruntukan yang berbeza daripada maklumat yang dinyatakan di sini akan membatalkan sebarang waranti yang diberikan oleh ST untuk produk tersebut.
ST dan logo ST adalah tanda dagangan ST. Untuk maklumat tambahan tentang tanda dagangan ST, rujuk kepada www.st.com/trademarks. Semua nama produk atau perkhidmatan lain adalah hak milik pemilik masing-masing.
Maklumat dalam dokumen ini menggantikan dan menggantikan maklumat yang dibekalkan sebelum ini dalam mana-mana versi terdahulu dokumen ini.
© 2024 STMicroelectronics – Hak cipta terpelihara
Dokumen / Sumber
 |
Perpustakaan Pengesanan Jatuh Masa Nyata ST X-CUBE-MEMS1 MotionFD [pdf] Manual Pengguna Perpustakaan Pengesanan Jatuh Masa Nyata X-CUBE-MEMS1 MotionFD, X-CUBE-MEMS1, Pustaka Pengesanan Jatuh Masa Nyata MotionFD, Perpustakaan Pengesanan Jatuh Masa Nyata, Perpustakaan Pengesanan Jatuh, Perpustakaan Pengesanan, Perpustakaan |
