Skip to end of metadata
Go to start of metadata

Overview

Indigo supports a Command Repeater widget tool that allows you to define collections of commands and variables that you can use to send repeated commands to a connected device/host.
This is particularly useful is you want to send one or more commands repeatedly for testing or for querying a device/host.  
You can also include dynamic variables in the repeated commands where the variable substitution can be updated via a mathematical expression on each repeat cycle.

View Menu

The Command Repeater widget can be displayed using the View Menu.

Widget Docking, Pinning, Re-sizing

Widget docking, pinning, re-sizing, etc information is listed here.

User Interface

The Command Repeater user interface consists of a grid listing of commands and variables with a single options toolbar and a status bar.

Command TabVariables Tab

The Command Repeater widget options are listed below.

 NameDescription
New

This option will prompt the user to create a new command repeater data file.

Open

This option will prompt the user to select and existing command repeater data file.
When a file is selected the Command Repeater widget will refresh and display the contents of the newly selected file.

Save

This option will prompt the user to save the current command repeater data file.
(The current command repeater data file is automatically saved when the Indigo application is closed.

Edit

This option will switch the Command Repeater widget into edit mode.
Edit mode will allow adding and editing commands on the command tab.

Tip

Existing variable replacement values can be edited even when not in edit mode.

ConfigureThis option will open the Command Repeater run-time settings
StartThis option will start/resume sending commands from the Command Repeater to the active terminal session.
StopThis option will stop sending commands from the Command Repeater to the active terminal session.
PauseThis option will pause/resume sending commands from the Command Repeater to the active terminal session.

The Command Repeater widget also supports a right-click context menu that provides the same options.

(The View Toolbox option will show and hide the toolbar in the Command Repeater widget.)

Edit Mode User Interface

When in the edit mode, the Command Repeater user interface will include a few more toolbar options and allow editing of the commands in the data grid.

Command TabVariables Tab

The additional Command Repeater widget options exposed in edit mode are listed below.

 Name

Description

Exit Edit Mode

This option will exit the editing mode and return to run-time mode.

Insert

Insert a new command row or variable replacement row above the current selected row depending on which tab is selected.

RemoveRemove the selected command row(s)or variable replacement row(s) depending on which tab is selected.
(Note that the entire row must be selected. Click the numbered cell to select an entire row.
Move UpMove the selected command row(s) or variable replacement row(s) up one position in the listing depending on which tab is selected.
(Note that the entire row must be selected. Click the numbered cell to select an entire row.)  
Move DownMove the selected command row(s) or variable replacement row(s) down up one position in the listing depending on which tab is selected.
(Note that the entire row must be selected. Click the numbered cell to select an entire row.

The Command Repeater widget also supports a right-click context menu that provides the same options.

(The View Toolbox option will show and hide the toolbar in the Command Repeater widget.)

Run-time Settings

The Command Repeater includes run-time configuration options to determine the repeater behavior.
Use the  Configure Repeater Settings option to access this dialog. 

Playback Mode
Continuous PlaybackIf this option is selected, the Command Repeater will iterate over the defined command listing and then continually start over and repeat the listing.
Fixed PlaybackIf this option is selected, the Command Repeater will iterate over the defined command listing once and then stop.
Cycle Function
On each cycle, send entire command listIf this option is selected, the Command Repeater will iterate over the defined command listing and transmit all the commands during each repeater cycle.
On each cycle, send next list entryIf this option is selected, the Command Repeater will iterate over the defined command listing and transmit only one command during each repeater cycle.
Reset Cycle IndexIf this option is selected, the Command Repeater will reset the repeat cycle index counter when the targeted number of repeat cycles have been reached.
Number of CyclesIf the Reset Cycle Index option is selected, then this field will be used to define the number of cycles at which to reset the repeat cycle index count.
Timing
Send next command on time intervalIf this option is selected, the Command Repeater will initiate the repeater cycle based on a user defined time interval.
Delay (ms)If the Send next command on time interval option is selected, then this field will define the number of milliseconds for the time cycle delay interval.
Send next command on data receivedIf this option is selected, the Command Repeater will initiate the repeater cycle only over having received a specific target data string.
Data RXIf the Send next command on data received option is selected, then this field will define the target received data string to watch for.
Number ofIf the Fixed Playback option is selected, then this field will be provided to define the number of repeat cycles the Command Repeater should invoke.
(Note that if the reset cycle index option is enabled, then it could affect the total number of cycles that will be repeated.)
Target Session
Send commands to active sessionIf this option is selected, the Command Repeater will transmit its data commands to only the selected/active terminal session.
Send commands to all sessionsIf this option is selected, the Command Repeater will transmit its data commands to all open and connected terminal sessions.

Variable Cycling

The Command Repeater can perform a simple mathematical equation on a variable expression on each repeater cycle.

The following fields for a replacement variable row defines the variable properties and mathematical equation properties.

NameDescription
EnabledThis option allows you to enable/disable specific variables.
VariableThis field defines the variable replacement name/token. To embed a variable in command data, please see Command Variable Replacement
StartThis field defines the seed value or initiating start value that the variable will be assigned when the Command Repeater cycle starts.
The variable value will always be rest to this start value when the Command Repeater is re-started.
OperatorThis field defines the math operation to perform on each repeater cycle. The Command Repeater can perform addition, subtraction, multiplication, and division.
CyclicThis field defines the operand value to use in the equation on each repeater cycle.
CurrentThis field displays the current value derived from the equation after each cycle.

The mathematical equation is applied to each variable on each repeater cycle .

Expression

CURRENT = START

FOR EACH CYCLE
{
  CURRENT = CURRENT [+|-|*|/] CYCLIC
}

Tip

You can pause the Command Repeater and modify a variable's current value, operator, cycle operand, etc. and resume the repeater cycle.

Tip

You can also use variables defined in the Variable Manager with commands listed in the Command Repeater.

Double-Click to Send

You can double-click a record in the commands tab of the Command Repeater widget and the command text will be transmitted to the connected device/host in the active terminal session.

Drag & Drop

The Command Repeater widget supports drag-and-drop.
You can select a command record in the command tab of the Command Repeater widget and drag the entry to the command bar to stage the command text.

Session Menu

You can select a block of text in the session data window and then use Add to Command Repeater option in the session menu to add the selection as a new command record in the Command Repeater widget.
(The new command record will only be added if it does not match an existing record.

Session Toolbar

You can enter command text into the command bar and then use session toolbar to add the selected text as a new command record in the Command Repeater widget.
(The new command record will only be added if it does not match an existing record.

Session Context Menu

You can select a block of text in the session data window and then use the right-click session context menu to add the selection as a new command record in the Command Repeater widget.
(The new command record will only be added if it does not match an existing record.

Labels
  • None