STMicroelectronics UM3230 X-LINUX-SPN1 softver

Informacije o proizvodu

Specifikacije

• Softverski paket: X-LINUX-SPN1
• Platforma: STM32MP mikroprocesor
• Komponente: Python API-ji, GTK-bazirana UI aplikacija
• Metoda kontrole: GPIO-ovi koji koriste libgpiod
• Podržano ploče:
  • X-NUCLEO-IHM15A1 ploča bazirana na STSPIN840 drajveru
  • X-NUCLEO-IHM12A1 ploča bazirana na STSPIN240 drajveru

Upute za upotrebu proizvoda

1. Početak rada sa softverom X-LINUX-SPN1
   X-LINUX-SPN1 je softverski paket dizajniran za demonstraciju uređaja porodice STSPIN na platformi STM32MP.
2.  Karakteristike softvera X-LINUX-SPN1
   Softver pruža drajvere i aplikacije korisničkog prostora za kontrolu više kanala kontrolera motora.
3.  Arhitektura X-LINUX-SPN1
   Softver koristi libgpiod za kontrolu drajvera motora preko GPIO-a. Uključuje Python API-je i GTK-baziranu UI aplikaciju za jednostavno povezivanje.
4. X-LINUX-SPN1 struktura paketa
   Paket sadrži različite komponente uključujući Python API-je, izvorni kod GTK aplikacije i UI resurse poput slika i ikona.
5. 5. Postavljanje hardvera
   Softver podržava X-NUCLEO-IHM15A1 i X-NUCLEO-IHM12A1 ploče zasnovane na STSPIN840 i STSPIN240 drajverima.

Često postavljana pitanja (FAQ)

1. P: Mogu li razviti prilagođene aplikacije koristeći X-LINUX-SPN1 paket?
   O: Da, programeri mogu kreirati vlastite aplikacije koristeći priložene Python API-je u paketu.
2. P: Koje su glavne karakteristike STSPIN840 i STSPIN240 drajvera motora?
   O: STSPIN840 je pogodan za kompaktne aplikacije u pogonu motora sa mogućnostima paralelnog rada, dok STSPIN240 može istovremeno kontrolisati dva brušena DC motora sa različitim zaštitama za industrijsku upotrebu.

Uputstvo za upotrebu
Početak rada sa softverom X-LINUX-SPN1

Uvod

X-LINUX-SPN1 je softverski paket zasnovan na OpenSTLinuxu za demonstriranje uređaja porodice STSPIN na mikroprocesorskoj platformi STM32MP. Pruža Linux softver (drajvere, API-je i aplikacije) za ciljanje ploča za proširenje zasnovanih na drajverima motora STSPIN porodice. Softver se može koristiti kao polazna tačka za razvoj složenijih aplikacija za upravljanje motorom. Uključena aplikacija i drajveri rade na Cortex-A jezgri MPU-a.

Slika 1. X-LINUX-SPN1 paket

Opis

Funkcije softvera X-LINUX-SPN1
Softver za proširenje X-LINUX-SPN1 pruža drajvere i aplikacije korisničkog prostora koje rade na platformi STM32MP za kontrolu više kanala kontrolera motora.
Softverski paket X-LINUX-SPN1 sastoji se od sljedećih komponenti:

1. Python API-ji
2. GTK-bazirana UI aplikacija

Arhitektura X-LINUX-SPN1
Softver koristi libgpiod za kontrolu drajvera motora preko GPIO-a.

Obezbeđena GTK aplikacija je izgrađena na Python API-ju i pruža interfejs spreman za upotrebu. Međutim, programeri aplikacija mogu pisati svoje aplikacije koristeći Python API-je koji se isporučuju s ovim paketom.

Struktura paketa X-LINUX-SPN1

Sadržaj pakovanja je opisan u nastavku.

•  "aplikacija":
  • “x_linux_spn1”: Ovaj folder sadrži izvore za API i UI aplikaciju
  • “slike”: Svi resursi za slike i ikone koje zahtijeva UI aplikacija su prisutni u ovoj mapi.
  • “ihm12_api.py” & “ihm15_api.py”: Ovo files implementirati API koji se koristi za kontrolu odgovarajućih pokretača motora.
  • “spn1_ui.py”: Sadrži izvorni kod UI aplikacije zasnovane na GTK.
  • “spn1_ui.glade”: Ovo file je generisan alatom “Glade” i sadrži konfiguraciju widgeta koji se koristi u UI aplikaciji.
  • “spn1_ui.css”: Sadrži vizuelne stilove koje koriste widgeti u UI aplikaciji.
