UM2275
వినియోగదారు మాన్యువల్

STM1Cube కోసం X-CUBE-MEMS32 విస్తరణలో MotionFD రియల్ టైమ్ ఫాల్ డిటెక్షన్ లైబ్రరీతో ప్రారంభించడం

పరిచయం

MotionEC అనేది X-CUBE-MEMS1 సాఫ్ట్‌వేర్ యొక్క మిడిల్‌వేర్ లైబ్రరీ భాగం మరియు STM3z2పై నడుస్తుంది. ఇది పరికరం నుండి డేటా ఆధారంగా పరికర ధోరణి మరియు కదలిక స్థితి గురించి నిజ-సమయ సమాచారాన్ని అందిస్తుంది.
ఇది క్రింది అవుట్‌పుట్‌లను అందిస్తుంది: పరికర విన్యాసాన్ని (క్వాటర్నియన్‌లు, ఆయిలర్ కోణాలు), పరికర భ్రమణ (వర్చువల్ గైరోస్కోప్ ఫంక్షనాలిటీ), గ్రావిటీ వెక్టర్ మరియు లీనియర్ యాక్సిలరేషన్.
ఈ లైబ్రరీ ST MEMSతో మాత్రమే పని చేయడానికి ఉద్దేశించబడింది.
అల్గోరిథం స్టాటిక్ లైబ్రరీ ఆకృతిలో అందించబడింది మరియు ARM® Cortex®-M32+, ARM® Cortex®-M0, ARM® Cortex®-M3, ARM® Cortex®®-M33 మరియు ARM® కార్టెక్స్ ®-M4 మరియు ARM® కార్టెక్స్ ®-M7 ఆధారంగా STMXNUMX మైక్రోకంట్రోలర్‌లపై ఉపయోగించేందుకు రూపొందించబడింది. కార్టెక్స్®-MXNUMX నిర్మాణాలు.
ఇది వివిధ STM32 మైక్రోకంట్రోలర్‌లలో పోర్టబిలిటీని సులభతరం చేయడానికి STM32Cube సాఫ్ట్‌వేర్ టెక్నాలజీ పైన నిర్మించబడింది.
సాఫ్ట్‌వేర్‌తో వస్తుందిampNUCLEO-F4RE, NUCLEO-U1ZI-Q లేదా NUCLEO-L01RE డెవలప్‌మెంట్ బోర్డ్‌లో X-NUCLEO-IKS3A401 లేదా X-NUCLEO-IKS575A152 విస్తరణ బోర్డ్‌లో అమలు చేయబడుతోంది.

ఎక్రోనింస్ మరియు సంక్షిప్తాలు

టేబుల్ 1. ఎక్రోనింస్ జాబితా

ఎక్రోనిం	వివరణ
API	అప్లికేషన్ ప్రోగ్రామింగ్ ఇంటర్ఫేస్
BSP	బోర్డు మద్దతు ప్యాకేజీ
GUI	గ్రాఫికల్ యూజర్ ఇంటర్‌ఫేస్
HAL	హార్డ్‌వేర్ సంగ్రహణ పొర
IDE	సమగ్ర అభివృద్ధి వాతావరణం

STM1Cube కోసం X-CUBE-MEMS32 సాఫ్ట్‌వేర్ విస్తరణలో MotionFD మిడిల్‌వేర్ లైబ్రరీ

2.1 MotionFD ముగిసిందిview
MotionFD లైబ్రరీ X-CUBE-MEMS1 సాఫ్ట్‌వేర్ యొక్క కార్యాచరణను విస్తరిస్తుంది.
లైబ్రరీ యాక్సిలరోమీటర్ మరియు ప్రెజర్ సెన్సార్ నుండి డేటాను పొందుతుంది మరియు పరికరం నుండి డేటా ఆధారంగా యూజర్ ఫాల్ ఈవెంట్ గురించి సమాచారాన్ని అందిస్తుంది.
లైబ్రరీ ST MEMS కోసం మాత్రమే రూపొందించబడింది. ఇతర MEMS సెన్సార్‌లను ఉపయోగిస్తున్నప్పుడు కార్యాచరణ మరియు పనితీరు విశ్లేషించబడవు మరియు డాక్యుమెంట్‌లో వివరించిన దానికంటే గణనీయంగా భిన్నంగా ఉండవచ్చు.
SampNUCLEO-F4RE, NUCLEO-U1ZI-Q లేదా NUCLEO-L01RE డెవలప్‌మెంట్ బోర్డుపై మౌంట్ చేయబడిన X-NUCLEO-IKS3A401 మరియు X-NUCLEO-IKS575A152 విస్తరణ బోర్డు కోసం le అమలు అందుబాటులో ఉంది.
2.2 MotionFD లైబ్రరీ
MotionFD APIల యొక్క విధులు మరియు పారామితులను పూర్తిగా వివరించే సాంకేతిక సమాచారం MotionFD_Package.chm సంకలనం చేయబడిన HTMLలో కనుగొనబడుతుంది file డాక్యుమెంటేషన్ ఫోల్డర్‌లో ఉంది.
2.2.1 MotionFD లైబ్రరీ వివరణ
MotionFD ఫాల్ డిటెక్షన్ లైబ్రరీ యాక్సిలెరోమీటర్ మరియు ప్రెజర్ సెన్సార్ నుండి పొందిన డేటాను నిర్వహిస్తుంది; ఇది లక్షణాలు:

