Konsulatets skärm

Detta är kod som utvecklats av F.dev för att styra skärmen som hänger i konsulatet. Koden är skriven för att användas på en Raspberry Pi-en med stöd från servern som hemsidan ligger på för att uppdatera data. Om du har några frågor eller funderingar så är det bara att skicka ett mejl till [email protected].

Table of Contents Installation Installera med setup.sh Manuell installation Frontend Backend Användning Frontend Backend

Installation

Installationsguiden är skriven för dig som kör ett linux-baserat operativsystem.

Installera med setup.sh

Vi har skapat en installationsfil som heter setup.sh. För att installera programvaran extraherar du filerna på valfri plats och noterar sökvägen dit, your-path. Därefter öppnar du terminalen och navigerar till ~/your-path/kons-screen/ och kör följande kod:

    ./setup.sh

Om installationen inte lyckades så följer du instruktionerna från terminalen så löser det sig.

Manuell installation

Under installation skrivs kod som ska exekveras i terminalen såhär:

*EXECUTABLE-CODE*

Följande instruktioner förutsätter att python är av version python3.4+. Kolla din python-version med:

python --version</code>

I vissa fall finner du python3 genom:

python3

Frontend

Om du inte redan har nodejs eller npm så kör du

sudo apt-get install nodejs
sudo apt-get install npm

För att sedan installera appen så går du in i frontend/ och kör:

npm install

Backend

För att installera alla dependencies till app.py så kan du köra kommandot

    pip3 install -r requirements.txt

Om kommandot pip3 inte känns igen så kör du samma kommando fast med pip istället. Om detta mot all förmodan inte skulle fungera så måste du först installera pip med

    sudo apt-get install python-pip

eller

sudo apt-get install python3-pip

Användning

Frontend

För att förhandsgranska index.html så måste du först gå till ~/your-path/kons-screen/frontend/ och köra:

npm start

Efter detta så serveras appen på localhost:3000. För att data ska fyllas i så måste du köraapp.py enligt instruktionerna nedan.

Backend

Det finns flera sätt att köra app.py på; du kan välja mellan att använda en lokal databas, eller att koppla upp dig mot https://f.kth.se och använda data som uppdateras regelbundet. För att använda en lokal databas så kör du kommandot:

python app.py

För att använda data från https://f.kth.se så kör du:

python app.py --remotedb

Datan i APIs/db/ är gammal så i vissa fall måste datan uppdateras manuellt för att den ska visas på frontend.

Ytterligare startalternativ till app.py är --debug som tillåter dig att spara ändringar och se dessa genom att bara uppdatera sidan istället för att behöva starta om app.py.

Exempelanvändning:

python app.py --debug --remotedb