UM 2275
Uzantmanlibro

Komencu kun MotionFD realtempa fal-detekta biblioteko en X-CUBE-MEMS1 ekspansio por STM32Cube

Enkonduko

La MotionEC estas mezvarba biblioteko komponanto de la programaro X-CUBE-MEMS1 kaj funkcias per STM3z2. Ĝi provizas realtempajn informojn pri la aparato-orientiĝo kaj movada stato surbaze de datumoj de aparato.
Ĝi disponigas la sekvajn produktaĵojn: aparatorientiĝo (kvaternioj, Euler-anguloj), aparatrotacio (virtuala giroskopfunkcio), gravitvektoro kaj lineara akcelo.
Ĉi tiu biblioteko estas intencita labori kun ST MEMS nur.
La algoritmo estas provizita en senmova bibliotekformato kaj estas dizajnita por esti uzata sur STM32 mikroregiloj bazitaj sur la ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 kaj ARM®. Cortex®-M7-arkitekturoj.
Ĝi estas konstruita supre de STM32Cube programaro teknologio por faciligi porteblon tra malsamaj STM32 mikroregiloj.
La programaro venas kun sample efektivigo funkcianta sur X-NUCLEO-IKS4A1 aŭ X-NUCLEO-IKS01A3 ekspansiotabulo sur NUCLEO-F401RE, NUCLEO-U575ZI-Q aŭ NUCLEO-L152RE-disvolva tabulo.

Akronimoj kaj mallongigoj

Tabelo 1. Listo de akronimoj

Akronimo	Priskribo
API	Interfaco de programado de aplikaĵoj
BSP	Estraro-subtena pako
GUI	Grafika uzantinterfaco
HAL	Aparataro abstrakta tavolo
IDE	Integrita evolumedio

MotionFD-mezvarobiblioteko en X-CUBE-MEMS1 softvarvastiĝo por STM32Cube

2.1 MotionFD finiĝisview
La MotionFD-biblioteko vastigas la funkciecon de la programaro X-CUBE-MEMS1.
La biblioteko akiras datenojn de la akcelometro kaj premosensilo kaj disponigas informojn pri la uzanta falokazaĵo bazita sur datenoj de aparato.
La biblioteko estas desegnita nur por ST MEMS. Funkcieco kaj efikeco dum uzado de aliaj MEMS-sensiloj ne estas analizitaj kaj povas esti signife diferencaj de tio, kio priskribis en la dokumento.
Sampla efektivigo disponeblas por la ekspansiotabulo X-NUCLEO-IKS4A1 kaj X-NUCLEO-IKS01A3, muntita sur NUCLEO-F401RE, NUCLEO-U575ZI-Q aŭ NUCLEO-L152RE-disvolva tabulo.
2.2 Biblioteko MotionFD
Teknikaj informoj plene priskribantaj la funkciojn kaj parametrojn de la MotionFD APIs troveblas en la MotionFD_Package.chm kompilita HTML file troviĝas en la dosierujo Dokumentado.
2.2.1 Bibliotekopriskribo de MotionFD
La biblioteko de detekto de faloj MotionFD administras la datumojn akiritajn de la akcelometro kaj premosensilo; ĝi prezentas:

• ebleco distingi ĉu la uzantfalo okazis aŭ ne
• rekono bazita nur sur akcelometro kaj premosensilo datumoj
• bezonata akcelometro kaj premo-sensilo datumoj sampling-frekvenco estas 25 Hz
• Postuloj pri rimedoj:
  – Cortex-M3: 3.6 kB de kodo kaj 3.2 kB de datummemoro
  – Cortex-M33: 3.4 kB de kodo kaj 3.2 kB de datummemoro
  – Cortex-M4: 3.4 kB de kodo kaj 3.2 kB de datummemoro
  – Cortex-M7: 3.4 kB de kodo kaj 3.2 de datummemoro
• havebla por arkitekturoj ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 kaj ARM Cortex-M7

2.2.2 MotionFD-APIoj
La MotionFD-bibliotekaj APIoj estas:

• uint8_t MotionFD_GetLibVersion(char *versio)
  – retrovas la bibliotekan version
  – *versio estas montrilo al tabelo de 35 signoj
  – liveras la nombron da signoj en la versio-ĉeno
• malplenigi MotionFD_Initialize(void)
  – faras MotionFD-bibliotekan inicialigon kaj aranĝon de la interna mekanismo

Notu: Ĉi tiu funkcio devas esti vokita antaŭ ol uzi la faldetektan bibliotekon kaj la CRC-modulo en la mikroregilo STM32 (en RCC periferia horloĝo ebligas registron) devas esti ebligita.

