Edge Agent Kurulum RehberiWindows ve macOS

Edge Agent, kapıdaki bilgisayarda arka planda çalışan programdır: kameraları okur, plakayı tanır, bariyeri açar ve sonuçları buluta gönderir. Arayüzü tarayıcıda açılır; internet kesilse de plaka okuma ve bariyer kararı yerel liste önbelleğinden devam eder.

Windows için indir (.exe) macOS kurulumu Bariyer bağlantısı

Bilgisayar

Windows 10/11 64-bit veya macOS 13+. 4 çekirdek CPU, 8 GB RAM önerilir. GPU gerekmez.

Kamera

USB webcam ya da IP/RTSP kamera (ONVIF destekli kameralar otomatik bulunur). Plaka karede en az %15 genişlik kaplamalı.

Bariyer (isteğe bağlı)

USB seri röle (CH340/FTDI), Shelly/Sonoff ağ rölesi, Modbus TCP veya Raspberry Pi GPIO.

Başlamadan önce: kayıt token'ı alın

  1. 1

    Panelde lokasyonu oluşturun

    gatevision.app paneline girin, Lokasyonlar bölümünden kapının bulunduğu lokasyonu ekleyin.

  2. 2

    Edge cihazı için token üretin

    Ayarlar › Edge Cihazları › Yeni cihaz ekle ile lokasyonu seçip token oluşturun. Token gv_… ile başlar, 24 saat geçerlidir ve tek kullanımlıktır.

Windows kurulumu

  1. 1

    İndirin ve çalıştırın

    GateVisionAgent.exe dosyasını indirin ve çift tıklayın (ZIP sürümü de aynı dosyayı içerir).

    Program kendini C:\GateVision klasörüne kopyalar, masaüstüne ve Başlangıç klasörüne kısayol ekler, ardından oradan yeniden başlar. Bu adım bir kez yapılır.

    Windows SmartScreen "Tanınmayan yayımcı" uyarısı verebilir. Daha fazla bilgi › Yine de çalıştır seçin. Dosya kendinden imzalıdır; kurumsal antivirüs kullanıyorsanız C:\GateVision klasörünü istisnaya ekleyin.
  2. 2

    Panel tarayıcıda açılır

    Kurulum bitince tarayıcı otomatik açılır. Açılmazsa görev çubuğunun sağ altındaki Gate Vision simgesine sağ tıklayıp Paneli Aç seçin. Panel adresi http://127.0.0.1:8765 şeklindedir ve yalnızca bu bilgisayardan erişilir.

  3. 3

    Panele kaydedin

    Açılan Kurulum ekranında API adresi https://gatevision.app/api/v1 olarak gelir. Aldığınız token'ı yapıştırıp Kayıt Ol tıklayın. Cihaz lokasyona bağlanır ve liste önbelleği indirilir.

  4. 4

    Kameraları tanımlayın

    Yönetim › Kameralar › Kamera Bul ile USB ve ağdaki ONVIF/RTSP kameralar taranır. Bulunan kamerada Test & Ekle tıklayın; yönü (Giriş/Çıkış) seçin. Manuel eklemede RTSP adresi şu biçimdedir:

    rtsp://KULLANICI:SIFRE@192.168.1.10:554/stream1

    Plaka karede küçük kalıyorsa Okuma Alanı ile yalnızca aracın durduğu bölgeyi çizin; hem isabet artar hem CPU düşer.

  5. 5

    Bariyeri bağlayın

    Yönetim › Bariyer › Röle Bul USB röleyi COM portuyla, ağ rölesini IP'siyle listeler. Seçip Test Et ile röleyi tıklatın, ardından Bariyer kontrolü aktif ve Beyaz listedeki araçlar için otomatik aç seçeneklerini açıp kaydedin. Donanım yoksa Simülasyon tipi ile akışı deneyebilirsiniz.

  6. 6

    Deneyin

    Operatör ekranında F2 ile plaka girip kararı görün; kameraya plakayı gösterince kutu ve sonuç anında çıkar. Beyaz listedeki araç bariyeri açar, kara liste alarm verir. Geçişler bulut panelinde birkaç saniye içinde görünür.

