TuyaOpen: AI Donanım Geliştirme Sistemi

Bu yazıda TuyaOpen’ın ne işe yaradığını, nasıl bir mimariye sahip olduğunu, hangi donanımları desteklediğini, kurulum ve geliştirme sürecini, lisans yapısını ve kullanım maliyetlerini adım adım ele alacağız.

TuyaOpen nedir?

Platform üç parçadan oluşuyor:

1. Gömülü SDK. Katmanlı bir C/C++ kütüphane seti. Uygulama kodu donanımdan soyutlandığı için aynı kaynak farklı çipler için derlenebiliyor.
2. Bulut yapay zekâ katmanı. Konuşma tanıma (ASR), metinden konuşma (TTS), görüntü anlama ve dil modeli erişimi tek bir oturum üzerinden geliyor. Model tarafında ChatGPT, Claude, Gemini, Qwen ve DeepSeek seçenekleri var.
3. Araç zinciri. tos.py komut satırı aracı, VS Code ve Cursor için TuyaOpen IDE eklentisi, seri port ve flash araçları.

Projeyi, Tuya bünyesinde yalnızca açık kaynak topluluğuna bakan bir ekip yürütüyor. Yol haritası ve issue’lar herkese açık, kod fork’lanabilir durumda.

Künye — 7 Eylül 2026 itibarıyla

Site ve dokümantasyon lisansı Apache-2.0 olarak veriyor. GitHub’ın otomatik lisans tanıyıcısı ise depodaki LICENSE dosyasını “Other” olarak etiketliyor. Ticari bir üründe kullanılacaksa dosyayı bir kez doğrudan okumakta fayda var.

Neler geliştirilebilir?

Dokümantasyonda hedeflenen kullanım alanları şöyle sıralanıyor:

• Konuşma tanıma (ASR), anahtar kelime algılama (KWS), metinden konuşma (TTS) ve sesten metne (STT) içeren ses ürünleri
• DeepSeek, ChatGPT, Claude ve Gemini gibi dil modelleriyle çalışan cihazlar
• Ses, görüntü ve sensör verisini birlikte kullanan çok modlu ürünler
• Tuya buluta bağlanan, uzaktan kontrol edilen, izlenen ve OTA ile güncellenen cihazlar
• Google Home ve Amazon Alexa ile uyumlu ürünler
• Bluetooth, Wi-Fi ve Ethernet üzerinden haberleşen donanımlar
• Cihaz kimlik doğrulama ve veri şifreleme gereken uygulamalar

Mimari: beş katman

SDK beş katmandan oluşuyor. Her katman yalnızca bir alttakine bağımlı; bu yüzden donanım değiştiğinde üst katmanlara dokunmak gerekmiyor.

• TKL (Kernel Layer). En alttaki katman. Tuya T serisi Core-SDK, Espressif ESP-IDF ile ARM SoC ve Linux için BSP paketleri burada duruyor. GPIO, PWM, ADC, DAC ve I²C sürücüleri donanım farklarını gizliyor. Dokümantasyona göre uygulama tarafında çalışırken bu katmanın detayına inmek gerekmiyor.
• TAL (Abstract Layer). İşletim sistemi ve cihaz soyutlaması. Bellek yönetimi, log, event ve mesaj kuyrukları, thread yönetimi, güvenli depolama; bunun yanında bağlantı (Wi-Fi, Ethernet, LTE Cat.1, Bluetooth) ve şifreleme motoru.
• Libraries. Hazır protokol ve bileşenler: MQTT, mbedTLS, HTTP, WebSocket, P2P, RTSP/RTP, LVGL arayüz kütüphanesi, cJSON ve QR kod işleme.
• Services. Geliştirme araçları ve bulut servisleri: tos.py, Arduino, Lua, MicroPython; bulut tarafında AI Agent, ASR/VAD, IoT PaaS ve RAG; TDD adı verilen cihaz sürücüleri; ses tarafında VAD, AEC ve wake-word algılama.
• Applications. Uygulama katmanı. Endüstriyel, görüntü, ses, ajan, robot, akıllı ev, güvenlik ve sağlık senaryoları burada yazılıyor.

Yapının amacı, donanıma bağımlı kodu en alt katmanda toplayıp uygulama katmanını taşınabilir tutmak. Board tanımını değiştirip aynı uygulamayı başka bir çip için derlemek mümkün.

Cihaz ve bulut arasındaki görev dağılımı

Temel yaklaşım şu: gecikmeye duyarlı işler cihazda, dil ve muhakeme işleri bulutta.

Bunun iki pratik sonucu var. Birincisi, bağlantı koptuğunda cihaz tamamen ölmüyor; yerel işler dönmeye devam ediyor. İkincisi, sesi, modeli veya ajanın davranışını değiştirmek için cihaza yeniden firmware atmak gerekmiyor. Bunlar bulut tarafındaki ajan yapılandırmasından değişiyor.

Araç çağrısının donanıma nasıl bağlandığını görmek için basit bir örnek: bulut sıcaklığı ve süreyi belirliyor, cihaz set_temperature(180), set_heat(both, on), set_time(12) ve start() çağrılarını yürütüyor; sürenin sonuna doğru bulut take_photo() istiyor, gelen kareyi değerlendiriyor ve stop() çağırıyor.

Çok modlu veri akışı

Dört veri türü de aynı yolu izliyor: donanım, ai_components yazılım katmanı, ai_agent ve bulut. ai_agent buluta açılan tek nokta.

Kullanılmayan veri türleri Kconfig üzerinden (ENABLE_COMP_AI_* seçenekleri) kapatılıyor ve derlenen binary’ye hiç girmiyor. 16 MB flash’a sahip bir modülde bu, kod boyutu açısından ciddi fark yaratıyor.

Ekran arayüzü için üç hazır seçenek var: balonlu sohbet görünümü, chatbot görünümü ve OLED ekranlar için sadeleştirilmiş görünüm.

Desteklenen donanım

MCU tarafı

Düşük maliyetli, az güç tüketen ve sürekli açık kalan cihazlar için. Yapay zekâ işi bulutta döndüğü için cihaz tarafı yalın kalıyor.

• Tuya T5 (önerilen, çok modlu): T5-E1 modülü, T5AI-Board, T5AI-Core, T5AI Pixel (32×32 LED panel), T5AI Pocket, E-Ink NFC kartı, Otto Robot ve Robot Dog referans kartları, Waveshare 1,75 inç AMOLED, Zectrix Note 4
• Tuya T3 ve T2: Wi-Fi ve BLE destekli klasik IoT çipleri
• ESP32 ailesi: S3, C3, C6, P4 ve klasik ESP32; ALIENTEK ve Waveshare kartları dâhil
• BK7231X, LN882H, GigaDevice GD32VW553: ek çip platformları

SoC tarafı

Uçta model çalıştırmak ya da daha ağır uygulamalar yazmak isteyenler için.

• Raspberry Pi 4 ve 5: ALSA ses, SDL2 ekran ve V4L2 USB kamera desteğiyle
• Rockchip RK3576: TaishanPi 3 ve DshanPi A1 kartları
• Ubuntu ve Linux PC: x86_64 veya arm64; LVGL arayüzü masaüstünde SDL üzerinden çalışıyor
• ESP32-P4 ile ESP32-C6: MIPI-CSI/DSI arayüzleri, kablosuz bağlantı C6 üzerinden

Geliştirme makinesi olarak Windows, macOS ve Linux destekleniyor. Ama platform tablosuna bakınca en tam desteğin Linux’ta olduğu görülüyor: ESP32 ve T5AI için Windows onaylıyken BK7231X, LN882H, T2 ve T3 tarafında Windows ve macOS hâlâ beklemede.

Tuya T5 teknik özellikleri

Ekosistemin merkezinde T5 var. Ses, ekran ve kamera arayüzlerini tek modülde topluyor.

Kurulum ve derleme

Depo klonlandıktan sonra kök dizindeki export betiği çalıştırılıyor; bu betik tos.py ortamını hazırlıyor.

git clone https://github.com/tuya/TuyaOpen.git
cd TuyaOpen
. ./export.sh          # Windows'ta export.ps1 veya export.bat
tos.py check

cd apps/tuya_cloud/switch_demo
tos.py config choice   # hedef kartı seç
tos.py build
tos.py flash
tos.py monitor         # seri log ve yetkilendirme

Uygulamalar iki grupta duruyor: tuya_cloud altındakiler yalnızca IoT bağlantısı kuruyor, tuya.ai altındakiler buna yapay zekâ servislerini ekliyor.

C dışında Arduino IDE, Lua ve MicroPython ile de geliştirme yapılabiliyor. Arduino tarafında T5 için board desteği ve kütüphaneler hazır geliyor.

Lisansın cihaza yazılması

Tuya buluta bağlanacak her cihazın bir kimliği olması gerekiyor. Bu kimlik 20 karakterlik bir UUID ile 32 karakterlik bir AuthKey çiftinden oluşuyor ve Tuya Developer Platform üzerinden alınıyor.

Kimliği cihaza yazmanın iki yolu var. Birincisi derleme zamanında, tuya_config.h üzerinden:

// tuya_config.h
#define TUYA_OPENSDK_UUID    "uuidxxxxxxxxxxxxxxxx"
#define TUYA_OPENSDK_AUTHKEY "keyxxxxxxxxxxxxxxxxxx"

İkincisi cihaz çalışırken seri porttan:

tos.py monitor -b 115200
auth uuid9f6a6...  cGuDnU2Yxj...

Yazılan kimlik auth-read komutuyla geri okunup doğrulanıyor. Cihaz yeniden başlatıldıktan sonra Tuya uygulamasından eşleştiriliyor.

Kimlik, MCU üzerinde korumalı bir key-value alanında tutuluyor. Firmware güncellemelerinden etkilenmiyor, yalnızca flash tamamen silinirse kayboluyor. Bir AuthKey’i başka bir karta taşımadan önce ilk cihazı uygulamadan kaldırmak gerekiyor.

Hazır demo uygulamaları

• switch_demo — Desteklenen tüm çiplerde çalışan temel IoT firmware’i. Ağ kurulumu, eşleştirme, bulut üzerinden kontrol ve OTA güncellemeyi kapsıyor. Basit bir aç/kapa örneği ve buna bağlı uygulama paneli içeriyor.
• your_chat_bot — Sesli sohbet uygulaması. T5AI, ESP32-S3 ve Raspberry Pi 4/5 sınıfı cihazlar için ayarlanmış. Çok modlu giriş ve skill eklemeyi destekliyor.
• duo_eye_mood — T5AI üzerinde çalışan, ekranda iki göz ve ifade gösteren sesli etkileşim örneği.

Bunların yanında donanım protokolleri, işletim sistemi programlama, LVGL arayüzü ve genel örnekleri kapsayan ayrı bir çevre birimi örnek seti var.

TuyaOpen IDE

VS Code ve Cursor için geliştirilen eklenti; şu an early preview aşamasında. Amacı firmware, bulut ajanı ve uygulama panelini tek bir akışta toplamak.

• Doğal dille proje oluşturma; çok platformlu proje yapısı ve makine tarafından okunabilir metadata üretimi
• Board kataloğu, pin mapping yardımı, demo kütüphanesi, SDK yönetimi, flash ve seri monitör
• PlatformIO deposundan üçüncü parti sürücü ve sensör kütüphanesi kurulumu, CMake entegrasyonunun otomatik üretilmesi
• Kod asistanlarıyla kullanılabilen skill kütüphanesi; donanım bağlamı doğrudan asistana aktarılıyor

