UnderAutomation
⌘Q
Cette page est disponible uniquement en anglais.

Data and I/O panels

The Data panel and the I/O panel of a Fanuc or Yaskawa controller: open them from the tree, choose the kind and the page of 50, edit several cells, then write them with one confirmation. Pending changes, Revert, the Pro edition, the cells that are read-only, Add to Watch, and Simulate and Unsimulate of a Fanuc signal.

This page explains the Data panel and the I/O panel of a controller: a table of registers or signals that you read, edit and write back. It applies to Fanuc and Yaskawa controllers. Reading is free. Writing needs the Pro edition, see Editions and license.

What the panels are

Each controller has a Data panel and an I/O panel. Both open as a tab of the editor, with a table of 50 rows of one kind. The I/O panel of a Yaskawa controller is different: it is the table of the manuals, see The I/O panel of a Yaskawa controller. A row has a reference, a value, a comment (or a name on Yaskawa) and an Add to Watch button.

The panels replace the Registers, Variables, I/O and Tasks views of the side bar, which are gone: the side bar keeps Controllers, Watch, Toolbox, Backups and Account. See Read live values. The panels edit many values at once, with one confirmation.

Open a panel

Open the nodes of the controller in the Controllers view:

BrandData panelI/O panel
FanucData > Registers, Position Registers, String Registers, KAREL Vars, KAREL PositionsI/O
YaskawaData > Byte, Integer, Double, Real, String, Position, Base Position, External PositionI/O

Data > Variable Map opens the Variable Map, see Navigate across a robot. The Fanuc node Variables opens the Variables panel, see Read live values.

A panel is named after the node and the controller, for example Data: Cell 3 Fanuc.

The Data panel of a Fanuc controller: the numeric registers R[1] to R[50].

Choose what to show

ControlWhat it does
KindThe list of kinds of the panel, for example R · Numeric registers on Fanuc or DI · Digital inputs in the I/O panel
Previous 50, Next 50Show the 50 values before or after the current page

The I/O panel of a Yaskawa controller has its own controls, see below.

The values are read again every second while the panel is visible. When you hide the tab, TouchUp stops reading. A register that the controller does not have shows is not in the scenario in orange, with no value.

Edit values

You can change several values, check them, then write them in one step. Nothing is sent to the controller until you click the write button.

  1. Click a cell and type the new value.
  2. Press Enter, or click another cell. The new value is kept as a pending change.
  3. Repeat for the other cells.
  4. Click Write N changed values.

N is the number of changed cells. A value and a comment of the same row count as two.

Two pending changes: the value and the comment of R[1]. Each edited cell has a blue bar and a small Revert button that shows the value read from the controller.

An edited cell has a blue bar on its left. Beside it, a small Revert button shows the value read from the controller, for example ↶ 7. The columns and the rows keep their size when you edit.

ActionWhat it does
Escape while you typePuts the cell back, nothing is kept
Revert (the small button of the cell)Drops the pending change of one cell and brings back the value read
Revert AllDrops every pending change of the panel

Write the changes

Write N changed values sends only the changed values. TouchUp asks one confirmation for the whole panel. It lists each value with its old and new value. After Confirm:

  • TouchUp reads each value again and shows the value that the controller holds.
  • Each register or signal has its own record in the audit log.
  • For a Yaskawa name, TouchUp first saves a copy of the name file of the controller. See Names.
  • A value that the controller refuses stays pending. Its row shows Not written under the reference, and the reason is the tooltip of that text. The other values are still written.

Fix the cause of a refused value, then click the write button again. A pending change that you make while the confirmation is open is not sent. It stays pending.

The pending changes are kept in the panel only. When you close it, they are lost.

Free and Pro

A Free user can read and edit the cells. Write N changed values opens the Pro dialog and sends nothing. The pending changes stay in the panel.

Cells that cannot be edited

A read-only cell has no field. It shows a few words that say why, for example Simulate it to edit or Set by its device. Point at the words to read the full sentence in a tooltip.

CellWhy
A KAREL position of a Fanuc controllerIt is shown, not edited, in the panel
A position register or a Yaskawa position (P, BP, EX)A position has several values. Click Open to edit it in the Position Editor, where a Fanuc position register can also change its form
The name of a Yaskawa register (M000 to M999) or of a signal that has no user nameThese have no name on the controller. See Names
A Yaskawa signal that is not a network inputSee The I/O panel of a Yaskawa controller. The words beside the value say who sets it, for example Set by its device
The value of a Fanuc inputAn input is set by its device. It takes a value once it is simulated

When nothing can be written now, the panel says it once, in one line above the table: the controller is not connected, or it or its connection does not allow a write. The cells then show their values with no repeated reason. Point at a cell to read the line again in a tooltip.

Add to Watch

The Add to Watch button of a row adds that register or signal to the Watch view, for this controller. See Read live values.

The I/O panel

The I/O panel shows signals of one kind: DI, DO, RI, RO, GI, GO, AI, AO, UI, UO, SI, SO and flags on Fanuc, and the table of the manuals on Yaskawa. The comment of a Fanuc signal can be edited like a value.

The I/O panel of a Fanuc controller: the digital inputs, one of them simulated.

Simulate a Fanuc signal

The Simulation column shows the state of each signal and two buttons.

ButtonWhat it does
SimulateSimulates the signal. Its value can then be edited
UnsimulatePuts the signal back under the control of its device

Simulate and Unsimulate are actions, not pending changes. Each one asks its own confirmation and runs at once. They do not count in Write N changed values.

  • The state is Simulated, or Unknown when TouchUp does not know it. A real Fanuc controller shows Unknown until its SDK reports the state.
  • An input takes a value only while it is simulated. Until then, its cell says Simulate it to edit.
  • The signals F, UI, UO, SI and SO cannot be simulated (the controller gives a flag no simulation status). Their buttons are disabled.

