Add README file
[sitara-dss-files/am57xx-dss-files.git] / README
1 These Debug Server Scripting (DSS) files are intended to be invoked
2 from inside the Code Composer Studio (CCS) Scripting console.  These scripts have been tested
3 in CCS for both Windows and Linux.
5 Directions:
7 1. You first need to configure your debugger ccxml file.
8    a. File -> New -> Target Configuration File
9    b. Supply a name/location for the file.
10    c. View -> Target Configurations to see the available target configurations (yours should now be among them!).
11    d. Double-click your file in the Target Configurations panel to open it for editing.
12    e. Select your emulator and processor. Be sure to select a processor and not a board,
13       as we don't want any gel files to be part of the configuration. Save.
14    f. Do NOT connect to any CPU cores.  The scripts handle this automatically once you get the debug session launched.
16 2. In the Target Configurations window, right-click on your ccxml file and select "Launch Selected Configuration".
18 3. Launch the scripting console by going to View -> Scripting Console.
20 4. Run the desired dss file using loadJSFile command, for example:
22 loadJSFile C:\Users\username\workspace_v6_0\am57xx-dss-files\am57xx-ctt.dss
24 The resulting output file(s) will be on your Desktop.  Each generated file contains a timestamp in its name
25 such that you can invoke the scripts many times without overwriting previous files.