Skip to Content
Otomasyon Özelliği

Otomasyon Özelliği

Beta Özelliği

Otomasyonlar özelliği şu anda BETA aşamasındadır. Veritabanına değer kaydetme aksiyonu aktif olarak kullanılabilir; Telegram bildirimi ve Webhook aksiyonları ise yakında eklenecektir.

PxServ Otomasyon Özelliği, projenizdeki verileri belirlediğiniz koşullarla anlık olarak izlemenizi ve koşul sağlandığında (veya sağlanmadığında) otomatik işlemler çalıştırmanızı sağlar. Cihaz tarafında karmaşık kontrol kodları yazmaya ya da ek bir sunucu kurmaya gerek kalmadan, doğrudan panel üzerinden Koşul -> Gerçekleştiğinde -> Aksi Durumda kuralları oluşturabilirsiniz.

  • Amaç: Projedeki verileri koşullarla izleyip otomatik işlemler ve cihaz komutları çalıştırmak.
  • Göründüğü yer: Kontrol panelindeki Özellikler -> Otomasyonlar bölümü.
  • Nasıl tetiklenir: İzlenecek veri anahtarı (key), karşılaştırma operatörü (=, !=, >, <, >=, <=) ve eşik değer (value) ile.
  • Nasıl çalışır: Koşul sağlandığında Gerçekleştiğinde adımları, sağlanmadığında ise isteğe bağlı Aksi Durumda adımları çalışır.

Ne zaman kullanılır?

Otomasyonlar; bir sensör verisi belirli bir sınırı geçtiğinde başka bir veriyi otomatik güncellemek, bir röleyi ya da fanı açıp kapatmak veya birden fazla cihazın birbiriyle haberleşmesini sağlamak istediğinizde idealdir.

Otomasyon özelliği şu durumlarda idealdir:

  • Sıcaklık, nem, toprak nemi veya su seviyesi gibi bir ölçüm belirlediğiniz sınırı aştığında fan, pompa ya da alarm durumunu otomatik değiştirmek istediğinizde.
  • Cihaza tekrar kablo takıp kod yüklemeden, eşik değerlerini doğrudan PxServ panelinden değiştirmek istediğinizde.
  • Bir cihazın gönderdiği sensör verisine göre aynı projedeki başka bir cihazı tetiklemek istediğinizde.
  • Koşul sağlandığında (Gerçekleştiğinde) bir sistemi açıp, değer normale döndüğünde (Aksi Durumda) otomatik olarak kapatmak istediğinizde.

Otomasyon kullanırken şu noktalara dikkat edilmelidir:

  • Koşulda izlenen anahtar ile aksiyonda değiştirilen anahtarın aynı olması, otomasyonun kendi kendini sürekli tetiklemesine yol açabilir.
  • Sayısal karşılaştırmalarda (>, <, >=, <=) cihazdan gönderilen değerin sade bir sayı formatında (örneğin "24.5") olması gerekir.
  • Kritik fiziksel sistemlerde (örneğin yüksek güçlü ısıtıcılar veya su pompaları) bulut otomasyonunun yanında cihaz kodunda da temel güvenlik sınırları bulundurulmalıdır.

Otomasyon akışı nasıl çalışır?

PxServ üzerinde bir otomasyon kuralı şu adımlarla çalışır:

  1. Cihaz veya uygulama, PxServ veritabanına bir veri gönderir (örneğin sıcaklık anahtarına "32" yazar).
  2. PxServ, bu anahtarı izleyen otomasyon kurallarını kontrol eder.
  3. Koşul sağlanıyorsa Gerçekleştiğinde bölümündeki aksiyonlar çalıştırılır.
  4. Koşul sağlanmıyorsa ve tanımlanmışsa Aksi Durumda bölümündeki aksiyonlar çalıştırılır.
  5. Otomasyonun güncellediği yeni değer (örneğin fan_durumu), cihazlar veya uygulamalar tarafından okunarak uygulanır.

Temel kavramlar

KavramAçıklama
Otomasyon AdıOluşturduğunuz kuralı panelde kolayca tanımanızı sağlayan isimdir (örneğin Yüksek sıcaklık fan kontrolü).
KoşulOtomasyonun ne zaman devreye gireceğini belirleyen kuraldır (örneğin sıcaklık > 30).
Veritabanı AnahtarıTakip etmek istediğiniz verinin adıdır (örneğin sıcaklık, nem, toprak_nemi). Panel, mevcut anahtarları otomatik önerir.
OperatörGelen veriyi hedef değerle karşılaştırma şeklidir (=, !=, >, <, >=, <=).
GerçekleştiğindeKoşul sağlandığında otomatik olarak yapılacak işlemlerdir.
Aksi DurumdaKoşul sağlanmadığında yapılacak isteğe bağlı işlemlerdir (örneğin sıcaklık normale döndüğünde fanı kapatmak).
Dinamik DeğerlerAksiyon içinde sabit bir metin yazmak yerine, o an gelen verinin adını ({key}) veya değerini ({value}) otomatik olarak kullanmanızı sağlar.

