API  2.2
TSmarT Software Library
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Quick Start Guide

Installation

Install Eclipse

Once you have downloaded the SDK, extract the .zip file and run the file TSmarTSEx86.exe if you have a 32-bit system or the file TSmarTSEx64.exe if your system is 64-bit.

Note: You have also an installation video-tutorial available on our Documentation Center.

Setup Wizard

Select the components you want to install (we recommend to install everything) and click Next.

Setup Wizard

Enter the destination folder (without spaces) to install the tools at, and click Install button.

Setup Wizard

The process bar shows the installation process.

Setup Wizard

When the installation process is completed, the following window promts up. Click Finish.

Setup Wizard

Install JTAG driver

To install the utilities and driver for ST-Link V2 JTAG, please run the file STM32 ST-LINK Utility_v3.3.0.exe.

JTAG

Click Next button in the following window.

Setup Wizard

Acept the terms and click Next button in the following window.

Setup Wizard

Select Destination folder and click Next button in the following window.

Setup Wizard

Click Finish on the successful installation window for ST-Link Utility.

Setup Wizard

Now the process install the driver.


Click Next button in the following window.

Setup Wizard

Select Destination folder and click Next button in the following window.

Setup Wizard

Click Install button.

Setup Wizard

Click Finish on the successful installation window for ST-Link Driver.

Setup Wizard

When you connect the ST-Link to a USB port in your computer, you will probably see the following window.

Setup Wizard
Setup Wizard

Install TSkiT driver

When you connect the Debug_Board USB sniffer to a USB port in your computer, you will probably see the following window.

Setup Wizard

And also the following error window will be displayed.

Setup Wizard

To install the driver, please run the file CP210x_VCP_Win_XP_S2K3_Vista_7.exe provided in the SDK.

Setup Wizard

Click Next button in the following window.

Setup Wizard

Accept the terms and click Next button in the following window.

Setup Wizard

Select Destination folder and click Next button in the following window.

Setup Wizard

Click Install button.

Setup Wizard

The driver will be installed.

Setup Wizard

Launch the driver installer.

Setup Wizard

Click Install button.

Setup Wizard

Click OK on the successful installation window.

Setup Wizard
Setup Wizard

Import TST examples


Double-click the eclipe.exe file to run Eclipse.

Setup Wizard

Choose the workspace to store your projects.

Setup Wizard

On the welcome tab, click on the Workbench icon.

Setup Wizard

On the File menu, select the Import option.

Setup Wizard

Select the option Existing Code as Makefile Project, and click Next.

Setup Wizard

Click the Browse button to indicate the code location .

Setup Wizard

Select the "RELEASE" folder in your Workspace. Please be aware that "RELEASE" is just a place holder, you will see a folder called TSmarT_x.x instead, being x.x the current API version.

Setup Wizard

Now click the Finish button. Congratulations, now you have imported all our examples!

Setup Wizard

Compiling the first program


Right-click on the Release folder and select the Import menu.

Setup Wizard

Select the C/C++ Project Settings option, and click the Next button.

Setup Wizard

Click the Browse button.

Setup Wizard

Select the release.xml file.

Setup Wizard

Click the Finish button.

Setup Wizard

Right-click on the Release folder and select the Properties menu.

Setup Wizard

At the C/C++ Build window, on the Builder Settings tab, uncheck the Use default build command checkmark and introduce the following line on the Build command text field:
make -f ${selected_resource_loc}/Makefile DEBUG=1 TS_BOARD=TSmoTe.
NOTE: If you are compiling for the TSgaTe_v2, introduce this other line instead:
make -f ${selected_resource_loc}/Makefile DEBUG=1 TS_BOARD=TSgaTe_v2.
Type also the following line on the Build directory text field:
${selected_resource_loc}

Setup Wizard

At the C/C++ Build window, on the Behavior tab, type eclipse on the text field and click the OK button.

Setup Wizard

In the Project Explorer tree window, select the Makefile.local file under templates/app and copy it (CTRL+C).

Setup Wizard

Paste (CTRL+V) the Makefile.local file under the example folder you want to use, e.g. under the ai_read folder.

Setup Wizard

Select the example folder you want to compile, e.g. the ai_read folder, and click on the build icon (i.e. the hammer symbol).

Setup Wizard

A process bar for the building process will be displayed.

Setup Wizard

When the building process is completed, details will be shown on the console tab and the message Build Finished is displayed on the bottom.

Setup Wizard

Customizing Eclipse


Click the down arrow on the External Tools icon.

Setup Wizard

Select the Organize Favorites menu.

Setup Wizard

Click the Add button.

Setup Wizard

Checkmark the option OpenOCD_XL_RELEASE.

Setup Wizard

Click the OK button.

Setup Wizard

Now this option has been saved and is displayed under the External Tools icon.

Setup Wizard

Click the down arrow on the Debug icon.

Setup Wizard

Select the Organize Favorites menu.

Setup Wizard

Click the Add button.

Setup Wizard

Checkmark the option CodeSourcery_(RELEASE)_(TSmoTe_STM32F10X_XL).

Setup Wizard

Click the OK button.

Setup Wizard

Now this option has been saved and is displayed under the Debug icon.

Setup Wizard

Select Standard GDB Hardware Debugging Launcher and click the OK button.

Setup Wizard