IP telegram description
TecControl
TecControl turns your PC or touch panel into the actuator of your smart home.
Start any program automatically or via your visualization, play sounds and music, and much more.
You can send all commands via our free TecTool logic modules for Gira Home/FacilityServer. Download at: www.SmartHomeTools.de
Basic telegrams
"TecControl;Restart" Performs a restart.
"TecControl;Shutdown" Shuts down the relevant system.
"TecControl;Standby" Sets the system to standby.
"TecControl;Hybernate" Puts the system into standby mode.
"TecControl;DisplayOn" Activates the display.
"TecControl;DisplayOff" Switches the display off.
"TecControl;Sound;test.wav " Plays a .wav file in the Sounds folder.
All commands from the "Plus" scope are listed below:
Program control
"TecControl;Program;c:\program\text.exe" Starts any program.
"TecControl;Program;c:\program\text.exe;/f/a" Passes additional parameters.
Sound control
"TecControl;Sound;test.mp3" Controls an .mp3 file in the Sounds folder.
"TecControl;Sound;test.mp3;Stop”
"TecControl;Sound;test.wav ;Start" Plays the sound as a continuous loop.
"TecControl;Sound;test.wav ;Stop" Stops the continuous loop.
"TecControl;Volume;80 Sets the Windows system volume.
Window control
Control any windows/programs in Windows. The window name does not have to be entered in full. The first window that matches will be controlled accordingly. Therefore, the more exact the window name, the more reliable the control.
"TecControl;window;fetch;<window title>"
"TecControl;window;minimize;<window title>"
"TecControl;window;maximize;<window title>"
"TecControl;window;normal;<window title>"
"TecControl;window;restore;<window title>"
"TecControl;window;close;<window title>"
Further commands
"TecControl;Keyboard" Starts the on-screen keyboard.
"TecControl;Ping" The TecTool immediately responds to this command with a UDP telegram "PingAntwort" to the sender IP address. The port corresponds to the set +1. "Device monitoring" must be activated in the TecTool. A corresponding template for the Gira HomeServer can be found in our download area.
"TecControl;DisplayBrightness;100" Sets the brightness of the monitor. A value of 0-100 is possible.
"TecControl;TTS;<text>;<voice>" Speaks the text specified in the "Text" placeholder. The voice installed in the system can be selected with "Voice". Default = 1.
"TecControl;Design;<0/1>" Controls the background of the Visu Starter start screen between black and white when the Gira QuadClient visualization is set.
TecControl;BatteryInfo " The TecTool responds to this command with:
"AkkuAntwort;<Charge in %>;<remaining term in minutes>;<on the charger 1/0>" and can be used, for example, to extend the service life of a battery in touch panels/notebooks/tablets by controlling the charger via a switching actuator.
„TecControl;WindowsKeyOn“ Activates the window key.
„TecControl;WindowsKeyOff“ Deactivates the window key.
„TecControl;SwipeGesturesOn“ Activates the swipe gestures.
„TecControl;SwipeGesturesOff“ Deactivates the swipe gestures.
„TecControl;WriteProtectionOn“ Activates the write protection.
„TecControl;WriteProtectionOff“ Deactivates the write protection.
Remote software commands
AnyDesk and TeamViewer are possible. In the following examples, AnyDesk can also be replaced by TeamViewer. The corresponding "RemoteSoftware" must be selected in the TecTool.
"AnyDesk;Query" The TecTool responds to this command immediately with a UDP telegram "AnyDeskAntwort:<1 or 0>" to the sender IP address, depending on the status of the Windows service. The port corresponds to the set +1.
"AnyDesk;On" Activates the Windows service of AnyDesk. The TecTool responds to this command immediately with a UDP telegram "AnyDeskAntwort:<1 or 0>" depending on the status of the Windows service as feedback to the sender IP address. The port corresponds to the set +1. The "RemoteSoftware" must be selected in the TecTool.
"AnyDesk;Off" Deactivates the Windows service of AnyDesk and prevents remote access via the program. The TecTool responds to this command immediately with a UDP telegram "AnyDeskAntwort:<1 or 0>" depending on the status of the Windows service as feedback to the sender IP address. The port corresponds to the set +1. The "RemoteSoftware" must be selected in the TecTool.
TecMessage
The telegram is structured as followed:
TecMessage;<Tt>;<Mt> Standard
TecMessage;<Tt>;<Mt>;<Td> Transfer design
TecMessage;<Tt>;<Mt>;<Tc><Ttc><Mc><Mtc> Design definition
<Tt> Title text
The desired text in the title bar is transferred here, e.g. "Alarm".
<Mt> Message text
The message text is displayed in the main window of the pop-up.
<Td> Temporary design
If an individual message is to be displayed in a different design than the one set in the tool, this can be transferred at the end. The following values are currently available:
"TecS" Design TecSupport
"GnSw" Design Gira QuadClient - old design
"WsBl" Design white/blue
“Alert" Design red for e.g. alarms
"QCschwarz" Design Gira QuadClient black - New design
"QCweiss " Design Gira QuadClient white - New design
<Tc> Title color
Defines the background color of the title bar. The color is transferred as a HEX value.
<Ttc> Title text color
Defines the text color of the title bar. The color is transferred as a HEX value.
<Mc> Message window color
Defines the color of the text window. The color is transferred as a HEX value.
<Mtc> Message window text color
Defines the text color of the text window. The color is transferred as a HEX value.
The display is activated with every TecMessage pop-up!
PLUS features
These include the display of very long texts by automatically displaying a scroll bar for overlong text, as well as complete freedom from advertising in all pop-up messages. In addition, line breaks can be inserted into the text by using an * (asterisk).
Examples
Standard Simple pop-up in the selected design
"TecMessage;Note;Motion detected in yard"
Transfer design Alarm popup with transferred design
"TecMessage;Attention;Burglar alarm front door;Alert"
Design definition Popup with free design
"TecMessage;Weather warning;It's below 3 degrees Celsius this morning;#000088;#000000;#0088FF;#000000"
TecMessage PLUS Ad-free, line break, long text
"TecMessage;Advanced functions;A *new line* is created here. You can also write text of any length, e.g. instructions, in a message."
You can find colors as HEX values here: https://en.wikipedia.org/wiki/Web_colors.
TecStick
TecStick;<MODUS>;<BYTE-R>;<BYTE-G>;<BYTE-B>;<OPTION>
<MODUS>
The mode defines the type of color display.
Four types are currently available:
LEDAus The stick is switched off.
LEDLeuchten Permanently lit
LEDBlinken Flashing
LEDPulsieren Alternative flashing through soft dimming.
<BYTE-R>;<BYTE-G>;<BYTE-B>
These three 1-byte positions define the desired color and are NOT transferred with the "LEDAus" mode.
<OPTION>
This last digit can be used to change the flashing speed in "LEDBlinken" mode. If the value is not transferred, 500ms is set. The possible setting range is between 50 and 1500ms.
Examples
TecStick;LEDAus LED Off.
TecStick;LEDLeuchten;255;255;255 LED lights up in bright white.
TecStick;LEDBlinken;127;0;0 LED flashing in red with 50% brightness.
TecStick;LEDBlinken;74;4;123;50 Very fast flashing in purple.
TecStick;LEDPulsieren;123;4;74 Pulsing in pink .
Compatible Blinksticks
Nano, Square and Strip.
Gira HomeServer logic module
The logic modules are very easy to use. TecControl has a basic module that is connected to the function modules. Some of these, such as sound, program and window, can be connected multiple times.