Desteklenen operatörler

Koşul bölümünde aşağıdaki 6 karşılaştırma operatörünü kullanabilirsiniz:

OperatörAçıklamaÖrnek Koşul
=Eşittirkapı_durumu = 1
!=Eşit değildirmod != manuel
>Büyüktürsıcaklık > 30
<Küçüktürtoprak_nemi < 25
>=Büyük veya eşittirnem >= 70
<=Küçük veya eşittirpil_seviyesi <= 15

Aksiyon türleri

Bir koşul gerçekleştiğinde veya aksi durumda çalıştırılmak üzere bir ya da birden fazla aksiyon ekleyebilirsiniz:

Aksiyon TürüDurumHedef Alanıİçerik / Değer AlanıAçıklama
Veritabanına değer kaydetAktifKaydedilecek keyKaydedilecek değerProje veritabanındaki belirtilen anahtara sabit veya dinamik bir değer yazar.
Telegram mesajı gönderYakındaChat ID / kanalTelegram mesajıBelirtilen Telegram sohbetine veya kanalına otomatik bildirim mesajı gönderir.
Webhook çağırYakındaWebhook URLJSON payloadHarici bir web servisine olay verilerini içeren HTTP isteği gönderir.

Dinamik değer kullanımı ({key} ve {value})

Bir aksiyon çalışırken her zaman sabit bir değer (1, 0, açık) yazmak zorunda değilsiniz. Otomasyonu tetikleyen verinin kendi adını veya o anki değerini de doğrudan kullanabilirsiniz:

  • {key}: Otomasyonu tetikleyen verinin adını yazar.
  • {value}: Otomasyonu tetikleyen verinin o anki değerini yazar.

Örneğin:

  • Kaydedilecek key: son_uyarı
  • Kaydedilecek değer: {key} kritik seviyeye ulaştı: {value}

Koşul sıcaklık > 30 iken cihaz "34.2" gönderdiğinde, son_uyarı anahtarına otomatik olarak "sıcaklık kritik seviyeye ulaştı: 34.2" kaydedilir.

Adım adım otomasyon oluşturma

PxServ kontrol panelinden yeni bir otomasyon oluşturmak için şu adımları izleyin:

  1. Projenizin sol menüsünden Özellikler -> Otomasyonlar sayfasına gidin.
  2. Sağ üstteki Yeni otomasyon (veya ilk kuralınızsa Otomasyon oluştur) butonuna tıklayın.
  3. Otomasyon adı alanına kuralı açıklayan bir isim yazın (örneğin Sera Fan Kontrolü).
  4. Koşul bölümünde:
    • Veritabanı anahtarı: İzlemek istediğiniz anahtarı yazın veya açılır listeden seçin (seçtiğiniz anahtar veritabanında varsa altında Mevcut değer bilgisi görünür).
    • Operatör: Karşılaştırma operatörünü seçin (=, !=, >, <, >=, <=).
    • Değer: Karşılaştırılacak eşik değerini girin (örneğin 30).
  5. Gerçekleştiğinde bölümünde:
    • Aksiyon: Veritabanına değer kaydet seçeneğini belirleyin.
    • Kaydedilecek key: Güncellenecek hedef anahtarı girin (örneğin fan_durumu).
    • Kaydedilecek değer: Yazılacak değeri girin (örneğin 1).
    • Gerekirse + Aksiyon ekle butonuyla aynı koşula bağlı ek aksiyonlar tanımlayın.
  6. İsteğe bağlı olarak Aksi Durumda bölümünde + Aksiyon ekle butonuna tıklayarak koşul sağlanmadığında çalışacak aksiyonu ekleyin (örneğin fan_durumu anahtarına 0 kaydetmek).
  7. Otomasyonu kaydet butonuna tıklayarak kuralı etkinleştirin.
Sonsuz döngü uyarısı

Koşulda izlediğiniz Veritabanı anahtarı ile aksiyonda yazdığınız Kaydedilecek key aynı olmamalıdır. Örneğin sıcaklık > 20 koşulunda yine sıcaklık anahtarına değer yazmak otomasyonun sürekli tetiklenmesine neden olabilir. Sensör verisi (örn. sıcaklık) ile kontrol çıktısını (örn. fan_durumu) ayrı anahtarlarda tutun.

