README.md

Content

• Content
• Eclipse example projects
  • Overview example projects
    • Start project 1: TxtSharedLibraryInterface
    • Start project 2: TxtSharedLibraryInterface2
    • Start project 3: TxtSliTestTA1
    • Start project 4: TxtSliTestTA2
    • Example 1: TxtSharedLibraryInterfaceDemo01
    • Example 2: TxtSharedLibraryInterfaceDemo02
    • The TXT libraries: TxtDeps
  • How can I create my first Eclipse SLI project
    • Copy and Paste the start projects
    • Rename some files
    • Inspecting and updating the project properties
    • Start with coding
  • How to make use of DoxyGen?
• document history

Eclipse example projects

In this workspace you will the TXT library and some Eclipse projects.

You need TXT firmware version >=4.6.6

see ROBOPro help in section 8.2.9 and 8.2.10

Overview example projects

All examples are Eclipse projects.

Start project 1: TxtSharedLibraryInterface

See readme

Step 1: What are the SLI basics?

Start project 2: TxtSharedLibraryInterface2

See readme

Step 2: Does fischertechnik RoboPro SLI-mechanism knows some peculiarities?
Blocking issues, a workaround for the online 5sec problem and init/stop issues.

Start project 3: TxtSliTestTA1

See readme

Introduction into the use of the Transfer Area (TA).

Start project 4: TxtSliTestTA2

See readme

The same as TxtSliTestTA1 but now is the functionality removed from the main file and put in a class. The main file takes only care for the RoboPro elements.
.

Example 1: TxtSharedLibraryInterfaceDemo01

See readme

SLI show the use of the Joystick<br/>
A control element for a two wheels FT-bot (TXT discovery kit)

Example 2: TxtSharedLibraryInterfaceDemo02

See readme
(not yet available) SLI show the use of the Extended Motor control

The TXT libraries: TxtDeps

See readme
This project contains the include and library fields for the fischertechnik SLI's and local programs Eclipse project. It is as it is, no need to compile or change.

How can I create my first Eclipse SLI project

Advice: Study carefully TxtSharedLibraryInterface and TxtSharedLibraryInterface2 before you start with your own project. Exercise:
You are going make the basics for your first Eclipse SLI project.

Copy and Paste the start projects

• Select the TxtSharedLibraryInterface in the Eclipse Project Explorer.
• Right click the mouse and select `Copy.

• Right click again the mouse and select Paste.

• Change the name of the project.

Rename some files

Rename in the src the LibExampleSLI.cpp file, the ROBOPro files and in the root the TxtSharedLibraryInterface.doxyfile

Inspecting and updating the project properties

(See in case of problems also)[../ProjectSetUp(so).md ] for information over the settings.
Select the project properties

Inspect the setting and correct the reference to the project his include map

• Compile the project and see if everything is fine. Otherwise correct small mistakes.
  After this you project is ready to start with writing code.

Start with coding

• You can remove the 4 examples functions but you can also use them as templates.
• Update the iit and stop.
• Add the StayAwake function

int setStayAwakeShort(short t) {
	if (!IsInit) {
		fprintf(stderr, "setStayAwakeShort: Not initialized!\n");
		return -1;
	} else {// fprintf( "ExampleSLI:setValueDouble: already initialized!\n");
	}
	return 0;
}

• Don't forget to keep your documentation up to date.

How to make use of DoxyGen?

DoxyGen is a nice tool to help you with creating documentation for your project. The examples contain already a option to generate a DoxyGen based documentation, the *doxyfile file
If not this file can be add with File | New | Others | Others | Doxyfile.

After running the documentation, select the doxyfile and run it with the symbol, you need to refresh the Project Explorer view with top menu File | Refresh or F5.

document history

• 2020-05-16,24,26,28 Cvl 466.1.2 new