Difference between revisions of "RUT955 Input/Output"

From Teltonika Networks Wiki
(17 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Template: Networking_rutos_manual_input_output_rut2_rut9
+
{{Template: Networking_rutxxx_manual_input_output
<!------------------------DEVICE----------------------->
+
<!----------------------------DEVICE DETAILS---------------------------->
| name           = RUT955
+
| name                 = RUT955
| series         = RUT9
+
| series               = RUT9xx
<!----------------------SEPARATORS--------------------->
+
| fw_version            = RUT9XX_R_00.06.04
| analog        = 1    <!-- 0 - doesn't have Analog Input; 1 - has Analog Input -->
+
<!--------------------------------STATUS-------------------------------->
| configurableio = 0    <!-- 0 - doesn't have Configurable I/O; 1 - has Configurable I/O -->
+
| file_status          = Networking_rut955_manual_input_output_status_io_status_v1.png
| dualsim       = 1     <!-- 0 - doesn't have Dual SIM; 1 - has Dual SIM -->
+
| file_status_digital  = Networking_rutxxx_manual_input_output_status_custom_label_digital_input_v1.png
| input_volts    = 9-30  <!-- Input voltage range -->
+
| file_status_analog    = Networking_rut955_manual_input_output_status_custom_label_analog_input_v1.png
| juggler_input  = 0    <!-- first input on the I/O Juggler list. 0 - Input; 1 - Configurable I/O; 2 - Passive/Active Input -->
+
<!--------------------------------INPUT--------------------------------->
| mobile        = 1    <!-- 0 - doesn't have mobile; 1 - has mobile -->
+
| file_input_analog    = Networking_rut955_manual_input_output_input_check_analog_v1.png
| wifi          = 1    <!-- 0 - doesn't have wifi; 1 - has wifi -->
+
| file_input_add       = Networking_rutxxx_manual_input_output_input_input_rules_add_new_v1.png
| acl            = 1    <!-- 0 - doesn't have Analog Current Loop; 1 - has Analog Current Loop -->
+
| file_input_config     = Networking_rut955_manual_input_output_input_input_rules_input_configuration_v1.png
| isolated      = 1
+
<!--------------------------------OUTPUT-------------------------------->
| relay          = 1
+
| file_output_config    = Networking_rut955_manual_input_output_output_output_configuration_v1.png
| galvanic      = 1
+
| file_output_on_off    = Networking_rut955_manual_input_output_output_on_off_v1.png
| digitalpassive = 1
+
| file_output_post_get  = Networking_rutxxx_manual_input_output_output_post_get_configuration_v1.png
 +
| file_output_periodic  = Networking_rut955_manual_input_output_output_periodic_control_v1.png
 +
| file_output_scheduler = Networking_rut955_manual_input_output_output_scheduler_v1.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]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>field name</th>
 +
      <th>value</th>
 +
      <th>description</th>
 +
    </tr>
 +
    <tr>
 +
      <td>Enable</td>
 +
      <td>yes | no; Default: '''no'''</td>
 +
      <td>Toggles POST/GET ON or OFF</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Username</td>
 +
      <td>string; Default: " "</td>
 +
      <td>Username used for authentication in POST/GET queries</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Password</td>
 +
        <td>string; Default: " "</td>
 +
        <td>Password used for authentication in POST/GET queries</td>
 +
    </tr>
 +
</table>
 +
 +
====Post/Get usage====
 +
----
 +
{{Template: webui_services_input_output_post_get_configuration_usage}}
 +
 +
<table class="nd-othertables">
 +
    <tr>
 +
        <th style="width: 500px">ACTION</th>
 +
      <th style="width: 900px">POST/GET URL EXAMPLE</th>
 +
    </tr>
 +
    <tr>
 +
      <td>Turn Relay Output ON</td>
 +
      <td>http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Turn Relay Output ON after a 10 second delay</td>
 +
      <td>http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&delay=10</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Turn Relay Output ON for 5 seconds</td>
 +
        <td>http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&time=5</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Turn Relay Output ON for 5 seconds after a 15 second delay</td>
 +
        <td>http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=relay&delay=15&time=5</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Turn Relay Output OFF for 5 seconds after a 15 second delay</td>
 +
      <td>http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=off&pin=relay&delay=15&time=5</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Turn Open Collector Output ON</td>
 +
        <td>http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=oc</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Turn Open Collector Output OFF</td>
 +
        <td>http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=off&pin=oc</td>
 +
    </tr>
 +
</table>
 +
 +
'''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]]
 +
 +
<table class="nd-mantable">
 +
    <tr>
 +
        <th>field name</th>
 +
      <th>value</th>
 +
      <th>description</th>
 +
    </tr>
 +
    <tr>
 +
      <td>Enable</td>
 +
      <td>yes | no; Default: '''no'''</td>
 +
      <td>Toggles the rule ON or OFF</td>
 +
    </tr>
 +
    <tr>
 +
      <td>Output</td>
 +
      <td>Digital OC output | Digital Relay output; Default: '''Digital OC output'''</td>
 +
      <td>To which output the rule pertains </td>
 +
    </tr>
 +
    <tr>
 +
    <td>Action</td>
 +
        <td>On | Off; Default: '''On'''</td>
 +
        <td>Periodic action to be taken</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Action timeout</td>
 +
        <td>yes | no; Default: '''no'''</td>
 +
        <td>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 </td>
 +
    </tr>
 +
    <tr>
 +
    <td>Timeout (sec)</td>
 +
        <td>integer; Default: " "</td>
 +
        <td>Specifies how long the Action timeout is</td>
 +
    </tr>
 +
    <tr>
 +
    <td>Mode</td>
 +
        <td>Fixed | Interval; Default: '''Fixed'''</td>
 +
        <td>'''Fixed''' mode triggers the specified action on a specified day(s), hour and minute. For example, every Sunday at 8:30 AM<br>
 +
 +
'''Interval''' provides you with the possibility to set up an interval after which the same action takes place</td>
 +
    </tr>
 +
</table>
 +
 +
===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]]'''
 +
 +
[[Category:RUT955 WebUI]]

Revision as of 14:21, 29 July 2019

Main Page > RUT Routers > RUT955 > RUT955 Manual > RUT955 WebUI > RUT955 Services section > RUT955 Input/Output

Template:Networking rutxxx manual input output

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.

Services inputoutput output post get v2.png

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.

Services inputoutput output periodic v2.png

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.

Services inputoutput output scheduler v2.png

Additional Information