Program VideoWind jest aplikacją serwerową działającą w systemie operacyjnym Debian. Umożliwia zdalny dostęp do obrazu z kamery (USB) i odczyt z czujników temperatury (DS18B20) za pośrednictwem przeglądarki internetowej. Dane z czujników odczytywane są automatycznie i zostają archiwizowane w bazie danych, co umożliwia ich późniejszą analizę.
Aplikacja przechodziła ewolucję przez wiele lat w ramach projektu “Stacja monitorująca na bazie Raspberry Pi” i została zaprojektowana z myślą o tym jednopłytkowym komputerze.
Raspberry Pi – Uruchomienie magistrali 1Wire
System operacyjny Linux daje możliwość podłączenia magistrali 1Wire bezpośrednio do wyprowadzeń procesora, te natomiast w komputerze Raspberry Pi są dostępne na złączach szpilkowych – GPIO.
Abstrakcja warstwy sprzętowej w Linux jest bardzo wygodna, urządzenia są plikami. Również i urządzenia podłączone do magistrali 1Wire będą widziane w systemie jako pliki. By włączyć obsługę 1Wire w Raspberry Pi wystarczy uruchomić konfigurator poleceniem sudo raspi-config a potem wybrać z menu “Interfacing Options” i w następnej kolejności “I2C – Enable/Disable automatic loading of I2C kernel module” wybierając “Enable“. Po skonfigurowaniu i ponownym uruchomieniu każdy dołączony do magistrali czujnik reprezentowany jest poprzez katalog w lokalizacji /sys/bus/w1/devices o nazwie będącej połączeniem kodu rodziny układu i jego numeru identyfikacyjnego.
Instalacja VideoWind
Program dostępny jest w Repository.NoweEnergie.org w postaci archiwum ZIP, jednak jego instalacja powinna zostać przeprowadzona za pomocą skryptu instalacyjnego (również do pobrania z repozytorium).
W konsoli z poziomu root należy wejść do katalogu w którym ma zostać zainstalowany program a następnie wykonać:
wget http://repository.noweenergie.org/Repo/python/videowind/install.sh
sudo chmod +x install.sh
sudo sh install.sh
Po pobraniu skryptu instalacyjnego i nadaniu mu praw do wykonywania nastąpi uruchomienie instalacji.
Pierwszym krokiem będzie pobranie potrzebnych pakietów, między innymi python, python-serial i innych. W tym celu na pytanie:
“Dokonac sprawdzenia czy system posiada potrzebne biblioteki i programy? [y]es / [n]o”
należy kliknąć “y” i potwierdzić enterem.
Następnie instalator pobierze archiwum ZIP zawierające program VideoWind i rozpakuje pliki.
Kolejnym krokiem jest konfiguracja programu. Na pytanie:
“Czy konfigurowac teraz program? [y]es / [n]o”
należy odpowiedzieć “y” i kliknąć enter.
Parametry które należy zdefiniować zostały opisane w punkcie “Konfiguracja VideoWind”.
Zapisanie odbywa się po kliknięciu CTRL+o a wyjście z edytora po kliknięciu CTRL+x.
Końcowym etapem instalacji jest pytanie:
“Czy program ma automatycznie startowac z systemem? [y]es / [n]o”
należy podać odpowiedź zgodnie z potrzebami.
Odpowiedź twierdząca powoduje dodanie do pliku /etc/crontab linijki:
@reboot root python server.py start
Konfiguracja VideoWind
Plik konfiguracyjny “config.ini” znajduje się w folderze “config”.
Sekcja “SERVER” konfiguruje ogólne ustawienia programu:
- SCRIPT_PATH – ścieżka w której znajduje się skrypt “server.py”, jest ona automatycznie ustawiana w trakcie instalacji,
- PORT – port na którym zostanie uruchomiony serwer (domyślnie 81), po podaniu adresu IP w przeglądarce internetowej należy podać numer portu np. 10.0.0.1:81,
- DEBUG – włączenie (true) lub wyłączenie (false) raportowania błędów (wyświetlane w konsoli),
- PASSWORD – hasło podawane by uzyskać dostęp w przeglądarce internetowej.
Sekcja “CAMERA” konfiguruje parametry obrazu z kamery:
- CAMID – kamera widoczna jest jako plik przykładowo /dev/video0 w pliku konfiguracyjnym zapisywana jako 0,
- FPS – klatek na sekundę np. 30,
- FRAME_WIDTH – szerokość obrazu (zgodnie z możliwościami kamery) np. 480,
- FRAME_HEIGHT – wysokość obrazu (zgodnie z możliwościami kamery) np. 640,
- PACKET_DELAY – definicja przerwy (w sekundach) między klatkami obrazu MJPEG np. 1,
- JPEG_QUALITY – kompresja JPG (w procentach) np. 90.
Sekcja “TEMPERATURE”:
- READ_INTERVAL – definiuje co ile minut nastąpi odczyt temperatury z czujnika np. 30,
- NRSENSOR – numer czujnika podłączonego do magistrali 1Wire z którego odczytywana jest temperatura zewnętrzna np. 0.
Sekcja “UART” obsługa np. modułu TTMSB:
- PORT – definiuje port na którym dostępny jest moduł np. ACM0.
Uruchomienie VideoWind
Jeśli w trakcie instalacji wybrano automatyczny start, po włączeniu urządzenia i załadowaniu systemu również zostanie uruchomiony program.
Dzieje się to za sprawą skryptu:
@reboot root python server.py start
dołączonego do pliku /etc/crontab.
By uruchomić program z konsoli należy wejść jako root do folderu w którym znajduje się skrypt server.py i wydać polecenie:
sudo python server.py start
Natomiast zatrzymanie programu odbywa się po instrukcji:
sudo python server.py stop
W przypadku błędnego zakończenia działania programu przydatnym może okazać się uruchomienie skryptu:
sudo sh run.sh
Kasuje on tymczasowe pliki i uruchamia serwer.
Baza danych
Z poziomu przeglądarki internetowej istnieje możliwość zapisania obrazu, jest on dostępny w folderze “archive”.
Miejsce to zawiera również pliki bazy danych:
- dbase.db – ogólne ustawienia programu,
- temperature.db – archiwum pomiarów temperatury.
Praca w programie
Po wpisaniu w przeglądarce adresu który przypisany jest do urządzenia na którym został uruchomiony program należy podać numer portu (w przypadku innego niż 80) np. 10.0.0.1:81. W trakcie pierwszego uruchomienia pojawia się okno logowania.
Główne okno programu wyświetla zdjęcie z kamery oraz menu główne i ostatni odczyt temperatury.
Główne okno programu VideoWind.
Po kliknięciu “wykres temperatury” wyświetlana jest historia odczytów temperatury. Wymagane jest połączenie z siecią Internet, gdyż wykres tworzony jest przez jsapi google.
Wykres odczytów temperatury.