From 67c8b2f4724fc7009e76955ae5544de06b92c004 Mon Sep 17 00:00:00 2001
From: Gerhard Hoffmann <g.hoffmann@atb-online.eu>
Date: Sat, 9 Sep 2023 14:55:48 +0200
Subject: [PATCH] Extended comment: USING THE BOOTLOADER.

---
 update.cpp | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/update.cpp b/update.cpp
index e54b20c..f29c168 100644
--- a/update.cpp
+++ b/update.cpp
@@ -460,6 +460,13 @@ bool Update::downloadBinaryToDC(QString const &bFile) const {
                         //             10: OK
 
  10 :   bl_stopBL()     // leave bl and start (the new) application
+                        //
+                        // NOTE: this function MUST work under all conditions.
+                        // Alas, there is no direct result for this command, so
+                        // the only way of knowing it was successful is to ask
+                        // the device if the bootloader is still running.
+                        // There is no problem to repeat this command until the
+                        // bootloader is really not running anymore.
  */
 bool Update::updateBinary(char const *fileToSendToDC) {
     qInfo() << "UPDATING DEVICE CONTROLLER BINARY" << fileToSendToDC;