Releasing Your Application

Top  Previous  Next

So you've created and debugged your application and now it is time to release it into the wild. What do you do?

 

Building for release

For deployment in the real world you application must be built for release.

Release binaries are executed as soon as the device powers up. No debug commands from TIDE are needed (or accepted).

 

tide_button_buildmodeTo build a release binary select Release in the drop-down on the Debug toolbar.

After that use Build > Build (or Build > Rebuild, > Build and Upload, or > Rebuild All and Upload to create and optionally upload a release binary).

Whatever you choose, a .TPC file will get created and placed in the project directory.

 

Combining with TiOS

The .TPC binary does not include the TiOS firmware.

When you upload it onto a device you need to make sure that this device is running a compatible version of TiOS.

"Compatible" means two things:

The type of device you are uploading to matches the type of device (platform) for which you built your .TPC binary file.
The TiOS on this device has the same major revision as the one for which this application was built.

 

The current TiOS version running on the device can be checked using the Device Explorer, it appears in the Version field. You will see something like this: <TPP2W-3.50.05>.

In this example 3.50 is the major revision, and 05 is the minor revision number.

The version of TiOS you are building for appears in the Files pane and the Browser-Project pane, on top of the tree, next to the platform name.

TiOS versions in TIDE are displayed without the last number, like this: TPP2W, V3.50.

 

current_tios_version

 

If you build for V3.50 then the compiled application binary will happily run on TiOS devices with firmware V3.50.XX, where XX means any number.

 

A lot of compatibility issues can be eliminated by combining TiOS with the application binary.

This creates a known working combination and you don't have to worry about compatibility issues between the application binary and TiOS of the device it goes onto.

 

Click to enlarge
Click to enlarge

Tibbo offers a BinMerger utility for combining TiOS with your application.

You can download it here: http://tibbo.com/downloads/basic/software.html.

 

 

 

BinMerger steps:

 

Browse to the TiOS firmware file. If you built your application for V3.50 then you need to get your hands on any TiOS firmware of V3.50.XX, where "XX" means "any number".

You can find TiOS firmware files here: C:\Program Files (x86)\Tibbo\TIDE\Platforms\<your platform>\firmware, where "<your platform>" is the actual platform name, such as "TPP2W".

TiOS files are also published here: http://tibbo.com/downloads/basic/firmware.html.

 

Select .TPC file. This is the compiled application binary. It is supposed to be inside your project folder.

 

Generate binary. Click and it's done!

 

Deploying to multiple devices

You can deploy your .TPC binary or TiOS+TPC binary using the Device Explorer.

Since the Device Explorer is a standalone utility that can be installed separately from TIDE you don't actually need TIDE for gang-uploading into devices.

 

Here is how to upload:

Connect any number of Tibbo programmable devices to your LAN.
Launch the Device Explorer.
Select one or more devices in the list (use [CTRL]+click or [SHIFT]+click to select many devices at once).
To upload a .TPC binary click Upload... and choose Load Application Through the Network.
To upload a TiOS+TPC binary click Upload... and choose Load Firmware Through the Network.

 

It is also possible to upload a TiOS+TPC binary through the serial port in the firmware upgrade mode.

 

Password-protecting your devices

It is a good idea to password-protect your devices when deploying them in the field.

Without the password protection, anyone with a basic knowledge of TIDE will be able to upload your devices with a different application!

To set a password for a device, highlight it in the Device Explorer and click Set Password....

Forgot the password? Press and hold the Setup (MD) button while accessing your device from TIDE. The password protection will be disabled for as long as the button is pressed. Set the new password while holding the MD button down — this way TIDE will not require the existing password to be entered.