JRMON User Commands
NAME
jrmon - JNIOR I/O Utility
SYNOPSIS
jrmon [OPTIONS]
DESCRIPTION
This command provides command line access to the I/O features of the
JNIOR. It is a useful diagnostic tool as well.
When executed without OPTIONS the command displays the current state
of digital inputs and relay outputs including those assigned to external
4ROUT modules. A 'twirly' (a character sequence / - \ | emulating rotation)
spins to indicate active monitoring. Any keyboard keystroke exits the
command.
WARNING: THE FOLLOWING COMMANDS AFFECT RELAY STATES AND THEREBY ANY
EQUIPMENT WIRED TO THOSE RELAYS. DO NOT ATTEMPT THESE ACTIONS UNLESS
YOU ARE CERTAIN THAT THE RESULT WILL NOT DAMAGE EQUIPMENT OR OTHERWISE
CAUSE UNWANTED EVENTS TO OCCUR.
ACTIONS
Single character commands are accepted at the JRMON prompt in interactive
mode. A sequence is executed with the ENTER keystroke. These can also be
executed from the command line using the JRMON -X command.
[C]lose NNN
Causes 1 or more relays to Close (be activated, LED illuminates). For
example 'c35' closes Relay Outputs 3 and 5 simultaneously.
[O]pen NNN
Causes 1 or more relays to Open (be deactivated, LED extinguishes). For
example 'o35' opens Relay Outputs 3 and 5 reversing the above example.
[P]ulse
A relay may be pulsed for a very specific time defines in milliseconds.
This action must be combines with a Close or Open. For instance the
command 'cp2' pulses Relay Output 2. This can pulse an output ON for a
moment and then back OFF. I can also pulse the output OFF and then back
ON.
Pulses have a duration. The default pulse duration is 100 milliseconds.
The '=' equals sign can be used to specify the pulse duration. The
command 'c1p = 2000' pulses Relay Output 1 foe 2 seconds. This does not
alter the default and therefore the command 'c1p' pulses the same output
for just 0.1 seconds (100 milliseconds). However, the command 'p = 2000'
alters the default to 2000 milliseconds.
NNN
Relay outputs and Digital Inputs are identified by single individual
numeric digits. You can enter 1 or more digits. Relay Outputs 1-8 are
designated with numerals '1' thru '8'. Relay Outputs 9-12 are considered
to be a second bank of 8 and are referenced by preceding the digit with
the '+'sign. The command 'c1+12' closes Relay Outputs 1, 2, and 9.
An '*' asterisk specifies ALL. You can open all relays with the
command 'o*'.
[R]eset NNN
Digital Inputs may be latched. Depending on configuration these may
reuire manual intervention to be reset or unlatched. The command 'r2'
resets any active latching on Digital Input 2.
[L]ist
The 'l' lowercase 'L' command lists the values of the input counters.
[S]et NNN
This sets the counter or counters for the specified Digital Inputs. You
can set a counter to a specific value if a correction is needed or clear
the counters to 0 zero. The command 's1=1241' set the counter to Digital
Input 1 to 1,241 while the command 's*=0' resets all counts to 0 zero.
[U]sage
The 'u' command displays the value of Usage (Metering) timers. These may
be viewed and can only be reset by application.
[Q]uit
The 'q' command exits JRMON terminating the interactive session.
COMMAND LINE SYNTAX
-C
Enters Control Mode. In this mode commands may be issued to Close,
Open or Pulse individual relays or even all of the relays. For example:
q - exit the program
c1 - close Relay Output 1
o1 - open Relay Output 1
c3p=2000 - close Relay Output 3 for 2 seconds (pulse)
c25 - close Relay Outputs 2 and 5 simultaneously
o - open all Relay Outputs
Relay Outputs 1-8 are defined by a single character. The plus '+'
sign is used to reach relays 9-16 with digit characters 1-8.
c+1 - close Relay Output 9
c5+2 - close Relay Outputs 5 and 10
The default pulse is 100 milliseconds. This can be altered for the
current command instance.
p=5000 - set 5 second pulsing
c1p - close Relay Output 1 for 5 seconds
c2 - close Relay Output 2
o2p - open Relay Output 2 for 5 seconds.
Digital inputs can be configured for Latching. Once latched the input
need to be reset somehow and possible by an application.
r2 - reset latched Digital Input 2
Input transitions are tallied by Counters. These can be displayed and
even preset by the following actions.
l - list counters (lowercase L)
s1=1024 - set DIN1 counter to 1024
s*=0 - reset all counters
Usage meters tally time for inputs and outputs. While those cannot be
set here you can view them.
u - view all usage meters
-X CMD
Execute control command CMD immediately and return. This performs the
request and does not enter the monitoring mode. The following immediately
opens all relays.
jrmon -x o
-D
Diagnostics Mode. This is the same as the -C Control Mode with the
addition of a T action. This runs a complex pattern of relay outputs
just to showoff the relays. It is interesting but would be really
really bad if anything were actually wired to the JNIOR.
-M
System Monitor mode. This mode is not related to I/O but allows you
monitor system load in real-time. The system load is determined by
measuring the overhead time involved in process swaps away from the
monitoring process. System heap status is also shown. Any keyboard
input exits the command.
SEE ALSO
HELP Topics:
IOLOG
[/flash/manpages/manpages.hlp:4533]