
Release notes for KW LSP release 5.1.3
========================================
 
Table of Contents
-----------------

1.	Contents of this Release
2. 	HowTo build
3.	Changes from previous releases
4.	Known Issues
5.      Notes
6.      Disclaimer


1. Contents of This Release
===========================

	Included in current release :
	- Support for ttyS0.
	- Interrupts handling.
	- L2 support + optimized cache opertaions.
	- USB host and device support.
	- CESA support.
	- PCI and PEX support.
	- Standard network interface support for the KW giga port.
	- Gateway network interface support for the RD on board switch.
	- Marvell SATA support.
	- Audio Alsa driver.
	- SD/SDIO/MMC driver.
  	- Telephony driver.
	- Nand flash driver.
	- SPI flash driver.
	- Memory transfer accelerations by using the XOR-DMA engine.
        - RTC support.
        - Support for passing Marvell Tag list from uboot.
        - Kconfig scripts for KW platforms configuration.
        - Heart Beat led.
        - Reset support.
        - MV shell Proc FS.
	- Transport Stream unit. (See known issues below).

	- This release is a patch to Linux 2.6.31.8 which can be download from
          (www.kernel.org)

	Configuration:
	--------------
        1. mv_kw_defconfig       -> performance optimised (No GW/NAT support)
        2. mv_kw_gw_defconfig    -> default configuration 

	Supported boards:
	-----------------
	1. DB-88F6281-BP-A
	2. DB-88F6192-BP-A (6190)
        3. DB-88F6180-BP-A
        4. RD-88F6281-A
        5. RD-88F6192-A (6190)
	6. DB-88F6282-A-BP
	7. RD-88F6282-A

2. HowTo build
===============
	This release was built using SDK 3.2
	get linux-2.6.31.8 from www.kernel.org
	change its name to the release name (linux_feroceon_...).
	unzip the release.zip in the directory where you put the kernel, say A to replace all.
	cd to the kernel directory.
	'make mrproper'
	config the kernel:
	'make <platform>_defconfig' 
	'make uImage'
	the kernel uImage will be found under arch/arm/boot/.


3. Changes from previous releases
=================================
- Changes from release 5.1.2
------------------------------
 o Add 6282 RD support (6171 switch)
 o Remove duplicated support for copy to/from user by memcpy, and disable all untetsted XOR CONFIGS.
 o update the function list for routing perf.
 o Bug fixes:
	- Remove UNWIND support to enable REORDER
	- Enable PCIE E1000 NIC
 	- Add 6282 support in cpufreq
	- SATA: 
		- change swap_buf_le16 to be static
		- replace SCSI_OPCODE_WRITE16 with SCSI_OPCODE_READ16
	- Fix USB string settings.
	- Use i2c1 only in case lcd is compiled and module exist on the board.

- Changes from release 5.1.1
------------------------------
 o Add support for LCD based on Dove FB driver.
 o Align HAL with U-Boot.

- Changes from release 5.1.0
------------------------------
 o Support runtime detection of 6281/6282
 o Fix bug - second PCIE IO win wasnt remapped.

- Changes from release 5.0.3
------------------------------
 o Add support for 6282 A0 ctrl and board.
 o Add support for 2nd PCIE if.
 o Remove support of 6282 Z0.
 o LCD BAR support.

- Changes from release 5.0.2
------------------------------
 o Add support for UBIFS in kernel config file.
 o Support for DDR self refresh.
 o Upgrade openswan to version 2.6.24.
 o Integrate patches 24 to 25 from KW LSP version 4.3.4
 o Fix kernel build issue when function reordering is enabled.
 o Add watchdog timer driver.
 o Fix bug in mv_shell SMI register write commands.


- Changes from release 5.0.1
------------------------------
 o Fixed NFP crash when receiving non-IP packets.
 o Update USB stack with latest changes and bug fixes.


- Changes from release 5.0.0
------------------------------
 o Add support for Multiple Rx Queues in defconfig file.
 o Update USB stack with latest fixes.
 o Fix a bug which caused a kernel panic when ethernet interface was
   switched up / down.
 o Fix timeout message caused by restarting autonegotiation when
   tx_enable was turned on.


- Changes from release 4.3.4
------------------------------
 o Kernel version:
   This release is based on kernel 2.6.31.8.
 o Bug Fixes:
   This release includes the same feature set as in version 4.3.4.

4. Notes
=========
NAS:
- From this version in order to get more optimized results, EXT4 should be used 
  instead of XFS.

Counter/Timer:
- Due to built-in +/-30 PPM deviation of on-board 25MHz main Xtal, KW
  internal core clock may drift ~2.5 seconds per day.
  The +/-30 PPM deviation is according to manufacturer specification.

USB:
- Linux doesn't handle well a case of 2 ISO devices(full speed) working
  simultaneously through the high speed hub.

NAND:
- When working with 4bit ECC configuration, it is not recommended to perform
  read from an erased page, since no ECC was calculated for this page.
  In this case we compared the page data against 512 bytes of 0xFF and if we
  get a match, then return gracefully, otherwise, there is an uncorrectable
  error.

UBIFS:
- When UBIFS support is enabled, the kernel configuration option
  CONFIG_MTD_NAND_VERIFY_WRITE must be disabled, and the CONFIG_NFTL,
  CONFIG_NFTL_RW options need to be enabled.

