WeatherHub

A small project to gather weather data from several weather stations, which are connected to a centralized server.

Attention: This project is still in development.

Server

The server handles all client-types of this project. It receives and stores measurements of weather-stations in a database. In addition to that, the server then also sends the saved data to data-visualizer-clients. They're responsible to the data-visualization.

Usage

In order to work, you have to create a server/.env-file with those values:

SERVER_HOST="localhost"
SERVER_PORT=1337
SERVER_SSL_KEYFILEPATH="ssl_files/keyfile_server.key"
SERVER_SSL_CERTFILEPATH="ssl_files/certfile_server.crt"
MAX_INCOMING_CONNECTIONS=10
MAX_MSG_CHUNK_SIZE=1024
SOCKET_BUFFER_SIZE=2048
LOG_DIRPATH="logs/"
LOG_FILENAME="weatherhub_server.log"
SERVER_SSL_KEYFILEPASSWORD=""
DATABASE_URI="sqlite:///instances/database.db"
RESPONSECODE_SEPARATOR="_#R#_"

Execute server-script manually:

python3 main.py

Admin-Client

This client is for managing the different weather-stations and to get an overview of the current operations on the server.

Usage

You need to create an environment-file - admin_client/.env:

TIMEZONE="UTC"
SERVER_CERTIFICATE_FILEPATH="ssl_files/certfile_server.crt"
CLIENT_CERTIFICATE_FILEPATH="ssl_files/certfile_client.crt"
CLIENT_KEYFILE_PATH="ssl_files/keyfile_client.key"
CLIENT_KEYFILE_PASSWORD=""
CLIENT_USERNAME=""
CLIENT_PASSWORD=""
DEFAULT_MAX_MSG_CHUNK_SIZE=1024
DEFAULT_BUFFER_SIZE=1024
RESPONSECODE_SEPARATOR="_#R#_"

To connect to the server, execute the script like that:

python3 admin_client -s localhost -p 1337

Weather-Station-Client

This client sends weather-measurements to the server.

Usage

You need to create an environment-file - weather_station_client/.env:

TIMEZONE="UTC"
SERVER_HOST="localhost"
SERVER_PORT=1337
SERVER_CERTIFICATE_FILEPATH="ssl_files/certfile_server.crt"
CLIENT_CERTIFICATE_FILEPATH="ssl_files/certfile_client.crt"
CLIENT_KEYFILE_PATH="ssl_files/keyfile_client.key"
CLIENT_KEYFILE_PASSWORD="lol1234"
CLIENT_USERNAME="test_station_user"
CLIENT_PASSWORD="lol1234"
DEFAULT_MAX_MSG_CHUNK_SIZE=1024
DEFAULT_BUFFER_SIZE=1024
RESPONSECODE_SEPARATOR="_#R#_"
LOG_DIRPATH="logs/"
LOG_FILENAME="weather_station_client.log"
WEATHER_STATION_NAME="Test Station"

As you can see, the weather-station-clients needs a WEATHER_STATION_NAME which is the actual name of the weather-station in the database. For that, the weather-station has to be registered in the database. You can do that with the admin_client.

To execute the script, it can be done like that:

python3 weather_station_client.py

Key- & Certfile generation

In order to work, both, the client and the server need a self-signed certificate and a keyfile to establish a TLS-encrypted connection. You could to that by using the openssl software:

# Generate keyfile
openssl genpkey -algorithm RSA -out keyfile_server.key -aes256

# Generate certificate signing request (CSR) - Fill in your data.
openssl req -new -key keyfile_server.key -out server.csr \
    -subj "/C=DE/ST=BIELEFELD/L=BIELEFELD/O=BIELEFELD GmbH/CN=localhost"

# Generate self-signed certificate
openssl x509 -req -days 365 -in server.csr -signkey keyfile_server.key -out certfile_server.crt

For the CSR you have to fill in your data. It's important that the CN-field-value is the server-hostname. And obviously adjust the filepaths of your SSL-files.