• వినియోగదారు పతనం సంభవించిందా లేదా అని గుర్తించే అవకాశం
• యాక్సిలరోమీటర్ మరియు ప్రెజర్ సెన్సార్ డేటా ఆధారంగా మాత్రమే గుర్తింపు
• అవసరమైన యాక్సిలెరోమీటర్ మరియు ప్రెజర్ సెన్సార్ డేటా sampలింగ్ ఫ్రీక్వెన్సీ 25 Hz
• వనరుల అవసరాలు:
  – కార్టెక్స్-M3: 3.6 kB కోడ్ మరియు 3.2 kB డేటా మెమరీ
  – కార్టెక్స్-M33: 3.4 kB కోడ్ మరియు 3.2 kB డేటా మెమరీ
  – కార్టెక్స్-M4: 3.4 kB కోడ్ మరియు 3.2 kB డేటా మెమరీ
  – Cortex-M7: 3.4 kB కోడ్ మరియు 3.2 డేటా మెమరీ
• ARM కార్టెక్స్-M3, ARM కార్టెక్స్-M33, ARM కార్టెక్స్-M4 మరియు ARM కార్టెక్స్-M7 ఆర్కిటెక్చర్‌ల కోసం అందుబాటులో ఉంది

2.2.2 MotionFD APIలు
MotionFD లైబ్రరీ APIలు:

• uint8_t MotionFD_GetLibVersion(char *version)
  - లైబ్రరీ సంస్కరణను తిరిగి పొందుతుంది
  – * వెర్షన్ 35 అక్షరాల శ్రేణికి పాయింటర్
  - సంస్కరణ స్ట్రింగ్‌లోని అక్షరాల సంఖ్యను అందిస్తుంది
• శూన్యం MotionFD_Initialize(శూన్యం)
  - MotionFD లైబ్రరీ ప్రారంభించడం మరియు అంతర్గత మెకానిజం యొక్క సెటప్‌ను నిర్వహిస్తుంది

గమనిక: ఫాల్ డిటెక్షన్ లైబ్రరీని ఉపయోగించే ముందు ఈ ఫంక్షన్ తప్పనిసరిగా కాల్ చేయబడాలి మరియు STM32 మైక్రోకంట్రోలర్‌లోని CRC మాడ్యూల్ (RCC పెరిఫెరల్ క్లాక్ ఎనేబుల్ రిజిస్టర్‌లో) ప్రారంభించబడాలి.

• శూన్యం MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
  - పతనం గుర్తింపు అల్గోరిథంను అమలు చేస్తుంది
  – *data_in పారామీటర్ అనేది ఇన్‌పుట్ డేటాతో కూడిన స్ట్రక్చర్‌కు పాయింటర్
  – నిర్మాణ రకం MFD_input_t కోసం పారామితులు:
  ◦ AccX అనేది mgలో X అక్షంలోని యాక్సిలెరోమీటర్ సెన్సార్ విలువ
  ◦ AccY అనేది mgలో Y అక్షంలోని యాక్సిలెరోమీటర్ సెన్సార్ విలువ
  ◦ AccZ అనేది mgలో Z అక్షంలోని యాక్సిలెరోమీటర్ సెన్సార్ విలువ
  ◦ ప్రెస్ అనేది hPaలో ఒత్తిడి సెన్సార్ విలువ
  – *data_out పరామితి క్రింది అంశాలతో enumకి పాయింటర్:
  ◦ MFD_NOFALL = 0
  ◦ MFD_FALL = 1
