Home Assistant integration via MQTT – automatic device discovery with station, equalizer, volume, play/stop, recording and LCD entities.

- MQTT broker auto-discovery via mDNS; manual broker address configurable from the web interface.
- Free RAM info in the web interface – DMA, Internal and SPIRAM with manual refresh button.

Author: MacWyznawca

CHANGELOG.md

@@ -7,7 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [1.1.1] - 2026-03-05
+## [1.2.0] - 2026-03-05
+
+### Added
+- **Home Assistant integration via MQTT** – automatic device discovery with station, equalizer, volume, play/stop, recording and LCD entities.
+- MQTT broker auto-discovery via mDNS; manual broker address configurable from the web interface.
+- Free RAM info in the web interface – DMA, Internal and SPIRAM with manual refresh button.
+
+## [1.1.1] - 2026-03-04
 
 ### Fixed
 - Problem with storing volume levels greater than 63% solved.

README.md

@@ -4,7 +4,14 @@
 
 ## 🌟 Main Features
 
-### 🌐 **Local Web Server - NEW!**
+### 🏠 **Home Assistant Integration via MQTT - NEW!**
+
+- **Automatic MQTT discovery** – entities appear in Home Assistant without manual YAML configuration
+- **Full control** – station, equalizer, volume, play/stop, recording, LCD on/off
+- **Real-time state sync** – all changes (from buttons, web, or HA) are instantly reflected everywhere
+- **Easy setup** – broker found automatically via mDNS or set manually in the web interface
+
+### 🌐 **Local Web Server**
 
 - **Remote control** via a web browser: volume, station selection, equalizer adjustment
 - **Dedicated LCD on/off button** in the web interface for manual display control (visible only if display is present)
@@ -14,16 +21,6 @@
 - **Local access** without the need for an Internet connection  
 - **Automatic SD card save** of the current station list  
 
-### Other Updates
-
-- Reorder radio stations via the web interface  
-- Automatically save the current station list from device flash memory (NVS) to the SD card  
-- Download the current station list in `.csv` format via the browser  
-- Equalizer selection via the web interface  
-- Increased maximum number of stations to 50  
-- Increased maximum number of equalizers to 20  
-- More built-in equalizers (10 total)
-
 ### 📻 Audio Playback
 
 - Supports many audio formats: **MP3, AAC, OGG, WAV, FLAC, OPUS, M4A, AMR**
@@ -63,6 +60,7 @@
 ### 🔗 Connectivity
 
 - **WiFi** with automatic provisioning via ESP SoftAP Prov app
+- **MQTT** for Home Assistant integration (auto-discovery via mDNS or manual broker address)
 - **mDNS/Bonjour, NetBIOS** for easy network discovery
 - **SNTP** for time synchronization
 - Configuration support via ESP SoftAP app
@@ -206,7 +204,39 @@ Always 10 EQ values in dB.
 - 📋 **Station selection** with full list
 - 📋 **Edit station list** without physical access
 
