Following is the rules for input to each panel/dialog box.
Character sets that are allowed to input are as follows:
Table 2.24 | List of Character Set |
|
|
ASCII
|
1- byte alphabets, numbers, symbols
|
Shift-JIS
|
2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji and 1-byte Katakana.
|
EUC-JP
|
2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji and 1-byte Katakana.
|
UTF-8
|
2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji (include Chinese characters) and 1-byte Katakana.
|
UTF-16 Big-Endian
|
2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji (include Chinese characters) and 1-byte Katakana.
|
UTF-16 Little-Endian
|
2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji (include Chinese characters) and 1-byte Katakana.
|
UTF-32 Big-Endian
|
2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji (include Chinese characters) and 1-byte Katakana.
|
UTF-32 Little-Endian
|
2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji (include Chinese characters) and 1-byte Katakana.
|
Escape sequences that are allowed to input are as follows:
Table 2.25 | Escape Sequence List |
|
|
|
\0
|
0x00
|
null character
|
\a
|
0x07
|
Alert
|
\b
|
0x08
|
Backspace
|
\t
|
0x09
|
Horizontal tab
|
\n
|
0x0A
|
New line
|
\v
|
0x0B
|
Vertical tab
|
\f
|
0x0C
|
Form feed
|
\r
|
0x0D
|
Carriage return
|
\"
|
0x22
|
Double-quotation mark
|
\'
|
0x27
|
Single-quotation mark
|
\?
|
0x3F
|
Question mark handled as a question mark if ? is entered.
|
\\
|
0x5C
|
Backslash
|
Notations allowed when entering numbers are as follows:
|
|
Binary number
|
Start with 0b and continues with the numbers from 0 to 1.
(Case insensitive for alphabets)
|
Octal number
|
Start with 0 and continues with the numbers from 0 to 7.
|
Decimal
|
Start without 0 and continues with the numbers from 0 to 9.
|
Hexadecimal number
|
Start with 0x and continues with the numbers from 0 to 9 and alphabets a to f.
(Case insensitive for alphabets)
In the input area with the
mark, prefix 0x is not needed.
|
(4) | Expression and operator |
Expression represents constants, register name, SFR name and symbols and those connected with operators.
An expression comes in two types: an address expression and a watch-expression. The expression that requires the address of a symbol is referred to as an address expression, and the one that requires the value of a symbol is referred to as a watch-expression.
(a) | An address expression and operators |
With an address expression, the address of a symbol is used to perform operations. Only when a CPU register name is written, the value of the symbol is used to perform operations.
The basic input formats of address expressions are as follows:
Table 2.27 | Basic Input Format of Address Expressions |
|
|
Name of a C/C++ language variableNote 1,2
|
Address of a C/C++ language variable
|
Expression [ExpressionNote 3]
|
Address of an array
|
Expression.Member nameNote 4
|
Address of a structure/union/class member
|
Expression->Member nameNote 4
|
Address of a structure/union/class member that is pointed to
|
Watch-expression.*Cast expression
|
Address of the pointer to a member variable
|
Watch-expression->*Cast expression
|
Address of the pointer to a member variable
|
Name of a CPU register
|
Value of the CPU register
|
Name of a SFR
|
Address of the SFR
|
Label nameNote 5, EQU symbol nameNote 5 and [immediate value]
|
Address of a label, a value of an EQU symbol, and an immediate address
|
Integer constant
|
Address
|
Note 1. | It represents C language (C89/C99) and C++ language variables. |
Note 2. | If the register is assigned the value of a C variable, an error results. |
Note 3. | The expression that is input as an index to an array is parsed as a watch-expression. |
Note 4. | To specify a member variable of base class, specify scope before a member name. |
(Example: variable.BaseClass::member)
Note 5. | If the label name or EQU symbol name includes a "$", be sure to enclose the name in "{ }" (e.g. {$Label}).
When you specify the CPU register name "I", add ":REG" (e.g. I:REG) to distinguish it from the keyword "I" that indicates an imaginary number. |
From "2.20.2 Symbol name completion function", the following expressions with operator can be constructed.
Table 2.28 | Construction of Expressions with Operators |
|
|
(Expression)
|
Value of the parenthetical watch-expression
|
! Expression
|
Inverts symbol
|
- Expression
|
Logical negation
|
~ Expression
|
Bit inversion
|
Expression * ExpressionNote
|
Multiplication
|
Expression / ExpressionNote
|
Division
|
Expression % ExpressionNote
|
Remainder calculation
|
Expression + ExpressionNote
|
Addition
|
Expression . ExpressionNote
|
Subtraction
|
Expression & ExpressionNote
|
Logical multiplication by bits
|
Expression ^ ExpressionNote
|
Exclusive disjunction by bits
|
Expression | ExpressionNote
|
Logical sum by bits
|
Note | Variables and functions can be combined by an operator only with variables, functions and integer constants.
Example: C variable name + SFR name |
(b) | Watch-expression and operator |
With watch-expression, the value of a symbol is used to perform operations. Only when the value does not exist, the address of the symbol is used to perform operations (e.g. main( ) + 1).
The basic input formats of watch-expressions are as follows:
Table 2.29 | Basic Input Format of Watch-expressions |
|
|
Name of a C/C++ language variableNote 1
|
Address of a C/C++ language variable
|
Expression [Expression]
|
Element of an array
|
Expression.Member nameNote 2
|
Value of a structure/union/class member
|
Expression->Member nameNote 2
|
Value of a structure/union/class member that is pointed to
|
Watch-expression.*Cast expression
|
Value of a pointer to member variable
|
Watch-expression->*Cast expression
|
Value of a pointer to member variable
|
*Expression
|
Value of pointer variable
|
&Expression
|
Location address
|
Name of a CPU register
|
Value of the CPU register
|
Name of a SFR
|
Value of the SFR
|
Label nameNote 2, EQU symbol nameNote 3 and [immediate value]
|
Values of a label, a value of an EQU symbol, and an immediate address
|
Integer constant
|
Integer constant value
|
Floating constant
|
Floating point constant value
|
Character constant
|
Character constant value
|
Note 1. | It represents C language (C89/C99) and C++ language variables. |
Note 2. | To specify a member variable of base class, specify scope before a member name. |
(Example: variable.BaseClass::member)
Note 3. | If the label name or EQU symbol name includes a "$", be sure to enclose the name in "{ }" (e.g. {$Label}).
Any imaginary number must be multiplied by an uppercase "I" (e.g. 1.0 + 2.0*I). When you specify the CPU register name "I", add ":REG" (e.g. I:REG) to distinguish it from the keyword "I" that indicates an imaginary number. |
From "Table 2.29 Basic Input Format of Watch-expressions", the following watch-expressions with operator can be constructed. For the operators listed in the table below, the expression is parsed according to C language specifications.
Table 2.30 | Construction of Expressions with Operators |
|
|
(Expression)
|
Specifies the order in which operations are performed
|
! Expression
|
Inverts symbol
|
- Expression
|
Logical negation
|
Expression * ExpressionNote
|
Multiplication
|
Expression / ExpressionNote
|
Division
|
Expression % ExpressionNote
|
Remainder calculation
|
Expression + ExpressionNote
|
Addition
|
Expression . ExpressionNote
|
Subtraction
|
Expression & ExpressionNote
|
Logical multiplication by bits
|
Expression ^ ExpressionNote
|
Exclusive disjunction by bits
|
Expression | ExpressionNote
|
Logical sum by bits
|
Note | Variables and functions can be combined by an operator only with variables, functions and integer constants.
Example: C variable name + SFR name |
Caution 1. | When two or more variables are defined with the same name in unnamed name spaces of different source files, the Watch panel only shows the information on the first variable to be found. |
Caution 2. | After the member-variable pointer "mp1" defined in the program below is registered with the Watch panel and Local Variables panel, the type of the pointer is indicated as "int *", not "int Foo::*". |
class Foo {
int m1;
};
int Foo::*mp1 = &Foo::m1;
|
Caution 3. | When a char-type one-dimensional array is assigned to multiple locations in registers or memory as shown below, no character string will be displayed in the value column of the Watch panel or Local Variables panel even after the array "array" has been registered with the panel.
char array[5] = "ABCD"; |
Caution 4. | When the selection for [Scope] in the Local Variables panel is not [Current], the values of variables assigned to registers are not displayed correctly. Editing these values is also not possible. |
Caution 5. | When a defined variable satisfies both of the conditions given below, the Watch panel and Local Variables panel indicate the location of the entire variable rather than the location of its member variables. |
[Conditions]
<1> | The variable is assigned to two or more addresses or registers (i.e. two or more addresses or registers are displayed in the address column). |
<2> | A structure-, class-, array-, or union-type member is defined in the variable. |
[Example]
struct Mem {
long m_base;
};
struct Sample {
long m_a;
struct Mem m_b; <- Condition <2>
};
main () {
struct Sample obj;
}
|
Display in the Watch and Local Variables panels:
"obj" - { R1:REG, R2:REG } (struct Sample)
L m_a 0x00000000 { R1:REG } (long)
L m_b - { R1:REG, R2:REG } (struct Base)
L m_base 0x00000000 { R2:REG } (long)
|
Caution 6. | When a variable is cast to another type in the Watch panel, casting of the variable is C-style.
For this reason, the result of casting a class using virtual inheritance to its base class is not the same as the result of the cast within the program. |
class AAA [
int m_aaa;
} objA;
class BBB : public AAA { //BBB inherits AAA.
int m_bbb;
} objB;
class CCC { //CCC does not inherit AAA.
int m_ccc;
} objC
class DDD { //DDD virtually inherits AAA.
public:
int m_ddd;
} objD
class AAA* pa = objA;
class BBB* pb = objB;
class CCC* pc = objC;
class DDD* pd = objD;
"(AAA*)pa" Usable
"(BBB*)pb" Usable
"(AAA*)pb" Usable
"(CCC*)pc" Usable
"(AAA*)pc" Not usable because pc is considered to point to the top address of AAA.
Image of the cast in a program: (AAA*)((void*)pc)
"(AAA*)pd" Not usable because pd is considered to point to the top address of AAA.
Image of the cast in a program: (AAA*)((void*)pd)
|
Caution 7. | In case of a variable with the size beyond 0x10000, Value, Style and Address indicate "?" in the Watch panel. |