• “080-x-linux-spn1.yaml”: Ovo file dodaje unos menija u zadanu demo aplikaciju koja dolazi sa STM32MP1 pločama za evaluaciju/otkrivanje
• “deploy.sh”: Ovo je skripta za implementaciju koja se koristi za implementaciju files od glavnog računara do MPU ploče. Kopira files na ispravnu lokaciju u MPU filesistem, tako da demo pokretač prepoznaje i učitava novu aplikaciju pri pokretanju.

Podešavanje hardvera

Trenutni paket pruža softversku podršku za sljedeće ploče

• X-NUCLEO-IHM15A1 ploča bazirana na STSPIN840 drajveru. STSPIN840 je pristupačno i lako za korištenje rješenje za implementaciju kompaktnih aplikacija za motornu vožnju kao što su termalni štampači, robotika i igračke. Takođe podržava paralelni rad, gdje djeluje kao jednosmjerni drajver s jednom četkom sa dvostrukom sposobnošću struje. Strujni limiteri i kompletan set zaštitnih karakteristika čine ga pogodnim za pouzdane aplikacije.
• X-NUCLEO-IHM12A1 ploča bazirana na STSPIN240 drajveru. STSPIN240 može istovremeno kontrolirati dva brušena DC motora. Dolazi u vrlo malom 4×4 QFN paketu i snage s niskim otporomtage. Također može raditi u paralelnom načinu rada kao jedan full-bridge drajver sa većom strujnom sposobnošću. Ima dva PWM kontrolera struje koje korisnik može podesiti. Ima režim niske snage i nekoliko zaštita za napajanjetage. Pogodan je za zahtjevne industrijske primjene.

Naredne verzije paketa će dodati podršku za više drajvera motora.

Slika 6. X-NUCLEO-IHM12A1

Ploča se uključuje u Arduino konektore dostupne na poleđini STM32MP157F-DK2 ploča za otkrivanje, kao što je prikazano ispod.
Slika 7. X-NUCLEO-IHM15A1 montiran na STM32MP157F-DK2

Podešavanje softvera

Odjeljak opisuje podešavanje softvera koje je potrebno za izgradnju, flešovanje, implementaciju i pokretanje aplikacije.

1. Preporučeni preduslovi za PC
   Mora se koristiti Linux® PC koji radi pod Ubuntu® 20.04 ili 22.04. Programer može pratiti link ispod. https://wiki.st.com/stm32mpu/wiki/PC_prerequisites
   Pratite uputstva na ST wiki stranici Slika treperi da pripremite SD karticu za pokretanje sa početnim paketom. Alternativno, može se koristiti i Windows/Mac računar, u kom slučaju će biti korisni sljedeći alati:
   • STM32CubeProgrammer za flešovanje OpenSTLinux započete slike paketa na SD karticu
   • TeraTerm ili PuTTY za pristup interfejsu konzole preko USB-a
   • winscp da kopirate aplikaciju na MPU ploču
     Sljedeće konvencije se koriste kada se pozivamo na upute za kod.
   • #Komentari: Komentar koji opisuje korake
   • PC>$ : Komandna linija za razvoj ili host PC/mašina. Tekst iza $ je naredba Board>$ : STM32MP1 komandna linija. Tekst iza $ je naredba
2. STMPU Softverski preduslovi
   Python paket “gpiod” je preduslov za X-LINUX-SPN1 softver i mora se instalirati na STM32MP1 ploču.
   • #Instaliraj Python pip ako već nije instaliran Board>$ apt-get install python3-pip
     #Instaliraj gpiod
     Ploča>$ python3 -m pip install gpiod
