MicroControlPanel'de Datastream ve Widget Ekleme Rehberi

📡 Datastream Nedir?

MicroControlPanel'de Datastream, cihazınız ile platform arasındaki veri kanallarıdır. Her datastream bir Virtual Pin (V0, V1, V2…) ile tanımlanır ve cihazınızdan gelen sensör verilerini okumak veya cihazınıza komut göndermek için kullanılır.

Datastream'i gerçek hayattaki bir su borusu gibi düşünebilirsiniz:

• 🔵 Input (Okuma): Sensörden platforma veri akar — sıcaklık, nem, basınç gibi
• 🟠 Output (Yazma): Platformdan cihaza komut gider — açma/kapama, hedef değer gibi
• 🟢 InputOutput: Her iki yönde de veri akar

Örnek: Bir sıcaklık sensörü V0 üzerinden 23.5 değerini gönderir → Platform bunu Gauge widget'ında gösterir. Kullanıcı slider'ı kaydırır → Platform V3 üzerinden "25" değerini cihaza yazar.

Datastream vs Widget Farkı

Önce datastream tanımlanır, sonra widget bu datastream'e bağlanır.

🛠️ Datastream (Virtual Pin) Oluşturma

Cihazınıza datastream eklemek için şu adımları izleyin:

1. Cihazlarım sayfasına gidin ve cihazınızı seçin.
2. Cihaz detayında "+ Datastream Ekle" butonuna tıklayın.
3. Açılan formda aşağıdaki alanları doldurun:

📌 Veri Tipleri

🔄 Pin Mode: Veri Akış Yönü

Pin Mode, verinin hangi yönde akacağını belirler. Doğru ayarlamak önemlidir:

Örnek Senaryo

Bir akıllı aydınlatma projesinde:

• V0 — Input — LDR sensörden ortam ışık seviyesi (0-1024)
• V1 — Output — LED parlaklık kontrolü (0-255, Slider ile)
• V2 — Output — LED açma/kapama (0 veya 1, Switch ile)
• V3 — Input — WiFi sinyal gücü RSSI (dBm)

💡 İpucu: Save History seçeneğini Input pinlerde mutlaka açın — böylece Chart widget'ında zaman serisi grafik görebilirsiniz. Output pinlerde genellikle geçmiş kaydı gerekmez.

🎨 Widget Tipleri

MicroControlPanel şu widget tiplerini destekler. Her birini ilgili datastream'e bağlayarak dashboard'unuzu oluşturursunuz:

📦 Paket Notu: Free planda BUTTON, SLIDER, SWITCH, VALUE_DISPLAY, LED, GAUGE, LABEL kullanılabilir. CHART widget'ı Pro ve Business paketlerinde aktiftir.

➕ Widget Ekleme (Adım Adım)

Dashboard'a widget eklemek için:

1. Cihazlarım sayfasında cihazınızı seçin.
2. Dashboard görünümünde "+ Widget Ekle" butonuna tıklayın.
3. Açılan pencerede şu alanları doldurun:

🖥️ Örnek Dashboard Düzeni

Bir hava istasyonu projesi için önerilen widget düzeni:

💻 Firmware'den Datastream Kullanımı

Cihaz tarafında datastream'lere veri yazmak ve okumak için MCPSimpleEsp8266 kütüphanesini kullanırız. Global MCP nesnesi ve MCP_WRITE makrosu ile çalışılır:

Veri Gönderme (Cihaz → Platform)

// Sensörden okunan değerleri platforma gönder
float sicaklik = dht.readTemperature();
float nem = dht.readHumidity();
int isikSeviyesi = analogRead(A0);

// MCP.virtualWrite(pin, değer) — pin makro olarak (V0, V1...)
MCP.virtualWrite(V0, sicaklik);       // 23.5 (float → otomatik 1 ondalık)
MCP.virtualWrite(V1, nem);             // 45.2
MCP.virtualWrite(V2, isikSeviyesi);    // 680 (int)

