STLinux -- STi5528 Linux

Communication

Mailing lists

Documentation

User Manual

Support

Downloads

Search

STi5528 Linux
STMicroelectronics STi5528 Eval (mb376) and STi5528 Espresso

The information below assumes the reader to be familiar with the ST Linux product.

This Linux release for STi5528 (based on distribution 1.0_pl1) includes:

Support for both STi5528 boards, Eval (mb376) and Espresso
A single set of hardware configuration files, they support Linux requirements and matches the ST20 STAPI config. files
Serial system console
Ethernet connection via the SMC91c111 device (includes TCP/IP, telnet service and NFS File System)
Dynamic FLASH partitioning
HDDI-ATAPI Hard Disk
Dual Boot: it is intended the ability of having two CPUs running at the same time and, possibly cooperating. Different ways are provided:
- the two CPUs boots independently from MicroConnect
- Linux boots the ST20
- both CPUs boots from FLASH
RPC support
LIRC: Linux InfraRed Remote Control
KGDB: Linux kernel Debugger
USB support

Known Bugs

Hard Disk doesn`t work correctly in Ultra DMA mode.
The magic SysRq key support doesn`t work on the Espresso platform; this is supposed to be used to enter a Kernel Debug Session while the system is running (i.e. the command line argument "... kgdb=disabled ..." is used).

Installing and configuring

Hardware settings

See the following link for any information concerning the physical HW setting of both boards, Espresso and STi5528 Evaluation (MB376). The hardware setup described, assumes the ST40 to be the primary (booting) CPU and uses the ST20 as a co-processor.
It is very important to read the SMC91C111 section in order to setup the network interface.

Set of ST toolchains required

Please see your FAE or technical support contact for details of how to download these toolsets.

ST40 Micro Toolset Release
Install the proper ST40 Micro Toolset Releases, we recommend the Rel. 2.1.3 or 2.1.4.
The ST40 Micro Toolset is required because it contains:
- the sh4gdb tool, used by the download script st40load_gdb.
  Note: st40load_gdb version 0.4 or later is required, see below.
- the complete set of STi5528 hardware configuration files, used to setup the HW platform when downloading from MicroConnect.
  You must also download an updated version of these command files to substitute those provided by the toolset in:
  /opt/STM/ST40R2.1.x/sh-superh-elf/stdcmd/...
ST20 Micro Toolset Release
For dual processor development you also need to install the ST20 toolset. We recommend the use of ST20 Toolset 1.9.6 with Patch 7 (to download it click here).

Set of Linux packages required

The STi5528 Linux release is not yet provided in form of a single CD ISO image for an easy installation from scratch. Instead it is a set of updates to the current ST Linux distribution. So if you have not already installed the 1.0_pl1 distribution, this needs to be done first. Once you have installed the ST Linux Distribution Release 1.0 pl1, just upgrade it with the following set of packages (click the right button and save the target to download them):

Common to any STi5528 platform

stm-host-kernel-2.4.24_st1.7test7-13.noarch.rpm
stm-sh4-kernel-headers-2.4.24_st1.7test7-1.noarch.rpm
stm-host-sh-ipl+g-st1.3_test2-5.noarch.rpm
stm-cross-rpc_develop-2.1-0.i386.rpm
stm-host-stimage-0.2-0.i386.rpm
stm-sh4-stslave-0.3-0.sh4.rpm

st40load_gdb-v0.4.tar
Note: more recent versions of the ST40 Linux kernel for the STi5528 (st1.7test6 or later) place the kernel at a different address in memory to previous versions, and so st40load_gdb version 0.4 or later is required.

STi5528 Eval (mb376)

stm-cross-sh4-sh-ipl+g-st-sti5528eval-st1.3_test2-5.noarch.rpm
stm-sh4-sh-ipl+g-st-sti5528eval-st1.3_test2-5.sh4.rpm
stm-cross-sh4-lsp-st-sti5528eval-2.4.24_st1.7test7-2.noarch.rpm
stm-sh4-lsp-st-sti5528eval-2.4.24_st1.7test7-3.sh4.rpm

STi5528 Espresso

stm-cross-sh4-sh-ipl+g-st-espresso-st1.3_test2-5.noarch.rpm
stm-sh4-sh-ipl+g-st-espresso-st1.3_test2-5.sh4.rpm
stm-cross-sh4-lsp-st-espresso-2.4.24_st1.7test7-2.noarch.rpm
stm-sh4-lsp-st-espresso-2.4.24_st1.7test7-3.sh4.rpm

Configuring the serial System Console

The kernel messages as well as the root login prompt are directed to the system console, so depending on the board type the kernel command line must be properly set:

Board	Port	Kernel command line argument
Espresso	COM1 (ASC)	console=ttyAS0,115200
STi5528 Eval	SCIF0	console=ttySC0,115200

Connect a serial terminal or, use a serial connection with your PC host and run a terminal emulator on it (i.e. minicom on Linux). By default Linux kernel configures the other RS232 parameters at: 8bit, no parity, 1 stop bit

[Top]

USB support

By default the STi5528 kernel for both: Espresso and Evaluation board, distribuited via lsp packages, has the USB support already enabled.
Currently only the keyboard and mouse target devices are included.

As example, the following figures show how the USB has been configured using linux xconfig tool.

Fig. 4 USB support menu selection

USB support menu 1

Fig. 5 OHCI selection

USB support menu 2

Fig. 6 Mouse & keyboard selection

A good example of using such target devices via USB could be to configure the X environment using keyboard and mouse as input devices.
To do this:

download and install the appropriate (board dependent) Frame Buffer driver package.
Click on this link to download it.
run X ... and play