Dear Texas Instruments/Anaren,
Your Air Booster Pack (i.e. Shield) for the Texas Instruments (TI) LaunchPad has a lot of potential, but there are some really high barriers for novices to utilize them. A hobbyist would certainly like to do more than run the demo code; a natural desire would be to hack in other sensors (than the TI MCU's built-in temperature sensor) for instance. The problem is the demo code is too ' obfuscated'.
By that I mean after 2 months of trying to understand the code well enough to know where to 'hack in' another sensor, I am still at a loss of where to start, or which file to modify. The heart of any C code is "main.c". (It is not there). "Main.c" lists two dependencies, (#include...h files); which also have multiple dependencies, 20 .h files in all. For each of those there is a similar .c file; but with different code. I printed it all out, and counted over 4000 lines of code and papered my home with it trying to follow the gist of the program. (I question if this is beyond mere mortals).
"obfuscated code is the deliberate act of making source or machine code difficult to understand by humans"
With the talent you have in your Engineering Dept., you could provide some more sets of sample code that is simpler in scope and easier to understand (and that would be good for training purposes). A good start would be a simple wireless UART, so bytes can be pushed in one Anaren/TI Booster pack/Launchpad set up and the same bytes come out the other one connected to a PC's USB port. Normal technical generalists could make use of code like that. Another code example should show how to use one of the MSP430's analog inputs to measure an external sensor and to send those bytes over the RF link.
A good , comparative product is Pololu's Wixel. Out of the box, bytes in one unit, bytes out the other via RF. TI wants to grow in the hobbyist market, and a lot of engineers who are not embedded experts want to learn more and utilize widgets to perform better work. However, as long as the bar is as high as it currently is to do anything with the AirBooster pack, very few customers will succeed. Please invest in the success of your customers with some better code examples.
http://www.pololu.com/catalog/product/1336
Sincerely,
James M. Dinsmore