Smart Socket Final Version

EcoLab Dashboard - Smart Laboratory Management System

EcoLab Dashboard - DTEDI Electronics Laboratory Internship 2025 x Final Project
Author: Stephanus Kevin Andika Rata
Internship Hardware (Smart AC & Lamp): Ilham Purnomo

Project Overview

EcoLab Dashboard is a Smart Laboratory Management System desktop application built with PySide6 (Qt) and Firebase Authentication to monitor and control laboratory devices in real time.

The system currently supports:

• EcoLab Power Monitoring (Growatt)
• Smart Socket
• Smart Lamp
• Smart AC Control
• Weather Station Monitoring
• Laboratory sensor and device status monitoring

Main Features

• Firebase Authentication: email/password, Google Sign-In, and Guest Mode
• Role-based Access Control: guest, user, and admin
• Session Management: remember-me support
• Admin Panel: laboratory user account management
• Smart Socket Control: relay, timer, schedule, and energy monitoring
• Smart Socket Safety Protection: load warning, overload popup, and automatic cutoff
• Smart Socket Power-Off Protection: admin-configured blocked/password mode with Firebase sync
• Smart Socket Recording: store monitoring data in application memory
• Smart Socket Export: export per-socket data to CSV
• Smart Socket Graph: per-socket monitoring charts inside the control popup
• EcoLab Power Monitoring: Growatt inverter monitoring on page 1
• Weather Station Monitoring: laboratory weather data monitoring
• Smart Lamp Control
• Smart AC Control
• Windows 11 Dark Mode Handling: light theme enforcement for key widgets

Technology Stack

Frontend

• PySide6 (Qt6)
• Python 3.10+
• PySide6.QtCharts for Smart Socket charts

Backend / Services

• Firebase Authentication
• Pyrebase4
• MQTT (paho-mqtt) for IoT device communication
• Growatt data integration for inverter monitoring
• Weather data integration for Weather Station monitoring
• Google Cloud / OAuth config for Google login

Hardware

• Growatt Inverter for EcoLab Power Monitoring
• ESP32-C3 for Smart Socket
• Wemos D1 Mini for Smart Lamp and Smart AC
• PZEM-004T v3.0 for Smart Socket energy monitoring
• DS1302 RTC for Smart Socket timer and schedule
• PCB Smart AC & Smart Lamp designed by Ilham Purnomo (KiCad)

Installation

Prerequisites

Python 3.10 or higher

Install dependencies

pip install -r requirements.txt

Runtime configuration

The application needs four external setup areas:

1. Firebase web configuration in .env
2. Google OAuth client credential in credentials/client_secret.json
3. MQTT TLS certificate in credentials/ca.crt or credentials/ca2.crt
4. Growatt account credential in .env

See credentials/README.md for the detailed credential guide.

Firebase setup

1. Create or open the EcoLab project in Firebase Console.
2. Enable Authentication for Email/Password.
3. Enable Google Sign-In in Firebase Authentication if you want Google login.
4. Copy the Firebase web app values into the root .env file.
5. Generate a service account key and place it in credentials/firebase_service_account.json.

Example Firebase web config values:

{
  "apiKey": "YOUR_API_KEY",
  "authDomain": "YOUR_PROJECT.firebaseapp.com",
  "databaseURL": "https://YOUR_PROJECT.firebaseio.com",
  "projectId": "YOUR_PROJECT_ID",
  "storageBucket": "YOUR_PROJECT.appspot.com",
  "messagingSenderId": "YOUR_SENDER_ID",
  "appId": "YOUR_APP_ID"
}

Required .env keys:

ECOLAB_FIREBASE_API_KEY=
ECOLAB_FIREBASE_AUTH_DOMAIN=
ECOLAB_FIREBASE_DATABASE_URL=
ECOLAB_FIREBASE_PROJECT_ID=
ECOLAB_FIREBASE_STORAGE_BUCKET=
ECOLAB_FIREBASE_MESSAGING_SENDER_ID=
ECOLAB_FIREBASE_APP_ID=
ECOLAB_FIREBASE_SERVICE_ACCOUNT=

Notes:

• Leave ECOLAB_FIREBASE_SERVICE_ACCOUNT empty if you use credentials/firebase_service_account.json.
• Fill ECOLAB_FIREBASE_SERVICE_ACCOUNT only if the service account file is stored somewhere else.

Google OAuth setup

Google Sign-In does not use only Firebase settings. It also needs a Google OAuth client JSON file.

Prepare:

• credentials/client_secret.json

Steps:

1. Open Google Cloud Console.
2. Select the same Google Cloud project linked to EcoLab.
3. Go to APIs & Services -> Credentials.
4. Create or open the OAuth client used by the app.
5. Download the client JSON.
6. Rename it to client_secret.json.
7. Place it inside the credentials/ folder.

If Google Sign-In fails, the first thing to verify is whether credentials/client_secret.json matches the active Google Cloud project.

MQTT TLS setup

MQTT communication for the IoT devices uses TLS and requires a CA certificate file.

Prepare:

