RUT955 Input/Output: Difference between revisions
No edit summary |
|||
(24 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
{{Template: | ==Summary== | ||
| | {{Template: webui_services_input_output_summary}} | ||
| | |||
==Characteristics== | |||
| | |||
| | {{Template: rut955_webui_services_input_output_characteristics}} | ||
| | |||
| | ==Status== | ||
| | |||
| | {{Template: webui_services_input_output_status}} | ||
| | |||
| | [[File:Services inputoutput status v2.png]] | ||
| | |||
| | ===Custom Labels=== | ||
| | ---- | ||
| | {{Template: rut955_webui_services_input_output_status_custom_labels}} | ||
} | |||
===Status and control from command line=== | |||
---- | |||
{{Template: rut955_webui_services_input_output_status_cli_io}} | |||
---- | |||
{{Template: rut955_webui_services_input_output_status_cli_io_analog}} | |||
==Input== | |||
The '''Input''' section is used to configure Input rules and set Analog Input value check interval: | |||
[[File:Services inputoutput input check v2.png]] | |||
===Input Rules=== | |||
---- | |||
'''Input Rules''' provides you with the possibility to set up rules that execute specified actions after specified triggers occur. | |||
[[File:Services inputoutput input configuration v2.png]] | |||
<table class="nd-mantable"> | |||
<tr> | |||
<th>field name</th> | |||
<th>value</th> | |||
<th>description</th> | |||
</tr> | |||
<tr> | |||
<td>Enable</td> | |||
<td>yes {{!}} no; Default: '''yes'''</td> | |||
<td>Toggles the Input rule ON or OFF</td> | |||
</tr> | |||
<tr> | |||
<td>Input type</td> | |||
<td>Digital {{!}} Digital isolated {{!}} Analog; Default: '''Digital'''</td> | |||
<td>Selects which Input is tied to the rule</td> | |||
</tr> | |||
<tr> | |||
<td>Trigger</td> | |||
<td>Input open {{!}} Input shorted {{!}} Both; Default: '''Input open'''</td> | |||
<td>Specifies the Trigger after which the rule will take effect</td> | |||
</tr> | |||
<tr> | |||
<td>Action</td> | |||
<td>Send SMS {{!}} Change SIM card {{!}} Send email {{!}} Change profile {{!}} Turn on WiFi {{!}} Turn off WiFi {{!}} Reboot {{!}} Activate output {{!}} HTTP POST/GET; Default: '''Send SMS'''</td> | |||
<td>Action to be taken after the Trigger takes place | |||
'''Send SMS''' - sends an SMS message to a specified number(s). The message text is custom | |||
'''Change SIM card''' - switches the SIM card that is currently in use | |||
'''Send email''' - sends an email to the specified address. You will be prompted to enter your email account's authentication information | |||
'''Change profile''' - switches the profile in use to the specified profile | |||
'''Turn on WiFi/Turn off WiFi''' - turns WiFi ON or OFF | |||
'''Reboot''' - reboots the router after a specified amount of time | |||
'''Activate output''' - activates specified output | |||
'''HTTP POST/GET''' - gets or posts data to HTTP</td> | |||
</tr> | |||
</table> | |||
==Output== | |||
The '''Output''' section is used to configure the router's outputs: '''Relay''' Output and '''Open Collector''' ('''OC''') Output. | |||
===Output Configuration=== | |||
---- | |||
The '''Output Configuration''' tab is used to change the default states of the router's outputs. | |||
[[File:Services inputoutput output configuration v2.png]] | |||
<table class="nd-mantable"> | |||
<tr> | |||
<th>field name</th> | |||
<th>value</th> | |||
<th>description</th> | |||
</tr> | |||
<tr> | |||
<td>Open collector output</td> | |||
<td>High level {{!}} Low level; Default: '''Low level'''</td> | |||
<td>Changes the default<span style="color:#0054A6;">'''*'''</span> state of the Open collector (OC) output</td> | |||
</tr> | |||
<tr> | |||
<td>Relay output</td> | |||
<td>Contacts open {{!}} Contacts closed; Default: '''Contacts closed'''</td> | |||
<td>Relay Output default state</td> | |||
</tr> | |||
</table> | |||
<span style="color:#0054A6;">'''*'''</span> Changing the default state of an output means that the changes will be written into the input/output config and saved, therefore making the change permanent. This means that, unless some other related change occurs, the state of the output will remain as set in this section. Therefore, if the input/output service restarts or the device reboots, it will have no effect on the state of the output. | |||
===ON/OFF=== | |||
---- | |||
The '''ON/OFF''' section is used to turn Outputs ON or OFF, but it doesn't save the state permanently, meaning that after a reboot the states will revert back to their default values. | |||
[[File:Services inputoutput output onoff v2.png]] | |||
===Post/Get Configuration=== | |||
---- | |||
'''Post/Get Configuration''' allows you to perform action requests by writing them in the URL field after your device’s IP address. | |||
[[File:Services inputoutput output post get v2.png]] | |||
{| class="wikitable" | |||
|+ | |||
! style="width: 250px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | FIELD NAME | |||
! style="width: 250px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | VALUE | |||
! style="width: 579px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | DESCRIPTION | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Enable | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | yes {{!}} no; Default: '''no''' | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Toggles POST/GET ON or OFF | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Username | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | string; Default: " " | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Username used for authentication in POST/GET queries | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Password | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | string; Default: " " | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Password used for authentication in POST/GET queries | |||
|- | |||
|} | |||
====Post/Get usage==== | |||
---- | |||
{{Template: webui_services_input_output_post_get_configuration_usage}} | |||
{| class="wikitable" | |||
|+ | |||
! style="width: 500px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | ACTION | |||
! style="width: 900px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | POST/GET URL EXAMPLE | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Turn Relay Output ON | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Turn Relay Output ON after a 10 second delay | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&delay=10 | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Turn Relay Output ON for 5 seconds | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&time=5 | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Turn Relay Output ON for 5 seconds after a 15 second delay | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&delay=15&time=5 | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Turn Relay Output OFF for 5 seconds after a 15 second delay | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=off&pin=relay&delay=15&time=5 | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Turn Open Collector Output ON | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=oc | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Turn Open Collector Output OFF | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=off&pin=oc | |||
|- | |||
|} | |||
'''Overview''': | |||
* '''192.168.1.1''' - router's default LAN IP address; replace it in accordance with your own configuration | |||
* '''username''' - login name from Post/Get Configuration | |||
* '''password''' - password from Post/Get Configuration | |||
* '''action''' - the action that is to be performed on the specified Output (can be '''on''' or '''off''') | |||
* '''pin''' - specifies on which Output the action will be applied (can be '''oc''' or '''relay''') | |||
* '''delay''' - defines a delay (in seconds) after which the specified action will be performed | |||
* '''time''' - defines a window of time during which the action will take place. For instance, if you post an ON action for an output while specifying '''time=5''', that Output will turn ON and stay ON for 5 seconds before turning OFF | |||
Delay and time parameters can be used together. For example, if delay is 10, time is 5, action is on, then 10 seconds after the execution of the command, the output will switch to ON (or stay in ON state if it was already ON), then after 5 more seconds it will switch to OFF state. In this case, the overall command execution time is 15 seconds. | |||
Actions ON and OFF depend on setting „Output configuration in active state“ (ON is active state), which can be set via [[Input/Output#Output|Services → Input/Output → Output]] | |||
===Periodic Control=== | |||
---- | |||
The '''Periodic control''' section allows you to set up automatic output control rules that trigger output state changes at the specified period or interval. | |||
[[File:Services inputoutput output periodic v2.png]] | |||
{| class="wikitable" | |||
|+ | |||
! style="width: 250px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | FIELD NAME | |||
! style="width: 250px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | VALUE | |||
! style="width: 579px; border: 1px solid white; border-bottom: 2px solid #0054A6; background: white; color: #0054A6; text-align: left;" | DESCRIPTION | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Enable | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | yes {{!}} no; Default: '''no''' | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Toggles the rule ON or OFF | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Output | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Digital OC output {{!}} Digital Relay output; Default: '''Digital OC output''' | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | To which output the rule pertains | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Action | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | On {{!}} Off; Default: '''On''' | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Periodic action to be taken | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Action timeout | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | yes {{!}} no; Default: '''no''' | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Activates action timeout. Action timeout specifies whether an action should end after some time. For example, if the specified Action is to turn Digital OC output On and the action triggers, the Action timeout then turns Digital OC output back off after a specified amount of time in seconds specified in this field | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Timeout (sec) | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | integer; Default: " " | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Specifies how long the Action timeout is | |||
|- | |||
! style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Mode | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | Fixed {{!}} Interval; Default: '''Fixed''' | |||
| style="border: 1px solid white; border-bottom: 2px solid #E8E8E8; text-align: left; vertical-align: top; background: white;" | '''Fixed''' mode triggers the specified action on a specified day(s), hour and minute. For example, every Sunday at 8:30 AM | |||
'''Interval''' provides you with the possibility to set up an interval after which the same action takes place | |||
|- | |||
|} | |||
===Scheduler=== | |||
---- | |||
The '''Scheduler''' lets you configure a schedule of when certain outputs are to be enabled or disabled. | |||
[[File:Services inputoutput output scheduler v2.png]] | |||
==Additional Information== | |||
* Input/Output hardware application examples: | |||
** '''[[RUT955 Connecting relay to open collector output|Connecting relay to open collector output]]''' | |||
** '''[[Inverting RUT955 relay output polarity|Inverting relay output polarity]]''' | |||
** '''[[Using RUT955 Inputs for security applications|Using Inputs for security applications]]''' | |||
** '''[[Current measurement with RUT955 analog input|Current measurement with analog input]]''' |
Revision as of 11:10, 19 December 2018
Main Page > EOL Products > RUT955 > RUT955 Manual > RUT955 WebUI > RUT955 Services section > RUT955 Input/OutputSummary
Template:Webui services input output summary
Characteristics
Template:Rut955 webui services input output characteristics
Status
Template:Webui services input output status
Custom Labels
Template:Rut955 webui services input output status custom labels
Status and control from command line
Template:Rut955 webui services input output status cli io
Template:Rut955 webui services input output status cli io analog
Input
The Input section is used to configure Input rules and set Analog Input value check interval:
Input Rules
Input Rules provides you with the possibility to set up rules that execute specified actions after specified triggers occur.
field name | value | description |
---|---|---|
Enable | yes | no; Default: yes | Toggles the Input rule ON or OFF |
Input type | Digital | Digital isolated | Analog; Default: Digital | Selects which Input is tied to the rule |
Trigger | Input open | Input shorted | Both; Default: Input open | Specifies the Trigger after which the rule will take effect |
Action | Send SMS | Change SIM card | Send email | Change profile | Turn on WiFi | Turn off WiFi | Reboot | Activate output | HTTP POST/GET; Default: Send SMS | Action to be taken after the Trigger takes place
Send SMS - sends an SMS message to a specified number(s). The message text is custom Change SIM card - switches the SIM card that is currently in use Send email - sends an email to the specified address. You will be prompted to enter your email account's authentication information Change profile - switches the profile in use to the specified profile Turn on WiFi/Turn off WiFi - turns WiFi ON or OFF Reboot - reboots the router after a specified amount of time Activate output - activates specified output HTTP POST/GET - gets or posts data to HTTP |
Output
The Output section is used to configure the router's outputs: Relay Output and Open Collector (OC) Output.
Output Configuration
The Output Configuration tab is used to change the default states of the router's outputs.
field name | value | description |
---|---|---|
Open collector output | High level | Low level; Default: Low level | Changes the default* state of the Open collector (OC) output |
Relay output | Contacts open | Contacts closed; Default: Contacts closed | Relay Output default state |
* Changing the default state of an output means that the changes will be written into the input/output config and saved, therefore making the change permanent. This means that, unless some other related change occurs, the state of the output will remain as set in this section. Therefore, if the input/output service restarts or the device reboots, it will have no effect on the state of the output.
ON/OFF
The ON/OFF section is used to turn Outputs ON or OFF, but it doesn't save the state permanently, meaning that after a reboot the states will revert back to their default values.
Post/Get Configuration
Post/Get Configuration allows you to perform action requests by writing them in the URL field after your device’s IP address.
FIELD NAME | VALUE | DESCRIPTION |
---|---|---|
Enable | yes | no; Default: no | Toggles POST/GET ON or OFF |
Username | string; Default: " " | Username used for authentication in POST/GET queries |
Password | string; Default: " " | Password used for authentication in POST/GET queries |
Post/Get usage
Template:Webui services input output post get configuration usage
ACTION | POST/GET URL EXAMPLE |
---|---|
Turn Relay Output ON | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay |
Turn Relay Output ON after a 10 second delay | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&delay=10 |
Turn Relay Output ON for 5 seconds | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&time=5 |
Turn Relay Output ON for 5 seconds after a 15 second delay | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&delay=15&time=5 |
Turn Relay Output OFF for 5 seconds after a 15 second delay | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=off&pin=relay&delay=15&time=5 |
Turn Open Collector Output ON | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=oc |
Turn Open Collector Output OFF | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=off&pin=oc |
Overview:
- 192.168.1.1 - router's default LAN IP address; replace it in accordance with your own configuration
- username - login name from Post/Get Configuration
- password - password from Post/Get Configuration
- action - the action that is to be performed on the specified Output (can be on or off)
- pin - specifies on which Output the action will be applied (can be oc or relay)
- delay - defines a delay (in seconds) after which the specified action will be performed
- time - defines a window of time during which the action will take place. For instance, if you post an ON action for an output while specifying time=5, that Output will turn ON and stay ON for 5 seconds before turning OFF
Delay and time parameters can be used together. For example, if delay is 10, time is 5, action is on, then 10 seconds after the execution of the command, the output will switch to ON (or stay in ON state if it was already ON), then after 5 more seconds it will switch to OFF state. In this case, the overall command execution time is 15 seconds.
Actions ON and OFF depend on setting „Output configuration in active state“ (ON is active state), which can be set via Services → Input/Output → Output
Periodic Control
The Periodic control section allows you to set up automatic output control rules that trigger output state changes at the specified period or interval.
FIELD NAME | VALUE | DESCRIPTION |
---|---|---|
Enable | yes | no; Default: no | Toggles the rule ON or OFF |
Output | Digital OC output | Digital Relay output; Default: Digital OC output | To which output the rule pertains |
Action | On | Off; Default: On | Periodic action to be taken |
Action timeout | yes | no; Default: no | Activates action timeout. Action timeout specifies whether an action should end after some time. For example, if the specified Action is to turn Digital OC output On and the action triggers, the Action timeout then turns Digital OC output back off after a specified amount of time in seconds specified in this field |
Timeout (sec) | integer; Default: " " | Specifies how long the Action timeout is |
Mode | Fixed | Interval; Default: Fixed | Fixed mode triggers the specified action on a specified day(s), hour and minute. For example, every Sunday at 8:30 AM
Interval provides you with the possibility to set up an interval after which the same action takes place |
Scheduler
The Scheduler lets you configure a schedule of when certain outputs are to be enabled or disabled.
Additional Information
- Input/Output hardware application examples: