winIDEA Help

In this topic:

•Preprocessor

•Item Types

•Write Item

•Modify Item

•Pause Item

•Reset Item

•Instruction Item

•Poll Item

•Copy Item

 

 

Introduction

Initialization files (INI files) in winIDEA are plain text files used to script simple memory read/write operations, basic core instruction execution.

 

They are mostly used for:

•Memory initialization

•Simple peripheral initialization

•Additional operations/actions that can be executed at predefined debug session operation (e.g.: after reset, before starting trace session, etc…)

 

INI files can be part of winiDEA distribution (e.g.: next to EVE scripts and SFR files, part of winIDEA Example Workspaces) or can be user created files. They are mainly defined in Hardware | CPU Options | Reset.

 

An initialization item is defined in a single line.  The syntax is case-insensitive, which means that, for example, either #define or #DEFINE is considered the same.

 

No arithmetic is supported. These expressions are illegal:

 

 

Preprocessor

C-like pre-processor is used.

 

Aliases

 

Example:

 

 

Comments

Multiline comments

Standard C /*  */ multi-line comments are supported.

Example:

 

End of line comments

Double forward-slash characters are interpreted as end of line comments.

Example:

 

 

Tokens with Spaces

If a token contains a space, it must be enclosed in double quotes.

Example:

 

 

Item Types

Memory Area specifies the name of the CPU’s Memory Space where the write is performed.  The string specifying the area is CPU architecture specific. This parameter is optional. If omitted, the default SFR memory space is used.

 

 

 

Write Item

Write item causes a target location to be written.

Detailed description with an example:

 A        memory location, absolute addresses

 R        core register

 

Memory area specifies the name of the CPU’s memory space where the write is performed. The string specifying the area is CPU specific. For applicable values see Memory Spaces chapter. This parameter is optional. If omitted, the default SFR memory space is used.

 

 B        8-bit width

 W        16-bit width

 L        32-bit width

 

Number of repeats is an optional parameter used for block writes, which specifies the number of times the data is written.

 

Examples:

 

Modify Item

Reads the memory location specified by the <address> and <size>, modifies the bits specified by <mask> to a <data> value and writes the modified value back to the same memory location.

Detailed description with an example:

 

Where:

 

Memory area specifies the name of the CPU’s memory space where the write is performed.  The string specifying the area is CPU specific. For applicable values see Memory Spaces chapter. This parameter is optional. If omitted, the default SFR memory space is used.

 

 

Example modifies the last 2 bits of the 32-bit value at 0x200080C4 to b’10’.

 

Pause Item

Introduces a delay.

Detailed description with an example:

 

Example inserts a delay of 100ms:

 

 

Reset Item

Resets the CPU.

 

Instruction Item

Executes a CPU instruction. No inline assembler is supported – the op-code must be specified in HEX format.

Detailed description with an example:

 

Example:

Executes the 7C0007A4 opcode.

 

Poll Item

Polls a memory location until a specified bit is set.

Detailed description with an example:

 C        memory location, address offset is used

 D        memory location, absolute addresses

 

See Write Item.

 

See Write Item.

 

See Write Item.

 

See Write Item.

 

Same format as <data>. winIDEA will repeat memory reads while:

Time in milliseconds to wait for completion.

 

Example:

reads 16 bit words from address E01FC084 for 500 ms, or until the read value is 0x200F

 

 

Copy Item

Reads value from some address and writes it to some other address.

Detailed description with an example:

 

See Write Item.

 

See Write Item <address>.