3. Raspoređivanje files na MPU ploču
   Potrebno je prenijeti izgrađene binarne datoteke, Python skripte i aplikativne resurse na STM32MP ploču sa razvojnog PC-a.
   Sredstva se mogu prenijeti na bilo koji od sljedećih načina:
   • Korištenje mrežne veze
   • Pogledajte Kako prenijeti a File Preko mreže da biste povezali MPU ploču na mrežu, možete je povezati na žičanu mrežu preko Ethernet priključka na MPU ploči
   • Alternativno, da biste se povezali na WLAN, pogledajte Kako postaviti WLAN vezu
   • Korištenje serijskog protokola (kao zmodem od Teraterm ili kermit)
   • Za Linux hostove pogledajte Kako prenijeti a file preko serijske konzole
   • Za Windows hostove, pogledajte Kako prenijeti files na Discovery kit koristeći Tera Term
     Da bi brzo procijenili paket X-LINUX-SPN1, programeri mogu kopirati sadržaj foldera “application” koji se nalazi u paketu u /usr/local/demo/application folder na STM32MP ploči koristeći bilo koju od gore navedenih metoda. Da bi se olakšao ovaj zadatak, može se koristiti skripta za implementaciju u folderu "aplikacija" paketa X-LINUX-SPN1 (samo ako se koristi mrežna veza).
     Nakon filesu kopirani na MPU ploču, ponovo pokrenite ploču. Nakon ponovnog pokretanja, demo meni će imati opciju dodanu za X-LINUX-SPN1

Slika 8. Ikona menija X-LINUX-SPN1

Korištenje GTK aplikacije
Prilikom otvaranja aplikacije, korisniku se pruža mogućnost odabira upravljačke ploče motora koja će se koristiti. Interfejs je prikazan ispod.
Slika 9. Izbor ploče

Korištenje GTK aplikacije

Interfejs aplikacije sadrži dugme za pokretanje/zaustavljanje i četiri dugmeta za smer. Aplikacija je dizajnirana za dva kanala koji kontroliraju motore s lijeve i desne strane:

• Kada pritisnete dugme za uključivanje/isključivanje, oba motora počinju da se kreću u pravcu napred
• Pritiskom na dugme za povratak oba motora počinju da se kreću u obrnutom smeru
•  Kada pritisnete lijevo i desno dugme, oba motora se kreću u suprotnim smjerovima kako bi skrenuli lijevo ili desno prema radnji korisnika.

Interfejs je prikazan ispod.

Slika 10. Sučelje aplikacije

Istorija revizija

Tabela 1. Istorija revizije dokumenta

Datum	Verzija	Promjene
04-2023	1	Prvo izdanje.

VAŽNA NAPOMENA – PAŽLJIVO PROČITAJTE

• STMicroelectronics NV i njegove podružnice (“ST”) zadržavaju pravo na izmjene, ispravke, poboljšanja, modifikacije i poboljšanja ST proizvoda i/ili ovog dokumenta u bilo koje vrijeme bez prethodne najave. Kupci bi trebali dobiti najnovije relevantne informacije o ST proizvodima prije nego što daju narudžbu. ST proizvodi se prodaju u skladu sa ST-ovim odredbama i uslovima prodaje koji su na snazi ​​u trenutku potvrde narudžbe.
• Kupci su isključivo odgovorni za izbor, odabir i korištenje ST proizvoda, a ST ne preuzima nikakvu odgovornost za pomoć u primjeni ili dizajn proizvoda kupaca.
• ST ovdje ne daje nikakvu licencu, izričitu ili impliciranu, za bilo koje pravo intelektualne svojine.
• Preprodaja ST proizvoda sa odredbama koje se razlikuju od informacija navedenih ovde poništava svaku garanciju koju ST daje za takav proizvod.
• ST i ST logo su zaštitni znakovi ST. Za dodatne informacije o ST zaštitnim znakovima, pogledajte www.st.com/trademarks. Svi ostali nazivi proizvoda ili usluga vlasništvo su njihovih vlasnika.
• Informacije u ovom dokumentu zamjenjuju i zamjenjuju informacije koje su prethodno date u prethodnim verzijama ovog dokumenta.
• © 2023 STMicroelectronics – Sva prava zadržana

UM3230 – Rev 1

Dokumenti / Resursi

STMicroelectronics UM3230 X-LINUX-SPN1 softver [pdf] Korisnički priručnik UM3230 X-LINUX-SPN1 softver, UM3230, X-LINUX-SPN1 softver, SPN1 softver, softver

Reference

• Uputstvo za upotrebu