node-red-contrib-knx-ultimate/tutorial/knxUltimateHATranslator-teleprompter.txt

Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.

INTRO
HEY FRIENDS!
TODAY WE CONFIGURE THE KNX ULTIMATE HOME ASSISTANT TRANSLATOR.
IT CONVERTS PHRASES LIKE ON OR OPEN INTO TRUE OR FALSE FOR KNX.

USE CASES
PERFECT FOR HOME ASSISTANT AUTOMATIONS, VOICE COMMANDS, OR MQTT TOPICS.

IO OVERVIEW
ONE INPUT, ONE OUTPUT.
THE NODE REWRITES THE SPECIFIED MESSAGE PROPERTY AND PASSES IT ALONG.

CORE SETUP
OPTIONALLY NAME THE NODE.
SET WHICH PROPERTY TO TRANSLATE, DEFAULT IS PAYLOAD.
EDIT THE TRANSLATION TABLE: EACH LINE IS INCOMING COLON OUTGOING.

DEFAULT MAP
ON GOES TO TRUE, OFF TO FALSE.
OPEN TO TRUE, CLOSED TO FALSE.
HOME TO TRUE, NOT HOME TO FALSE.
NUMBERS ZERO AND ONE ARE HANDLED TOO.

HOW IT WORKS
THE NODE MATCHES VALUES CASE INSENSITIVELY.
WHEN A MATCH EXISTS IT REPLACES THE PROPERTY WITH THE NEW VALUE.
IF NOTHING MATCHES, THE MESSAGE PASSES THROUGH UNCHANGED.

EDITING TIPS
ONE MAP PER LINE.
YOU CAN USE COMMENTS STARTING WITH HASH TO DOCUMENT RULES.

WORKFLOW IDEAS
EXAMPLE: BINARY SENSOR STATES FROM HOME ASSISTANT TO KNX LIGHT OUTPUTS.
EXAMPLE: PRESENCE TRACKING HOME VERSUS NOT HOME TO TRIGGER KNX SCENES.
EXAMPLE: OPEN OR CLOSE COMMANDS FOR SHUTTERS TRANSLATED TO BOOLEANS.

BEST PRACTICES
KEEP THE TABLE CLEAN AND GROUPED.
PLACE THE TRANSLATOR EARLY SO DOWNSTREAM NODES RECEIVE CONSISTENT DATA.

WRAP UP
WE CONFIGURED THE INPUT PROPERTY AND THE TRANSLATION TABLE.
LIKE, SUBSCRIBE, AND SHARE YOUR FAVORITE HOME ASSISTANT PHRASES.
SEE YOU NEXT TIME!