Otomasyon Ö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:
- Cihaz veya uygulama, PxServ veritabanına bir veri gönderir (örneğin
sıcaklıkanahtarına"32"yazar). - PxServ, bu anahtarı izleyen otomasyon kurallarını kontrol eder.
- Koşul sağlanıyorsa Gerçekleştiğinde bölümündeki aksiyonlar çalıştırılır.
- Koşul sağlanmıyorsa ve tanımlanmışsa Aksi Durumda bölümündeki aksiyonlar çalıştırılır.
- Otomasyonun güncellediği yeni değer (örneğin
fan_durumu), cihazlar veya uygulamalar tarafından okunarak uygulanır.
Temel kavramlar
| Kavram | Açı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şul | Otomasyonun 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ör | Gelen veriyi hedef değerle karşılaştırma şeklidir (=, !=, >, <, >=, <=). |
| Gerçekleştiğinde | Koşul sağlandığında otomatik olarak yapılacak işlemlerdir. |
| Aksi Durumda | Koş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ğerler | Aksiyon 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ör | Açıklama | Örnek Koşul |
|---|---|---|
= | Eşittir | kapı_durumu = 1 |
!= | Eşit değildir | mod != manuel |
> | Büyüktür | sıcaklık > 30 |
< | Küçüktür | toprak_nemi < 25 |
>= | Büyük veya eşittir | nem >= 70 |
<= | Küçük veya eşittir | pil_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ü | Durum | Hedef Alanı | İçerik / Değer Alanı | Açıklama |
|---|---|---|---|---|
| Veritabanına değer kaydet | Aktif | Kaydedilecek key | Kaydedilecek değer | Proje veritabanındaki belirtilen anahtara sabit veya dinamik bir değer yazar. |
| Telegram mesajı gönder | Yakında | Chat ID / kanal | Telegram mesajı | Belirtilen Telegram sohbetine veya kanalına otomatik bildirim mesajı gönderir. |
| Webhook çağır | Yakında | Webhook URL | JSON payload | Harici 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:
- Projenizin sol menüsünden Özellikler -> Otomasyonlar sayfasına gidin.
- Sağ üstteki Yeni otomasyon (veya ilk kuralınızsa Otomasyon oluştur) butonuna tıklayın.
- Otomasyon adı alanına kuralı açıklayan bir isim yazın (örneğin
Sera Fan Kontrolü). - 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).
- Gerçekleştiğinde bölümünde:
- Aksiyon:
Veritabanına değer kaydetseç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.
- Aksiyon:
- İ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_durumuanahtarına0kaydetmek). - Otomasyonu kaydet butonuna tıklayarak kuralı etkinleştirin.
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,nemgibi anahtarlar; otomasyon çıktıları içinfan_durumu,pompa_durumu,alarm_durumugibi ayrı anahtarlar kullanın. - Aksi Durumda bölümünü değerlendirin: Bir eşik aşıldığında
1yazan otomasyonun, değer normal seviyeye döndüğünde otomatik olarak0yazması 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: