enviroplussensorstomqtt 0.1.0__tar.gz

enviroplussensorstomqtt-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Olof Hellqvist 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

enviroplussensorstomqtt-0.1.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: enviroplussensorstomqtt
+Version: 0.1.0
+Summary: Publish Pimoroni Enviro+ environmental sensor data to MQTT
+Author-email: Olof Hellqvist <olof.hellqvist@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hellqvio86/enviroplus-sensors-to-mqtt
+Project-URL: Repository, https://github.com/hellqvio86/enviroplus-sensors-to-mqtt
+Project-URL: Issues, https://github.com/hellqvio86/enviroplus-sensors-to-mqtt/issues
+Keywords: enviroplus,temperature,humidity,pressure,mqtt,raspberry-pi
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Home Automation
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: enviroplus
+Requires-Dist: pimoroni-bme280
+Requires-Dist: pms5003
+Requires-Dist: smbus2
+Requires-Dist: paho-mqtt<3.0.0,>=2.0.0
+Requires-Dist: pyyaml
+Requires-Dist: setproctitle
+Provides-Extra: tests
+Requires-Dist: pytest; extra == "tests"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+# Enviroplus Sensors to MQTT
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+
+A robust Python service that reads environmental sensor data from a Pimoroni Enviro+ HAT on a Raspberry Pi and publishes structured JSON payloads to an MQTT broker.
+
+---
+
+## Features
+
+- **Sensors supported**: BME280 (temperature, humidity, pressure), MICS6814 (reducing, oxidising, NH3 gas resistance), MEMS microphone (noise low/mid/high/amp), and PMS5003 particulate matter sensor (PM1, PM2.5, PM10).
+- **Fault-isolated sampling**: Transient I2C/serial/sensor errors are handled cleanly per sensor group rather than crashing the service.
+- **Self-heating compensation**: Configurable temperature offset (`--temperature_offset` / `temperature_offset`).
+- **Resilient MQTT loop**: Long-lived connection with automatic reconnect, error-checked publishing, and Last Will and Testament (LWT) offline messaging.
+- **systemd-first architecture**: Direct console logging formatted for `journald` with graceful shutdown on `SIGTERM` / `SIGINT`.
+- **Environment variable secrets**: Secure credential loading via `MQTT_HOST`, `MQTT_USERNAME`, and `MQTT_PASSWORD`.
+
+---
+
+## Hardware & System Prerequisites (Raspberry Pi)
+
+Ensure the required Raspberry Pi hardware interfaces are enabled via `raspi-config`:
+- **I2C**: Enabled (`Interface Options -> I2C`)
+- **SPI**: Enabled (`Interface Options -> SPI`)
+- **Serial Port**: Hardware serial enabled, serial console disabled (`Interface Options -> Serial Port`)
+- **Microphone**: If using the MEMS noise sensor, ensure the microphone audio overlay is enabled in `/boot/config.txt`.
+
+Install system libraries required by the sensor hardware stacks:
+```bash
+sudo apt-get update
+sudo apt-get install -y python3-dev gcc i2c-tools cmake libffi-dev libopenblas0
+```
+
+---
+
+## Installation & Setup
+
+We recommend using [uv](https://github.com/astral-sh/uv) for fast, deterministic installs:
+
+```bash
+# Clone the repository
+git clone https://github.com/hellqvio86/enviroplus-sensors-to-mqtt.git
+cd enviroplus-sensors-to-mqtt
+
+# Install dependencies into local virtualenv
+make install
+```
+
+### Running Tests & Linting
+
+```bash
+make test
+```
+
+---
+
+## Configuration
+
+Configuration is loaded and merged with the following precedence (highest to lowest):
+1. Command-line flags
+2. Environment variables (`MQTT_HOST`, `MQTT_USERNAME`, `MQTT_PASSWORD`)
+3. YAML config file (`--config_file <path>`, `/etc/enviroplussensorstomqtt.yaml`, or `./config.yaml`)
+4. Built-in defaults
+
+### Configuration Reference
+
+| Option | CLI Flag | Environment Variable | Default | Description |
+|---|---|---|---|---|
+| `host` | `--host` | `MQTT_HOST` | *(required)* | MQTT broker hostname or IP |
+| `port` | `--port` | - | `1883` | MQTT broker port (1-65535) |
+| `topics` | `--topics` | - | *(required)* | Comma-separated list of MQTT topics |
+| `username` | `--username` | `MQTT_USERNAME` | `None` | MQTT broker username (optional) |
+| `password` | `--password` | `MQTT_PASSWORD` | `None` | MQTT broker password (optional) |
+| `interval` | `--interval` | - | `60.0` | Seconds between measurement cycles |
+| `measurements` | `--measurements` | - | `3` | Number of samples to median per cycle |
+| `temperature_offset` | `--temperature_offset` | - | `0.0` | °C offset to subtract for board self-heating |
+| `enable_ltr559` | `--disable-ltr559` | - | `true` | Enable/disable LTR559 light and proximity sensor |
+| `client_id` | `--client_id` | - | `None` | Optional MQTT client ID |
+| `tls` | `--tls` / `--no-tls` | - | `false` | Enable TLS encryption for MQTT broker connection |
+| `tls_ca_certs` | `--tls_ca_certs` | - | `None` | Path to CA certificates file for TLS verification |
+| `tls_certfile` | `--tls_certfile` | - | `None` | Path to client certificate file for mutual TLS |
+| `tls_keyfile` | `--tls_keyfile` | - | `None` | Path to client private key file for mutual TLS |
+| `tls_insecure` | `--tls_insecure` / `--no-tls_insecure` | - | `false` | Disable server certificate hostname verification |
+| `per_metric_topics` | `--per_metric_topics` / `--no-per_metric_topics` | - | `false` | Also publish individual values to `{topic}/{metric}` subtopics |
+| `ha_discovery` | `--ha_discovery` / `--no-ha_discovery` | - | `false` | Enable Home Assistant MQTT Discovery registration |
+| `ha_discovery_prefix` | `--ha_discovery_prefix` | - | `homeassistant` | MQTT topic prefix for Home Assistant discovery |
+| `device_id` | `--device_id` | - | `enviroplus` | Unique device identifier for Home Assistant discovery |
+| `qos` | - | - | `1` | MQTT QoS level (0, 1, or 2) |
+| `retain` | - | - | `true` | Retain published MQTT messages |
+| `debug` | `-D`, `--debug` | - | `false` | Enable verbose debug logging |
+| `log_file` | `--log_file` | - | `None` | Optional file path for file logging |
+
+### YAML Configuration Example
+
+Save as `/etc/enviroplussensorstomqtt.yaml` or `config.yaml` with permissions `chmod 600 config.yaml`:
+
+```yaml
+host: "192.168.1.50"
+port: 1883
+username: "mqtt_user"
+password: "secure_password"
+topics:
+  - "home/sensors/livingroom/enviroplus"
+interval: 60.0
+measurements: 3
+temperature_offset: 2.5
+enable_ltr559: true
+qos: 1
+retain: true
+debug: false
+```
+
+---
+
+## Example MQTT Payload
+
+Readings are published as a retained JSON object:
+
+```json
+{
+  "temperature": 21.45,
+  "unit_of_temperature": "C",
+  "humidity": 45.20,
+  "unit_of_humidity": "%",
+  "pressure": 1013.2,
+  "unit_of_pressure": "mbar",
+  "noise_low": 0.12,
+  "noise_mid": 0.08,
+  "noise_high": 0.05,
+  "noise_amp": 0.02,
+  "gas_oxidising": 182500,
+  "unit_of_gas_oxidising": "Ohms",
+  "gas_reducing": 245000,
+  "unit_of_gas_reducing": "Ohms",
+  "gas_nh3": 312000,
+  "unit_of_gas_nh3": "Ohms",
+  "pm1": 2,
+  "pm25": 6,
+  "pm10": 9,
+  "lux": 150.25,
+  "unit_of_lux": "Lux",
+  "proximity": 38,
+  "time_utc": "2026-10-09T08:30:00.000000"
+}
+```
+
+---
+
+## Systemd Service Installation
+
+To install as a background service:
+
+```bash
+make install-service
+sudo systemctl enable enviroplussensorstomqtt
+sudo systemctl start enviroplussensorstomqtt
+```
+
+Check status and follow logs:
+
+```bash
+sudo systemctl status enviroplussensorstomqtt
+journalctl -u enviroplussensorstomqtt -f
+```
+
+<p align="right">
+  <a href="https://www.buymeacoffee.com/olofhellqvc">
+    <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee" height="48">
+  </a>
+</p>

enviroplussensorstomqtt-0.1.0/README.md

@@ -0,0 +1,173 @@
+# Enviroplus Sensors to MQTT
+
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+
+A robust Python service that reads environmental sensor data from a Pimoroni Enviro+ HAT on a Raspberry Pi and publishes structured JSON payloads to an MQTT broker.
+
+---
+
+## Features
+
+- **Sensors supported**: BME280 (temperature, humidity, pressure), MICS6814 (reducing, oxidising, NH3 gas resistance), MEMS microphone (noise low/mid/high/amp), and PMS5003 particulate matter sensor (PM1, PM2.5, PM10).
+- **Fault-isolated sampling**: Transient I2C/serial/sensor errors are handled cleanly per sensor group rather than crashing the service.
+- **Self-heating compensation**: Configurable temperature offset (`--temperature_offset` / `temperature_offset`).
+- **Resilient MQTT loop**: Long-lived connection with automatic reconnect, error-checked publishing, and Last Will and Testament (LWT) offline messaging.
+- **systemd-first architecture**: Direct console logging formatted for `journald` with graceful shutdown on `SIGTERM` / `SIGINT`.
+- **Environment variable secrets**: Secure credential loading via `MQTT_HOST`, `MQTT_USERNAME`, and `MQTT_PASSWORD`.
+
+---
+
+## Hardware & System Prerequisites (Raspberry Pi)
+
+Ensure the required Raspberry Pi hardware interfaces are enabled via `raspi-config`:
+- **I2C**: Enabled (`Interface Options -> I2C`)
+- **SPI**: Enabled (`Interface Options -> SPI`)
+- **Serial Port**: Hardware serial enabled, serial console disabled (`Interface Options -> Serial Port`)
+- **Microphone**: If using the MEMS noise sensor, ensure the microphone audio overlay is enabled in `/boot/config.txt`.
+
+Install system libraries required by the sensor hardware stacks:
+```bash
+sudo apt-get update
+sudo apt-get install -y python3-dev gcc i2c-tools cmake libffi-dev libopenblas0
+```
+
+---
+
+## Installation & Setup
+
+We recommend using [uv](https://github.com/astral-sh/uv) for fast, deterministic installs:
+
+```bash
+# Clone the repository
+git clone https://github.com/hellqvio86/enviroplus-sensors-to-mqtt.git
+cd enviroplus-sensors-to-mqtt
+
+# Install dependencies into local virtualenv
+make install
+```
+
+### Running Tests & Linting
+
+```bash
+make test
+```
+
+---
+
+## Configuration
+
+Configuration is loaded and merged with the following precedence (highest to lowest):
+1. Command-line flags
+2. Environment variables (`MQTT_HOST`, `MQTT_USERNAME`, `MQTT_PASSWORD`)
+3. YAML config file (`--config_file <path>`, `/etc/enviroplussensorstomqtt.yaml`, or `./config.yaml`)
+4. Built-in defaults
+
+### Configuration Reference
+
+| Option | CLI Flag | Environment Variable | Default | Description |
+|---|---|---|---|---|
+| `host` | `--host` | `MQTT_HOST` | *(required)* | MQTT broker hostname or IP |
+| `port` | `--port` | - | `1883` | MQTT broker port (1-65535) |
+| `topics` | `--topics` | - | *(required)* | Comma-separated list of MQTT topics |
+| `username` | `--username` | `MQTT_USERNAME` | `None` | MQTT broker username (optional) |
+| `password` | `--password` | `MQTT_PASSWORD` | `None` | MQTT broker password (optional) |
+| `interval` | `--interval` | - | `60.0` | Seconds between measurement cycles |
+| `measurements` | `--measurements` | - | `3` | Number of samples to median per cycle |
+| `temperature_offset` | `--temperature_offset` | - | `0.0` | °C offset to subtract for board self-heating |
+| `enable_ltr559` | `--disable-ltr559` | - | `true` | Enable/disable LTR559 light and proximity sensor |
+| `client_id` | `--client_id` | - | `None` | Optional MQTT client ID |
+| `tls` | `--tls` / `--no-tls` | - | `false` | Enable TLS encryption for MQTT broker connection |
+| `tls_ca_certs` | `--tls_ca_certs` | - | `None` | Path to CA certificates file for TLS verification |
+| `tls_certfile` | `--tls_certfile` | - | `None` | Path to client certificate file for mutual TLS |
+| `tls_keyfile` | `--tls_keyfile` | - | `None` | Path to client private key file for mutual TLS |
+| `tls_insecure` | `--tls_insecure` / `--no-tls_insecure` | - | `false` | Disable server certificate hostname verification |
+| `per_metric_topics` | `--per_metric_topics` / `--no-per_metric_topics` | - | `false` | Also publish individual values to `{topic}/{metric}` subtopics |
+| `ha_discovery` | `--ha_discovery` / `--no-ha_discovery` | - | `false` | Enable Home Assistant MQTT Discovery registration |
+| `ha_discovery_prefix` | `--ha_discovery_prefix` | - | `homeassistant` | MQTT topic prefix for Home Assistant discovery |
+| `device_id` | `--device_id` | - | `enviroplus` | Unique device identifier for Home Assistant discovery |
+| `qos` | - | - | `1` | MQTT QoS level (0, 1, or 2) |
+| `retain` | - | - | `true` | Retain published MQTT messages |
+| `debug` | `-D`, `--debug` | - | `false` | Enable verbose debug logging |
+| `log_file` | `--log_file` | - | `None` | Optional file path for file logging |
+
+### YAML Configuration Example
+
+Save as `/etc/enviroplussensorstomqtt.yaml` or `config.yaml` with permissions `chmod 600 config.yaml`:
+
+```yaml
+host: "192.168.1.50"
+port: 1883
+username: "mqtt_user"
+password: "secure_password"
+topics:
+  - "home/sensors/livingroom/enviroplus"
+interval: 60.0
+measurements: 3
+temperature_offset: 2.5
+enable_ltr559: true
+qos: 1
+retain: true
+debug: false
+```
+
+---
+
+## Example MQTT Payload
+
+Readings are published as a retained JSON object:
+
+```json
+{
+  "temperature": 21.45,
+  "unit_of_temperature": "C",
+  "humidity": 45.20,
+  "unit_of_humidity": "%",
+  "pressure": 1013.2,
+  "unit_of_pressure": "mbar",
+  "noise_low": 0.12,
+  "noise_mid": 0.08,
+  "noise_high": 0.05,
+  "noise_amp": 0.02,
+  "gas_oxidising": 182500,
+  "unit_of_gas_oxidising": "Ohms",
+  "gas_reducing": 245000,
+  "unit_of_gas_reducing": "Ohms",
+  "gas_nh3": 312000,
+  "unit_of_gas_nh3": "Ohms",
+  "pm1": 2,
+  "pm25": 6,
+  "pm10": 9,
+  "lux": 150.25,
+  "unit_of_lux": "Lux",
+  "proximity": 38,
+  "time_utc": "2026-10-09T08:30:00.000000"
+}
+```
+
+---
+
+## Systemd Service Installation
+
+To install as a background service:
+
+```bash
+make install-service
+sudo systemctl enable enviroplussensorstomqtt
+sudo systemctl start enviroplussensorstomqtt
+```
+
+Check status and follow logs:
+
+```bash
+sudo systemctl status enviroplussensorstomqtt
+journalctl -u enviroplussensorstomqtt -f
+```
+
+<p align="right">
+  <a href="https://www.buymeacoffee.com/olofhellqvc">
+    <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me a Coffee" height="48">
+  </a>
+</p>

enviroplussensorstomqtt-0.1.0/pyproject.toml

@@ -0,0 +1,70 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "enviroplussensorstomqtt"
+version = "0.1.0"
+description = "Publish Pimoroni Enviro+ environmental sensor data to MQTT"
+readme = "README.md"
+authors = [
+  { name = "Olof Hellqvist", email = "olof.hellqvist@gmail.com" }
+]
+license = "MIT"
+requires-python = ">=3.11"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Home Automation",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+keywords = ["enviroplus", "temperature", "humidity", "pressure", "mqtt", "raspberry-pi"]
+dependencies = [
+    "enviroplus",
+    "pimoroni-bme280",
+    "pms5003",
+    "smbus2",
+    "paho-mqtt>=2.0.0,<3.0.0",
+    "pyyaml",
+    "setproctitle",
+]
+
+[project.urls]
+Homepage = "https://github.com/hellqvio86/enviroplus-sensors-to-mqtt"
+Repository = "https://github.com/hellqvio86/enviroplus-sensors-to-mqtt"
+Issues = "https://github.com/hellqvio86/enviroplus-sensors-to-mqtt/issues"
+
+[project.optional-dependencies]
+tests = [
+    "pytest",
+]
+dev = [
+    "pytest",
+    "ruff",
+]
+
+[project.scripts]
+enviroplussensorstomqtt = "enviroplussensorstomqtt.main:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["enviroplussensorstomqtt*"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP", "RUF"]
+ignore = []
+
+[tool.ruff.lint.per-file-ignores]
+"src/tests/*" = ["S101"]

enviroplussensorstomqtt-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

enviroplussensorstomqtt-0.1.0/src/enviroplussensorstomqtt/__init__.py

@@ -0,0 +1,5 @@
+"""Enviroplus sensors to MQTT."""
+
+__version__ = "0.1.0"
+
+__all__ = ["__version__"]

enviroplussensorstomqtt-0.1.0/src/enviroplussensorstomqtt/args.py

@@ -0,0 +1,160 @@
+"""Args handler module."""
+
+from __future__ import annotations
+
+import argparse
+import os
+from typing import Any
+
+from .config import parse_config, validate_config
+
+
+def args_handler(
+    argv: list[str] | None = None,
+    *,
+    config_file: str | None = None,
+    validate: bool = False,
+) -> dict[str, Any]:
+    """
+    Function for reading arguments and config file.
+
+    Args:
+        argv (list[str], optional): Arguments list to parse. Defaults to sys.argv[1:].
+        config_file (str, optional): Default config file to use if not overridden by CLI.
+        validate (bool, optional): Whether to validate config immediately against AppConfig schema.
+
+    Returns:
+        dict: Parsed and merged configuration dictionary.
+    """
+    parser = argparse.ArgumentParser(description="Publish Enviro+ sensor data to MQTT")
+    parser.add_argument("--username", type=str, required=False, help="MQTT username")
+    parser.add_argument("--password", type=str, required=False, help="MQTT password")
+    parser.add_argument("--host", type=str, required=False, help="MQTT broker host")
+    parser.add_argument("--port", type=int, required=False, help="MQTT broker port")
+    parser.add_argument("--topics", type=str, required=False, help="Comma-separated MQTT topics")
+    parser.add_argument("--config_file", type=str, required=False, help="Path to YAML configuration file")
+    parser.add_argument("--log_file", type=str, required=False, help="Path to log file")
+    parser.add_argument("--interval", type=float, required=False, help="Interval in seconds between cycles")
+    parser.add_argument("--measurements", type=int, required=False, help="Number of samples to average per cycle")
+    parser.add_argument(
+        "--temperature_offset",
+        type=float,
+        required=False,
+        help="Temperature offset in °C to subtract/compensate for self-heating",
+    )
+    parser.add_argument("--client_id", type=str, required=False, help="MQTT client ID")
+    parser.add_argument("--tls", action=argparse.BooleanOptionalAction, default=None, help="Enable TLS")
+    parser.add_argument("--tls_ca_certs", type=str, required=False, help="Path to CA certificate")
+    parser.add_argument("--tls_certfile", type=str, required=False, help="Path to client certificate")
+    parser.add_argument("--tls_keyfile", type=str, required=False, help="Path to client key")
+    parser.add_argument("--tls_insecure", action=argparse.BooleanOptionalAction, default=None, help="Skip TLS verify")
+    parser.add_argument(
+        "--per_metric_topics", action=argparse.BooleanOptionalAction, default=None, help="Publish per-metric"
+    )
+    parser.add_argument(
+        "--ha_discovery", action=argparse.BooleanOptionalAction, default=None, help="Enable HA discovery"
+    )
+    parser.add_argument("--ha_discovery_prefix", type=str, required=False, help="HA discovery prefix")
+    parser.add_argument("--device_id", type=str, required=False, help="Device ID for HA discovery")
+    parser.add_argument(
+        "--disable-ltr559",
+        action="store_true",
+        help="Disable LTR559 light and proximity sensor",
+    )
+    parser.add_argument("-D", "--debug", action="store_true", help="Enable debug logging")
+    args = parser.parse_args(argv)
+
+    if args.config_file:
+        config = parse_config(config_file=args.config_file)
+    elif config_file:
+        config = parse_config(config_file=config_file)
+    elif os.path.isfile("/etc/enviroplussensorstomqtt.yaml"):
+        config = parse_config(config_file="/etc/enviroplussensorstomqtt.yaml")
+    elif os.path.isfile("config.yaml"):
+        config = parse_config(config_file="config.yaml")
+    else:
+        config = parse_config()
+
+    if args.username is not None:
+        config["username"] = args.username
+
+    if args.password is not None:
+        config["password"] = args.password
+
+    if args.host is not None:
+        config["host"] = args.host
+
+    if args.port is not None:
+        config["port"] = args.port
+
+    if args.debug:
+        config["debug"] = True
+
+    if args.disable_ltr559:
+        config["enable_ltr559"] = False
+
+    if args.log_file is not None:
+        config["log_file"] = args.log_file
+
+    if args.interval is not None:
+        config["interval"] = args.interval
+
+    if args.measurements is not None:
+        config["measurements"] = args.measurements
+
+    if args.temperature_offset is not None:
+        config["temperature_offset"] = args.temperature_offset
+
+    if args.topics is not None:
+        config["topics"] = [item.strip() for item in args.topics.split(",") if item.strip()]
+
+    if args.client_id is not None:
+        config["client_id"] = args.client_id
+
+    if args.tls is not None:
+        config["tls"] = args.tls
+
+    if args.tls_ca_certs is not None:
+        config["tls_ca_certs"] = args.tls_ca_certs
+
+    if args.tls_certfile is not None:
+        config["tls_certfile"] = args.tls_certfile
+
+    if args.tls_keyfile is not None:
+        config["tls_keyfile"] = args.tls_keyfile
+
+    if args.tls_insecure is not None:
+        config["tls_insecure"] = args.tls_insecure
+
+    if args.per_metric_topics is not None:
+        config["per_metric_topics"] = args.per_metric_topics
+
+    if args.ha_discovery is not None:
+        config["ha_discovery"] = args.ha_discovery
+
+    if args.ha_discovery_prefix is not None:
+        config["ha_discovery_prefix"] = args.ha_discovery_prefix
+
+    if args.device_id is not None:
+        config["device_id"] = args.device_id
+
+    # Environment variable fallbacks for secrets and broker config
+    if not config.get("password") and "MQTT_PASSWORD" in os.environ:
+        config["password"] = os.environ["MQTT_PASSWORD"]
+
+    if not config.get("username") and "MQTT_USERNAME" in os.environ:
+        config["username"] = os.environ["MQTT_USERNAME"]
+
+    if not config.get("host") and "MQTT_HOST" in os.environ:
+        config["host"] = os.environ["MQTT_HOST"]
+
+    # Validate configuration if requested
+    if validate:
+        app_config = validate_config(config)
+        config = app_config.to_dict()
+
+    if config.get("debug"):
+        debug_config = {k: ("***" if k == "password" and v else v) for k, v in config.items()}
+        print(f"config: {debug_config}")
+
+    return config