Everything
 

IOR panel


This panel displays the contents of I/O registers and changes their values (see Section"2.11.3 Displaying and changing the I/O registers").

Note that this panel can only be opened when CS+ is connected with the debug tool.

Caution

The I/O registers that get the microcontroller actuated by a read operation are protected against reads, so that no values are read from those registers ([Value] marked with "?").
To obtain the contents of the I/O registers protected against reads, select [Force Read Value] from the context menu.

Remark

By double-clicking a line delimiting each area on panel, it is possible to change the relevant area to the smallest displayable width without omitting the content in it.

Figure A.11

IOR Panel

 

This section describes the following.

[How to open]

-

Choose [IOR] from the [View] menu.

[Description of each area]

(1)

Search area

This area performs a search of I/O register names.

 

Specify the character string to be searched (not case-sensitive).

Enter a character string directly from the keyboard (specifiable in up to 512 characters) or select an input history item from the drop-down list (up to 10 history entries).

 

Searches for I/O register names that include the character string specified in the text box in upward direction, with the search result placed in selected state.

 

Searches for I/O register names that include the character string specified in the text box in downward direction, with the search result placed in selected state.

Remark 1.

The I/O register names that are hidden as classified by category (folder) also are searched (expanded and placed in selected state).

Remark 2.

After entering the character string to be searched, press the [Enter] key and the same option as would be when the button is clicked is performed, or press the [Shift] + [Enter] keys and the same operation as would be when the button is clicked is performed.

(2)

[IOR] area

This area displays I/O register names in list form as classified by type of I/O register as category (folder).

The meaning of each displayed icon is as follows.

 

 

Indicates that names of I/O registers in this category are currently displayed. Double-clicking this icon or clicking "-" will close the category and hide the names of corresponding I/O registers.

Note that categories are, by default, nonexistent. If necessary, create a new category and then Edit the tree.

 

Indicates that names of I/O registers in this category are currently hidden. Double-clicking this icon or clicking "+" will open the category and display the names of corresponding I/O registers.

Note that categories are, by default, nonexistent. If necessary, create a new category and then Edit the tree.

 

Displays I/O register names.

Remark

By clicking the header part of this area, it is possible to sort category names in order of character code. (The I/O register names in each category are sorted in the same way.)

 

This area has the following features.

(a)

Edit the tree

The tree form can be edited by classifying each I/O register by any category (folder).

To create a new category, move the caret to the I/O register name for which a category is to be created and click the button in the toolbar or select [Create Category] from the context menu. Then enter any category name (specifiable in up to 1,024 characters).

To remove a category, select the category to be removed and click the button in the toolbar or select [Remove] from the context menu. Note, however, that only blank categories can be removed.

Also, to edit a category name, select the category name to edit and follow one of the following procedures:

-

Click the category name again and edit it directly from the keyboard

-

Choose [Change Name] from the [Edit] menu and then edit the category name directly from the keyboard

-

Press the [F2] key and then edit the category name directly from the keyboard

 

When a category is created, drag-and-drop I/O register names directly into the category. That way, I/O register names can be displayed in tree form classified by category.

Similarly, the order in which categories or I/O register names are displayed (one above or below another) can be freely changed by a drag-and-drop operation.

To clear and restore an edited category, click on the button on the toolbar or select [Clear customization] from the context menu.

Caution 1.

A category cannot be created within another category.

Caution 2.

I/O registers cannot be added or removed.

(b)

Registration of watch-expressions

I/O registers or categories can be registered as watch-expressions on the Watch panel.

For details on how to do it, see "2.11.6.1 Registering watch-expressions".

Remark 1.

If a watch-expression is registered for a category, all of the I/O registers belonging to that category are registered as watch-expressions.

Remark 2.

The registered watch-expressions have their scope specification automatically given.

(c)

Zoom in or out on a view

To zoom in and out of the IOR panel view, change the zoom ratio by using the drop-down list on the toolbar of the Main window while the focus is placed in the IOR panel.

You can also change the zoom ratio by using the [Ctrl] key + mouse-wheel combination.

-

Using the [Ctrl] key + mouse-wheel forward will zoom into the view, making the contents larger and easier to see (max. 300%).