-## 🎠 Button Controls (OLED-less Mode)
+## � Home Assistant Integration
+
+RadioJKK supports automatic integration with **Home Assistant** via MQTT discovery. All entities are created automatically — no manual YAML configuration needed.
+
+![RadioJKK in Home Assistant](img/RadioJKK_HA.png)
+
+### Discovered Entities
+
+| Entity | Type | Description |
+|--------|------|-------------|
+| Station | Select | Choose from the configured station list |
+| Equalizer | Select | Choose equalizer preset |
+| Volume | Number | Volume level 0–100% |
+| Playback | Switch | Play / Stop with state indicator |
+| Recording | Switch | Start / Stop recording to SD card |
+| LCD | Switch | Display on / off |
+
+### MQTT Broker Configuration
+
+RadioJKK discovers the MQTT broker automatically via **mDNS** (service `_mqtt._tcp`). If your broker advertises this service (e.g. Mosquitto with Avahi), no manual configuration is needed.
+
+To set the broker address manually:
+
+1. Open the web interface: `http://radiojkk32.local`
+2. Enter the MQTT broker address (e.g. `mqtt://192.168.1.100:1883`)
+3. Save — the device will connect to the specified broker
+
+### Requirements
+
+- **MQTT broker** (e.g. Mosquitto) accessible on the local network
+- **Home Assistant** with [MQTT integration](https://www.home-assistant.io/integrations/mqtt/) enabled and connected to the same broker
+
+## �🎠 Button Controls (OLED-less Mode)
 
 | Button        | Short Press          | Long Press         |
 | ------------- | -------------------- | ------------------ |

README_PL.md

@@ -4,7 +4,14 @@
 
 ## 🌟 Główne funkcje
 
-### 🌐 **Lokalny serwer WWW - NOWOŚĆ!**
+### 🏠 **Integracja z Home Assistant przez MQTT - NOWOŚĆ!**
+
+- **Automatyczne wykrywanie MQTT** – encje pojawiają się w Home Assistant bez ręcznej konfiguracji YAML
+- **Pełna kontrola** – stacja, equalizer, głośność, odtwarzanie/stop, nagrywanie, LCD on/off
+- **Synchronizacja stanu w czasie rzeczywistym** – zmiany z przycisków, WWW lub HA są natychmiast widoczne wszędzie
+- **Łatwa konfiguracja** – broker odnajdywany automatycznie przez mDNS lub ustawiany ręcznie w interfejsie WWW
+
+### 🌐 **Lokalny serwer WWW**
 
 - **Zdalne sterowanie** przez przeglądarkę internetową: głośność, wybór stacji, zmiana equalizera
 - **Dedykowany przycisk LCD on/off** w interfejsie WWW do ręcznego włączania/wyłączania wyświetlacza (widoczny tylko gdy wyświetlacz jest obecny)
@@ -14,16 +21,6 @@
 - **Dostęp lokalny** bez potrzeby połączenia z Internetem
 - **Automatyczny zapis na karcie SD** aktualnej listy stacji
 
-### Inne nowości
-
-- Zmiana kolejności stacji radiowych przez WWW
-- Automatyczny zapis aktualnej listy stacji z pamięci flash urządzenia (NVS) na kartę SD
-- Możliwość pobrania aktualnej listy stacji w formacie .csv przez przeglądarkę
-- Wybór equalizera w przeglądarce
-- Zwiększona maksymalna liczba stacji do 50
-- Maksymalna liczba equalizerów zwiększona do 20
-- Więcej wbudowanych equalizerów (10)
-
 ### 📻 Odtwarzanie audio
 
 - Obsługa wielu formatów audio: **MP3, AAC, OGG, WAV, FLAC, OPUS, M4A, AMR**
@@ -63,6 +60,7 @@
 ### 🔗 Łączność
 
 - **WiFi** z automatycznym provisioningiem przez aplikację ESP SoftAP Prov
+- **MQTT** do integracji z Home Assistant (auto-discovery przez mDNS lub ręczny adres brokera)
 - **mDNS/Bonjour, NetBIOS** dla łatwego odnajdywania w sieci
 - **SNTP** dla synchronizacji czasu
 - Obsługa konfiguracji przez aplikację ESP SoftAP
@@ -210,7 +208,39 @@ Zawsze 10 ustawień korekcji w dB.
 - 📋 **Zmiana stacji** z pełną listą dostępnych opcji
 - 📋 **Edycja listy stacji** bez potrzeby fizycznego dostępu
 
-## 🎠 Obsługa przycisków (tryb bez OLED)
+## � Integracja z Home Assistant
+
+RadioJKK wspiera automatyczną integrację z **Home Assistant** przez MQTT discovery. Wszystkie encje tworzone są automatycznie — bez konieczności ręcznej konfiguracji YAML.
+
+![RadioJKK w Home Assistant](img/RadioJKK_HA.png)
+
+### Wykrywane encje
+
+| Encja | Typ | Opis |
+|-------|-----|------|
+| Stacja | Select | Wybór z listy skonfigurowanych stacji |
+| Equalizer | Select | Wybór presetu equalizera |
+| Głośność | Number | Poziom głośności 0–100% |
+| Odtwarzanie | Switch | Play / Stop ze wskaźnikiem stanu |
+| Nagrywanie | Switch | Start / Stop nagrywania na kartę SD |
+| LCD | Switch | Włączanie / wyłączanie wyświetlacza |
+
+### Konfiguracja brokera MQTT
+
+RadioJKK automatycznie odnajduje broker MQTT przez **mDNS** (usługa `_mqtt._tcp`). Jeśli Twój broker ogłasza tę usługę (np. Mosquitto z Avahi), żadna ręczna konfiguracja nie jest potrzebna.
+
+Aby ustawić adres brokera ręcznie:
+
+1. Otwórz interfejs WWW: `http://radiojkk32.local`
+2. Wpisz adres brokera MQTT (np. `mqtt://192.168.1.100:1883`)
+3. Zapisz — urządzenie połączy się ze wskazanym brokerem
+
+### Wymagania
+
+- **Broker MQTT** (np. Mosquitto) dostępny w sieci lokalnej
+- **Home Assistant** z włączoną [integracją MQTT](https://www.home-assistant.io/integrations/mqtt/) podłączoną do tego samego brokera
+
+## �🎠 Obsługa przycisków (tryb bez OLED)
 
 | Przycisk      | Krótkie naciśnięcie | Długie naciśnięcie |
 | ------------- | ------------------- | ------------------ |

img/RadioJKK_HA.png

@@ -1064,5 +1064,87 @@ <h2>Wi‑Fi setup</h2>
         </div>
         <p id="wifi-msg" style="text-align: center; font-weight: bold; color: #333; margin: 0;"></p>
     </div>
+
+    <!-- MQTT broker setup -->
+    <div class="form-container wifi-panel" style="margin: 1.5rem auto; max-width: 600px;">
+        <h2>MQTT Broker</h2>
+        <div class="form-group" style="display:flex; align-items:center; gap:0.5em;">
+            <input id="mqtt-enabled" type="checkbox" checked style="width:auto; margin:0;">
+            <label for="mqtt-enabled" style="margin:0; cursor:pointer;">MQTT enabled</label>
+        </div>
+        <div class="form-group">
+            <label for="mqtt-broker">Broker address (host or host:port)</label>
+            <input id="mqtt-broker" type="text" maxlength="79" placeholder="empty = mDNS auto-discovery">
+        </div>
+        <div class="form-buttons">
+            <button onclick="saveMqtt()">💾 Save</button>
+            <button onclick="loadMqtt()" style="background:#555;">🔄 Refresh</button>
+        </div>
+        <p id="mqtt-msg" style="text-align: center; font-weight: bold; color: #333; margin: 0;"></p>
+    </div>
+
+    <script>
+    function saveMqtt() {
+        const broker = document.getElementById('mqtt-broker').value.trim();
+        const enabled = document.getElementById('mqtt-enabled').checked ? 1 : 0;
+        const msg = document.getElementById('mqtt-msg');
+        msg.textContent = 'Saving...';
+        msg.style.color = '#333';
+        const body = `broker=${encodeURIComponent(broker)}&enabled=${enabled}`;
+        fetch('/mqtt_save', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body
+        }).then(r => r.text())
+        .then(t => { msg.textContent = t + (enabled ? '' : ' (MQTT disabled)'); msg.style.color = '#070'; })
+        .catch(() => { msg.textContent = 'Error saving MQTT'; msg.style.color = '#c00'; });
+    }
+
+    function loadMqtt() {
+        fetch('/mqtt_status')
+        .then(r => r.text())
+        .then(t => {
+            // Format: broker_addr;connected;enabled
+            const parts = t.split(';');
+            document.getElementById('mqtt-broker').value = parts[0] || '';
+            const connected = parts[1] === '1';
+            const enabled = parts[2] !== '0';
+            document.getElementById('mqtt-enabled').checked = enabled;
+            const msg = document.getElementById('mqtt-msg');
+            if (!enabled) {
+                msg.textContent = 'MQTT disabled';
+                msg.style.color = '#888';
+            } else if (connected) {
+                msg.textContent = '✅ Connected';
+                msg.style.color = '#070';
+            } else if (parts[0]) {
+                msg.textContent = 'Configured (not connected)';
+                msg.style.color = '#a80';
+            } else {
+                msg.textContent = 'mDNS auto-discovery active';
+                msg.style.color = '#555';
+            }
+        })
+        .catch(() => {});
+    }
+    loadMqtt();
+    </script>
+
+    <!-- RAM info -->
+    <div style="text-align:center; color:#888; font-size:0.85em; margin:1.5rem 0 0.5rem;">
+        <span id="ram-info">Loading RAM info...</span>
+        <button onclick="loadRam()" style="background:none; border:none; cursor:pointer; font-size:1em; vertical-align:middle; padding:0 0 0 0.3em;" title="Refresh">🔄</button>
+    </div>
+    <script>
+    function loadRam(){
+        document.getElementById('ram-info').textContent='Loading...';
+        fetch('/raminfo').then(r=>r.text()).then(t=>{
+            const [dma,int_,spi]=t.split(';');
+            document.getElementById('ram-info').textContent=
+                'Free RAM \u2014 DMA: '+dma+' KB \u00b7 Internal: '+int_+' KB \u00b7 SPIRAM: '+spi+' KB';
+        }).catch(()=>{ document.getElementById('ram-info').textContent='Error'; });
+    }
+    loadRam();
+    </script>
 </body>
 </html>

…K32/bin/RadioJKK_LCD_ext_keys_v1.1.1.bin …2/bin/RadioJKK_LCD_board_keys_v1.2.0.binradioJKK32/bin/RadioJKK_LCD_ext_keys_v1.1.1.bin renamed to radioJKK32/bin/RadioJKK_LCD_board_keys_v1.2.0.bin radioJKK32/bin/RadioJKK_LCD_ext_keys_v1.1.1.bin renamed to radioJKK32/bin/RadioJKK_LCD_board_keys_v1.2.0.bin

@@ -6,6 +6,7 @@ set(srcs  "radio_jkk.c"
                     "jkk_nvs.c"
                     "jkk_settings.c"
                     "web_server.c"
+                    "jkk_mqtt.c"
                    )
 
 if(CONFIG_JKK_RADIO_USING_I2C_LCD)