Dnes máme dobré zprávy. M5Stack Cardputer nyní může používat CircuitPython. A máme test pro M5Stack Cardputer. CircuitPython běží bez problémů.
Pojďme zjistit, jak nainstalovat CircuitPython na M5Stack Cardputer a jak používat programování v Pythonu.
Krok za krokem průvodce instalací
Krok 1: Stáhněte si firmware CircuitPython
Navštivte oficiální stránku pro stažení CircuitPythonu:
Přejděte na CircuitPython pro M5Stack Cardputer.
Tato stránka uvádí firmware speciálně vytvořený pro M5Stack Cardputer.
Vyberte nejnovější stabilní verzi:
K 25. únoru 2025 je pravděpodobně nejnovější stabilní verzí CircuitPython 9.2.4 (nebo novější vydání 9.x, pokud je k dispozici).
Hledejte soubor s názvem něco jako adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin.
Přímý odkaz ke stažení (na základě aktuální stabilní verze):
Uložte soubor:
Stáhněte soubor .bin do snadno přístupného umístění na vašem počítači (např. na plochu nebo do složky Stažené soubory).
Krok 2: Vstupte do režimu Bootloader na M5Stack Cardputeru
Vypněte zařízení:
Pokud je Cardputer zapnutý, odpojte jej od USB kabelu nebo jej vypněte.
Připojit k počítači:
Zasuňte jeden konec kabelu USB-C do počítače a druhý konec zatím nechte nezapojený.
Zadejte režim bootloaderu:
Najděte tlačítko BOOT na M5Stack Cardputeru (obvykle na boku nebo dole, v závislosti na uspořádání; pokud si nejste jisti, zkontrolujte dokumentaci M5Stack Cardputeru).
Stiskněte a podržte tlačítko BOOT.
Při držení tlačítka BOOT připojte kabel USB-C ke Cardputeru.
Pokračujte v držení tlačítka BOOT asi 1-2 sekundy po připojení, poté jej uvolněte.
Zařízení by nyní mělo být v režimu bootloaderu.
Ověřit režim bootloaderu:
Na vašem počítači by se měl objevit nový USB disk pojmenovaný RPI-RP2 (nebo podobně, což označuje bootloader ESP32-S3).
Pokud se žádný disk nezobrazí, proces opakujte a ujistěte se, že během připojování držíte tlačítko BOOT dostatečně dlouho.
Krok 3: Nainstalujte firmware
Zkopírujte soubor .bin:
Otevřete jednotku RPI-RP2 ve svém průzkumníku souborů (např. Průzkumník souborů ve Windows, Finder na macOS).
Přetáhněte stažený soubor .bin (např. adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) na disk RPI-RP2.
Alternativně zkopírujte a vložte soubor na disk.
Čekejte na instalaci:
Disk se automaticky zavře a Cardputer se restartuje, jakmile je firmware zkopírován (trvá to několik sekund).
Během tohoto procesu nepřipojujte USB kabel.
Potvrďte instalaci:
Po restartu by se měl USB disk znovu objevit, nyní pojmenovaný CIRCUITPY.
Otevřete jednotku CIRCUITPY a ověřte, že obsahuje soubory jako boot.py nebo README.txt. To naznačuje, že CircuitPython je úspěšně nainstalován.
Krok 4: Otestujte instalaci
Připojte se k sériovému terminálu (volitelné, ale doporučené):
Použijte nástroj jako Mu Editor (nejjednodušší pro začátečníky), PuTTY (Windows) nebo screen (macOS/Linux) pro připojení k sériovému portu Cardputeru.
Najděte COM port:
Windows: Zkontrolujte Správce zařízení pro nový COM port (např. COM3).
macOS/Linux: Spusťte ls /dev/tty* a hledejte /dev/ttyUSB0 nebo /dev/ttyACM0.
V editoru Mu:
Otevřete Mu, vyberte režim „Serial“ a připojte se k detekovanému portu.
Měli byste vidět výzvu Python REPL (>>>).
Spusťte jednoduchý test
Krok 5: Připravte se k použití
Zkontrolujte složku lib:
Otevřete CIRCUITPY a hledejte složku lib. Pokud je prázdná nebo neexistuje, vytvořte ji ručně (CIRCUITPY/lib/).
Zde později přidáte externí knihovny (např. adafruit-circuitpython-requests.mpy).
Uložte si kód:
Vytvořte soubor s názvem code.py v kořenovém adresáři CIRCUITPY, aby se váš program spustil automaticky při startu.
Odstraňování problémů
Žádný disk RPI-RP2 se nezobrazuje:
Ujistěte se, že USB kabel podporuje přenos dat (pokud možno otestujte s jiným).
Dvakrát zkontrolujte časování tlačítka BOOT – držte ho, dokud není USB připojeno.
Vyzkoušejte jiný USB port na vašem počítači.
Disk se zobrazí, ale nepřijímá .bin:
Ověřte, že soubor .bin odpovídá M5Stack Cardputer (nikoli jiné desce).
Znovu stáhněte soubor, abyste se ujistili, že není poškozený.
Žádný CIRCUITPY po instalaci:
Odpojte a znovu připojte USB kabel.
Pokud stále selhává, opakujte proces s novým stažením souboru .bin.
Sériové připojení selhalo:
Ujistěte se, že je vybrán správný COM port.
Nainstalujte ovladače USB, pokud je to potřeba (ESP32-S3 obvykle používá vestavěné ovladače, ale zkontrolujte M5Stack Docs pro podrobnosti).
Další kroky
Jakmile je CircuitPython nainstalován, můžete přidat knihovny do složky lib a nahrát svůj kód (např. skript DeepSeek API). Pokud s tímto krokem potřebujete pomoc nebo narazíte na chyby, dejte mi vědět a já vás dále navedu!
