preOmloxServer 🛰️

• Author: Emil Sedlacek @ FHSTP
• Purpose: RFID-JSON → Omlox Gateway for forwarding reader and tag data to DeepHub
• Version: 0.3 (2025-11-13)
• License: MIT

---

🧾 Overview

preOmloxServer is a Python-based gateway that receives RFID data in JSON format, converts it to the Omlox specification, and forwards it via the Omlox REST API to a DeepHub server.

✨ Features

• Converts RFID JSON into Omlox-compliant data.
• Creates/updates location providers, zones, and trackables.
• Encapsulated design including an adaptable Omlox client.
• Encapsulable into docker-container.

⚠️ Known Limitation

• Performance: Runs single-threaded, relying on a basic HTTP server and client.

🙌 Credits

• Based on an omloxoridentcontrol implementation by Pepperl+Fuchs, significantly extended here.

---

⚙️ Requirements

• Docker 3.8+
• Python 3.13+
  • Dependencies listed in requirements.txt

---

🐳 Docker Usage

🛠 Build Image

docker build -t preomloxserver .

▶️ Run with Environment Variables

docker run -p 8082:8082 preomloxserver -o https://logitraak.media.fhstp.ac.at/deephub/v2

🔄 Internal Parameters

Script / CLI Parameters

• -c preOmloxServerSettings.json → fixed in entrypoint.sh (containerized)
• -o http://127.0.0.1:7081/v2 → customizable endpoint

Environment Variables

• PYTHONUNBUFFERED=1
• LOGLEVEL_MIDDLEWARE=DEBUG
• OMLOX_URL=http://127.0.0.1:7081/v2 → takes precedence over -o
• PREOMLOX_SERVER_LAZY_GPS=TRUE → enables creation of location providers with GPS (intentionally run locally because buggy, needs restart of server when changing GPS locations)
• LOG_DATA=TRUE → Logs data to CSV - might slow down over time.

---

🧰 Docker Compose Example

version: '3.8'

services:
  preomlox:
    image: preomloxserver:latest
    container_name: preomlox
    ports:
      - "8082:8082"
    environment:
      PYTHONUNBUFFERED: "1"
      LOGLEVEL_MIDDLEWARE: "DEBUG"
      OMLOX_URL: "http://192.168.0.100:7081/v2"
      PREOMLOX_SERVER_LAZY_GPS: "1"
      LOG_DATA: "1"

Run:

docker compose up -d

---

📌 Version History

• 0.1 – Functional prototype
• 0.2 – Bugfixes
• 0.3 - Datalogger added