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).
To 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 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.
TiOS versions in TIDE are displayed without the last number, like this: TPP2W, V3.50.
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.
Tibbo offers a BinMerger utility for combining TiOS with your application.
You can download it here: http://tibbo.com/downloads/basic/software.html.
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:
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.