-

Using the [Ctrl] key + mouse-wheel backward will zoom out of the view, making the contents smaller (min. 50%).

 

If the panel is closed after the zoom ratio is changed, the changed zoom ratio is retained (next time, the panel will open at the changed zoom ratio).

(3)

[Value] area

This area displays or changes I/O register values.

The notation (numeral representation) in which values are displayed can be selected using the appropriate toolbar button or selecting from the context menu. Also, it is possible to select a display form that always adds hexadecimal equivalents to the ordinary display.

The meaning of marks displayed as I/O register values and their colors are as follows (The colors in which text and backgrounds are displayed depend on how the [General - Font and Color] category of the Option dialog box is set.).

Example display (default)

Description

 

Text color

Blue

The value of the I/O register that the user is changing (press the [Enter] key to write to the target memory).

Background color

Standard color

 

Text color

Sienna

The value of the I/O register that has been changed because of the execution of a program

To reset the highlighting, select the button on the toolbar or [Reset Color] from the context menu.

Background color

LightYellow

?

Text color

Gray

Values of I/O registers protected against read Note

Background color

Standard color

Note

This refers to the I/O registers that get the microcontroller actuated by a read operation.
To read the value of read-protected I/O register, select [Force Read Value] from the context menu.

Caution

The 1-byte or 2-byte I/O registers and the 1-bit I/O registers mapped to those 1-byte or 2-byte I/O registers differ in timing with which values are retrieved. Therefore, while a value from the same I/O register is being displayed, it is possible that the displayed value is different.

Remark

The values are sorted in ascending order of numeric value by clicking the header part of this area.

 

This area has the following features.

(a)

Alteration of I/O register values

When changing I/O register values, select the target I/O register value and then click it again to edit it directly from the keyboard. (Pressing the [Esc] key cancels the edit mode.)

After editing an I/O register value, hit the [Enter] key or move the focus to other than the edit area. The edited value is written into the debug tool's target memory.

For details on how to edit I/O register values, see "2.11.3.4 Changing the contents of I/O registers".

(b)

Saving of I/O register values

Choosing [Save IOR Data As ...] from the [File] menu opens the Save As dialog box, making it possible to save all content of this panel to a text file (*.txt) or CSV file (*.csv).

For details on how to save I/O register values, see "2.11.3.6 Saving the displayed I/O register contents".

(4)

[Type (Byte Size)] area

This area displays the type information of each I/O register in the form shown below.

-

<Type of I/O register> [<Access attribute> <All accessible sizes>](<Size>)

Access attribute

One of the following is displayed as access attribute.

R

Read only

W

Write only

R/W

Read/Write

All accessible sizes

Accessible sizes, in bit units, are enumerated in increasing order by separating each with a comma ",".

Size

Shows the size of each I/O register.

If displayable in byte units, the size is shown in bytes, if displayable in bit units, the size is shown in bits, with the respective units given.

Example 1.

For the "IOR [R/W 1.8] (1 byte)" case
This refers to an I/O register that is read/writable, accessible in 1 bit and 8 bits, and 1 byte in size.

Example 2.

For the "IOR [R/W 1] (1 bit)" case
This refers to an I/O register that is read/writable, accessible in 1 bit, and 1 bit in size.

Remark

The type information is sorted in order of character code by clicking the header part of this area.

(5)

[Address] area

This area displays the addresses to which the I/O registers are mapped (always shown in hexadecimal).

However, the bit registers displayed here are given bit offset values, as shown in the examples below.

Example 1.

For the "0xFF40" case
This register is mapped to "0xFF40".

Example 2.

For the "0xFF40.4" case
This is a bit register mapped to bit 4 of the address "0xFF40".

Remark

The addresses are sorted in ascending order of numeric value by clicking the header part of this area.

[Toolbar]

 

Obtains latest information from the debug tool and updates the display.

No data are reloaded for the I/O registers protected against read.

However, this button is disabled during program execution.

 

Resets the highlighting for a selected I/O register, which indicates that its value has changed as a result of program execution.

However, this button is disabled during program execution.

 

