This is an old revision of the document!
Generic Commands
When an object is added to the System, and if this object allows it, a list of commands related to this object will be accessible to be used on a generic button, inside the logic module, in a universal gateway, etc.
The commands are grouped into 5 categories:
The category will only be visible if the related objects have been added inside the System tab.
Figure 1: Thinknx Objects Commands
The available commands when selecting the System category are the following:
Send KNX Bit telegram
This command is used to send a 1 bit value to the KNX bus.
Send KNX Byte Telegram
This command is used to send a 1 byte value to the KNX bus.
A generic button can be configured to send a fixed dimming value to a dimming circuit, for example sending the value 128 to make the light go to 50%.
Send KNX Float 2 Byte Telegram
This command is used to send a 2 byte float value to the KNX bus.
A generic button can be configured to send a fixed temperature value to a thermostat, for example sending the value 21.5 as a setpoint.
Send KNX Float 4 Byte Telegram
This command is used to send a 4 byte float value to the KNX bus.
Send KNX String Telegram
This command is used to send a string of 14 bytes to the KNX bus.
Send KNX 4 Bit Telegram
This command is used to send a 4 bit value to the KNX bus.
A generic button can be configured to decrease (value 0-7) or increase ( value 8-15) a light dimming value. It can also be used to change a shutter position (use values 0-7 for UP, and 8-15 for DOWN). For example, sending the value 5 to a dimmer will decrease the brightness by 6%, while sending the value 10 to a shutter will lower its position by 50%.
Read KNX group address
This command is used to read a value from the KNX bus.
Make a pause for a fixed interval
This command pauses the system for a specified time interval configurable in milliseconds.
When saving a scene, sometimes a pause between two commands is necessary, for example, when saving the TV channel number. Another use of the Pause application would be before turning off the final light in a Goodbye scene, making sure that the client has left the house.
Change UI Function and Page: GENERAL
This command allows to redirect all clients to a specific function and page.
Using the Universal Gateway, a scenario can be configured to redirect the users to the Main Entrance camera page whenever the doorbell rings.
Change UI Function and Page: SPECIFIC CLIENT
This command allows the specific client who has sent it to access a certain function and page.
Invisible generic buttons can be placed on the house plan for each room, allowing every single client to navigate through the rooms by clicking on each area.
Send Push Notification
This command allows to send push notifications to the clients. By accessing the web page of the server and clicking on Server –> Licenses and Codes, it is possible to enable/disable the receipt of push notifications for each client.
Using the Universal Gateway, a push notification can be sent to the client when a 1-bit value is received from the bus to indicate that the Water Tank Level is low. The message in that case can be “Low Water Level!”. If the 1-bit is being sent periodically to the bus with a small interval, then a maximum number of push notifications can be inserted in the related parameter.
Execute MS Windows Command: GENERAL
This command allows to launch an .exe file directly from the ThinKnx application on all Players for Windows.
Execute MS Windows Command: SPECIFIC CLIENT
This command allows to launch an .exe file directly from the ThinKnx application on all Players for Windows.
Recall iOS app with url
This property allows to launch a specific application on iOS devices directly from the ThinKnx app by typing the related URL.
A generic button can be configured for the client to open another application on the iOS device.
Send Email to recipients
This command allows to send an email message using a default ThinKnx account.
If the client's house is empty and a presence has been detected inside (1-bit KNX telegram), a scenario can be programmed on the Universal Gateway to send an email to the owner of the house.
This command might not work properly. Instead, add an Email Account under System tab, and select the command “send email to recipient” that can be found in the Internal Services. See this section for more information.
Send DTMF tone during intercom call
This command allows to send a DTMF tone used in telephony while an intercom call is running on the client.
A generic button can be configured in the Intercom page to send a DTMF tone to open the main gate whenever a call is established.
Make SIP call
When using the Thinknx server as PBX, it is possible to make internal calls between all the devices.
A house owner can have a generic button on his application to call the extension of the touch screen installed in Kitchen to communication with the help.
Start audio notification sound in all the clients
This command allows to play an audio sound in all the clients.
An emergency push button can be installed in bathrooms to send a KNX 1-bit value. Using the Universal Gateway, this value received can launch the command to start audio notification on all clients.
Stop audio notification sound in all clients
This command allows to stop the audio sound previously launched in all clients.
See above command for example.
Reports and Gateways
The list below contains all the possible objects that could be added to the Reports and Gateways category:
Figure 2: Reports and Gateways
Gateway Modbus
The available commands when selecting the Gateway Modbus category under Reports and Gateways are the following:
Send Modbus value with function 5
This function is used to send a value to a Modbus device supporting function 5, known as “write single coil”.
Send Modbus value with function 6
This function is used to send a value to a Modbus device supporting function 6, known as “Write Single Holding Register”.
Send Modbus value with function 16
This function is used to send a value to a Modbus device supporting function 16, known as “Write Multiple Holding Registers”.
Send Modbus value with function 22
This function is used to send a value to a Modbus device supporting function 22. The function can be used to set or clear individual bits in the register.
Lutron Project
Serial Gateway
Ethernet Gateway
The available commands when selecting the Ethernet Gateway category under Reports and Gateways are the following:
Make an HTTP GET call to a specified url
This command allows the sending of an HTTP GET request to execute a command.
Make an HTTP GET call to a specified url with username and password
This command allows the sending of an HTTP GET request execute a command.
Make an HTTP POST call to a specified url
This command allows the sending of an HTTP POST request to send data to a certain sever in order to execute a command.
Make an HTTP POST call to a specified url with username and password
This command allows the sending of an HTTP POST request to send data to a certain sever in order to execute a command. The server in this case requires a username and password.
Send string with no termination to TCP socket
This command allows the sending of a string to a TCP host on a defined port.
Send string with CR termination to TCP socket
This command allows the sending of a string with CR termination, marking the end of the line, to a TCP host on a defined port.
Send hexadecimal string with no termination to TCP socket
This command allows the sending of an hexadecimal string to a TCP host on a defined port.
To send “hello world”, it is enough to convert this ASCII text to HEX using a simple tool such as https://www.rapidtables.com/convert/number/ascii-to-hex.html, and the HEX string to send would be “68 65 6c 6c 6f 20 77 6f 72 6c 64”.
Send hexadecimal string with CR termination to TCP socket
This command allows the sending of a string with CR termination, marking the end of the line, to a TCP host on a defined port.
To send “hello world”, it is enough to convert this ASCII text to HEX using a simple tool such as https://www.rapidtables.com/convert/number/ascii-to-hex.html, and the HEX string to send would be “68 65 6c 6c 6f 20 77 6f 72 6c 64”.
Send string with no termination to UDP socket
This command allows the sending of an hexadecimal string to a UDP host on a defined port.
Send string with CR termination to UDP socket
This command allows the sending of a string with CR termination, marking the end of the line, to a UDP host on a defined port.
Send hexadecimal string with no termination to UDP socket
This command allows the sending of an hexadecimal string to a UDP host on a defined port.
To send “hello world”, it is enough to convert this ASCII text to HEX using a simple tool such as https://www.rapidtables.com/convert/number/ascii-to-hex.html, and the HEX string to send would be “68 65 6c 6c 6f 20 77 6f 72 6c 64”.
Send hexadecimal string with CR termination to UDP socket
This command allows the sending of a string with CR termination, marking the end of the line, to a UDP host on a defined port.
To send “hello world”, it is enough to convert this ASCII text to HEX using a simple tool such as https://www.rapidtables.com/convert/number/ascii-to-hex.html, and the HEX string to send would be “68 65 6c 6c 6f 20 77 6f 72 6c 64”.
Send hexadecimal string with no termination to UDP socket in multicast
This command allows the sending of an hexadecimal string to a UDP host supporting multicast on a defined port. The characters should be separated by a space.
To send “hello world”, it is enough to convert this ASCII text to HEX using a simple tool such as https://www.rapidtables.com/convert/number/ascii-to-hex.html, and the HEX string to send would be “68 65 6c 6c 6f 20 77 6f 72 6c 64”.
Send hexadecimal string with CR termination to UDP socket in multicast
This command allows the sending of a string with CR termination, marking the end of the line, to a UDP host supporting multicast on a defined port.
To send “hello world”, it is enough to convert this ASCII text to HEX using a simple tool such as https://www.rapidtables.com/convert/number/ascii-to-hex.html, and the HEX string to send would be “68 65 6c 6c 6f 20 77 6f 72 6c 64”.
Send SOAP request to the specified url
This command allows the sending of a SOAP (Simple Object Access Protocol) request to a URL. SOAP is an XML-based messaging protocol for exchanging information among computers.
Establish SSH session and send commands
This command allows to establish an SSH session with a server to execute certain commands. Secure Socket Shell or SSH, is a network protocol that gives users, particularly system administrators, a secure way to access a computer over an unsecured network.
Application: This session can be used to connect to the home router/access point through Thinknx.
Gateway MyHome
Voice Control Gateway
The available commands when selecting the Voice Control Gateway category under Reports and Gateways are the following:
Restart Homekit gateway
This function is used to restart the Homekit gateway enabled from the server's web page.
IFTTT Account
The available commands when selecting the IFTTT Account category under Reports and Gateways are the following:
Trigger an event with parameters
This function is used to send a command from Thinknx to trigger an event configured on an IFTTT service. The service configured in this case requires certain values before execution.
Trigger an event
This function is used to send a command from Thinknx to trigger an event configured on an IFTTT service.
SMS Gateway
The available commands when selecting the SMS Gateway category under Reports and Gateways are the following:
Send SMS to numbers with text
This function allows the sending of an SMS to multiple phone numbers.
The list below contains all the possible objects that could be added to the Internal Services category:
Figure 3: Internal Services
Scene
After selecting Scene, a list of all the added scenes in System will be shown. The available commands when selecting one of the scenes are the following:
Launch scenery
This command will allow to play the selected scene.
Sop scenery execution
This command will allow to stop a scene during execution.
Presence Simulator
The available commands after selecting Presence Simulator and opening the Simulator tree are the following:
Start the presence simulation
This command allows to start playing the presence simulation configured in the Presence Simulation object in System.
Stop the presence simulation
This command allows to stop playing the presence simulation configured in the Presence Simulation object in System.
Chronothermostat
After selecting Chronothermostat, a list of all the added chronothermostats in System will be shown. The available command when selecting one of the chronothermostats is the following:
Enable/Disable the Chrono modality
This command allows to activate/deactivate the control of the setpoint from the schedule configured by the client.
Email Account
After selecting Email Account, a list of all the email accounts created in System will be shown. The available command when selecting one of the accounts is the following:
Send Email to recipients
This command allows to send an email to a group of recipients.
Irrigation
The available command after selecting Irrigation and opening the “Chrono-Irrigation” is the following:
Enable/Disable the Chrono modality
This command allows to activate/deactivate the functioning of the irrigation zones from the schedule configured by the client.
RGB
The list below contains all the possible objects that could be added to the Internal Services category:
Video Matrix
Audio Matrix
Display
After selecting Display, a list of all the displays added in System will be shown. The available commands when selecting one of the displays are the following:
Set the TV channel number
This command will allow to change the TV channel to the desired channel entered inside the parameter.
Set the video source
This command will allow to set the video source on the TV.
On or standby the device
This command will allow to turn ON the TV or put it to Standby mode.
Set the audio volume
This command will allow to send a value to the TV volume.
Set the audio volume up
This command will allow to raise the volume on the TV.
Set the audio volume down
This command will allow to lower the volume on the TV.
Home Theater
Sonos Manager
IR Transmitter
After selecting IR Transmitter, a list of all the transmitters created in the System tab will be shown. The available commands when selecting one of the transmitters are the following:
Send the selected command for the selected remote
This command will allow to send an IR command by selecting it from the list to the right. It is possible to send multiple commands by pressing “Enqueue” and choosing another one from the list, as well as adding a pause between the commands.
The Output Option will allow the user to send the IR commands to the selected outputs of the IR transmitter.
The list below contains all the possible objects that could be added to the Security category:
Alarm Device
Centrale