STMicroelectronics UM3330 MotionSM Aleep Monitoring Library
Zavedení
Motion SM je součástí knihovny middlewaru softwaru X-CUBE-MEMS1 a běží na STM32. Poskytuje sledování spánku uživatele v reálném čase na základě dat ze zařízení.
Poskytuje informace v reálném čase, zda uživatel spí nebo ne. Knihovna je určena pro přístroje nošené na zápěstí. Tato knihovna je určena pouze pro práci s ST MEMS.
Algoritmus je poskytován ve formátu statické knihovny a je navržen pro použití na mikrokontrolérech STM32 založených na architektuře Arm Cortex®-M3, Arm Cortex®-M4, Arm Cortex®-M33 nebo Arm Cortex®-M7.
Je postaven na softwarové technologii STM32Cube, která usnadňuje přenositelnost mezi různými mikrokontroléry STM32.
Zkratky a zkratky
Tabulka 1. Seznam zkratek
| Akronym | Popis |
| API | Aplikační programovací rozhraní |
| BSP | Balíček podpory desky |
| GUI | Grafické uživatelské rozhraní |
| HAL | Vrstva abstrakce hardwaru |
| IDE | Integrované vývojové prostředí |
Knihovna middlewaru MotionSM v softwarovém rozšíření X-CUBE-MEMS1 pro STM32Cube
MotionSM skončilview
Knihovna Motion SM rozšiřuje funkčnost softwaru X-CUBE-MEMS1.
Knihovna získává data z akcelerometru a poskytuje informace v reálném čase, zda uživatel spí nebo ne. Knihovna je určena pro přístroje nošené na zápěstí.
Knihovna je určena pouze pro ST MEMS. Funkčnost a výkon při použití jiných MEMS senzorů nejsou analyzovány a mohou se výrazně lišit od toho, co je popsáno v dokumentu.
Knihovna MotionSM
Technické informace plně popisující funkce a parametry API Motion SM lze nalézt v kompilovaném HTML kódu MotionMC_Package.chm file umístěné ve složce dokumentace.
Popis knihovny Motion SM
- Knihovna sledování spánku Motion SM spravuje data získaná z akcelerometru; to představuje:
- Možnost rozlišení, zda uživatel spí nebo ne
- Určeno pro zařízení založená na zápěstí
- Rozpoznání pouze na základě údajů akcelerometru
- Požadované údaje akcelerometru sampfrekvence 16 Hz
- Požadavky na zdroje:
- Cortex®-M3: 1.7 KB kódu a 2.2 KB datové paměti
- Cortex®-M33: 1.6 KB kódu a 2.2 KB datové paměti
- Cortex®-M4: 1.6 KB kódu a 2.2 KB datové paměti
- Cortex®-M7: 1.6 KB kódu a 2.2 KB datové paměti
- K dispozici pro architektury Arm Cortex®-M3, Arm Cortex®-M33, Arm Cortex®-M4 a Arm Cortex® M7
- Známá omezení: stav spánku může být také detekován, pokud je zařízení ve stabilní poloze, napřample: uloženo na polici. Algoritmus sledování spánku se doporučuje kombinovat s algoritmem rozpoznávání aktivity pro zápěstí (Knihovna Motion AW) a spustit jej pouze v případě, že je detekována poloha vleže.
Motion SM API
Rozhraní API knihovny Motion SM jsou:
- uint8_t Motion SM_ Verze GetLib (char *verze)
- Načte verzi knihovny
- *verze je ukazatel na pole 35 znaků
- Vrátí počet znaků v řetězci verze
- void Motion SM_ Initialize(void)
- Provádí inicializaci knihovny Motion SM a nastavení vnitřního mechanismu
- CRC modul v mikrokontroléru STM32 (v registru povolení periferních hodin RCC) musí být povolen před použitím knihovny
Poznámka: Tato funkce musí být volána před použitím knihovny sledování spánku
- void Motion SM_ Reset(void)
- Resetuje algoritmus sledování spánku
- void Motion SM_ Update (MSM_ input_t *data_in, MSM_ output_t *data_out)
- Spouští algoritmus sledování spánku
- *data_ v parametru je ukazatel na strukturu se vstupními daty
- Parametry pro typ struktury MSD_ input_t jsou:
- AccX je hodnota akcelerometru na ose X v g
- AccY je hodnota snímače akcelerometru v ose Y v g
- AccZ je hodnota snímače akcelerometru v ose Z v g
- Parametr *data_out je ukazatel na strukturu s výstupními daty
- Parametry pro typ struktury MSD_ output_t jsou:
- Příznak spánku je příznak spánku
- Celková doba spánku je celková doba spánku
- void Motion SM_ Set Orientation_ Acc(const char *acc_ Orientation)
- Nastavuje orientaci akcelerometru
- *acc_ orientace je ukazatel na řetězec obsahující referenční systém nezpracovaných dat akcelerometru (například: z jihozápadu nahoru se stalo „swu“, ze severovýchodu nahoru se stalo „ned“)
Vývojový diagram API
Obrázek 1. Logická sekvence Motion SM API
Demo kód
Následující demonstrační kód čte data ze senzoru akcelerometru a získává kód intenzity pohybu.
[…] #define VERSION_STR_LENG 35 […] /*** Inicializace ***/ char lib_version[VERSION_STR_LENG]; /* Funkce inicializace rozhraní API pro monitorování spánku */ MotionSM_Initialize(); /* Nastaví skutečnou orientaci senzoru akcelerometru */ MotionSM_SetOrientation_Acc(“ned”); /* Volitelné: Získat verzi */ MotionSM_GetLibVersion(lib_version); […] /*** Používání algoritmu sledování spánku ***/ Timer_OR_DataRate_Interrupt_Handler() { MSM_input_t data_in; MSM_output_t data_out; /* Získání zrychlení X/Y/Z v g */ MEMS_Read_AccValue(&data_in.AccX, &data_in.AccY, &data_in.AccZ); /* Aktualizace algoritmu detekce intenzity */ MotionSM_ Update(&data_ in, &data_ out); }
Reference
Následující zdroje jsou volně dostupné na www.st.com:
- UM1859: Začínáme s rozšířením softwaru X-CUBE-MEMS1 motion MEMS a senzoru prostředí pro STM32Cube
- UM1724: Deska STM32 Nucleo-64
- UM2128: Začínáme s Unicleo-GUI pro pohyb MEMS a rozšíření softwaru senzoru prostředí pro STM32Cube
Historie revizí
Tabulka 2. Historie revizí dokumentu
| Datum | Revize | Změny |
| 02-dub-2024 | 1 | Počáteční vydání. |
DŮLEŽITÉ UPOZORNĚNÍ – ČTĚTE POZORNĚ
STMicroelectronics NV a její dceřiné společnosti (“ST”) si vyhrazují právo provádět změny, opravy, vylepšení, úpravy a vylepšení produktů ST a/nebo tohoto dokumentu kdykoli bez upozornění. Kupující by měli před zadáním objednávky získat nejnovější relevantní informace o produktech ST. Produkty ST jsou prodávány v souladu s prodejními podmínkami ST platnými v době potvrzení objednávky.
Kupující jsou výhradně odpovědní za výběr, výběr a použití produktů ST a ST nepřebírá žádnou odpovědnost za pomoc s aplikací nebo design produktů kupujících.
Společnost ST zde neuděluje žádnou výslovnou ani předpokládanou licenci k právu duševního vlastnictví.
Další prodej produktů ST s ustanoveními odlišnými od informací uvedených v tomto dokumentu ruší jakoukoli záruku poskytnutou společností ST na takový produkt.
ST a logo ST jsou ochranné známky společnosti ST. Další informace o ochranných známkách ST viz www.st.com/trademarks. Všechny ostatní názvy produktů nebo služeb jsou majetkem jejich příslušných vlastníků.
Informace v tomto dokumentu nahrazují a nahrazují informace dříve uvedené v předchozích verzích tohoto dokumentu.
© 2024 STMicroelectronics – Všechna práva vyhrazena
Dokumenty / zdroje
 |
STMicroelectronics UM3330 MotionSM Aleep Monitoring Library [pdfUživatelská příručka UM3330 MotionSM Aleep Monitoring Library, UM3330, MotionSM Aleep Monitoring Library, Aleep Monitoring Library, Monitoring Library, Library |