• శూన్యమైన MotionFD_SetKnobs(ఫ్లోట్ ఫాల్_థ్రెషోల్డ్, int32_t ఫాల్_ఆల్టిట్యూడ్_డెల్టా, ఫ్లోట్ లైయింగ్_టైమ్)
  - లైబ్రరీ కాన్ఫిగరేషన్ పారామితులను సెట్ చేస్తుంది
  – ఫాల్_థ్రెషోల్డ్ యాక్సిలరేషన్ థ్రెషోల్డ్‌లో mg
  – ఫాల్_ఎలిట్యూడ్_డెల్టా ఎత్తులో తేడా సెం.మీ
  - ప్రభావం తర్వాత కదలిక లేకుండా సెకన్లలో అబద్ధం సమయం
• శూన్యమైన MotionFD_GetKnobs(ఫ్లోట్ * ఫాల్_థ్రెషోల్డ్, int32_t *fall_altitude_delta, float *lying_time)
  - లైబ్రరీ కాన్ఫిగరేషన్ పారామితులను పొందుతుంది
  – ఫాల్_థ్రెషోల్డ్ యాక్సిలరేషన్ థ్రెషోల్డ్‌లో mg
  – ఫాల్_ఎలిట్యూడ్_డెల్టా ఎత్తులో తేడా సెం.మీ
  - ప్రభావం తర్వాత కదలిక లేకుండా సెకన్లలో అబద్ధం సమయం

2.2.3 API ఫ్లో చార్ట్

2.2.4 డెమో కోడ్
కింది ప్రదర్శన కోడ్ యాక్సిలరోమీటర్ మరియు ప్రెజర్ సెన్సార్ నుండి డేటాను రీడ్ చేస్తుంది మరియు ఫాల్ ఈవెంట్ కోడ్‌ను పొందుతుంది.

2.2.5 అల్గోరిథం పనితీరు
ఫాల్ డిటెక్షన్ అల్గారిథమ్ యాక్సిలరోమీటర్ మరియు ప్రెజర్ సెన్సార్ నుండి డేటాను మాత్రమే ఉపయోగిస్తుంది మరియు విద్యుత్ వినియోగాన్ని తగ్గించడానికి తక్కువ ఫ్రీక్వెన్సీ (25 Hz) వద్ద నడుస్తుంది.

2.3 ఎస్ample అప్లికేషన్
వినియోగదారు అప్లికేషన్‌లను రూపొందించడానికి MotionFD మిడిల్‌వేర్‌ను సులభంగా మార్చవచ్చు; వంటిample అప్లికేషన్ అప్లికేషన్ ఫోల్డర్‌లో అందించబడింది.
ఇది X-NUCLEO-IKS401A575 లేదా X-NUCLEO-IKS152A4 విస్తరణ బోర్డుకి కనెక్ట్ చేయబడిన NUCLEO-F1RE, NUCLEO-U01ZI-Q లేదా NUCLEO-L3RE డెవలప్‌మెంట్ బోర్డ్‌లో అమలు చేయడానికి రూపొందించబడింది.
అప్లికేషన్ నిజ సమయంలో యూజర్ ఫాల్ ఈవెంట్‌ను గుర్తిస్తుంది.

పై బొమ్మ వినియోగదారు బటన్ B1 మరియు NUCLEO-F401RE బోర్డు యొక్క మూడు LEDలను చూపుతుంది. బోర్డు పవర్ చేయబడిన తర్వాత, LED LD3 (PWR) ఆన్ అవుతుంది.
నిజ-సమయ డేటాను పర్యవేక్షించడానికి USB కేబుల్ కనెక్షన్ అవసరం. బోర్డు USB కనెక్షన్ ద్వారా PC ద్వారా శక్తిని పొందుతుంది. ఈ వర్కింగ్ మోడ్ కనుగొనబడిన యూజర్ ఫాల్ ఈవెంట్, యాక్సిలరోమీటర్ మరియు ప్రెజర్ సెన్సార్ డేటా, టైమ్ స్టంప్‌ని అనుమతిస్తుందిamp మరియు చివరికి ఇతర సెన్సార్ డేటా, నిజ సమయంలో, MEMS-స్టూడియోను ఉపయోగిస్తుంది.
2.4 MEMS-స్టూడియో అప్లికేషన్
లుample అప్లికేషన్ MEMS-స్టూడియో అప్లికేషన్‌ను ఉపయోగిస్తుంది, దీని నుండి డౌన్‌లోడ్ చేసుకోవచ్చు www.st.com.
దశ 1. అవసరమైన డ్రైవర్లు ఇన్‌స్టాల్ చేయబడి ఉన్నాయని మరియు తగిన విస్తరణ బోర్డుతో కూడిన STM32 న్యూక్లియో బోర్డ్ PCకి కనెక్ట్ చేయబడిందని నిర్ధారించుకోండి.
దశ 2. ప్రధాన అప్లికేషన్ విండోను తెరవడానికి MEMS-స్టూడియో అప్లికేషన్‌ను ప్రారంభించండి.
మద్దతు ఉన్న ఫర్మ్‌వేర్‌తో కూడిన STM32 న్యూక్లియో బోర్డ్ PCకి కనెక్ట్ చేయబడితే, అది స్వయంచాలకంగా గుర్తించబడుతుంది.
మూల్యాంకన బోర్డుకి కనెక్షన్‌ని ఏర్పాటు చేయడానికి [కనెక్ట్] బటన్‌ను నొక్కండి.

