node-red-contrib-knx-ultimate 7.0.3 → 7.1.0-beta.0

package/CHANGELOG.md

@@ -6,6 +6,17 @@
 
 # CHANGELOG
 
+**Version 7.1.0-beta.0** - September 2026<br/>
+
+- New **KNX Utility** node with eleven functions, including Home Assistant Translator, and conversion of legacy nodes.<br/>
+- Automatic flow backup before converting KNX and HUE nodes.<br/>
+- Simple **KNX Viewer** telegram list with 24-hour history saved to file.<br/>
+- KNX Engine updated to 6.0.6.<br/>
+
+**Version 7.0.4** - September 2026<br/>
+
+- KNX Engine bump to 6.0.5.<br/>
+
 **Version 7.0.3** - September 2026<br/>
 
 - Fixed some wrong translations.<br/>

package/README.md

@@ -8,7 +8,9 @@
 
 KNX Ultimate is the most advanced KNX integration for Node-RED, providing secure KNX/IP communication, routing, ETS project import, Philips Hue, Matter Controller and Matter Bridge (control matter device via KNX and expose KNX GA via Matter), MQTT, diagnostics, virtual devices, and powerful automation nodes. Build professional, reliable, and scalable smart home and building automation projects with minimal effort.
 
+**KNX Utility** brings eleven functions into one palette node: Alerter, AutoResponder, DateTime, WatchDog, GlobalContext, Logger, Staircase, Garage, SceneController, LoadControl and Home Assistant Translator. Select a function to get its editor, icon and ports; KNX Device remains the main node. Home Assistant Translator converts message values to booleans without requiring a KNX gateway. Existing dedicated nodes continue to work. The migration button converts all compatible nodes in every flow and subflow, preserving IDs, settings, connections, saved scenes and values. Before KNX or HUE conversion, the browser automatically starts downloading a dated JSON backup of all current editor flows using the standard Node-RED export format, without declared credentials. Conversion supports a single Undo and waits for you to Deploy. See the [KNX Utility guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/KNX-Utility), localized node help and the [example flow with all eleven functions](examples/KNX%20Utility%20-%20All%20functions.json).
 
