Skip to content

Getting Started

Junaid Jawed Khan edited this page Jul 27, 2020 · 1 revision

Welcome to the vcu-fw wiki!

Please follow the instructions listed below to be able to contribute to this repository.

  1. Always clone develop branch, NOT master.

Reason: The develop branch has a single project with Build Configurations set up for both VCU & the Launchpad, allowing you to clone a single repository, add new code to the project and build for two different target configurations. Follow Step 2 to select the desired Build Configuration settings to be used for your target configuration.

  1. To select the desired Build Configuration:

If you've successfully cloned the develop branch, imported the project to CCS, your CCS window should like the following screenshot: image

Notice in the Project Explorer window, next to the project name, inside first [] it says "Active - Debug" -> This indicates the Build Configuration that will be used for this project when you try to build the project. This is the default build configurations that will be applied to the project.

Building with the "Debug" configuration, the project will not build successfully as the compiler and linker will not know which of the files in the following screenshot to use, you can only build an executable file (.out -> the final binary output file that is flashed to the device) for a single target at a time.

image

The VCU and the launchpad are two different targets and have different architectures (although they belong to the same family of MCUs).

Therefore, to select the correct build configuration for your target, following the steps in the screenshots below:

image

  • If you're using a Launchpad as your target, select "BuildConfig_Launchpad-1224" as your Active Build Configuration.
  • If you're using a VCU as your target, select "BuildConfig_VCU-REV2" as your Active Build Configuration.

With "BuildConfig_Launchpad-1224" set as your Active Build Configuration, CCS IDE will exclude any VCU specific files (Halcogen generated files and the board_hardware.h of VCU) that are in the project from build process, as shown below.

image

Same thing happens when you select "BuildConfig_VCU-REV2" as your Active Build Configuration, CCS IDE will exclude. Launchpad specific files that are in the project from build process.

Now you can begin adding code to the project and build for your target, either VCU or the Launchpad 1224.