AVLA İstasyon Kurulum Dokümantasyonu

English Version Ana Sayfa

Bu sayfa herkese açıktır. Yeni kurulum akışı, ortam değişkenleri ile otomatik konfigürasyon yapar ve iot-station systemd servisini kurar. Backend URL formatı: https://avla.talivio.com/api/v1.

1) İstasyona (Raspberry Pi) Bağlantı (SSH)

İstasyonunuza yerel ağ üzerinden bağlanın. Varsayılan kullanıcı adı çoğunlukla pi olur.

# mDNS ile
ssh pi@raspberrypi.local

# veya IP ile
ssh pi@<STATION_IP>

Kullanıcı adı ve portu gerekirse değiştirin.
İlk bağlantıda fingerprint onayı isteyebilir.

2) Hızlı Kurulum (Önerilen)

Aşağıdaki komutlardan birini kullanarak istasyonu tek adımda kurun. STATION_BASE_URL, STATION_ID, STATION_KEY değerlerini kendi istasyon bilgilerinizle değiştirin.

A) Raspberry Pi üzerinde (paketi otomatik indirir)

curl -L -o avla-station.zip https://avla.talivio.com/downloads/latest
unzip -q avla-station.zip -d avla-station
cd avla-station/station

# Otomatik konfigürasyon ile kurulum
sudo env \
  STATION_BASE_URL=https://avla.talivio.com/api/v1 \
  STATION_ID=<ISTASYON_ID> \
  STATION_KEY=<ISTASYON_KEY> \
  bash station/install.sh

İsteğe bağlı: SSH anahtarınızı otomatik eklemek için SSH_PUBKEY ekleyebilirsiniz.

A.1) Onboarding ile (login/register) otomatik kurulum

# LOGIN (mevcut hesap/workspace)
sudo env \
  STATION_BASE_URL=https://avla.talivio.com/api/v1 \
  INSTALL_MODE=login \
  INSTALL_EMAIL=<EMAIL> \
  INSTALL_PASSWORD=<SIFRE> \
  INSTALL_WORKSPACE_ID=<OPSİYONEL_ID> \
  INSTALL_WORKSPACE_NAME=<OPSİYONEL_AD> \
  INSTALL_STATION_NAME="My Station" \
  bash station/install.sh

# REGISTER (yeni hesap + workspace + station)
sudo env \
  STATION_BASE_URL=https://avla.talivio.com/api/v1 \
  INSTALL_MODE=register \
  INSTALL_WORKSPACE_NAME="My Workspace" \
  INSTALL_EMAIL=<EMAIL> \
  INSTALL_USER_NAME=<AD> \
  INSTALL_STATION_NAME="Station 1" \
  bash station/install.sh

B) Windows (PowerShell) üzerinden kopyala/kur (scp + ssh)

# Yerel Windows makinenizde (proje klasörü altında)
cd E:\Dropbox\Works\Talivio\avla-manager\station
$HOST = "pi@raspberrypi.local"   # kullanıcı@host/ip
$SID  = "<ISTASYON_ID>"
$SKEY = "<ISTASYON_KEY>"
$BASE = "https://avla.talivio.com/api/v1"

scp .\install.sh $HOST:/tmp/install.sh
ssh $HOST "sudo env STATION_BASE_URL=$BASE STATION_ID=$SID STATION_KEY=$SKEY bash /tmp/install.sh | cat"

3) Konfigürasyon

Kurulum sırasında ortam değişkenleri verildiyse config.json otomatik düzenlenir. Manuel kontrol/editleme için:

cat ~/avla-manager/station/config.json | jq .api
nano ~/avla-manager/station/config.json   # gerekirse

Backend URL: https://avla.talivio.com/api/v1
station_id ve station_key alanlarının paneldeki değerlerle uyumlu olduğundan emin olun.
Kamera ve I²C arayüzlerini sudo raspi-config ile etkinleştirin (Interface Options).

4) Servis ve Loglar

Kurulum, iot-station systemd servisini otomatik oluşturur ve başlatır.

systemctl status iot-station --no-pager || true
journalctl -u iot-station -n 200 --no-pager
# Canlı izleme
journalctl -u iot-station -f

Gerekirse foreground çalıştırma (debug): cd ~/avla-manager/station && source .venv/bin/activate && python main.py

5) Güncelleme (OTA ve Manuel)

OTA (Önerilen)

config.json → update.enabled=true, public_key ayarlı olmalı. İstasyon saatlik olarak yeni sürümü kontrol eder, imza ve SHA256 doğrulaması sonrası atomik güncelleme yapar.

Manuel Güncelleme (Alternatif)

# (Varsa) systemd servisini durdurun
sudo systemctl stop iot-station || true

# Geçici klasörde paketi indirip açın
mkdir -p /tmp/avla_update && cd /tmp/avla_update
curl -L -o avla-station.zip https://avla.talivio.com/downloads/latest
unzip -q avla-station.zip

# Yalnızca station klasörünü güncelleyin (mevcut yapı korunur)
cp -a avla-station/station/* ~/avla-manager/station/

# Bağımlılıkları güncelleyin
cd ~/avla-manager/station
source .venv/bin/activate
pip install -U pip setuptools wheel
pip install -r requirements.txt

# Servisi başlatın (systemd yoksa foreground çalıştırabilirsiniz)
sudo systemctl start iot-station || python main.py

Not: Güncellemeden önce ~/avla-manager klasörünü yedeklemeniz önerilir.

Sık Karşılaşılan Sorunlar

Servis görünmüyor: systemctl daemon-reload ardından sudo systemctl enable --now iot-station.
API bağlantı hatası: config.json → api.base_url mutlaka https://avla.talivio.com/api/v1 olmalı.
Kamera çalışmıyor: sudo raspi-config ile kamera arayüzünü etkinleştirin; kullanıcıyı video grubuna ekleyin.
I²C sensörleri görünmüyor: I²C arayüzünü etkinleştirin ve sudo i2cdetect -y 1 ile tarayın.
pip/venv hataları: python3-venv kurulu olmalı; sanal ortamı yeniden oluşturmayı deneyin.