Defines the how the register value is obtained or calculated. For
register where dev
is local
, this is one of:
A local sensor name: L1
-L3
, Ldc
, or
S1
-S30
.
A power formula written as a sum of products of sensors. For
example, S1*L1+S2*L2
would indicate that the register value
is calculated as the real power measured by current sensor
S1
and line-voltage L1
plus the real power measured by
current sensor S2
and line-voltage L2
. Note that even
though the real power calculation is indicated by an asterisk,
it is actually calculated by averaging the product of the
instantaneous current and voltage samples, not by multiplying
the RMS voltages of S1
and L1
. The first factor of each
real power calculation may also be negated. For example,
-S1*L2
would yield the negative of the real power calculated
by S1*L2
.
An equal sign (=
) followed by an
eScript expression. The register
value is obtained by evaluating the eScript expression once
per update interval.
Non-finite numbers (e.g., not-a-number, or infinities) are
silently converted to 0 before recording the register value.
For registers where dev
is not local
, so-called remote
registers, the value is interpreted in a way that is specific to
the particular remote device in use. Commonly, the value is some
sort of register name or identifier. For example, for Modbus
remote devices, the value is a register name defined by the
Modbus map of the remote device.
reg required | string The name of a register. |
Normal response.
Unauthorized response.
{- "result": "S16*L1+S17*L2",
- "error": "Error message (present if an error occurred)."
}
reg required | string The name of a register. |
Defines the how the register value is obtained or calculated. For
register where dev
is local
, this is one of:
A local sensor name: L1
-L3
, Ldc
, or
S1
-S30
.
A power formula written as a sum of products of sensors. For
example, S1*L1+S2*L2
would indicate that the register value
is calculated as the real power measured by current sensor
S1
and line-voltage L1
plus the real power measured by
current sensor S2
and line-voltage L2
. Note that even
though the real power calculation is indicated by an asterisk,
it is actually calculated by averaging the product of the
instantaneous current and voltage samples, not by multiplying
the RMS voltages of S1
and L1
. The first factor of each
real power calculation may also be negated. For example,
-S1*L2
would yield the negative of the real power calculated
by S1*L2
.
An equal sign (=
) followed by an
eScript expression. The register
value is obtained by evaluating the eScript expression once
per update interval.
Non-finite numbers (e.g., not-a-number, or infinities) are
silently converted to 0 before recording the register value.
For registers where dev
is not local
, so-called remote
registers, the value is interpreted in a way that is specific to
the particular remote device in use. Commonly, the value is some
sort of register name or identifier. For example, for Modbus
remote devices, the value is a register name defined by the
Modbus map of the remote device.
Normal response.
Unauthorized response.
"S16*L1+S17*L2"
{- "status": "OK",
- "error": "Error message (present if an error occurred)."
}
reg required | string The name of a register. |
Defines the how the register value is obtained or calculated. For
register where dev
is local
, this is one of:
A local sensor name: L1
-L3
, Ldc
, or
S1
-S30
.
A power formula written as a sum of products of sensors. For
example, S1*L1+S2*L2
would indicate that the register value
is calculated as the real power measured by current sensor
S1
and line-voltage L1
plus the real power measured by
current sensor S2
and line-voltage L2
. Note that even
though the real power calculation is indicated by an asterisk,
it is actually calculated by averaging the product of the
instantaneous current and voltage samples, not by multiplying
the RMS voltages of S1
and L1
. The first factor of each
real power calculation may also be negated. For example,
-S1*L2
would yield the negative of the real power calculated
by S1*L2
.
An equal sign (=
) followed by an
eScript expression. The register
value is obtained by evaluating the eScript expression once
per update interval.
Non-finite numbers (e.g., not-a-number, or infinities) are
silently converted to 0 before recording the register value.
For registers where dev
is not local
, so-called remote
registers, the value is interpreted in a way that is specific to
the particular remote device in use. Commonly, the value is some
sort of register name or identifier. For example, for Modbus
remote devices, the value is a register name defined by the
Modbus map of the remote device.
Normal response.
Unauthorized response.
"S16*L1+S17*L2"
{- "status": "OK",
- "error": "Error message (present if an error occurred)."
}
Reset to empty string.
reg required | string The name of a register. |
Normal response.
Unauthorized response.
{- "status": "OK",
- "error": "Error message (present if an error occurred)."
}