CYD Studio › Belgeler › Proje yazma

Proje yazma

Projeler kartta /projects (SD varsa /sd/projects) altında yaşar. Her proje tek bir .py dosyasıdır, import cyd ile kartın donanımına ve çalışma ortamına erişir. Aynı dosya üç kartta da çalışır; kartta olmayan donanım açık hata fırlatır, sessizce yanlış çalışmaz.

İskelet

import cyd
from machine import Pin

led = Pin(getattr(cyd, 'D1', 22), Pin.OUT, value=0)   # NodeMCU: D1, CYD: GPIO22

try:
    while not cyd.should_stop():      # paneldeki Durdur'u dinle
        led.value(1)
        if not cyd.sleep(0.5): break  # durdurulabilir bekleme (saniye)
        led.value(0)
        if not cyd.sleep(0.5): break
finally:
    led.value(0)                      # nasil biterse bitsin temizle

Durdurma sözleşmesi

while True değil, while not cyd.should_stop(). should_stop() global olarak da enjekte edilir.
time.sleep değil, cyd.sleep(sn): beklerken Durdur'u dinler, kesilirse False döner, komşu projelere sıra verir. Normal modda otomatik await'e çevrilir.
Dinleyen proje 3 saniye içinde temiz çıkar. Dinlemeyen normal görev iptal edilir (finally çalışır). Hiç bekleme yapmayan proje ortak çalışanı kilitler; 5 saniye sonra kart resetlenir (panel bu sırada cevap verir). Thread'de: tek çalışan oysa reset, başkaları varsa "takıldı" işareti ve zorla düğmesi.
print() panele ve /logs/<proje>.log dosyasına akar; solo modda da kaybolmaz.

`cyd` modülü

Çağrı	Ne yapar
`cyd.should_stop()` · `cyd.sleep(sn)`	Durdurma sözleşmesi
`cyd.display(rot=None, bgr=None)`	Ekran (tembel oluşturulur; `fill`, `fill_rect`, `text(..., olcek)`, `circle`). OLED'de aynı API, renkler yanık/sönük'e düşer
`cyd.touch()`	`.touch()` → `(x, y)` ya da `None`, `.pressed()`, `.raw()`
`cyd.set_display(rot, bgr)` · `cyd.test_pattern()`	Yön ayarı
`cyd.led(r, g, b)` · `cyd.led_off()`	Kart üstü RGB LED (ters mantık)
`cyd.light()`	LDR, 0–4095 (büyük = karanlık)
`cyd.beep(freq, ms)`	Hoparlör (GPIO 26)
`cyd.buton(pin, fn=None, aktif=0, sekme_ms=40)`	Kesme tabanlı buton: `.basildi()` (tüketir), `.sayac`, `.basili()`; proje bitince kesme kapanır
`cyd.rota('/yol', fn)` · `cyd.rota_sil()` · `cyd.rotalar()`	Projenin web sayfası, ana sunucuda
`cyd.dram()`	Boş dahili DRAM (bayt); BLE/TLS öncesi buna bak
`cyd.wifi()`	Bağlı STA arayüzü (yalnız kullan, kapatma)
`cyd.mount_sd()`	SD'yi `/sd` altına bağlar, yolu döner ya da `None`
`cyd.claim_display()`	`(True, None)` ya da `(False, 'sahip proje')`
`cyd.job_name()`	Bu projenin adı
`cyd.D0` … `cyd.D8`, `cyd.A0`	NodeMCU pin etiketleri

Projenin kendi web sayfası

İkinci bir HTTP sunucusu açma. Ana sunucu /api dışı her isteği önce projelerin kaydettiği rotalara bakar: tek soket, tek döngü, aynı port.

import cyd

sayac = 0

def sayfa(istek):                 # istek: {'yontem', 'yol', 'sorgu', 'govde'}
    global sayac
    sayac += 1
    return '<h1>merhaba %d</h1>' % sayac   # str -> html, dict/list -> json,
                                           # bytes -> ham, (durum, tip, govde) -> ozel
cyd.rota('/selam', sayfa)

while not cyd.should_stop():
    cyd.sleep(1)

İşleyici sunucunun iş parçacığında koşar: kısa tut, içinde cyd.sleep bekleme, paylaşılan durumu basit değişkenlerde tut. Proje bitince rotaları kendiliğinden silinir. Panelde Uygulamalar satırında bağlantı olarak görünür. Örnek: yuk_kontrol.py (http://<ip>/yuk).

Buton: yoklama değil kesme

import cyd

b = cyd.buton(22)                 # GPIO22 <-> GND
while not cyd.should_stop():
    if b.basildi():
        print('basildi', b.sayac)
    cyd.sleep(0.05)

Ölçüldü (50 taklit basış, ekran çizen proje ve ağır thread yanında): 10 ms yoklama 5/50 yakaladı, kesme 50/50.

Yapılmayacaklar

İkinci HTTP sunucusu açma. İkinci dinleyici soket lwIP tamponlarıyla dahili DRAM'i tüketip paneli kilitledi (ölçüldü). cyd.rota kullan.
wlan.active(False) / wlan.disconnect() çağırma. Paneli de düşürür.
machine.reset() çağırma. jobs zaten yönetiyor.
Sleep'siz sonsuz döngü yazma. Normal modda komşuları bekletir, thread'de Durdur reset atar.
Ekranı iki projeden çizme. Veri bozulmaz (SPI kilidi var) ama üst üste çizerler; cyd.claim_display() sahipliği bildirir.

Ağ

Yöntem	Normal mod	Solo mod
`requests.get('http://...')`	✅	✅
`requests.get('https://...')`	❌ ENOMEM	✅
Ham `socket`	✅	✅
`ntptime.settime()`	✅	✅
BLE (`bluetooth`)	❌ EIO	✅

requests gövdeyi RAM'e alır; büyük dosyayı ham soketle parça parça gönder (ornek_sunucuya_yukle.py, 22 KB DRAM ile 9690 bayt doğrulandı). Olmayanlar: kamera modülü, WireGuard, Node.js / C#.

NodeMCU'da dikkat

RAM az (panel açıkken ~24 KB). Uzun print metinlerinden kaçın; büyük kütüphaneleri önceden derlenmiş .mpy olarak koy (mpy-cross bme280.py), kaynak .py import edilirken ayrıştırma için büyük geçici blok ister ve MemoryError verir.

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

Proje yazma

İskelet#

Durdurma sözleşmesi#

cyd modülü#

Projenin kendi web sayfası#

Buton: yoklama değil kesme#

Yapılmayacaklar#

Ağ#

NodeMCU'da dikkat#