TapHome script language
Multi-line scripting language with syntax highlighting is now available in smart rules Equation, Formula and Script and in Modbus.
doc_tap_taphome_script_language_2022.1;
...
Highlights
...
RETURN() function returns final result. If it is not used, result of a last line is used to enable backward compatibility.
...
...
New syntax: Block IF. E.g.:
doc_tap_highlights_2022.1;
Code Block IF X < 5 RETURN(1); ELSEIF X > 10 RETURN(3); ELSE RETURN(0); END
Binary number literal, e.g. “0b101010”
Enhanced IF function; now it supports optional 2 parameters (instead of fixed 3)
New constant NaN (Not a Number). Can be returned as value in case the value is not known. Also available: ISNAN() function.
Comments - must be on a new line, starting with '#' character.
Improved error messages, more descriptive.
doc_tap_highlights2_2022.1;
New functions
...
Bit and byte operations
GETBIT(), GETBITS(), GETBYTE(), SETBYTE(), SETBIT(), SETBITS()
...
BCD operations:
FROMBCD(), TOBCD()
...
Conversion to string:
e.g. conversion of number to hexadecimal string: TOSTRING(10,"X") returns "A"
...
Sleep the script for number of miliseconds: SLEEP()
...
'Last run' debugging data
Every time script runs, Core captures variables at the time of start and when script finishes and these values are presented in "Last run" section of script window.
doc_tap_new_functions_2022.1;
...
doc_tap_new_devices_2022.1;
...
...
Gas: Consumption [m3] or [kW], Demand [m3 / h] or [kWh]
...
Water: Consumption [m3], Demand [m3/h]
...
Rainfall rate [mm / h], RainCounter [mm]
...
Water pressure [bar], e.g. pressure in heating system
...
Water level [m], e.g. water column in tank or well
...
Electric Voltage [V]
...
Electric Current [A]
doc_tap_new_devices1_2022.1;
Mac OS BETA version
Push notifications are supported only when app is running.
No support for SIP intercom and for IP cameras.
Available only as a manual download, no automatic upgrades. Download link: https://drive.google.com/drive/folders/1-imkjDvjvUWMt56GwTqNMsmoovbM-UR0
doc_tap_mac_os_beta_version_2022.1;
Export of device configuration
After configuring inputs and outputs on taphome bus modules, information about zones, serial numbers, names, terminals etc. can be exported to CSV format. Using pivot table, it is possible to format export and create “documentation”, that can be printed.
doc_tap_export_of_device_configuration_2022.1;
...
Access system logs
Logs from access system can now be exported to CSV format in 2 versions:
...
...
Attendance: Check-in and check-out card readers must be defined. System calculates duration of attendance of users each day. Export contains information about each user / card per day.
doc_tap_access_system_logs_2022.1;
Major upgrade of MODBUS communication
New configuration tool: Registers info
Provides overview about last successful and unsuccessful request for each register.
doc_tap_major_upgrade_of_modbus_communication_2022.1;
...
New tool for manual modbus test requests (read and write)doc_tap_major_upgrade_of_modbus_communication1_2022.1;
...
...
User defined XML templates. Configure your modbus device and export it to reusable user-readable XML file that can be used in other installations.
Support for custom info / warning / error messages from scripts, e.g. ADDERROR(2, “Temperature probe not connected“)
Communication errors and Modbus exceptions are now descriptive (e.g. Illegal data address, CRC error, Syntax error, Illegal function, Illegal data value, Slave device busy, Timeout, …)
New hierarchical structure - all devices are organized as children of “module” device. Wrapper devices are no more needed.
Service attributes: read text information (or any other data) from registers that are displayed only in service settings of a module or device.
doc_tap_new_tool_2022.1;
Service actions: add custom actions (scripts) to execute maintenance or configuration of device (e.g. “Filter replaced”, “Set slave ID”, “Reset device”, …)
Every module and device has internal variables, that can be reused within itself or its children
Faster response: improved poll interval response times (originally minimum was 500ms, now it is 50ms)
Device can now indicate that it has no known value (NaN)
New 32bit ByteSwap data types: BigEndianFloatByteSwap, LittleEndianFloatByteSwap, LittleEndianUint32ByteSwap, BigEndianUint32ByteSwap, LittleEndianInt32ByteSwap, BigEndianInt32ByteSwap
New device type Push Button with “Clear on read” logic
Support for electric meter without actual demand, that is calculated from differences in total consumption
Support for multi-line scripts
- Read script can return previous value. Usable for situations, where in time of reading, value is not yet known, but it is not an error and last read value should be returned.
doc_tap_new_tool1_2022.1;
...