దశ 3. మద్దతు ఉన్న ఫర్మ్‌వేర్‌తో STM32 న్యూక్లియో బోర్డ్‌కి కనెక్ట్ చేసినప్పుడు [లైబ్రరీ మూల్యాంకనం] ట్యాబ్ తెరవబడుతుంది.
డేటా స్ట్రీమింగ్‌ను ప్రారంభించడానికి మరియు ఆపడానికి, సముచితమైన [ప్రారంభించు] టోగుల్ చేయండి లేదా [ఆపు]   బాహ్య నిలువు టూల్ బార్‌పై బటన్.
కనెక్ట్ చేయబడిన సెన్సార్ నుండి వచ్చే డేటా కావచ్చు viewed లోపలి నిలువు సాధనం ba పై [డేటా టేబుల్] ట్యాబ్‌ను ఎంచుకోవడం

దశ 4. అంకితమైన అప్లికేషన్ విండోను తెరవడానికి [ఫాల్ డిటెక్షన్]పై క్లిక్ చేయండి.

దశ 5. [Save To] పై క్లిక్ చేయండి File] డేటాలాగింగ్ కాన్ఫిగరేషన్ విండోను తెరవడానికి. లో సేవ్ చేయవలసిన సెన్సార్ మరియు ఫాల్ డిటెక్షన్ డేటాను ఎంచుకోండి file. మీరు సంబంధిత బటన్‌పై క్లిక్ చేయడం ద్వారా సేవ్ చేయడం ప్రారంభించవచ్చు లేదా ఆపివేయవచ్చు.

దశ 6. గతంలో పొందిన డేటాను లైబ్రరీకి పంపడానికి మరియు ఫలితాన్ని స్వీకరించడానికి డేటా ఇంజెక్షన్ మోడ్‌ను ఉపయోగించవచ్చు. అంకితమైన వాటిని తెరవడానికి నిలువు టూల్ బార్‌లో [డేటా ఇంజెక్షన్] ట్యాబ్‌ను ఎంచుకోండి view ఈ కార్యాచరణ కోసం.

దశ 7. ఎంచుకోవడానికి [బ్రౌజ్] బటన్‌పై క్లిక్ చేయండి file CSV ఆకృతిలో గతంలో సంగ్రహించిన డేటాతో.
డేటా ప్రస్తుత పట్టికలో లోడ్ చేయబడుతుంది view.
ఇతర బటన్లు సక్రియం అవుతాయి. మీరు దీనిపై క్లిక్ చేయవచ్చు:
– ఫర్మ్‌వేర్ ఆఫ్‌లైన్ మోడ్‌ను ఆన్/ఆఫ్ చేయడానికి [ఆఫ్‌లైన్ మోడ్] బటన్ (గతంలో సంగ్రహించిన డేటాను ఉపయోగించి మోడ్).
– MEMS-స్టూడియో నుండి లైబ్రరీకి డేటా ఫీడ్‌ని నియంత్రించడానికి [ప్రారంభం]/[స్టాప్]/[స్టెప్]/[రిపీట్] బటన్‌లు.

2.5 సూచనలు
క్రింది వనరులన్నీ www.st.comలో ఉచితంగా అందుబాటులో ఉన్నాయి.

1. UM1859: STM1Cube కోసం X-CUBE-MEMS32 మోషన్ MEMS మరియు పర్యావరణ సెన్సార్ సాఫ్ట్‌వేర్ విస్తరణతో ప్రారంభించడం
2. UM1724: STM32 న్యూక్లియో-64 బోర్డులు (MB1136)
3. UM3233: MEMS-స్టూడియోతో ప్రారంభించడం

పునర్విమర్శ చరిత్ర

పట్టిక 4. డాక్యుమెంట్ పునర్విమర్శ చరిత్ర

తేదీ	వెర్షన్	మార్పులు
22-సెప్టెంబర్-2017	1	ప్రారంభ విడుదల.
6-ఫిబ్రవరి-18	2	NUCLEO-L152RE డెవలప్‌మెంట్ బోర్డ్ మరియు టేబుల్ 2కి సూచనలు జోడించబడ్డాయి. గడిచిన సమయం (μs) అల్గోరిథం.
21-మార్చి-18	3	పరిచయం మరియు విభాగం 2.1 MotionFD నవీకరించబడిందిview.
19-ఫిబ్రవరి-19	4	నవీకరించబడిన పట్టిక 2. గడిచిన సమయం (μs) అల్గోరిథం మరియు మూర్తి 2. STM32 న్యూక్లియో: LEDలు, బటన్, జంపర్. X-NUCLEO-IKS01A3 విస్తరణ బోర్డు అనుకూలత సమాచారం జోడించబడింది.
17-సెప్టెంబర్-24	5	నవీకరించబడిన విభాగం పరిచయం, విభాగం 2.1: MotionFD ముగిసిందిview, విభాగం 2.2.1: MotionFD లైబ్రరీ వివరణ, విభాగం 2.2.2: MotionFD APIలు, విభాగం 2.2.5: అల్గారిథమ్ పనితీరు, విభాగం 2.3: Sample అప్లికేషన్, విభాగం 2.4: MEMS-స్టూడియో అప్లికేషన్

ముఖ్యమైన నోటీసు - జాగ్రత్తగా చదవండి
STMicroelectronics NV మరియు దాని అనుబంధ సంస్థలు ("ST") ST ఉత్పత్తులు మరియు/లేదా ఈ పత్రంలో ఎటువంటి నోటీసు లేకుండా మార్పులు, దిద్దుబాట్లు, మెరుగుదలలు, మార్పులు మరియు మెరుగుదలలు చేసే హక్కును కలిగి ఉంటాయి. కొనుగోలుదారులు ఆర్డర్లు చేయడానికి ముందు ST ఉత్పత్తులపై తాజా సంబంధిత సమాచారాన్ని పొందాలి. ST ఉత్పత్తులు ఆర్డర్ రసీదు సమయంలో స్థానంలో ST యొక్క నిబంధనలు మరియు విక్రయ నిబంధనలకు అనుగుణంగా విక్రయించబడతాయి.
ST ఉత్పత్తుల ఎంపిక, ఎంపిక మరియు వినియోగానికి కొనుగోలుదారులు మాత్రమే బాధ్యత వహిస్తారు మరియు అప్లికేషన్ సహాయం లేదా కొనుగోలుదారుల ఉత్పత్తుల రూపకల్పనకు ST ఎటువంటి బాధ్యత వహించదు.
ఇక్కడ ST ద్వారా ఏ మేధో సంపత్తి హక్కుకు ఎలాంటి లైసెన్స్, ఎక్స్‌ప్రెస్ లేదా సూచించబడదు.
ఇక్కడ పేర్కొన్న సమాచారానికి భిన్నమైన నిబంధనలతో ST ఉత్పత్తుల పునఃవిక్రయం అటువంటి ఉత్పత్తికి ST ద్వారా మంజూరు చేయబడిన ఏదైనా వారంటీని రద్దు చేస్తుంది.
ST మరియు ST లోగో ST యొక్క ట్రేడ్‌మార్క్‌లు. ST ట్రేడ్‌మార్క్‌ల గురించి అదనపు సమాచారం కోసం, చూడండి www.st.com/trademarks. అన్ని ఇతర ఉత్పత్తి లేదా సేవా పేర్లు వాటి సంబంధిత యజమానుల ఆస్తి.
ఈ పత్రంలోని సమాచారం ఈ పత్రం యొక్క ఏదైనా మునుపటి సంస్కరణల్లో గతంలో అందించిన సమాచారాన్ని భర్తీ చేస్తుంది మరియు భర్తీ చేస్తుంది.

© 2024 STMmicroelectronics – అన్ని హక్కులు ప్రత్యేకించబడ్డాయి

పత్రాలు / వనరులు

ST X-CUBE-MEMS1 MotionFD రియల్ టైమ్ ఫాల్ డిటెక్షన్ లైబ్రరీ [pdf] యూజర్ మాన్యువల్ X-CUBE-MEMS1 MotionFD రియల్ టైమ్ ఫాల్ డిటెక్షన్ లైబ్రరీ, X-CUBE-MEMS1, MotionFD రియల్ టైమ్ ఫాల్ డిటెక్షన్ లైబ్రరీ, రియల్ టైమ్ ఫాల్ డిటెక్షన్ లైబ్రరీ, ఫాల్ డిటెక్షన్ లైబ్రరీ, డిటెక్షన్ లైబ్రరీ, లైబ్రరీ

సూచనలు

• వినియోగదారు మాన్యువల్