DLI DC3 Object Model Reference
20211225T044803Z
Modbus/TCP slave object
objectmodbus/
Object representing the Modbus/TCP slave configuration
dot_inline_dotgraph_638.png

Retrieving the value is denied if not administrative user

This object contains the following items:

enabledModbus/TCP slave enabled
outletsOutlet Modbus configuration settings
discrete_inputsDiscrete input configuration settings
input_registersInput register configuration settings
holding_registersHolding register configuration settings
portModbus broker port, if any
notificationsNotifications

Sample requests write command:

requests.put('http://192.168.0.100/restapi/modbus/',auth=auth,headers=headers,json=<...>)

Sample uom library read command:

print(uom.dump(uom.modbus))

<...>

Browse more samples

Modbus/TCP slave enabled

sum (boolean)modbus/enabled/
Modbus/TCP slave enable status
dot_inline_dotgraph_639.png

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 trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

Sample JS request read command:

request.get({url:"modbus/enabled/"},function(error,response,body) {console.log(body)});

true

Sample requests write command:

requests.put('http://192.168.0.100/restapi/modbus/enabled/',auth=auth,headers=headers,json=True)

Browse more samples

Outlet Modbus configuration settings

arraymodbus/outlets/
Properties related to exposing outlets via Modbus
dot_inline_dotgraph_640.png

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 CLI read command:

uom get "modbus/outlets"

Sample uom library outlet Modbus/TCP configuration creation command:

uom.insert(uom.modbus.outlets,6,{allow_read=true,allow_write=true})

Browse more samples

See also Outlet Modbus configuration settings: Outlet Modbus/TCP configuration

Outlet Modbus configuration settings: Outlet Modbus/TCP configuration

objectmodbus/outlets/N/
Properties related to exposing the outlet via Modbus/TCP
dot_inline_dotgraph_641.png

The value is subject to the following constraints: outlets[index of the value]

This object contains the following items:

allow_readAllow read
allow_writeAllow write

Sample curl write command (note that :outlet_modbus_tcp_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 "{\"allow_write\":true,\"allow_read\":false}" "http://192.168.0.100/restapi/modbus/outlets/:outlet_modbus_tcp_configuration_index/"

Sample requests read command (note that _outlet_modbus_tcp_configuration_index is a variable):

print(requests.get('http://192.168.0.100/restapi/modbus/outlets/'+str(_outlet_modbus_tcp_configuration_index)+'/',auth=auth,headers=headers).json())

{'allow_write': True, 'allow_read': False}

Browse more samples

Allow read

sum (boolean)modbus/outlets/N/allow_read/
Outlet state is reported via Modbus/TCP
dot_inline_dotgraph_642.png

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 trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

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()+"/allow_read/"},function(error,response,body) {console.log(body)});

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_read/"

true

Browse more samples

Allow write

sum (boolean)modbus/outlets/N/allow_write/
Outlet state can be changed via Modbus/TCP
dot_inline_dotgraph_643.png

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 trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

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

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

Browse more samples

Discrete input configuration settings

arraymodbus/discrete_inputs/
Properties related to custom discrete inputs
dot_inline_dotgraph_644.png

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":false,"name":"fazpoz0","index":31816},{"value":true,"allow_read":true,"name":"sf66","index":9092},{"value":true,"allow_read":false,"name":"dclintg1","index":27185}]

Sample requests discrete input configuration creation command:

requests.post('http://192.168.0.100/restapi/modbus/discrete_inputs/',auth=auth,headers=headers,json={'value': True, 'allow_read': True, 'name': 'sks17', 'index': 43545})

Browse more samples

See also Discrete input configuration settings: Discrete input configuration

Discrete input configuration settings: Discrete input configuration

objectmodbus/discrete_inputs/N/
Properties related to a custom discrete input

This object contains the following items:

nameName
indexIndex
allow_readAllow read
valueState

Sample uom library read command (note that _discrete_input_configuration_index is a variable):

print(uom.dump(uom.modbus.discrete_inputs[_discrete_input_configuration_index]))

{allow_read=true,index=65270,name="lvznczc5",value=true}

Sample JS request read command (note that _discrete_input_configuration_index is a variable):

request.get({url:"modbus/discrete_inputs/"+_discrete_input_configuration_index.toString()+"/"},function(error,response,body) {console.log(body)});

