HOWTO: Working with FreeMASTER SDKs

Document created by Mike Doidge Employee on Jul 19, 2018Last modified by Mike Doidge Employee on Aug 27, 2018
Version 2Show Document
  • View in full screen mode

The FreeMASTER serial communication driver is a piece of code that enables an embedded application to communicate with the FreeMASTER PC application.


Please note: The FreeMASTER_S32xx does not support all Toolchains and not all versions of supported Toolchains. The available SDKs will vary depending upon the toolchain which is selected. It is independent of the S32/MPC SDKs. In most cases, it is not integrated with the S32/MPC SDKs, although this could change in the future.


When creating a new S32DS Application Project, you may have noticed the FreeMASTER_S32xx SDK option in the Select SDK menu.



To add the FreeMASTER SDK to your project, simply add it in the New Project Wizard (as pictured above) or add it later through the project properties menu, SDKs:



Select the desired SDK from the list, then click 'Attach/Detach...'



Click in the column for each build configuration for which you wish to have the SDK attached. You can remove SDKs by clicking the '+', making it disappear.


It should also be noted that there exists example projects which demonstrate usage of the FreeMASTER serial communication driver, though these do not use the FreeMASTER SDK, the driver was added manually.



When working in your project, you can use the SDK Explorer to drag and drop macros and function calls into your code.

To add the SDK Explorer to your perspective, there are at least 2 methods:

1) Menu method

a) Window -> Show View -> Other... OR Alt + Shift + Q, Q

b) Filter on 'SDK'

c) Select 'SDK Explorer'

d) Click OK

2) Quick Access method

a) Type 'SDK'

b) Select 'SDK Explorer'


To access the macros and function calls from the SDK Explorer:

1) Go to the Project Explorer and select your project to make it active.

2) Go to SDK Explorer and all of the SDKs you included in the project will be listed.

3) For the SDK you wish to access, expand the folders and files until you can see the function you wish to add. You can set some filters to hide unwanted content.



4) Simply drag and drop the macro/function call into your source file. The #include statement for the associated header file will be automatically added near the top of your source file.




Happy FreeMASTER serial communicating!

1 person found this helpful