NeoHub Control Dashboard

A Streamlit-based dashboard for monitoring and controlling NeoHub heating systems. This application provides a user-friendly interface for managing multiple NeoHub devices, zones, and power sockets.

System Architecture

graph TD
    A[User] -->|Login| B[Streamlit Dashboard]
    B -->|API Requests| C[NeoHub API]
    C -->|Device Data| B
    B -->|Display| D[Zone Control]
    B -->|Display| E[Matrix View]
    B -->|Display| F[Data Export]
    B -->|Display| G[System Overview]
    
    subgraph Devices
        C -->|Control| H[Thermostats]
        C -->|Control| I[Power Sockets]
    end
    
    subgraph Data Processing
        B -->|Process| J[Temperature Data]
        B -->|Process| K[Status Updates]
        B -->|Generate| L[Alerts]
        B -->|Export| M[CSV/Excel]
    end

Loading

Component Architecture

classDiagram
    class NeoHub {
        +login()
        +get_data()
        +set_temperature()
        +set_mode()
        +set_away_mode()
        +get_history()
    }
    
    class Device {
        +deviceid
        +devicename
        +online
        +type
        +version
    }
    
    class Zone {
        +ZONE_NAME
        +ACTUAL_TEMP
        +SET_TEMP
        +HEAT_ON
        +HEAT_MODE
        +RELATIVE_HUMIDITY
    }
    
    class Dashboard {
        +ZoneControl
        +MatrixView
        +DataExport
        +SystemOverview
    }

    Dashboard --> NeoHub : Uses
    NeoHub --> Device : Controls
    Device --> Zone : Contains
    Dashboard --> Zone : Displays

Loading

Data Flow

sequenceDiagram
    participant U as User
    participant D as Dashboard
    participant A as NeoHub API
    participant T as Thermostats
    participant S as Sockets

    U->>D: Login
    D->>A: Authenticate
    A->>D: Return Token
    
    loop Every Update
        D->>A: Request Device Status
        A->>T: Poll Thermostats
        A->>S: Poll Sockets
        T->>A: Temperature Data
        S->>A: Power Status
        A->>D: Device Data
        D->>U: Update Display
    end

    U->>D: Control Action
    D->>A: Send Command
    A->>T: Update Settings
    A->>S: Update Settings
    A->>D: Confirm Changes
    D->>U: Show Result

Loading

Features

• Zone Control

  • Temperature monitoring and control
  • Mode selection (Heat/Cool/Vent)
  • Real-time status updates
  • Support for both thermostats and power sockets

• Matrix View

  • Comprehensive overview of all zones
  • Status indicators for heating, windows, batteries
  • Customizable sorting and filtering
  • Export capabilities (CSV/Excel)

• Data Export

  • Detailed zone information
  • Multiple export formats
  • Customizable data selection

• System Overview

  • Device status monitoring
  • Temperature visualization
  • Problem detection and alerts
  • Performance metrics

Installation

1. Clone the repository:

git clone https://github.com/GitDakky/NeoHub-Control.git
cd NeoHub-Control

2. Install dependencies:

pip install -r requirements.txt

Usage

1. Run the Streamlit app:

streamlit run app.py

2. Open your browser and navigate to the provided URL (typically http://localhost:8501)

3. Log in with your NeoHub credentials

Status Indicators

The dashboard uses the following indicators to show device status:

• 🔥 Heating active
• 🪟 Window open
• 🔋 Low battery
• ⚠️ Invalid reading
• ✓ Normal operation

Device Types

The system supports two types of devices:

• Thermostat: Temperature control and monitoring
• Socket: Power socket control (no temperature readings)

Requirements

• Python 3.8 or higher
• NeoHub account and devices
• Internet connection

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

DAK

Acknowledgments

• NeoHub API
• Streamlit framework
• Python community