AMSDK START HERE Script

Content is no longer maintained and is being kept for reference only!

Return to the Sitara Linux Software Developer's Guide

Content is no longer maintained and is being kept for reference only!

Overview

For some devices like the Beaglebone which use a built in USB to Serial adapter a special script called START_HERE.sh has been created to assist in running the out of box software and installing the AMSDK. This script will be found when the board is booted into Linux and the START_HERE partition of the SD card is auto mounted on your Linux host machine. At that point the board is acting as an SD card reader to provide you access to the contents of the START_HERE partition which has the AMSDK installer, Quick Start Guides, and CCS installer.

Executing the Script

After following the instructions to connect your board to your Linux host machine using USB, the board will boot into Linux. At this point you should find two partitions mounted. These are the boot and START_HERE partitions. On the START_HERE partition you will find a script called START_HERE.sh. To execute this script double-click the script and if prompted select Run in Terminal. This will open a terminal window which will prompt you for which actions you wish to perform.

Launching Matrix

At this point a terminal window should be open and you should see output like the sample below asking you if you would like to launch a browser to connect to matrix remotely.

                         BeagleBone Startup

Thank you for purchasing the BeagleBone!

The BeagleBone contains everything you need for development, including a USB
card reader, USB-to-Serial converter and a XDS100v2 emulator - and it's all over
the same USB cable! With optional daughter cards, components like display and
Wifi can be added with ease.

The BeagleBone is fully booted, but development can't begin until the SDK is
installed and the appropriate development environment is configured.

However, before beginning development, would you like to explore the remote
version of Matrix GUI v2? Matrix GUI provides an easy way explore the
capabilities of the BeagleBone through your host web browser. (y/n)
[y]

Pressing Enter (default is yes) or entering y + Enter will start your local browser and connect to the matrix application running on the board. Entering n will skip this step. From this browser window you can launch additional applications on the board and see their results.

NOTE: You can only see text based output. Applications that are graphical in nature can only be viewed using the LCD or DVI output of your board if available. If a video output is not available you will not be able to see the application output and should not execute the application.

When you are done exploring the example applications available you can minimize your browser and go on to the next step.

Launching the Software Developer's Guide

The terminal window should now be prompting you to decide whether or not to view the Software Developer's Guide.

TI provides an up-to-date Software Developer's Guide (SDG) in the form of a
wiki on the TI website. Would you like to open this before beginning
the setup process? (y/n)?
[y] 

If you select y here or just press Enter your browser will open a new tab connecting to the Software Developer's Guide on the TI wiki. Entering n will skip this step. This guide will explain the features of the SDK and how to use it.

When you are done reviewing the Software Developer's Guide you can minimize your browser and go to the next step.

Installing the SDK

The terminal window should now be prompting you about whether or not to begin the SDK installation.

Would you like to begin the SDK installation? (y/n)?
[y]

If you select y here or just press Enter the SDK installer will pop up and prompt you to begin installation. Entering n will skip SDK installation and the terminal will close, at which time the START_HERE script has finished running.

If you selected y above then you will be guided through the SDK installation using the graphical interface. It is generally best to select all the default values.

NOTE: If you do not install the SDK to the default location you will be prompted to run the setup.sh script inside of the SDK yourself with a message similar to:

                         BeagleBone setup.sh

The remainder of the BeagleBone setup is performed via setup.sh. Setup.sh has
been modified slightly for the BeagleBone so that it can autodetect and install
the drivers for the built in USB-to-Serial and XDS100v2. 

The setup script is located in your install directory, and requires sudo (admin)
access to correctly run. To run type "sudo <sdk-install dir>/setup.sh"
Press Enter to Exit.

Running setup.sh

Assuming that you installed the SDK to the default path the script will find the setup.sh script within the SDK installation and prompt you if you would like to run that script.

                         BeagleBone setup.sh

The remainder of the BeagleBone setup is performed via setup.sh. Setup.sh has
been modified slightly for the BeagleBone so that it can autodetect and install
the drivers for the built in USB-to-Serial and XDS100v2. 


Would you like to begin setup.sh now? (y/n)
[y] 

For details on what the setup.sh script does refer to the SDK setup script page.

NOTE: You will need to have sudo (administrative) privileges to run the setup.sh script. If you do not have sudo access on your Linux PC you should select n here and talk to your system administrator to gain sudo permissions. You can then run setup.sh manually as described on the SDK setup script page. If you do have sudo permissions you will be prompted for your sudo password.

When setup.sh has finished you will be left with a terminal that is connected over the USB to serial adapter to the board. From this terminal you can interact with the shell command line on the board.