sticker-central

This is the central server application for managing HARDWARIO STICKER devices. It provides functionalities such as device configuration.

The application provides the HTTPS server with the WebSocket interface for STICKER devices to connect and receive configuration data. The web server hosts static HTML application which connects to the WebSocket server to manage STICKER devices. The HTML application writes configuration data to the STICKER devices over the NFC interface (using the Web NFC API).

The web application works only on the Android platform with Chrome browser due to the Web NFC API limitations.

Requirements

• Python 3.11+
• SQLite3
• Protocol Buffers compiler (protoc)
• Tool uv for managing virtual environments

Installation

Initialize the virtual environment and install dependencies:

uv sync

Copy template configuration file:

cp config.yaml.template config.yaml

Initialize the database:

sqlite3 sticker.db < sticker.sql

Running

Start the application with:

uv run -m sticker_central

Create the secure tunnel with QR code:

ssh -p 443 -R0:localhost:5555 [email protected]

Update gRPC schema

Switch to the protobuf directory:

cd protobuf

Run the Protocol Buffers compiler to generate Python code:

protoc --python_out=. nfc_config.proto

Note: The nfc_config.proto file must match the one found in the sticker-firmware repository.