The I/O panel of a Yaskawa controller

The I/O panel of a Yaskawa controller is the table of the I/O manuals: every relay number, with its logical name, its name, the name that you gave to it on the controller and its classification. After the relays, it lists the registers M000 to M999. It has no simulation. It replaces the four kinds IN#, OT#, IG# and OG# of the previous version.

Filter, search and sort

ControlWhat it does
ClassificationKeeps one classification of the manuals, for example General purpose input, Network input, Specific input, Auxiliary relay or Control status. All shows everything
LayerKeeps one layer: Logic I/O, Physical I/O, Internal or Hard signal monitor
SearchLooks for a relay number (80173), a register (M010), a logical name (SIN#001 or SIN#(1), IN#(9)) or a part of a name of the I/O signal catalog. On a connected controller it does not look in the user names, see Names
SortAddress, or Type, then address
Previous, NextShow the previous or next 6 channels. The range, for example Channels 1 to 6 of 120, is beside them

Channels and signals

The table has one line per channel: a channel is the group of 8 signals of one byte, for example channel 4001 holds the relays 40010 to 40017. The line gives the classification, the layer and the state of the 8 bits, for example 0:1 1:0 2:0 ....

Click Channel <number> to open the line. It shows one row per signal:

ColumnWhat it shows
SignalThe relay number, for example 40010
LogicalThe logical name, for example SIN#001
Name in the catalogThe name of the signal in the I/O signal catalog of TouchUp, its use, and the names it has in other applications or controller generations when they differ
User nameThe name that you gave to the signal on the controller, see Names
ClassificationThe classification of the manuals
ValueThe value read from the controller
ActionsAdd to Watch

A search opens every channel that it lists, and marks the signals that it found. Without a search, the channels are closed.

The I/O panel of a Yaskawa controller: a search opens the channels it lists, each signal with its logical name, its name and its classification.

Registers

The registers M000 to M999 come after the relays, in lines of 8 registers: Registers M000, Registers M008, and so on. The line shows the 8 values, and opens like a channel to one row per register. A register is a whole number of 16 bits, from -32768 to 32767. It has no relay number, no logical name and no name in the catalog. The classification tells its kind: general purpose, analog output, analog input or system register. Search M010 to open the line of that register.

A search on M010 opens the line of the registers M008 to M015.

Values and writes

TouchUp reads the 6 channels of the page, as long as the panel is visible. When the controller is not connected, the table lists the signals with their names and their classification, without a value.

  • A network input (relays 27010 to 29567) and a general purpose register (M000 to M559) are edited like any other value: the edit becomes a pending change, and Write N changed values writes it after the usual confirmation. A register takes a whole number from -32768 to 32767. See Edit values and Write values and control a program.
  • Every other signal is read-only: the analog output registers (M560 to M599), the analog input registers (M600 to M639), the system registers (M640 to M999) and every relay that is not a network input. The words beside its value say who sets it, and the tooltip gives the full reason.

Names

The column Name in the catalog gives the names of the I/O signal catalog. It is read-only.

The column User name gives the names that you gave to the general purpose signals on the controller (IN#(n) and OT#(n)). The user names come from IONAME.DAT of the controller. You can edit them here. The registers and the other signals (network, external, specific) have no user name: their cell is read-only, with the reason beside it.

The channel of the relay 00010: the column User name gives the names of the controller, in a field that you can edit.
  • On a connected controller, TouchUp reads IONAME.DAT once, when it connects. A name that you change on the pendant shows after a new connection. When the controller refuses the file, the column stays empty and the panel shows no error.
  • On a connected controller, the search does not look in the user names. Search the relay or the logical name, then read the name in the column.
  • In the panel of a backup, the search looks in the user names too, see Open the I/O panel of a backup.
  • The names of the external signals (EXIONAME.DAT) are not shown.

Edit a name

The name of a Yaskawa variable (B, I, D, R, S, P, BP, EX, column Name of the Data panel) and the user name of a general purpose signal (column User name of the I/O panel) are edited like a value, see Edit values.

  1. Click the name, type the new one and press Enter. The name becomes a pending change, and a small Revert button beside it shows the name read from the controller.
  2. Click Write N changed values and Confirm. A name and a value are written in the same step.
The name of the relay 00010 changed to PART IN PLACE: a pending change, with a small Revert button that shows the name read from the controller, and the button Write 1 changed value.

A name follows the rules of the controller files:

  • 16 characters at most, printable ASCII only: letters, digits, spaces and signs.
  • No comma, because it separates the names in IONAME.DAT.
  • It does not start with /, which marks a section title of the file.
  • An empty name clears the name.

A name that breaks a rule is refused with its reason, and nothing is sent to the controller.

Before it writes, TouchUp saves a copy of the name file that it will replace: VARNAME.DAT for a variable, IONAME.DAT for a signal. The audit record of the write points to that copy, see Write values and control a program. The write replaces the whole file: a name that someone changes on the pendant between the moment you click Confirm and the end of the write is lost.

The write needs the Pro edition, like a value, see Free and Pro. When the controller or its connection does not offer the way to write names, TouchUp refuses the name and says that the function is not available, with the reason. The position value of a P, BP or EX variable stays read-only, only its name can be edited.

From a backup

The same table opens from a backup, without a controller. See Open the I/O panel of a backup.

What to read next

  • Read live values
  • Write values and control a program
  • Edit a position
  • Open controller files
  • Back up a controller
  • Editions and license