Type Definitions
ColumnHeader
- Description:
- Custom Driver table Column Header
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
label |
string | The table column label. Max 30 Characters | |
unit |
string |
<optional> |
The Unit of measurement of the column values (eg %). Max 10 characters |
valueType |
ValueType |
<optional> |
The value of the column values (used for display purposes) |
Custom Driver table Column Header
Type:
- Object
ConfigurationBackup
- Description:
- Custom Driver configuration backup Validated version is returned by D.createBackup, should be passed to D.success()
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
label |
string |
<optional> |
The name of the backup, default is "Custom Driver Configuration Backup" |
running |
string | The configuration currently running on the device, must be less than 1mb | |
startup |
string |
<optional> |
The optional configuration which will be active when the device is restarted, must be less than 1mb |
ignoredLines |
Array.<string> |
<optional> |
List of regular expressions They are used to decide if a line should be considered when comparing configurations for misalignment. The regex engine directly substitutes the match text with an empty string. Do not pass flags in the regex, the format is not supported. |
Custom Driver configuration backup
Validated version is returned by D.createBackup, should be passed to D.success()
Type:
- Object
DriverTableResult
- Description:
- Custom Driver table Result
Properties:
Name | Type | Description |
---|---|---|
label |
string | The table Label. Max 50 characters |
columnHeaders |
Array.<ColumnHeader> | The column headers list |
rows |
Array.<Array.<any>> | The table rows |
Custom Driver table Result
Type:
- Object
ErrorResult
- Description:
- Used when the result of a call towards a device is in an erroneous state
Properties:
Name | Type | Description |
---|---|---|
message |
string | The Error Message |
Used when the result of a call towards a device is in an erroneous state
Type:
- Object
ErrorType
- Description:
- Known Domotz Context Error types
Properties:
Name | Type | Description |
---|---|---|
TOO_MANY_VARIABLES_ERROR |
string | Too many variables have been defined in this driver execution |
MISSING_DEVICE_ERROR |
string | No device was found for execution |
RESOURCE_UNAVAILABLE |
string | The Resource you are trying to access is not available |
AUTHENTICATION_ERROR |
string | Authentication with the device has failed |
PARSING_ERROR |
string | Failed to parse the response |
TIMEOUT_ERROR |
string | The remote call has resulted in a timeout |
IMPORT_NOT_ALLOWED |
string | Import statements are not allowed in the sandbox environment |
REQUIRE_NOT_ALLOWED |
string | Require statements are not allowed in the sandbox environment |
GENERIC_ERROR |
string | A Generic/Unknown error has occurred |
Known Domotz Context Error types
Example
D.errorType.TIMEOUT_ERROR
SshAlgorithms
- Description:
- The SSH authentication algorithm parameters
Properties:
Name | Type | Description |
---|---|---|
kex |
Array.<string> | A List of SSH key exchange methods to use |
cipher |
Array.<string> | A List of SSH ciphers to use |
The SSH authentication algorithm parameters
Type:
- Object
Example
{
cipher: [
'aes128-gcm',
'aes128-gcm@openssh.com',
'aes256-gcm',
'aes256-gcm@openssh.com'
],
kex: [
'diffie-hellman-group-exchange-sha1',
'diffie-hellman-group-exchange-sha256',
'ecdh-sha2-nistp256',
'ecdh-sha2-nistp384',
'ecdh-sha2-nistp521'
]
}
ValueType
- Description:
- Domotz variable value types
Properties:
Name | Type | Description |
---|---|---|
STRING |
string | String value |
NUMBER |
string | Numerical value |
DATETIME |
string | Datetime value |
RATE |
string | A numeric value that changes over time in an increasing manner. Only the rate of change is calculated and stored |
MONOTONE_RATE |
string | A numeric value similar to the RATE type but ignoring values lower than the previous collected value in the rate of change comparison |
Domotz variable value types
Example
D.valueType.RATE
Variable
- Description:
- Custom Driver variable Created via D.createVariable
Properties:
Name | Type | Description |
---|---|---|
uid |
string | The identifier of the variable. Must be Unique. Max 50 characters
cannot be one of the following reserved words: "table", "column", "history" |
name |
string | The Name/Label of the variable. Max 100 characters |
value |
string | The Value of the variable. Max 500 characters |
unit |
string | The Unit of measurement of the variable (eg %). Max 10 characters |
valueType |
ValueType | The type of the variable value (used for visualization purposes). |
Custom Driver variable
Created via D.createVariable
Type:
- Object