{"value":false,"allow_read":true,"name":"l53","index":7767}

Browse more samples

Name

stringmodbus/discrete_inputs/N/name/
Discrete input name
dot_inline_dotgraph_645.png

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 write command (note that _discrete_input_configuration_index is a variable):

request.put({url:"modbus/discrete_inputs/"+_discrete_input_configuration_index.toString()+"/name/",body:"se1"});

Sample requests read command (note that _discrete_input_configuration_index is a variable):

print(requests.get('http://192.168.0.100/restapi/modbus/discrete_inputs/'+str(_discrete_input_configuration_index)+'/name/',auth=auth,headers=headers).json())

'lc38'

Browse more samples

Index

numbermodbus/discrete_inputs/N/index/
Zero-based index of discrete input (without 10...01 added)
dot_inline_dotgraph_646.png

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 CLI write command (note that discrete_input_configuration_index is a variable):

uom set "modbus/discrete_inputs/${discrete_input_configuration_index}/index" "43618"

Sample uom library read command (note that _discrete_input_configuration_index is a variable):

print(uom.dump(uom.modbus.discrete_inputs[_discrete_input_configuration_index].index))

10891

Browse more samples

Allow read

sum (boolean)modbus/discrete_inputs/N/allow_read/
Discrete input is readable via Modbus/TCP
dot_inline_dotgraph_647.png

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 trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

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 "false" "http://192.168.0.100/restapi/modbus/discrete_inputs/:discrete_input_configuration_index/allow_read/"

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)+'/allow_read/',auth=auth,headers=headers,json=True)

Browse more samples

State

sum (boolean)modbus/discrete_inputs/N/value/
State of discrete input
dot_inline_dotgraph_648.png

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 trueOnThe input is on
constant falseOffThe input is off

Sample uom library write command (note that _discrete_input_configuration_index is a variable):

uom.modbus.discrete_inputs[_discrete_input_configuration_index].value=false

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 "false" "http://192.168.0.100/restapi/modbus/discrete_inputs/:discrete_input_configuration_index/value/"

Browse more samples

Input register configuration settings

arraymodbus/input_registers/
Properties related to custom input registers
dot_inline_dotgraph_649.png

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 CLI write command:

uom set "modbus/input_registers" "[{\"value\":50024,\"allow_read\":true,\"name\":\"yxtqvb9\",\"index\":22333},{\"value\":40990,\"allow_read\":false,\"name\":\"yrnpare3\",\"index\":56943}]"

Sample uom library write command:

uom.modbus.input_registers={{allow_read=true,index=30273,name="dnca1",value=2359}}

Browse more samples

See also Input register configuration settings: Input register configuration

Input register configuration settings: Input register configuration

objectmodbus/input_registers/N/
Properties related to a custom input register

This object contains the following items:

nameName
indexIndex
allow_readAllow read
valueState

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]))

{allow_read=false,index=31158,name="xyzn28",value=23789}

Sample CLI deletion command (note that input_register_configuration_index is a variable):

uom remove "modbus/input_registers/${input_register_configuration_index}"

Browse more samples

Name

stringmodbus/input_registers/N/name/
Input register name
dot_inline_dotgraph_650.png

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 requests read command (note that _input_register_configuration_index is a variable):

print(requests.get('http://192.168.0.100/restapi/modbus/input_registers/'+str(_input_register_configuration_index)+'/name/',auth=auth,headers=headers).json())

'wiqbvta1'

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 "\"tmgfy4\"" "http://192.168.0.100/restapi/modbus/input_registers/:input_register_configuration_index/name/"

Browse more samples

Index

numbermodbus/input_registers/N/index/
Zero-based index of input register (without 30...01 added)
dot_inline_dotgraph_651.png

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=36745)

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()+"/index/"},function(error,response,body) {console.log(body)});

21419

Browse more samples

Allow read

sum (boolean)modbus/input_registers/N/allow_read/
Input register is readable via Modbus/TCP
dot_inline_dotgraph_652.png

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 trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

Sample CLI read command (note that input_register_configuration_index is a variable):

uom get "modbus/input_registers/${input_register_configuration_index}/allow_read"

false

