Dziś mamy dobre wieści. M5Stack Cardputer może teraz korzystać z CircuitPython. Mamy też test dla M5Stack Cardputer. CircuitPython działa bez problemów.
Dowiedzmy się, jak zainstalować CircuitPython na M5Stack Cardputer i jak korzystać z programowania w Pythonie.
Przewodnik instalacji krok po kroku
Krok 1: Pobierz oprogramowanie układowe CircuitPython
Odwiedź oficjalną stronę pobierania CircuitPython:
Przejdź do CircuitPython for M5Stack Cardputer.
Ta strona zawiera oprogramowanie układowe specjalnie stworzone dla M5Stack Cardputer.
Wybierz najnowszą stabilną wersję:
Na dzień 25 lutego 2025 roku najnowszą stabilną wersją jest prawdopodobnie CircuitPython 9.2.4 (lub nowsze wydanie 9.x, jeśli jest dostępne).
Szukaj pliku o nazwie podobnej do adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin.
Bezpośredni link do pobrania (na podstawie obecnej stabilnej wersji):
Zapisz plik:
Pobierz plik .bin do łatwo dostępnej lokalizacji na swoim komputerze (np. na Pulpit lub do folderu Pobrane).
Krok 2: Wejdź w tryb Bootloader na M5Stack Cardputer
Wyłącz urządzenie:
Jeśli Cardputer jest włączony, odłącz go od kabla USB lub wyłącz.
Połącz z komputerem:
Podłącz jeden koniec kabla USB-C do komputera, a drugi koniec na razie pozostaw niepodłączony.
Wejdź w tryb Bootloadera:
Znajdź przycisk BOOT na M5Stack Cardputer (zazwyczaj z boku lub na dole, w zależności od układu; jeśli nie jesteś pewien, sprawdź dokumentację M5Stack Cardputer).
Naciśnij i przytrzymaj przycisk BOOT.
Trzymając przycisk BOOT, podłącz kabel USB-C do Cardputera.
Przytrzymaj przycisk BOOT przez około 1-2 sekundy po podłączeniu, a następnie go zwolnij.
Urządzenie powinno być teraz w trybie bootloadera.
Zweryfikuj tryb bootloadera:
Na twoim komputerze powinien pojawić się nowy dysk USB o nazwie RPI-RP2 (lub podobnej, wskazującej na bootloader ESP32-S3).
Jeśli dysk nie pojawi się, powtórz proces, upewniając się, że przytrzymujesz przycisk BOOT wystarczająco długo podczas podłączania.
Krok 3: Zainstaluj oprogramowanie układowe
Skopiuj plik .bin:
Otwórz dysk RPI-RP2 w swoim eksploratorze plików (np. Eksplorator plików w Windows, Finder w macOS).
Przeciągnij i upuść pobrany plik .bin (np. adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) na dysk RPI-RP2.
Alternatywnie, skopiuj i wklej plik na dysk.
Czekaj na instalację:
Dysk zostanie automatycznie zamknięty, a Cardputer uruchomi się ponownie po skopiowaniu oprogramowania układowego (to zajmuje kilka sekund).
Nie odłączaj kabla USB podczas tego procesu.
Potwierdź instalację:
Po ponownym uruchomieniu dysk USB powinien ponownie się pojawić, teraz nazwany CIRCUITPY.
Otwórz dysk CIRCUITPY, aby potwierdzić, że zawiera pliki takie jak boot.py lub README.txt. To wskazuje, że CircuitPython jest pomyślnie zainstalowany.
Krok 4: Przetestuj instalację
Połącz się z terminalem szeregowym (opcjonalne, ale zalecane):
Użyj narzędzia takiego jak Mu Editor (najłatwiejszy dla początkujących), PuTTY (Windows) lub screen (macOS/Linux), aby połączyć się z portem szeregowym Cardputera.
Znajdź port COM:
Windows: Sprawdź Menedżera urządzeń pod kątem nowego portu COM (np. COM3).
macOS/Linux: Uruchom ls /dev/tty* i poszukaj /dev/ttyUSB0 lub /dev/ttyACM0.
W edytorze Mu:
Otwórz Mu, wybierz tryb „Serial” i połącz się z wykrytym portem.
Powinieneś zobaczyć monit REPL Pythona (>>>).
Uruchom prosty test
Krok 5: Przygotuj do użycia
Sprawdź folder lib:
Otwórz CIRCUITPY i poszukaj folderu lib. Jeśli jest pusty lub nie istnieje, utwórz go ręcznie (CIRCUITPY/lib/).
To tutaj później dodasz zewnętrzne biblioteki (np. adafruit-circuitpython-requests.mpy).
Zapisz swój kod:
Utwórz plik o nazwie code.py w katalogu głównym CIRCUITPY, aby automatycznie uruchamiać program podczas startu.
Rozwiązywanie problemów
Brak dysku RPI-RP2:
Upewnij się, że kabel USB obsługuje przesyłanie danych (jeśli to możliwe, przetestuj innym kablem).
Podwójnie sprawdź czas naciskania przycisku BOOT — przytrzymaj go aż do momentu podłączenia USB.
Spróbuj innego portu USB w swoim komputerze.
Dysk pojawia się, ale nie akceptuje pliku .bin:
Zweryfikuj, czy plik .bin odpowiada M5Stack Cardputer (a nie innej płytce).
Ponownie pobierz plik, aby upewnić się, że nie jest uszkodzony.
Brak CIRCUITPY po instalacji:
Odłącz i ponownie podłącz kabel USB.
Jeśli nadal występuje błąd, powtórz proces z nowym pobraniem pliku .bin.
Połączenie szeregowe nie powiodło się:
Upewnij się, że wybrano właściwy port COM.
Zainstaluj sterowniki USB, jeśli to konieczne (ESP32-S3 zazwyczaj korzysta z wbudowanych sterowników, ale sprawdź M5Stack Docs dla szczegółów).
Następne kroki
Po zainstalowaniu CircuitPython możesz dodać biblioteki do folderu lib i przesłać swój kod (np. skrypt API DeepSeek). Jeśli potrzebujesz pomocy z tym etapem lub napotkasz błędy, daj mi znać, a poprowadzę Cię dalej!