Dosyalar

  • Program: C:\GateVision\GateVisionAgent.exe
  • Ayarlar: %USERPROFILE%\.gatevision\config\settings.json
  • Loglar: %USERPROFILE%\.gatevision\logs\agent.log
  • Plaka görüntüleri: %USERPROFILE%\.gatevision\captures

Otomatik başlatma

Başlangıç klasöründeki kısayol sayesinde bilgisayar açılıp kullanıcı oturumu başladığında agent kendiliğinden çalışır. Kapı bilgisayarında otomatik oturum açma ayarlayın; böylece elektrik kesintisi sonrası müdahale gerekmez. Kaldırmak için C:\GateVision\uninstall.bat.

macOS kurulumu

macOS için hazır paket henüz yayınlanmıyor; kurulum kaynak koddan tek komutla yapılır ve geliştirme/test ortamı için önerilir. Sahada Windows veya Linux mini PC kullanın.
  1. 1

    Gereksinimler

    macOS 13+, Python 3.11 veya üzeri, Git. Homebrew ile:

    brew install python@3.12 git
  2. 2

    Kaynak kodu alın ve kurun

    git clone https://github.com/kalismeras61/gate-vision.git
cd gate-vision/apps/edge-client
./install.sh

    Betik sanal ortamı oluşturur, bağımlılıkları yükler ve --selfcheck ile modelleri doğrular. İlk çalıştırmada plaka modelleri (~30 MB) indirilir.

  3. 3

    Çalıştırın

    cd gate-vision/apps/edge-client
source venv/bin/activate
python -m agent --no-tray --open-browser

    Tarayıcı açılır; Kurulum ekranında token ile kaydolun. macOS ilk seferde Kamera izni ister; Terminal için izin verin (Sistem Ayarları › Gizlilik ve Güvenlik › Kamera). Donanım yoksa --relay simulated ekleyin.

  4. 4

    Oturum açılışında otomatik başlatma (isteğe bağlı)

    ./install.sh --service      # LaunchAgent kurar, çökerse yeniden başlatır
./installer/macos/install-launchagent.sh --uninstall   # kaldırmak için

    Panel adresi ve giriş anahtarı ~/.gatevision/agent.json dosyasındaki loginUrl alanındadır.

Linux / Raspberry Pi

Aynı adımlar geçerlidir; ./install.sh --service systemd servisi kurar (/opt/gatevision, veri /var/lib/gatevision). USB röle için kullanıcıyı dialout grubuna ekleyin.

İnternet kesilirse ne olur?

Okuma ve karar devam eder

Beyaz/kara listeler cihazda saklanır; karar 1 ms içinde yerelde verilir, bariyer açılır.

Geçişler kuyruğa alınır

Her geçiş cihazda kaydedilir. Ekranda ÇEVRİMDIŞI ve bekleyen sayısı görünür.

Bağlantı gelince senkron

Kuyruk otomatik gönderilir, çift kayıt oluşmaz. Panelde yapılan liste değişiklikleri 30 sn içinde cihaza iner.

Bariyer bağlantısı (Nice, BFT, CAME, FAAC)

Gate Vision bariyeri kuru kontakla kumanda eder: röle çıkışı, kumanda kartının komut girişindeki iki ucu yaklaşık bir saniye kısa devre yapar. Bu, kartlı sistemlerin kullandığı yöntemin aynısıdır; motor kartında ayar değişikliği gerekmez. Fotosel, emniyet kenarı ve loop dedektör bariyerin kendi kartında kalır, güvenlik devresine dokunulmaz.

