UM2275
Manwal għall-utent

Nibdew bil-librerija ta' skoperta ta' waqgħa f'ħin reali MotionFD fl-espansjoni X-CUBE-MEMS1 għal STM32Cube

Introduzzjoni

Il-MotionEC huwa komponent tal-librerija tal-middleware tas-softwer X-CUBE-MEMS1 u jaħdem fuq STM3z2. Jipprovdi informazzjoni f'ħin reali dwar l-orjentazzjoni tal-apparat u l-istatus tal-moviment ibbażat fuq data minn apparat.
Jipprovdi l-outputs li ġejjin: orjentazzjoni tal-apparat (quaternions, angoli Euler), rotazzjoni tal-apparat (funzjonalità tal-ġiroskopju virtwali), vettur tal-gravità u aċċelerazzjoni lineari.
Din il-librerija hija maħsuba biex taħdem ma' ST MEMS biss.
L-algoritmu huwa pprovdut f'format ta' librerija statika u huwa ddisinjat biex jintuża fuq mikrokontrolluri STM32 ibbażati fuq ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 u ARM® Arkitetturi Cortex®-M7.
Huwa mibni fuq it-teknoloġija tas-softwer STM32Cube biex itaffi l-portabbiltà fuq mikrokontrolluri STM32 differenti.
Is-softwer jiġi ma 'sampLe implimentazzjoni taħdem fuq bord ta 'espansjoni X-NUCLEO-IKS4A1 jew X-NUCLEO-IKS01A3 fuq bord ta' żvilupp NUCLEO-F401RE, NUCLEO-U575ZI-Q jew NUCLEO-L152RE.

Akronimi u abbrevjazzjonijiet

Tabella 1. Lista ta' akronimi

Akronimu	Deskrizzjoni
API	Interfaċċja tal-ipprogrammar tal-applikazzjoni
BSP	Pakkett ta' appoġġ tal-Bord
GUI	Interfaċċja grafika għall-utent
HAL	Saff ta' astrazzjoni tal-ħardwer
IDE	Ambjent ta 'żvilupp integrat

Librerija tal-middleware MotionFD fl-espansjoni tas-softwer X-CUBE-MEMS1 għal STM32Cube

2.1 MotionFD intemmview
Il-librerija MotionFD tespandi l-funzjonalità tas-softwer X-CUBE-MEMS1.
Il-librerija takkwista dejta mill-aċċellerometru u s-sensor tal-pressjoni u tipprovdi informazzjoni dwar l-avveniment tal-waqgħa tal-utent ibbażata fuq dejta minn apparat.
Il-librerija hija mfassla għal ST MEMS biss. Il-funzjonalità u l-prestazzjoni meta jintużaw sensuri MEMS oħra mhumiex analizzati u jistgħu jkunu differenti b'mod sinifikanti minn dak deskritt fid-dokument.
Sampl-implimentazzjoni le hija disponibbli għall-bord ta 'espansjoni X-NUCLEO-IKS4A1 u X-NUCLEO-IKS01A3, immuntat fuq bord ta' żvilupp NUCLEO-F401RE, NUCLEO-U575ZI-Q jew NUCLEO-L152RE.
2.2 Librerija MotionFD
Informazzjoni teknika li tiddeskrivi bis-sħiħ il-funzjonijiet u l-parametri tal-APIs ta' MotionFD tista' tinstab fl-HTML miġbur ta' MotionFD_Package.chm file jinsab fil-folder tad-Dokumentazzjoni.
2.2.1 Deskrizzjoni tal-librerija MotionFD
Il-librerija tal-iskoperta tal-waqgħa MotionFD timmaniġġja d-dejta miksuba mill-aċċellerometru u s-sensor tal-pressjoni; fiha:

• possibbiltà li ssir distinzjoni jekk il-waqgħa tal-utent seħħitx jew le
• rikonoxximent ibbażat biss fuq l-aċċelerometru u d-dejta tas-sensorju tal-pressjoni
• meħtieġa aċċelerometru u pressjoni sensor data sampfrekwenza tal-ling hija 25 Hz
• rekwiżiti tar-riżorsi:
  – Cortex-M3: 3.6 kB ta 'kodiċi u 3.2 kB ta' memorja tad-dejta
  – Cortex-M33: 3.4 kB ta 'kodiċi u 3.2 kB ta' memorja tad-dejta
  – Cortex-M4: 3.4 kB ta 'kodiċi u 3.2 kB ta' memorja tad-dejta
  – Cortex-M7: 3.4 kB ta 'kodiċi u 3.2 ta' memorja tad-dejta
• disponibbli għall-arkitetturi ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 u ARM Cortex-M7

2.2.2 MotionFD APIs
L-APIs tal-librerija MotionFD huma:

• uint8_t MotionFD_GetLibVersion(char *verżjoni)
  – jirkupra l-verżjoni tal-librerija
  – * Il-verżjoni hija indikatur għal firxa ta' 35 karattru
  – jirritorna n-numru ta’ karattri fis-sekwenza tal-verżjoni
• null MotionFD_Initialize(void)
  – iwettaq l-inizjalizzazzjoni tal-librerija MotionFD u s-setup tal-mekkaniżmu intern

