Difference between revisions of "Using PSoC Creator"

From uGFX Wiki
Jump to: navigation, search
(Adding µGFX)
(Adding µGFX)
Line 26: Line 26:
 
[[File:psoc_file_structure_01.png]]
 
[[File:psoc_file_structure_01.png]]
  
Next, we need to add the top level uGFX library directory and the driver directory to the compiler include path. This is done in the <code>Build Settings</code> dialog.
+
Next, we need to add the top level uGFX library directory and the driver directory to the compiler include path. This is done in the <code>Build Settings</code> dialog:
  
 
[[File:psoc_build_settings.png]]
 
[[File:psoc_build_settings.png]]
 
[[File:psoc_include_paths_01.png]]
 
[[File:psoc_include_paths_01.png]]
 +
 +
At this stage you have successfully added the µGFX library to an existing PSoC Creator project and you should be able to compile without any errors after including <code>#include <gfx.h></code> and calling <code>gfxInit()</code> in your <code>main()</code> code (if the requirements of the underlying system are met):
 +
<syntaxhighlight lang=c>
 +
#include "gfx.h"
 +
 +
int main (void)
 +
{
 +
    // Initialize hardware and underlying system (if any) BEFORE calling gfxInit()
 +
 +
    gfxInit();
 +
 +
    while(1) {
 +
        gfxSleepMilliseconds(500);
 +
    }
 +
}
 +
</syntaxhighlight>

Revision as of 21:47, 17 August 2016

ILI9341 connected to PSoC 5LP via SPI.

This article will explain how the µGFX library can be added to an existing PSoC Creator project.

Used Tools

The following tools were used to create this guide:

  • PSoC Creator 3.3 CP3
  • PSoC 5LP Prototyping Kit (CY8CKIT-059)

However, this article has been kept as generic as possible and should be usable for any PSoC platform.

Structure

We recommend using the following folder structure:

.
├── Project 1
├── Project 2
├── Project 3
└── ugfx

Adding µGFX

This guide will describe how to add the µGFX library to a PSoC Creator project using the Single-File-Inclusion technique.

The first step is to add the file gfx_mk.c which can be found in the /src directory of the µGFX library directory to the project. Furthermore, we add our configuration file as well.

Psoc file structure 01.png

Next, we need to add the top level uGFX library directory and the driver directory to the compiler include path. This is done in the Build Settings dialog:

Psoc build settings.png Psoc include paths 01.png

At this stage you have successfully added the µGFX library to an existing PSoC Creator project and you should be able to compile without any errors after including #include <gfx.h> and calling gfxInit() in your main() code (if the requirements of the underlying system are met):

#include "gfx.h"
 
int main (void)
{	
    // Initialize hardware and underlying system (if any) BEFORE calling gfxInit()
 
    gfxInit();
 
    while(1) {
        gfxSleepMilliseconds(500);
    }
}