+**KNX Viewer** opens a simple ETS-style list of group address state changes, with time, telegram type (Read, Write, Response), source, GA, name, DPT, previous value and new value. Read requests are also recorded, without changing the last known GA value. Search the history or pause the live view; the node keeps recording to local files and retains the last 24 hours across Node-RED restarts. See the [KNX Viewer guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/knxUltimateViewer).
 
 The former bundled AI assistant has moved to the standalone [Cerebrum Ultimate](https://github.com/Supergiovane/node-red-contrib-cerebrum-ultimate) package. Cerebrum Ultimate now provides the conversational, learning and supervised home-intelligence features, while using KNX Ultimate as an optional compatible integration. Hidden legacy runtime types remain in this package only so existing Node-RED flows continue to load; new installations should add the Cerebrum node from the standalone package.
 

package/examples/HA Translator - Payload Conversion.json

@@ -2,7 +2,7 @@
   {
     "id": "ha_tab",
     "type": "tab",
-    "label": "KNX HA Translator",
+    "label": "KNX Utility - HA Translator",
     "disabled": false,
     "info": ""
   },
@@ -11,25 +11,29 @@
     "type": "comment",
     "z": "ha_tab",
     "name": "Translate Home Assistant-like strings to booleans",
-    "info": "",
+    "info": "Home Assistant Translator runs inside KNX Utility with no gateway. Deploy this example and click an inject button: the output payload is converted to a boolean, preserving the other message fields.",
     "x": 350,
     "y": 60,
     "wires": []
   },
   {
     "id": "ha_node",
-    "type": "knxUltimateHATranslator",
+    "type": "knxUltimateUtility",
     "z": "ha_tab",
     "name": "HA Translator",
     "payloadPropName": "payload",
-    "commandText": "on:true\noff:false\nopen:true\nclosed:false\nhome:true\nnot_home:false",
     "x": 560,
     "y": 220,
     "wires": [
       [
         "ha_dbg"
       ]
-    ]
+    ],
+    "utilityType": "hatranslator",
+    "inputs": 1,
+    "outputs": 1,
+    "server": "",
+    "haTranslationTable": "on:true\noff:false\nopen:true\nclosed:false\nhome:true\nnot_home:false"
   },
   {
     "id": "ha_on",
@@ -51,7 +55,9 @@
     "x": 180,
     "y": 180,
     "wires": [
-      "ha_node"
+      [
+        "ha_node"
+      ]
     ]
   },
   {
@@ -74,7 +80,9 @@
     "x": 180,
     "y": 220,
     "wires": [
-      "ha_node"
+      [
+        "ha_node"
+      ]
     ]
   },
   {
@@ -97,7 +105,9 @@
     "x": 180,
     "y": 260,
     "wires": [
-      "ha_node"
+      [
+        "ha_node"
+      ]
     ]
   },
   {

package/examples/KNX Utility - All functions.json

@@ -0,0 +1,389 @@
+[
+  {
+    "id": "utility-examples",
+    "type": "tab",
+    "label": "KNX Utility examples"
+  },
+  {
+    "id": "utility-guide",
+    "type": "comment",
+    "z": "utility-examples",
+    "name": "Configure a KNX gateway for bus functions; Translator works without one",
+    "info": "Each KNX Utility instance has one function. This flow shows all eleven functions. Select a gateway and configure addresses for bus functions before deploying. Home Assistant Translator converts message values without a gateway; see the HA Translator - Payload Conversion example for a ready-to-run flow. Alerter has three outputs, Logger has two, and AutoResponder, DateTime and GlobalContext have no flow ports. GlobalContext uses its name for global variables, so keep KNXGlobalContext or choose letters only. AutoResponder starts with an empty list. DateTime schedules and Logger automatic output timers are disabled; WatchDog automatic start is disabled. No example supplies KNX group addresses. LoadControl uses message control. Read the selected function help before enabling it.",
+    "x": 340,
+    "y": 80,
+    "wires": []
+  },
+  {
+    "id": "utility-alert",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "name": "Alerter",
+    "utilityType": "alerter",
+    "server": "",
+    "inputs": 1,
+    "outputs": 3,
+    "rules": [],
+    "whentostart": "ifnewalert",
+    "timerinterval": "2",
+    "initialreadGAInRules": "1",
+    "x": 180,
+    "y": 180,
+    "wires": [
+      [
+        "utility-debug-each"
+      ],
+      [
+        "utility-debug-all"
+      ],
+      [
+        "utility-debug-last"
+      ]
+    ]
+  },
+  {
+    "id": "utility-response",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "name": "AutoResponder",
+    "utilityType": "autoresponder",
+    "server": "",
+    "inputs": 0,
+    "outputs": 0,
+    "commandText": "[]",
+    "x": 190,
+    "y": 340,
+    "wires": []
+  },
+  {
+    "id": "utility-datetime",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "name": "Date / Time",
+    "utilityType": "datetime",
+    "server": "",
+    "inputs": 0,
+    "outputs": 0,
+    "gaDateTime": "",
+    "gaDate": "",
+    "gaTime": "",
+    "dptDateTime": "19.001",
+    "dptDate": "11.001",
+    "dptTime": "10.001",
+    "sendOnDeploy": false,
+    "sendOnDeployDelay": 30,
+    "periodicSend": false,
+    "periodicSendInterval": 60,
+    "periodicSendUnit": "m",
+    "x": 190,
+    "y": 400,
+    "wires": []
+  },
+  {
+    "id": "utility-debug-each",
+    "type": "debug",
+    "z": "utility-examples",
+    "name": "Each alerted device",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 470,
+    "y": 140,
+    "wires": []
+  },
+  {
+    "id": "utility-debug-all",
+    "type": "debug",
+    "z": "utility-examples",
+    "name": "All alerted devices",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 470,
+    "y": 200,
+    "wires": []
+  },
+  {
+    "id": "utility-debug-last",
+    "type": "debug",
+    "z": "utility-examples",
+    "name": "Last alerted device",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 470,
+    "y": 260,
+    "wires": []
+  },
+  {
+    "server": "",
+    "topic": "",
+    "maxRetry": 6,
+    "retryInterval": 10,
+    "name": "WatchDog",
+    "autoStart": false,
+    "listenToKnxUltimateNodeErrors": true,
+    "checkLevel": "Ethernet",
+    "id": "utility-watchdog",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "utilityType": "watchdog",
+    "inputs": 1,
+    "outputs": 1,
+    "x": 200,
+    "y": 490,
+    "wires": [
+      []
+    ]
+  },
+  {
+    "server": "",
+    "name": "KNXGlobalContext",
+    "exposeAsVariable": "exposeAsVariableREADWRITE",
+    "writeExecutionInterval": 1000,
+    "contextStorage": "",
+    "id": "utility-globalcontext",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "utilityType": "globalcontext",
+    "inputs": 0,
+    "outputs": 0,
+    "x": 200,
+    "y": 560,
+    "wires": []
+  },
+  {
+    "server": "",
+    "topic": "",
+    "intervalCreateETSXML": 15,
+    "name": "Logger",
+    "autoStartTimerCreateETSXML": false,
+    "maxRowsInETSXML": 0,
+    "saveMode": "emit",
+    "filePath": "",
+    "autoStartTimerTelegramCounter": false,
+    "intervalTelegramCount": 60,
+    "id": "utility-logger",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "utilityType": "logger",
+    "inputs": 1,
+    "outputs": 2,
+    "x": 200,
+    "y": 630,
+    "wires": [
+      [],
+      []
+    ]
+  },
+  {
+    "server": "",
+    "name": "Staircase",
+    "outputtopic": "",
+    "gaTrigger": "",
+    "nameTrigger": "",
+    "dptTrigger": "1.001",
+    "gaOutput": "",
+    "nameOutput": "",
+    "dptOutput": "1.001",
+    "gaStatus": "",
+    "nameStatus": "",
+    "dptStatus": "1.001",
+    "gaOverride": "",
+    "nameOverride": "",
+    "dptOverride": "1.001",
+    "gaBlock": "",
+    "nameBlock": "",
+    "dptBlock": "1.001",
+    "timerSeconds": 120,
+    "extendMode": "restart",
+    "triggerOffCancels": "yes",
+    "preWarnEnable": false,
+    "preWarnSeconds": 15,
+    "preWarnMode": "status",
+    "preWarnFlashMs": 400,
+    "blockAction": "off",
+    "emitEvents": false,
+    "id": "utility-staircase",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "utilityType": "staircase",
+    "inputs": 1,
+    "outputs": 1,
+    "x": 200,
+    "y": 700,
+    "wires": [
+      []
+    ]
+  },
+  {
+    "server": "",
+    "name": "Garage",
+    "outputtopic": "",
+    "gaCommand": "",
+    "nameCommand": "",
+    "dptCommand": "1.001",
+    "gaImpulse": "",
+    "nameImpulse": "",
+    "dptImpulse": "1.017",
+    "gaHoldOpen": "",
+    "nameHoldOpen": "",
+    "dptHoldOpen": "1.001",
+    "gaDisable": "",
+    "nameDisable": "",
+    "dptDisable": "1.001",
+    "gaPhotocell": "",
+    "namePhotocell": "",
+    "dptPhotocell": "1.001",
+    "gaMoving": "",
+    "nameMoving": "",
+    "dptMoving": "1.001",
+    "gaObstruction": "",
+    "nameObstruction": "",
+    "dptObstruction": "1.001",
+    "autoCloseEnable": true,
+    "autoCloseSeconds": 120,
+    "emitEvents": false,
+    "id": "utility-garage",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "utilityType": "garage",
+    "inputs": 1,
+    "outputs": 1,
+    "x": 200,
+    "y": 770,
+    "wires": [
+      []
+    ]
+  },
+  {
+    "server": "",
+    "name": "Scene Controller",
+    "outputtopic": "",
+    "topic": "",
+    "dpt": "",
+    "topicTrigger": "true",
+    "topicSave": "",
+    "dptSave": "",
+    "topicSaveTrigger": "true",
+    "rules": [],
+    "id": "utility-scenecontroller",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "utilityType": "scenecontroller",
+    "inputs": 1,
+    "outputs": 1,
+    "x": 200,
+    "y": 840,
+    "wires": [
+      []
+    ]
+  },
+  {
+    "server": "",
+    "name": "Load Control",
+    "controlMode": "msg",
+    "topic": "",
+    "dpt": "",
+    "wattLimit": 3000,
+    "sheddingCheckInterval": 15,
+    "sheddingRestoreDelay": 60,
+    "GA1": "",
+    "DPT1": "",
+    "Name1": "",
+    "autoRestore1": true,
+    "MonitorGA1": "",
+    "MonitorDPT1": "",
+    "MonitorName1": "",
+    "GA2": "",
+    "DPT2": "",
+    "Name2": "",
+    "autoRestore2": true,
+    "MonitorGA2": "",
+    "MonitorDPT2": "",
+    "MonitorName2": "",
+    "GA3": "",
+    "DPT3": "",
+    "Name3": "",
+    "autoRestore3": true,
+    "MonitorGA3": "",
+    "MonitorDPT3": "",
+    "MonitorName3": "",
+    "GA4": "",
+    "DPT4": "",
+    "Name4": "",
+    "autoRestore4": true,
+    "MonitorGA4": "",
+    "MonitorDPT4": "",
+    "MonitorName4": "",
+    "GA5": "",
+    "DPT5": "",
+    "Name5": "",
+    "autoRestore5": true,
+    "MonitorGA5": "",
+    "MonitorDPT5": "",
+    "MonitorName5": "",
+    "id": "utility-loadcontrol",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "utilityType": "loadcontrol",
+    "inputs": 1,
+    "outputs": 1,
+    "x": 200,
+    "y": 910,
+    "wires": [
+      []
+    ]
+  },
+  {
+    "id": "utility-hatranslator",
+    "type": "knxUltimateUtility",
+    "z": "utility-examples",
+    "name": "HA Translator",
+    "payloadPropName": "payload",
+    "x": 220,
+    "y": 1000,
+    "wires": [
+      [
+        "utility-ha-debug"
+      ]
+    ],
+    "utilityType": "hatranslator",
+    "inputs": 1,
+    "outputs": 1,
+    "server": "",
+    "haTranslationTable": "on:true\noff:false\nopen:true\nclosed:false\nhome:true\nnot_home:false"
+  },
+  {
+    "id": "utility-ha-debug",
+    "type": "debug",
+    "z": "utility-examples",
+    "name": "Translated HA boolean",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 520,
+    "y": 1000,
+    "wires": []
+  }
+]

package/nodes/commonFunctions.js

@@ -3,7 +3,6 @@
 const oOS = require('os')
 const fs = require('fs')
 const path = require('path')
-const yaml = require('js-yaml')
 const dptlib = require('knxultimate').dptlib
 const customHTTP = require('./utils/http')
 const KNXClient = require('knxultimate').KNXClient
@@ -281,8 +280,8 @@ module.exports = (RED) => {
       }
     })
 