• credentials/ca.crt as the default CA certificate
• credentials/ca2.crt as an optional backup CA certificate for some simulator or broker setups

Required .env keys:

ECOLAB_MQTT_BROKER=
ECOLAB_MQTT_PORT=8883
ECOLAB_MQTT_USERNAME=
ECOLAB_MQTT_PASSWORD=
ECOLAB_MQTT_CA_CERT=credentials/ca.crt
ECOLAB_MQTT_USE_TLS=true

What to prepare for MQTT TLS:

1. MQTT broker hostname or IP
2. MQTT username and password
3. TLS-enabled MQTT port, usually 8883
4. CA certificate file, usually credentials/ca.crt
5. Fallback CA certificate if your simulator or broker setup uses ca2.crt

Notes:

• main.py defaults to credentials/ca.crt when ECOLAB_MQTT_CA_CERT is not overridden.
• Some simulator files in hardware_TA/ still point to ca2.crt, so keep both certificate files available unless you are standardizing them.
• Do not embed certificate contents directly into the firmware.

Growatt setup

Dashboard startup currently initializes the Growatt panel during MainWindow creation, so these .env keys are required when opening the dashboard:

ECOLAB_GROWATT_USERNAME=
ECOLAB_GROWATT_PASSWORD=

Notes:

• Use the same Growatt account that has access to the target storage/inverter plant.
• If the account has no accessible plant or storage device, the Growatt panel will fail during startup.

Minimum files checklist

Before running the app, make sure these files exist:

.env
credentials/client_secret.json
credentials/firebase_service_account.json
credentials/ca.crt

Optional but recommended:

credentials/ca2.crt

Minimum required .env groups for a full dashboard launch:

• Firebase web config keys
• MQTT connection keys
• Growatt account keys

Usage

Run the application

python launcher.py

Authentication options

1. Email Login
   Sign in with email and password.
2. Google Sign-In
   Sign in with a Google account.
3. Guest Mode
   Read-only access without device control.

User roles

Smart Socket Updates

The current Smart Socket feature set includes:

• Per-socket relay ON/OFF control
• Per-socket timer
• Start/stop schedules with daily and onetime modes
• Monitoring for Voltage, Current, Power, Energy, Frequency, PF
• Control popup with Control, Data, Graph, Warning, and Setting tabs
• Per-socket monitoring data recording
• Configurable recording interval from the popup
• Follow Schedule option to automatically start recording when a schedule becomes active
• Autosave CSV when schedule-based recording ends
• Load warning levels for elevated, high, and critical current
• Light warning popup for elevated load with cooldown control
• Critical overload protection with user response popup, grace period, and automatic relay cutoff
• Automatic schedule clearing before forced OFF when overload protection is triggered during an active schedule
• Admin-only Smart Socket Setting tab inside the popup to configure power-off protection per socket
• Power-off protection modes: Blocked and Password required
• Protection configuration stored in Firebase Realtime Database so it can be shared across multiple PCs
• Per-socket CSV export
• Per-socket charts with selectable metrics
• Table and chart refresh only while recording is active

Implementation notes:

• The Python Smart Socket simulator has been aligned with the latest firmware concept.
• Firmware files from smartsocket2.ino to smartsocket5.ino were derived from smartsocket.ino with adjusted MQTT topics.

Project Structure

The current project structure after refactoring is:

Aplikasi EcoLab -  New/
|-- launcher.py
|-- loginmain.py
|-- main.py
|-- create_admin.py
|-- README.md
|-- requirements.txt
|-- build.bat
|-- .env.example
|-- auth/
|   |-- auth_service.py
|   `-- session_manager.py
|-- config/
|   |-- firebase_settings.py
|   |-- login_settings.py
|   `-- path_utils.py
|-- dialogs/
|   |-- admin_window.py
|   `-- smartsocket_popup.py
|-- services/
|   |-- smartsocket_recorder.py
|   |-- smartsocket_protection_store.py
|   `-- smartsocket_settings_manager.py
|-- app/

Architecture Overview

Entry Flow

• launcher.py is the main application entry point.
• It loads any saved session through auth/session_manager.py.
• If a valid session exists, it opens the main dashboard.
• Otherwise, it opens loginmain.py.

Authentication Layer

• auth/auth_service.py handles Firebase authentication and user records.
• auth/session_manager.py stores the local session file used by remember-me behavior.
• create_admin.py is a helper script for manually creating the first admin account.

Main Application Layer

• main.py contains the main dashboard window and top-level application orchestration.
• loginmain.py handles login, sign-up, forgot password, guest mode, and the admin/dashboard selection flow.
• dialogs/admin_window.py contains the admin panel.
• dialogs/smartsocket_popup.py contains the detailed Smart Socket control and monitoring popup.
• services/smartsocket_protection_store.py stores Smart Socket power-off protection data in Firebase Realtime Database.

Setup Helpers

The app/setup/ modules are thin UI wiring helpers:

• lamp_setup.py creates and connects custom lamp buttons
• switch_setup.py creates and connects Smart Socket switch buttons
• ac_setup.py creates and connects the custom AC button
• arrow_setup.py creates and stores flow arrows
• smartsocket_setup.py connects Smart Socket backend signals to the main window

Backend Layer

The backend/ folder contains service and integration modules:

• mqtt_client.py manages the shared MQTT connection
• mqtt_dht22_backend.py stores and filters DHT22 sensor messages
• mcu_status_backend.py tracks MCU online/offline state
• smartsocket_backend.py handles MQTT topics for all Smart Socket devices
• lampbutton_backend.py and acbutton_backend.py send control commands
• growatt_backend.py fetches inverter data
• growatt_worker.py runs Growatt fetches outside the UI thread
• weathercloud_backend.py fetches weather station data

UI and Widget Layer

• ui/ contains helper code and generated Python modules from Qt Designer .ui files
• widgets/ contains handwritten custom widgets used by the dashboard
• resources_rc.py contains the compiled Qt resource bindings

Hardware TA

The hardware_TA/ folder contains firmware and simulators used for development and device integration testing.

Arduino / firmware

1. smartsocket.ino - Smart Socket 1 firmware based on MQTT
2. smartsocket2.ino - Smart Socket 2 firmware based on MQTT
3. smartsocket3.ino - Smart Socket 3 firmware based on MQTT
4. smartsocket4.ino - Smart Socket 4 firmware based on MQTT
5. smartsocket5.ino - Smart Socket 5 firmware based on MQTT
6. smartlampcontrol.ino - Smart Lamp firmware
7. smartaccontrol.ino - Smart AC Control firmware

Python simulators

1. smartsocket_simulator.py - Smart Socket 1 simulator
2. smartsocket2_simulator.py - Smart Socket 2 simulator
3. smartsocket3_simulator.py - Smart Socket 3 simulator
4. smartsocket4_simulator.py - Smart Socket 4 simulator
5. smartsocket5_simulator.py - Smart Socket 5 simulator
6. mcua_simulator.py - MCU-A simulator
7. mcub_simulator.py - MCU-B simulator

Example: run a simulator

cd hardware_TA
python smartsocket_simulator.py

PCB Designs (KiCad)

• Smart AC & Smart Lamp — PCB designed by Ilham Purnomo during the 2025 internship.

Custom KiCad libraries are located under Libraries for Arduino IDE/ in each project folder.

Feature Details

Session management

• Save login sessions
• Remember-me support
• Auto-login when the session is still valid
• Application logout

Admin panel

• View user list
• Approve accounts
• Update user/admin roles
• Block/unblock accounts
• Update passwords for non-Google users
• Delete accounts

Smart Socket

• Device status monitoring
• Relay control
• Countdown timer
• Automatic scheduling
• Real-time energy monitoring
• Multi-level current warning system
• Automatic overload cutoff for critical current conditions
• Admin-only power-off protection settings inside the Smart Socket popup
• Power-off protection synced through Firebase so the same socket rules can be read from different PCs
• Data recording, CSV export, and charts
• Final Project — fully developed by Stephanus Kevin Andika Rata (Hardware & Software)

Smart Lamp

• Laboratory lamp control
• MQTT-based switching
• Supports multiple lamp channels in the control room page
• Developed together with Ilham Purnomo
• Hardware PCB design: Ilham Purnomo

Smart AC

• IR-based AC control
• Cooling and fan modes
• Temperature settings
• Developed together with Ilham Purnomo
• Hardware PCB design: Ilham Purnomo

EcoLab Power Monitoring

• Displays Growatt inverter data on page 1
• EcoLab power summary and live monitoring
• Serves as the main laboratory energy monitoring page

Weather Station Monitoring

• Displays laboratory weather station data
• Environmental sensor monitoring on the dashboard
• Integrated into the monitoring page for surrounding condition tracking

Authentication Flow

launcher.py -> check session
  |- valid session -> open dashboard
  |- no session -> open login window
       |- email/password -> Firebase -> save session -> dashboard
       |- Google sign-in -> OAuth -> save session -> dashboard
       |- guest mode -> temp session -> dashboard (limited)

Notes

• Use launcher.py as the main application entry point.
• The local session file is created automatically after a successful login.
• Firebase credential files are not included in the repository.
• Several key widgets are forced into a light theme to avoid text color issues on Windows 11 dark mode.
• Smart Socket MQTT firmware no longer stores the CA certificate contents directly inside the .ino files.

Contact

Stephanus Kevin Andika Rata
Software Development & System Integration
DTEDI Electronics Laboratory Internship 2025
Final Project - EcoLab Smart Laboratory
DTEDI Electronics Laboratory
Universitas Gadjah Mada

Email: kevinandika18@gmail.com

Ilham Purnomo
Hardware PCB Design (Smart AC & Smart Lamp)
DTEDI Electronics Laboratory Internship 2025
DTEDI Electronics Laboratory
Universitas Gadjah Mada

License & Copyright

Copyright (c) 2026 Stephanus Kevin Andika Rata
PCB Design (Smart AC & Lamp): Ilham Purnomo