[STLinux-announce] Update to the ST40R3.0.3 stdcmd GDB command scripts for Linux platforms

[stlinux-announce at stlinux.com]

Hi,

	An updated set of stdcmd GDB scripts for the ST40 R3.0.3 toolchain
which is used to download and boot kernels from the ST40 Linux 2.0
distribution is now available. This update is primarily concerned with
providing better support for the new silicon cuts of the STb710x silicon
on the STb7100 Reference (coco) and STb7100 MBoard (mb411) boards. For
further information on the names of the new GDB connect commands see the
appropriate web site (depending on your board type):

	http://www.stlinux.com/boards/stb7100ref/index.php
or	http://www.stlinux.com/boards/mb411/index.php

	The new stdcmd tarball may be downloaded from:

	ftp://ftp.stlinux.com/pub/tools/stm-st40.303-3.0.3-stdcmd-updates-20060126.tar.gz

	Please read the README file, which is also included in this E-mail.

	If you have any problems with the updates, please submit a bug
using the bugzilla bug tracking system, which may be found in:

	https://bugzilla.stlinux.com/

	Regards,
		Sean


	------------------- README ---------------------

STLinux 2.0 stdcmd updates for ST40 R3.0.3 embedded toolset
===========================================================

These configuration files are updates for the ST40 R3.0.3 embedded
toolset (a.k.a. the bare-machine toolset) and are required for the Linux
kernel to work correctly on some ST platforms.

The files can be installed in one of two ways. Either the files can be
copied directly into the ST40 toolset directory or they can be installed
into a separate directory and sourced from the user's own ".shgdbinit".

Installing directly into the toolset directory
----------------------------------------------

Installing directly into the toolset installed directory is
trivial. Simply copy all .cmd files included in this package into the
<toolset_root_directory>/sh-superh-elf/stdcmd directory.

Note: it is recommended to copy all the files in the above directory
(using tar cvf) before updating it with the contents of this package.
Making such a copy permits the safe removal of this package in the
unlikely event that the new versions regresses functionality.

Installing using .shgdbinit
---------------------------

Installing via .shgdbinit is (slightly) more complex than direct
installation but has the advantage that the original toolset is not
modified. This is useful if you do not have write permission to the
toolset installation, or if you need to maintain a 'clean' toolset for
normal embedded development as well. The disadvantage is that because
.shgdbinit resides in your home directory every developer will
need to install the package, and have their own copy of the .shgdbinit file.

Copy all files included in this package into an empty directory. This
example assumes the user's home directory is /home/tux and that the
files have been copied to the /home/tux/stm-st40.303-3.0.3-stdcmd-updates
directory.

Add the following lines to the /home/tux/.shgdbinit file:

directory /home/tux/stm-st40.303-3.0.3-stdcmd-updates
source sh4targets.cmd

Note that the directory command must use a full path since GDB will
perform neither variable expansion ($HOME/) nor tilde expansion (~/).



Notes on new naming conversion for STb710x based boards
=======================================================

There are now several different revisions (or cuts) of the STb710x
silicon, and some of these differences require a personalised set of
values specific to that cut being used. Also, some boards, such as the
STb7100 Reference (coco) and STb7100 MBoard (mb411) may have a 27MHz or
a 30MHz PLL module for the SysA crystal PLL.  In addition, the STb7100
MBoard (mb411) may be populated with either a STb7100 or a STb7109 chip.

In order to create a set of unified, unambiguous GDB stdcmd scripts that
can handle all these permutations, a new set of scripts are required
which encodes some of the following information in their names:

		- board name (STb7100 Reference, or STb7100 MBoard)
		- silicon chip type (STb7100 or STb7109)
		- silicon chip cut revision
		- SysA PLL crystal frequency (27MHz or 30MHz)
		- TapMux mode (bypass or stmmx)

For STb7100 Reference boards, the GDB connect command name is of the form:
	stb7100refcut<cut-number><tapmux-mode><SysA-freq>

For STb7100 MBoard boards, the GDB connect command name is of the form:
	mb411<chip>cut<cut-number><tapmux-mode><SysA-freq>

where,
	<chip>		is either "stb7100" or "stb7109".
	<cut-number>	is 2 digit cut number, (e.g. "20" for Cut #2).
	<tapmux-mode>	is either "bypass" or "stmmx".
	<SysA-freq>	is either "27MHz" or "30MHz".

It has been necessary as a result of these changes to break compatibility
with the old names that you may have been using. This means that any
scripts you use will need to be modified to use the new (more explicit)
names when you boot.

For a complete listing of the new names for the affected boards, please
see the appropriate following web page:

	http://www.stlinux.com/boards/stb7100ref/index.php
or	http://www.stlinux.com/boards/mb411/index.php


	The following table shows some of the more common conversions that
need to be made. See the above web site for further details and options.

	Old			New
	---			---
	mb411cut2bypass		mb411stb7100cut20bypass27MHz
	mb411stb7109bypass	mb411stb7109cut10bypass27MHz
	stb7100refcut11bypass	stb7100refcut11bypass27MHz or stb7100refcut11bypass30MHz
	stb7100refcut2bypass 	stb7100refcut20bypass27MHz or stb7100refcut20bypass30MHz

Note:	For the STb7100 Reference boards, board from Europe are likely to be of the 30MHz
	variant, and boards from AP are likely to be of the 27MHz variant.


	------------------- README ---------------------


------------------------------------------------------------------------
|  Sean McGoogan,                 |  E-mail: Sean.McGoogan at st.com      |
|  STMicroelectronics Ltd.,       |                                    |
|  1000 Aztec West,               |  Direct: +44 (0) 1454 462601       |
|  Almondsbury,                   |  Main:   +44 (0) 1454 616616       |
|  Bristol, BS32 4SQ, U.K.        |  Fax:    +44 (0) 1454 462305       |
------------------------------------------------------------------------