AVLA Station Setup Guide

Türkçe Sürüm Home

This page is public. Follow the steps below for a quick setup over SSH. The stack is Windows + XAMPP friendly. Frontend uses jQuery + Bootstrap 5 only.

1) Connect to the Station (SSH)

Connect to your station over the local network. Default user is usually pi.

# via mDNS
ssh pi@raspberrypi.local

# or via IP
ssh pi@<STATION_IP>

Change username and port if needed.
First connect may ask for host key fingerprint confirmation.

2) Download the App Package

Download the latest signed versioned zip and extract it.

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

(Optional) SHA256 Integrity Check

Linux/macOS

sha256sum avla-manager.zip

Windows (PowerShell)

Get-FileHash .\avla-manager.zip -Algorithm SHA256

The hash must match the sha256 field for the corresponding version in https://avla.talivio.com/downloads/manifest.json.

3) Station (Raspberry Pi) Setup

Requires Python 3.9+. Run these on the Pi.

# One-shot auto install (run as root)
sudo bash station/install.sh

# Then adjust config
nano ~/avla-manager/station/config.json

Fill X-Station-Id and X-Station-Key in config.json.
Backend URL: https://avla.talivio.com/api/v1/

4) Start the Service

cd ~/avla-manager/station && source .venv/bin/activate && python main.py

In production, run the station as a systemd service.

5) Updates (OTA and Manual)

OTA (Recommended)

Ensure config.json → update.enabled=true and public_key is configured. The station checks hourly, verifies signature and SHA256, then applies atomic update.

Manual Update (Alternative)

# Stop systemd service (if any)
sudo systemctl stop iot-station || true

# Download and extract in a temp dir
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

# Update only the station folder (preserve current structure)
cp -a avla-station/station/* ~/avla-manager/station/

# Update dependencies
cd ~/avla-manager/station
source .venv/bin/activate
pip install -U pip setuptools wheel
pip install -r requirements.txt

# Start service (or run in foreground)
sudo systemctl start iot-station || python main.py

Note: Back up ~/avla-manager before manual updates.

Troubleshooting

Camera not working: Enable camera via raspi-config; add user to video group.
I²C devices missing: Enable I²C and scan with sudo i2cdetect -y 1.
pip/venv issues: Ensure python3-venv is installed; recreate the virtualenv.