NOTICE: The Processors Wiki will End-of-Life in December of 2020. It is recommended to download any files or other content you may need that are hosted on processors.wiki.ti.com. The site is now set to read only.

Running the TCA8418 Demo (CCS)

From Texas Instruments Wiki
Jump to: navigation, search
Construction Icon small.png This page is currently under construction. The content of this page is due to change quite frequently and thus the quality and accuracy are not guaranteed until this message has been removed. Please feel free to contribute to this page while construction is in progress.
MAVRK Banner.png

MAVRK is no longer an active TI evaluation platform. Please contact TI application support if you need further information on TI products or support.

Purpose[edit]

This page describes how to bring up a very simple demo application on the MAVRK system using Code Composer. The application contains code that will allow the MCU to interact with the TCA-8418 keyboard, and the Qt Demo GUI will allow us to see a virtual keyboard in action as we interact with the real keyboard.

What You Will Need For This Project[edit]

In order to run this application, you will need:

  • MSP-FET430UIF - MSP430 USB Debug Interface
  • USB Cable (A to Micro AB) to power the MAVRK Pro motherboard
  • TCA8418 Module
  • Latest version of the Qt Demo GUI

Workspaces and Templates[edit]

Code Composer Studio is a modified version of Eclipse IDE which gathers software together into workspaces. A workspace includes all of the source software necessary to compile together and create one application executable code. This executable code can then be downloaded onto the MAVRK system and run.

The MAVRK software contains a number of Template projects designed to enable the user to rapidly begin development. In general, there are templates available for each separate category of components. These templates contain a workspace that already has a generic working program and most of the files necessary to develop software for that component.

In this case, we will use the TCA8418 Template. Make sure that your TCA8418 module is attached to RF slot 1 on the MAVRK board. The motherboard and module should be assembled like this:

TCA8418 demo.JPG


To begin working on the project, you need to first launch Code Composer Studio.

For Windows CCS the program can be found in Start->Program Files->Texas Instruments->Code Composer Studio #.#.#->Code Composer Studio #.#.#.

If this window related to the Workspace Launcher appears:

Workspace Launcher.jpg


Set the workspace directory to the MAVRK_CCS directory your root directory [C:\] for example C:\MAVRK_CCS.

For more details on what this does visit Selecting the CCS Workspace Directory.

Otherwise, the start window should look like:

Welcome page.jpg


Click on X to close the Welcome Tab to close the window. The resulting Code Composer window should look like:

Editor.jpg


You can then import the project by selecting File -> Import.

CCS File Import.jpg


You should select “Existing CCS/CCE Eclipse Projects” and click “Next”

Import.jpg


We want to choose the “Select search-directory” option and click “Browse” to find the template.

Browse.jpg


The template in question will be located in the MAVRK software under mavrk_embedded\Modular_EVM_projects\Component_Demo_Projects\TCA8418-MVK_Demo_Project

Sel tca demo.jpg

Click "Finish" after you've selected the template.

Initial Project[edit]

The launched project will look like:

TCA Proj.jpg

On the left side, we see a list of folders that will contain the library files and support files necessary to build the application. The main program file is also visible here in TCA8418-MVK_Demo_Main.c

Some basic capabilities of the system:

  • Clicking on the + sign by a folder will expand the folder showing the source files in that folder.
  • Clicking on the - sign of an expanded folder will collapse the folder.
  • Clicking on the + sign for a specific file will show the header files used to compile that source file

Configurations[edit]

Before we begin, we must configure certain settings. In particular, we need to add the predefined symbol “__MSP430F5438A__” to the settings. You can do so by right mouse clicking on "TCA8418-MVK_Demo” and selecting “Properties”

Properties tca.jpg


Once in “Properties” expand the “CCS Build” tab in the left column. Then click on “Predefined Symbols” under “MSP430 Compiler”.

Click on the “Add” icon for “Pre-define NAME” to add a symbol. Type in “__MSP430F5438A__” and click “OK”.

Predefined.jpg

Click “OK” again to save the settings and to quit the window.


Now lets take a look at all the files included in the application. You can open each of the folders to see the files provided in the MAVRK libraries that are used within this system. A majority of the files are used to initialize the system.

Lib files tca.jpg

While that seems like a lot of work, these files contain pre-written functions for you to utilize. The actual user based work for this application is located in the TCA8418-MVK_Demo_Main.c file.

Build Project[edit]

First we have to build the project.

This is done by the “Build Project” option under the “Project” tab. Make sure that your project “TCA8418-MVK_Demo” is highlighted before clicking on “Build” Project”

Build tca proj.jpg

At this point a Console block with build status will appear at the bottom of the Code Compiler Workbench. We can also see in the Problems block the Total Number of Errors and Total Number of Warnings. These should be 0 for a good build.

