CCYD StudioBelgeler

CYD Studio › Belgeler › Başlangıç

Başlangıç

Kartı bir kez hazırlarsın: imajı yazar, çekirdeği yüklersin. Sonrası tarayıcıda. Bu sayfa üç kart için de PC tarafındaki adımları anlatır.

Gerekenler

  • Python 3.12 ve araçlar: pip install mpremote esptool mpy-cross pyserial
  • Depo: git clone https://github.com/tarikgkhsn/CYD-Studio
  • Seri port: Windows'ta COM3 gibi, Linux'ta /dev/ttyUSB0 gibi. Listelemek için: python -c "import serial.tools.list_ports as l; [print(p.device) for p in l.comports()]"

1. WiFi ayarı

boards/*/config.json şifre içerdiği için depoda yoktur. Örneği kopyala ve doldur:

cp boards/cyd/config.example.json boards/cyd/config.json

Alanlar: ssid, password, statik IP (ip, netmask, gateway, dns), yedek erişim noktası (ap_ssid, ap_password), hostname, rotation, cpu_freq. Kart ağa bağlanamazsa ap_ssid adıyla kendi ağını açar ve 192.168.4.1 adresinden ulaşılır.

2. Flash

Hazır imajlar firmware/ altında:

DosyaKart
micropython-esp32-cydstudio.binCYD, özel imaj (dondurulmuş çekirdek, sabit heap)
micropython-esp8266-frozen.binNodeMCU, özel imaj
micropython-esp32.bin · micropython-esp8266.binStok yedekler

CYD: kartın otomatik reset devresi IO0'ı süremez. BOOT'u basılı tut, RESET'e bas-bırak, BOOT'u yazma bitene kadar bırakma. flash.py esptool'u --before no-reset --after no-reset --baud 115200 ile çalıştırır; --koru dosya sistemini (projeler, config, log) silmez.

python tools/flash.py COM3 firmware/micropython-esp32-cydstudio.bin --koru

Dikkat: --baud 460800 verirsen esptool stub'ı o hızda bırakır ve sonraki komut 115200'den bağlanamaz. Yazma ortasında port düşerse kart download modunda kalır; tuşa tekrar gerek yok, komutu hemen yeniden çalıştır.

NodeMCU: otomatik reset var, tuş yok. Flash'tan sonra ~10 saniye dokunma; LittleFS ilk formatını yapıyor.

python tools/flash_esp8266.py COM3 --koru

ESP32 OLED: stok imaj (micropython-esp32.bin) ve aynı BOOT yordamı.

3. Deploy

Çekirdeği dondurulmuş kartlarda yalnız dosya sistemi dosyaları gider (main.py, boot.py, index.html, belgeler, örnekler). --frozen dondurulmuş modüllerin dosya sistemindeki kopyalarını siler; bu şarttır, çünkü dosya sistemindeki aynı adlı .py firmware'dekini gölgeler ve RAM yer.

# CYD
python tools/deploy.py --board cyd --port COM3 --frozen --samples --reset
# NodeMCU
python tools/deploy_mpy.py --board nodemcu --port COM4 --frozen --samples --reset
# ESP32 OLED (stok firmware; çekirdek dosya sistemine yazılır)
python tools/deploy.py --board oled --port COM6 --samples
  • --samples örnek projeleri de yükler.
  • --config kartın config.json'unu ezer; ilk kurulumda ver, sonra verme.
  • --reset sonunda kartı yeniden başlatır. mpremote kartı REPL'de bırakır; bunu vermezsen panel açılmaz.
  • deploy.py karttaki dosyanın özetini okuyup karşılaştırır, değişmeyeni atlar.

4. Açılışı izle

python tools/bootlog.py COM3 25
curl http://192.168.0.217/api/status

Panel cevap vermiyorsa kart ya kapalı, ya solo modda, ya açılışta patlamış, ya da REPL'de kalmış. bootlog.py her zaman gerçeği söyler.

5. İlk proje

Paneli aç (http://<kart-ip>/), + yeni ile merhaba.py oluştur, yaz, ▶'a bas:

import cyd

sayac = 0
while not cyd.should_stop():
    sayac += 1
    print('merhaba', sayac)
    if not cyd.sleep(1): break

print() çıktısı alttaki konsola akar, ■ durdurur. Kurallar ve cyd modülünün tamamı: Proje yazma.

USB köprüsü: WiFi olmadan panel

tools/usb_panel.py COM4 --board nodemcu paneli seri kablo üzerinden http://127.0.0.1:8080/ adresinde açar (localhost değil: Windows önce IPv6 dener, her istek 2 saniye gecikir). Panel HTML'i PC'den yüklenir, yalnız /api/... istekleri seri porttan gider; kartın konsol çıktısı aynı pencerede [kart] olarak akar. Köprü açıkken port meşguldür; deploy'dan önce kapat.

Dosya yazarken

PowerShell'in Set-Content -Encoding utf8 komutu dosya başına BOM ekler ve MicroPython bunu değişken sanıp NameError verir. Python dosyalarını editörle ya da Python'la yaz: open(p, 'w', encoding='utf-8', newline='\n').

Son güncelleme 2026-10-17 · Bu sayfa Markdown olarak