UM2275
მომხმარებლის სახელმძღვანელო
დაიწყეთ MotionFD რეალურ დროში დაცემის აღმოჩენის ბიბლიოთეკა X-CUBE-MEMS1 გაფართოებაში STM32Cube-ისთვის
შესავალი
MotionEC არის X-CUBE-MEMS1 პროგრამული უზრუნველყოფის შუაპროგრამის ბიბლიოთეკის კომპონენტი და მუშაობს STM3z2-ზე. ის უზრუნველყოფს რეალურ დროში ინფორმაციას მოწყობილობის ორიენტაციისა და მოძრაობის სტატუსის შესახებ მოწყობილობის მონაცემებზე დაყრდნობით.
ის უზრუნველყოფს შემდეგ გამოსავალს: მოწყობილობის ორიენტაცია (კვატერნიონები, ეილერის კუთხეები), მოწყობილობის ბრუნვა (ვირტუალური გიროსკოპის ფუნქციონირება), გრავიტაციის ვექტორი და ხაზოვანი აჩქარება.
ეს ბიბლიოთეკა განკუთვნილია მხოლოდ ST MEMS-თან მუშაობისთვის.
ალგორითმი მოწოდებულია სტატიკური ბიბლიოთეკის ფორმატში და შექმნილია გამოსაყენებლად STM32 მიკროკონტროლერებზე, რომლებიც დაფუძნებულია ARM® Cortex®-M0+, ARM® Cortex®-M3, ARM® Cortex®-M33, ARM® Cortex®-M4 და ARM®-ზე. Cortex®-M7 არქიტექტურები.
იგი აგებულია STM32Cube პროგრამული ტექნოლოგიის თავზე, რათა გაამარტივოს პორტაბელურობა სხვადასხვა STM32 მიკროკონტროლერებში.
პროგრამას მოყვება სampდანერგვა მუშაობს X-NUCLEO-IKS4A1 ან X-NUCLEO-IKS01A3 გაფართოების დაფაზე NUCLEO-F401RE, NUCLEO-U575ZI-Q ან NUCLEO-L152RE განვითარების დაფაზე.
აბრევიატურა და აბრევიატურა
ცხრილი 1. აკრონიმების სია
აკრონიმი | აღწერა |
API | აპლიკაციის პროგრამირების ინტერფეისი |
BSP | საბჭოს მხარდაჭერის პაკეტი |
GUI | გრაფიკული მომხმარებლის ინტერფეისი |
HAL | ტექნიკის აბსტრაქციის ფენა |
IDE | ინტეგრირებული განვითარების გარემო |
MotionFD Middleware ბიბლიოთეკა X-CUBE-MEMS1 პროგრამული გაფართოებაში STM32Cube-ისთვის
2.1 MotionFD დასრულდაview
MotionFD ბიბლიოთეკა აფართოებს X-CUBE-MEMS1 პროგრამული უზრუნველყოფის ფუნქციონირებას.
ბიბლიოთეკა იძენს მონაცემებს აქსელერომეტრისა და წნევის სენსორიდან და უზრუნველყოფს ინფორმაციას მომხმარებლის დაცემის მოვლენის შესახებ მოწყობილობის მონაცემების საფუძველზე.
ბიბლიოთეკა განკუთვნილია მხოლოდ ST MEMS-ისთვის. ფუნქციონალობა და შესრულება სხვა MEMS სენსორების გამოყენებისას არ არის გაანალიზებული და შეიძლება მნიშვნელოვნად განსხვავდებოდეს დოკუმენტში აღწერილისგან.
Sampდანერგვა ხელმისაწვდომია X-NUCLEO-IKS4A1 და X-NUCLEO-IKS01A3 გაფართოების დაფისთვის, რომელიც დამონტაჟებულია NUCLEO-F401RE, NUCLEO-U575ZI-Q ან NUCLEO-L152RE განვითარების დაფაზე.
2.2 MotionFD ბიბლიოთეკა
ტექნიკური ინფორმაცია, რომელიც სრულად აღწერს MotionFD API-ების ფუნქციებსა და პარამეტრებს, შეგიძლიათ იხილოთ MotionFD_Package.chm-ში შედგენილ HTML-ში. file მდებარეობს Documentation საქაღალდეში.
2.2.1 MotionFD ბიბლიოთეკის აღწერა
MotionFD დაცემის აღმოჩენის ბიბლიოთეკა მართავს ამაჩქარებლისა და წნევის სენსორიდან შეძენილ მონაცემებს; მას აქვს მახასიათებლები:
- შესაძლებლობა განასხვავოს მომხმარებლის დაცემა მოხდა თუ არა
- ამოცნობა მხოლოდ აქსელერომეტრისა და წნევის სენსორის მონაცემებზე დაყრდნობით
- საჭირო ამაჩქარებლისა და წნევის სენსორის მონაცემები სampლინგის სიხშირეა 25 ჰც
- რესურსების მოთხოვნები:
– Cortex-M3: 3.6 კბ კოდი და 3.2 კბ მონაცემთა მეხსიერება
– Cortex-M33: 3.4 კბ კოდი და 3.2 კბ მონაცემთა მეხსიერება
– Cortex-M4: 3.4 კბ კოდი და 3.2 კბ მონაცემთა მეხსიერება
– Cortex-M7: 3.4 კბ კოდი და 3.2 მონაცემთა მეხსიერება - ხელმისაწვდომია ARM Cortex-M3, ARM Cortex-M33, ARM Cortex-M4 და ARM Cortex-M7 არქიტექტურებისთვის
2.2.2 MotionFD API
MotionFD ბიბლიოთეკის API არის:
- uint8_t MotionFD_GetLibVersion(char *ვერსია)
- იბრუნებს ბიბლიოთეკის ვერსიას
– *ვერსია არის მაჩვენებელი 35 სიმბოლოსგან შემდგარი მასივის მიმართ
– აბრუნებს სიმბოლოების რაოდენობას ვერსიის სტრიქონში - void MotionFD_Initialize(void)
– ასრულებს MotionFD ბიბლიოთეკის ინიციალიზაციას და შიდა მექანიზმის დაყენებას
შენიშვნა: ეს ფუნქცია უნდა გამოიძახოთ დაცემის ამოცნობის ბიბლიოთეკის გამოყენებამდე და ჩართული უნდა იყოს CRC მოდული STM32 მიკროკონტროლერში (RCC პერიფერიული საათის ჩართვის რეესტრში).
- void MotionFD_Update (MFD_input_t *data_in, MFD_output_t *data_out)
- ახორციელებს დაცემის გამოვლენის ალგორითმს
– *data_in პარამეტრი არის სტრუქტურის მაჩვენებელი შეყვანის მონაცემებით
– სტრუქტურის ტიპის MFD_input_t პარამეტრებია:
◦ AccX არის აქსელერომეტრის სენსორის მნიშვნელობა X ღერძში მგ-ში
◦ AccY არის აქსელერომეტრის სენსორის მნიშვნელობა Y ღერძში მგ-ში
◦ AccZ არის ამაჩქარებლის სენსორის მნიშვნელობა Z ღერძში მგ
◦ პრესა არის წნევის სენსორის მნიშვნელობა hPa-ში
– *data_out პარამეტრი არის ციფრული მითითება შემდეგი ელემენტებით:
◦ MFD_NOFALL = 0
◦ MFD_FALL = 1 - void MotionFD_SetKnobs (float fall_threshold, int32_t fall_altitude_delta, float lying_time)
– ადგენს ბიბლიოთეკის კონფიგურაციის პარამეტრებს
– დაცემის_ზღურბლის აჩქარების ბარიერი მგ-ში
– დაცემა_სიმაღლე_დელტა სიმაღლის სხვაობა სმ-ში
– წოლის დრო წამებში დარტყმის შემდეგ მოძრაობის გარეშე - void MotionFD_GetKnobs(float *fall_threshold, int32_t *fall_altitude_delta, float *lying_time)
- იღებს ბიბლიოთეკის კონფიგურაციის პარამეტრებს
– დაცემის_ზღურბლის აჩქარების ბარიერი მგ-ში
– დაცემა_სიმაღლე_დელტა სიმაღლის სხვაობა სმ-ში
– წოლის დრო წამებში დარტყმის შემდეგ მოძრაობის გარეშე
2.2.3 API ნაკადის სქემა
2.2.4 დემო კოდი
შემდეგი საჩვენებელი კოდი კითხულობს მონაცემებს აქსელერომეტრისა და წნევის სენსორიდან და იღებს შემოდგომის მოვლენის კოდს.
2.2.5 ალგორითმის შესრულება
დაცემის გამოვლენის ალგორითმი იყენებს მხოლოდ ამაჩქარებლისა და წნევის სენსორის მონაცემებს და მუშაობს დაბალ სიხშირეზე (25 ჰც) ენერგიის მოხმარების შესამცირებლად.
2.3 სampგანაცხადი
MotionFD შუალედური პროგრამული უზრუნველყოფის მარტივად მანიპულირება შესაძლებელია მომხმარებლის აპლიკაციების შესაქმნელად; როგორცampაპლიკაცია მოწოდებულია განაცხადის საქაღალდეში.
იგი შექმნილია NUCLEO-F401RE, NUCLEO-U575ZI-Q ან NUCLEO-L152RE განვითარების დაფაზე, რომელიც დაკავშირებულია X-NUCLEO-IKS4A1 ან X-NUCLEO-IKS01A3 გაფართოების დაფაზე.
აპლიკაცია ცნობს მომხმარებლის დაცემის მოვლენას რეალურ დროში.
ზემოთ მოყვანილ სურათზე ნაჩვენებია მომხმარებლის ღილაკი B1 და NUCLEO-F401RE დაფის სამი LED. როდესაც დაფა ჩაირთვება, LED LD3 (PWR) ჩაირთვება.
რეალურ დროში მონაცემების მონიტორინგისთვის საჭიროა USB კაბელის კავშირი. დაფა იკვებება კომპიუტერით USB კავშირის საშუალებით. მუშაობის ეს რეჟიმი საშუალებას აძლევს გამოვლენილი მომხმარებლის დაცემის მოვლენას, ამაჩქარებლისა და წნევის სენსორის მონაცემებს, დროის ქamp და საბოლოოდ სხვა სენსორული მონაცემები, რეალურ დროში, MEMS-Studio-ის გამოყენებით.
2.4 MEMS-Studio აპლიკაცია
სample აპლიკაცია იყენებს MEMS-Studio აპლიკაციას, რომლის ჩამოტვირთვა შესაძლებელია www.st.com.
ნაბიჯი 1. დარწმუნდით, რომ დაყენებულია საჭირო დრაივერები და STM32 Nucleo დაფა შესაბამისი გაფართოების დაფით არის დაკავშირებული კომპიუტერთან.
ნაბიჯი 2. გაუშვით MEMS-Studio აპლიკაცია აპლიკაციის ძირითადი ფანჯრის გასახსნელად.
თუ STM32 Nucleo დაფა მხარდაჭერილი პროგრამული უზრუნველყოფით არის დაკავშირებული კომპიუტერთან, ის ავტომატურად გამოვლინდება.
დააჭირეთ ღილაკს [დაკავშირება] შეფასების დაფასთან კავშირის დასამყარებლად.
ნაბიჯი 3. მხარდაჭერილი პროგრამული უზრუნველყოფის მქონე STM32 Nucleo დაფასთან დაკავშირებისას იხსნება ჩანართი [Library Evaluation].
მონაცემთა ნაკადის დასაწყებად და შესაჩერებლად, გადართეთ შესაბამისი [დაწყება] ან [გაჩერება]
ღილაკი ხელსაწყოს გარე ვერტიკალურ ზოლზე.
დაკავშირებული სენსორიდან მიღებული მონაცემები შეიძლება იყოს viewაირჩიეთ [მონაცემთა ცხრილი] ჩანართი შიდა ვერტიკალურ ხელსაწყოზე ba
ნაბიჯი 4. დააწკაპუნეთ [Fall Detection] აპლიკაციის გამოყოფილი ფანჯრის გასახსნელად.
ნაბიჯი 5. დააწკაპუნეთ [Save To File] მონაცემთა აღრიცხვის კონფიგურაციის ფანჯრის გასახსნელად. აირჩიეთ სენსორი და დაცემის ამოცნობის მონაცემები, რომ შეინახოთ მასში file. შეგიძლიათ დაიწყოთ ან შეწყვიტოთ შენახვა შესაბამის ღილაკზე დაწკაპუნებით.
ნაბიჯი 6. მონაცემთა ინექციის რეჟიმი შეიძლება გამოყენებულ იქნას ბიბლიოთეკაში ადრე შეძენილი მონაცემების გასაგზავნად და შედეგის მისაღებად. აირჩიეთ [მონაცემთა ინექცია] ჩანართი ხელსაწყოების ვერტიკალურ ზოლზე, რათა გახსნათ გამოყოფილი view ამ ფუნქციონირებისთვის.
ნაბიჯი 7. დააჭირეთ ღილაკს [Browse] ასარჩევად file ადრე აღებული მონაცემებით CSV ფორმატში.
მონაცემები ჩაიტვირთება ცხრილში მიმდინარე view.
სხვა ღილაკები გააქტიურდება. შეგიძლიათ დააჭიროთ:
– [Offline Mode] ღილაკი ჩართვის/გამორთვის პროგრამული უზრუნველყოფის ოფლაინ რეჟიმის ჩართვისთვის (რეჟიმი, რომელიც იყენებს ადრე გადაღებულ მონაცემებს).
– [დაწყება]/[შეჩერება]/[ნაბიჯი]/[გამეორება] ღილაკები MEMS-Studio-დან ბიბლიოთეკაში მონაცემთა მიწოდების გასაკონტროლებლად.
2.5 ცნობარი
ყველა შემდეგი რესურსი თავისუფლად არის ხელმისაწვდომი www.st.com-ზე.
- UM1859: დაწყება X-CUBE-MEMS1 მოძრაობის MEMS-ით და გარემოს სენსორის პროგრამული გაფართოებით STM32Cube-ისთვის
- UM1724: STM32 Nucleo-64 დაფები (MB1136)
- UM3233: MEMS-Studio-ს დაწყება
გადასინჯვის ისტორია
ცხრილი 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 Nucleo: LED-ები, ღილაკი, ჯუმპერი. დამატებულია X-NUCLEO-IKS01A3 გაფართოების დაფის თავსებადობის ინფორმაცია. |
17-სექ-24 | 5 | განახლებულია განყოფილების შესავალი, სექცია 2.1: MotionFD დასრულდაview, სექცია 2.2.1: MotionFD ბიბლიოთეკის აღწერა, სექცია 2.2.2: MotionFD APIs, განყოფილება 2.2.5: ალგორითმის შესრულება, სექცია 2.3: Sampგანაცხადი, სექცია 2.4: MEMS-Studio აპლიკაცია |
მნიშვნელოვანი შენიშვნა - წაიკითხეთ ყურადღებით
STMicroelectronics NV და მისი შვილობილი კომპანიები ("ST") იტოვებენ უფლებას ნებისმიერ დროს განახორციელონ ცვლილებები, შესწორებები, გაუმჯობესებები, მოდიფიკაციები და გაუმჯობესებები ST პროდუქტებში და/ან ამ დოკუმენტში შეტყობინების გარეშე. მყიდველებმა უნდა მიიღონ უახლესი შესაბამისი ინფორმაცია ST პროდუქტების შესახებ შეკვეთების განთავსებამდე. ST-ის პროდუქტები იყიდება ST-ის გაყიდვის პირობებისა და პირობების შესაბამისად, რომლებიც შეკვეთის დადასტურების მომენტში არსებობს.
მყიდველები არიან მხოლოდ პასუხისმგებელი ST პროდუქტების არჩევანზე, შერჩევასა და გამოყენებაზე და ST არ იღებს პასუხისმგებლობას განაცხადის დახმარებაზე ან მყიდველების პროდუქტების დიზაინზე.
არავითარი ლიცენზია, გამოხატული თუ ნაგულისხმევი, რაიმე ინტელექტუალური საკუთრების უფლებაზე არ არის გაცემული ST-ის მიერ აქ.
ST პროდუქტების ხელახალი გაყიდვა წინამდებარე ინფორმაციისგან განსხვავებული დებულებებით გააუქმებს ST-ის მიერ ასეთ პროდუქტზე გაცემულ ნებისმიერ გარანტიას.
ST და ST ლოგო ST-ის სავაჭრო ნიშნებია. დამატებითი ინფორმაციისთვის ST სავაჭრო ნიშნების შესახებ იხილეთ www.st.com/trademarks. ყველა სხვა პროდუქტის ან სერვისის სახელი მათი შესაბამისი მფლობელების საკუთრებაა.
ამ დოკუმენტის ინფორმაცია ანაცვლებს და ცვლის ადრე მოწოდებულ ინფორმაციას ამ დოკუმენტის ნებისმიერ წინა ვერსიაში.
© 2024 STMicroelectronics – ყველა უფლება დაცულია
დოკუმენტები / რესურსები
![]() |
ST X-CUBE-MEMS1 MotionFD რეალურ დროში დაცემის გამოვლენის ბიბლიოთეკა [pdf] მომხმარებლის სახელმძღვანელო X-CUBE-MEMS1 MotionFD რეალურ დროში დაცემის აღმოჩენის ბიბლიოთეკა, X-CUBE-MEMS1, MotionFD რეალურ დროში დაცემის აღმოჩენის ბიბლიოთეკა, რეალურ დროში დაცემის აღმოჩენის ბიბლიოთეკა, დაცემის აღმოჩენის ბიბლიოთეკა, აღმოჩენის ბიბლიოთეკა, ბიბლიოთეკა |