Adds a new category (folder). Enter a category name directly in the text box.

While you can create any number of new categories, note that a category cannot be created within another category.

However, this button is disabled during program execution.

 

Clears the user customization (creation of categories, changing orders, and changing notation).

 

 

Deletes a selected range of character string.

If a blank category is in selected state, the category is deleted (I/O registers cannot be deleted.).

Notation

Shows the following buttons that change the form in which values are displayed.

 

Hexadecimal

Displays the value of a selected item in hexadecimal (default).

Signed Decimal

Displays the value of a selected item in signed decimal.

Unsigned Decimal

Displays the value of a selected item in unsigned decimal.

Octal

Displays the value of a selected item in octal.

Binary

Displays the value of a selected item in binary.

ASCII

Displays the value of a selected item in ASCII code.

 

Adds a hexadecimal equivalent for the displayed value of a selected item at the end of it, with the equivalent enclosed in parentheses ( ).

[[File] menu (IOR Panel-Only Items)]

The [File] menu used exclusively for the IOR panel is as follows (The other items are shared.).

However, all of these items are disabled during program execution.

Save IOR Data

Saves the content of this panel to a text file (*.txt) or CSV file (*.csv) that has been saved previously (see "(b) Saving of I/O register values").

If this item is selected for the first time after startup, the same operation as [Save IOR Data As …] would have been selected is performed.

Save IOR Data As...

Opens the Save As dialog box in order to save the content of this panel to a specified text file (*.txt) or CSV file (*.csv) (see "(b) Saving of I/O register values").

[[Edit] menu (IOR Panel-Only Items)]

The [Edit] menu used exclusively for the IOR panel is as follows (All other items are disabled.).

Cut

Cuts a selected range of character string and moves it to the clipboard (No I/O registers and categories can be cut.).

Copy

Copies a selected range of character string to the clipboard.

If an I/O register or category is in selected state, that item is copied.

Note that the copied item can be pasted to the Watch panel.

Paste

Pastes the content of the clipboard to the caret position when text is in editing mode (I/O registers and categories cannot be pasted.).

Delete

Deletes a selected range of character string.

If a blank category is in selected state, that item is deleted (No I/O registers can be deleted.).

Select All

Selects all character strings whose text is in edit mode.

If the text is in other than edit mode, all I/O registers and categories are placed in selected state.

Rename

Edits the name of a selected category.

Find...

Moves the focus to the text box in the search area.

Go To...

Opens the Go to the Location dialog box to move the caret to a specified I/O register.

[Context Menu]

Register to Watch1

Registers the selected I/O register or category to the Watch panel (Watch1).

Refresh

Obtains latest information from the debug tool and updates the display.

No data are reloaded for the I/O registers protected against read.

However, this button is disabled during program execution.

Force Read Value

Forcibly loads a value once for I/O registers protected against read.

Go To...

Opens the Go to the Location dialog box.

Create Category

Adds a new category (folder). Enter a category name directly into the text box.

While you can create any number of new categories, note that a category cannot be created within another category.

However, this button is disabled during program execution.

Clear customization

Clears the user customization (creation of categories, changing orders, and changing notation).

Copy

Copies a selected range of character string to the clipboard.

If an I/O register or category is in selected state, that item is copied.

Note that the copied item can be pasted to the Watch panel.

Delete

Deletes a selected range of character string.

If a blank category is in selected state, that item is deleted (No I/O registers can be deleted.).

Notation

Shows the following cascaded menu to specify the form in which values are displayed.

 

Hexadecimal

Displays the value of the selected item in hexadecimal (default).

Signed Decimal

Displays the value of the selected item in signed decimal.

Unsigned Decimal

Displays the value of the selected item in unsigned decimal.

Octal

Displays the value of the selected item in octal.

Binary

Displays the value of the selected item in binary.

ASCII

Displays the value of the selected item in ASCII code.

Include Hexadecimal Value

Adds a hexadecimal equivalent for the displayed value of a selected item at the end of it, with the equivalent enclosed in parentheses ( ).

Reset Color

Resets the highlighting for a selected I/O register, which indicates that its value has changed as a result of program execution.