# CYD Studio belgeleri

CYD Studio, tek kartlı mini bilgisayarlar (ESP32 "CYD", NodeMCU ESP8266, OLED'li ESP32) için küçük bir işletim sistemidir: tarayıcıdan `.py` yazarsın, **Çalıştır**'a basarsın, proje kartta koşar. Loglar, çalışma modları, bekçi, projelerin kendi web sayfaları ve kart başına özellik haritası hepsi içeridedir. **C++ derlemesi yoktur**: firmware'i geliştirici derler, kullanıcı yalnız Python yazar.

Bu belgelerdeki her sayı kartlarda **ölçülmüştür**, tahmin değildir. Bir şeyi değiştirirsen yeniden ölç.

## Nereden başlamalı

- [Başlangıç](/docs/baslangic/): PC araçları, WiFi ayarı, flash ve deploy, ilk proje.
- [Proje yazma](/docs/proje-yazma/): `cyd` modülü, durdurma sözleşmesi, yapılmayacaklar.
- [Çalışma modları ve bellek](/docs/calisma-modlari/): N / T / S cipi, heap ile dahili DRAM farkı, ölçülmüş sınırlar.
- [Kartlar ve firmware](/docs/kartlar/): üç kartın farkları, özel imajlar, yeni kart ekleme.
- [HTTP API](/docs/api/): kart üstü panelin bütün uç noktaları.
- [Atölye ve Mağaza](/docs/atolye/): proje paylaşımı, panelin Mağaza sekmesi, herkese açık arama API'si.
- [Bilinen tuzaklar](/docs/tuzaklar/): MISO, SD slotu, mpremote, BOM, CH340.
- Yeni başlayanlar için adım adım öğretici: [Atölye Defteri](/defter/).

## Sistem bir bakışta

| Katman | Nerede | Ne yapar |
|---|---|---|
| Çekirdek (`device/`) | Firmware'e dondurulmuş (CYD, NodeMCU) ya da dosya sisteminde (OLED) | `runtime`, `jobs`, `server`, `store`, `netmgr`, `sysinfo`, `settings`, `logstore` |
| Kart katmanı (`boards/<ad>/cyd.py`) | Firmware'de | Donanım ve `OZELLIKLER` sözlüğü; projeler `import cyd` yazar |
| Panel (`index.html`) | Kartın dosya sisteminde | Tek dosya, bağımlılık yok, TR/EN |
| Projeler | `/projects` (SD varsa `/sd/projects`) | Senin `.py` dosyaların |
| PC araçları (`tools/`) | Bilgisayarında | deploy, flash, bootlog, USB köprüsü, testler |

## Kaynak ve lisans

Kod [GitHub'da](https://github.com/tarikgkhsn/CYD-Studio), MIT lisanslı. Sorun bildirimi ve katkı açıktır. Bu site ve belgeler [Nuvaka](https://nuvaka.com) tarafından barındırılır.