KB 01: Create a PSoC Project using PSoC Creator

Create a New Project

A project contains all the source code and files required to create a single output module that can be downloaded to a target PSoC 5LP device.

Start PSoC Creator

Find the PSoC Creator 4.x icon to launch the tool by using one of the following methods:

• On the Windows desktop, find the PSoC Creator icon and double-click on it.
  
• Launch PSoC Creator from Windows Start Menu.
  
• Use the Windows Start key and type "PSoC Creator" to locate the PSoC Creator, then click on it.

Create New Project

The first step of creating a design is using New Project Wizard to create a new PSoC project. The New Project Wizard will do the following items:

• Select the kit, module, or device
• Select the type of project to create
• Specify the project name and location
• Choose whether to create a new Workspace or add to an existing Workspace

Follows the next steps to open the wizard dialog and configure for a new project:

1. To start a new project, you can either:
   
   • Click the "Create New Project..." link on the PSoC Creator Start Page
   • Click the Create New Project button in the menu bar, or
   • From the File menu and select "New ➤ Project ..." to open the NEW Project Wizard

   

2. In the "Create Project" dialog, you need to select one of the following types of target device:
   
   • Target kit: Use this option to select a specific kit or the last used kit.
   • Target module: Use this option to select a specific module or the last used module.
   • Target device: Use this option to select a device family and series, the last used device, or to launch the Device Selector.
   ......
   
   • If you are using CY8CKIT-059 Kit, and you have installed the design kit file. You can click "Target kit" and select "CY8CKIT-059 (PSoC 5LP)".
     
   • If you did not install design kit file, or you are using another PSoC 5LP development board, you have to click on "Target device:", select chip type to "PSoC 5LP", and select chip family to "CY8C58LP" or "<Launch Device Selector...>". Or, You can select the specific device you want to use.
     
   • If you select "<Launch Device Selector...>", the system will launch the "Device Selector". It will pull up a list of all the various PSoC5LP parts. Find the exact chip number that is used on the PSoC5LP board, click it to highlight the line, and click OK.

     Cypress CY8CKIT-059 Kit

     

     CY8CKIT-059 Kit: CY8C5888LTI-LP097

     EagleSoC Development Board

     EagleSoC Mini Board

     

     You should probably never need to change this again unless you change to use another PSoC development board. PSoC Creator remembers the parts you have used in the past.

3. Next, in the "Select project template" dialog, select an Empty schematic as a project template.
   
4. In the next dialog, you have to enter text for a Workspace name. A workspace is a container for one or more projects. A project is usually contained in a workspace.
   
   • In the Workspace name field, type the name of the Workspace, for example: "PSoC5LP_Lab".
   • In the Location field, type the path where you want the project to be saved, or click and navigate to the appropriate directory.
   • In the Project name field, type the name of your project, for example: "MyFirstPSoC".

   

   PSoC Creator organizes applications into Workspace that can contain one or more projects.

5. Click Finish button, then PSoC Creator will create a new directory in the "Location" field and create a subdirectory for Workspace. In the Workspace subdirectory, the Project directory will be created.
   
6. After PSoC Creator creates all the folders and files, the main windows will show on the screen, and several new panes are displayed: Workspace Explorer, Schematic (TopDesign.cysch), and Component Catalog.
   
   
   • By default, PSoC Creator creates a new workspace containing the new project. Files and folders are added to the Workspace Explorer shown in the Source tab.
   • In the document panel, the Schematic Editor displays the top-level schematic file (TopDesign.cysch).
   • The Component Catalog panel opens to display a list of Components that can be used in your design.

Device Selector

If you change the PSoC development board, or you copy

1. In the Workspace Explorer panel, expand the "Design Wide Resources (.cydwr)" folder and double-click on the Pins to open the Resource file on the Pins tab. You will see the device pin assignments and device number.
   
2. Make sure the device number is the same as the chip number on your PSoC 5LP board. If different, you can click Project from the menu, then choose Device Selector to open the Device Selector dialog.
   
3. On the Device Selector window, click on the device number that is used on your PSoC 5LP board to highlight it, then click OK. After you select the correct device number, you do not need to change it again unless you use a different PSoC 5LP board.
   

Add/Configure Component

In this step, you drag Components from the Component Catalog onto the Schematic. You then configure each Component and wire them together.

1. In the Component Catalog panel, expand the "Digital ➤ Functions" folder and drag a PWM Component onto your TopDesign.cysch.
   