• malplenigi MotionFD_Update (MFD_input_t *date_en, MFD_output_t *data_out)
  – efektivigas fal-detektan algoritmon
  – *data_in-parametro estas montrilo al strukturo kun eniga datumo
  – la parametroj por la strukturo-tipo MFD_input_t estas:
  ◦ AccX estas la akcelometra sensilvaloro en X-akso en mg
  ◦ AccY estas la akcelometra sensilvaloro en Y-akso en mg
  ◦ AccZ estas la akcelometra sensilvaloro en Z-akso en mg
  ◦ Gazetaro estas la prema sensilo-valoro en hPa
  – *data_out parametro estas montrilo al enumo kun la sekvaj eroj:
  ◦ MFD_NOFALL = 0
  ◦ MFD_FALL = 1
• void MotionFD_SetKnobs(float fal_sojlo, int32_t fal_altitude_delta, flosu liying_tempo)
  – fiksas bibliotekajn agordajn parametrojn
  – fal_sojlo akcela sojlo en mg
  – fall_altitude_delta altitudodiferenco en cm
  – tempo de kuŝado en sekundoj sen movado post trafo
• void MotionFD_GetKnobs(float *fala_sojlo, int32_t *fala_alteco_delta, flosilo *kuŝa_tempo)
  – ricevas bibliotekajn agordajn parametrojn
  – fal_sojlo akcela sojlo en mg
  – fall_altitude_delta altitudodiferenco en cm
  – tempo de kuŝado en sekundoj sen movado post trafo

2.2.3 API-fludiagramo

2.2.4 Demo-kodo
La sekva pruva kodo legas datumojn de la akcelometro kaj prema sensilo kaj ricevas la aŭtunan eventokodon.

2.2.5 Algoritma agado
La algoritmo de detekto de faloj nur uzas datumojn de la akcelometro kaj premo-sensilo kaj funkcias per malalta frekvenco (25 Hz) por redukti energikonsumon.

2.3 Sample aplikaĵo
La mezvaro MotionFD povas esti facile manipulita por konstrui uzantajn aplikojn; kielampla aplikaĵo estas provizita en la dosierujo de Apliko.
Ĝi estas desegnita por funkcii sur NUCLEO-F401RE, NUCLEO-U575ZI-Q aŭ NUCLEO-L152RE-disvolva tabulo konektita al ekspansiotabulo X-NUCLEO-IKS4A1 aŭ X-NUCLEO-IKS01A3.
La aplikaĵo rekonas la uzantan falokazaĵon en reala tempo.

La supra figuro montras la uzantan butonon B1 kaj la tri LED-ojn de la tabulo NUCLEO-F401RE. Post kiam la tabulo estas funkciigita, LED LD3 (PWR) ŝaltas.
USB-kablokonekto estas postulata por monitori realtempajn datumojn. La tabulo estas funkciigita de la komputilo per USB-konekto. Ĉi tiu laborreĝimo permesas al la detektita uzanta falokazaĵo, akcelometro kaj premo-sensilo datumoj, tempo stamp kaj eventuale aliaj sensildatenoj, en reala tempo, uzante la MEMS-Studion.
2.4 MEMS-Studia aplikaĵo
La sampla aplikaĵo uzas MEMS-Studio-aplikaĵon, kiu povas esti elŝutita de www.st.com.
Paŝo 1. Certigu, ke la necesaj ŝoforoj estas instalitaj kaj la STM32 Nucleo-tabulo kun taŭga ekspansia tabulo estas konektita al la komputilo.
Paŝo 2. Lanĉu la MEMS-Studio-aplikaĵon por malfermi la ĉefan aplikaĵfenestron.
Se STM32 Nucleo-tabulo kun subtenata firmvaro estas konektita al la komputilo, ĝi estas aŭtomate detektita.
Premu la butonon [Konekti] por establi konekton al la taksa tabulo.

Paŝo 3. Kiam ligite al STM32 Nucleo-tabulo kun subtenata firmvaro, la langeto [Biblioteko-Taksado] estas malfermita.
Por komenci kaj ĉesigi datumfluadon, ŝaltu la taŭgan [Komencu] aŭ [Haltu]   butono sur la ekstera vertikala ilobreto.
La datumoj venantaj de la konektita sensilo povas esti viewed elektante la langeton [Datumtabelo] sur la interna vertikala ilo ba

Paŝo 4. Alklaku la [Fall Detection] por malfermi la dediĉitan aplikaĵan fenestron.

