STMicroelectronics UM3230 X-LINUX-SPN1 hugbúnaðarhandbók

Hugbúnaðarpakki: X-LINUX-SPN1
Pallur: STM32MP örgjörvi
Íhlutir: Python API, GTK byggt notendaviðmót forrit
Stjórnunaraðferð: GPIOs sem nota libgpiod
Stuðningur Spjöld:
- X-NUCLEO-IHM15A1 borð byggt á STSPIN840 reklum
- X-NUCLEO-IHM12A1 borð byggt á STSPIN240 reklum

Notkunarleiðbeiningar fyrir vöru

Að byrja með X-LINUX-SPN1 hugbúnaðinum
X-LINUX-SPN1 er hugbúnaðarpakki hannaður til að sýna STSPIN fjölskyldutæki á STM32MP pallinum.
X-LINUX-SPN1 hugbúnaðareiginleikar
Hugbúnaðurinn veitir ökumenn og notendarýmisforrit til að stjórna mörgum rásum mótorstýringar.

X-LINUX-SPN1 arkitektúr
Hugbúnaðurinn notar libgpiod til að stjórna mótorrekendum í gegnum GPIO. Það inniheldur Python API og GTK byggt notendaforrit til að auðvelda samskipti.
X-LINUX-SPN1 pakkauppbygging
Pakkinn inniheldur ýmsa hluti, þar á meðal Python API, GTK forritakóða og notendaviðmót eins og myndir og tákn.

5. Uppsetning vélbúnaðar
Hugbúnaðurinn styður X-NUCLEO-IHM15A1 og X-NUCLEO-IHM12A1 töflur byggðar á STSPIN840 og STSPIN240 rekla í sömu röð.

Algengar spurningar (algengar spurningar)

Sp.: Get ég þróað sérsniðin forrit með X-LINUX-SPN1 pakkanum?
A: Já, forritarar geta búið til sín eigin forrit með því að nota Python API sem fylgja með í pakkanum.

Sp.: Hverjir eru helstu eiginleikar STSPIN840 og STSPIN240 mótorstjóranna?
A: STSPIN840 er hentugur fyrir samninga mótor akstur forrit með samhliða aðgerð getu, en STSPIN240 getur stjórnað tveimur bursti DC mótorum samtímis með ýmsum vörnum fyrir iðnaðar notkun.

Notendahandbók
Að byrja með X-LINUX-SPN1 hugbúnaði

Inngangur

X-LINUX-SPN1 er OpenSTLinux hugbúnaðarpakki til að sýna STSPIN fjölskyldutæki á STM32MP örgjörva pallinum. Það býður upp á Linux hugbúnað (rekla, API og forrit) til að miða á stækkunartöflurnar byggðar á STSPIN fjölskyldu mótorrekla. Hugbúnaðinn er hægt að nota sem upphafspunkt til að þróa flóknari hreyfistýringarforrit. Meðfylgjandi forrit og ökumenn keyra á Cortex-A kjarna/kjarna MPU.

Mynd 1. X-LINUX-SPN1 pakki

Lýsing

X-LINUX-SPN1 hugbúnaðareiginleikar
X-LINUX-SPN1 stækkunarhugbúnaðurinn veitir ökumönnum og notendarýmisforritum sem keyra á STM32MP pallinum til að stjórna mörgum rásum mótorstýringar.
X-LINUX-SPN1 hugbúnaðarpakkinn samanstendur af eftirfarandi hlutum:

Python API
GTK byggt UI forrit

X-LINUX-SPN1 arkitektúr
Hugbúnaðurinn notar libgpiod til að stjórna mótorrekendum í gegnum GPIO.

GTK forritið sem fylgir með er byggt ofan á Python API og veitir tilbúið viðmót. Forritahönnuðir geta hins vegar skrifað sín eigin forrit með því að nota Python API sem fylgir þessum pakka.

X-LINUX-SPN1 pakkauppbygging

Innihaldi pakkans er lýst hér að neðan.

"umsókn":
- „x_linux_spn1“: Þessi mappa inniheldur heimildir fyrir API og UI forritið
- „myndir“: Öll mynd- og táknmyndaforrit sem UI appið krefst eru til staðar í þessari möppu.
- „ihm12_api.py“ og „ihm15_api.py“: Þessar files innleiða API sem notað er til að stjórna viðkomandi mótorökumönnum.
- „spn1_ui.py“: Inniheldur GTK-undirstaða UI forrits frumkóða.
- “spn1_ui.glade”: Þetta file er búið til af „Glade“ tólinu og inniheldur búnaðarstillingar sem notaðar eru í UI App.
- „spn1_ui.css“: Inniheldur sjónræna stíl sem notuð eru af búnaðinum í UI appinu.
"080-x-linux-spn1.yaml": Þetta file bætir valmyndarfærslu við sjálfgefna kynningarforritið sem fylgir STM32MP1 mats-/uppgötvunartöflunum

