SB61xx SURFboard Cable Modem Files

Copyright (c) 2012 Motorola Mobility Inc

All rights reserved.


Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright
   notice, this list of conditions and the following disclaimer in the
   documentation and/or other materials provided with the distribution.
3. The name of the author may not be used to endorse or promote products
   derived from this software without specific prior written permission.

Alternatively, this software may be distributed under the terms of the
GNU General Public License ("GPL") version 2 as published by the Free
Software Foundation.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

GPLv2 license:

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.



##########################################################

OSS components of uboot for the SB6120/SB6121/SB6141 Cable Modem 

##########################################################

README.txt - This file explains the OSS package contents and how to build.

== CONTENTS==
   
     Overview
     Package Info
     Installation
     Open Source Toolchain
     Build Instructions
     End


== OVERVIEW ==

The SB6120/SB6121/SB6141(Surfboard 6120/SB6121/SB6141) is a Docsis 3.0 compliant cable modem. 
This package contains all the files used in the uboot code on SB6120/SB6121/SB6141 that are open 
source and meant for re-distribution to the community.  

The application code is available in a separate download.


== PACKAGE INFO ==

A brief description of the files included in the SB_KOMODO-UBOOT.tar.bz2 packages.

OSS Package contents
--------------------


Here is a list of the OSS packages that SB_KOMODO uboot the SB6120/SB6121/SB6141 uses. 
For details of each package, refer to the README in respective directories.

There are 3 versions of the u-boot found in this directory.
As of 12/4/2012:
SB_KOMODO-UBOOT-1.0.7.13m2.tar.bz2 is the uboot currently used on the SB6120, it is not compatible with the SB6121 or the SB6141.
SB_KOMODO-UBOOT-1.0.12.18m2.tar.bz2 is the uboot originally used on the SB6121, it is compiled to enable a 25MHz clock that is required for the ethernet to function.
SB_KOMODO-UBOOT-1.0.12.18m3.tar.bz2 is the uboot currently used on the SB6121 and SB6141 is it based on the SB_KOMODO-UBOOT-1.0.12.18m2 uboot with the addition of support for the Spansion S25FL064P flash device


NOTE: "modified" string in the package name implies that the packages are modified by Intel/Motorola.

u-boot-1.2.0-modified	        : This is the bootloader that is used in our ARM based SB6121/SB6121/SB6141 boards

These packages are available in the SB_KOMODO application file .tar.bz2 and are used to build the bootloader

puma5_toolchain                 : This contains the tool chain installation script and patches.

INSTALL_SCRIPT                  : Script to create build environment for the OSS package

== Open Source Toolchain ==

armeb-linux-uclibceabi-gcc -v
CROSS Compiler:  gcc version 4.2.0 TI-Puma5 20100224


== Build Instructions =

1) Download and install the puma5_toolchain found in the SB_KOMODO-1.0.6.10-SCM00.tar.bz2 file following the directions found there.


INSTRUCTIONS TO CREATE BUILD ENVIRONMENT 
----------------------------------------
1) Copy the below commands at the path where you are going to compile OSS package.
   eg: if the package that you are going to build is at /root/
       cd /root/ and copy the below commands.

       export TARGET_HOME=`pwd`
       export PRODUCT_NAME=dsdk
       export KERNEL_DIR=${TARGET_HOME}/linux-2.6.18-modified/src
       export TI_tools_path=${TARGET_HOME}/tools
       export TI_filesystem_path=${TARGET_HOME}/build/{PRODUCT_NAME}/fs
       export TI_build_root=${TARGET_HOME}
       export TI_BUILD_ROOT=${TARGET_HOME}
       export TI_lib_path=${TARGET_HOME}/ti/lib
       export TI_include=${TARGET_HOME}/ti/include

2) run INSTALL_SCRIPT
	./INSTALL_SCRIPT

INSTRUCTIONS TO BUILD u-boot.bin
----------------------------------
1) Unzip the uboot package or your choice: ex tar -xjvf  SB_KOMODO-UBOOT-1.0.7.13m2.tar.bz2
2) Enter the u-boot-1.2.0 subdirectory in the unzipped directory
3) Configure the u-boot for the tnetc550 with either 3a or 3b
3a) For a SB6120 uboot
     make CROSS_COMPILE=armeb-linux-uclibceabi- tnetc550_config
3b) For a SB6121 or a SB6141 uboot
     make CROSS_COMPILE=armeb-linux-uclibceabi- CONFIG_MOTO_PSPUBOOT_25_MHZ_CLK_ENABLE=1 tnetc550_config
4) Build u-boot.bin
     make CROSS_COMPILE=armeb-linux-uclibceabi- 


= END =