feat: allow stopping the FTP server from the web interface

Add Ftp_DisableServer()/Ftp_IsServerRunning(), report the FTP state
over the websocket (on connect and after start/stop requests) and
turn the FTP start button into a red stop button while the server is
running - matching the bluetooth mode buttons.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: fhirschmann

html/locales/de.json

@@ -326,7 +326,8 @@
 		"start": {
 			"title": "FTP-Server starten",
 			"desc": "Aktiviert den FTP-Server bis zum Neustart des Geräts.",
-			"button": "FTP-Server starten"
+			"button": "FTP-Server starten",
+			"stopButton": "FTP-Server stoppen"
 		}
 	},
 	"bt": {

html/locales/en.json

@@ -327,7 +327,8 @@
 		"start": {
 			"title": "Start FTP-server",
 			"desc": "Enables FTP-server until device is restarted.",
-			"button": "Start FTP-server"
+			"button": "Start FTP-server",
+			"stopButton": "Stop FTP server"
 		}
 	},
 	"bt": {

html/locales/fr.json

@@ -319,7 +319,8 @@
 		"start": {
 			"title": "Démarrer serveur FTP",
 			"desc": "Active le serveur FTP jusqu'au redémarrage du périphérique.",
-			"button": "Démarrer le serveur FTP"
+			"button": "Démarrer le serveur FTP",
+			"stopButton": "Arrêter le serveur FTP"
 		}
 	},
 	"bt": {

html/management.html

@@ -1605,7 +1605,7 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 					<div data-i18n="ftp.start.desc"></div>
 					<br>
 					<div class="text-center">
-						<button type="button" class="btn btn-primary" onclick="ftpStart()"
+						<button type="button" class="btn btn-primary" id="ftpModeBtn" onclick="ftpSetStatus(1)"
 							data-i18n="ftp.start.button"></button>
 					</div>
 				</div>
@@ -3180,6 +3180,9 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 					currentOpMode = socketMsg.opmode;
 					updateOperationModeIndicator(socketMsg.opmode);
 				}
+				if ("ftpStatus" in socketMsg) {
+					updateFtpButton(socketMsg.ftpStatus.running);
+				}
 				if ("volume" in socketMsg) {
 					volumeSlider.setValue(parseInt(socketMsg.volume));
 				}
@@ -3880,16 +3883,28 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 			toaster.info(i18next.t("toast.saved"));
 		}
 