MarkaAçma için kullanılacak girişKol konumu için çıkış
Nice (Wide, M-Bar, Signo, Robus)P.P. (adım adım) ya da Open girişiSCA — kapı açık gösterge çıkışı (Oview / DIP ile seçilir)
BFT (Giotto, Moovi, Michelangelo)START ya da OPEN girişiSCA / programlanabilir AUX çıkışı
CAME (Gard, G serisi)Aç-kapa komut girişi (klasik kartlarda 2-7)Gösterge lambası çıkışı (klasik kartlarda 10-E)
FAAC (615, 620, B614/B680)OPEN A girişiW1 / kapı açık gösterge çıkışı
Magnetic, Beninca, Roger ve diğerleriImpuls / Open / Start etiketli girişKapı açık gösterge ya da limit switch çıkışı

Klemens numaraları kart modeline ve üretim yılına göre değişir. Kartın kılavuzunda yukarıdaki işlevi bulun, numaraya göre değil işleve göre bağlayın.

Röle seçimi ve darbe

Potansiyelsiz (kuru kontak) röle kullanın, 5 A ve üzeri yeterlidir. Darbe süresi 0,5-1 saniye olmalı. Yönetim › Bariyer › Açık kalma süresi alanından ayarlanır; süre biterse röle kendi kapanır, bariyeri kapatan motor kartıdır.

Kol konumu girişi

Gösterge çıkışı çoğunlukla 24 V lamba çıkışıdır, doğrudan Raspberry Pi girişine bağlanmaz. Araya küçük bir röle veya optokuplör koyup kuru kontağı GPIO girişi ile GND arasına verin. Ayarlarda 'Aktif düşük' açık kalsın.

İkinci kanal

Aynı noktada ikinci bariyer, yaya kapısı ya da ikaz lambası varsa Yönetim › Bariyer › Röle kanalları bölümünden kanal ekleyin. Kamera ayarında kanal seçerseniz o kamera kendi kanalını tetikler.

Kol konumu bağlanınca ne kazanırsınız

Kiosk kolun gerçek konumunu gösterir. Açma komutundan sonra kol kalkmazsa ekranda arıza uyarısı çıkar ve panele bildirim gider; kol açık kalırsa yine uyarılırsınız. Araç geçerken kol zaten açıksa gereksiz röle darbesi gönderilmez. Ayar: Yönetim › Bariyer › Kol konum sensörü.

Sorun giderme

Tarayıcı 'Yetkisiz erişim' diyor

Paneli tepsi simgesindeki 'Paneli Aç' ile veya agent.json içindeki loginUrl ile açın; adres tek kullanımlık giriş anahtarı içerir.

Kamera bulunuyor ama görüntü yok

RTSP adresini, kullanıcı adı/şifreyi ve kameranın aynı ağda olduğunu kontrol edin. Kamera Bul › Test ile doğrulayın. USB kamerayı başka bir program kullanıyor olabilir.

Plaka okunmuyor / yanlış okunuyor

Plaka karede çok küçük olabilir: kamerayı yaklaştırın veya Okuma Alanı çizin. Yönetim › Ayarlar › Plaka Tanıma Kalitesi'nde dedektörü yolo-v9-t-512 veya s-608, OCR'ı cct-s-v2 seçin. Gece için IR aydınlatma gerekir.

Aynı araç ikinci kez okunmuyor

Bu tasarım gereğidir: aynı plaka 5 sn boyunca tek geçiş sayılır (Ayarlar › Aynı plaka tekrar penceresi).

Bariyer açılmıyor

Yönetim › Bariyer › Test Et ile röleyi doğrulayın. Kameranın 'Bariyer: Manuel' modunda olmadığından ve 'Otomatik aç' seçeneğinin açık olduğundan emin olun. USB rölede COM port numarası değişmiş olabilir.

Bulut ÇEVRİMDIŞI görünüyor

İnternet ve https://gatevision.app erişimini kontrol edin. Ayarlar › Bağlantıyı Test Et. Kayıt token'ı yenilendiyse cihazı yeniden kaydedin.

Log dosyası nerede?

Windows: %USERPROFILE%\.gatevision\logs\agent.log — macOS/Linux: ~/.gatevision/logs/agent.log. Panelde Yönetim › Loglar bölümünden de indirilebilir.