BeamOS – Input/Output
Summary
Characteristics
This section provides a list Input/Output electric characteristics inherent in BEAM iSERIES routers:
- Digital non-isolated input (DIN1): Logic low 0 – 5 V; Logic high 8 – 40 V
- Digital open collector (OC) output: 30 V, 300 mA
Status
The Status tab displays the current states the router’s input and output:
Custom Labels
If the default Input/Output labels do not suit your needs, you can always configure custom ones in the Custom Labels section. Click the ‘Edit’ button next to the desired Input or Output and you will be redirected to a window such as this:
The figure above is an example of custom label configuration for Digital Input. You can change an input’s/output’s name and the names of their states. The changes are purely cosmetic and used for easier management purposes.
Status and control from command line
You can control and monitor input and output values via a command line interface (CLI) with the gpio.sh command. You can execute this command without any additional options to get usage syntax examples:
root@beam-onboard:~# gpio.sh
GPIO control aplication
Usage: /sbin/gpio.sh <ACTION> <NAME>
ACTION - set, clear, get, export, invert, dirout, dirin
NAME - SIM MON MRST SDCS CASE DIN1 DOUT1
Where:
- DIN1 – Digital input
- DOUT1 – Digital output
For example, to get the status of the digital output use the following command:
root@beam-onboard:~# gpio.sh get DOUT1
0root@beam-onboard:~# gpio.sh invert DOUT1
root@beam-onboard:~# gpio.sh get DOUT1
1Input
The Input tab is used to configure the router’s input pin.
Input Rules
The Input Rules section provides you with the possibility to set up rules that execute user specified actions after a certain trigger occurs. To add a new rule, look to the Input Configuration section that is just below. Select the input, the trigger and the action for the rule and click the ‘Add’ button. A new rule will appear in the Input Rules list:
Field Name | Value | Description |
|---|---|---|
Enable | yes | no; default: yes | Turns the input rule on or off. |
Input type | Digital; default: Digital | Selects to which input pin the rule will apply. |
Trigger | Input open | Input shorted | Both; default: Input open | Selects which input state will trigger the rule. |
Action | Send SMS | Send email | Change profile | Turn on WiFi | Turn off WiFi | Reboot | Activate output; default: Send SMS | The action that will be taken when the rule is triggered.
Send SMS – sends an SMS message to a specified number(s) or user group. The message text is custom.
Send email – sends an email to the specified address(es). You will be prompted to enter your email account’s authentication information.
Change profile – switches to using another configuration profile. Configuration profiles can be created via the System → Profiles page.
Turn on WiFi/Turn off WiFi – turns WiFi on or off.
Reboot – reboots the router when a specified amount of time passes or instantly after the trigger occurrence.
Activate output – activates the specified router output. |
Output
The Output tab is used to configure the router’s output pin.
Output Configuration
The Output Configuration section is used to change the default state of the router’s output pin.
Post/Get configuration
Field Name | Value | Description |
|---|---|---|
Enable | yes | no; default: no | Turns Post/Get on or off. |
Username | string; default: none | Username used for authentication in POST/GET queries. |
Post/Get examples
It is possible to turn the output on and off by using a valid HTTP POST/GET syntax. Use a web browser or any other compatible software to submit HTTP POST/GET strings to the device.
Below is a table containing syntax examples of this usage:
Action | POST/GET URL |
|---|---|
Turn output on | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=oc |
Turn output off | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=off&pin=oc |
Turn output on after a 10 second delay | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=oc&delay=10 |
Turn output on for 5 seconds | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=oc&time=5 |
Turn output on for 5 seconds after a 10 second delay | http://192.168.1.1/cgi-bin/output?username=user1&password=user1&action=on&pin=oc&delay=10&time=5 |
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 will be performed on the output (can be on or off).
- pin – specifies the output (use oc).
- 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 while specifying time=5, the 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 that way), then after 5 more seconds it will switch to off state. In this case the overall command execution time is 15 seconds.
Periodic control
Field Name | Value | Description |
|---|---|---|
Enable | yes | no; default: no | Turns the rule on or off. |
Output | Digital OC output | Digital relay output; default: Digital OC output | The output pin that will be be effected by the rule. |
Action | On | Off; default: On | The action that will be performed on the output. |
Action timeout | yes | no; default: no | When the rule will be triggered.
Fixed – triggers the specified action on a specified day(s), hour and minute. For example, every Sunday at 8:30 AM.
Interval – performs the action at an interval. For example, every 1 hour during Mondays. |
Scheduler