Ekip ayrıca TuyaOpen-dev-skills deposunda bir SDK uzman skill’i yayımlamış. Yeni proje kurulumu, cihaz kimlik doğrulama, build, flash, debug ve komut satırından test adımlarını tanımlıyor.

Eklenti şu anda VS Code Marketplace ve Open VSX üzerinde listelenmiyor. Kurmak için GitHub Releases sayfasından .vsix dosyasını indirip elle yüklemek gerekiyor.

TClaw

TClaw (eski adı DuckyClaw), TuyaOpen C SDK’sı üzerine kurulmuş bir ajan framework’ü. MCU üzerinde Node.js istemiyor; ARM Cortex-M, Cortex-A ve x64 hedeflerinde aynı kod tabanı çalışıyor.

• Ajan döngüsünün çekirdeği cihazda dönüyor; dil modeli, RAG ve MCP gibi ağır işler buluta devrediliyor
• Telegram, Discord ve Feishu tek bir gateway üzerinden bağlanıyor
• Yerel MCP araçları: zamanlanmış görevler (CRON), dosya işlemleri, IoT kontrolü ve Linux tarafında shell komutu çalıştırma
• Kalıcı hafıza dosyaları (agent.txt, memory.txt) ve cihaz tercihlerini öğrenen bir IoT hafızası
• Ajan döngüsünü ayakta tutan, periyodik kontrol yapan bir heartbeat mekanizması

Desteklenen kartlar arasında T5AI Board ve Core, ESP32-S3, Raspberry Pi 4/5 ile CM4/CM5, DshanPI-A1 (RK3576) ve Waveshare T5-E1 AMOLED var.

Lisanslama ve maliyet

Framework’ün tamamı her katmanda aynı ve açık kaynak. Ücret yalnızca cihaz Tuya buluta bağlandığında devreye giriyor.

Ödemeler tek seferlik, abonelik yok. Her geliştirici Tuya Developer Platform üzerinden iki adet ücretsiz cihaz lisansı alabiliyor; bunlar tam yapay zekâ ve IoT yetenekleriyle geliyor, kredi kartı da istenmiyor.

Lisanslı her cihaz günlük sabit bir ücretsiz yapay zekâ kullanım hakkıyla geliyor: dil modeli token’ı, ASR dakikası ve TTS karakteri. Bu hak aşılırsa kullanım başına ücretlendirme başlıyor.

Günlük hakkın sayısal karşılığı sitede yazmıyor. Seri üretim düşünülüyorsa toplam maliyeti belirleyen kalem bu; önceden netleştirmek gerekiyor.

Sürüm ve dal yapısı

Proje hızlı geliştiği için hangi branch üzerinden çalışıldığı önem taşıyor.

Değerlendirme

• Katmanlı yapı gerçekten uygulanmış; aynı uygulama T5, ESP32-S3 ve Raspberry Pi için derlenebiliyor.
• Cihaz ve bulut arasındaki görev dağılımı net; gecikmeye duyarlı işler cihazda kalıyor.
• Cihaz araçlarının MCP üzerinden açılması, dil modelini donanıma standart bir protokolle bağlıyor.
• Maliyet öngörülebilir: abonelik yerine cihaz başına tek seferlik ödeme.
• Model bağımlılığı yok; sağlayıcılar arasında geçiş yapılabiliyor.
• Hazır kartlar, demolar ve geniş sürücü seti başlangıç süresini ciddi biçimde kısaltıyor.

Platformun işi görüp görmeyeceğini anlamanın en hızlı yolu, bir T5AI kartı ya da eldeki bir ESP32-S3 ile your_chat_bot demosunu çalıştırmak. İki ücretsiz lisans, uçtan uca bir bulut ve yapay zekâ akışını denemeye yetiyor.

Bu yazıdaki bilgiler 7 Eylül 2026 tarihinde TuyaOpen resmî sitesinden ve proje dokümantasyonundan derlendi. Fiyatlar, sürüm numaraları ve kart listesi değişebilir.