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.



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



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



The process bar shows the installation process.



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

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.



Click Next button in the following window.



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



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



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



Now the process install the driver.


Click Next button in the following window.



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



Click Install button.



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



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

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.



And also the following error window will be displayed.



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



Click Next button in the following window.



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



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



Click Install button.



The driver will be installed.



Launch the driver installer.



Click Install button.



Click OK on the successful installation window.

Import TST examples

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



Choose the workspace to store your projects.



On the welcome tab, click on the Workbench icon.



On the File menu, select the Import option.



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



Click the Browse button to indicate the code location .



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.



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

Compiling the first program

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



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



Click the Browse button.



Select the release.xml file.



Click the Finish button.



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



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}



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



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



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



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).



A process bar for the building process will be displayed.



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

Customizing Eclipse

Click the down arrow on the External Tools icon.



Select the Organize Favorites menu.



Click the Add button.



Checkmark the option OpenOCD_XL_RELEASE.



Click the OK button.



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



Click the down arrow on the Debug icon.



Select the Organize Favorites menu.



Click the Add button.



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



Click the OK button.



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



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