-		function ftpStart() {
+		function ftpSetStatus(start) {
 			var myObj = {
 				"ftpStatus": {
-					start: 1
+					start: start
 				}
 			};
 			var myJSON = JSON.stringify(myObj);
 			socket.send(myJSON);
 		}
 
+		/* Turns the FTP start button into a stop button while the server is running */
+		function updateFtpButton(running) {
+			const btn = document.getElementById('ftpModeBtn');
+			btn.setAttribute('data-i18n', running ? 'ftp.start.stopButton' : 'ftp.start.button');
+			btn.onclick = () => ftpSetStatus(running ? 0 : 1);
+			btn.classList.toggle('btn-danger', running);
+			btn.classList.toggle('btn-primary', !running);
+			if (localize) {
+				localize('#ftpModeBtn');
+			}
+		}
+
 		async function mqttSettings(clickedId) {
 			lastIdclicked = clickedId;
 			var val;

src/Ftp.cpp

@@ -95,6 +95,31 @@ void Ftp_EnableServer(void) {
 	}
 }
 
+void Ftp_DisableServer(void) {
+#ifdef FTP_ENABLE
+	if (ftpEnableLastStatus || ftpEnableCurrentStatus) {
+		if (ftpSrv != NULL) {
+			delete ftpSrv; // also closes the listening socket and all client connections
+			ftpSrv = NULL;
+		}
+		ftpEnableLastStatus = false;
+		ftpEnableCurrentStatus = false;
+		Log_Println(ftpServerStopped, LOGLEVEL_NOTICE);
+		System_IndicateOk();
+	} else {
+		System_IndicateError();
+	}
+#endif
+}
+
+bool Ftp_IsServerRunning(void) {
+#ifdef FTP_ENABLE
+	return ftpEnableLastStatus;
+#else
+	return false;
+#endif
+}
+
 // Creates FTP-instance only when requested
 void ftpManager(void) {
 #ifdef FTP_ENABLE

src/Ftp.h

@@ -7,3 +7,5 @@ void Ftp_Init(void);
 void Ftp_Exit(void);
 void Ftp_Cyclic(void);
 void Ftp_EnableServer(void);
+void Ftp_DisableServer(void);
+bool Ftp_IsServerRunning(void);

src/LogMessages_DE.cpp

@@ -173,6 +173,7 @@ const char trackPausedAtPos[] = "Titel pausiert bei Position: %u (%u)";
 const char freeHeapWithoutFtp[] = "Freier Heap-Speicher vor FTP-Instanzierung: %u";
 const char freeHeapWithFtp[] = "Freier Heap-Speicher nach FTP-Instanzierung: %u";
 const char ftpServerStarted[] = "FTP-Server gestartet";
+const char ftpServerStopped[] = "FTP-Server gestoppt";
 const char freeHeapAfterSetup[] = "Freier Heap-Speicher nach Setup-Routine";
 const char tryStaticIpConfig[] = "Statische IP-Konfiguration wird durchgeführt...";
 const char staticIPConfigFailed[] = "Statische IP-Konfiguration fehlgeschlagen";

src/LogMessages_EN.cpp

@@ -175,6 +175,7 @@ const char freeHeapWithoutFtp[] = "Free heap before FTP-allocation: %u";
 const char freeHeapWithFtp[] = "Free heap after FTP-allocation: %u";
 const char freeHeapAfterSetup[] = "Free heap after setup";
 const char ftpServerStarted[] = "FTP-Server started";
+const char ftpServerStopped[] = "FTP-Server stopped";
 const char tryStaticIpConfig[] = "Performing IP-configuration...";
 const char staticIPConfigFailed[] = "IP-configuration failed";
 const char wakeUpRfidNoCard[] = "Wakeup caused by low power card-detection. RF-field changed but no known card on reader was found. So I'll return back to sleep now...";

src/LogMessages_FR.cpp

@@ -173,6 +173,7 @@ const char freeHeapWithoutFtp[] = "Espace libre avant l'allocation FTP : %u";
 const char freeHeapWithFtp[] = "Espace libre après l'allocation FTP : %u";
 const char freeHeapAfterSetup[] = "Espace libre après la configuration";
 const char ftpServerStarted[] = "Serveur FTP démarré";
+const char ftpServerStopped[] = "Serveur FTP arrêté";
 const char tryStaticIpConfig[] = "Configuration IP statique en cours...";
 const char staticIPConfigFailed[] = "Échec de la configuration IP statique";
 const char wakeUpRfidNoCard[] = "Réveil causé par la détection de carte à faible puissance. Le champ RF a changé mais aucune carte connu sur le lecteur n'a été trouvée. Je vais donc retourner en mode veille maintenant...";

src/Web.cpp

@@ -872,7 +872,10 @@ WebsocketCodeType JSONToSettings(JsonObject doc) {
 		uint8_t _ftpStart = doc["ftpStatus"]["start"].as<uint8_t>();
 		if (_ftpStart == 1) { // ifdef FTP_ENABLE is checked in Ftp_EnableServer()
 			Ftp_EnableServer();
+		} else {
+			Ftp_DisableServer();
 		}
+		Web_SendWebsocketData(0, WebsocketCodeType::FtpStatus); // broadcast new status to all clients
 	}
 	if (doc["mqtt"].is<JsonObject>()) {
 		uint8_t _mqttEnable = doc["mqtt"]["enable"].as<uint8_t>();
@@ -1613,6 +1616,9 @@ void Web_SendWebsocketData(uint32_t client, WebsocketCodeType code) {
 		object["bt_scan"] = "in_progress";
 	} else if (code == WebsocketCodeType::BluetoothScanComplete) {
 		object["bt_scan"] = "complete";
+	} else if (code == WebsocketCodeType::FtpStatus) {
+		JsonObject entry = object["ftpStatus"].to<JsonObject>();
+		entry["running"] = Ftp_IsServerRunning();
 	};
 
 	if (doc.overflowed()) {
@@ -1647,6 +1653,7 @@ void onWebsocketEvent(AsyncWebSocket *server, AsyncWebSocketClient *client, AwsE
 		Log_Printf(LOGLEVEL_DEBUG, "ws[%s][%u] connect", server->url(), client->id());
 		// Send initial operation mode and RSSI to newly connected client
 		Web_SendWebsocketData(client->id(), WebsocketCodeType::OperationMode);
+		Web_SendWebsocketData(client->id(), WebsocketCodeType::FtpStatus);
 		// client->printf("Hello Client %u :)", client->id());
 		// client->ping();
 	} else if (type == WS_EVT_DISCONNECT) {