The utils folder in a StellarisWare installation contains (appropriately enough) a set of "utility" modules; eg,
cmdline - simple command-line interpreter
softi2c - software I2C on GPIO pins
softssi - software SSI on GPIO pins
softuart - software UART on GPIO pins
uartstdio - simple stdio interface on a UART
Currently, there seems to be no standalone documentation for these - instead, the same documentation is repeated verbatim in each of the DevKit user manuals
So my first suggestion is: Wouldn't it be simpler to have a single document for these?
Of course, this would be referenced by the individual DevKit user manuals, and they could supply any details specific to the particular kit.
The descriptions of the module files are somewhat ambiguous; eg,
EK-LM3S6965 Firmware Development Package User's Guide This module is contained in utils/uartstdio.c, with utils/uartstdio.h containing the API definitions (sic) for use by applications.
This module is contained in
Now, "definitions" there is OK in general English usage, but is incorrect in specific 'C' language terminology.
So my second suggestion is: it should be changed to "declarations"
It might (only might) have helped this user: http://www.keil.com/forum/18997/
Andy NeilWouldn't it be simpler to have a single document for these?
It would have answered this question: http://e2e.ti.com/support/microcontrollers/stellaris_arm_cortex-m3_microcontroller/f/471/p/116948/415274.aspx#415274
Hi Andy,
Thanks for the suggestion. I'll pass it along to the software team.
Regards,
Sue
Bump: http://e2e.ti.com/support/microcontrollers/stellaris_arm_cortex-m3_microcontroller/f/473/t/167525.aspx
Bump: http://e2e.ti.com/support/microcontrollers/stellaris_arm_cortex-m3_microcontroller/f/471/t/203177.aspx
Still confusing users: http://e2e.ti.com/support/microcontrollers/stellaris_arm/f/901/p/245433/859069.aspx#859069