UM2201
İstifadəçi təlimatı
NUCLEO-F401RE MotionGR Real Time Jest Tanıma Kitabxanası
STM1Cube üçün X-CUBEMEMS32 genişləndirilməsində MotionGR real vaxt jest tanınması kitabxanasına başlayın
Giriş
MotionGR, orta proqram kitabxanasının bir hissəsidir X-CUBE-MEMS1 proqram təminatı və STM32 üzərində işləyir. Real vaxt rejimində məlumat verir
istifadəçinin sadəcə mobil telefon kimi cihazla etdiyi jest haqqında.
Aşağıdakı jestləri ayırd edə bilir: götür, nəzər sal, oyan.
Bu kitabxana yalnız ST MEMS ilə işləmək üçün nəzərdə tutulub.
Alqoritm statik kitabxana formatında təqdim olunub və ARM® Cortex® -M32, ARM® Cortex® -M3, ARM® Cortex® -M33 və ya ARM® Cortex® -M4 arxitekturasına əsaslanan STM7 mikrokontrollerlərində istifadə üçün nəzərdə tutulub.
Üstündə tikilib STM32Cube müxtəlif STM32 mikro nəzarətçiləri arasında daşınmanı asanlaşdıran proqram texnologiyası.
Proqram təminatı s ilə gəlirampicrası davam edir X-NUCLEO-IKS4A1 or X-NUCLEO-IKS01A3 genişləndirmə lövhəsində a NUCLEO-F401RE, NUCLEO-U575ZI-Q or NUCLEO-L152RE inkişaf lövhəsi.
Qısaltmalar və ixtisarlar
Cədvəl 1. Akronimlərin siyahısı
| Akronim | Təsvir |
| API | Tətbiq proqramlaşdırma interfeysi |
| BSP | İdarə heyətinə dəstək paketi |
| GUI | Qrafik istifadəçi interfeysi |
| HAL | Hardware abstraksiya təbəqəsi |
| IDE | İnteqrasiya edilmiş inkişaf mühiti |
STM1Cube üçün X-CUBE-MEMS32 proqram təminatının genişləndirilməsində MotionGR ara proqram kitabxanası
2.1 MotionGR bitdiview
MotionGR kitabxanası funksionallığı genişləndirir X-CUBE-MEMS1 proqram təminatı.
Kitabxana akselerometrdən məlumatları əldə edir və istifadəçinin cihazla etdiyi jest haqqında məlumat verir.
Kitabxana yalnız ST MEMS üçün nəzərdə tutulmuşdur. Digər MEMS sensorlarından istifadə edərkən funksionallıq və performans təhlil edilmir və sənəddə təsvir olunanlardan əhəmiyyətli dərəcədə fərqlənə bilər.
Sample həyata keçirilməsi üçün mövcuddur X-NUCLEO-IKS4A1 və X-NUCLEO-IKS01A3 genişləndirici lövhələr, quraşdırılmış a NUCLEO-F401RE, NUCLEO-U575ZI-Q or NUCLEO-L152RE inkişaf lövhəsi.
2.2 MotionGR kitabxanası
MotionGR API-lərinin funksiyalarını və parametrlərini tam təsvir edən texniki məlumatı MotionGR_Package.chm tərtib edilmiş HTML-də tapa bilərsiniz. file Sənədlər qovluğunda yerləşir.
2.2.1 MotionGR kitabxanasının təsviri
MotionGR jest tanınması kitabxanası akselerometrdən alınan məlumatları idarə edir; xüsusiyyətləri:
- aşağıdakı fəaliyyətləri ayırd etmək imkanı: götürmək, baxmaq, oyanmaq
- yalnız akselerometr məlumatlarına əsaslanan tanınma
- tələb olunan akselerometr məlumatları sampling tezliyi 50 Hz-dir
- Resurs tələbləri:
– Cortex-M3: 10.0 kB kod və 4.4 kB məlumat yaddaşı
– Cortex-M33: 10.1 kB kod və 4.4 kB məlumat yaddaşı
– Cortex-M4: 10.2 kB kod və 4.4 kB məlumat yaddaşı
– Cortex-M7: 10.3 kB kod və 4.4 kB məlumat yaddaşı - ARM® Cortex®-M3, ARM® Cortex® -M33, ARM® Cortex® -M4 və ARM® Cortex® -M7 arxitekturaları üçün mövcuddur
2.2.2 MotionGR API-ləri
MotionGR kitabxana API-ləri bunlardır:
- uint8_t MotionGR_GetLibVersion(char *versiya)
– kitabxana versiyasını əldə edir
– *versiya 35 simvoldan ibarət massiv üçün göstəricidir
– versiya sətirindəki simvolların sayını qaytarır - void MotionGR_Initialize(etibarsız)
– MotionGR kitabxanasının işə salınmasını və daxili mexanizmin qurulmasını həyata keçirir
Qeyd: Bu funksiya jestlərin tanınması kitabxanasından istifadə etməzdən əvvəl çağırılmalıdır və STM32 mikrokontrollerindəki CRC modulu (RCC periferik saat aktivləşdirmə registrində) aktivləşdirilməlidir.
- etibarsız MotionGR_Update(MGR_input_t *data_in, MGR_output_t *data_out)
– jestlərin tanınması alqoritmini icra edir
– *data_in parametri daxil verilənləri olan strukturun göstəricisidir
– MGR_input_t struktur növü üçün parametrlər:
◦ AccX g-də X oxundakı akselerometr sensor dəyəridir
◦ AccY g-də Y oxundakı akselerometr sensor dəyəridir
◦ AccZ g-də Z oxundakı akselerometr sensor dəyəridir
– *data_out parametri aşağıdakı elementləri olan enum üçün göstəricidir:
◦ MGR_NOGESTURE = 0
◦ MGR_PICKUP = 1
◦ MGR_GLANCE = 2
◦ MGR_WAKEUP = 3 - void MotionGR_SetOrientation_Acc (const char *acc_orientation)
– bu funksiya akselerometr məlumatının oriyentasiyasını təyin etmək üçün istifadə olunur
– konfiqurasiya adətən MotionGR_Initialize funksiyasının çağırışından dərhal sonra həyata keçirilir
– *acc_orientation parametri x, y, z ardıcıllığında akselerometr məlumatının çıxışı üçün istifadə olunan istinad çərçivəsinin müsbət istiqamətlərinin hər birinin istiqamətini göstərən üç simvoldan ibarət sətirin göstəricisidir. Etibarlı dəyərlər bunlardır: n (şimal) və ya s (cənub), w (qərb) və ya e (şərq), u (yuxarı) və ya d (aşağı).
– Aşağıdakı şəkildə göstərildiyi kimi, X-NUCLEO-IKS4A1 akselerometr sensoru SEU-ya malikdir (x – Cənub, y – Şərq, z – Yuxarı), ona görə də sətir belədir: “seu”.
Şəkil 1. Məsələnampsensor istiqamətləri
2.2.3 API axını diaqramı
Şəkil 2. MotionGR API məntiq ardıcıllığı
2.2.4 Demo kodu
Aşağıdakı nümayiş kodu akselerometr sensorundan məlumatları oxuyur və jest kodunu alır.
2.2.5 Alqoritmin icrası
Jestlərin tanınması alqoritmi yalnız akselerometrdən alınan məlumatlardan istifadə edir və enerji istehlakını azaltmaq üçün aşağı tezlikdə (50 Hz) işləyir.
Aşağıdakı istifadəçi jestləri haqqında real vaxt məlumatını aşkar edir və təmin edir:
- götürmək: lövhəni masadan qaldırmaq/qaldırmaq;
- baxış: telefonun ona baxmaq üçün fırlanması jestinə bənzər lövhənin təxminən 30° fırlanması;
- oyanmaq: silkələmək hərəkəti.
Cədvəl 2. Alqoritmin keçmə müddəti (µs) Cortex-M4, Cortex-M3
| Cortex-M4 STM32F401RE 84 MHz | Cortex-M3 STM32L152RE 32 MHz | ||||
| Min | Ort | Maks | Min | Ort | Maks |
| 136 | 240 | 341 | 473 | 870 | 1235 |
Cədvəl 3. Alqoritmin keçmə müddəti (µs) Cortex-M33 və Cortex-M7
| Cortex- M33 STM32U575ZI-Q 160 MHz | Cortex- M7 STM32F767ZI 96 MHz | ||||
| Min | Ort | Maks | Min | Ort | Maks |
| 87 | 140 | 191 | 459 | 504 | 808 |
2.3 Samptətbiq
MotionGR ara proqramı istifadəçi proqramlarını yaratmaq üçün asanlıqla manipulyasiya edilə bilər; kimiample proqram Tətbiq qovluğunda verilir.
A üzərində işləmək üçün nəzərdə tutulmuşdur NUCLEO-F401RE, NUCLEO-U575ZI-Q or NUCLEO-L152RE X-NUCLEO-IKS4A1 və ya X-NUCLEO-IKS01A3 genişləndirmə lövhəsinə qoşulmuş inkişaf lövhəsi.
Tətbiq real vaxt rejimində yerinə yetirilən jestləri tanıyır.
Şəkil 3. STM32 Nucleo: LED-lər, düymə, keçid
Yuxarıdakı şəkildə istifadəçi düyməsi B1 və NUCLEO-F401RE lövhəsinin üç LED-i göstərilir. Lövhə enerjiyə verildikdən sonra LED LD3 (PWR) yanır.
Real vaxt məlumatlarına nəzarət etmək üçün USB kabel bağlantısı tələb olunur. Lövhə USB bağlantısı vasitəsilə PC tərəfindən qidalanır. Bu iş rejimi istifadəçiyə aşkar edilmiş jesti, akselerometr məlumatlarını, stamp və nəticədə digər sensor məlumatları, real vaxt rejimində istifadə edərək MEMS-Studio.
2.4 MEMS Studio proqramı
Sample proqram istifadə edir MEMS-Studio proqramdan yükləyə bilərsiniz www.st.com.
Addım 1. Lazımi sürücülərin quraşdırıldığından və STM32 nüvəsi müvafiq genişləndirmə lövhəsi olan lövhə PC-yə qoşulur.
Addım 2. işə salın MEMS-Studio əsas proqram pəncərəsini açmaq üçün proqram.
Dəstəklənən proqram təminatı ilə STM32 Nucleo lövhəsi PC-yə qoşulubsa, o, avtomatik aşkarlanır.
Qiymətləndirmə lövhəsi ilə əlaqə yaratmaq üçün [Qoşulun] düyməsini basın.
Şəkil 4. MEMS-Studio – Qoşulun
Addım 3. Dəstəklənən proqram təminatı ilə STM32 Nucleo lövhəsinə qoşulduqda [Kitabxananın Qiymətləndirilməsi] nişanı açılır.
Məlumat axınını başlamaq və dayandırmaq üçün müvafiq [Start] düyməsini dəyişin 
və ya [Dayan] 
xarici şaquli alətlər panelindəki düymə.
Bağlı sensordan gələn məlumatlar ola bilər viewdaxili şaquli alətlər panelində [Data Cədvəli] nişanını seçərək.
Şəkil 5. MEMS-Studio – Kitabxananın Qiymətləndirilməsi – Məlumat Cədvəli
Addım 4. Xüsusi proqram pəncərəsini açmaq üçün [Jestin tanınması] üzərinə klikləyin.
Şəkil 6. MEMS-Studio – Kitabxananın Qiymətləndirilməsi – Jestlərin tanınması
Addım 5. [Saxla] üzərinə klikləyin File] məlumat qeydinin konfiqurasiya pəncərəsini açmaq üçün. Saxlanacaq sensor və jest tanınma məlumatlarını seçin file. Müvafiq düyməni klikləməklə yadda saxlamağa başlaya və ya dayandıra bilərsiniz.
Şəkil 7. MEMS-Studio – Kitabxananın Qiymətləndirilməsi – Saxla File
Addım 6. Data Injection rejimi əvvəllər əldə edilmiş məlumatları kitabxanaya göndərmək və nəticəni almaq üçün istifadə edilə bilər. Xüsusi bölməni açmaq üçün şaquli alətlər panelində [Data Injection] sekmesini seçin view bu funksionallıq üçün.
Şəkil 8. MEMS-Studio – Kitabxananın Qiymətləndirilməsi – Məlumatların Yerləşdirilməsi
Addım 7. Seçmək üçün [Browse] düyməsinə klikləyin file CSV formatında əvvəllər ələ keçirilmiş məlumatlarla.
Məlumat cari vəziyyətdə cədvələ yüklənəcəkdir view.
Digər düymələr aktiv olacaq. Siz klikləyə bilərsiniz:
– Firmware oflayn rejimini yandırmaq/söndürmək üçün [Offline Mode] düyməsi (əvvəllər çəkilmiş məlumatlardan istifadə edən rejim).
– [Start]/[Stop]/[Addım]/[Təkrar] düymələri MEMS-Studio-dan kitabxanaya məlumat ötürülməsini idarə etmək üçün.
İstinadlar
Aşağıdakı resursların hamısı www.st.com saytında sərbəst mövcuddur.
- UM1859: STM1Cube üçün X-CUBE-MEMS32 hərəkət MEMS və ətraf mühit sensoru proqram təminatının genişləndirilməsi ilə işə başlayın
- UM1724: STM32 Nucleo-64 lövhələri (MB1136)
- UM3233: MEMS-Studio ilə işə başlayın
Təftiş tarixi
Cədvəl 4. Sənədin təftiş tarixi
| Tarix | Versiya | Dəyişikliklər |
| 06 iyun 2017-ci il | 1 | İlkin buraxılış. |
| 26-2018 yanvar | 2 | NUCLEO-L152RE inkişaf lövhəsinə və Cədvəl 2-ə istinadlar əlavə edildi. Keçən vaxt (μs) alqoritmi. |
| 20 mart 2018-ci il | 3 | Yenilənmiş Giriş və Bölmə 2.1 MotionGR bitdiview. |
| 21-fevral 2019 | 4 | Yenilənmiş Şəkil 1. Məsampsensor oriyentasiyalarının le, Cədvəl 2. Keçən vaxt (µs) alqoritmi və Şəkil 3. STM32 Nüvəsi: LEDlər, düymə, keçid. X-NUCLEO-IKS01A3 genişləndirmə lövhəsi uyğunluğu haqqında məlumat əlavə edildi. |
| 24 mart 2020-ci il | 5 | Yenilənmiş Giriş, Bölmə 2.2.1 MotionGR kitabxanasının təsviri və Bölmə 2.2.5 Alqoritm performansı. ARM Cortex-M7 arxitektura uyğunluğu məlumatı əlavə edildi. |
| 17-2024 sentyabr | 6 | Yenilənib Bölmə Giriş, Bölmə 2.1: MotionGR bitdiview, Bölmə 2.2.1: MotionGR kitabxanası təsviri, Bölmə 2.2.2: MotionGR API-ləri, Bölmə 2.2.5: Alqoritmin icrası, Bölmə 2.3: Samptətbiq, Bölmə 2.4: MEMS Studio tətbiqi |
Vacib XƏBƏRDARLIQ – DİQQƏTLİ OXUYUN
STMicroelectronics NV və onun törəmə müəssisələri (“ST”) istənilən vaxt xəbərdarlıq etmədən ST məhsullarına və/yaxud bu sənədə dəyişikliklər, düzəlişlər, təkmilləşdirmələr, dəyişikliklər və təkmilləşdirmələr etmək hüququnu özündə saxlayır. Alıcılar sifariş verməzdən əvvəl ST məhsulları haqqında ən son müvafiq məlumatları əldə etməlidirlər. ST məhsulları, sifarişin qəbulu zamanı mövcud olan ST-nin satış şərtlərinə uyğun olaraq satılır.
Alıcılar ST məhsullarının seçimi, seçimi və istifadəsinə görə məsuliyyət daşıyırlar və ST tətbiq yardımı və ya alıcıların məhsullarının dizaynına görə heç bir məsuliyyət daşımır.
ST tərəfindən hər hansı əqli mülkiyyət hüququna açıq və ya nəzərdə tutulan heç bir lisenziya verilmir.
ST məhsullarının burada göstərilən məlumatdan fərqli müddəalarla yenidən satışı ST tərəfindən belə məhsul üçün verilən hər hansı zəmanəti ləğv edir.
ST və ST loqosu ST-nin ticarət nişanlarıdır. ST ticarət nişanları haqqında əlavə məlumat üçün baxın www.st.com/trademarks. Bütün digər məhsul və ya xidmət adları müvafiq sahiblərinin mülkiyyətidir.
Bu sənəddəki məlumatlar əvvəllər bu sənədin hər hansı əvvəlki versiyalarında verilmiş məlumatları əvəz edir və əvəz edir.
© 2024 STMicroelectronics – Bütün hüquqlar qorunur
UM2201 – Rev 6 – Sentyabr 2024
Əlavə məlumat üçün yerlinizlə əlaqə saxlayın
STMicroelectronics satış ofisi.
www.st.com
Sənədlər / Resurslar
 |
ST NUCLEO-F401RE MotionGR Real Time Jest Tanıma Kitabxanası [pdf] İstifadəçi Təlimatı NUCLEO-F401RE, NUCLEO-U575ZI-Q, NUCLEO-L152RE, NUCLEO-F401RE MotionGR Real Time Gesture Recognition Library, NUCLEO-F401RE, MotionGR Real Time Jest Recognition Library, Time Recognition Library, Gesture Recognition Library, ary |