Nota: Din il-funzjoni trid tissejjaħ qabel ma tuża l-librerija tal-kxif tal-waqgħa u l-modulu CRC fil-mikrokontrollur STM32 (f'RCC arloġġ periferali enable register) għandu jkun attivat.

• null MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
  – tesegwixxi algoritmu ta' skoperta tal-waqgħa
  – * parametru data_in huwa pointer għal struttura b'data input
  – il-parametri għat-tip ta' struttura MFD_input_t huma:
  ◦ AccX huwa l-valur tas-sensor tal-aċċelerometru fl-assi X f'mg
  ◦ AccY huwa l-valur tas-sensor tal-aċċelerometru fl-assi Y f'mg
  ◦ AccZ huwa l-valur tas-sensor tal-aċċelerometru fl-assi Z f'mg
  ◦ Press huwa l-valur tas-sensor tal-pressjoni f'hPa
  – * parametru data_out huwa pointer għal enum bl-oġġetti li ġejjin:
  ◦ MFD_NOFALL = 0
  ◦ MFD_FALL = 1
• void MotionFD_SetKnobs(float fall_threshold, int32_t fall_altitude_delta, float lying_time)
  – jistabbilixxi l-parametri tal-konfigurazzjoni tal-librerija
  – limitu ta' aċċelerazzjoni fall_threshold f'mg
  – differenza fl-altitudni fall_altitude_delta f'ċm
  – ħin tal-mimdud f'sekondi mingħajr moviment wara impatt
• void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
  – iġib il-parametri tal-konfigurazzjoni tal-librerija
  – limitu ta' aċċelerazzjoni fall_threshold f'mg
  – differenza fl-altitudni fall_altitude_delta f'ċm
  – ħin tal-mimdud f'sekondi mingħajr moviment wara impatt

2.2.3 Tabella tal-fluss tal-API

2.2.4 Kodiċi Demo
Il-kodiċi ta 'dimostrazzjoni li ġej jaqra d-dejta mill-aċċellerometru u s-sensor tal-pressjoni u jikseb il-kodiċi tal-avveniment tal-waqgħa.

2.2.5 Prestazzjoni tal-algoritmu
L-algoritmu ta 'skoperta tal-waqgħa juża biss data mill-aċċellerometru u s-sensor tal-pressjoni u jaħdem bi frekwenza baxxa (25 Hz) biex inaqqas il-konsum tal-enerġija.

2.3 Sample applikazzjoni
Il-middleware MotionFD jista 'jiġi manipulat faċilment biex jinbnew applikazzjonijiet tal-utent; kifampl-applikazzjoni hija pprovduta fil-folder tal-Applikazzjoni.
Hija mfassla biex taħdem fuq bord ta 'żvilupp NUCLEO-F401RE, NUCLEO-U575ZI-Q jew NUCLEO-L152RE konness ma' bord ta 'espansjoni X-NUCLEO-IKS4A1 jew X-NUCLEO-IKS01A3.
L-applikazzjoni tirrikonoxxi l-avveniment tal-waqgħa tal-utent f'ħin reali.

Il-figura ta 'hawn fuq turi l-buttuna tal-utent B1 u t-tliet LEDs tal-bord NUCLEO-F401RE. Ladarba l-bord jitħaddem, l-LED LD3 (PWR) jixgħel.
Konnessjoni tal-kejbil USB hija meħtieġa biex tissorvelja data f'ħin reali. Il-bord huwa mħaddem mill-PC permezz ta 'konnessjoni USB. Din il-modalità tax-xogħol tippermetti lill-utent skopert waqgħa avveniment, aċċellerometru u data tas-sensorju tal-pressjoni, ħin stamp u eventwalment data oħra tas-sensuri, f'ħin reali, bl-użu tal-MEMS-Studio.
2.4 Applikazzjoni MEMS-Studio
Is-sampl-applikazzjoni tuża MEMS-Studio applikazzjoni, li tista 'titniżżel minn www.st.com.
Pass 1. Kun żgur li s-sewwieqa meħtieġa huma installati u l-bord STM32 Nucleo b'bord ta 'espansjoni xieraq huwa konness mal-PC.
Pass 2. Niedi l-applikazzjoni MEMS-Studio biex tiftaħ it-tieqa ewlenija tal-applikazzjoni.
Jekk bord STM32 Nucleo b'firmware appoġġjat huwa konness mal-PC, jiġi skopert awtomatikament.
Agħfas il-buttuna [Ikkonnettja] biex tistabbilixxi konnessjoni mal-bord tal-evalwazzjoni.

Pass 3. Meta tkun imqabbda ma 'bord STM32 Nucleo b'firmware appoġġjat, tinfetaħ it-tab [Evalwazzjoni tal-Librerija].
Biex tibda u twaqqaf l-istrimjar tad-dejta, aqleb il-[Bidu] xierqa jew [Waqqaf]   buttuna fuq il-bar tal-għodda vertikali ta 'barra.
Id-dejta li ġejja mis-sensor konness tista 'tkun viewed tagħżel it-tab [Tabella tad-Data] fuq l-għodda vertikali ta 'ġewwa ba

Pass 4. Ikklikkja fuq il-[Sejbien tal-waqgħa] biex tiftaħ it-tieqa tal-applikazzjoni ddedikata.

Pass 5. Ikklikkja fuq il-[Save To File] biex tiftaħ it-tieqa tal-konfigurazzjoni tad-datalogging. Agħżel is-sensor u d-data ta 'skoperta tal-waqgħa li għandha tiġi ssejvjata fil- file. Tista' tibda jew tieqaf tiffranka billi tikklikkja fuq il-buttuna korrispondenti.

Pass 6. Il-modalità ta 'Injezzjoni tad-Data tista' tintuża biex tibgħat id-dejta akkwistata qabel lil-librerija u tirċievi r-riżultat. Agħżel it-tab [Injezzjoni tad-Data] fuq il-bar tal-għodda vertikali biex tiftaħ id-dedikata view għal din il-funzjonalità.

Pass 7. Ikklikkja fuq il-buttuna [Ibbrawżja] biex tagħżel il- file bid-dejta maqbuda qabel fil-format CSV.
Id-dejta se titgħabba fit-tabella fil-kurrent view.
Buttuni oħra se jsiru attivi. Tista' tikklikkja fuq:
– Buttuna [Modalità Offline] biex taqleb/itfi l-modalità tal-firmware offline (modalità li tuża d-dejta maqbuda qabel).
– Buttuni [Start]/[Stop]/[Pass]/[Irrepeti] biex jikkontrollaw l-għalf tad-dejta minn MEMS-Studio għal-librerija.

2.5 Referenzi
Ir-riżorsi kollha li ġejjin huma disponibbli b'xejn fuq www.st.com.

1. UM1859: Nibdew bl-MEMS tal-moviment X-CUBE-MEMS1 u espansjoni tas-softwer tas-sensuri ambjentali għal STM32Cube
2. UM1724: Bordijiet STM32 Nucleo-64 (MB1136)
3. UM3233: Nibdew b'MEMS-Studio

Storja tar-reviżjoni

Tabella 4. Storja tar-reviżjoni tad-dokument

Data	Verżjoni	Bidliet
22-Sep-2017	1	Rilaxx inizjali.
6-Frar-18	2	Miżjuda referenzi għall-bord ta 'żvilupp NUCLEO-L152RE u Tabella 2. Algoritmu ta' ħin li għadda (μs).
21-Mar-18	3	Introduzzjoni Aġġornata u Taqsima 2.1 MotionFD fuqview.
19-Frar-19	4	Tabella Aġġornata 2. Algoritmu tal-ħin li għadda (μs) u Figura 2. Nukleo STM32: LEDs, buttuna, jumper. Miżjud informazzjoni ta 'kompatibilità tal-bord ta' espansjoni X-NUCLEO-IKS01A3.
17-Sep-24	5	Taqsima Aġġornata Introduzzjoni, Taqsima 2.1: MotionFD overview, Taqsima 2.2.1: Deskrizzjoni tal-librerija MotionFD, Taqsima 2.2.2: APIs MotionFD, Taqsima 2.2.5: Prestazzjoni tal-algoritmu, Taqsima 2.3: Sampl-applikazzjoni, Taqsima 2.4: Applikazzjoni MEMS-Studio

AVVIŻ IMPORTANTI - AQRA B'attenzjoni
STMicroelectronics NV u s-sussidjarji tagħha (“ST”) jirriżervaw id-dritt li jagħmlu bidliet, korrezzjonijiet, titjib, modifiki, u titjib għall-prodotti ST u/jew għal dan id-dokument fi kwalunkwe ħin mingħajr avviż. Ix-xerrejja għandhom jiksbu l-aħħar informazzjoni rilevanti dwar il-prodotti ST qabel ma jagħmlu ordnijiet. Il-prodotti ST jinbiegħu skont it-termini u l-kundizzjonijiet tal-bejgħ ta' ST fis-seħħ fil-ħin tar-rikonoxximent tal-ordni.
Ix-xerrejja huma unikament responsabbli għall-għażla, l-għażla u l-użu tal-prodotti ST u ST ma jassumi l-ebda responsabbiltà għall-assistenza tal-applikazzjoni jew id-disinn tal-prodotti tax-xerrejja.
L-ebda liċenzja, espressa jew impliċita, għal xi dritt ta' proprjetà intellettwali ma tingħata minn ST hawnhekk.
Il-bejgħ mill-ġdid ta' prodotti ST b'dispożizzjonijiet differenti mill-informazzjoni stipulata hawnhekk għandu jħassar kwalunkwe garanzija mogħtija minn ST għal tali prodott.
ST u l-logo ST huma trademarks ta' ST. Għal informazzjoni addizzjonali dwar it-trademarks ST, irreferi għal www.st.com/trademarks. L-ismijiet l-oħra kollha tal-prodott jew tas-servizz huma proprjetà tas-sidien rispettivi tagħhom.
L-informazzjoni f'dan id-dokument tieħu post u tissostitwixxi l-informazzjoni pprovduta qabel fi kwalunkwe verżjoni preċedenti ta' dan id-dokument.

© 2024 STMicroelectronics – Id-drittijiet kollha riżervati

Dokumenti / Riżorsi

ST X-CUBE-MEMS1 MotionFD Librerija ta 'Sejbien ta' Waqgħa f'Ħin Real [pdfManwal tal-Utent X-CUBE-MEMS1 Librerija ta' Rilevazzjoni ta' Waqgħa f'Ħin Real MotionFD, X-CUBE-MEMS1, Librerija ta' Sejbien ta' Waqgħa f'Ħin Real MotionFD, Librerija ta' Sejbien ta' Waqgħa f'Ħin Real, Librerija ta' Sejbien ta' Waqgħa, Librerija ta' Sejbien, Librerija

Referenzi

• Manwal għall-Utent