Layout Tool

Introduction

The Layout Tool is the official layout adjustment tool developed by Realtek for Ameba series SoC, used to adjust chip memory layout and configure link script files.

As shown below, the UI of Layout Tool contains two parts: the memory layout and the link configuration.

Environment Setup

Software Setup

• Environment requirements: EX. WinXP, Win 7 or later, Microsoft .NET Framework 4.0.

• Software location: <SDK>/tools/Ameba/LayoutTool/AmebaLayoutTool.exe

Open

Select SDK Path

The SDK select steps are illustrated below:

1. Click the Open button.

2. Click the Browse button to select the SDK path.

3. Click the OK button to confirm the selection.

Configure Memory

Edit

Configure Link

Link configuration is to adjust the location of code section. The adjustment steps are illustrated below:

1. Click the value of the Location column which needs to be edited.

2. Click the drop-down box to switch the location.

The memory layout will be changed accordingly when code section is moved.

Note

• Location value containing IMG2_XIP means Flash virtual address.

• In order to adjust the memory address conveniently, the memory layout shows Flash physical address.

Resize Memory Section

Memory layout contains PSARM, SRAM, and Flash. Every memory consists of several memory sections. The structure of memory section is illustrated below:

• Start address: value in red means can be adjusted.

• Size: in MB/KB/B.

• Memory section name: name of memory section.

• Code section: value in red means code section can be moved, Reserved means this section did not contain code section.

The steps of adjusting start address are:

1. Click the start address value.

2. Enter the required address in keyboard.

   Note

   • If not Dummy section, range of start address: pre-section start address (not contained) ~ current section end address (not contained).

   • If Dummy section, range of start address: pre-section start address (not contained) ~ current section end address (contained).

3. Press Enter to enable it, size will be changed accordingly.

Delete Section

There are two ways to delete a memory section:

• Use Delete button in tool strip

  1. Click the section, the border will turn red to indicate selected.

  2. Chick the Delete button.

  3. Click the OK button to confirm deletion.

• Use right mouse button

  1. Right-click on the section.

  2. Select Delete.

  3. Click the OK button to confirm deletion.

When memory section is deleted, its name turns Dummy, and its color changes to light blue. In the case its space can be allocated freely.

Preview

1. Click the Preview button to preview the link scripts.

2. Use Core combo-box to preview different core’s link script.

Save and Save As

Save

Click the Save button to save layout file and link script files.

Save As

1. Click the Save As button in menu bar.

2. Click the Browse button to edit the file name.

3. Click the OK button.

Note

Path of the layout file and link script file cannot be changed, which can only be allowed to be saved as another files.