Using STWorkbench with STLinux Booting the STLinux kernel

Overview

Make sure a kernel loader script is in the user's path. This script must be either st40load_gdb or st200load_gdb depending on the core type in use.

STWorkbench also supports booting remote kernimages over ethernet using the Das U-Boot bootloader.
For more information see u-boot.sourceforge.net and www.stlinux.com.

Opening a serial console

When booting the STLinux kernel, it is useful to view the system console through a serial port.

1. Connect a null modem cable between the first serial port on the target board (ttyAS0) and the first serial port on the host (ttyS0).

2. View the output with a terminal emulator.

STWorkbench can display serial port output in the Console view. If you have the Kermit terminal emulator this console can be read/write, allowing you to log in to the target and issue commands from within STWorkbench. Otherwise the console will be read only.

1. Select Run > Run. The Create, manage and run configurations dialog appears.

2. Select Serial Console and click New. A new launch configuration is created.

3. Enter ttyS0 in the Name field.

4. If you have Kermit on your path, select Read/write (requires kermit) in the Console type field.

5. Click Run. This serial console will remain open in the Console view until it is explicitly closed. It is not associated with any particular run of the kernel.

Booting the kernel

The specific values in the following steps are for an STb7100 Reference Board. Many of the boot settings and kernel parameters vary for different boards, and so must be substituted as appropriate.

1. Select Run > Run. The Create, manage and run configurations dialog appears.

2. Select ST Applications -> STLinux Kernel and click New. A new launch configuration is created.
   
   

3. In the Name field, enter Boot STb7100ref.

4. In the Project field, click Browse and select STb7100ref.

5. Click Search and select vmlinux.

6. Select Boot over JTAG if it is not already selected.

7. In the Board type field, confirm that the connect procedure is correct for your hardware.

8. In the ST Micro Connect field, enter the name or IP address of the HTI connected to the target board.

9. Select the Networking tab. In the Target IP address field, enter the IP address to be used by the target board.

10. In the Target hostname field, enter the hostname to be used by the target board.

11. Complete the Gateway IP address and Netmask fields, if required by your network topology.

12. The target board mounts its root filesystem over NFS. Ensure the root filesystem supplied with STLinux-2.3 at /opt/STM/STLinux-2.3/devkit/sh4/target is exported and can be read and written by the target board. For information on how to do this, see man exports.

13. Select the Root Filesystem tab. In the NFS server IP address field, enter the IP address of the NFS server.

14. Click Run. The Create, manage, and run configurations dialog closes and the kernel boots. The system console is displayed in the serial console opened earlier.

    If the kernel does not boot correctly, look at the system console messages for information on possible causes of the problem.