A few modifications to the Code Composer Studio ™ project are required to add support for the SFRA GUI.
Add "sfra_gui_scicomms_driverlib.c" to the project. This can be done in the project window, by right-click on your project and selecting “Add files to project”, then browse to the file under <sfra-install-path>/gui/source.
Add "sfra_gui_scicomms_driverlib.h" to the include path for the project. The file is located at <sfra-install-path>/gui/include.
Call the SFRA_GUI_config function. The GUI can toggle an LED when connected, if this feature is used additional configuration parameters must be passed to the GUI config routine, otherwise pass zero in those parameters. Typical defines used on F28004x control card are shown below. Change them if your hardware requires any changes. Currently the SFRA GUI supports plotting of two vectors, passing a '1' for the plot options defualts the plant and open loop vectors. '2' plots the closed loop and the plant transfer function.
#define SFRA_GUI_SCI_BASE SCIA_BASE
#define SFRA_GUI_VBUS_CLK 50000000
#define SFRA_GUI_SCI_BAUDRATE 57600
#define SFRA_GUI_SCIRX_GPIO 28
#define SFRA_GUI_SCITX_GPIO 29
#define SFRA_GUI_SCIRX_GPIO_PIN_CONFIG GPIO_28_SCIRXDA
#define SFRA_GUI_SCITX_GPIO_PIN_CONFIG GPIO_29_SCITXDA
//
// if the following #define is set to 1 SFRA GUI indicates status on an LED
// otherwise LED code is ignored
//
#define SFRA_GUI_LED_INDICATOR 1
#define SFRA_GUI_LED_GPIO 31
#define SFRA_GUI_LED_GPIO_PIN_CONFIG GPIO_31_GPIO31
.....
//
// configures the SCI channel for communication with SFRA host GUI
// to change SCI channel change #define in the sfra_gui_scicomms_driverlib.c
// the GUI also changes a LED status, this can also be changed with #define
// in the file pointed to above
//
SFRA_GUI_config(SFRA_GUI_SCI_BASE,
SCI_VBUS_CLK,
SFRA_GUI_SCI_BAUDRATE,
SFRA_GUI_SCIRX_GPIO,
SFRA_GUI_SCIRX_GPIO_PIN_CONFIG,
SFRA_GUI_SCITX_GPIO,
SFRA_GUI_SCITX_GPIO_PIN_CONFIG,
SFRA_GUI_LED_INDICATOR,
SFRA_GUI_LED_GPIO,\
SFRA_GUI_LED_GPIO_PIN_CONFIG,
amp;sfra1,
1);
SFRA_GUI_SCI_BASE : this is the base for the SCI that is used for SFRA communication.
SFRA_GUI_SCIRX/TX_GPIO: GPIO pin that are used for the SCI peripheral. These are defined currectly for example on controlCARDS where the FTDI chip is connected for the serial link and it uses GPIO-28 and GPIO-29.
The GUI is setup such that it will blink an LED when GUI has established connection with the host. This LED can be specified in SFRA_GUI_LED_GPIO. Also make sure to change SFRA_GUI_LED_GPIO_PIN_CONFIG appropriately.
Also make sure that the SCI clock is enabled. Clock configuration is typically handled in setupDevice()->Device_init() functions. For powerSUITE solutions, these are in the board.c file.
In a slower task with a service rate of ~ 10 ms, call the following routine to keep the SFRA GUI connection alive. This can typically be kept close to the SFRA Backrground function.
SFRA_GUI_runSerialHostComms(&sfra1);
The project will now connect to the SFRA GUI. For more information on how to run the SFRA GUI, see Section 3.6.