CTT

= TI Clock Tree Tool(CTT) = Clock Tree Tool is software used to understand the complex clock framework dependencies on OMAP chips. This is an excellent tool for learning to debug and understand the clock framework dependencies. Using this tool clock dependencies can be traced all the way from the oscillator on the board to the clocks in the IP functional block of interest. TI official site has links to download the CTT.

Note: this page was originated with CTT version v1.7.0.3

= Installing and Using TI Clock Tree Tool(CTT) =

Supported Operating Systems
This wiki describes the steps performed using Ubuntu 9.10
 * Windows XP
 * Linux - RedHat Enterprise, Ubuntu and Debian - should also work on Fedora/Gentoo

= Downloads Required = $ sudo apt-get install java-common sun-java6-bin sun-java6-jdk sun-java6-jre sun-java6-plugin unzip NOTE dpkg -L sun-java6-bin should show that it is atleast revision 1.6.0.18 (the install directory shows the version)
 * Download CTT for OMAP4 from here (version v1.7.0.3)
 * Current version on 21 Dec 10 is CTT-OMAP4430ES2.x-v1.7.0.4.zip
 * Install java (e.g. on Ubuntu 9.10)
 * Download JGraphTool - we need version 5.8.0 for this to work

Subnote for ubuntu 10.04
It is possible that the partner repository is not enabled in Ubuntu 10.04 default installation - you can follow the following steps to get sun jdk installed instead sudo apt-get remove icedtea6-plugin sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner" sudo apt-get update sudo apt-get install sun-java6-jdk sudo update-alternatives --config java sudo apt-get install sun-java6-plugin

= Installation Steps =

Install the CTT tool and JGraphLib tool to get started..

CTT installation
$ unzip CTT-OMAP4430ES2.0-v1.7.0.3.zip  Archive: CTT-OMAP4430ES2.0-v1.7.0.3.zip creating: CTT-OMAP4430ES2.0-v1.7.0.3/ inflating: CTT-OMAP4430ES2.0-v1.7.0.3/CTT_USER_MANUAL_v1.7.pdf inflating: CTT-OMAP4430ES2.0-v1.7.0.3/Install Instruction.txt inflating: CTT-OMAP4430ES2.0-v1.7.0.3/Installer-CTT-OMAP4430ES2.0-v1.7.0.3.jar
 * unzip the installation package

./$ cd CTT-OMAP4430ES2.0-v1.7.0.3/ ./CTT-OMAP4430ES2.0-v1.7.0.3 $ ls CTT_USER_MANUAL_v1.7.pdf                 Install Instruction.txt Installer-CTT-OMAP4430ES2.0-v1.7.0.3.jar ./CTT-OMAP4430ES2.0-v1.7.0.3$ java -jar Installer-CTT-OMAP4430ES2.0-v1.7.0.3.jar NOTE The installer installs the packages in a file hierarchy as follows from the selected installation path TI_Clock_Tree_Tool/ `-- CTT-OMAP4430ES2.0-v1.7.0.3 |-- CTT4430-v1.7.0.3.jar |-- Docs |  |-- CTT_USER_MANUAL_v1.7.pdf |  |-- Export Notice.htm |  |-- Libraries.htm |  |-- SWPA175_v1.0.pdf |  `-- WTBU License.htm |-- JGraphLib |  `-- README.txt |-- Scripts ....    `-- XMLFiles .... NOTE the locations of CTT4430-v1.7.0.3.jar and JGraphLib, we will need it later in the installation and execution steps
 * Start the CTT installer (you do not need root access for these steps)



Manual install
If you can't find the specified JGraph files (they seem to have disappeared from SF.net as of 20/01/2011), grab any jgraph-5.8 library (e.g. this one) and dump it to TI_Clock_Tree_Tool/CTT-OMAP4430ES2.x-v1.7.0.5/JGraphLib/lib/jgraph.jar.

JGraphLib installation
$ java -jar ~/Desktop/jgraph-5.8.0.0-lgpl.jar  ''' NOTE: THIS STEP IS IMPORTANT Remember to install JGraphLib in the Directory JGraphLib where TI Clock Tree Tool is installed
 * Start the JGraphLib installer (you do not need root access for these steps)

= Running CTT = Change directory to the installed directory of CTT. $ cd TI_Clock_Tree_Tool/CTT-OMAP4430ES2.0-v1.7.0.3 ./TI_Clock_Tree_Tool/CTT-OMAP4430ES2.0-v1.7.0.3 $ java -jar CTT4430-v1.7.0.3.jar

=IMPORTANT DOCUMENTS= Docs/CTT_USER_MANUAL_v1.7.pdf -> This tells you how to use the CTT Docs/SWPA175_v1.0.pdf -> This explains to you the clock architecture of OMAP4 (Strongly recommended reading)

= Providing Feedback for CTT = TODO