Sample curl read command (note that :input_register_configuration_index is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/input_registers/:input_register_configuration_index/allow_read/"

false

Browse more samples

State

numbermodbus/input_registers/N/value/
State of input register
dot_inline_dotgraph_653.png

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 (note that _input_register_configuration_index is a variable):

print(requests.get('http://192.168.0.100/restapi/modbus/input_registers/'+str(_input_register_configuration_index)+'/value/',auth=auth,headers=headers).json())

37850

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()+"/value/"},function(error,response,body) {console.log(body)});

1560

Browse more samples

Holding register configuration settings

arraymodbus/holding_registers/
Properties related to custom holding registers
dot_inline_dotgraph_654.png

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 JS request read command:

request.get({url:"modbus/holding_registers/"},function(error,response,body) {console.log(body)});

[{"allow_read":false,"name":"yzdu51","value":40301,"allow_write":true,"index":23271},{"allow_read":false,"name":"mt66","value":16327,"allow_write":false,"index":62492},{"allow_read":false,"name":"tu67","value":7926,"allow_write":true,"index":49598}]

Sample uom library write command:

uom.modbus.holding_registers={{allow_read=false,allow_write=true,index=20956,name="o1",value=43864}}

Browse more samples

See also Holding register configuration settings: Holding register configuration

Holding register configuration settings: Holding register configuration

objectmodbus/holding_registers/N/
Properties related to a custom holding register

This object contains the following items:

nameName
indexIndex
allow_readAllow read
allow_writeAllow write
valueState

Sample CLI write command (note that holding_register_configuration_index is a variable):

uom set "modbus/holding_registers/${holding_register_configuration_index}" "{\"allow_read\":false,\"name\":\"toumo67\",\"value\":62454,\"allow_write\":true,\"index\":52558}"

Sample curl deletion command (note that :holding_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/holding_registers/:holding_register_configuration_index/"

Browse more samples

Name

stringmodbus/holding_registers/N/name/
Holding register name
dot_inline_dotgraph_655.png

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 _holding_register_configuration_index is a variable):

uom.modbus.holding_registers[_holding_register_configuration_index].name="lzrneg5"

Sample CLI read command (note that holding_register_configuration_index is a variable):

uom get "modbus/holding_registers/${holding_register_configuration_index}/name"

"thunttpa0"

Browse more samples

Index

numbermodbus/holding_registers/N/index/
Zero-based index of holding register (without 40...01 added)
dot_inline_dotgraph_656.png

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 uom library read command (note that _holding_register_configuration_index is a variable):

print(uom.dump(uom.modbus.holding_registers[_holding_register_configuration_index].index))

45089

Sample uom library write command (note that _holding_register_configuration_index is a variable):

uom.modbus.holding_registers[_holding_register_configuration_index].index=62101

Browse more samples

Allow read

sum (boolean)modbus/holding_registers/N/allow_read/
Holding register is readable via Modbus/TCP
dot_inline_dotgraph_657.png

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 trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

Sample uom library write command (note that _holding_register_configuration_index is a variable):

uom.modbus.holding_registers[_holding_register_configuration_index].allow_read=false

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))

false

Browse more samples

Allow write

sum (boolean)modbus/holding_registers/N/allow_write/
Holding register is writable via Modbus/TCP
dot_inline_dotgraph_658.png

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 trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

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 "true" "http://192.168.0.100/restapi/modbus/holding_registers/:holding_register_configuration_index/allow_write/"

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_write))

false

Browse more samples

State

numbermodbus/holding_registers/N/value/
State of holding register
dot_inline_dotgraph_659.png

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 write command (note that _holding_register_configuration_index is a variable):

request.put({url:"modbus/holding_registers/"+_holding_register_configuration_index.toString()+"/value/",body:38349});

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 "41392" "http://192.168.0.100/restapi/modbus/holding_registers/:holding_register_configuration_index/value/"

Browse more samples

Modbus broker port, if any

sum (optional number)modbus/port/
TCP port to listen on, if any
dot_inline_dotgraph_660.png

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 nullUse default portListen on TCP port 502
numberModbus broker portTCP port to listen on

all of the following is true:

Sample uom library write command:

uom.modbus.port=null

Sample CLI read command:

uom get "modbus/port"

null

Browse more samples

Notifications

objectmodbus/notifications/
Modbus-related notifications
dot_inline_dotgraph_661.png

Retrieving the value is denied if not administrative user

This object does not support direct modification.

This object contains the following items:

parameter_kindsParameter kinds
eventsEvents

Sample curl read command:

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/modbus/notifications/"