// LED durumu (0 veya 1)
MCP.virtualWrite(V5, digitalRead(RELAY_PIN) == LOW ? 1 : 0);

// String veri
MCP.virtualWrite(V6, "Sistem Çalışıyor");

Komut Alma (Platform → Cihaz)

MCP_WRITE(Vx) makrosu ile tanımlanan handler'lar, platformdan o pine değer geldiğinde otomatik çağrılır. param nesnesi gelen değeri içerir:

// V3: Switch widget'ından gelen on/off komutu
MCP_WRITE(V3)
{
    int val = param.asInt();
    if (val == 1) {
        digitalWrite(FAN_PIN, HIGH);  // Fan aç
        Serial.println("Fan: ON");
    } else {
        digitalWrite(FAN_PIN, LOW);   // Fan kapat
        Serial.println("Fan: OFF");
    }
}

// V4: Slider widget'ından gelen PWM değeri (0-255)
MCP_WRITE(V4)
{
    int pwm = param.asInt();
    pwm = constrain(pwm, 0, 255);
    analogWrite(FAN_PWM_PIN, pwm);
    Serial.printf("Fan hız: %d\n", pwm);
}

// V7: Enum datastream — "Kapalı","Düşük","Orta","Yüksek"
MCP_WRITE(V7)
{
    String mod = param.asStr();
    Serial.println("Mod: " + mod);
    if (mod == "Kapalı")      analogWrite(FAN_PWM_PIN, 0);
    else if (mod == "Düşük")  analogWrite(FAN_PWM_PIN, 80);
    else if (mod == "Orta")   analogWrite(FAN_PWM_PIN, 170);
    else if (mod == "Yüksek") analogWrite(FAN_PWM_PIN, 255);
}

// Bağlantı kurulduğunda son değerleri sunucudan çek
MCP_CONNECTED()
{
    MCP.syncVirtual(V3, V4, V7);
}

void setup() {
    Serial.begin(115200);
    pinMode(FAN_PIN, OUTPUT);
    MCP.begin(auth, ssid, pass, server, 80);
}

void loop() {
    MCP.run();
    // ... sensör okuma ve MCP.virtualWrite() ...
}

⏱️ Gönderim Sıklığı: Sensör verilerini 10-30 saniye aralıkla göndermek idealdir. Çok sık göndermek (1 sn) sunucu yükünü artırır, çok seyrek göndermek (5 dk) anlık izlemeyi zorlaştırır.

🎯 Pratik Proje Örnekleri

Örnek 1: Akıllı Sera Otomasyonu

Örnek 2: Araç Takip Sistemi

Örnek 3: Akıllı Ev Aydınlatma

💡 İpuçları ve En İyi Uygulamalar

📐 Datastream İsimlendirme Kuralları

• Pin kodlarını sıralı kullanın: V0, V1, V2… (boşluk bırakmayın)
• Label'lara anlamlı isimler verin: "Oda Sıcaklığı" ✅ — "V0" ❌
• Aynı cihazda aynı pin kodunu iki kez kullanamazsınız
• Farklı cihazlarda aynı pin kodunu kullanabilirsiniz (V0 her cihaz için ayrıdır)

🎨 Widget Renk Stratejisi

⚡ Performans Tavsiyeleri

• Save History'yi sadece grafik görmek istediğiniz pinlerde açın — gereksiz açmak veritabanı şişirir
• InvalidateSeconds ayarlayarak bağlantı koptuğunda widget'ın eski değeri göstermesini engelleyin (ör: 60 saniye)
• Expose to Automation'ı sadece otomasyon kurallarında kullanacağınız pinlerde açık tutun
• Bir cihazda en fazla 32 Virtual Pin tanımlamanız önerilir

🔧 Sık Yapılan Hatalar

Daha fazla bilgi için REST API dokümantasyonunu inceleyin. Her datastream'e GET /api/devices/{id}/pins ve POST /api/devices/{id}/pins/{pinCode}/value endpoint'leri ile programatik olarak da erişebilirsiniz. 🚀