Meillä on tänään hyviä uutisia. M5Stack Cardputer voi nyt käyttää CircuitPythonia. Ja meillä on testi M5Stack Cardputerille. CircuitPython toimii hyvin.
Selvitämme, miten CircuitPython asennetaan M5Stack Cardputerille ja miten Python-ohjelmointia käytetään.
Asennusopas vaihe vaiheelta
Vaihe 1: Lataa CircuitPython-laiteohjelmisto
Vieraile virallisella CircuitPythonin lataussivulla:
Siirry osoitteeseen CircuitPython for M5Stack Cardputer.
Tällä sivulla on lueteltu nimenomaan M5Stack Cardputerille rakennettu laiteohjelmisto.
Valitse uusin vakaa versio:
25. helmikuuta 2025 alkaen uusin vakaa versio on todennäköisesti CircuitPython 9.2.4 (tai uudempi 9.x-versio, jos saatavilla).
Etsi tiedosto, jonka nimi on jotain kuten adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin.
Suora latauslinkki (perustuu nykyiseen vakaaseen versioon):
Tallenna tiedosto:
Lataa .bin-tiedosto helposti löydettävään paikkaan tietokoneellasi (esim. Työpöytä tai Lataukset-kansio).
Vaihe 2: Siirry Bootloader-tilaan M5Stack Cardputerilla
Sammuta laite:
Jos Cardputer on päällä, irrota se USB-kaapelista tai sammuta se.
Yhdistä tietokoneeseen:
Kytke USB-C-kaapelin toinen pää tietokoneeseesi ja jätä toinen pää toistaiseksi irti.
Siirry Bootloader-tilaan:
Etsi BOOT-painike M5Stack Cardputerista (yleensä sivulla tai pohjassa, riippuen asettelusta; tarkista M5Stack Cardputer Docs, jos et ole varma).
Paina ja pidä BOOT-painiketta.
Pidä BOOT-painiketta painettuna ja liitä USB-C-kaapeli Cardputeriin.
Jatka BOOT-painikkeen painamista noin 1–2 sekuntia liittämisen jälkeen, sitten vapauta se.
Laitteen pitäisi nyt olla bootloader-tilassa.
Vahvista bootloader-tila:
Tietokoneellasi pitäisi ilmestyä uusi USB-asema nimeltä RPI-RP2 (tai vastaava, joka osoittaa ESP32-S3 bootloaderin).
Jos asemaa ei näy, toista prosessi varmistaen, että pidät BOOT-painiketta tarpeeksi kauan yhdistämisen aikana.
Vaihe 3: Asenna laiteohjelmisto
Kopioi .bin-tiedosto:
Avaa RPI-RP2-asema tiedostonhallinnassasi (esim. File Explorer Windowsissa, Finder macOS:ssä).
Vedä ja pudota ladattu .bin-tiedosto (esim. adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) RPI-RP2-asemalle.
Vaihtoehtoisesti kopioi ja liitä tiedosto asemalle.
Odota asennusta:
Asema sulkeutuu automaattisesti ja Cardputer käynnistyy uudelleen, kun laiteohjelmisto on kopioitu (tämä kestää muutaman sekunnin).
Älä irrota USB-kaapelia tämän prosessin aikana.
Vahvista asennus:
Käynnistyksen jälkeen USB-aseman pitäisi ilmestyä uudelleen nimellä CIRCUITPY.
Avaa CIRCUITPY-asema varmistaaksesi, että se sisältää tiedostoja kuten boot.py tai README.txt. Tämä tarkoittaa, että CircuitPython on asennettu onnistuneesti.
Vaihe 4: Testaa asennus
Yhdistä sarjaterminaaliin (valinnainen mutta suositeltava):
Käytä työkalua kuten Mu Editor (helpoin aloittelijoille), PuTTY (Windows) tai screen (macOS/Linux) yhdistääksesi Cardputerin sarjaporttiin.
Etsi COM-portti:
Windows: Tarkista Laitehallinnasta uusi COM-portti (esim. COM3).
macOS/Linux: Suorita ls /dev/tty* ja etsi /dev/ttyUSB0 tai /dev/ttyACM0.
Mu Editorissa:
Avaa Mu, valitse “Serial” -tila ja yhdistä havaittuun porttiin.
Sinun pitäisi nähdä Pythonin REPL-kehotte (>>>).
Suorita yksinkertainen testi
Vaihe 5: Valmistautuminen käyttöön
Tarkista lib-kansio:
Avaa CIRCUITPY ja etsi lib-kansio. Jos se on tyhjä tai sitä ei ole, luo se manuaalisesti (CIRCUITPY/lib/).
Tähän lisäät myöhemmin ulkoisia kirjastoja (esim. adafruit-circuitpython-requests.mpy).
Tallenna koodisi:
Luo tiedosto nimeltä code.py CIRCUITPY:n juurihakemistoon, jotta ohjelmasi käynnistyy automaattisesti käynnistyksen yhteydessä.
Vianmääritys
Ei RPI-RP2-levyä näy:
Varmista, että USB-kaapeli tukee datansiirtoa (testaa toista kaapelia, jos mahdollista).
Tarkista BOOT-painikkeen ajoitus – pidä sitä painettuna USB-yhteyden muodostumisen jälkeen.
Kokeile toista USB-porttia tietokoneessasi.
Levy näkyy, mutta ei hyväksy .bin-tiedostoa:
Varmista, että .bin-tiedosto vastaa M5Stack Cardputeria (ei jotain muuta levyä).
Lataa tiedosto uudelleen varmistaaksesi, ettei se ole vioittunut.
Ei CIRCUITPY:tä asennuksen jälkeen:
Irrota ja kytke USB-kaapeli uudelleen.
Jos epäonnistuu edelleen, toista prosessi lataamalla .bin-tiedosto uudelleen.
Sarjayhteys epäonnistuu:
Varmista, että oikea COM-portti on valittu.
Asenna USB-ajurit tarvittaessa (ESP32-S3 käyttää yleensä sisäänrakennettuja ajureita, mutta tarkista M5Stack Docs yksityiskohdat).
Seuraavat vaiheet
Kun CircuitPython on asennettu, voit lisätä kirjastoja lib-kansioon ja ladata koodisi (esim. DeepSeek API -skripti). Jos tarvitset apua tässä vaiheessa tai kohtaat virheitä, kerro minulle, niin opastan sinua eteenpäin!