Örnek senaryo ve cihaz kodu

Aşağıdaki senaryoda ESP32 cihazı ortam sıcaklığını sıcaklık anahtarına gönderir ve fan_durumu anahtarını okuyarak fan rölesini kontrol eder.

1. Paneldeki otomasyon kuralı

  • Otomasyon adı: Yüksek Sıcaklık Fan Otomasyonu
  • Koşul: sıcaklık > 28
  • Gerçekleştiğinde: Veritabanına değer kaydet -> Hedef: fan_durumu, Değer: 1
  • Aksi Durumda: Veritabanına değer kaydet -> Hedef: fan_durumu, Değer: 0

2. Arduino (ESP32 / ESP8266) örnek kodu

#include <PxServ.h> #define FAN_RELAY_PIN 5 PxServ client("pxserv_proje_api_anahtariniz"); void setup() { Serial.begin(115200); pinMode(FAN_RELAY_PIN, OUTPUT); PxServ::connectWifi("wifi_ssid", "wifi_sifre"); } void loop() { // 1. Sensör verisini PxServ'e gönder (otomasyon bu anahtarı izler) float mevcutSicaklik = 29.4; // Örnek sensör ölçümü client.setData("sıcaklık", String(mevcutSicaklik)); // 2. Otomasyonun güncellediği hedef anahtarı oku ve röleyi uygula PxServ::Callback fanDurumu = client.getData("fan_durumu"); if (fanDurumu.status == 200) { digitalWrite(FAN_RELAY_PIN, fanDurumu.data == "1" ? HIGH : LOW); } delay(5000); }

3. JavaScript / TypeScript ile gerçek zamanlı dinleme

Otomasyon bir hedef anahtarı güncellediğinde, Socket.IO veya JavaScript/TypeScript SDK kullanan uygulamalar da bu değişikliği anında yakalayabilir:

import { io } from "socket.io-client"; const socket = io("https://api.pxserv.net", { auth: { apiKey: process.env.PXSERV_API_KEY, }, }); socket.on("setData", (data) => { if (data.key === "fan_durumu") { console.log("Otomasyon fan durumunu güncelledi:", data.value); } });

İpuçları

  • Giriş ve çıkış anahtarlarını ayırın: Ölçüm verileri için sıcaklık, nem gibi anahtarlar; otomasyon çıktıları için fan_durumu, pompa_durumu, alarm_durumu gibi ayrı anahtarlar kullanın.
  • Aksi Durumda bölümünü değerlendirin: Bir eşik aşıldığında 1 yazan otomasyonun, değer normal seviyeye döndüğünde otomatik olarak 0 yazması için Aksi Durumda aksiyonu ekleyin.
  • Tutarlı veri formatı kullanın: Sayısal operatörler (>, <, >=, <=) kullanırken cihazdan birim sembolü içermeyen sade sayısal metinler gönderin ("25.4 °C" yerine "25.4").

Sorun giderme

Otomasyon kaydedilemiyor

  • Otomasyon adı, veritabanı anahtarı, koşul değeri ve eklenen tüm aksiyonların hedef/değer alanlarının dolu olduğundan emin olun; boş alan bırakıldığında form kaydedilmez.

Koşul sağlandığı halde hedef anahtar güncellenmiyor

  • Cihazın gönderdiği anahtar adının otomasyondaki Veritabanı anahtarı ile birebir aynı (büyük/küçük harf duyarlı) olduğunu kontrol edin.
  • Sayısal karşılaştırma yapıyorsanız gönderilen değerin metin içinde harf veya birim içermediğinden emin olun.
  • Otomasyonlar listesinden kuralın doğru operatör ve eşik değeriyle kaydedildiğini doğrulayın.

Cihaz güncellenen aksiyon değerini uygulamıyor

  • Cihaz kodunda okunan anahtar adının (getData("fan_durumu")) otomasyondaki Kaydedilecek key alanıyla aynı olduğunu kontrol edin.
  • API anahtarının okuma yetkisine sahip olduğundan emin olun.

Kısa özet

PxServ Otomasyon Özelliği, cihazlardan gelen verileri bulut üzerinde koşullarla değerlendirip başka veritabanı anahtarlarını otomatik olarak güncellemenizi sağlar. Koşul, Gerçekleştiğinde ve Aksi Durumda yapısıyla cihaz kodunu değiştirmeden esnek kontrol senaryoları oluşturabilirsiniz.

İlgili dokümanlar:

Son güncelleme