„deploy.sh“: Þetta er dreifingarforritið sem notað er til að dreifa files frá hýsingartölvunni til MPU borðsins. Það afritar files á réttan stað í MPU filekerfi, þannig að kynningarforritið þekkir og hleður nýja forritinu við ræsingu.

Uppsetning vélbúnaðar

Núverandi pakki veitir hugbúnaðarstuðning fyrir eftirfarandi borð

X-NUCLEO-IHM15A1 borð byggt á STSPIN840 reklum. STSPIN840 er hagkvæm og auðveld í notkun lausn fyrir innleiðingu á fyrirferðarlítilli mótorakstri eins og hitaprentara, vélfærafræði og leikföng. Það styður einnig samhliða notkun, þar sem það virkar eins og einn bursta DC drif með tvöfalda núverandi getu. Núverandi takmarkararnir og heill sett af verndareiginleikum gera það hentugt fyrir áreiðanlega notkun.
X-NUCLEO-IHM12A1 borð byggt á STSPIN240 reklum. STSPIN240 getur stjórnað tveimur burstuðum DC mótorum á sama tíma. Það kemur í mjög litlum 4×4 QFN pakka og afli með lágt viðnámtage. Það getur líka virkað í samhliða stillingu sem einn fullur brúardrifi með meiri straumgetu. Það hefur tvo PWM straumstýringar sem notandinn getur stillt. Það er með lítilli aflstillingu og nokkrar varnir fyrir afl stage. Það er hentugur fyrir krefjandi iðnaðarnotkun.

Síðari útgáfur af pakkanum munu bæta við stuðningi við fleiri mótorökumenn.

Mynd 6. X-NUCLEO-IHM12A1

Stjórnin tengist Arduino tengjunum sem eru fáanleg aftan á STM32MP157F-DK2 uppgötvunarspjöldum, eins og sýnt er hér að neðan.
Mynd 7. X-NUCLEO-IHM15A1 festur á STM32MP157F-DK2

Hugbúnaðaruppsetning

Hlutinn lýsir hugbúnaðaruppsetningunni sem þarf til að smíða, blikka, dreifa og keyra forritið.

Mælt er með PC forkröfum
Nota verður Linux® tölvu sem keyrir undir Ubuntu® 20.04 eða 22.04. Framkvæmdaraðilinn getur fylgst með hlekknum hér að neðan. https://wiki.st.com/stm32mpu/wiki/PC_prerequisites
Fylgdu leiðbeiningunum á ST wiki síðunni. Mynd blikkar til að útbúa ræsanlegt SD kort með byrjunarpakkanum. Að öðrum kosti er einnig hægt að nota Windows/Mac tölvu, í því tilviki munu eftirfarandi verkfæri nýtast:
- STM32CubeProgrammer til að flassa OpenSTLinux upphafspakkamyndinni á SD-kortið
- TeraTerm eða PuTTY til að fá aðgang að stjórnborðsviðmótinu í gegnum USB
- winscp til að afrita forritið á MPU borðið
  Eftirfarandi venjur eru notaðar þegar vísað er í kóðaleiðbeiningarnar.
- #Athugasemdir: Athugasemd sem lýsir skrefum
- PC>$ : Þróunar- eða Host PC/vél skipanafyrirmæli. Texti á eftir $ er skipanaborð>$ : STM32MP1 skipanalína. Texti á eftir $ er skipun

Forsendur STMPU hugbúnaðar
Python pakkinn „gpiod“ er forsenda fyrir X-LINUX-SPN1 hugbúnaðinum og verður að setja hann upp á STM32MP1 borðið.
- #Install Python pip ef það er ekki þegar uppsett Board>$ apt-get install python3-pip
  #Settu upp gpiod
  Board>$ python3 -m pip setja upp gpiod