2. Double-click the PWM Component to open the "Configure" dialog, change the Implementation setting to "Fixed Function", and click OK.
   
3. In the Component Catalog, expand the "Digital ➤ Logic" folder, drag a Logic Low '0' Component onto your design, and connect it to the kill terminal on the PWM. Connect another Logic Low '0' to the reset terminal.
   
   
   You can select the Wire Tool  to connect the logic (or press 『w' as a shortcut). The wire is Green, it means that is a digital connection.
   
4. In the Component Catalog, expand the "System" folder, drag a Clock Component onto your design, and connect it to the clock terminal on the PWM.
   
5. Double-click the Clock to open the Configure dialog, change the Frequency value to 250 Hz, and click OK.
   
6. In the Component Catalog, expand the "Ports and Pins" folder, drag a Digital Output Pin Component onto your design, and connect it to the pwm terminal on the PWM.
   

Assign Pins and Connect Hardware

At this point, the hardware design is complete. However, the Pin Component must still be associated with a physical pin.

If you did not assign any pins, after you click Generate Application or Build your project from the Build menu, the PSoC Creator would automatically assign the pin to a physical port/pin on the device. To specify a specific pin, use the Pin Editor to assign the pin for the component.

1. In the Workspace Explorer window, expand the "Design Wide Resources (.cydwr)" folder in your project and double-click on the Pins to open the Design Wide Resource (DWR) Pin Editor.
   
2. Pull down the menu in the Port or Pin column and assign Pin_1 to the following pin, depending on the kit you are used:
   

   Cypress CY8CKIT-059 Kit

   Cypress CY8CKIT-059 kit already has a switch and a LED on the board. The switch is connected to port 2, pin2 (P2[2]), and the LED is connected to port 2, pin 1 (P2[1]). Therefore, for CY8CKIT-059 Kit, you can assign Pin_1 to P2[1] (or Pin 63).

   

   EagleSoC Development Board

   EagleSoC Mini Board

3. You will notice that many pins have some extra text associated with their port/pin information; for example, P1[2] is also labeled as 「XRES[0]:opt」. These are special functions that can be associated with the pin for improved performance rather than mandates that a given pin be used for a specific function.

Generate Application

Before you write the code, you have to let PSoC Creator generate all the necessary API files to support the hardware components that you placed in the schematic earlier. To do that, choose the "Generate Application" item in the Build function.

1. Select the PSoC Creator menu item Build➤Generate Application, or click the icon () on the toolbar.
   
2. If there is no error, PSoC Creator generates several code files under the folder Generated_Source. These are the support files for the components. Do not edit them. They are, in fact, just standard C files, and you could rework them to fit your needs, but the IDE can, and does, frequently regenerate those files, which would wipe out any changes you've made.
   

Write C Code

Add code to the auto-generated file main.c.

1. In the Workspace Explorer panel, double-click the main.c file in your project to open it on the Document window.
2. Add the following function to main():
   PWM_1_Start();

This code assumes that the PWM Component has the default name. If you renamed your PWM Component to something other than the default value, use those names in the _Start() function call.

/* ========================================
 *
 * Copyright YOUR COMPANY, THE YEAR
 * All Rights Reserved
 * UNPUBLISHED, LICENSED SOFTWARE.
 *
 * CONFIDENTIAL AND PROPRIETARY INFORMATION
 * WHICH IS THE PROPERTY OF your company.
 *
 * ========================================
*/
#include "project.h"

int main(void)
{
    CyGlobalIntEnable; /* Enable global interrupts. */

    /* Place your initialization/startup code here (e.g. MyInst_Start()) */
    PWM_1_Start();
    for(;;)
    {
        /* Place your application code here. */
    }
}

/* [] END OF FILE */

Program the Device

The programming process is the same for all the development kit boards.

1. Connect the programmer to your PSoC 5LP development board and plug it into your PC with a USB cable.
3. Confirm the programmer is connected with PSoC Creator through the USB port.
   Select the PSoC Creator menu item Debug ➤ Select Debug Target... A "Select Debug Target" dialog is displayed
   

   CY8CKIT-059 Kit

   EagleSoC Development Board

   EagleSoC Mini Board

4. Click the Program button () in the menu bar.
5. If the Select Debug Target dialog displays, select your device, then click Connect and OK.

PSoC Creator will build your design, generate code, and program the device. When programming is complete, the selected LED on the board will blink; press the Reset button if needed.