{"events":{"dli.modbus.sample_event":{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}},"parameter_kinds":[]}

Sample requests read command:

print(requests.get('http://192.168.0.100/restapi/modbus/notifications/',auth=auth,headers=headers).json())

{'events': {'dli.modbus.sample_event': {'parameters': [{'id': 'sample_parameter', 'has_fixed_value': False, 'fixed_value': None}], 'message_template': ['sample event']}}, 'parameter_kinds': {}}

Browse more samples

Parameter kinds

objectmodbus/notifications/parameter_kinds/
Kinds of event parameters

This object does not correspond to an actual resource.

This object is empty.

Events

mapmodbus/notifications/events/
Event templates
dot_inline_dotgraph_662.png

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 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"]}}

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"}}}}

Browse more samples

See also Events: Event

Event parameters: Event parameter

objectmodbus/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:

idIdentifier
has_fixed_valueFixed value flag
fixed_valueFixed value

Sample uom library write command (note that _event and _event_parameter_index are variables):

uom.modbus.notifications.events[_event].parameters[_event_parameter_index]={fixed_value=null,has_fixed_value=false,id="sample_parameter"}

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/"

{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}

Browse more samples

Identifier

stringmodbus/notifications/events/S/parameters/N/id/
Parameter identifier
dot_inline_dotgraph_663.png

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 CLI read command (note that event and event_parameter_index are variables):

uom get "modbus/notifications/events/${event}/parameters/${event_parameter_index}/id"

"sample_parameter"

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"

Browse more samples

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
dot_inline_dotgraph_664.png

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 trueFixedThe value is fixed
constant falseVariableThe 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/modbus/notifications/events/:event/parameters/:event_parameter_index/has_fixed_value/"

false

Sample CLI read command (note that event and event_parameter_index are variables):

uom get "modbus/notifications/events/${event}/parameters/${event_parameter_index}/has_fixed_value"

false

Browse more samples

Fixed value

sum (variant)modbus/notifications/events/S/parameters/N/fixed_value/
Fixed parameter value for this particular event
dot_inline_dotgraph_665.png

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 nullNullNull
constant trueTrueTrue
constant falseFalseFalse
stringStringThis string
numberNumberThis number

Sample CLI read command (note that event and event_parameter_index are variables):

uom get "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

Browse more samples

Events: Event

objectmodbus/notifications/events/S/
Event template
dot_inline_dotgraph_666.png

This object is a part of a composite value which is modified as a whole.

This object contains the following items:

message_templateMessage template
severitySeverity
parametersEvent parameters

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/modbus/notifications/events/:event/"

{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}

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"]}

Browse more samples

Message template

arraymodbus/notifications/events/S/message_template/
Template for human-readable message generation
dot_inline_dotgraph_667.png

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 CLI read command (note that event is a variable):

uom get "modbus/notifications/events/${event}/message_template"

["sample event"]

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/modbus/notifications/events/:event/message_template/"

["sample event"]

Browse more samples

Message template element

sum (variant)modbus/notifications/events/S/message_template/N/
Element of human-readable message template
dot_inline_dotgraph_668.png

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:

stringStringFixed string
numberParameterIndex of message parameter to insertevent 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/modbus/notifications/events/'+_event+'/message_template/'+str(_message_template_element_index)+'/',auth=auth,headers=headers).json())

'sample event'

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"

Browse more samples

Severity

sum (enumerated number)modbus/notifications/events/S/severity/
Severity rating assigned to the event
dot_inline_dotgraph_669.png

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 1EmergencyTreat the event as an emergency
constant 2AlertTreat the event as an alert
constant 3CriticalTreat the event as critical
constant 4ErrorTreat the event as an error
constant 5WarningTreat the event as a warning
constant 6NoticeTreat the event as a notice
constant 7InformationalTreat the event as informational
constant 8DebugTreat 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 uom library read command (note that _event is a variable):

print(uom.dump(uom.modbus.notifications.events[_event].severity))

{}

Browse more samples

Event parameters

arraymodbus/notifications/events/S/parameters/
Additional data associated with the event
dot_inline_dotgraph_670.png

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 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}]

Sample uom library read command (note that _event is a variable):

print(uom.dump(uom.modbus.notifications.events[_event].parameters))

{{fixed_value=null,has_fixed_value=false,id="sample_parameter"}}

Browse more samples

See also Event parameters: Event parameter