Að dreifa files til MPU borð
Nauðsynlegt er að flytja innbyggðu tvöfaldana, Python forskriftirnar og forritaauðlindina yfir á STM32MP borðið úr þróunartölvunni.
Hægt er að flytja auðlindirnar með einhverjum af eftirfarandi aðferðum:
- Notkun nettengingar
- Sjá Hvernig á að flytja a File Yfir netkerfi til að tengja MPU borðið við net, geturðu tengt það við hlerunarnet í gegnum Ethernet tengið á MPU borðinu
- Að öðrum kosti, til að tengjast þráðlausu staðarneti, sjáðu Hvernig á að setja upp þráðlaust staðarnetstengingu
- Notaðu raðsamskiptareglur (eins og zmodem frá Teraterm eða kermit)
- Fyrir Linux vélar, sjáðu Hvernig á að flytja a file yfir raðtölvu
- Fyrir Windows vélar, sjáðu Hvernig á að flytja files til Discovery Kit með Tera Term
  Til að meta X-LINUX-SPN1 pakkann fljótt geta forritarar afritað innihald „application“ möppunnar sem er í pakkanum í /usr/local/demo/application möppu á STM32MP borðinu með því að nota einhverja af ofangreindum aðferðum. Til að auðvelda þetta verkefni má nota dreifingarforskriftina í „application“ möppunni í X-LINUX-SPN1 pakkanum (aðeins ef nettenging er notuð).
  Eftir að files hefur verið afritað á MPU borðið, endurræstu borðið. Eftir endurræsingu mun kynningarvalmyndin hafa möguleika bætt við fyrir X-LINUX-SPN1

Mynd 8. X-LINUX-SPN1 valmyndartákn

Með því að nota GTK forritið
Þegar forritið er opnað er notandanum sýndur kostur á að velja mótor drifborðið sem á að nota. Viðmótið er sýnt hér að neðan.
Mynd 9. Stjórnarval

Notaðu GTK forritið

Forritsviðmótið inniheldur byrjun/stöðvunarhnapp og fjóra stefnuhnappa. Forritið er hannað fyrir tvær rásir sem stjórna vinstri og hægri hlið mótorum:

Þegar ýtt er á Kveikja/Slökkva hnappinn byrja báðir mótorar að hreyfast í áttina áfram
Þegar smellt er á afturhnappinn byrja báðir mótorarnir að hreyfast í öfuga átt
Þegar ýtt er á vinstri og hægri hnappana, hreyfast báðir mótorar í gagnstæðar áttir til að beygja til vinstri eða hægri samkvæmt aðgerðum notandans.

Viðmótið er sýnt hér að neðan.

Mynd 10. Umsóknarviðmót

Endurskoðunarsaga

Tafla 1. Endurskoðunarferill skjala

Dagsetning	Útgáfa	Breytingar
04-des-2023	1	Upphafleg útgáfa.

MIKILVÆG TILKYNNING - LESIÐU VARLEGA

STMicroelectronics NV og dótturfélög þess („ST“) áskilja sér rétt til að gera breytingar, leiðréttingar, endurbætur, breytingar og endurbætur á ST vörum og/eða þessu skjali hvenær sem er án fyrirvara. Kaupendur ættu að fá nýjustu viðeigandi upplýsingar um ST vörur áður en þeir leggja inn pantanir. ST vörur eru seldar í samræmi við söluskilmála ST sem eru í gildi þegar pöntun er staðfest.
Kaupendur bera einir ábyrgð á vali, vali og notkun ST vara og ST tekur enga ábyrgð á umsóknaraðstoð eða hönnun vöru kaupenda.
Ekkert leyfi, óbeint eða óbeint, til nokkurs hugverkaréttar er veitt af ST hér.
Endursala á ST vörum með öðrum ákvæðum en upplýsingarnar sem settar eru fram hér ógilda alla ábyrgð sem ST veitir fyrir slíka vöru.

ST og ST merkið eru vörumerki ST. Fyrir frekari upplýsingar um ST vörumerki, sjá www.st.com/trademarks. Öll önnur vöru- eða þjónustuheiti eru eign viðkomandi eigenda.
Upplýsingar í þessu skjali koma í stað og koma í stað upplýsinga sem áður hafa verið gefnar í fyrri útgáfum þessa skjals.

UM3230 – Rev 1

Skjöl / auðlindir

STMicroelectronics UM3230 X-LINUX-SPN1 Hugbúnaður [pdfNotendahandbók
UM3230 X-LINUX-SPN1 Hugbúnaður, UM3230, X-LINUX-SPN1 Hugbúnaður, SPN1 Hugbúnaður, Hugbúnaður

Heimildir

Notendahandbók

STMicroelectronics UM3230 X-LINUX-SPN1 Hugbúnaður

Upplýsingar um vöru