| object | modbus/ |
| Object representing the Modbus/TCP slave configuration | |
Retrieving the value is denied if not administrative user
This object contains the following items:
Sample CLI write command:
uom set modbus ...
Sample uom library read command:
print(uom.dump(uom.modbus))
⇒
Modbus/TCP slave enabled
| sum (boolean) | modbus/enabled/ |
| Modbus/TCP slave enable status | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
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 read command:
print(requests.get('http://192.168.0.100/restapi/modbus/enabled/',auth=auth,headers=headers).json())
⇒
True
Sample uom library read command:
print(uom.dump(uom.modbus.enabled))
⇒
true
Outlet Modbus configuration settings
| array | modbus/outlets/ |
| Properties related to exposing outlets via Modbus | |
The value is subject to the following constraints: length of the value is equal to length of outlets
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
This array represents a value in persistent storage.
This array contains Outlet Modbus/TCP configuration elements.
Sample requests read command:
print(requests.get('http://192.168.0.100/restapi/modbus/outlets/',auth=auth,headers=headers).json())
⇒
Sample requests outlet Modbus/TCP configuration creation command:
requests.post('http://192.168.0.100/restapi/modbus/outlets/',auth=auth,headers=headers,json={'allow_write': True, 'allow_read': False})
See also Outlet Modbus configuration settings: Outlet Modbus/TCP configuration
Outlet Modbus configuration settings: Outlet Modbus/TCP configuration
| object | modbus/outlets/N/ |
| Properties related to exposing the outlet via Modbus/TCP | |
The value is subject to the following constraints: outlets[index of the value]
This object contains the following items:
| allow_read | Allow read |
| allow_write | Allow write |
Sample JS request read command (note that _outlet_modbus_tcp_configuration_index is a variable):
request.get({url:"modbus/outlets/"+_outlet_modbus_tcp_configuration_index.toString()+"/"},function(error,response,body) {console.log(body)});
⇒
{"allow_write":true,"allow_read":true}
Sample curl read command (note that :outlet_modbus_tcp_configuration_index is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/outlets/:outlet_modbus_tcp_configuration_index/"
⇒
{"allow_write":false,"allow_read":false}
Allow read
| sum (boolean) | modbus/outlets/N/allow_read/ |
| Outlet state is reported via Modbus/TCP | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
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 CLI read command (note that outlet_modbus_tcp_configuration_index is a variable):
uom get "modbus/outlets/${outlet_modbus_tcp_configuration_index}/allow_read"
⇒
false
Sample curl read command (note that :outlet_modbus_tcp_configuration_index is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/outlets/:outlet_modbus_tcp_configuration_index/allow_read/"
⇒
true
Allow write
| sum (boolean) | modbus/outlets/N/allow_write/ |
| Outlet state can be changed via Modbus/TCP | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
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 curl read command (note that :outlet_modbus_tcp_configuration_index is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/outlets/:outlet_modbus_tcp_configuration_index/allow_write/"
⇒
true
Sample uom library write command (note that _outlet_modbus_tcp_configuration_index is a variable):
uom.modbus.outlets[_outlet_modbus_tcp_configuration_index].allow_write=true
Discrete input configuration settings
| array | modbus/discrete_inputs/ |
| Properties related to custom discrete inputs | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
This array represents a value in persistent storage.
This array contains Discrete input configuration elements.
Sample JS request read command:
request.get({url:"modbus/discrete_inputs/"},function(error,response,body) {console.log(body)});
⇒
[{"value":false,"allow_read":true,"name":"qjhpwl2","index":42721},{"value":true,"allow_read":true,"name":"yjn54","index":14007},{"value":false,"allow_read":false,"name":"rzyzg1","index":38047},{"value":true,"allow_read":false,"name":"x8","index":21144}]
Sample uom library read command:
print(uom.dump(uom.modbus.discrete_inputs))
⇒
{{allow_read=true,index=57484,name="tjta7",value=false},{allow_read=false,index=15668,name="e28",value=true},{allow_read=false,index=61207,name="b0",value=false}}
See also Discrete input configuration settings: Discrete input configuration
Discrete input configuration settings: Discrete input configuration
| object | modbus/discrete_inputs/N/ |
| Properties related to a custom discrete input | |
This object contains the following items:
| name | Name |
| index | Index |
| allow_read | Allow read |
| value | State |
Sample JS request write command (note that _discrete_input_configuration_index is a variable):
request.put({url:"modbus/discrete_inputs/"+_discrete_input_configuration_index.toString()+"/",body:{"value":true,"allow_read":true,"name":"bwk55","index":23637}});
Sample curl deletion command (note that :discrete_input_configuration_index is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X DELETE -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/discrete_inputs/:discrete_input_configuration_index/"
Name
| string | modbus/discrete_inputs/N/name/ |
| Discrete input 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 discrete_input_configuration_index is a variable):
uom set "modbus/discrete_inputs/${discrete_input_configuration_index}/name" "\"ll49\""
Sample curl write command (note that :discrete_input_configuration_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 "\"lgb1\"" "http://192.168.0.100/restapi/modbus/discrete_inputs/:discrete_input_configuration_index/name/"
Index
| number | modbus/discrete_inputs/N/index/ |
| Zero-based index of discrete input (without 10...01 added) | |
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 any of the following is true:
This number represents a value in persistent storage.
Sample requests write command (note that _discrete_input_configuration_index is a variable):
requests.put('http://192.168.0.100/restapi/modbus/discrete_inputs/'+str(_discrete_input_configuration_index)+'/index/',auth=auth,headers=headers,json=13699)
Sample curl write command (note that :discrete_input_configuration_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 "32147" "http://192.168.0.100/restapi/modbus/discrete_inputs/:discrete_input_configuration_index/index/"
Allow read
| sum (boolean) | modbus/discrete_inputs/N/allow_read/ |
| Discrete input is readable via Modbus/TCP | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
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 CLI write command (note that discrete_input_configuration_index is a variable):
uom set "modbus/discrete_inputs/${discrete_input_configuration_index}/allow_read" "true"
Sample CLI read command (note that discrete_input_configuration_index is a variable):
uom get "modbus/discrete_inputs/${discrete_input_configuration_index}/allow_read"
⇒
false
State
| sum (boolean) | modbus/discrete_inputs/N/value/ |
| State of discrete input | |
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 | On | The input is on | |
| constant false | Off | The input is off | |
Sample CLI read command (note that discrete_input_configuration_index is a variable):
uom get "modbus/discrete_inputs/${discrete_input_configuration_index}/value"
⇒
true
Sample uom library write command (note that _discrete_input_configuration_index is a variable):
uom.modbus.discrete_inputs[_discrete_input_configuration_index].value=false
Input register configuration settings
| array | modbus/input_registers/ |
| Properties related to custom input registers | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
This array represents a value in persistent storage.
This array contains Input register configuration elements.
Sample uom library write command:
uom.modbus.input_registers={{allow_read=true,index=30093,name="snzwz3",value=43927}}
Sample requests read command:
print(requests.get('http://192.168.0.100/restapi/modbus/input_registers/',auth=auth,headers=headers).json())
⇒
[{'value': 6673, 'allow_read': False, 'name': 'cga66', 'index': 48961}, {'value': 33538, 'allow_read': False, 'name': 'gce63', 'index': 21599}]
See also Input register configuration settings: Input register configuration
Input register configuration settings: Input register configuration
| object | modbus/input_registers/N/ |
| Properties related to a custom input register | |
This object contains the following items:
| name | Name |
| index | Index |
| allow_read | Allow read |
| value | State |
Sample JS request deletion command (note that _input_register_configuration_index is a variable):
request.delete({url:"modbus/input_registers/"+_input_register_configuration_index.toString()+"/"});
Sample curl deletion command (note that :input_register_configuration_index is a URL template argument):
curl --digest -u admin:1234 -H "X-CSRF: x" -X DELETE -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/input_registers/:input_register_configuration_index/"
Name
| string | modbus/input_registers/N/name/ |
| Input register 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 read command (note that _input_register_configuration_index is a variable):
print(uom.dump(uom.modbus.input_registers[_input_register_configuration_index].name))
⇒
"m4"
Sample JS request read command (note that _input_register_configuration_index is a variable):
request.get({url:"modbus/input_registers/"+_input_register_configuration_index.toString()+"/name/"},function(error,response,body) {console.log(body)});
⇒
"eskf4"
Index
| number | modbus/input_registers/N/index/ |
| Zero-based index of input register (without 30...01 added) | |
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 any of the following is true:
This number represents a value in persistent storage.
Sample requests write command (note that _input_register_configuration_index is a variable):
requests.put('http://192.168.0.100/restapi/modbus/input_registers/'+str(_input_register_configuration_index)+'/index/',auth=auth,headers=headers,json=46584)
Sample CLI write command (note that input_register_configuration_index is a variable):
uom set "modbus/input_registers/${input_register_configuration_index}/index" "64206"
Allow read
| sum (boolean) | modbus/input_registers/N/allow_read/ |
| Input register is readable via Modbus/TCP | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
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 JS request write command (note that _input_register_configuration_index is a variable):
request.put({url:"modbus/input_registers/"+_input_register_configuration_index.toString()+"/allow_read/",body:true});
Sample curl write command (note that :input_register_configuration_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/modbus/input_registers/:input_register_configuration_index/allow_read/"
State
| number | modbus/input_registers/N/value/ |
| State of input register | |
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 write command (note that _input_register_configuration_index is a variable):
requests.put('http://192.168.0.100/restapi/modbus/input_registers/'+str(_input_register_configuration_index)+'/value/',auth=auth,headers=headers,json=57422)
Sample curl write command (note that :input_register_configuration_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 "47912" "http://192.168.0.100/restapi/modbus/input_registers/:input_register_configuration_index/value/"
Holding register configuration settings
| array | modbus/holding_registers/ |
| Properties related to custom holding registers | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
This array represents a value in persistent storage.
This array contains Holding register configuration elements.
Sample requests holding register configuration creation command:
requests.post('http://192.168.0.100/restapi/modbus/holding_registers/',auth=auth,headers=headers,json={'allow_read': False, 'name': 'gaz7', 'value': 54425, 'allow_write': True, 'index': 19459})
Sample CLI read command:
uom get "modbus/holding_registers"
⇒
...
See also Holding register configuration settings: Holding register configuration
Holding register configuration settings: Holding register configuration
| object | modbus/holding_registers/N/ |
| Properties related to a custom holding register | |
This object contains the following items:
| name | Name |
| index | Index |
| allow_read | Allow read |
| allow_write | Allow write |
| value | State |
Sample curl read command (note that :holding_register_configuration_index is a URL template argument):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/holding_registers/:holding_register_configuration_index/"
⇒
{"allow_read":false,"name":"ces8","value":58087,"allow_write":false,"index":53535}
Sample uom library read command (note that _holding_register_configuration_index is a variable):
print(uom.dump(uom.modbus.holding_registers[_holding_register_configuration_index]))
⇒
{allow_read=true,allow_write=true,index=23577,name="h96",value=36314}
Name
| string | modbus/holding_registers/N/name/ |
| Holding register 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 _holding_register_configuration_index is a variable):
request.get({url:"modbus/holding_registers/"+_holding_register_configuration_index.toString()+"/name/"},function(error,response,body) {console.log(body)});
⇒
"i57"
Sample uom library write command (note that _holding_register_configuration_index is a variable):
uom.modbus.holding_registers[_holding_register_configuration_index].name="fl71"
Index
| number | modbus/holding_registers/N/index/ |
| Zero-based index of holding register (without 40...01 added) | |
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 any of the following is true:
This number represents a value in persistent storage.
Sample JS request write command (note that _holding_register_configuration_index is a variable):
request.put({url:"modbus/holding_registers/"+_holding_register_configuration_index.toString()+"/index/",body:64265});
Sample CLI read command (note that holding_register_configuration_index is a variable):
uom get "modbus/holding_registers/${holding_register_configuration_index}/index"
⇒
26813
Allow read
| sum (boolean) | modbus/holding_registers/N/allow_read/ |
| Holding register is readable via Modbus/TCP | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
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 read command (note that _holding_register_configuration_index is a variable):
print(requests.get('http://192.168.0.100/restapi/modbus/holding_registers/'+str(_holding_register_configuration_index)+'/allow_read/',auth=auth,headers=headers).json())
⇒
False
Sample JS request write command (note that _holding_register_configuration_index is a variable):
request.put({url:"modbus/holding_registers/"+_holding_register_configuration_index.toString()+"/allow_read/",body:true});
Allow write
| sum (boolean) | modbus/holding_registers/N/allow_write/ |
| Holding register is writable via Modbus/TCP | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
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 (note that _holding_register_configuration_index is a variable):
requests.put('http://192.168.0.100/restapi/modbus/holding_registers/'+str(_holding_register_configuration_index)+'/allow_write/',auth=auth,headers=headers,json=True)
Sample CLI write command (note that holding_register_configuration_index is a variable):
uom set "modbus/holding_registers/${holding_register_configuration_index}/allow_write" "false"
State
| number | modbus/holding_registers/N/value/ |
| State of holding register | |
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 JS request read command (note that _holding_register_configuration_index is a variable):
request.get({url:"modbus/holding_registers/"+_holding_register_configuration_index.toString()+"/value/"},function(error,response,body) {console.log(body)});
⇒
23447
Sample curl write command (note that :holding_register_configuration_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 "22188" "http://192.168.0.100/restapi/modbus/holding_registers/:holding_register_configuration_index/value/"
Modbus broker port, if any
| sum (optional number) | modbus/port/ |
| TCP port to listen on, if any | |
Retrieving the value is denied if not administrative user
Changing the value is denied if any of the following is true:
This sum represents a value in persistent storage.
This sum can assume the following values:
| constant null | Use default port | Listen on TCP port 502 | |
| number | Modbus broker port | TCP port to listen on | all of the following is true: |
Sample JS request read command:
request.get({url:"modbus/port/"},function(error,response,body) {console.log(body)});
⇒
null
Sample JS request write command:
request.put({url:"modbus/port/",body:null});
Notifications
| object | modbus/notifications/ |
| Modbus-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:"modbus/notifications/"},function(error,response,body) {console.log(body)});
⇒
{"events":{"dli.modbus.sample_event":{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}},"parameter_kinds":[]}
Sample CLI read command:
uom get "modbus/notifications"
⇒
{"events":{"dli.modbus.sample_event":{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}},"parameter_kinds":[]}
Parameter kinds
| object | modbus/notifications/parameter_kinds/ |
| Kinds of event parameters | |
This object does not correspond to an actual resource.
This object is empty.
Events
| map | modbus/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 uom library read command:
print(uom.dump(uom.modbus.notifications.events))
⇒
{["dli.modbus.sample_event"]={message_template={"sample event"},parameters={{fixed_value=null,has_fixed_value=false,id="sample_parameter"}}}}
Sample CLI read command:
uom get "modbus/notifications/events"
⇒
{"dli.modbus.sample_event":{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}}
See also Events: Event
Event parameters: Event parameter
| object | modbus/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 read command (note that _event and _event_parameter_index are variables):
request.get({url:"modbus/notifications/events/"+_event+"/parameters/"+_event_parameter_index.toString()+"/"},function(error,response,body) {console.log(body)});
⇒
{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}
Sample requests write command (note that _event and _event_parameter_index are variables):
requests.put('http://192.168.0.100/restapi/modbus/notifications/events/'+_event+'/parameters/'+str(_event_parameter_index)+'/',auth=auth,headers=headers,json={'id': 'sample_parameter', 'has_fixed_value': False, 'fixed_value': None})
Identifier
| string | modbus/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.modbus.notifications.events[_event].parameters[_event_parameter_index].id))
⇒
"sample_parameter"
Sample JS request read command (note that _event and _event_parameter_index are variables):
request.get({url:"modbus/notifications/events/"+_event+"/parameters/"+_event_parameter_index.toString()+"/id/"},function(error,response,body) {console.log(body)});
⇒
"sample_parameter"
Fixed value flag
| sum (boolean) | modbus/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 requests read command (note that _event and _event_parameter_index are variables):
print(requests.get('http://192.168.0.100/restapi/modbus/notifications/events/'+_event+'/parameters/'+str(_event_parameter_index)+'/has_fixed_value/',auth=auth,headers=headers).json())
⇒
False
Sample uom library read command (note that _event and _event_parameter_index are variables):
print(uom.dump(uom.modbus.notifications.events[_event].parameters[_event_parameter_index].has_fixed_value))
⇒
false
Fixed value
| sum (variant) | modbus/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 uom library read command (note that _event and _event_parameter_index are variables):
print(uom.dump(uom.modbus.notifications.events[_event].parameters[_event_parameter_index].fixed_value))
⇒
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/modbus/notifications/events/:event/parameters/:event_parameter_index/fixed_value/"
⇒
null
Events: Event
| object | modbus/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 JS request read command (note that _event is a variable):
request.get({url:"modbus/notifications/events/"+_event+"/"},function(error,response,body) {console.log(body)});
⇒
{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}
Sample requests read command (note that _event is a variable):
print(requests.get('http://192.168.0.100/restapi/modbus/notifications/events/'+_event+'/',auth=auth,headers=headers).json())
⇒
{'parameters': [{'id': 'sample_parameter', 'has_fixed_value': False, 'fixed_value': None}], 'message_template': ['sample event']}
Message template
| array | modbus/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:"modbus/notifications/events/"+_event+"/message_template/"},function(error,response,body) {console.log(body)});
⇒
["sample event"]
Sample CLI read command (note that event is a variable):
uom get "modbus/notifications/events/${event}/message_template"
⇒
["sample event"]
Message template element
| sum (variant) | modbus/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 JS request read command (note that _event and _message_template_element_index are variables):
request.get({url:"modbus/notifications/events/"+_event+"/message_template/"+_message_template_element_index.toString()+"/"},function(error,response,body) {console.log(body)});
⇒
"sample event"
Sample curl read command (note that :event and :message_template_element_index are URL template arguments):
curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/notifications/events/:event/message_template/:message_template_element_index/"
⇒
"sample event"
Severity
| sum (enumerated number) | modbus/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 JS request read command (note that _event is a variable):
request.get({url:"modbus/notifications/events/"+_event+"/severity/"},function(error,response,body) {console.log(body)});
⇒
[]
Sample CLI read command (note that event is a variable):
uom get "modbus/notifications/events/${event}/severity"
⇒
[]
Event parameters
| array | modbus/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 CLI read command (note that event is a variable):
uom get "modbus/notifications/events/${event}/parameters"
⇒
[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}]
Sample JS request read command (note that _event is a variable):
request.get({url:"modbus/notifications/events/"+_event+"/parameters/"},function(error,response,body) {console.log(body)});
⇒
[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}]
See also Event parameters: Event parameter