-    // 2025-12 Download logger XML file configured in a knxUltimateLogger node
-    RED.httpAdmin.get('/knxUltimateLoggerDownload', normalizeAuthFromAccessTokenQuery, RED.auth.needsPermission('knxUltimate-config.read'), (req, res) => {
+    // Shared Logger download for legacy nodes and the private Utility profile.
+    const downloadLoggerFile = (req, res) => {
       try {
         const nodeId = (req.query.nodeId || req.query.id || '').toString()
         if (!nodeId) {
@@ -316,7 +315,9 @@ module.exports = (RED) => {
         try { RED.log.error(`KNXUltimateLoggerDownload error: ${error.message}`) } catch (e) {}
         if (!res.headersSent) res.status(500).json({ error: 'UNEXPECTED_ERROR' })
       }
-    })
+    }
+    RED.httpAdmin.get('/knxUltimateLoggerDownload', normalizeAuthFromAccessTokenQuery, RED.auth.needsPermission('knxUltimate-config.read'), downloadLoggerFile)
+    RED.httpAdmin.get('/knxUltimateUtility/logger/download', normalizeAuthFromAccessTokenQuery, RED.auth.needsPermission('knxUltimate-config.read'), downloadLoggerFile)
 
     // 2025-09 List interfaces (IA) from KNX Secure keyring
     RED.httpAdmin.get('/knxUltimateKeyringInterfaces', RED.auth.needsPermission('knxUltimate-config.read'), async (req, res) => {

package/nodes/knxUltimateAlerter.html

@@ -1,9 +1,11 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateAlerter', {
-        category: "KNX Ultimate",
-        color: '#C7E9C0',
+        category: 'deprecated',
+        color: '#E5F0E2',
         defaults: {
             //buttonState: {value: true},
             server: { type: "knxUltimate-config", required: false },
@@ -24,9 +26,9 @@
         },
         icon: "node-alerter-icon.svg",
         label: function () {
-            return (this.outputRBE == true ? "|rbe| " : "") + (this.name || this.topic || "KNX Alerter") + (this.inputRBE == true ? " |rbe|" : "")
+            return (this.outputRBE == true ? "|rbe| " : "") + (this.name || this.topic || "KNX Alerter") + (this.inputRBE == true ? " |rbe|" : "") + " (deprecated)"
         },
-        paletteLabel: "KNX Alerter",
+        paletteLabel: "KNX Alerter (deprecated)",
         // button: {
         //     enabled: function() {
         //         // return whether or not the button is enabled, based on the current
@@ -191,6 +193,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateAlerter">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateAlerter.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateAlerter.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateAlerter.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/knxUltimateAutoResponder.html

@@ -1,9 +1,11 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateAutoResponder', {
-        category: "KNX Ultimate",
-        color: '#C7E9C0',
+        category: 'deprecated',
+        color: '#E5F0E2',
         defaults: {
             //buttonState: {value: true},
             server: { type: "knxUltimate-config", required: true },
@@ -16,9 +18,9 @@
         outputs: 0,
         icon: "node-knx-icon.svg",
         label: function () {
-            return (this.name || "KNX Auto Responder");
+            return (this.name || "KNX Auto Responder") + " (deprecated)";
         },
-        paletteLabel: "KNX Auto Responder",
+        paletteLabel: "KNX Auto Responder (deprecated)",
         // button: {
         //     enabled: function() {
         //         // return whether or not the button is enabled, based on the current
@@ -77,6 +79,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateAutoResponder">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateAutoResponder.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateAutoResponder.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateAutoResponder.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>

package/nodes/knxUltimateDateTime.html

@@ -1,3 +1,5 @@
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/flowMigrationBackup.js"></script>
+<script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/knxUtilityMigration.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 
 <script type="text/javascript">
@@ -266,8 +268,8 @@
   }
 
   RED.nodes.registerType('knxUltimateDateTime', {
-    category: 'KNX Ultimate',
-    color: '#C7E9C0',
+    category: 'deprecated',
+    color: '#E5F0E2',
     defaults: {
       server: { type: 'knxUltimate-config', required: true },
       name: { value: '' },
@@ -291,13 +293,13 @@
     outputs: 0,
     icon: 'node-knx-icon.svg',
     label: function () {
-      return this.name || 'KNX DateTime'
+      return (this.name || 'KNX DateTime') + ' (deprecated)'
     },
     paletteLabel: function () {
       try {
-        return RED._('node-red-contrib-knx-ultimate/knxUltimateDateTime:knxUltimateDateTime.paletteLabel') || 'DateTime'
+        return RED._('node-red-contrib-knx-ultimate/knxUltimateDateTime:knxUltimateDateTime.paletteLabel') || 'DateTime (deprecated)'
       } catch (error) {
-        return 'DateTime'
+        return 'DateTime (deprecated)'
       }
     },
     onadd: function () {
@@ -484,6 +486,15 @@
 </script>
 
 <script type="text/html" data-template-name="knxUltimateDateTime">
+  <div class="form-row knx-utility-legacy-notice" role="note" style="box-sizing:border-box; padding:10px 12px; margin-bottom:12px; border-left:4px solid #d79b00; background:#fff8df; color:#4d3a00;">
+    <i class="fa fa-exclamation-triangle" aria-hidden="true"></i>
+    <span data-i18n="knxUltimateDateTime.legacy_notice"></span>
+  </div>
+  <div class="form-row knx-utility-legacy-migration-action" style="margin-bottom:14px;">
+    <button type="button" class="red-ui-button knx-utility-migrate-flow" style="background:#d97706; border-color:#b45309; color:#fff !important; font-weight:700;" data-i18n="[title]knxUltimateDateTime.migration_button_title">
+      <i class="fa fa-exchange" style="color:#fff !important;"></i> <span style="color:#fff !important;" data-i18n="knxUltimateDateTime.migration_button"></span>
+    </button>
+  </div>
   <div class="form-row" style="margin-bottom:10px;">
     <span style="color:#ff0000"><i class="fa fa-youtube"></i></span>&nbsp;<a target="_blank" href="https://www.youtube.com/playlist?list=PL9Yh1bjbLAYrU8PsVhW4xzEug2WtVFv3E"><b>KNX-Ultimate video tutorials (YouTube playlist)</b></a>
   </div>