TWSI:
- 2 TWSI drivers are supported within the LSP: based HAL driver and standard Linux
  driver.
  The HAL based driver is used by the board environment initialization
  code (at kernel startup), and upon phone drivers initialization.
  The Linux driver is being used by the I2S audio codec.
  In order to use the I2S audio codec the i2c-mv64xxx.ko module should
  be loaded (after system startup).
  In a case where both phone and I2S codec drivers should exist in the system, 
  then the Linux I2C module should be loaded (insmod) only after the phone 
  driver is initialized (MMP package is loaded into the system).
  Additionally, the HAL based driver is not reentrant and can not be used
  simultaneously by more than one source.

Networking:

- Networking when CPU frequency is low (800MHz) may generate overrun error:
	" bad rx status 2fc3a86b, (overrun error)".

- NFP doesn't support packets with MTU bigger than 1500 Bytes.

Transport Stream:
- The transport stream unit driver supports only non-aggregation mode
  for read and write operations.

Storage:
- USB VBUS and SDIO WP is not operational on the following boards since 
  it conflicts MPP settings for add-on modules:
  o DB-88F6281-BP-A: SDIO and USB device
  o DB-88F6180-BP-A: USB device

- When disconnecting a SATA device while it used by the kernel (e.g. contains
  unmounted file system), the user must delete the block devices on that 
  channel (using the sysfs), otherwise, farther hotswap events on that channel
  may cause to kernel crash.

  In order to overcome this issue, 
  We recommend that the user will cleanly remove the scsi dev through the sysfs by using the 
  following command:
  #echo 1 > /sys/class/scsi_host/hostH/device/targetH:B:T/H:B:T:L/delete
  Where H, B, T and L stands for Host, Bus, Target and Lun.

  In case that the disk was removed brutally, the udev should detect this event and should remove 
  the device from the sysfs by using the same command as above.

- Thor 6145 has issues with hot-swap, NCQ, port-multiplier and
  ATAPI support.

- Thor 6121 has issues with hot-swap and ATAPI support.

- This release support up to 512MB of DRAM with current memory layout definition.

Configs:
- CONFIG_ARM_UNWIND can't be used together with CONFIG_REORDER

5. Disclaimer
=============
This document provides preliminary information about the products described, and such 
information should not be used for purpose of final design. Visit the Marvell(r) web 
site at www.marvell.com for the latest information on Marvell products.

No part of this document may be reproduced or transmitted in any form or by any means, 
electronic or mechanical, including photocopying and recording, for any purpose, 
without the express written permission of Marvell. Marvell retains the right to make 
changes to this document at any time, without notice. Marvell makes no warranty of 
any kind, expressed or implied, with regard to any information contained in this 
document, including, but not limited to, the implied warranties of merchantability 
or fitness for any particular purpose. Further, Marvell does not warrant the accuracy 
or completeness of the information, text, graphics, or other items contained within 
this document. Marvell makes no commitment either to update or to keep current the 
information contained in this document. Marvell products are not designed for use in 
life-support equipment or applications that would cause a life-threatening situation 
if any such products failed. Do not use Marvell products in these types of equipment 
or applications. The user should contact Marvell to obtain the latest specifications 
before finalizing a product design. Marvell assumes no responsibility, either for use 
of these products or for any infringements of patents and trademarks, or other rights 
of third parties resulting from its use. No license is granted under any patents, 
patent rights, or trademarks of Marvell.These products may include one or more 
optional functions. The user has the choice of implementing any particular optional 
function. Should the user choose to implement any of these optional functions, it is 
possible that the use could be subject to third party intellectual property rights. 
Marvell recommends that the user investigate whether third party intellectual property 
rights are relevant to the intended use of these products and obtain licenses as 
appropriate under relevant intellectual property rights. 
Marvell comprises Marvell Technology Group Ltd. (MTGL) and its subsidiaries, Marvell 
International Ltd. (MIL), Marvell Semiconductor, Inc. (MSI), Marvell Asia Pte Ltd. (MAPL), 
Marvell Japan K.K. (MJKK), Marvell Semiconductor Israel Ltd. (MSIL), SysKonnect GmbH, 
and Radlan Computer Communications, Ltd.
Export Controls.  With respect to any of Marvell's Information, the user or recipient, 
in the absence of appropriate U.S. government authorization, agrees: 1) not to re-export 
or release any such information consisting of technology, software or source code 
controlled for national security reasons by the U.S. Export Control Regulations ("EAR"), 
to a national of EAR Country Groups D:1 or E:2; 2) not to export the direct product of 
such technology or such software, to EAR Country Groups D:1 or E:2, if such technology or 
software and direct products thereof are controlled for national security reasons by the 
EAR; and, 3) in the case of technology controlled for national security reasons under the 
EAR where the direct product of the technology is a complete plant or component of a plant, 
not to export to EAR Country Groups D:1 or E:2 the direct product of the plant or major 
component thereof, if such direct product is controlled for national security reasons by 
the EAR, or is subject to controls under the U.S. Munitions List  ("USML").  At all times 
hereunder, the recipient of any such information agrees that they shall be deemed to have 
manually signed this document in connection with their receipt of any such information. 
Copyright (c) 2004.  Marvell.  All rights reserved.  Marvell, the Marvell logo, Moving 
Forward Faster, Alaska, and GalNet are registered trademarks of Marvell.  Discovery, 
Fastwriter, GalTis, Horizon, Libertas, Link Street, NetGX, PHY Advantage, Prestera, 
Raising The Technology Bar, UniMAC, Virtual Cable Tester, and Yukon are trademarks of 
Marvell.  All other trademarks are the property of their respective owners.
