Mathematica - API Bindings¶

As AddOn¶

To install the bindings as AddOn just create a new folder for Tinkerforge in the Mathematica AddOn-Applications folder and copy the Tinkerforge.dll file to it. On Windows the AddOn-Applications folder for Mathematica 9 is located here (for Mathematica 10 replace 9.0 by 10.0):

C:\Program Files\Wolfram Research\Mathematica\9.0\AddOns\Applications\

On Linux it's located here (for Mathematica 10 replace 9.0 by 10.0):

/usr/local/Wolfram/Mathematica/9.0/AddOns/Applications/

And on macOS it's located here:

/Applications/Mathematica.app/AddOns/Applications/

Create a Tinkerforge/ folder here, create an assembly/ folder in copy the Tinkerforge.dll file to it. Afterwards it should look like this on Windows:

C:\Program Files\Wolfram Research\Mathematica\9.0\AddOns\Applications\Tinkerforge\assembly\Tinkerforge.dll

Like this on Linux:

/usr/local/Wolfram/Mathematica/9.0/AddOns/Applications/Tinkerforge/assembly/Tinkerforge.dll

And like this on macOS:

/Applications/Mathematica.app/AddOns/Applications/Tinkerforge/assembly/Tinkerforge.dll

If you installed the bindings like this then you have to modify the LoadNETAssembly[] call in the examples like this:

LoadNETAssembly["Tinkerforge","Tinkerforge`"]

The section about testing an example has more details about this.

As SystemFile¶

To install the bindings as SystemFile copy the Tinkerforge.dll file to Mathematica's SystemFiles folder for .NET/Link. On Windows the SystemFiles folder for .NET/Link for Mathematica 9 is located here (for Mathematica 10 replace 9.0 by 10.0):

C:\Program Files\Wolfram Research\Mathematica\9.0\SystemFiles\Links\NETLink\

On Linux it's located here (for Mathematica 10 replace 9.0 by 10.0):

/usr/local/Wolfram/Mathematica/9.0/SystemFiles/Links/NETLink/

And on macOS it's located here:

/Applications/Mathematica.app/SystemFiles/Links/NETLink/

If you installed the bindings like this then you have to modify the LoadNETAssembly[] call in the examples like this:

LoadNETAssembly["Tinkerforge"]

The section about testing an example has more details about this.

Without Installation¶

You can use the Mathematica bindings without having to install them. Just give the folder that contains the Tinkerforge.dll file as parameter to the LoadNETAssembly[] call. The examples are set up in a ways that the LoadNETAssembly[] call already points correctly to the Tinkerforge.dll file if the bindings and the examples have been unpacked from the ZIP file. The section about testing an example has more details about this.

Stepper Brick¶

As an example we will run the Stepper Brick configuration example. To do this open the ExampleConfiguration.nb Notebook from the examples/Brick/Stepper/ folder in Mathematica.

LoadNETAssembly["Tinkerforge","Tinkerforge`"]

LoadNETAssembly["Tinkerforge"]

LoadNETAssembly["C:\\Absolute\\path\\to\\Tinkerforge.dll"]

LoadNETAssembly["/Absolute/path/to/Tinkerforge.dll"]

host="localhost"
port=4223
uid="XXYYZZ"(*Change XXYYZZ to the UID of your Stepper Brick*)

Temperature Bricklet¶

Here's an another example showing a dynamic plot of Temperature Bricklet measurements. The drop at sample 82 was created using a freezer spray.