Zero problems.jpg

Debug and Run[edit]

Now, we are ready to get this thing going. Let’s get the board ready. Make sure the MCU-430F5438A-MVK is installed on the board.

Attach the USB cable from the PC to the USB connector to the left of the JTAG connector at the top of the MAVRK Pro motherboard. This will provide power for the board.

Now that we have power, we can attach the JTAG connector from the MSP430 USB-Debug-Interface to the JTAG slot at the top of the MAVRK Pro motherboard and the other end into a USB slot on the PC.

At this, debug the project by selecting the drop-down arrow on the bug -> Debug As -> Code Composer Debug Session

Debug tca.jpg

The executable file will download and the program will halt at the first step of the main program. We can now hit the Run button to run the program.

Run tca.jpg

Running the Qt Demo GUI[edit]

At this point, the code should be loaded onto your MCU. In order for us to see that the PC is receiving the keyboard signals, we can see a virtual keyboard in action on the Qt Demo App. To get the current Qt Demo App, create a new repository by right mouse clicking in a folder and choosing "Git Clone".

Create repository qt.jpg

Enter "ssh://dlegerr.ext.ti.com:29421/mavrk_qt_tool" into the URL and click OK.

Repository url qt.jpg

We need to switch to the mavrk_prerelease folder and do a pull so that we get the current version of the Qt Demo App. To do so, right click on your repository folder "mavrk_qt_tool" -> TortoiseGit -> Switch/Checkout...

Switch to prerelease.jpg

Now choose the "mavrk_prerelease_dev" branch and click OK.

Branch to prer.jpg

After you do the switch, right mouse click on the "mavrk_qt_tool" folder again and click on TortoiseGit -> Pull...

Pull qt.jpg

Now you should have the latest version of the Qt Demo App. Go to mavrk_qt_tool -> Released Version - QT Demo Application -> mavrk_demo_gui.exe

This should open up the GUI software that looks like this:

Qt demo screen.jpg

Click on a few buttons on the keypad and wait a few seconds. You should see a "Select Device" popup. Click OK.

Sel device qt2.jpg

Now you should see the virtual keypad on your PC. It will copy the actions you make on the keypad module by highlighting the pressed button green.

Keypad demo loaded.jpg


MAVRK Links[edit]

API Documentation[edit]

For a more complete discussion of the various software API functions, please see the MAVRK API Documentation.

I have MAVRK Questions[edit]

MAVRK Forum


I want Info on other MAVRK Software Functionality[edit]

<DPL> category = MAVRK category = Software columns = 3 </DPL>

I want more info on MAVRK[edit]

<dpl> category = MAVRK category = navigation columns = 3 </dpl>

E2e.jpg {{
  1. switchcategory:MultiCore=
  • For technical support on MultiCore devices, please post your questions in the C6000 MultiCore Forum
  • For questions related to the BIOS MultiCore SDK (MCSDK), please use the BIOS Forum

Please post only comments related to the article Running the TCA8418 Demo (CCS) here.

Keystone=
  • For technical support on MultiCore devices, please post your questions in the C6000 MultiCore Forum
  • For questions related to the BIOS MultiCore SDK (MCSDK), please use the BIOS Forum

Please post only comments related to the article Running the TCA8418 Demo (CCS) here.

C2000=For technical support on the C2000 please post your questions on The C2000 Forum. Please post only comments about the article Running the TCA8418 Demo (CCS) here. DaVinci=For technical support on DaVincoplease post your questions on The DaVinci Forum. Please post only comments about the article Running the TCA8418 Demo (CCS) here. MSP430=For technical support on MSP430 please post your questions on The MSP430 Forum. Please post only comments about the article Running the TCA8418 Demo (CCS) here. OMAP35x=For technical support on OMAP please post your questions on The OMAP Forum. Please post only comments about the article Running the TCA8418 Demo (CCS) here. OMAPL1=For technical support on OMAP please post your questions on The OMAP Forum. Please post only comments about the article Running the TCA8418 Demo (CCS) here. MAVRK=For technical support on MAVRK please post your questions on The MAVRK Toolbox Forum. Please post only comments about the article Running the TCA8418 Demo (CCS) here. For technical support please post your questions at http://e2e.ti.com. Please post only comments about the article Running the TCA8418 Demo (CCS) here.

}}

Hyperlink blue.png Links

Amplifiers & Linear
Audio
Broadband RF/IF & Digital Radio
Clocks & Timers
Data Converters

DLP & MEMS
High-Reliability
Interface
Logic
Power Management

Processors

Switches & Multiplexers
Temperature Sensors & Control ICs
Wireless Connectivity