Home › Development › Using STWorkbench for STLinux

Overview

This explains how to boot the Linux kernel built in Building an STLinux kernel, using an ST Micro Connect.

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 Terminal view.

  1. Select Window > Show View > Other and select Terminal > Terminal. The Terminal view appears.

  2. Click the Connect button at the top-right of the view. The Terminal Settings dialog opens.

  3. Enter ttyS0 in the View Title field.

  4. Select Serial from the Connection Type dropdown.

  5. Fill in the serial port settings.

  6. Click OK. The terminal is opened.

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.