DLI EPCDC32 Object Model Reference
|
object | relay/ |
Object representing relay state and configuration |
This object contains the following items:
Sample curl
write command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "..." "http://192.168.0.100/restapi/relay/"
Sample uom
library write command:
uom.relay=<...>
string | relay/name/ |
User-visible relay name |
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Sample requests
write command:
requests.put('http://192.168.0.100/restapi/relay/name/',auth=auth,headers=headers,json='My controller')
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/name/',auth=auth,headers=headers).json())
⇒
'My controller'
sum (variant) | relay/online/ |
Relay module online status |
Retrieving the value is denied if not administrative user
This sum does not support direct modification if agent identifier is not equal to relay.
This sum can assume the following values:
constant true | Online | The relay module is online and fully operational, outlets can be switched on unless emergency shutoff is activated | |
constant "degraded" | Degraded | The relay module is online but outlets cannot be switched on due to low-power conditions | |
constant false | Offline | The relay module is offline, outlets cannot be switched on |
Sample CLI write command:
uom set "relay/online" "true"
Sample uom
library read command:
print(uom.dump(uom.relay.online))
⇒
true
string | relay/model/ |
Relay model name |
Retrieving the value is denied if not administrative user
This string does not support direct modification.
This string represents a value in persistent storage.
Sample JS request
read command:
request.get({url:"relay/model/"},function(error,response,body) {console.log(body)});
⇒
"EPCR5"
Sample curl
read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/model/"
⇒
"EPCR5"
string | relay/version/ |
Relay core firmware version number |
Retrieving the value is denied if not administrative user
This string does not support direct modification if agent identifier is not equal to relay.
Sample CLI read command:
uom get "relay/version"
⇒
"1.8.1.0"
Sample JS request
write command:
request.put({url:"relay/version/",body:"1.8.1.0"});
array | relay/outlets/ |
Outlets controlled by the relay |
This array does not support direct modification.
This array represents a value in persistent storage.
This array contains Outlet elements.
Creating elements in this collection is not supported.
Sample JS request
read command:
request.get({url:"relay/outlets/"},function(error,response,body) {console.log(body)});
⇒
<...>
Sample uom
library read command:
print(uom.dump(uom.relay.outlets))
⇒
<...>
object | relay/outlets/N/ |
Object representing outlet state and configuration |
This object contains the following items:
name | Name |
state | Configured state |
transient_state | Transient state |
physical_state | Physical state |
locked | Lock state |
critical | Critical |
cycle_delay | Outlet cycle delay, if any |
cycle | Cycle |
Sample curl
read command (note that :outlet_index
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/outlets/:outlet_index/"
⇒
{"state":true,"critical":true,"cycle_delay":10,"locked":false,"transient_state":true,"physical_state":false,"name":"outlet #17"}
Sample JS request
read command (note that _outlet_index
is a variable):
request.get({url:"relay/outlets/"+_outlet_index.toString()+"/"},function(error,response,body) {console.log(body)});
⇒
{"state":true,"critical":true,"cycle_delay":2,"locked":false,"transient_state":true,"physical_state":false,"name":"outlet #7"}
See also Outlet: Name
See also Outlet: Configured state
See also Outlet: Transient state
See also Outlet: Physical state
See also Outlet: Lock state
See also Outlet: Critical
See also Outlet: Outlet cycle delay, if any
See also Outlet: Cycle
string | relay/outlets/N/name/ |
User-visible outlet name |
Retrieving the value is denied if any of the following is true:
false
true
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Sample curl
read command (note that :outlet_index
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/outlets/:outlet_index/name/"
⇒
"Local alarm lights"
Sample requests
write command (note that _outlet_index
is a variable):
requests.put('http://192.168.0.100/restapi/relay/outlets/'+str(_outlet_index)+'/name/',auth=auth,headers=headers,json='outlet #7')
sum (boolean) | relay/outlets/N/state/ |
Saved configured state of the outlet. Cannot be changed if the outlet is locked |
Retrieving the value is denied if any of the following is true:
false
true
Changing the value is denied if any of the following is true:
false
true
This sum represents a value in persistent storage.
Changes to this sum may have an effect besides setting value.
This sum can assume the following values:
constant true | On | The outlet is powered | |
constant false | Off | The outlet is not powered |
Sample JS request
write command (note that _outlet_index
is a variable):
request.put({url:"relay/outlets/"+_outlet_index.toString()+"/state/",body:true});
Sample uom
library read command (note that _outlet_index
is a variable):
print(uom.dump(uom.relay.outlets[_outlet_index].state))
⇒
false
sum (boolean) | relay/outlets/N/transient_state/ |
Current expected state of the outlet. Cannot be changed if the outlet is locked |
Retrieving the value is denied if any of the following is true:
false
true
Changing the value is denied if any of the following is true:
false
true
This sum can change as if by itself or indirectly because of other actions.
This sum can assume the following values:
constant true | On | The outlet is powered | |
constant false | Off | The outlet is not powered |
Sample CLI write command (note that outlet_index
is a variable):
uom set "relay/outlets/${outlet_index}/transient_state" "false"
Sample JS request
read command (note that _outlet_index
is a variable):
request.get({url:"relay/outlets/"+_outlet_index.toString()+"/transient_state/"},function(error,response,body) {console.log(body)});
⇒
true
sum (boolean) | relay/outlets/N/physical_state/ |
Current actual state of the outlet |
Retrieving the value is denied if any of the following is true:
false
true
Changing the value is denied if agent identifier is not equal to relay
This sum does not support direct modification if agent identifier is not equal to relay.
This sum can assume the following values:
constant true | On | The outlet is powered | |
constant false | Off | The outlet is not powered |
Sample JS request
read command (note that _outlet_index
is a variable):
request.get({url:"relay/outlets/"+_outlet_index.toString()+"/physical_state/"},function(error,response,body) {console.log(body)});
⇒
false
Sample curl
write command (note that :outlet_index
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "true" "http://192.168.0.100/restapi/relay/outlets/:outlet_index/physical_state/"
sum (boolean) | relay/outlets/N/locked/ |
Indicates whether the outlet state is locked from keypad |
Retrieving the value is denied if any of the following is true:
false
true
Changing the value is denied if agent identifier is not equal to relay
This sum represents a value in persistent storage.
This sum can assume the following values:
constant true | Locked | The outlet state cannot be changed | |
constant false | Unlocked | The outlet state can be changed |
Sample uom
library write command (note that _outlet_index
is a variable):
uom.relay.outlets[_outlet_index].locked=true
Sample CLI write command (note that outlet_index
is a variable):
uom set "relay/outlets/${outlet_index}/locked" "false"
sum (boolean) | relay/outlets/N/critical/ |
Flag indicating whether the outlet is critical, and turning it off should ask for confirmation |
Retrieving the value is denied if any of the following is true:
false
true
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant true | Critical | Confirmation requested to change the outlet state | |
constant false | Noncritical | No confirmation is needed to change the outlet state |
Sample uom
library read command (note that _outlet_index
is a variable):
print(uom.dump(uom.relay.outlets[_outlet_index].critical))
⇒
false
Sample JS request
read command (note that _outlet_index
is a variable):
request.get({url:"relay/outlets/"+_outlet_index.toString()+"/critical/"},function(error,response,body) {console.log(body)});
⇒
false
sum (optional number) | relay/outlets/N/cycle_delay/ |
Outlet cycle delay, in seconds, if any |
Retrieving the value is denied if any of the following is true:
false
true
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | Use default cycle delay | Use unit default cycle delay | |
number | Outlet cycle delay | Outlet cycle delay, in seconds | the value is greater than 0 |
Sample curl
read command (note that :outlet_index
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/outlets/:outlet_index/cycle_delay/"
⇒
null
Sample JS request
write command (note that _outlet_index
is a variable):
request.put({url:"relay/outlets/"+_outlet_index.toString()+"/cycle_delay/",body:7});
call | relay/outlets/N/cycle/ |
Turns the outlet off, then on again after the cycle delay passes. Has no effect when the outlet is already off. Signals an error if the outlet is locked. Does not turn the outlet back on if it becomes locked |
Performing the function call is denied if any of the following is true:
false
true
The call has no arguments (supply empty tuple).
The call returns the following results:
Sample curl
invocation (note that :outlet_index
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[]" "http://192.168.0.100/restapi/relay/outlets/:outlet_index/cycle/"
⇒
true
Sample requests
invocation (note that _outlet_index
is a variable):
print(requests.post('http://192.168.0.100/restapi/relay/outlets/'+str(_outlet_index)+'/cycle/',auth=auth,headers=headers,json={}).json())
⇒
True
sum (boolean) | relay/outlets/N/cycle/results: 1/ |
Flag indicating whether the call affected the outlet state |
This sum does not correspond to an actual resource.
This sum can assume the following values:
constant true | Started | The outlet was on and the cycle has started | |
constant false | No action taken | The outlet was off or already in a cycle, so the call had no effect |
call | relay/set_outlet_transient_states/ |
Change transient states of multiple outlets as simultaneously as possible, failing if one of them is not accessible |
Performing the function call is denied if outlet access permissions is equal to false
The call accepts the following arguments:
The call returns the following results:
Sample requests
invocation:
requests.post('http://192.168.0.100/restapi/relay/set_outlet_transient_states/',auth=auth,headers=headers,json=[[[1, True], [3, False], [5, True], [7, True], [12, True], [13, True], [19, False], [22, True], [29, False], [31, False]]])
⇒
(no output)
Sample uom
library invocation:
uom.relay.set_outlet_transient_states({{3,false},{4,true},{8,true},{9,false},{11,false},{12,true},{17,true},{19,true},{22,false},{27,false},{29,false},{31,false}})
⇒
(no output)
array | relay/set_outlet_transient_states/arguments: 1/ |
Desired pin transient state configurations |
The value is subject to the following constraints: 0
elements of all values of the value are distinct
This array does not correspond to an actual resource.
This array contains Pin transient state configuration elements.
See also Pin transient state configurations: Pin transient state configuration
constant null | relay/set_outlet_transient_states/results: 1/ |
No additional information available |
This constant does not correspond to an actual resource.
tuple | relay/set_outlet_transient_states/arguments: 1/N/ |
Desired pin transient state configuration |
This tuple does not correspond to an actual resource.
This tuple contains the following items:
1 | Outlet index |
2 | Transient state |
number | relay/set_outlet_transient_states/arguments: 1/N/1/ |
Index of the outlet to be configured |
The value is subject to the following constraints: all of the following is true:
true
This number does not correspond to an actual resource.
sum (boolean) | relay/set_outlet_transient_states/arguments: 1/N/2/ |
Desired actual state of the outlet |
This sum does not correspond to an actual resource.
This sum can assume the following values:
constant true | On | The outlet is powered | |
constant false | Off | The outlet is not powered |
number | relay/sequence_delay/ |
Time after switching an outlet on during which switching outlets on is delayed to prevent simultaneous inrush currents on power-on |
The value represents time, the standard unit of which is the second (s).
The value is subject to the following constraints: the value is greater or equal to minimal ON sequence delay
Changing the value is denied if not administrative user
This number represents a value in persistent storage.
Sample uom
library write command:
uom.relay.sequence_delay=3
Sample CLI read command:
uom get "relay/sequence_delay"
⇒
6
number | relay/min_sequence_delay/ |
The minimal time after switching an outlet on during which switching outlets on is delayed |
The value represents time, the standard unit of which is the second (s).
The value is subject to the following constraints: the value is greater or equal to 0
This number does not support direct modification.
This number represents a value in persistent storage.
Sample curl
read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/min_sequence_delay/"
⇒
1
Sample JS request
read command:
request.get({url:"relay/min_sequence_delay/"},function(error,response,body) {console.log(body)});
⇒
1
number | relay/cycle_delay/ |
Time between switching an outlet off and turning it back on during cycling, which allows the controlled device to really power down |
The value represents time, the standard unit of which is the second (s).
The value is subject to the following constraints: the value is greater than 0
Changing the value is denied if not administrative user
This number represents a value in persistent storage.
Sample JS request
read command:
request.get({url:"relay/cycle_delay/"},function(error,response,body) {console.log(body)});
⇒
2
Sample uom
library read command:
print(uom.dump(uom.relay.cycle_delay))
⇒
8
number | relay/relatch/ |
Time to wait before relatching relays on brown-out |
The value represents time, the standard unit of which is the second (s).
The value is subject to the following constraints: the value is greater than 0
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This number represents a value in persistent storage.
Sample CLI write command:
uom set "relay/relatch" "1"
Sample uom
library write command:
uom.relay.relatch=9
sum (enumerated number) | relay/recovery_mode/ |
Outlet power-off recovery state policy |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant 0 | All outlets off | All outlets remain powered off at power-up | |
constant 1 | All outlets on | All outlets are switched on in sequence during power-up | |
constant 2 | Pre-powerloss state | Outlets are returned to configured pre-powerloss state during power-up |
Sample uom
library read command:
print(uom.dump(uom.relay.recovery_mode))
⇒
1
Sample CLI write command:
uom set "relay/recovery_mode" "0"
number | relay/measurement_interval/ |
Time between meter value fetches |
The value represents time, the standard unit of which is the second (s).
The value is subject to the following constraints: the value is greater than 0
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This number represents a value in persistent storage.
Sample uom
library read command:
print(uom.dump(uom.relay.measurement_interval))
⇒
3
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/measurement_interval/',auth=auth,headers=headers).json())
⇒
10
array | relay/buses/ |
Buses powering the relay |
This array does not support direct modification.
This array represents a value in persistent storage.
This array contains Bus elements.
Creating elements in this collection is not supported.
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/buses/',auth=auth,headers=headers).json())
⇒
Sample JS request
read command:
request.get({url:"relay/buses/"},function(error,response,body) {console.log(body)});
⇒
object | relay/buses/N/ |
Object representing bus state and configuration |
This object contains the following items:
Sample JS request
write command (note that _bus_index
is a variable):
request.put({url:"relay/buses/"+_bus_index.toString()+"/",body:{"outlet_indices":[0,1,2,3],"voltage_affects_outlets":[1,2,3],"max_current":5,"current_affects_outlets":[0],"max_voltage":null,"min_voltage":60}});
Sample JS request
read command (note that _bus_index
is a variable):
request.get({url:"relay/buses/"+_bus_index.toString()+"/"},function(error,response,body) {console.log(body)});
⇒
{"outlet_indices":[4,5,6,7],"voltage_affects_outlets":[0,1,2,3],"max_current":14,"current_affects_outlets":[0,1,2,3],"max_voltage":null,"min_voltage":60}
See also Bus: Outlet list
See also Bus: Voltage-affected outlets
See also Bus: Minimum voltage, if any
See also Bus: Maximum voltage, if any
See also Bus: Current-affected outlets
See also Bus: Maximum current, if any
array | relay/buses/N/outlet_indices/ |
List of outlets connected to the bus |
This array is composite, i.e. is modified as a whole.
This array does not support direct modification.
This array represents a value in persistent storage.
This array represents an unordered set (order of its elements doesn't matter, and each value should not be supplied more than once).
This array contains Outlet index elements.
Creating elements in this collection is not supported.
Sample JS request
read command (note that _bus_index
is a variable):
request.get({url:"relay/buses/"+_bus_index.toString()+"/outlet_indices/"},function(error,response,body) {console.log(body)});
⇒
[0,1,2,3]
Sample curl
read command (note that :bus_index
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/buses/:bus_index/outlet_indices/"
⇒
[0,1,2,3]
number | relay/buses/N/outlet_indices/N/ |
Index of outlet connected to the bus |
The value is subject to the following constraints: all of the following is true:
This number is a part of a composite value which is modified as a whole.
This number does not support direct modification.
This number represents a value in persistent storage.
Sample CLI read command (note that bus_index
and outlet_index_index
are variables):
uom get "relay/buses/${bus_index}/outlet_indices/${outlet_index_index}"
⇒
6
Sample curl
read command (note that :bus_index
and :outlet_index_index
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/buses/:bus_index/outlet_indices/:outlet_index_index/"
⇒
4
array | relay/buses/N/voltage_affects_outlets/ |
List of outlets affected by over/undervoltage |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This array is composite, i.e. is modified as a whole.
This array represents a value in persistent storage.
This array represents an unordered set (order of its elements doesn't matter, and each value should not be supplied more than once).
This array contains Outlet list index elements.
Sample CLI outlet list index creation command (note that bus_index
is a variable):
uom insert "relay/buses/${bus_index}/voltage_affects_outlets/1" "1"
Sample requests
write command (note that _bus_index
is a variable):
requests.put('http://192.168.0.100/restapi/relay/buses/'+str(_bus_index)+'/voltage_affects_outlets/',auth=auth,headers=headers,json=[1, 2, 3])
number | relay/buses/N/voltage_affects_outlets/N/ |
Index of outlet in the bus outlet list |
The value is subject to the following constraints: all of the following is true:
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This number is a part of a composite value which is modified as a whole.
Sample CLI deletion command (note that bus_index
and outlet_list_index_index
are variables):
uom remove "relay/buses/${bus_index}/voltage_affects_outlets/${outlet_list_index_index}"
Sample uom
library write command (note that _bus_index
and _outlet_list_index_index
are variables):
uom.relay.buses[_bus_index].voltage_affects_outlets[_outlet_list_index_index]=2
sum (optional number) | relay/buses/N/min_voltage/ |
The minimum voltage, below which the affected bus outlets are switched off, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | No minimum voltage | Undervoltage doesn't affect any outlets | |
number | Minimum voltage | The minimum voltage, below which the affected bus outlets are switched off | the value is greater or equal to 0 |
Sample curl
write command (note that :bus_index
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "60" "http://192.168.0.100/restapi/relay/buses/:bus_index/min_voltage/"
Sample requests
write command (note that _bus_index
is a variable):
requests.put('http://192.168.0.100/restapi/relay/buses/'+str(_bus_index)+'/min_voltage/',auth=auth,headers=headers,json=60)
sum (optional number) | relay/buses/N/max_voltage/ |
The maximum voltage, above which the affected bus outlets are switched off, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | No maximum voltage | Overvoltage doesn't affect any outlets | |
number | Maximum voltage | The maximum voltage, above which the affected bus outlets are switched off | the value is greater or equal to 0 |
Sample CLI read command (note that bus_index
is a variable):
uom get "relay/buses/${bus_index}/max_voltage"
⇒
null
Sample uom
library read command (note that _bus_index
is a variable):
print(uom.dump(uom.relay.buses[_bus_index].max_voltage))
⇒
null
array | relay/buses/N/current_affects_outlets/ |
List of outlets affected by overcurrent |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This array is composite, i.e. is modified as a whole.
This array represents a value in persistent storage.
This array represents an unordered set (order of its elements doesn't matter, and each value should not be supplied more than once).
This array contains Outlet list index elements.
Sample curl
outlet list index creation command (note that :bus_index
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "0" "http://192.168.0.100/restapi/relay/buses/:bus_index/current_affects_outlets/"
Sample uom
library write command (note that _bus_index
is a variable):
uom.relay.buses[_bus_index].current_affects_outlets={0,1,2,3}
number | relay/buses/N/current_affects_outlets/N/ |
Index of outlet in the bus outlet list |
The value is subject to the following constraints: all of the following is true:
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This number is a part of a composite value which is modified as a whole.
Sample curl
deletion command (note that :bus_index
and :outlet_list_index_index
are URL template arguments):
curl --digest -u admin:1234 -H "X-CSRF: x" -X DELETE -H "Accept: application/json" "http://192.168.0.100/restapi/relay/buses/:bus_index/current_affects_outlets/:outlet_list_index_index/"
Sample JS request
read command (note that _bus_index
and _outlet_list_index_index
are variables):
request.get({url:"relay/buses/"+_bus_index.toString()+"/current_affects_outlets/"+_outlet_list_index_index.toString()+"/"},function(error,response,body) {console.log(body)});
⇒
0
sum (optional number) | relay/buses/N/max_current/ |
The maximum current, above which the affected bus outlets are switched off, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | No maximum current | Overcurrent doesn't affect any outlets | |
number | Maximum current | The maximum current, above which the affected bus outlets are switched off | the value is greater or equal to 0 |
Sample uom
library read command (note that _bus_index
is a variable):
print(uom.dump(uom.relay.buses[_bus_index].max_current))
⇒
5
Sample requests
read command (note that _bus_index
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/buses/'+str(_bus_index)+'/max_current/',auth=auth,headers=headers).json())
⇒
14
map | relay/ports/ |
I/O ports attached to the relay |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map does not support direct modification if agent identifier is not equal to relay.
This map contains I/O port elements.
Sample curl
read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/ports/"
⇒
Sample CLI I/O port creation command:
uom insert "relay/ports/uart_ootid2hlj1x" "{\"latest_received\":{\"d\":\"EE48911F\"},\"type\":\"uart\",\"name\":\"uart_ootid2hlj1x\",\"accept\":{\"d\":true},\"configuration\":{\"baudrate\":\"66\",\"stop_bits\":\"1.5\"}}"
object | relay/ports/S/ |
Object representing an I/O port and its channels |
This object contains the following items:
Sample uom
library deletion command (note that _i_o_port
is a variable):
uom.remove(uom.relay.ports,_i_o_port)
Sample requests
write command (note that _i_o_port
is a variable):
requests.put('http://192.168.0.100/restapi/relay/ports/'+_i_o_port+'/',auth=auth,headers=headers,json={'latest_received': {'d': 'CE3F5B'}, 'type': 'uart', 'name': 'uart_a', 'accept': {'d': True}, 'configuration': {'stop_bits': '2', 'char_size': '7'}})
See also I/O port: Name
See also I/O port: Type
See also I/O port: Configuration
See also I/O port: Data reception mask
See also I/O port: Send data
See also I/O port: Latest received data
See also I/O port: Get receive history
See also I/O port: Clear received data history
string | relay/ports/S/name/ |
User-visible port name |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Sample uom
library write command (note that _i_o_port
is a variable):
uom.relay.ports[_i_o_port].name="uart_pnxu0eu8ve5c"
Sample requests
read command (note that _i_o_port
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/ports/'+_i_o_port+'/name/',auth=auth,headers=headers).json())
⇒
'uart_2'
string | relay/ports/S/type/ |
Port type |
The value is subject to the following constraints: port types[the value]
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string does not support direct modification if agent identifier is not equal to relay.
Sample uom
library write command (note that _i_o_port
is a variable):
uom.relay.ports[_i_o_port].type="uart"
Sample curl
write command (note that :i_o_port
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "\"uart\"" "http://192.168.0.100/restapi/relay/ports/:i_o_port/type/"
map | relay/ports/S/configuration/ |
Port configuration |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map represents a value in persistent storage.
This map can change as if by itself or indirectly because of other actions.
This map contains Configuration value elements.
Sample requests
configuration value creation command (note that _i_o_port
is a variable):
requests.put('http://192.168.0.100/restapi/relay/ports/'+_i_o_port+'/configuration/stop_bits/',auth=auth,headers=headers,json='1.5')
Sample requests
read command (note that _i_o_port
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/ports/'+_i_o_port+'/configuration/',auth=auth,headers=headers).json())
⇒
{'baudrate': '7702'}
string | relay/ports/S/configuration/S/ |
Value of a configuration item |
The value is subject to the following constraints: the value matches port types[type].data_items[index of the value].regexp
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
Sample requests
read command (note that _i_o_port
and _configuration_value
are variables):
print(requests.get('http://192.168.0.100/restapi/relay/ports/'+_i_o_port+'/configuration/'+_configuration_value+'/',auth=auth,headers=headers).json())
⇒
'M'
Sample curl
deletion command (note that :i_o_port
and :configuration_value
are URL template arguments):
curl --digest -u admin:1234 -H "X-CSRF: x" -X DELETE -H "Accept: application/json" "http://192.168.0.100/restapi/relay/ports/:i_o_port/configuration/:configuration_value/"
map | relay/ports/S/accept/ |
Mask of channels to receive data from |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map represents a value in persistent storage.
This map contains Enable elements.
Sample uom
library read command (note that _i_o_port
is a variable):
print(uom.dump(uom.relay.ports[_i_o_port].accept))
⇒
{}
Sample curl
enable creation command (note that :i_o_port
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "true" "http://192.168.0.100/restapi/relay/ports/:i_o_port/accept/d/"
constant true | relay/ports/S/accept/S/ |
Enable reception from this channel |
The value is subject to the following constraints: port types[type].channels[index of the value]
Sample CLI read command (note that i_o_port
and enable
are variables):
uom get "relay/ports/${i_o_port}/accept/${enable}"
⇒
true
Sample JS request
deletion command (note that _i_o_port
and _enable
are variables):
request.delete({url:"relay/ports/"+_i_o_port+"/accept/"+_enable+"/"});
call | relay/ports/S/send/ |
Write data to port's channels |
Performing the function call is denied if not administrative user
The call accepts the following arguments:
The call returns the following results:
Sample uom
library invocation (note that _i_o_port
is a variable):
uom.relay.ports[_i_o_port].send()
⇒
(no output)
Sample CLI invocation (note that i_o_port
is a variable):
uom invoke "relay/ports/${i_o_port}/send"
⇒
(no output)
map | relay/ports/S/send/arguments: 1/ |
Data to write, indexed by channel |
This map does not correspond to an actual resource.
This map contains Data string elements.
string | relay/ports/S/send/arguments: 1/S/ |
Channel send data, hex-encoded |
The value is subject to the following constraints: all of the following is true:
This string does not correspond to an actual resource.
constant null | relay/ports/S/send/results: 1/ |
No additional information available |
This constant does not correspond to an actual resource.
map | relay/ports/S/latest_received/ |
Latest data received, indexed by channel |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map is composite, i.e. is modified as a whole.
This map does not support direct modification if agent identifier is not equal to relay.
Changes to this map may have an effect besides setting value.
This map contains Data string elements.
Sample requests
data string creation command (note that _i_o_port
is a variable):
requests.put('http://192.168.0.100/restapi/relay/ports/'+_i_o_port+'/latest_received/d/',auth=auth,headers=headers,json='52')
Sample curl
data string creation command (note that :i_o_port
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "\"131DEA\"" "http://192.168.0.100/restapi/relay/ports/:i_o_port/latest_received/d/"
string | relay/ports/S/latest_received/S/ |
Channel received data, hex-encoded |
The value is subject to the following constraints: all of the following is true:
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string is a part of a composite value which is modified as a whole.
This string does not support direct modification if agent identifier is not equal to relay.
Changes to this string may have an effect besides setting value.
Sample requests
write command (note that _i_o_port
and _data_string
are variables):
requests.put('http://192.168.0.100/restapi/relay/ports/'+_i_o_port+'/latest_received/'+_data_string+'/',auth=auth,headers=headers,json={})
Sample JS request
write command (note that _i_o_port
and _data_string
are variables):
request.put({url:"relay/ports/"+_i_o_port+"/latest_received/"+_data_string+"/",body:"DBC77813"});
number | relay/ports/S/get_receive_history/results: 1/N/1/ |
Timestamp of the received data |
The value represents time, the standard unit of which is the second (s).
This number does not correspond to an actual resource.
map | relay/ports/S/get_receive_history/results: 1/N/2/ |
Historical data received, indexed by channel |
This map does not correspond to an actual resource.
This map contains Data string elements.
string | relay/ports/S/get_receive_history/results: 1/N/2/S/ |
Channel received data, hex-encoded |
The value is subject to the following constraints: all of the following is true:
This string does not correspond to an actual resource.
This string does not support direct modification if agent identifier is not equal to relay.
Changes to this string may have an effect besides setting value.
call | relay/ports/S/get_receive_history/ |
Get history of data received over a specific time range |
Performing the function call is denied if not administrative user
The call accepts the following arguments:
The call returns the following results:
Sample uom
library invocation (note that _i_o_port
is a variable):
print(uom.dump(uom.relay.ports[_i_o_port].get_receive_history(1234526102,1234599633)))
⇒
Sample curl
invocation (note that :i_o_port
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[1234513446,null]" "http://192.168.0.100/restapi/relay/ports/:i_o_port/get_receive_history/"
⇒
[[1234548782.6667,{"d":""}]]
sum (optional number) | relay/ports/S/get_receive_history/arguments: 1/ |
Requested timestamp of the first data element to retrieve, if any |
This sum does not correspond to an actual resource.
This sum can assume the following values:
constant null | Beginning of time | Return data starting from the oldest available | |
number | Data start time | Requested timestamp of the first data element to retrieve |
sum (optional number) | relay/ports/S/get_receive_history/arguments: 2/ |
Requested timestamp of the last data element to retrieve, if any |
This sum does not correspond to an actual resource.
This sum can assume the following values:
constant null | Now | Return data up to the most recent available | |
number | Data end time | Requested timestamp of the last data element to retrieve |
array | relay/ports/S/get_receive_history/results: 1/ |
Historical received data elements |
This array does not correspond to an actual resource.
This array contains Received data element elements.
tuple | relay/ports/S/get_receive_history/results: 1/N/ |
Historical data element received |
This tuple does not correspond to an actual resource.
This tuple contains the following items:
1 | Reception time |
2 | Received data |
See also Received data element: Reception time
See also Received data element: Received data
call | relay/ports/S/clear_receive_history/ |
Clear the complete history of received data |
Performing the function call is denied if not administrative user
The call has no arguments (supply empty tuple).
The call returns the following results:
Sample uom
library invocation (note that _i_o_port
is a variable):
uom.relay.ports[_i_o_port].clear_receive_history()
⇒
(no output)
Sample curl
invocation (note that :i_o_port
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[]" "http://192.168.0.100/restapi/relay/ports/:i_o_port/clear_receive_history/"
⇒
null
constant null | relay/ports/S/clear_receive_history/results: 1/ |
No additional information available |
This constant does not correspond to an actual resource.
map | relay/known_port_types/ |
Known I/O port types |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map is composite, i.e. is modified as a whole.
This map does not support direct modification if agent identifier is not equal to relay.
This map contains I/O port type elements.
Sample JS request
I/O port type creation command:
request.put({url:"relay/known_port_types/uart/",body:{"data_items":{"baudrate":{"name":"Baud rate","regexp":"^[1-9][0-9]*$"},"char_size":{"name":"Character size in bits","regexp":"^(5|6|7|8)$"},"stop_bits":{"name":"Number of stop bits","regexp":"^(1|2|1\\.5)$"},"parity":{"name":"Parity setting: N for none, E for even, O for odd, M for mark, S for space","regexp":"^(N|E|O|M|S)$"}},"channels":{"d":"Data"}}});
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/known_port_types/',auth=auth,headers=headers).json())
⇒
object | relay/known_port_types/S/ |
Object representing a supported type of I/O ports |
This object is a part of a composite value which is modified as a whole.
This object contains the following items:
data_items | Configuration structure |
channels | Channel map |
Sample CLI read command (note that i_o_port_type
is a variable):
uom get "relay/known_port_types/${i_o_port_type}"
⇒
Sample curl
read command (note that :i_o_port_type
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/known_port_types/:i_o_port_type/"
⇒
See also I/O port type: Configuration structure
See also I/O port type: Channel map
map | relay/known_port_types/S/data_items/ |
Port configuration structure |
Retrieving the value is denied if not administrative user
This map is a part of a composite value which is modified as a whole.
This map does not support direct modification.
This map contains Configuration item properties elements.
Creating elements in this collection is not supported.
Sample requests
read command (note that _i_o_port_type
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/known_port_types/'+_i_o_port_type+'/data_items/',auth=auth,headers=headers).json())
⇒
Sample JS request
read command (note that _i_o_port_type
is a variable):
request.get({url:"relay/known_port_types/"+_i_o_port_type+"/data_items/"},function(error,response,body) {console.log(body)});
⇒
object | relay/known_port_types/S/data_items/S/ |
Properties of a configuration item |
This object is a part of a composite value which is modified as a whole.
This object contains the following items:
name | Name |
regexp | Regular expression |
Sample curl
read command (note that :i_o_port_type
and :configuration_item_properties
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/known_port_types/:i_o_port_type/data_items/:configuration_item_properties/"
⇒
{"name":"Baud rate","regexp":"^[1-9][0-9]*$"}
Sample CLI write command (note that i_o_port_type
and configuration_item_properties
are variables):
uom set "relay/known_port_types/${i_o_port_type}/data_items/${configuration_item_properties}" "{\"name\":\"Baud rate\",\"regexp\":\"^[1-9][0-9]*$\"}"
string | relay/known_port_types/S/data_items/S/name/ |
Name of the data item |
Retrieving the value is denied if not administrative user
This string is a part of a composite value which is modified as a whole.
This string does not support direct modification.
Sample CLI read command (note that i_o_port_type
and configuration_item_properties
are variables):
uom get "relay/known_port_types/${i_o_port_type}/data_items/${configuration_item_properties}/name"
⇒
"Character size in bits"
Sample curl
read command (note that :i_o_port_type
and :configuration_item_properties
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/known_port_types/:i_o_port_type/data_items/:configuration_item_properties/name/"
⇒
"Character size in bits"
string | relay/known_port_types/S/data_items/S/regexp/ |
Regular expression which the data item must match |
Retrieving the value is denied if not administrative user
This string is a part of a composite value which is modified as a whole.
This string does not support direct modification.
Sample curl
read command (note that :i_o_port_type
and :configuration_item_properties
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/known_port_types/:i_o_port_type/data_items/:configuration_item_properties/regexp/"
⇒
"^[1-9][0-9]*$"
Sample uom
library read command (note that _i_o_port_type
and _configuration_item_properties
are variables):
print(uom.dump(uom.relay.known_port_types[_i_o_port_type].data_items[_configuration_item_properties].regexp))
⇒
"^(1|2|1\\.5)$"
map | relay/known_port_types/S/channels/ |
Map of channels supported by the port |
Retrieving the value is denied if not administrative user
This map is a part of a composite value which is modified as a whole.
This map does not support direct modification.
This map contains Channel name elements.
Creating elements in this collection is not supported.
Sample requests
read command (note that _i_o_port_type
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/known_port_types/'+_i_o_port_type+'/channels/',auth=auth,headers=headers).json())
⇒
{'d': 'Data'}
Sample curl
read command (note that :i_o_port_type
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/known_port_types/:i_o_port_type/channels/"
⇒
{"d":"Data"}
string | relay/known_port_types/S/channels/S/ |
Description of the channel |
Retrieving the value is denied if not administrative user
This string is a part of a composite value which is modified as a whole.
This string does not support direct modification.
Sample JS request
read command (note that _i_o_port_type
and _channel_name
are variables):
request.get({url:"relay/known_port_types/"+_i_o_port_type+"/channels/"+_channel_name+"/"},function(error,response,body) {console.log(body)});
⇒
"Data"
Sample CLI read command (note that i_o_port_type
and channel_name
are variables):
uom get "relay/known_port_types/${i_o_port_type}/channels/${channel_name}"
⇒
"Data"
map | relay/pins/ |
GPIO pins attached to the relay |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map does not support direct modification if agent identifier is not equal to relay.
This map contains GPIO pin elements.
Sample curl
GPIO pin creation command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "{\"level_bits\":0,\"latest_input_value\":null,\"name\":\"aio46\",\"drive_logic_mapping\":[\"Z\",\"Z\",\"0\",\"0\"],\"mode_driver\":\"lxr51\",\"mode_bits\":0,\"level_driver\":\"i5\",\"input_bits\":8}" "http://192.168.0.100/restapi/relay/pins/aio46/"
Sample uom
library write command:
uom.relay.pins={aio28={drive_logic_mapping={"Z","Z","Z","Z"},input_bits=0,latest_input_value=null,level_bits=1,level_driver=false,mode_bits=0,mode_driver=true,name="aio28"},din3={drive_logic_mapping={"Z","H","0","1"},input_bits=4,latest_input_value=null,level_bits=0,level_driver=true,mode_bits=1,mode_driver=true,name="din3"},din82={drive_logic_mapping={"Z","H","0","1"},input_bits=16,latest_input_value=null,level_bits=0,level_driver=true,mode_bits=0,mode_driver=false,name="din82"},dio5={drive_logic_mapping={"Z","Z","0","0"},input_bits=0,latest_input_value=null,level_bits=1,level_driver="wpuxt4",mode_bits=0,mode_driver=true,name="dio5"},dout0={drive_logic_mapping={"Z","Z","0","0"},input_bits=4,latest_input_value=null,level_bits=16,level_driver=false,mode_bits=4,mode_driver="geocg5",name="dout0"}}
object | relay/pins/S/ |
Object representing state and configuration of a GPIO pin |
This object contains the following items:
Sample JS request
deletion command (note that _gpio_pin
is a variable):
request.delete({url:"relay/pins/"+_gpio_pin+"/"});
Sample uom
library deletion command (note that _gpio_pin
is a variable):
uom.remove(uom.relay.pins,_gpio_pin)
See also GPIO pin: Name
See also GPIO pin: Input bits
See also GPIO pin: Mode bits
See also GPIO pin: Level bits
See also GPIO pin: Mode driver
See also GPIO pin: Level driver
See also GPIO pin: Pin drive mapping
See also GPIO pin: Latest input value, if any
See also GPIO pin: Configure tracking
See also GPIO pin: Configure mode driver
See also GPIO pin: Configure level driver
string | relay/pins/S/name/ |
User-visible pin name |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Sample JS request
read command (note that _gpio_pin
is a variable):
request.get({url:"relay/pins/"+_gpio_pin+"/name/"},function(error,response,body) {console.log(body)});
⇒
"aio82"
Sample JS request
write command (note that _gpio_pin
is a variable):
request.put({url:"relay/pins/"+_gpio_pin+"/name/",body:"ain9"});
number | relay/pins/S/input_bits/ |
Number of bits in pin input value |
The value represents count, the standard unit of which is the time (times).
The value is subject to the following constraints: all of the following is true:
Retrieving the value is denied if not administrative user
This number does not support direct modification if agent identifier is not equal to relay.
This number represents a value in persistent storage.
Sample curl
read command (note that :gpio_pin
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/pins/:gpio_pin/input_bits/"
⇒
16
Sample JS request
write command (note that _gpio_pin
is a variable):
request.put({url:"relay/pins/"+_gpio_pin+"/input_bits/",body:0});
number | relay/pins/S/mode_bits/ |
Number of bits in pin mode value |
The value represents count, the standard unit of which is the time (times).
The value is subject to the following constraints: all of the following is true:
Retrieving the value is denied if not administrative user
This number does not support direct modification if agent identifier is not equal to relay.
This number represents a value in persistent storage.
Sample requests
read command (note that _gpio_pin
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/pins/'+_gpio_pin+'/mode_bits/',auth=auth,headers=headers).json())
⇒
4
Sample CLI read command (note that gpio_pin
is a variable):
uom get "relay/pins/${gpio_pin}/mode_bits"
⇒
0
number | relay/pins/S/level_bits/ |
Number of bits in pin level value |
The value represents count, the standard unit of which is the time (times).
The value is subject to the following constraints: all of the following is true:
Retrieving the value is denied if not administrative user
This number does not support direct modification if agent identifier is not equal to relay.
This number represents a value in persistent storage.
Sample uom
library write command (note that _gpio_pin
is a variable):
uom.relay.pins[_gpio_pin].level_bits=0
Sample requests
write command (note that _gpio_pin
is a variable):
requests.put('http://192.168.0.100/restapi/relay/pins/'+_gpio_pin+'/level_bits/',auth=auth,headers=headers,json=2)
sum (variant) | relay/pins/S/mode_driver/ |
Configured signal driving the pin's mode (input or output) |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum does not support direct modification if all of the following is true:
0
This sum represents a value in persistent storage.
This sum can change as if by itself or indirectly because of other actions.
This sum can assume the following values:
constant true | Active | The pin is as active (output) as possible | |
constant false | Tristated | The pin is as inactive (input, hi-Z state) as possible | |
string | Net name | Name of the net providing the driving value | all of the following is true: |
string | Invalid net placeholder | A placeholder for a net that has been deleted or renamed (and always has the logical value false) | the value matches ^net_deleted:.*$ |
Sample JS request
read command (note that _gpio_pin
is a variable):
request.get({url:"relay/pins/"+_gpio_pin+"/mode_driver/"},function(error,response,body) {console.log(body)});
⇒
true
Sample JS request
write command (note that _gpio_pin
is a variable):
request.put({url:"relay/pins/"+_gpio_pin+"/mode_driver/",body:false});
sum (variant) | relay/pins/S/level_driver/ |
Configured signal driving the pin's output level |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum does not support direct modification if all of the following is true:
0
This sum represents a value in persistent storage.
This sum can change as if by itself or indirectly because of other actions.
This sum can assume the following values:
constant true | High | The pin is driven as high as possible given the current mode | |
constant false | Low | The pin is driven as low as possible given the current mode | |
string | Net name | Name of the net providing the driving value | all of the following is true: |
string | Invalid net placeholder | A placeholder for a net that has been deleted or renamed (and always has the logical value false) | the value matches ^net_deleted:.*$ |
Sample uom
library read command (note that _gpio_pin
is a variable):
print(uom.dump(uom.relay.pins[_gpio_pin].level_driver))
⇒
"fbspfofh13"
Sample JS request
read command (note that _gpio_pin
is a variable):
request.get({url:"relay/pins/"+_gpio_pin+"/level_driver/"},function(error,response,body) {console.log(body)});
⇒
true
tuple | relay/pins/S/drive_logic_mapping/ |
Mapping of pin mode and level combinations to resulting pin IEEE1164 logic levels |
Retrieving the value is denied if not administrative user
This tuple is composite, i.e. is modified as a whole.
This tuple does not support direct modification if agent identifier is not equal to relay.
This tuple represents a value in persistent storage.
This tuple contains the following items:
1 | Low mode, low level |
2 | Low mode, high level |
3 | High mode, low level |
4 | High mode, high level |
Sample requests
write command (note that _gpio_pin
is a variable):
requests.put('http://192.168.0.100/restapi/relay/pins/'+_gpio_pin+'/drive_logic_mapping/',auth=auth,headers=headers,json=['Z', 'Z', 'Z', 'Z'])
Sample uom
library read command (note that _gpio_pin
is a variable):
print(uom.dump(uom.relay.pins[_gpio_pin].drive_logic_mapping))
⇒
{"Z","Z","Z","Z"}
sum (enumerated string) | relay/pins/S/drive_logic_mapping/1/ |
IEEE1164 logic level when pin is in the minimum mode, minimum level configuration |
Retrieving the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification if agent identifier is not equal to relay.
This sum represents a value in persistent storage.
This sum can assume the following values:
constant "0" | Forcing 0 | Strong low signal as good as ground | |
constant "1" | Forcing 1 | Strong high signal as good as power supply voltage | |
constant "L" | Weak 0 | Low signal which is logically 0 but weak (e.g. from a pull-down resistor) | |
constant "H" | Weak 1 | High signal which is logically 1 but weak (e.g. from a pull-up resistor) | |
constant "Z" | High impedance | Pin pulled neither up nor down, signal defined by external circuitry |
Sample curl
read command (note that :gpio_pin
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/pins/:gpio_pin/drive_logic_mapping/0/"
⇒
"0"
Sample uom
library write command (note that _gpio_pin
is a variable):
uom.relay.pins[_gpio_pin].drive_logic_mapping[1]="0"
sum (enumerated string) | relay/pins/S/drive_logic_mapping/2/ |
IEEE1164 logic level when pin is in the minimum mode, maximum level configuration |
Retrieving the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification if agent identifier is not equal to relay.
This sum represents a value in persistent storage.
This sum can assume the following values:
constant "0" | Forcing 0 | Strong low signal as good as ground | |
constant "1" | Forcing 1 | Strong high signal as good as power supply voltage | |
constant "L" | Weak 0 | Low signal which is logically 0 but weak (e.g. from a pull-down resistor) | |
constant "H" | Weak 1 | High signal which is logically 1 but weak (e.g. from a pull-up resistor) | |
constant "Z" | High impedance | Pin pulled neither up nor down, signal defined by external circuitry |
Sample CLI read command (note that gpio_pin
is a variable):
uom get "relay/pins/${gpio_pin}/drive_logic_mapping/1"
⇒
"Z"
Sample curl
read command (note that :gpio_pin
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/pins/:gpio_pin/drive_logic_mapping/1/"
⇒
"Z"
sum (enumerated string) | relay/pins/S/drive_logic_mapping/3/ |
IEEE1164 logic level when pin is in the maximum mode, minimum level configuration |
Retrieving the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification if agent identifier is not equal to relay.
This sum represents a value in persistent storage.
This sum can assume the following values:
constant "0" | Forcing 0 | Strong low signal as good as ground | |
constant "1" | Forcing 1 | Strong high signal as good as power supply voltage | |
constant "L" | Weak 0 | Low signal which is logically 0 but weak (e.g. from a pull-down resistor) | |
constant "H" | Weak 1 | High signal which is logically 1 but weak (e.g. from a pull-up resistor) | |
constant "Z" | High impedance | Pin pulled neither up nor down, signal defined by external circuitry |
Sample uom
library read command (note that _gpio_pin
is a variable):
print(uom.dump(uom.relay.pins[_gpio_pin].drive_logic_mapping[3]))
⇒
"0"
Sample uom
library write command (note that _gpio_pin
is a variable):
uom.relay.pins[_gpio_pin].drive_logic_mapping[3]="0"
sum (enumerated string) | relay/pins/S/drive_logic_mapping/4/ |
IEEE1164 logic level when pin is in the maximum mode, maximum level configuration |
Retrieving the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification if agent identifier is not equal to relay.
This sum represents a value in persistent storage.
This sum can assume the following values:
constant "0" | Forcing 0 | Strong low signal as good as ground | |
constant "1" | Forcing 1 | Strong high signal as good as power supply voltage | |
constant "L" | Weak 0 | Low signal which is logically 0 but weak (e.g. from a pull-down resistor) | |
constant "H" | Weak 1 | High signal which is logically 1 but weak (e.g. from a pull-up resistor) | |
constant "Z" | High impedance | Pin pulled neither up nor down, signal defined by external circuitry |
Sample curl
write command (note that :gpio_pin
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "\"1\"" "http://192.168.0.100/restapi/relay/pins/:gpio_pin/drive_logic_mapping/3/"
Sample JS request
write command (note that _gpio_pin
is a variable):
request.put({url:"relay/pins/"+_gpio_pin+"/drive_logic_mapping/3/",body:"0"});
sum (optional number) | relay/pins/S/latest_input_value/ |
Latest pin input value as reported by a net, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
Using the sum as a field for indexing into the grandparent collection is denied
This sum does not support direct modification if agent identifier is not equal to relay.
This sum can change as if by itself or indirectly because of other actions.
This sum can assume the following values:
constant null | No latest input value | Input value not monitored so no latest value available | |
number | Latest input value | Latest pin input value as reported by a net |
Sample uom
library read command (note that _gpio_pin
is a variable):
print(uom.dump(uom.relay.pins[_gpio_pin].latest_input_value))
⇒
null
Sample requests
write command (note that _gpio_pin
is a variable):
requests.put('http://192.168.0.100/restapi/relay/pins/'+_gpio_pin+'/latest_input_value/',auth=auth,headers=headers,json=None)
array | relay/pins/S/configure_input_tracking/results: 1/1/ |
List of nets removed to fulfill the configuration result |
This array does not correspond to an actual resource.
This array contains Removed net elements.
string | relay/pins/S/configure_input_tracking/results: 1/1/N/ |
Identifier of the removed net |
This string does not correspond to an actual resource.
array | relay/pins/S/configure_input_tracking/results: 1/2/ |
List of nets added to fulfill the configuration result |
This array does not correspond to an actual resource.
This array contains Added net elements.
string | relay/pins/S/configure_input_tracking/results: 1/2/N/ |
Identifier of the added net |
This string does not correspond to an actual resource.
call | relay/pins/S/configure_input_tracking/ |
Set method of reporting the pin's value |
Performing the function call is denied if any of the following is true:
0
The call accepts the following arguments:
The call returns the following results:
Sample CLI invocation (note that gpio_pin
is a variable):
uom invoke "relay/pins/${gpio_pin}/configure_input_tracking" "\"pull\""
⇒
["pfybmbrcvvejp1"]
Sample curl
invocation (note that :gpio_pin
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[null]" "http://192.168.0.100/restapi/relay/pins/:gpio_pin/configure_input_tracking/"
⇒
[]
sum (optional enumerated string) | relay/pins/S/configure_input_tracking/arguments: 1/ |
Desired pin tracking configuration mode |
This sum does not correspond to an actual resource.
This sum can assume the following values:
constant null | None | Latest pin value is not updated | |
constant "pull" | Pull | Latest pin value is updated periodically | |
constant "push" | Push | Latest pin value is reported when changed |
tuple | relay/pins/S/configure_input_tracking/results: 1/ |
Changes in net structure performed by the call |
This tuple does not correspond to an actual resource.
This tuple contains the following items:
1 | Removed nets |
2 | Added nets |
See also Net changes: Removed nets
See also Net changes: Added nets
array | relay/pins/S/configure_mode_driver/results: 1/1/ |
List of nets removed to fulfill the configuration result |
This array does not correspond to an actual resource.
This array contains Removed net elements.
string | relay/pins/S/configure_mode_driver/results: 1/1/N/ |
Identifier of the removed net |
This string does not correspond to an actual resource.
array | relay/pins/S/configure_mode_driver/results: 1/2/ |
List of nets added to fulfill the configuration result |
This array does not correspond to an actual resource.
This array contains Added net elements.
string | relay/pins/S/configure_mode_driver/results: 1/2/N/ |
Identifier of the added net |
This string does not correspond to an actual resource.
call | relay/pins/S/configure_mode_driver/ |
Set pin's mode (input or output) driver |
Performing the function call is denied if any of the following is true:
0
The call accepts the following arguments:
The call returns the following results:
Sample JS request
invocation (note that _gpio_pin
is a variable):
request.post({url:"relay/pins/"+_gpio_pin+"/configure_mode_driver/",body:["umvir20"]});
⇒
[]
Sample curl
invocation (note that :gpio_pin
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[false]" "http://192.168.0.100/restapi/relay/pins/:gpio_pin/configure_mode_driver/"
⇒
[]
sum (variant) | relay/pins/S/configure_mode_driver/arguments: 1/ |
Desired signal driving the pin's mode (input or output) |
This sum does not correspond to an actual resource.
This sum can assume the following values:
constant true | High | The pin is driven as high as possible given the current mode | |
constant false | Low | The pin is driven as low as possible given the current mode | |
string | Net code | Code of the net providing the driving value |
tuple | relay/pins/S/configure_mode_driver/results: 1/ |
Changes in net structure performed by the call |
This tuple does not correspond to an actual resource.
This tuple contains the following items:
1 | Removed nets |
2 | Added nets |
See also Net changes: Removed nets
See also Net changes: Added nets
array | relay/pins/S/configure_level_driver/results: 1/1/ |
List of nets removed to fulfill the configuration result |
This array does not correspond to an actual resource.
This array contains Removed net elements.
string | relay/pins/S/configure_level_driver/results: 1/1/N/ |
Identifier of the removed net |
This string does not correspond to an actual resource.
array | relay/pins/S/configure_level_driver/results: 1/2/ |
List of nets added to fulfill the configuration result |
This array does not correspond to an actual resource.
This array contains Added net elements.
string | relay/pins/S/configure_level_driver/results: 1/2/N/ |
Identifier of the added net |
This string does not correspond to an actual resource.
call | relay/pins/S/configure_level_driver/ |
Set pin's output level driver |
Performing the function call is denied if any of the following is true:
0
The call accepts the following arguments:
The call returns the following results:
Sample JS request
invocation (note that _gpio_pin
is a variable):
request.post({url:"relay/pins/"+_gpio_pin+"/configure_level_driver/",body:[true]});
⇒
[]
Sample curl
invocation (note that :gpio_pin
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[\"ib4\"]" "http://192.168.0.100/restapi/relay/pins/:gpio_pin/configure_level_driver/"
⇒
[]
sum (variant) | relay/pins/S/configure_level_driver/arguments: 1/ |
Desired signal driving the pin's output level |
This sum does not correspond to an actual resource.
This sum can assume the following values:
constant true | High | The pin is driven as high as possible given the current mode | |
constant false | Low | The pin is driven as low as possible given the current mode | |
string | Net code | Code of the net providing the driving value |
tuple | relay/pins/S/configure_level_driver/results: 1/ |
Changes in net structure performed by the call |
This tuple does not correspond to an actual resource.
This tuple contains the following items:
1 | Removed nets |
2 | Added nets |
See also Net changes: Removed nets
See also Net changes: Added nets
map | relay/nets/ |
Nets controlling the GPIO pins |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This map represents a value in persistent storage.
This map contains GPIO net elements.
Sample requests
GPIO net creation command:
requests.put('http://192.168.0.100/restapi/relay/nets/wl33/',auth=auth,headers=headers,json={'name': 'wl33', 'scale': 1, 'tracking': 'pull', 'expression': '(not (not ((not anet["w55"]) and pin["din40"])))'})
Sample JS request
read command:
request.get({url:"relay/nets/"},function(error,response,body) {console.log(body)});
⇒
See also Nets: GPIO net
object | relay/nets/S/ |
Object representing a state of a GPIO net signal |
This object contains the following items:
name | Name |
expression | Expression |
tracking | Tracking |
latest_value | Latest value |
scale | Value scale factor |
Sample curl
read command (note that :gpio_net
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/nets/:gpio_net/"
⇒
{"name":"lmeeoqogne60","scale":65536,"latest_value":9,"tracking":"push","expression":"apin[\"aout9\"]"}
Sample CLI deletion command (note that gpio_net
is a variable):
uom remove "relay/nets/${gpio_net}"
string | relay/nets/S/name/ |
User-visible net name |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Sample CLI write command (note that gpio_net
is a variable):
uom set "relay/nets/${gpio_net}/name" "\"nc9\""
Sample requests
read command (note that _gpio_net
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/nets/'+_gpio_net+'/name/',auth=auth,headers=headers).json())
⇒
'scgbj3'
string | relay/nets/S/expression/ |
Expression governing the net's value |
The value contains Lua source (has native MIME type text/x-lua
).
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This string represents a value in persistent storage.
Sample CLI read command (note that gpio_net
is a variable):
uom get "relay/nets/${gpio_net}/expression"
⇒
false
Sample requests
read command (note that _gpio_net
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/nets/'+_gpio_net+'/expression/',auth=auth,headers=headers).json())
⇒
'(net["s5"] > apin["aout7"])'
sum (optional enumerated string) | relay/nets/S/tracking/ |
Method of reporting the net's value |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | None | Net value is not updated | |
constant "pull" | Pull | Net value is updated periodically | |
constant "push" | Push | Net value is reported when changed |
Sample CLI write command (note that gpio_net
is a variable):
uom set "relay/nets/${gpio_net}/tracking" "null"
Sample JS request
read command (note that _gpio_net
is a variable):
request.get({url:"relay/nets/"+_gpio_net+"/tracking/"},function(error,response,body) {console.log(body)});
⇒
null
number | relay/nets/S/latest_value/ |
Latest net value |
The value is unconditionally set to 0
on creation and doesn't have to be supplied (if it is, it must match)
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
Using the number as a field for indexing into the grandparent collection is denied
This number does not support direct modification if agent identifier is not equal to relay.
Sample CLI read command (note that gpio_net
is a variable):
uom get "relay/nets/${gpio_net}/latest_value"
⇒
2
Sample requests
write command (note that _gpio_net
is a variable):
requests.put('http://192.168.0.100/restapi/relay/nets/'+_gpio_net+'/latest_value/',auth=auth,headers=headers,json=9)
number | relay/nets/S/scale/ |
The factor by which the latest value must be divided to obtain the corresponding numeric value |
The value is unconditionally set to 1
on creation and doesn't have to be supplied (if it is, it must match)
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
Using the number as a field for indexing into the grandparent collection is denied
This number does not support direct modification if agent identifier is not equal to relay.
Sample CLI write command (note that gpio_net
is a variable):
uom set "relay/nets/${gpio_net}/scale" "4"
Sample requests
read command (note that _gpio_net
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/nets/'+_gpio_net+'/scale/',auth=auth,headers=headers).json())
⇒
65536
number | relay/net_poll_interval/ |
Time between net value fetches (for nets configured for periodic polling) |
The value represents time, the standard unit of which is the second (s).
The value is subject to the following constraints: the value is greater than 0
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This number represents a value in persistent storage.
Sample CLI read command:
uom get "relay/net_poll_interval"
⇒
6
Sample curl
read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/net_poll_interval/"
⇒
5
sum (number) | relay/gpio_scan_interval/ |
Target time between GPIO scans, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant 0 | Asynchronous GPIO scanning | GPIO scans occur not at a particular interval, but rather as often as possible | |
number | GPIO scan interval | Target time between GPIO scans | the value is greater than 0 |
Sample JS request
read command:
request.get({url:"relay/gpio_scan_interval/"},function(error,response,body) {console.log(body)});
⇒
0.1
Sample uom
library read command:
print(uom.dump(uom.relay.gpio_scan_interval))
⇒
0.1
number | relay/scan_catch_up_limit/ |
The maximum number of end-to-end-consecutive scans to catch up with the desired interval (has no effect if GPIO scanning is asynchronous) |
The value represents count, the standard unit of which is the time (times).
The value is subject to the following constraints: all of the following is true:
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This number represents a value in persistent storage.
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/scan_catch_up_limit/',auth=auth,headers=headers).json())
⇒
6
Sample curl
read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/scan_catch_up_limit/"
⇒
8
sum (boolean) | relay/fuses_enabled/ |
Allow use of measurement results to conditionally switch off outlets, enabling safety shutdown and correct power loss operation |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum is expected to be visible to advanced users only.
This sum can assume the following values:
constant true | Enabled | The feature is enabled | |
constant false | Disabled | The feature is disabled |
Sample JS request
write command:
request.put({url:"relay/fuses_enabled/",body:true});
Sample curl
write command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "false" "http://192.168.0.100/restapi/relay/fuses_enabled/"
sum (optional number) | relay/min_relay_voltage/ |
Minimum relay voltage below which it cannot drive outlets and they must be considered off, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum is expected to be visible to advanced users only.
This sum can assume the following values:
constant null | Disable relay undervoltage handling | Ignore relay undervoltage. This is unsafe! | |
number | Minimum relay voltage | Minimum relay voltage below which it cannot drive outlets and they must be considered off | the value is greater than 0 |
Sample JS request
write command:
request.put({url:"relay/min_relay_voltage/",body:8});
Sample CLI write command:
uom set "relay/min_relay_voltage" "8"
sum (optional number) | relay/fuse_relatch/ |
Time to hold outlets off after switching them off due to measurement limits being hit, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | Latch OFF | Switch outlets off until the user takes action | |
number | Measurement-driven relatch timeout | Time to hold outlets off after switching them off due to measurement limits being hit | the value is greater than 0 |
Sample curl
write command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "null" "http://192.168.0.100/restapi/relay/fuse_relatch/"
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/fuse_relatch/',auth=auth,headers=headers).json())
⇒
None
sum (boolean) | relay/keypad_enabled/ |
Flag indicating whether keypad is enabled or disabled |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant true | Enabled | The feature is enabled | |
constant false | Disabled | The feature is disabled |
Sample requests
write command:
requests.put('http://192.168.0.100/restapi/relay/keypad_enabled/',auth=auth,headers=headers,json=False)
Sample curl
write command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "false" "http://192.168.0.100/restapi/relay/keypad_enabled/"
sum (boolean) | relay/all_caps/ |
Flag enabling all-caps display of text |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant true | All CAPS | All LCD strings are displayed in capital letters | |
constant false | Standard mode | LCD strings are displayed as configured without capitalization |
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/all_caps/',auth=auth,headers=headers).json())
⇒
True
Sample requests
write command:
requests.put('http://192.168.0.100/restapi/relay/all_caps/',auth=auth,headers=headers,json=False)
string | relay/beep_sequence/ |
Signal sequence for beeper activation |
The value is subject to the following constraints: the value matches ^[01. _-]*$
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
Sample JS request
write command:
request.put({url:"relay/beep_sequence/",body:"0"});
Sample curl
read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/beep_sequence/"
⇒
"0"
string | relay/backlight_sequence/ |
Signal sequence for backlight blinking |
The value is subject to the following constraints: the value matches ^[01. _-]*$
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
Sample CLI read command:
uom get "relay/backlight_sequence"
⇒
"0"
Sample requests
write command:
requests.put('http://192.168.0.100/restapi/relay/backlight_sequence/',auth=auth,headers=headers,json='0')
number | relay/lcd_columns/ |
Number of LCD columns |
The value represents count, the standard unit of which is the time (times).
The value is subject to the following constraints: all of the following is true:
This number does not support direct modification.
This number represents a value in persistent storage.
Sample uom
library read command:
print(uom.dump(uom.relay.lcd_columns))
⇒
16
Sample curl
read command:
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/lcd_columns/"
⇒
16
number | relay/lcd_rows/ |
Number of LCD rows |
The value represents count, the standard unit of which is the time (times).
The value is subject to the following constraints: all of the following is true:
This number does not support direct modification.
This number represents a value in persistent storage.
Sample JS request
read command:
request.get({url:"relay/lcd_rows/"},function(error,response,body) {console.log(body)});
⇒
2
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/lcd_rows/',auth=auth,headers=headers).json())
⇒
2
array | relay/user_lines/ |
Array of strings to override LCD lines with, from top to bottom |
The value is subject to the following constraints: length of the value is equal to LCD row count
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This array contains User LCD line, if any elements.
Sample CLI write command:
uom set "relay/user_lines" "[null,null]"
Sample curl
write command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[null,null]" "http://192.168.0.100/restapi/relay/user_lines/"
sum (optional string) | relay/user_lines/N/ |
The line to override the corresponding line of the LCD output with, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
Changes to this sum may have an effect besides setting value.
This sum can assume the following values:
constant null | No user LCD line | Do not override the corresponding line of the ordinary LCD output | |
string | User LCD line | The line to override the corresponding line of the LCD output with |
Sample curl
write command (note that :user_lcd_line__if_any_index
is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "null" "http://192.168.0.100/restapi/relay/user_lines/:user_lcd_line__if_any_index/"
Sample JS request
write command (note that _user_lcd_line__if_any_index
is a variable):
request.put({url:"relay/user_lines/"+_user_lcd_line__if_any_index.toString()+"/",body:null});
sum (optional number) | relay/user_message_force_timeout/ |
Time during which the user script LCD message always overrides ordinary LCD output, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | Always force user message | The user message always overrides ordinary LCD output | |
number | User message force display timeout | Time during which the user script LCD message always overrides ordinary LCD output | the value is greater or equal to 0 |
Sample CLI write command:
uom set "relay/user_message_force_timeout" "null"
Sample curl
write command:
curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "0" "http://192.168.0.100/restapi/relay/user_message_force_timeout/"
sum (optional number) | relay/user_message_timeout/ |
Time after which the user script LCD message is replaced by ordinary LCD output even if nothing else happens, if any |
Retrieving the value is denied if not administrative user
Changing the value is denied if not administrative user
This sum represents a value in persistent storage.
This sum can assume the following values:
constant null | Show user message indefinitely | The user message stays on LCD until ordinary LCD output changes | |
number | User message display timeout | Time after which the user script LCD message is replaced by ordinary LCD output even if nothing else happens | the value is greater or equal to 0 |
Sample requests
read command:
print(requests.get('http://192.168.0.100/restapi/relay/user_message_timeout/',auth=auth,headers=headers).json())
⇒
3
Sample CLI write command:
uom set "relay/user_message_timeout" "1"
object | relay/notifications/ |
Relay-state-related notifications |
Retrieving the value is denied if not administrative user
This object does not support direct modification.
This object contains the following items:
parameter_kinds | Parameter kinds |
events | Events |
Sample JS request
read command:
request.get({url:"relay/notifications/"},function(error,response,body) {console.log(body)});
⇒
<...>
Sample CLI read command:
uom get "relay/notifications"
⇒
...
See also Notifications: Parameter kinds
map | relay/notifications/events/ |
Event templates |
Retrieving the value is denied if not administrative user
This map is composite, i.e. is modified as a whole.
This map does not support direct modification.
This map contains Event elements.
Creating elements in this collection is not supported.
Sample JS request
read command:
request.get({url:"relay/notifications/events/"},function(error,response,body) {console.log(body)});
⇒
<...>
Sample uom
library read command:
print(uom.dump(uom.relay.notifications.events))
⇒
<...>
See also Events: Event
object | relay/notifications/parameter_kinds/ |
Kinds of event parameters |
This object does not correspond to an actual resource.
This object contains the following items:
outlet | Outlet |
state | Configured state |
transient_state | Transient state |
physical_state | Physical state |
locked | Lock state |
number | relay/notifications/parameter_kinds/outlet/ |
Outlet index |
The value is subject to the following constraints: outlets[the value]
sum (boolean) | relay/notifications/parameter_kinds/state/ |
Saved configured state of the outlet |
This sum can assume the following values:
constant true | On | The outlet is powered | |
constant false | Off | The outlet is not powered |
sum (boolean) | relay/notifications/parameter_kinds/transient_state/ |
Current expected state of the outlet |
This sum can assume the following values:
constant true | On | The outlet is powered | |
constant false | Off | The outlet is not powered |
sum (boolean) | relay/notifications/parameter_kinds/physical_state/ |
Current actual state of the outlet |
This sum can assume the following values:
constant true | On | The outlet is powered | |
constant false | Off | The outlet is not powered |
sum (boolean) | relay/notifications/parameter_kinds/locked/ |
Indicates whether the outlet state is locked from keypad |
This sum can assume the following values:
constant true | Locked | The outlet state cannot be changed | |
constant false | Unlocked | The outlet state can be changed |
object | relay/notifications/events/S/parameters/N/ |
Properties of a parameter associated with the event |
This object is a part of a composite value which is modified as a whole.
This object contains the following items:
id | Identifier |
has_fixed_value | Fixed value flag |
fixed_value | Fixed value |
Sample JS request
write command (note that _event
and _event_parameter_index
are variables):
request.put({url:"relay/notifications/events/"+_event+"/parameters/"+_event_parameter_index.toString()+"/",body:{"fixed_value":true,"has_fixed_value":true,"id":"transient_state"}});
Sample CLI read command (note that event
and event_parameter_index
are variables):
uom get "relay/notifications/events/${event}/parameters/${event_parameter_index}"
⇒
{"fixed_value":false,"has_fixed_value":true,"id":"transient_state"}
string | relay/notifications/events/S/parameters/N/id/ |
Parameter identifier |
The value is subject to the following constraints: parameter kinds[the value]
Retrieving the value is denied if not administrative user
This string is a part of a composite value which is modified as a whole.
This string does not support direct modification.
Sample uom
library read command (note that _event
and _event_parameter_index
are variables):
print(uom.dump(uom.relay.notifications.events[_event].parameters[_event_parameter_index].id))
⇒
"state"
Sample requests
read command (note that _event
and _event_parameter_index
are variables):
print(requests.get('http://192.168.0.100/restapi/relay/notifications/events/'+_event+'/parameters/'+str(_event_parameter_index)+'/id/',auth=auth,headers=headers).json())
⇒
'transient_state'
sum (boolean) | relay/notifications/events/S/parameters/N/has_fixed_value/ |
Flag indicating that the parameter's value for this event is fixed |
Retrieving the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification.
This sum can assume the following values:
constant true | Fixed | The value is fixed | |
constant false | Variable | The value is variable |
Sample curl
read command (note that :event
and :event_parameter_index
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/notifications/events/:event/parameters/:event_parameter_index/has_fixed_value/"
⇒
true
Sample CLI read command (note that event
and event_parameter_index
are variables):
uom get "relay/notifications/events/${event}/parameters/${event_parameter_index}/has_fixed_value"
⇒
false
sum (variant) | relay/notifications/events/S/parameters/N/fixed_value/ |
Fixed parameter value for this particular event |
Retrieving the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification.
This sum can assume the following values:
constant null | Null | Null | |
constant true | True | True | |
constant false | False | False | |
string | String | This string | |
number | Number | This number |
Sample JS request
read command (note that _event
and _event_parameter_index
are variables):
request.get({url:"relay/notifications/events/"+_event+"/parameters/"+_event_parameter_index.toString()+"/fixed_value/"},function(error,response,body) {console.log(body)});
⇒
null
Sample curl
read command (note that :event
and :event_parameter_index
are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/notifications/events/:event/parameters/:event_parameter_index/fixed_value/"
⇒
null
object | relay/notifications/events/S/ |
Event template |
This object is a part of a composite value which is modified as a whole.
This object contains the following items:
message_template | Message template |
severity | Severity |
parameters | Event parameters |
Sample CLI read command (note that event
is a variable):
uom get "relay/notifications/events/${event}"
⇒
{"severity":7,"message_template":["outlet ",0," expected to be ON"],"parameters":[{"fixed_value":null,"has_fixed_value":false,"id":"outlet"},{"fixed_value":true,"has_fixed_value":true,"id":"transient_state"}]}
Sample uom
library read command (note that _event
is a variable):
print(uom.dump(uom.relay.notifications.events[_event]))
⇒
{message_template={"outlet ",0," configured to be ON"},parameters={{fixed_value=null,has_fixed_value=false,id="outlet"},{fixed_value=true,has_fixed_value=true,id="state"}},severity=6}
array | relay/notifications/events/S/message_template/ |
Template for human-readable message generation |
Retrieving the value is denied if not administrative user
This array is a part of a composite value which is modified as a whole.
This array does not support direct modification.
This array contains Message template element elements.
Creating elements in this collection is not supported.
Sample JS request
read command (note that _event
is a variable):
request.get({url:"relay/notifications/events/"+_event+"/message_template/"},function(error,response,body) {console.log(body)});
⇒
["locked outlet ",0," remains ON at power-up"]
Sample CLI read command (note that event
is a variable):
uom get "relay/notifications/events/${event}/message_template"
⇒
["outlet ",0," configured to be OFF at power-up"]
sum (variant) | relay/notifications/events/S/message_template/N/ |
Element of human-readable message template |
Retrieving the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification.
This sum can assume the following values:
string | String | Fixed string | |
number | Parameter | Index of message parameter to insert | event parameters[the value] |
Sample requests
read command (note that _event
and _message_template_element_index
are variables):
print(requests.get('http://192.168.0.100/restapi/relay/notifications/events/'+_event+'/message_template/'+str(_message_template_element_index)+'/',auth=auth,headers=headers).json())
⇒
0
Sample uom
library read command (note that _event
and _message_template_element_index
are variables):
print(uom.dump(uom.relay.notifications.events[_event].message_template[_message_template_element_index]))
⇒
" remains OFF at power-up"
sum (enumerated number) | relay/notifications/events/S/severity/ |
Severity rating assigned to the event |
Retrieving the value is denied if not administrative user
This sum is a part of a composite value which is modified as a whole.
This sum does not support direct modification.
This sum can assume the following values:
constant 1 | Emergency | Treat the event as an emergency | |
constant 2 | Alert | Treat the event as an alert | |
constant 3 | Critical | Treat the event as critical | |
constant 4 | Error | Treat the event as an error | |
constant 5 | Warning | Treat the event as a warning | |
constant 6 | Notice | Treat the event as a notice | |
constant 7 | Informational | Treat the event as informational | |
constant 8 | Debug | Treat the event as debugging-related |
Sample requests
read command (note that _event
is a variable):
print(requests.get('http://192.168.0.100/restapi/relay/notifications/events/'+_event+'/severity/',auth=auth,headers=headers).json())
⇒
6
Sample curl
read command (note that :event
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/notifications/events/:event/severity/"
⇒
6
array | relay/notifications/events/S/parameters/ |
Additional data associated with the event |
Retrieving the value is denied if not administrative user
This array is a part of a composite value which is modified as a whole.
This array does not support direct modification.
This array contains Event parameter elements.
Creating elements in this collection is not supported.
Sample curl
read command (note that :event
is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/relay/notifications/events/:event/parameters/"
⇒
[{"fixed_value":null,"has_fixed_value":false,"id":"outlet"},{"fixed_value":false,"has_fixed_value":true,"id":"state"}]
Sample CLI read command (note that event
is a variable):
uom get "relay/notifications/events/${event}/parameters"
⇒
[{"fixed_value":null,"has_fixed_value":false,"id":"outlet"},{"fixed_value":false,"has_fixed_value":true,"id":"state"}]
See also Event parameters: Event parameter