Paŝo 5. Alklaku la [Konservi al File] por malfermi la agordan fenestron de datumregistrado. Elektu la sensilon kaj faldetektajn datumojn por konservi en la file. Vi povas komenci aŭ ĉesi ŝpari alklakante la respondan butonon.

Paŝo 6. Data Injection-reĝimo povas esti uzata por sendi la antaŭe akiritajn datumojn al la biblioteko kaj ricevi la rezulton. Elektu la langeton [Injekto de datumoj] sur la vertikala ilobreto por malfermi la dediĉitan view por ĉi tiu funkcio.

Paŝo 7. Alklaku la butonon [Trarigardi] por elekti la file kun la antaŭe kaptitaj datumoj en CSV-formato.
La datumoj estos ŝarĝitaj en la tabelon en la nuna view.
Aliaj butonoj aktiviĝos. Vi povas klaki sur:
- Butono [Senreta Reĝimo] por ŝalti/malŝalti la firmvaran senreteman reĝimon (reĝimo utiliganta la antaŭe kaptitajn datumojn).
– [Komenco]/[Halti]/[Paŝo]/[Ripeti] por kontroli la datumfluon de MEMS-Studio al la biblioteko.

2.5 Referencoj
Ĉiuj jenaj rimedoj estas libere haveblaj ĉe www.st.com.

1. UM1859: Komencu kun la X-CUBE-MEMS1-moviĝo MEMS kaj media sensila programaro ekspansio por STM32Cube
2. UM1724: STM32 Nucleo-64-estraroj (MB1136)
3. UM3233: Komenci kun MEMS-Studio

Historio de revizioj

Tabelo 4. Dokumenta reviziohistorio

Dato	Versio	Ŝanĝoj
22-Sep-2017	1	Komenca eldono.
6-feb-18	2	Aldonitaj referencoj al NUCLEO-L152RE-disvolva tabulo kaj Tabelo 2. Algoritmo de Pasita tempo (μs).
21-mar-18	3	Ĝisdatigita Enkonduko kaj Sekcio 2.1 MotionFD finiĝisview.
19-feb-19	4	Ĝisdatigita Tabelo 2. Algoritmo de Pasita tempo (μs) kaj Figuro 2. STM32 Nucleo: LED-oj, butono, jumper. Aldonita X-NUCLEO-IKS01A3 ekspansiotabulo kongruo informo.
17-Sep-24	5	Ĝisdatigita Sekcio Enkonduko, Sekcio 2.1: MotionFD finiĝisview, Section 2.2.1: MotionFD-biblioteka priskribo, Section 2.2.2: MotionFD APIoj, Section 2.2.5: Algoritmefikeco, Section 2.3: Sample aplikaĵo, Sekcio 2.4: MEMS-Studio-apliko

GRAVA AVIZO – LEGU ATENTE
STMicroelectronics NV kaj ĝiaj filioj ("ST") rezervas la rajton fari ŝanĝojn, korektojn, plibonigojn, modifojn kaj plibonigojn al ST-produktoj kaj/aŭ al ĉi tiu dokumento iam ajn sen avizo. Aĉetantoj devas akiri la plej novajn rilatajn informojn pri ST-produktoj antaŭ ol fari mendojn. ST-produktoj estas venditaj laŭ la vendkondiĉoj de ST en la tempo de mendo agnosko.
Aĉetantoj respondecas nur pri la elekto, elekto kaj uzo de ST-produktoj kaj ST supozas neniun respondecon pri aplika helpo aŭ la dezajno de produktoj de aĉetantoj.
Neniu licenco, esprima aŭ implicita, al iu ajn intelekta proprieta rajto estas donita de ST ĉi tie.
Revendo de ST-produktoj kun dispozicioj malsamaj ol la informoj ĉi tie prezentitaj nuligos ajnan garantion donitan de ST por tia produkto.
ST kaj la ST-emblemo estas varmarkoj de ST. Por pliaj informoj pri ST-varmarkoj, referu al www.st.com/trademarks. Ĉiuj aliaj produktaj aŭ servonomoj estas la posedaĵo de siaj respektivaj posedantoj.
Informoj en ĉi tiu dokumento anstataŭas kaj anstataŭigas informojn antaŭe provizitajn en iuj antaŭaj versioj de ĉi tiu dokumento.

© 2024 STMicroelectronics - Ĉiuj rajtoj rezervitaj

Dokumentoj/Rimedoj

ST X-CUBE-MEMS1 MotionFD Real Time Fall Detection Library [pdf] Uzanto-manlibro 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, Biblioteko

Referencoj

• Uzanto Manlibro