MY FIRST FIVE PSOC® 3 DESIGNS

by Robert Ashby
Copyrights

Copyrights
© Cypress Semiconductor Corporation, 2010. The information contained herein is subject to change without notice. Cypress
Semiconductor Corporation assumes no responsibility for the use of any circuitry other than circuitry embodied in a Cypress
product. Nor does it convey or imply any license under patent or other rights. Cypress products are not warranted nor
intended to be used for medical, life support, life saving, critical control or safety applications, unless pursuant to an express
written agreement with Cypress. Furthermore, Cypress does not authorize its products for use as critical components in life-
support systems where a malfunction or failure may reasonably be expected to result in significant injury to the user. The
inclusion of Cypress products in life-support systems application implies that the manufacturer assumes all risk of such use
and in doing so indemnifies Cypress against all charges.
Trademarks

PSoC Creator™ is a trademark and PSoC® and CapSense® are registered trademarks of Cypress Semiconductor Corp. All
other trademarks or registered trademarks referenced herein are property of the respective corporations.
Source Code
Any Source Code (software and/or firmware) is owned by Cypress Semiconductor Corporation (Cypress) and is protected by
and subject to worldwide patent protection (United States and foreign), United States copyright laws and international treaty
provisions. Cypress hereby grants to licensee a personal, non-exclusive, non-transferable license to copy, use, modify, create
derivative works of, and compile the Cypress Source Code and derivative works for the sole purpose of creating custom soft-
ware and or firmware in support of licensee product to be used only in conjunction with a Cypress integrated circuit as speci-
fied in the applicable agreement. Any reproduction, modification, translation, compilation, or representation of this Source
Code except as specified above is prohibited without the express written permission of Cypress.
Disclaimer
CYPRESS MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS MATERIAL,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PAR-
TICULAR PURPOSE. Cypress reserves the right to make changes without further notice to the materials described herein.
Cypress does not assume any liability arising out of the application or use of any product or circuit described herein. Cypress
does not authorize its products for use as critical components in life-support systems where a malfunction or failure may rea-
sonably be expected to result in significant injury to the user. The inclusion of Cypress' product in a life-support systems appli-
cation implies that the manufacturer assumes all risk of such use and in doing so indemnifies Cypress against all charges.
Use may be limited by and subject to the applicable Cypress software license agreement.

2 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Contents

1. Introducing the PSoC ® 3/PSoC 5 Architecture 5

1.1 Beyond Microcontrollers ..............................................................................................5
1.1.1 Content and Organization ................................................................................5
1.2 Microcontroller Basics..................................................................................................6
1.2.1 The CPU ..........................................................................................................6
1.2.2 Memories .........................................................................................................6
1.2.3 Peripherals .......................................................................................................7
1.3 Features of the PSoC 3 and PSoC 5 Architectures .....................................................7
1.4 Conventions...............................................................................................................13
1.5 Revision History ........................................................................................................13

2. CY8C38xxx Introduction 15
2.1 CY8C38xxx................................................................................................................15
2.2 DVK1 Board...............................................................................................................17
2.3 PSoC Creator™.........................................................................................................18
2.3.1 Workspace Explorer .......................................................................................19
2.3.2 Design-Wide Resources ................................................................................21
2.3.3 Schematic View..............................................................................................21
2.3.4 Source Files and Header Files.......................................................................22
2.4 Example Designs.......................................................................................................22

3. Learn By Example: Blink an LED 23

3.1 Project Overview........................................................................................................23
3.2 Background Information.............................................................................................23
3.3 Project Steps .............................................................................................................24
3.3.1 Starting a New Project....................................................................................24
3.3.2 Adding Components.......................................................................................25
3.3.2.1 Adding a Clock Component .............................................................25
3.3.2.2 Adding a PWM Component .............................................................26
3.3.2.3 Adding a Digital Pin Component ......................................................27
3.3.3 Connecting Components and Chip Resources ..............................................28
3.3.4 Assigning Pins................................................................................................30
3.3.5 Code...............................................................................................................31
3.3.6B:Building and Debugging Your Project.............................................................37
3.4 Conclusions ...............................................................................................................38
3.5 Additional Information ................................................................................................38

4. Learn By Example: UART 41

4.1 Project Overview........................................................................................................41
4.2 Background Information.............................................................................................41
4.3 Project Steps .............................................................................................................42
4.3.1 Adding a New Project.....................................................................................42

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 3

Contents

4.3.2 Adding Components ...................................................................................... 43

4.3.2.1 Adding a Character LCD Component.............................................. 43
4.3.2.2 Adding a UART Component ............................................................ 45
4.3.2.3 Adding a Digital I/O Component ...................................................... 47
4.3.3 Assigning Pins ............................................................................................... 49
4.3.4 Configuring Clocks......................................................................................... 49
4.3.5 Code .............................................................................................................. 51
4.3.6 Building and Debugging Your Project ............................................................ 55
4.4 Conclusions ............................................................................................................... 56
4.5 Additional Information................................................................................................ 57

5. Learn By Example: CapSense 59

5.1 Project Overview ....................................................................................................... 59
5.2 Project Background Information ................................................................................ 59
5.3 Project Steps ............................................................................................................. 60
5.3.1 Adding a Project ............................................................................................ 60
5.3.2 Adding and Configuring a CapSense Component ......................................... 60
5.3.2.1 Configuring the Buttons ................................................................... 60
5.3.2.2 Configuring the Slider ...................................................................... 62
5.3.3 Assigning Pins ............................................................................................... 64
5.3.4 CapSense Code ............................................................................................ 65
5.4 Conclusions ............................................................................................................... 68
5.5 Additional Information................................................................................................ 69

6. Learn By Example: Digital Logic 71

6.1 Project Overview ....................................................................................................... 71
6.2 Project Background Information ................................................................................ 71
6.3 Project Steps ............................................................................................................. 71
6.3.1 Adding a Project ............................................................................................ 71
6.3.1.1 Setting Up Your Project ................................................................... 71
6.3.1.2 Adding and Configuring a Control Register ..................................... 72
6.3.1.3 Using Sheet Connectors.................................................................. 73
6.3.1.4 Adding a Lookup Table.................................................................... 76
6.3.1.5 Adding More Registers .................................................................... 76
6.3.1.6 Adding a Hardware Delay................................................................ 77
6.3.2 Code .............................................................................................................. 79
6.4 Conclusions ............................................................................................................... 88
6.5 Additional Information................................................................................................ 89

7. Learn By Example: Precision Analog 91

7.1 Project Overview ....................................................................................................... 91
7.2 Project Background Information ................................................................................ 91
7.3 Project Steps ............................................................................................................. 91
7.3.1 Adding Components ...................................................................................... 91
7.3.2 Configuring Components ............................................................................... 94
7.3.3 Assigning Pins ............................................................................................... 95
7.3.4 Code .............................................................................................................. 96
7.4 Conclusions .............................................................................................................102
7.5 Additional Information..............................................................................................102

Index 105

4 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 1. Introducing the PSoC® 3/PSoC 5 Architecture

1.1 Beyond Microcontrollers

Cypress and the PSoC® 3 and PSoC 5 architectures of programmable system-on-chip devices set a
new standard for microcontrollers. This new standard is not just a matter of improving upon the com-
petition. It is a dramatic paradigm shift and exists in a class by itself. The PSoC 3 and PSoC 5
devices perform the functions of a basic microcontroller, but they also do much more. You will learn
new ways of solving problems and new methods of accomplishing your design goals. The ability to
design entire analog systems within one chip, coupled with unparalleled flexibility in signal routing
and reconfiguration, creates entirely new possibilities in electronics design.

1.1.1 Content and Organization

This book is a guide to five basic designs:

Blink an LED
Project 1
Set up timing structure and set up basic signal input and output.
UART
Project 2 Set up a link between your project and the computer. Use the computer as an input and out-
put tool to enhance and debug your project.
CapSense®
Project 3
Add CapSense buttons and a slider to your project.
Digital Logic
Project 4
Create a PSoC simulation of the farmer, fox, goose, corn riddle.
Precision Analog
Project 5
Add simple analog processing to your project.

The designs selected for this book provide you with a working foundation. Each project builds upon
the knowledge you learn from the previous project. By the time you finish the Project 5, you will know
about the PSoC CY8C38xxx core, its digital peripheral capabilities, and its analog capabilities. Each
completed project includes interfaces to user input, display, and computer communication. You will
have created an entire system using a single chip and will realize how easy it is to complete these
designs. The Cypress system is perfect for the hobbyist, student, and engineer. The design process
is easy enough for a beginner with minimal experience, and powerful enough to stretch the imagina-
tion of the most seasoned engineer.
Before discussing a few of the features for the PSoC 3 and PSoC 5 architectures, there is a brief
explanation of Microcontroller Basics on page 6. If you have a good working knowledge of microcon-
trollers, you can skip the section.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 5

Introducing the PSoC® 3/PSoC 5 Architecture

1.2 Microcontroller Basics

Cypress uses the phrase programmable system-on-chip to describe the PSoC platform. The
PSoC 3 and PSoC 5 devices are often compared with microcontrollers in relation to other devices in
the industry. The PSoC 3 and PSoC 5 devices function similarly to other microcontrollers and per-
form the same tasks. However, the PSoC 3 and PSoC 5 devices perform functions that are not pos-
sible in many other microcontrollers in the industry. First, however, what is a microcontroller?
If you were to ask several people in the electronics industry to define a microcontroller, you might be
surprised by the varying definitions. This exists because the term microcontroller is used to describe
a wide breadth of devices with very different capabilities and structures. The abilities of microcontrol-
lers have improved dramatically over the years while the prices have dropped. The key to under-
standing what a microcontroller is lies in what these devices have in common rather than how they
differ.
Embedded system is an industry term used for a design with a microcontroller. The term is used
because the various subsystems are embedded within the design itself and are not separate compo-
nents that you need to add. A microcontroller is exactly that. It is a collection of subsystems that are
embedded into a single chip. There are three main subsystems in the classic definition of a micro-
controller:
■ CPU
■ Memories
■ Peripherals

1.2.1 The CPU

The central processing unit (CPU) is the brains of the microcontroller. The CPU has logic that allows
it to decode instructions and move numbers from one location in memory to another. It performs
mathematical operations on those numbers such as shifting bits, adding, and subtracting. Some
microcontroller CPUs are able to multiply and divide numbers. PSoC 3 devices use a very capable
8-bit 8051 CPU. PSoC 5 devices use an even more powerful 32-bit ARM processor.

1.2.2 Memories
The memories in a microcontroller contain both data and instructions. Some microcontrollers, includ-
ing the PSoC 3 and PSoC 5 devices, can interface with memory that is contained in separate
devices. Memories come in two broad categories; volatile and nonvolatile. Volatile memory loses its
contents when power is removed. Nonvolatile memory retains its contents even when power is
removed. In general, volatile memories are much faster than nonvolatile memories. Another differ-
ence between volatile and nonvolatile memories is that all nonvolatile memories wear out. They can
only be erased an rewritten a limited number of times. The endurance value of a nonvolatile memory
is the number of times that it can be erased and programmed without error.
There are three memory types in the PSoC 3 and PSoC 5 architecture: flash, electrically erasable
programmable read only memory (EEPROM), and random access memory (RAM). Flash and
EEPROM are two types of nonvolatile memory. RAM is volatile. Some PSoC 3 and PSoC 5 devices
also have an extended memory interface (EMIF) that allows you to add additional memory to the
device if you need to.
Flash memory is your program memory. You might hear it referred to as read only memory (ROM)
because it holds your program memory. However, you can erase and reprogram flash memory. An
important characteristic of flash memory is that it must be erased in blocks. You cannot erase a sin-
gle byte at a time. This might be seen as a disadvantage compared to other nonvolatile memories if
you are storing small amounts of data. Flash data also has a lower endurance value than some other
types of nonvolatile memory. Wear leveling is a technique that writes the small amounts of data over

6 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Introducing the PSoC® 3/PSoC 5 Architecture

several areas in succession to increase the amount of times that you can rewrite the data without
damaging the flash memory.
EEPROM is also nonvolatile memory. You can erase and rewrite information on a byte-by-byte basis
to EEPROM. The endurance value of EEPROM is much higher than flash. This makes EEPROM
ideal for storing nonvolatile information that needs frequent updates and especially for smaller
amounts of information.
RAM memory holds data during program execution. It is possible in some microcontrollers, including
the PSoC 5 architecture, to copy program memory into RAM and execute that program memory
while still in RAM. The important characteristics to remember about RAM are that you can change its
contents as often as you like and that you can read from and write to RAM very quickly. The endur-
ance value of RAM is high enough that this should not be a concern. RAM is a volatile memory
meaning it does not retain its information during a power loss. There are some newer technologies
that provide nonvolatile storage for RAM, but they are not discussed here.
Note The acronyms RAM and ROM are legacy terms that persist today. The names were given to
early devices and reflect the abilities of that memory at that time. However, the evolution of micro-
controller design has improved the memories. The limitations described by the names are often
defunct. RAM is not the only memory that can be accessed in a random order and not all ROM mem-
ory is read only.

1.2.3 Peripherals
The peripherals in a microcontroller are functions that are performed by the device. Common periph-
erals include I/O ports, analog to digital converters (ADCs), universal asynchronous receiver trans-
mitters (UARTs), timers, pulse width modulators (PWMs), generators, and many others. Peripheral
functionality built within the microcontroller distinguishes a microcontroller from a microprocessor. A
microprocessor (such as the one found in your computer) does not typically include these peripheral
functions, but instead communicates with separate devices that implement the peripheral functions.
A microcontroller contains CPU, memories, and peripherals to create an embedded system.

1.3 Features of the PSoC 3 and PSoC 5 Architectures

Microcontroller companies try to find the magic mix of CPU, memories, and peripherals that wins the
most customers. It is a never ending goal to give users everything that they need while maintaining a
cost effective solution. There are thousands of choices and alternatives in microcontrollers today.
Cypress is not trying to find the perfect mix. Their goal is to give you a flexible controller that you
easily configure into the perfect mix for your specific project, and then you can take that same device
and reconfigure it again with an entirely new mix for an entirely different project. You can take a sin-
gle PSoC device and reconfigure it during run time to perform the needed duties that would normally
require multiple devices. That is when the power of PSoC device configurability really appears.
The PSoC 3 and PSoC 5 architectures provide you with a programmable system-on-chip that excels
in precision analog processing and digital flexibility. The PSoC platform offers 8-bit and 32-bit CPUs.
The architecture of the digital and analog peripherals is the same, giving the user the ability to
choose the device that achieves the needed performance and the best value. The combination of
analog and digital systems on the same chip not only allows you to consolidate your design into a
smaller physical space, but also keeps those sensitive analog signals tight within the device itself.
This secures a new level of noise immunity and environmental stability.
The PSoC 3 and PSoC 5 architectures provide a complete design platform from the ground up for
efficiency and flexibility. The architecture of the platform is similar to a spoked wheel. It consists of a
hub with spokes that all connect to the hub. The hub at the center of the architecture is called the
peripheral hub (PHUB). The PHUB controls the transfer of information on each of the spokes. The
spokes are the advanced high performance bus (AHB) which connects the PHUB to the CPU, mem-

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 7

Introducing the PSoC® 3/PSoC 5 Architecture

ories, and other peripherals in the PSoC. The AHB allows transfers that range from 16 bits to 32 bits
wide, accommodating both the 8 bit and 32 bit CPU options. All transfers on the AHB are initiated by
the CPU or PHUB. The PHUB contains the direct memory access (DMA) controller, allowing the
PHUB to manage transfers of data without any need for CPU interaction. The hub configuration of
the PSoC 3 and PSoC 5 architecture offers some very significant advantages. The separation of the
spokes and the multiple channels of the DMA controller allow simultaneous transfers among devices
on different spokes. This allows for efficient and speedy transfers of data.
The analog system of the PSoC 3 and PSoC 5 architectures features very high precision because of
a very low noise floor and a very accurate reference level. I have not seen the analog capabilities of
the PSoC 3 and PSoC 5 architectures duplicated or matched in any microcontroller, field program-
mable gate array (FPGA), or any other standard device. Embedded systems need analog interfaces
to connect to the outside world. Reading temperatures, playing music, controlling liquid crystal dis-
plays (LCDs), or reading touch pads all require analog processing. The processing of these analog
systems needs more than a simple ADC. These projects require gain stages, filtering, analog output
signals, and special sensing circuitry. The PSoC 3 and PSoC 5 architectures provide this capability
in a single chip.
The analog system includes a sigma delta ADC that is capable of 20 bits of resolution and very fast
conversion times. A full 20 bits of resolution is fantastic. In a 3.3V system, this means that the ADC
reads changes in a signal as small as three millionths of a volt. An ADC with this type of accuracy
depends heavily upon the precision reference and the low noise floor. The noise floor is kept very
low by separating the analog power system from the digital system with the PSoC device itself.
Power and ground can connect together at the same pin on some devices, but they separate at the
bonding pin inside the chip. The internal reference swings less than 0.2% through the device’s volt-
age and temperature range.
The digital filter block (DFB) collects data from the ADC block. The DFB is a small digital signal pro-
cessing (DSP) engine that operates independently from the CPU. The DFB has its own arithmetic
logic unit (ALU), its own hardware multiplier, and its own RAM. The DFB is configured as a single 64
tap filter or as multiple filters with fewer taps, (for example, 4 filters with 16 taps each).
The PSoC 3 and PSoC 5 architectures include uncommitted operational amplifiers, switched cap/
continuous time (SC/CT) blocks, and comparators. All of the blocks, including the SC/CT blocks,
have an operational amplifier inside.
Note I have seen the term switched cap raise uncertainty and quizzical looks. The concept of a
switched cap analog system is to use capacitors and analog switches to transfer charge in a system.
The combination of the switch system and the capacitor acts similarly to a resistor allowing change-
able flexible analog designs.
The uncommitted operational amplifiers are usually configured as unity gain buffers. They can also
route their input and output pins to GPIO, allowing you to add your own components to construct
gain stages, filters, oscillators, and so on. The SC/CT blocks have resistors, capacitors, and
switches that allow you to build gain stages, filters, differential amplifiers, and so on.
The digital to analog converter (DAC) of the PSoC 3 and PSoC 5 architectures operates as either a
voltage DAC or a current DAC. It is the means by which you send the DFB output back out to the
analog domain.
The universal digital blocks (UDBs) are the key to the flexible digital system in the PSoC 3 and
PSoC 5 architectures. The UDB does not stand alone as an entity, but is part of a larger array that
holds all the UDBs in the system. This array structure allows the UDB to interact with other UDB
blocks before consuming resources in the digital systems interface (DSI). The DSI is the connection
that allows the UDB to send and receive signals from the I/O and other fixed function peripherals in
the chip.

8 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Introducing the PSoC® 3/PSoC 5 Architecture

The UDB contains two programmable logic devices (PLDs), a datapath module, and some control
and timing logic (see Figure 1-1).
Figure 1-1. UDB Block Diagram

PLD
Chaining
PLD PLD
Clock 12C4 12C4
and Reset (8 PTs) (8 PTs)
Control

Status and
Control Datapath
Datapath
Chaining

Routing Channel

Each PLD is a logic array that accepts 12 inputs into a group of eight product terms (AND function).
These product terms are summed (OR function) to provide a 4-bit-wide result. The use of PLD logic
does not always have to link to the datapath module within that UDB. It can use other UDBs sepa-
rate from the datapath module in its own UDB. An example of this situation is if the UDB is config-
ured to be an 8-bit timer, then the PLDs are not used for that functionality. In that case, those PLDs
are used for other functions if desired. This allows you to fully use all (some limitations exist) the
logic in the UDB array.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 9

Introducing the PSoC® 3/PSoC 5 Architecture

Figure 1-2. PLD Block Diagram

PT0

PT1

PT2

PT3

PT4

PT5

PT6

PT7
IN0 TC TC TC TC TC TC TC TC
IN1 TC TC TC TC TC TC TC TC
IN2 TC TC TC TC TC TC TC TC
IN3 TC TC TC TC TC TC TC TC
IN4 TC TC TC TC TC TC TC TC
IN5 TC TC TC TC TC TC TC TC AND
IN6 TC TC TC TC TC TC TC TC Array

IN7 TC TC TC TC TC TC TC TC
IN8 TC TC TC TC TC TC TC TC
IN9 TC TC TC TC TC TC TC TC
IN10 TC TC TC TC TC TC TC TC
IN11 TC TC TC TC TC TC TC TC
SELIN
(carry in)

OUT0 MC0 T T T T T T T T
OUT1 MC1 T T T T T T T T
OUT2 MC2 T T T T T T T T
OUT3 MC3 T T T T T T T T

SELOUT
(carry out) OR
Array

The datapath is a collection of logic that is optimized to perform functions such as PWMs, timers,
integrators, counters, cyclic redundancy check (CRC) calculations, and pseudo random sequence
(PRS) generation. The datapath implements an arithmetic logic unit (ALU). The ALU can increment,
decrement, AND, OR, XOR, add, and subtract. The datapath is also able to shift data and perform a
nibble swap. The datapath has six registers that feed into the ALU: two accumulators A0 and A1, two
data registers D0 and D1, and two first in and first out (FIFOs) F0 and F1. The FIFO registers are the
link between the ALU and the system interface.
The datapath is reconfigured cycle by cycle with an eight word by 16 bit configuration RAM. Chang-
ing the address inputs to this RAM alters the sequence of datapath operation. This ability allows the
UDB to perform what Cypress calls time multiplexing. By using the registers and toggling the func-
tion of the datapath from one set of registers to another, you can perform 16-bit functions with one
(8-bit) datapath.

10 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Introducing the PSoC® 3/PSoC 5 Architecture

Figure 1-3. Datapath Module Block Diagram

PHUB System Bus

R/W Access to All

Registers

F1

FIFOs

Conditions: 2 Compares,
Input Output

Detect Overflow Detect

Datapath Control

2 Zero Detect, 2 Ones

F0 Muxes
Muxes
Input from Control Store RAM A0 Output to
8 Word X 16 Bit

Programmable A1 Programmable
Routing 6 6 Routing
D1 D0
D1
Data Registers

D0
To/From To/From
Previous Chaining Next
Datapath Datapath
A1

Accumulators

A0

PI
Parallel Input/Output
(to/from Programmable Routing)

PO

ALU

Shift

Mask

The UDBs are arranged in a row and column format referred to as the UDB array. This allows an effi-
cient means of signal routing between UDBs. Each UDB is paired with another UDB in the same col-
umn. There are 64 I/O lines between these two blocks. These I/O lines connect to the horizontal
channel routes. There are 96 lines in each horizontal channel route. A switch mechanism toggles the
signals from the horizontal channel route to the vertical channel route. There are 32 lines in each
vertical channel route. The vertical channel routes extend beyond the UDBs to connect to the digital
system interface.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 11

Introducing the PSoC® 3/PSoC 5 Architecture

Figure 1-4. UDB Array Structure

Function I/O

Controller

Controller
I/O Ports

Interrupt
Fixed

DMA
DSI Routing Interface

UDB UDB UDB UDB

HV HV HV HV
A B A B

UDB Array Core

UDB UDB UDB UDB

UDB UDB UDB UDB

UDB Pair Tile

HV HV HV HV
B A B A

UDB UDB UDB UDB

DSI Routing Interface

Function I/O
Fixed

I/O Ports

Controller
Interrupt

Controller
DMA

The PSoC 3 and PSoC 5 architectures also include other fixed functions including controller area
network (CAN) bus and USB. This platform offers dramatic improvements to existing designs and
exciting opportunities for new designs that were not previously possible.

12 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Introducing the PSoC® 3/PSoC 5 Architecture

1.4 Conventions
These conventions are used throughout this guide.

Table 1-1. Documentation Conventions

Convention Usage
Courier New Displays source code:
void stateBlinkDecode(void)
Italics Displays file and path names and the titles of reference
documentation:
sourcefile.hex
[bracketed, bold] Displays keyboard commands in procedures:
[Enter] or [Ctrl] [C]
Bold ! With ! Arrows Represents menu paths, user entered text:
File ! New Project ! Clone
Bold Displays commands and selections, and icon names in
procedures:
Click the Debugger icon, and then click Next.
Displays information about situations that have the poten-
Caution: tial to cause data loss or physical damage to equipment,
or both.

1.5 Revision History

Table 1-2. My First Five PSoC® 3 Designs Revision History
Revision/Date Origin of Change Description
** Feb 15, 2010 FSU Initial release of My First Five PSoC 3 Designs
*A June 2, 2010 FSU Updated cover art

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 13

Introducing the PSoC® 3/PSoC 5 Architecture

14 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 2. CY8C38xxx Introduction

2.1 CY8C38xxx
The CY8C38xxx family is built on the PSoC® 3 architecture. The CY8C38xxx devices have an 8-bit
8051 CPU that runs up to 67 MHz. Most instructions take only one or two cycles to complete. The
popularity of the 8051 provides a familiar environment for many experienced programmers. There
are many existing compilers for the 8051 and many free tools and existing code on the Internet that
were designed for the 8051 and can be used for your CY8C38xxx design.
The 8051 in the CY8C38xxx has enhancements and extra features that were not in the original 8051
design. These include an enhanced interrupt controller, instruction cache, and extra pointers. The
enhancements and features allow the 8051 in the CY8C38xxx devices to run faster, with less power,
and reduce your code size compared to the original 8051.
The CY8C38xxx has a single sigma delta ADC. The ADC is capable of a maximum 20 bits of resolu-
tion while maintaining a 110 dB signal to noise ratio. Higher resolution requires longer sampling time.
A conversion of 20-bit resolution can be completed 180 times in a second. Lower resolution conver-
sion happens much faster. A 16-bit conversion can be completed 48 thousand times per second.
Conversions can be started by a software instruction or by the assertion of a Start of Conversion
hardware signal that can be triggered from an external source.
There are various modes for the ADC that allow you to capture a single signal, or several different
signals. The DMA controller allows you to automatically transfer the results of the conversions to the
DFB for filtering. The CY8C38xxx offers a single DFB, but that single DFB can be used to construct
multiple filters.
The CY8C38xxx has up to four of each of the following:
■ Comparators
■ Uncommitted opamps
■ SC/CT blocks
■ Voltage/current DACs
These are configurable to provide various components for pure analog processing without processor
intervention.
The CY8C38xxx offers up to 24 UDBs. The UDBs are configured automatically when you use the
associated components in PSoC Creator™. However, you can also create your own components
using Verilog to configure the digital logic of the UDBs.
The CY8C38xxx features a USB controller and a CAN controller. The USB transceiver provides a
full-speed USB peripheral connection with up to eight endpoints. Configuration of the USB trans-
ceiver is made much easier with a USB wizard tool included in PSoC Creator. The CAN controller
supports the CAN 2.0 protocol and handles all low-level tasks of the CAN transmission including
message separation, CRC checking, CRC calculation, and message buffering.
The CY8C38xxx has up to 62 general purpose input/output (GPIO) pins, eight special input/output
(SIO) pins, and two USB pins.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 15

CY8C38xxx Introduction

The GPIO on the CY8C38xxx allows you to route functions to almost any pin on the device. The
GPIO pins can operate as a digital input, analog input, or digital output. Each GPIO pin can operate
with internal pull up or pull down resistors. They also can operate in a open drain (drive high or drive
low) mode. All pin routing for GPIO functionality is done internally which gives you the ability to lay
out your printed circuit board (PCB) to maximize size, power, and noise immunity with unprece-
dented freedom.
Changing between the different modes of the GPIO pins requires changing values in several regis-
ters. The CY8C38xxx allows a special addressing scheme to write to multiple port configuration reg-
isters in a single write to change the mode of a single pin. This prevents any unwanted intermediate
states that can exist between register writes.
The CY8C38xxx allows GPIO pins to be configured to drive LCD glass directly. LCDs are con-
structed of polarized glass and a liquid crystal layer that is controlled with a voltage to allow or disal-
low light to pass through the filtered glass. The display is changed by placing a voltage potential
across the liquid crystal. When a voltage is placed across the liquid crystal layer, the crystal twists.
This stops light from being seen through that portion of glass. Pretty basic don't you think? The trick
comes in timing and voltage levels. In order to prevent the crystal material from being permanently
twisted, the average voltage across it must be zero. Every element (pixel) on the glass that needs to
be controlled separately requires a method to control that area individually. Pixels are mapped into
groups of rows and columns.
An LCD driver is responsible for applying the voltages to the rows and columns in such a way to
apply voltages to the liquid crystal for the pixels that you want to be on and keep the voltage neutral
on the pixels that you want to be off. At all times it must maintain an average voltage of zero across
all pixels or the LCD can be damaged and stay on. This process requires several voltage levels in
order to work correctly. The voltage levels are different for the rows compared to the voltage levels
for the columns. The rows in our driving circuitry will be referred to as segments and the columns are
referred to as commons. The CY8C38xxx uses a digital to analog converter (DAC) to produce up to
six different voltage levels that generate these voltage waveforms.
Figure 2-1 shows waveforms for two modes of operation with a CY8C38xxx. The LCD drive voltage
level represents the columns or commons. The display data represents a single row or segment. As
you can see, Type A achieves an average of 0 volts across both the segment that is on and the seg-
ments that are off. Note that the off segments still experience a small change in voltage up and down
as the LCD drive voltage level is moving. This voltage level is too small to actually turn on the LCD.
Figure 2-1. A Typical LCD Voltage Waveform
*1:4 Multiplex
Ratio
Type A 1/3 Bias Type B
(2x Type A Data Clock)

1 Frame 1 Frame 1 Frame

LCD Drive
Voltage Level

Display
Data

The CY8C38xxx uses a UDB to generate the clocking signals necessary to switch voltage levels
from the DAC and the segment pins as needed. The UDB also initiates the DMA transactions that

16 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 CY8C38xxx Introduction

move data from the Display RAM area into the LCD driver block so that they can be sent to the
appropriate I/O pins.
Figure 2-2. LCD Configuration Block Diagram

LCD DAC
Global
Clock

UDB

Pin

LCD Driver Block

Display
DMA
RAM

PHUB

2.2 DVK1 Board

The designs in this book have been developed with the DVK1 development kit. The DVK1 is a versa-
tile prototyping board that has LEDs, buttons, a small LCD display, CapSense buttons, an RS232
serial port, and other features that are used in our first five designs. The DVK1 is a generic prototyp-
ing platform that accommodates multiple PSoC devices. It has a socket that accepts a smaller PCB
module that holds the PSoC device. If you do not have a DVK1 board, you can design your own
board or try your hand at breadboard connections. However, you can easily end up spending signifi-
cant time debugging hardware. The DVK1 kit is shown in Figure 2-3 on page 18.
There are I/O headers for ports 1 and 2 around the prototyping area. These ports are common to all
the CY8C38xxx devices. Additional ports are available around the outer edge of the DVK1. There
are some ports (port 12 for example) that are not available on the CY8C38666 device. These ports
are supplied for other processor modules that support port 12.
The CapSense buttons and slider in the PCB have dedicated traces going to the processor module.
The signals are very sensitive, so it is better to have them on dedicated traces than to rely on jumper
wires. The associated port pins are labeled above the CapSense components. Since the buttons
and sliders only present a small amount of capacitance, these I/O pins can be used for other general
applications while the buttons and sliders exist in parallel to the other circuitry on those pins.
There are various jumpers around the board to select different voltages and connections. Refer to
the DVK1 documentation and schematic for a better understanding of these options.
A MiniProg3 is included in the development kit. The MiniProg3 is used as a programmer and debug-
ger. Different settings for debugging require different combinations of pins. We will be programming
using P1[0] and P1[1].

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 17

CY8C38xxx Introduction

Figure 2-3. DVK1 Development Kit

2.3 PSoC Creator™

PSoC Creator is the complete design tool for the CY8C38xxx that allows you to configure the analog
and digital resources within the device. It provides a code editor to write the firmware for your project
and links to your favorite compiler. PSoC Creator also provides programming and powerful debug-
ging tools to finalize your design.
PSoC Creator displays much of its information in web page format. It is highly integrated to the Inter-
net and can automatically retrieve additional help and design examples from the Internet for your
use. When you first invoke the program, PSoC Creator opens to the start page. The start page
allows you to open recent projects, start new projects, check for updates, and build projects based
from reference designs on the Cypress website. PSoC Creator scans your system for development
kits that you have purchased and connected to the computer to customize this view to the hardware
that you have available. The start page also includes links to tutorials, help files, and external
sources of help such as application notes and forums.
There are three basic areas of design for each PSoC project.
■ First, you need to configure system-wide resources, such as clocking, voltage levels, analog ref-
erences, and so on.

18 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 CY8C38xxx Introduction

■ Second, you need to configure the fixed function and configurable analog and digital resources
within the PSoC.
■ Third, you need to write the firmware associated with your project.
PSoC Creator helps you complete these three steps. The process is very simple and will become
second nature to you very quickly. Changes can be made to the design at any time to any of the
three areas. When you generate and compile the project, PSoC Creator will integrate the latest
changes into the completed output file. Navigation through the different areas of your design is made
very simple with Workspace Explorer.

2.3.1 Workspace Explorer

Workspace Explorer is a dockable window that allows quick access to any part of your design. Like
the other dockable windows within PSoC Creator, Workspace Explorer can be docked in various
positions around the PSoC Creator window. Workspace Explorer also offers an autohide feature that
can be toggled on and off by clicking on the push pin icon in the top right of the window. The auto-
hide feature hides Workspace Explorer and leaves a small tab. When you mouse over the small tab,
Workspace Explorer reappears. Each workspace can contain one or more projects. Workspace
Explorer divides the files of each project into three tabs: Source, Components, and Results.
The Source tab shows a tree view of the source and header files that are included in your project.
Double clicking on a file opens that file as a new tab within PSoC Creator for editing. Right clicking
the file allows you to compile that file or change the build settings for that file. The Source tab also
allows you to open the ProjectName.cydwr (Cypress design wide resources) file and the Top Sche-
matic file.
Figure 2-4. The Workspace Explorer Source Tab

The Components tab shows your schematic as the only component by default. You can add addi-
tional components as needed. Components include source files, symbols, and Verilog files. You can
create your own design and then export that design as a component for easy implementation in
future designs.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 19

CY8C38xxx Introduction

Figure 2-5. The Workspace Explorer Components Tab

The Results tab shows a tree view of files generated during the compilation of the project. It includes
important information such as use of analog and digital resources within the device, mapping files,
and the programmable output file.
Figure 2-6. The Workspace Explorer Results Tab

20 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 CY8C38xxx Introduction

2.3.2 Design-Wide Resources

Design-wide resources include clocking signals, interrupts, DMA, and I/O pins. Access the design-
wide resources by double clicking the .cydwr file in the Workspace Explorer. Opening this file allows
you to configure those global resources for the device. Note that you must add appropriate compo-
nents within schematic view before they can be configured in design-wide resources.
Figure 2-7. Design Wide Resources

2.3.3 Schematic View

Schematic view is the visual depiction of what components have been selected within a project and
how they are connected. Access the schematic view by double clicking the .cysch file in the Work-
space Explorer. Drawing the components in a schematic fashion gives a very intuitive view of how
the device is configured. Schematic view allows you to type notes and draw figures next to your
components to help describe the design and its purposes. For more complex designs, you can have
multiple sheets of schematics that describe a single design. Tags allow the connection of compo-
nents between different sheets.
PSoC Creator will configure chip resources to match what you have selected and connected within
schematic view.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 21

CY8C38xxx Introduction

Figure 2-8. Schematic View

2.3.4 Source Files and Header Files

Working with source and header files is similar to other development systems. The PSoC Creator
environment is also the debugging environment so debugging items such as breakpoints are manip-
ulated in the same view as design.
If you want to add source files or header files to your project, you can do so by choosing the New
Item or Existing Item from the Project menu.

2.4 Example Designs

Each of the following five designs are presented in a similar manner. Section one describes an over-
view of the project, the intent of the design, and what will be covered. Section two presents any
background information necessary to understand the processes that we will cover while completing
the design. Section three gives you step by step instructions to complete the project. Later projects
will quickly go beyond areas that have been covered in previous projects. Section four reviews what
was learned during the project and how it may apply to future applications. Section five lists sources
for additional information and possible enhancements that you can add to your project.
The five designs are intended to give you an understanding of what is possible within the PSoC
CY8C38xxx device. The methods used in completing each project will not be the most concise or
even the simplest method possible with the PSoC device. The intent is not to create the smallest
design or even the simplest design. The intent is to show you the flexibility and power of the PSoC
CY8C3xxx family. The designs are purposefully simple and straightforward. I encourage you to study
the applicable sections of the Technical Reference Manual and data sheet while completing the
designs. It is easier to absorb and retain information if you search for answers and additional help
while the questions are fresh in your mind.
Copying code examples from a PDF document is difficult, particularly if the code examples cross
page boundaries. Text flows from page to page may contain invisible control characters and header
and footer information that interfere with the compilation of the code. Also, long lines of source code
that wrap in the PDF may have CR or LF characters in them. Text files containing much of the code
are attached to the PDF for convenience. The code examples in the PDF should be used for refer-
ence only.

22 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 3. Learn By Example: Blink an LED

3.1 Project Overview

This chapter demonstrates how to build a basic project. The project covers three important areas:
input, output, and timing. Tactile buttons are used to change the method of blinking the LED. The
purpose of the task is not to simply blink an LED, but to build a basic timing structure for more com-
plex projects.
The project sets up an 8-bit PWM and generates an interrupt on the terminal count of that PWM.
Software counters and flags within the interrupt routine establish a flexible time base for blinking the
LED and other future tasks.
Each project in this book will build on the resources of the previous projects. It is necessary to com-
plete each chapter in turn in order to have all the resources needed for later chapters. This chapter
describes a more in-depth step by step process of building a project than subsequent chapters.

3.2 Background Information

Blinking an LED is a common first step with any project that uses a new microcontroller or all new
hardware. It allows you to accomplish a simple straightforward task that generally does not require
any special equipment beyond the programmer and development software (assuming that the hard-
ware does not have a problem). Since blinking an LED is a simple project, it is easy to debug and
test. It can also be a powerful tool to debug other parts of hardware on your project. There have
been many times when I have written code for a complex project before hardware was available for
that project. There have also been many times when I have programmed my first code onto these
new projects, flipped the power switch, and had nothing happen at all. If the problem cannot be
found easily, then I will revert back to blinking an LED to give me a foundation to test the rest of the
project.
Task management is a basic part of any embedded design. Different systems manage tasks in differ-
ent ways. This project executes tasks in a periodic fashion. We will create a timing system that
allows tasks to complete every 0.001 seconds, every 0.1 seconds, and every 1.0 seconds. The tim-
ing system consists of a timer that reaches its terminal count and trips an interrupt every 0.001 sec-
onds. Software counters are used to derive the other periods from the millisecond period. We will
use flags to signal to the project main loop that a particular interval has passed.
The method of using flags to signal that an event has happened will let us use that flag elsewhere to
determine when a task should run. If we try to execute the entire task within the interrupt rather than
setting a flag and running the task outside of the interrupt, we will need to limit the task execution
time to the constraints of the timing interrupt. If we try to perform too large a task in an interrupt, we
can experience interrupt overflow and subsequent timing problems.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 23

Learn By Example: Blink an LED

3.3 Project Steps

3.3.1 Starting a New Project
When you first open PSoC Creator, you are taken to the Start Page. The Start Page shows recent
projects, application notes, and design templates. Begin by creating a new blank project.
1. Click on File ! New ! Project to open the dialog box for a new project.
2. Verify that the Design tab is selected and that the Empty PSoC3 Design option is highlighted.
3. Change the name of the project to Chapter3.
4. Change the location of the project if desired. Click the browse button to the right of the Location
text box to browse to a desired folder.
5. Click on the expand button next to Advanced (see Figure 3-1).
6. Change the Workspace name to MyFirstFiveDesigns. This single workspace holds all of the
projects that we are going to do in this book.
7. There is a drop down menu that allows us to select the device that we are going to use for our
project. Since the CY8C3866 is the device included with the DVK1 board, select that device for
this project.
8. The Sheet Template drop down menu allows us to change the formatting of our schematic. The
default selections include a title box around the schematic. Select the Empty option to omit the
title block. Selecting the Launch Sheet Template Selector… option gives a visual example of
each template.
9. The Application Type menu allows you to choose special application types, such as boot load-
able applications. Use the default selection of Normal.
Figure 3-1. Workspace Creation

24 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Blink an LED

10.Click OK.
PSoC Creator generates the associated directories and files needed for your project and opens into
schematic view (see Figure 3-2). Schematic view gives the overall picture of the components you
have selected for your project and how they are connected to other components. You should see
Workspace Explorer to the left of your schematic, the Component Catalog to the right of your
schematic, and the Output window below your schematic. If you do not see all three of these win-
dows, click the View menu and choose the missing window from the menu.
Figure 3-2. Schematic View

3.3.2 Adding Components

This project is very simple so you only need a few components.

3.3.2.1 Adding a Clock Component

1. Locate the Clock component under the System group in the Component Catalog. The Compo-
nent Catalog is found to the right of your blank schematic sheet.
2. Drag the Clock component from the Component Catalog onto the schematic. Controls to zoom
in on your components within the schematic are found under the View menu and in the tool bar at
the top of schematic view.
3. Right click on the Clock component and select Configure from the context menu. The Config-
ure dialog allows you to set up default properties for that component. The Configure dialog can
also be opened for a component by simply double clicking the component.
4. Change the Name of the clock component to clock_PWM (Figure 3-3 on page 26). Pay close
attention to the case of names of the components. The name that you select for each component
is used when the project is built to generate names for the associated application programmer’s
interface (API) calls. The provided code will not work correctly if the names do not match exactly.
5. Change the Desired Frequency to 100 kHz.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 25

Learn By Example: Blink an LED

6. Click OK to close the Configure dialog.

Figure 3-3. clock_PWM Configuration

The Data Sheet button in the Configure dialog opens the data sheet associated with that compo-
nent. The data sheet for any component can also be easily opened by right clicking on the compo-
nent in schematic view and selecting the data sheet from the menu. The data sheet describes the
functionality of the component including available connections and parameters of the component.
The data sheet also includes example source code for that component.

3.3.2.2 Adding a PWM Component

1. Locate the PWM component under the Digital Functions section of the Component Catalog.
2. Click the PWM component and drag it onto your blank schematic sheet.
The PWM will be used for a dual purpose in our project. It allows us to create a quick signal that
will show that the PWM component is up and running and also allows us to interrupt on the termi-
nal count of the PWM to create a timing base.
3. Drag the clock_PWM component so that it connects with the clock input of the PWM compo-
nent. The small boxes at the end of the connection points should disappear when connected
properly (See Figure 3-4).
Figure 3-4. Connecting the Clock to the PWM.

26 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Blink an LED

4. Double click the PWM component to open the Configure dialog (Figure 3-5).
Figure 3-5. PWM_Timer Configuration

5. Set the Name parameter to PWM_Timer.

6. Set the PWM Mode parameter to One Output.
7. Set the Period parameter to 99.
8. Set the CMP Value 1 parameter to 25. This will give us a signal that is on 25% of the time. This
signal will be the source to drive a dim LED for our project.
9. Click the Advanced tab and select an Interrupt on Terminal Count Event.
Since we have set the Period to 99, we will interrupt every 100 (0-99) counts of the clock_PWM. This
divides the 100 kHz input clock to generate a 1 ms interrupt that will be our general purpose timer.
The Configure dialog calculates the 1 ms period. Click the adjustment arrows up and down to exper-
iment with the Period value and observe the changes to the Period calculation. Make sure that the
Period is set to 99 before pressing OK.
There are multiple ways to generate a timed interrupt every millisecond. I chose to use the PWM
component because the PWM output can provide an easy source of debugging information. If I
wanted to observe a internal register value in real time operation, I can copy that value to the CMP
register. If I have a simple LED connected to this register, I can get a rough estimation of the value of
the register by observing the brightness of the LED. If I have an oscilloscope or a good meter with
the ability to measure a duty cycle, then I can get a more exact value of the register value. If I con-
struct a simple low pass filter with a resistor and capacitor connected to the PWM output then I can
get a good estimation of the register value with a simple voltage measurement.

3.3.2.3 Adding a Digital Pin Component

1. Drag a Digital Output Pin component from Ports and Pins folder of the Component Catalog
onto your design. This component allows us to connect the PWM signal output to an I/O pin.
2. Double click the Digital Output Pin to configure it for our project (Figure 3-6 on page 28).

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 27

Learn By Example: Blink an LED

Figure 3-6. PWM_Pin Configuration

3. Change the Name parameter to PWM_Pin.

4. Leave the Type set to Digital Output HW Connection so that this pin is controlled by hardware.
5. On the General subtab, change the Initial State to High (1) and leave the Drive Mode set to the
default Strong Drive.
6. The defaults on the remaining tabs and subtabs are sufficient to drive the LED, but you may want
to look through them to familiarize yourself with the settings there.
7. Leave the Number of Pins parameter set to 1.

3.3.3 Connecting Components and Chip Resources

1. Zoom in close on the two components that you have added.
2. Position the mouse over the small square next to the pwm terminal on the PWM_Timer compo-
nent.
3. Press [w] on the keyboard to draw a wire. The mouse pointer changes to an X when you are over
the small square next to the pwm terminal (See Figure 3-7). Click on the square and then move
to the terminal of the PWM_Pin pin component. Click again on the target and your wire com-
pletes this connection.
Figure 3-7. Connecting the PWM Component to the PWM_Pin

28 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Blink an LED

The PWM_Timer needs an additional logic signal that I want to define rather than route to an exter-
nal I/O pin. The state of this signal is not going to change during our design.
1. From the Digital Logic group, drag an instance of the Logic Low ‘0’ component onto your design.
2. Connect the Logic Low ‘0’ component to the reset terminal of the PWM_Timer.
Your schematic should now look like Figure 3-8.
Figure 3-8. PWM_Pin Connection

1. Errors, Warnings, and Notes are shown in the Notice list. Select View > Other Windows >
Notice List to make sure that you do not have any errors.
If you have any errors go back and review the previous steps to see if you missed something.
2. Verify that the connections between components in your schematic do not overlap and are con-
nected properly.
3. Add an Interrupt component from the Systems group in the Component Catalog.
4. Connect its terminal to the interrupt terminal of the PWM_Timer component. Previously you set
this terminal to generate a signal on terminal count.
5. Rename this component to isr_PWM.
6. Add another Digital Output Pin component from the Ports and Pins group to your design.
7. Double click the pin component and change the Name to LED_Pin.
8. This time the pin is going to be software controlled, so deselect the HW Connection setting on
the Pins Type subtab. As before, the remaining defaults are sufficient to drive an LED.
9. Add a Digital Input Pin component to your design.
This pin is going to be connected to a switch on the DVK1.
10.Rename this component to Button_Pin.
11. On the General subtab of the Pins tab change the Drive Mode to Resistive Pull Up.
12.Set the Initial State to High (1). When you press the button, the pin is grounded and the state
goes low.
Your schematic should now look like Figure 3-9 on page 30.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 29

Learn By Example: Blink an LED

Figure 3-9. Chapter3 Schematic

3.3.4 Assigning Pins

Before you build the project, you must to tell PSoC Creator which pins to use for each of these sig-
nals. PSoC Creator will optimize the routing of internal logic and muxes to minimize resources.
When you are first creating a project, place all the components and connections and examine the
routing PSoC Creator chooses before you create your PCB. Inefficient routing can quickly consume
resources and may even lead to a situation where you do not have enough resources to successfully
complete the needed routing. If you have the flexibility to let PSoC Creator route the signals and then
match your board to that routing, you will be able to benefit from this optimization.
Since our PCB is already defined, we will need to force PSoC Creator to route the pins to match the
connections available on the DVK1 board. You will also need to connect wires from the headers to
the right of the prototyping area to complete the circuit between the I/O pins and LEDs, buttons, etc.
1. Double click on the Chapter3.cydwr (Cypress design-wide resources) file from the Workspace
Explorer.
2. Select the Pins tab at the bottom to show the pin configuration of the project. You will see a
graphic of the CY8C3866 PSoC with a description of the I/O pins and routing results.
3. Select P1[5] for the PMW_Pin, P1[6] for the LED_Pin, and P1[2] for the Button_Pin.
4. From the Build menu, select Build Chapter 3 and verify that you do not have any errors
(Figure 3-10 on page 31).

30 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Blink an LED

Figure 3-10. Pin Assignments

3.3.5 Code
PSoC Creator generates much of the code needed for this project. Open main.c by double clicking
the main.c icon under Source Files folder in the Workspace Explorer. The code needed in the
main.c file is quite concise for our simple project and is included in its entirety.
The first task to be completed upon entering main() is to call the start functions for the different com-
ponents that we have added. The start functions route power to those components and enable their
functionality. The parameters for each component's functions are found in the data sheet for that
component. After initializing the components the main code enters an endless loop that checks flags
to see if a given amount of time has expired since the last iteration of the loop. If the given amount of
time has expired, the endless loop executes the appropriate portion of code and returns to checking
the other time intervals. A simple flow chart depicting this operation is included in Figure 3-11 on
page 32.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 31

Learn By Example: Blink an LED

Figure 3-11. Main Routine Flow Chart

Main() Entry

Initialization of
Components

Has 1 ms Execute code for

passed ? this interval

Has0.1 s Execute code for

passed? this interval

Has 1 s Execute code for

passed? this interval

#include <device.h>
#include "timing.h"

void ToggleLed(void);

/*******************************************************************************
* Function Name: main()
********************************************************************************
* Summary:
* Contains initialization for different components and main loop
*
* Parameters:
* none
*
* Return:
* none
*
*****************************************************************************/
void main()
{
/* Components should be initialized in the following order:
* 1. interrupts
* 2. sources of interrupts (clocks are auto-initialized)
* 3. global interrupt enable
*/

32 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Blink an LED

InitTiming(); /* interrupt */
PWM_Timer_Start(); /* source of interrupt */
CYGlobalIntEnable /* macro */

for(;;) /* main loop - do forever */

{
/* This section contains code to be executed every millisecond */
if(milliSecond)
{
milliSecond = 0U;
} /* end of millisecond section */

/* This section contains code to be executed every tenth second */

if(tenthSecond)
{
tenthSecond = 0U;

/* Toggle the LED if the button is NOT pressed. This will cause
* the LED to blink rapidly when the button is NOT pressed.
*/
if(Button_Pin_Read()) /* read a 1 when button is NOT pressed */
{
ToggleLed();
}
} /* end of tenth second section */

/* This section contains code to be executed every second */

if(oneSecond)
{
oneSecond = 0U;

/* Toggle the LED if the button IS pressed. This will cause

* the LED to blink slowly when the button IS pressed.
*/
if(!Button_Pin_Read()) /* read a 0 when button IS pressed */
{
ToggleLed();
}
} /* end of one second section */
} /* end of do forever loop */
} /* end of main */

/*******************************************************************************
* Function Name: ToggleLed()
********************************************************************************
* Summary:
* Toggles the LED
*
* Parameters:
* none
*
* Return:
* none
*******************************************************************************/
void ToggleLed(void)
{
/* Set the pin to the opposite of what is read from the pin. The pin value

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 33

Learn By Example: Blink an LED

* is always right-justified to the LS bits.

*/
LED_Pin_Write(LED_Pin_Read() ^ 1U);
} /* end of ToggleLed */

In the initialization area of main(), first enable the interrupt by calling InitTiming(). The clock compo-
nent, Clock_PWM, is automatically enabled. To confirm this you can look at the Clocks tab of the
.cydwr file. There is a check in the Start on Reset column. Then call the enable function for the
source of the interrupt, the PWM_Timer component. After starting the PWM_Timer and isr_PWM
components, you enable the global interrupt flag so that the isr_PWM component can be serviced
when the terminal count of the PWM_Timer is reached.
The SW1 button on the DVK1 board will short the SW1 pin to ground when pressed. When you
check the status of the button with Button_Pin_Read() the result will be 0 (or ‘false’) when the
button is pressed, and 1 when it is not. For this reason, (!(Button_Pin_Read()) is true when
the button is pressed.
The final function in main.c file is the toggleLED function. The toggleLED function simply toggles the
state of the appropriate bit in the data register to change the state of the LED_Pin.
One important piece of information to note here is that I am getting the state of the DataReg (data
register) and I am toggling that value before writing it back to the data register. This is the value that
is written to the output latches of the I/O logic. The alternative value you can examine is the value
read from the state of the pin using the PS (pin state) register. An example of reading the PS register
instead of the data register is given here.

CY_SET_REG8(LED_Pin__DR,(CY_GET_REG8(LED_Pin__PS)^LED_Pin__MASK));
I do not recommend using the PS register when you toggle an output because if the pin on that reg-
ister does not currently see the same logic as the DR register, then an incorrect value will be written
back to the DR register. Consider our button component as an example. We have output a high to
the button DR register bit to enable the pull up resistor. However, when SW1 is depressed, the PS
register bit will be a zero. If we were to toggle another bit on that same port using the PS register
instead of the DR register, then we would write a zero to that register. This results in the pull up being
disabled. The project will interpret the SW1 button being pressed even when it is not pressed.
1. Add a file to your project called timing.c.
2. Highlight the Project 'Chapter3'[CY8C3866AXI-40] icon in the Workspace Explorer and right
click on it.
3. Choose New Item from the context menu.
4. Select C File from the list of templates and change the name to timing.c.
5. Pressing OK creates the timing.c file, adds it to the project, and opens that file for editing. Copy
the code below into the timing.c file.

#include <device.h>
#include "timing.h"

/***************************************
* Global Variables
***************************************/
/* event flags for each of the time periods */
uint8 milliSecond;
uint8 tenthSecond;
uint8 oneSecond;

34 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Blink an LED

/***************************************
* Private Functions
***************************************/
/*****************************************************************************
* Function Name: TimerIsr()
******************************************************************************
* Summary:
* An Interrupt Service Routine (ISR) for the pulse width modulator. This
* function is not public. The ISR provides basic timing for all background
* functions. It is assumed that the ISR is called once per millisecond.
*
* Parameters:
* none
*
* Return:
* None. Timing event flags are set.
*
*****************************************************************************/
static CY_ISR(TimerIsr)
{
/* counters for the longer time periods */
static uint8 tenthSecondCount = 0U;
static uint8 oneSecondCount = 0U;

/* Read the PWM status byte to clear the interrupt source. Since function
* calls should not be done from interrupt handlers, the register is read
* directly. Dump the value into a dummy location; we're not interested in
* the value of the register.
*/
(void)PWM_Timer_STATUS;

milliSecond = 1U; /* always set the millisecond global event flag */

/* see if a tenth second has passed */

tenthSecondCount++;
if(tenthSecondCount > 99U)
{
tenthSecondCount = 0U;
tenthSecond = 1U; /* tenth second global event flag */

/* see if one second has passed */

oneSecondCount++;
if(oneSecondCount > 9U)
{
oneSecondCount = 0U;
oneSecond = 1U; /* one second global event flag */
}
}
} /* end of TimerIsr() */

/***************************************
* Global Functions
***************************************/
/*****************************************************************************
* Function Name: InitTiming()
*****************************************************************************/
void InitTiming(void)

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 35

Learn By Example: Blink an LED

{
isr_PWM_Start();
/* set the interrupt's ISR function to be the one in this file */
isr_PWM_SetVector(TimerIsr);
} /* end of InitTiming() */

/*******************************************************************************
* Function Name: TenthSecondDelay()
*******************************************************************************/
void TenthSecondDelay(uint8 count)
{
/* count down every tenth second, and return when counted down to zero */
do
{
while(!tenthSecond){}
tenthSecond = 0U;
count--;
} while(count != 0U);
}/* end of TenthSecondDelay() */

1. Right click on the Project icon in Workspace Explorer and add a New Item.
2. This time select a Header File from the list of templates and name the header file timing.h.
3. Add the following code to the timing.h file.

/***************************************
* Function Prototypes
***************************************/
/*****************************************************************************
* Function Name: InitTiming()
******************************************************************************
* Summary:
* Initializes the timing system, particularly the interrupt component and
* the ISR.
*
* Parameters:
* none
*
* Return:
* none
*
*****************************************************************************/
void InitTiming(void);

/*******************************************************************************
* Function Name: TenthSecondDelay()
********************************************************************************
* Summary:
* Waits for a given delay in tenths of seconds. The actual delay will be:
* count - 1 < actual delay ? count
*
* Parameters:
* uint8 number of tenth-seconds to wait
*
* Return:
* none
*******************************************************************************/

36 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Blink an LED

void TenthSecondDelay(uint8 count);

/***************************************
* Global Variables
***************************************/
/* These timing event flags are set at the corresponding time interval by the ISR.
* It is the responsibility of the background function to reset them before they
* are set again.
*/
extern uint8 milliSecond;
extern uint8 tenthSecond;
extern uint8 oneSecond;

An interrupt service routine for the isr_PWM component exists in the isr_PWM.c file generated by
PSoC Creator. However, we will be using our own interrupt service routine, TimerIsr(), defined in
timing.c. Note the 'CY_ISR' macro that defines that this function is an interrupt service routine. In
the InitTiming() function, after we initialize the interrupt by calling isr_PWM_Start(), we change
the interrupt's vector to point to our routine by calling isr_PWM_SetVector().

3.3.6B: Building and Debugging Your Project

1. Build the project and verify that there are no errors in your project.
2. On the DVK1 development board, connect a wire from P1_5 to the top of LED1.
3. Connect a wire from P1_6 to the top of LED2.
4. Connect a third wire from P1_2 to SW1 (Figure 3-12). SW1 is a momentary, normally open button
that will short the signal to ground when pressed. We have configured our button component to
supply an internal pull up resistor for SW1.
Figure 3-12. Wire Connections

5. Select Execute Code from the Debug menu of PSoC Creator.

6. Alternatively, you can press [F5] or click on the small bug icon from the Build/Debug toolbar.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 37

Learn By Example: Blink an LED

Executing code will build the project if any changes have been made to source files or any config-
uration. It will program the target device and will halt at the main label in main.c.
7. Press the small green arrow on the Debugger toolbar or press [F5] to continue executing code.
You should see a dim light coming from LED1, and LED2 should be flashing at 5 Hz. Pressing on
SW1 should change the blink rate of LED2 to 0.5 Hz.

3.4 Conclusions
This project demonstrated one of many ways to create a periodic interrupt. The method used in this
project allows you to configure system-wide resources, digital logic in the UDB blocks, and I/O pins.
The PWM module created a system that is easy to debug at the most rudimentary levels so that you
have a basis for the other projects in this book. If a project from the other chapters is not working cor-
rectly, make sure that this basic LED functionality is still working. If it is not working correctly, then
make sure to restore that functionality first as it is a requirement for the added features of the other
projects.
The timing flags create a basic task scheduler that can be easily altered to meet different periodic
requirements. The use of timing flags set within a timing interrupt allows the bulk of code execution
to be done outside the interrupt. If execution of a task is very time critical and needs to be able to
interrupt other task execution, that task can be called from within the timing interrupt. Caution should
be taken to make sure that any task execution called from within the timing interrupt does not take
longer to execute than the period of the timing interrupt.

3.5 Additional Information

It is easy to use a single LED to show many different states. The best method depends on your par-
ticular project. I suggest at least two simple methods. The first is to have a continual repeating blink
of a specific period. The current state is defined by the period of the LED. In the example code
below, I have created a blinking LED that is controlled by the routine stateBlink. I have changed the
Pin component name to be LED_Pin2 so that you can add it as a separate component and add this
code to the example above without additional changes. This routine is called every 0.1 seconds and
will give a quick flash of the LED for 0.1 seconds followed by an interval of 0.1 seconds times the
value of state. A state value of zero (0) is indicated by a LED is that always on. A state value of one
shows a blinking LED at a rate of five Hz. A state of nine blinks at one Hz.

/*******************************************************************************
* Function Name: stateBlink
********************************************************************************
* Summary:
* Blinks a specific amount of blinks
*
* Parameters:
* none
*
* Return:
* none
*
*****************************************************************************/

/* state value used for real time debugging */

unsigned char state;

/* Counter for state value blinking */

unsigned char blinkCount;

38 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Blink an LED

void stateBlink(void)
{
/* Check to see if blinkCount has reached zero yet */
if(blinkCount>0)
{
/* If it is not zero, then default the LED off */
LED_Pin2_Write(0);

/* Update the counter */

blinkCount--;
}
/* Come here if blink Count was already zero */
else
{
/* Set this one for one count */
LED_Pin2_Write(1);

/* Initialize the down counter */

blinkCount=state;
}
}

The second recommended method for displaying a state is to use a counter so that the LED is
blinked the amount of times equal to the value of state.

/*******************************************************************************
* Function Name: stateBlinkDecode
********************************************************************************
* Summary:
* Blinks a specific amount of blinks
*
* Parameters:
* none
*
* Return:
* none
*
*****************************************************************************/

/* Constant used in the Additional Information section */

#define BLANKTIME 10

/* Counter for state value blinking */

unsigned char blinkCount1;

void stateBlinkDecode(void)
{
if(blinkCount1>0)
{
/* Decrement blinkCounter */
blinkCount1--;
if((blinkCount1>BLANKTIME)&(blinkCount1%2))
{
/* Turn on the LED; */
LED_Pin3_Write(1);

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 39

Learn By Example: Blink an LED

}
else
{
/* Turn off the LED; */
LED_Pin3_Write(0);

}
}
else
{
/* Turn off the LED; */
LED_Pin3_Write(0);

/* set up for the next round of blinking */

blinkCount1=(state*2)+BLANKTIME;
}
}

This method is simple and straightforward. It becomes more cumbersome as the numbers become
larger. A suggestion for larger numbers is to break the number up into digits. For example, a code of
35 could be shown by a set of three blinks of the LED, a short pause and then a set of five blinks of
the LED. This could be done digitally in the UDBs so that blinking LEDs would not burden the CPU.

40 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 4. Learn By Example: UART

4.1 Project Overview

This chapter demonstrates how to configure a universal asynchronous receiver transmitter (UART)
in the CY8C3866 and use a 2x16 LCD display. The UART provides a communication link between
your project and a computer. To complete this project you will need a computer with a fast COM port
or a USB to RS232 converter. The LCD display is used to display some debugging information.
This project builds on the Chapter3 project. You need to have the Chapter3 project completed and
running before beginning this project. If you want to hurry through the book, you can simply start with
the Chapter3 project and add additional components and code for this chapter to that same project.
I recommend starting over with a new project called Chapter4 and adding new components with the
same settings as you used in the Chapter3 project. Starting over with a new project helps you gain
familiarity with PSoC Creator. You can have several projects within the same workspace. It is possi-
ble to link components from different projects within PSoC Creator but that does create some inter-
dependency considerations that are beyond the scope of this book.

4.2 Background Information

For decades the UART serial communications port has been a basic link to communicate between
the personal computer and external devices. The communication is basic, simple, needs little cir-
cuitry, and requires only two data lines to transmit and receive. Transmission and reception of data
can happen simultaneously since the transmit and receive are on separate pins.
UART communication does not have a clock signal. Each bit is transmitted for a specific length of
time. The designation of bit time is given in the number of bits per second that can be transferred.
This designation is also referred to as baud rate. The baud rate must be determined before commu-
nication starts. Some systems implement algorithms to negotiate the current baud rate from a prede-
termined list by testing a received string of communication at different speeds.
Each byte of communication is framed by a start bit and a stop bit. The start and stop bits are used
to align the data so it can be properly sampled. The UART does allow for some variation in the stop
bit length as well as how many data bits are transmitted at a time. This example uses the setting of
eight data bits and a stop bit length of one.
UARTs continue to be common peripherals in various embedded systems. Recently, the desktop
and computer industry have been removing COM ports from their hardware in favor of USB. The
USB interface is a more complex interface that is much more powerful in its abilities. It can easily
serve as a single transmit and receive datapath to mimic the serial communications port.
The PSoC device can create a USB to UART bridge for your project. The USB2UART component
was not available at the time of publication, so this project will use a basic UART that connects to the
RS232 voltage level translator on the DVK1 board.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 41

Learn By Example: UART

4.3 Project Steps

This project adds to the project from Chapter 3. To maintain independence in all five projects, I am
rebuilding the components from Chapter 3 into a new project called Chapter4. It is a good practice to
close all the open windows before creating the other project so that you do not accidentally change
the wrong file.

4.3.1 Adding a New Project

1. Click File ! Add ! New Project to open the Add New Project dialog box.
2. Enter Chapter4 for the project name.
The Workspace Name is already set to MyFirstFiveDesigns (Figure 4-1). The new project
Chapter4 will be saved in a separate directory under the MyFirstFiveDesigns folder.
Figure 4-1. Chapter4 Project Creation

The advantages of rebuilding each chapter from scratch include the ability to see all five projects in
the same session of PSoC Creator. You can also easily go back to a previous project with the assur-
ance that the older project is not affected by changes made in the new project. You also gain confi-
dence and speed in placing and configuring new components.

42 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: UART

4.3.2 Adding Components

4.3.2.1 Adding a Character LCD Component
1. Add a Character LCD component from the Display group in the Component Catalog.
2. Configure the LCD component to have the name CharLCD and to include the ASCII to number
conversion routines.
3. Open the design-wide resources file (Chapter4.cydwr) and select the Pins tab.
You will notice from the chip graphic that the LCD component requires seven I/O pins. There are
four pins needed for data transfer and three pins for command signals.
4. Select P2[6:0] for the desired pin range for the CharLCD component (Figure 4-2).
This will route bit 0 of the LCD port to P2[0]. The other six pins will be assigned appropriately to
the other bits of port 2 to match the schematic of the DVK1 kit.
Figure 4-2. LCD_Char_1 Pin Configuration

5. Now add two files to your project: display.c and display.h. For now, we will keep the contents of
display.c simple.

#include <device.h>
#include "display.h"

/*******************************************************************************
* Function Name: DisplayWelcome()
*******************************************************************************/
void DisplayWelcome(void)
{
CharLCD_ClearDisplay();
CharLCD_Position(0U, 0U); /* row, column */
CharLCD_PrintString("PSoC Rocks!");
} /* end of DisplayWelcome() */

/*******************************************************************************
* Function Name: UpdateDisplay()
*******************************************************************************/

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 43

Learn By Example: UART

void DisplayCount(uint8 count)

{
CharLCD_Position(0U, 12U); /* row, column */
CharLCD_PrintNumber((uint16)count);
CharLCD_PrintString(" "); /* clear stray text after the number */
} /* end of UpdateDisplay() */

6. Start the CharLCD component in the beginning of main.c and call the welcome screen to verify
that the display is working.

InitTiming(); /* interrupt */
PWM_Timer_Start(); /* source of interrupt */
CYGlobalIntEnable /* macro */
CharLCD_Start(); /* Start the CharLCD component */
DisplayWelcome(); /* Display the welcome message */

The DisplayCount routine will be called every tenth second and will simply show an incrementing
counter.
7. Add this code to the tenth second area of main.c.

/* This section contains code to be executed every tenth second */

if(tenthSecond)
{
tenthSecond = 0U;
/* Toggle the LED if the button is NOT pressed. This will cause
* the LED to blink rapidly when the button is NOT pressed.
*/
if(Button_Pin_Read()) /* read a 1 when button is NOT pressed */
{
ToggleLed();
}

/* Continually update on the display a counter value */

{
static uint8 count = 0U;
DisplayCount(count++); /* will roll over to 0 */
}
} /* end of tenth second section */

The display.h file is needed to make the DisplayWelcome and DisplayCount routines visible to
main.c. Do not forget to include display.h in main.c. The contents of display.h are:

/***************************************
* Function Prototypes
***************************************/
/*******************************************************************************
* Function Name: DisplayWelcome()
********************************************************************************
* Summary:
* Displays a welcome message on the character LCD.
*
* Parameters:
* none
*
* Return:
* none

44 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: UART

*******************************************************************************/
void DisplayWelcome(void);

/*******************************************************************************
* Function Name: DisplayCount()
********************************************************************************
* Summary:
* Prints a count result to the LCD.
*
* Parameters:
* count: the count value to be displayed
*
* Return:
* void
*******************************************************************************/
void DisplayCount(uint8 count);

8. Build and run your project.

You should still have the LED blinking as before and changing with the SW1 button press. You
should also see the phrase “PSoC Rocks!” in the first line of the LCD display with a counter on the
right of the first line counting from 0 to 255 and then starting over. It is very difficult to see information
change much faster than a tenth of a second in an LCD display so we will limit any writing to the LCD
to be at intervals of a tenth of a second.

Note. The code in the millisecond area may not execute every millisecond in this chapter. The func-
tion called in the tenth second area may take longer than 1 millisecond to execute. This is accept-
able in the projects in this book. If you need some code executed every millisecond in your project
and it is based on the projects in this book, you may need to execute that code in the ISR in the tim-
ing.c file.

4.3.2.2 Adding a UART Component

1. Return to the schematic view for the Chapter4 project.
2. Drag a UART component from the Communications group on to your schematic and double
click the component to open the Configure dialog box.
3. Set the Bits per second selection to 115200.
4. Make sure that the Full UART option is selected so that you can both send and receive data with
the UART.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 45

Learn By Example: UART

Figure 4-3. UART Configuration

The other options in the Configure ’UART’ window specify that the UART sends or receives
eight bits of data at a time. We will not be sending a parity bit. The stop bit will be only one bit in
length and there will not be any flow control to this communication. The computer that is con-
nected to this project needs to have the same COM port settings as the UART in the PSoC 3 to
communicate correctly.
Figure 4-4. UART Configuration - Advanced Settings

46 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: UART

5. Click on the Advanced tab in the UART Configure dialog (Figure 4-4 on page 46).
The Clock Selection defaults to Internal Clock. This tells PSoC Creator to configure the internal
clocking distribution system to provide the necessary input frequency to the UART component. If
External Clock is selected, then a clock terminal will appear in schematic view to allow you to
connect a clock signal from another component in your design. The external clock signal needs
to have a frequency eight times the desired bit rate. This faster signal allows the UART compo-
nent to over-sample the incoming data and align the data sampling with the center of each bit
transmitted by another device. This oversampling helps with data integrity and proper error
detection.
6. Clear all selection boxes in the Interrupts section of the Advanced tab.
7. Scroll to the bottom of the Advanced tab and clear the Hardware TX-Enable option.
8. Set the buffer size for RX and TX to 1 (Figure 4-5).
When the buffer sizes for RX and TX are less than or equal to four, the options to enable internal
interrupts for the RX ISR and TX ISR are grayed out. You can enable external interrupts. The
PSoC 3 device implements a 4-byte buffer for RX and TX with the UART component. This
relieves the CPU of the need to manage the UART for every byte sent or received. If you want a
larger than 4-byte buffer, then PSoC Creator will generate the code needed to implement a larger
buffer using interrupts and additional RAM resources to manage that buffer. The calls to read and
write from the buffers are the same regardless of buffer size.
Figure 4-5. UART Configuration - Advanced Settings (continued)

4.3.2.3 Adding a Digital I/O Component

1. Drag a Digital Input Pin component onto the design.
2. Double click the Digital Input Pin component to configure it (Figure 4-6 on page 48).
3. Name the input pin component Rx_Pin.
4. Close the Configure dialog.
5. Connect the Rx_Pin component to the rx input of the UART_1 component.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 47

Learn By Example: UART

Figure 4-6. Rx_Pin Configuration

6. Drag a Digital Output Pin component onto the design and name it Tx_Pin.
7. Connect the Tx_Pin I/O component to the tx port of the UART_1 Component.
8. Add a logic low signal to the reset input of UART_1.
Your schematic should look like Figure 4-7.
Figure 4-7. Chapter4 Schematic

48 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: UART

4.3.3 Assigning Pins

1. Open the Chapter4.cydwr file.
2. Click on the Pins tab.
3. Assign the Tx_Pin to P1[7] and the Rx_Pin to P1[4] as shown in Figure 4-8.
4. Select Build Chapter4 from the Build menu and verify that you do not have any errors.
Figure 4-8. Chapter 4 Pin Assignment

4.3.4 Configuring Clocks

The clock signal for the UART_1 component must be generated from the clocking resources with the
PSoC. PSoC Creator configures the registers as needed to create this clock for you. Click on the
Clocks tab inside the Chapter4.cydwr file to examine how PSoC Creator has configured these clocks
(Figure 4-9 on page 50). The clocks that are in blue are the clocks needed by the components in the
Chapter4 design.
The Clock_PWM that we are using for our main timer is set to be 100 kHz. PSoC Creator decided to
derive this 100 kHz from the IMO (Internal Main Oscillator) which is running at 3 MHz. IMO is listed
as the input clock on the far right column. It sets up a divider 30 to reduce the frequency to 100 kHz.
The divider produces an actual frequency that matches the desired frequency. Therefore, the accu-
racy of the 100 kHz that we desire is only dependent on the accuracy of the IMO frequency.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 49

Learn By Example: UART

Figure 4-9. Clock Configuration

Examine the UART_1_IntClock. The UART_1 component bit rate is set to 115,200 bits per second.
Earlier, we learned that the UART needs to over-sample each bit that is being received so that the
UART can provide good error detection and ensure data integrity. The required clock for the
UART_1 component must be eight times the 115,200 bits per second. This gives us a frequency of
921,600 bits per second. PSoC Creator is showing a desired frequency of 921.600 kHz for the
UART_1_IntClock. However, it is not able to divide any of the available clocks by an integer value to
achieve 921.600 kHz, so it chooses the closest integer possible. The source clock is the master
clock which is running at 24 MHz. PSoC Creator divides this clock by 26 which results in an actual
frequency of approximately 923.077 kHz. That might seem like a large error to be off by more than
1.5 kHz, however, the percentage of error between the actual clock and the desired clock is only
about 0.16%. This error is acceptable for communication with the computer.
You will notice that some of the clocks listed in the light tan area have a ‘?’ listed under the Actual
Frequency column. These frequencies require an external crystal or clock signal which we are not
going to have for this project. The other clocks listed in the light tan area are derived from the internal
clock sources of the PSoC device. Double click in the light tan area to examine this arrangement
(Figure 4-10 on page 51).

50 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: UART

Figure 4-10. System Clocks Configuration

The Configure System Clocks dialog allows you to configure the clocking structure for your PSoC
project. External crystals can provide different frequencies or greater accuracy than the internal
clock. The Master Clock and Bus Clock allow you to set up the overall system frequency to balance
performance requirements and power used. PSoC Creator gives you a very visual picture of how the
configuration is arranged as well as the table format to view this configuration while examining other
clocks that you have added to your design.

4.3.5 Code
1. Create a new file to add to your project called comport.c and add the following content to that file.

#include <device.h>
#include <stdio.h>
#include "comport.h"

/***************************************
* Global Variables
***************************************/
/* flag to indicate LED should be toggled or turned off */
uint8 ledEnabled = (uint8)1;

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 51

Learn By Example: UART

/***************************************
* Private Functions
***************************************/
/*******************************************************************************
* Function Name: ExecuteCommand()
********************************************************************************
* Summary:
* Executes a command based on an input byte. The input byte is expected to
* be an ASCII character.
*
* Parameters:
* thisCommand: the command byte
*
* Return:
* none
*******************************************************************************/
static void ExecuteCommand(char thisCommand)
{
/* An ASCII number character changes the PWM duty cycle */
if (('0' <= thisCommand) && (thisCommand <= '9'))
{
/* Display "PWM xx%", where xx is the number times 10. For example,
* an ASCII '7' results in "PWM 70%".
*/
uint8 temp = (uint8)(((uint8)thisCommand & 0x0FU) * 10U);
char msg[10]; /* leave room for CR, LF and 0 */
sprintf(msg, "PWM %u%%\r\n", (unsigned int)temp);
UART_1_PutString(msg);
/* set the PWM duty cycle to the corresponding value, assumes that the
* PWM period is 100.
*/
PWM_Timer_WriteCompare(temp);
} /* end of if(), i.e. number key */
else /* not a number character */
{
switch(thisCommand)
{
/* An S or G character (either case) stops or starts blinking the
* LED, respectively. Stop also turns off the LED.
*/
case 's':
case 'S':
UART_1_PutString("Stop LED\r\n");
ledEnabled = 0U;
break;

case 'g':
case 'G':
UART_1_PutString("Go LED\r\n");
ledEnabled = 1U;
break;

default:
UART_1_PutString("Unknown Command\r\n");
break;
} /* end of switch(thisCommand) */
} /* end of else, i.e. not a number character */
} /* end of ExecuteCommand() */

52 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: UART

/***************************************
* Global Functions
***************************************/
/*******************************************************************************
* Function Name: InitComPort ()
*******************************************************************************/
void InitComPort(void)
{
UART_1_Start();
/* delay for the UART to initialize */
CyDelay(1LU); /* msec */
UART_1_PutString("My First Five Designs\r\n");
} /* end of InitComPort() */

/*******************************************************************************
* Function Name: UpdateComPort
*******************************************************************************/
void UpdateComPort(void)
{
/* if the UART has a received byte, execute a command based on that byte */
if(UART_1_ReadRxStatus() & (uint8)UART_1_RX_STS_FIFO_NOTEMPTY)
{
ExecuteCommand((char)UART_1_ReadRxData());
}
} /* end of UpdateComPort() */

2. Create a new header file for your project called comport.h and add the following content to that
file. Include this file in main.c.
/*******************************************************************************
* Function Name: InitComPort()
********************************************************************************
* Summary:
* Sets up the UART for operation and sends out a message.
*
* Parameters:
* none
*
* Return:
* none
*******************************************************************************/
void InitComPort(void);

/*******************************************************************************
* Function Name: UpdateComPort
********************************************************************************
* Summary:
* Checks for any received bytes and calls executes commands as needed, based
* on those bytes. It is expected that the received bytes are ASCII characters
* as follows:
* '0' - '9' : set the PWM duty cycle to 0%, 10%, ..., 90%
* 'S', 's' : stop the blinking LED, turning it off.
* 'G', 'g' : start blinking the LED.
*
* In addition to the above actions, a corresponding message is sent out the
* UART transmit. This includes an error message if the received byte is not
* one of the above characters.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 53

Learn By Example: UART

*
* This routine should be called every millisecond.
*
* Parameters:
* none
*
* Return:
* none
*******************************************************************************/
void UpdateComPort(void);

/***************************************
* Global Variables
***************************************/
/* This flag is used to indicate whether or not a command has been received from
* the ComPort to enable or disable the blinking LED.
*/
extern uint8 ledEnabled;

3. Now place the call to intializeComPort in the main routine and place the call to the
UpdateComPort function in the millisecond area as shown below. Don’t forget to include
comport.h.

InitTiming(); /* interrupt */
PWM_Timer_Start(); /* source of interrupt */
CYGlobalIntEnable /* macro */
CharLCD_Start(); /* Start the CharLCD component */
InitComPort(); /* UART component */
......
/* This section contains code to be executed every millisecond */
if(milliSecond)
{
milliSecond = 0U;
/* poll the UART and execute a command if bytes received */
UpdateComPort();
} /* end of millisecond section */
......

The InitComPort call in the beginning of main will both start the UART_1 component and send a
string through that ComPort to your computer. In order to see this message, you will need to have
the computer terminal program running and set to the same parameters as the UART_1 component
when the debugger executes this code. The UpdateComPort is called every millisecond to see if a
character has arrived from the computer, respond to any character received, and send out the
appropriate response. See the ExecuteCommandNote that UART_1_PutString will loop and not
return until all the characters are sent. This may not be desirable for your project, but it is an accept-
able characteristic for our purposes in this chapter.
I have limited the commands in this project to single characters for simplicity. This simplifies the
receive process by removing the need to align to the beginning of a command sequence. If a com-
mand is received that is not understood, it is simply discarded. Commands can easily be sent with
any terminal program, such as Hyperterminal or Tera Term. The number keys will change the duty
cycle of the PWM_Timer PWM output and therefore the brightness of the LED attached to the
PWM_Pin. The S and G commands change the value of ledEnabled. We need to modify the tog-
gleLED function in main.c to utilize ledEnabled. It should toggle the LED if the ledEnabled is a non
zero value and it should shut the LED off if ledEnabled is equal to zero. Here is the modified tog-
gleLED function.

54 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: UART

/***************************************************
* Function Name: ToggleLed()
****************************************************
* Summary:
* Toggles or turns off the LED, depending on an enable state.
*
* Parameters:
* none
*
* Return:
* none
****************************************************/
void ToggleLed(void)
{
/* toggle the LED if it is enabled, otherwise just keep it turned off */
if(ledEnabled)
{
/* Set the pin to the opposite of what is read from the pin. The pin
* value is always right-justified to the LS bits.
*/
LED_Pin_Write(LED_Pin_Read() ^ 1U);
}
else
{
LED_Pin_Write(0U);
}
} /* end of ToggleLed() */

4.3.6 Building and Debugging Your Project

Build the project and verify that it compiles without any errors. Connect the additional pins needed
for the UART (Figure 4-11 on page 56).

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 55

Learn By Example: UART

Figure 4-11. Pin Connections for Chapter4

1. Before downloading the code to the project, connect the computer to the serial port connector on
the DVK1 board
2. Start your terminal program.
3. Download the code to the PSoC and run the program. You should see the message “My First
Five Designs” returned to the terminal window.
4. Press the [S] key on the keyboard to turn off the LED connected to the LEDPin.
5. Press the [G] key on the keyboard. The LED should start blinking again.
6. Press each of the number keys to observe the different duty cycle rates to the LED connected to
the PWM_Pin. The [0] key sets the duty cycle to 0%, which just holds the signal low and turns off
the LED.

4.4 Conclusions
Two-way communication with a PC is a very powerful tool for any embedded designer. A simple
UART connection allows our project to benefit from the rich interface and display capabilities of a
computer. The UART connection can serve as a real-time debugging tool during operation.
The format of communication for the UART makes it a good choice for a part-time debugging tool.
Since the communication does not require a response from the computer in order to continue, you
can leave a computer disconnected with the debugging code active. A computer can be connected
to the project for debugging at any time without restarting the project.

56 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: UART

4.5 Additional Information

The UART remains a favorite serial communication device on many embedded devices today.
Nearly every desktop computer of earlier generations supported two UARTs. They were referred to
as COM ports. The COM port on your computer allowed you a quick connection to all sorts of
embedded devices. The COM ports on those early desktop computers would have a control chip
that handled the serial communications. The most popular serial port control chip in earlier comput-
ers was the National 16550. Similar devices were soon made by other manufacturers. The 16550
included FIFO (First In First Out) buffers for communication that allowed the reception or transmis-
sion of multiple bytes without processor intervention.
There are many reasons why the common UART has remained so popular. First of all, it is a serial
communication so the amount of pins needed to communicate are very low. In fact, most UART
designs that I have done only used two pins: transmit and receive. There are some other pins avail-
able on a computer COM port that can be used to regulate the flow of data. However, for now we will
concentrate on the transmit and receive pins. When you forgo the lines that control that flow of data,
you need to make sure that each side of the communication takes care not to send data faster than
the other side can receive and process the data. Since the transmit and receive lines are separate,
you can be receiving data at the same time that you are transmitting data. This is known as full
duplex communication.
The COM ports on computers follow the RS232 standard. This standard denotes a voltage range
that is higher than most microcontrollers can safely handle. The higher voltages in the specification
allow for a wider range of acceptable voltages on the receiving end. The higher voltages also help
with higher capacitance that becomes a larger and larger problem as the wires get longer. If you
want to follow the voltage standard, you usually need to add a chip to translate the voltages to meet
the specification. However, you can get by with some COM ports by simply using a 5V inverter for
transmitting and a resistor divider for receiving the higher voltages.
In later generations of computers the function of the serial ports that were handled by the 16550
chips were combined with the functionality of the parallel ports into one chip called a super I/O chip.
Later, serial ports started to disappear from computers altogether as USB became the more popular
serial connection to the desktop or laptop computer. The need for UART connectivity did not disap-
pear as fast as the UART disappeared from the typical home computer so a market for USB to Serial
devices grew rapidly to fill that particular need. The popularity of the UART on the microcontroller
has remained strong. The implementation of the UART does not take a tremendous amount of cir-
cuitry and the communication method is basic and straightforward. The implementation also allows
for some error checking.
The communication over the UART is referred to as NRZ (Non Return to Zero) communication. NRZ
communication describes a signal that only has two levels. The idle state of the signal is actually the
same voltage as one of the data values. The two states for the UART signals are called a Space and
a Mark. The Space is a logic zero and is defined in the RS232 protocol from +3V to +25V. The Mark
is a logic one and is defined from -3V to -25V. The space between -3V and +3V is undefined. That
explains why the use of a 5V inverter chip I mentioned above is not going to work all the time as it is
not going negative for its Mark signal and thereby falls out of the RS232 standard's definition for a
Mark.
When no information is being transmitted, the signal line remains in the Space voltage range. When
a byte needs to be transmitted, a Mark signal is sent. This is called a Start bit. The Start bit is fol-
lowed by the least significant bit followed in order until the most significant bit of the byte is sent. The
eighth bit of data is followed by a Stop bit. The PSoC UART also supports the option to send more
than one Stop bit per byte in addition to sending a parity bit to match with desired system require-
ments. The parity bit is for error detection.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 57

Learn By Example: UART

Each data bit in the UART communication including the start bit and stop bit are sent for a specific
time duration. The time duration of each bit needs to be established to interpret the communication.
A device will typically sample the signal several times each bit to be able to center data sampling
towards the middle of the bit time and to verify that the signal is not noisy. The rate bits that are able
to be sent are referred to as bits per second (bps). The number of bits per second can be shown in
thousands of bits per second by the term kilobits per second (kbps), or in millions of bits per second
(Mbps). In order to have successful communication between devices, it is necessary that they all
have a clock that is accurate to within about 2%. This assures that each side can time the communi-
cation correctly. The bits per second describe the transfer rate of data. There is another term that
you may have heard called baud rate. The use of baud rate very often means the bit rate. However,
there are times that the baud rate and bit rate are different. The term baud rate can also specifically
mean the rate at which the state of the transmission signal changes.
The PSoC implementation of the UART is very flexible. Using the clocking system, you are able to
generate virtually every standard baud rate. The UART block supports 7- and 8-bit data transfer with
a configurable number of stop bits to assure compatibility with other systems. If you are only going to
communicate with a local system that is running at the same voltage as the PSoC device, then there
is not a need to get the voltage converter chip to step up to the higher voltages required by the
RS232 standard.

58 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 5. Learn By Example: CapSense

5.1 Project Overview

This chapter demonstrates how to configure the CY8C38xxx to perform capacitive sensing with your
DVK1 PCB. Cypress uses the term CapSense to describe capacitive sensing. The CapSense
project includes two buttons and a slider that are integrated into the DVK1 PCB.

5.2 Project Background Information

CapSense is everywhere from lamps to elevators. CapSense allows a robust detection of the human
finger with a light touch and without any moving parts. Since there are no moving parts, the number
of switch detections is unlimited. The PCB can be fully sealed away from the user’s touch giving the
design complete isolation from the environment including static discharge and contamination of flu-
ids and dirt. CapSense can be used for proximity detection, detecting a finger close to a spinning
blade or potential pinch point. CapSense is ideal for an industrial environment because the switch
never wears out or needs repair. It is inexpensive to implement and can be made in virtually any size
and shape. CapSense is just cool.
CapSense has added a new level in the functionality of consumer electronics. Sliders can be used to
interpolate hundreds of positions from a small number of sensing elements. This ability makes
CapSense ideal for game control, settings adjustments, and fine positioning. CapSense can be
implemented on PCBs, flex circuits, polyester membranes, and touchscreens. A capacitive touch-
screen has much better clarity and durability than a resistive touchscreen. CapSense is capable of
multi touch and gesturing. It can track multiple fingers simultaneously and can interpret movement of
the fingers to add new possibilities to the user interface.
The basic process in capacitive sensing is to measure a change in capacitance that is caused by the
approach of a finger or other conductive object that has the ability to affect capacitance. There are
many different methods to measure this capacitance. Different methods have different strengths and
weaknesses in areas such as sensitivity, speed, and immunity to noise. Even though any conductive
object may be sensed, I refer only to sensing a finger in this chapter.
This chapter implements two buttons and a slider. The CapSense area of the DVK1 is directly below
the prototyping area and includes the label CAPSENSE in the white silkscreen lettering on the PCB.
P0_5 and P0_6 are CapSense buttons. The buttons indicate whether a finger is present or not. The
slider area, P0_0 to P0_4, gives us a linear position of the finger on the slider area. There are only
five signals here that are sensed by the PSoC device. The CY8C38xxx interpolates your finger's
position relative to the five sensors using the amount of change in capacitance. It can thereby derive
100 positions from only five sensors.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 59

Learn By Example: CapSense

5.3 Project Steps

5.3.1 Adding a Project
1. Create a new project in your workspace called Chapter5. Since this is just a test project for
CapSense there is no need to recreate the work done in Chapters 3 and 4.
2. Add a CharLCD component as was done in Chapter 4.

5.3.2 Adding and Configuring a CapSense Component

1. Add a CapSense component by dragging the component from the Component Catalog under
the CapSense group to your design.
2. Double click on the CapSense_1 component to open the Configure dialog.
3. On the General tab, type in CapSense for the Name, Serial for the Configuration, and IDAC
Sourcing. PRS should be None (see Figure 5-1).
Figure 5-1. CapSense Configuration General Tab

4. Select the Clock Source tab and set the Prescaler to UDB and the CPS_CLK to BUS_CLK: 24
MHz.

5.3.2.1 Configuring the Buttons

1. Select the Buttons tab and create two buttons. To create a button, type the name of the button in
the box next to the asterisk symbol and press the Apply button.
2. Name the buttons P0_5 and P0_6 for easy reference to the DVK1 board (Figure 5-2 on page 61).

60 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: CapSense

Figure 5-2. CapSense Configuration Buttons Tab

3. After you have created the two buttons, click on each button in turn and set the Debounce to 5,
the Hysteresis to 5, the Finger Threshold to 75, and the Noise Threshold to 10 (Figure 5-3).
Figure 5-3. CapSense Buttons Threshold

The capacitance measurement on the circuit is a very sensitive measurement. The circuit is sensi-
tive to changes in temperature, humidity, voltage, and so on. The capacitive system must be tuned
and adjusted for the board layout and the environment that it is in. The numbers that you are adjust-

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 61

Learn By Example: CapSense

ing for the button relate to how much expected variance there is in the capacitive measurement.
Each time your finger approaches the circuit, capacitance increases because the capacitance of
your finger with respect to circuit ground is in parallel with the sensing I/O pin with respect to circuit
ground.
Figure 5-4. Cross Section of a Capacitive Sensor

The code establishes a baseline measurement. The baseline value is the value of capacitance mea-
sured when no finger or object is present. This number is subject to some natural variance from
reading to reading as well as a drift in average measurements due to changing environmental condi-
tions. If the increase in a reading compared to the baseline is less than the noise threshold, then the
baseline is adjusted by a percentage of that change to compensate for changing environmental con-
ditions.
If the new reading is above the finger threshold, then the debounce counter starts to count. If the
counter is incremented by the value of Debounce, then the finger is declared to be present. There is
an adjustable Hysteresis value around the finger threshold to handle small deviations above and
below the threshold.

5.3.2.2 Configuring the Slider

1. Click on the Sliders tab.
2. Type Slider0 into the box next to the asterisk and press the [Enter] key.
3. Set the Type to Linear.
In both types of sliders, the adjacent sensing elements are examined and a centroid, an interpo-
lation of where the finger is centered, is calculated based on the relative strength of signal in the
adjacent elements. In a radial slider, the first element is adjacent to the last for centroid calcula-
tion.
4. Change the Number of Elements to 5.
5. Set the Resolution to 100.
6. The DVK board does not use diplexed sliders, so leave Diplexing unchecked.
7. Press the [Enter] key to set the slider.

62 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: CapSense

Pressing the Enter key enters the information and selects the next item. When you are in the last
column pressing the Enter key completes the current line and takes you to the beginning of the
next line.
8. Click on the name Slider0.
9. Verify that the Filters Configuration items are all set to Disabled.
10.Set the Finger Threshold to 30 and the Noise Threshold to 10 (Figure 5-5).
Figure 5-5. CapSense Slider Configuration

11. Click on the Scan Slots tab (Figure 5-6 on page 64).
12.Select the Custom box for each of the buttons and slider elements, and set the Prescaler
Period to 11, Resolution to 10 bits, IDAC range to 2, Scan Speed to Normal, and the IDAC
Setting to 127.
13.Press OK.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 63

Learn By Example: CapSense

Figure 5-6. CapSense Scan Slots Configuration

5.3.3 Assigning Pins

1. Assign the pins for the CapSense elements in the design-wide resources file (Figure 5-7 on
page 65).
2. The Alias name sCmod is for a capacitor that must be added to your design. If you look at the
schematic of the CY8C38 Family Processor Module you will see that a 2200 pF capacitor (C18)
is included on the processor module for use as the CMOD capacitor. It is attached to pin P2_7 on
the processor module. Choose pin P2[7] for sCmod.
3. The other pin assignments follow the port numbers as seen on the white silkscreen text of the
DVK1 PCB in the CapSense area.

64 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: CapSense

Figure 5-7. CapSense Pin Assignments

5.3.4 CapSense Code

1. Create a new .c file in your project called myCapsense.c.
2. Copy the following code into the myCapsense.c file.

#include <device.h>
#include "myCapsense.h"

/***************************************
* Global Functions
***************************************/
/*******************************************************************************
* Function Name: InitCapSense()
*******************************************************************************/
void InitCapSense(void)
{
/* Components should be initialized in the following order:
* 1. interrupts
* 2. sources of interrupts (clocks are auto-initialized)
* 3. global interrupt enable
*/
CapSense_Start(); /* interrupt and source of interrupt */
CYGlobalIntEnable /* macro */

/* set up baseline values for all buttons and slider */

CapSense_CSHL_InitializeAllBaselines();
} /* end of InitCapSense() */

/*******************************************************************************
* Function Name: UpdateCapSense()
*******************************************************************************/
void UpdateCapSense(void)
{
/* Scan all buttons and slider */
CapSense_CSD_ScanAllSlots();
/* update baseline values for all buttons and slider */

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 65

Learn By Example: CapSense

CapSense_CSHL_UpdateAllBaselines();
} /* end of UpdateCapSense() */

/*******************************************************************************
* Function Name: GetButtonP0_5()
*******************************************************************************/
uint8 GetButtonP0_5(void)
{
return CapSense_CSHL_CheckIsSlotActive((uint8)CapSense_SCANSLOT_BTN_P0_5);
} /* end of GetButtonP0_5() */

/*******************************************************************************
* Function Name: GetButtonP0_6()
*******************************************************************************/
uint8 GetButtonP0_6(void)
{
return CapSense_CSHL_CheckIsSlotActive((uint8)CapSense_SCANSLOT_BTN_P0_6);
} /* end of GetButtonP0_6() */

/*******************************************************************************
* Function Name: GetSlider()
*******************************************************************************/
uint8 GetSlider(void)
{
return (uint8)(CapSense_CSHL_GetCentroidPos((uint8)CapSense_CSHL_LS_SLIDER0));
} /* end of GetSlider() */

3. Create a header file called myCapsense.h and include the following in that file.

/*******************************************************************************
* Function Name: InitCapSense()
********************************************************************************
* Summary:
* Initializes the CapSense component for the DVK.
*
* Parameters:
* none
*
* Return:
* none
*******************************************************************************/
void InitCapSense(void);

/*******************************************************************************
* Function Name: UpdateCapSense()
********************************************************************************
* Summary:
* Scans slots and updates baselines for the CapSense component for the DVK.
*
* Parameters:
* none
*
* Return:
* none

66 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: CapSense

*******************************************************************************/
void UpdateCapSense(void);

/*******************************************************************************
* Function Name: GetButtonP0_5
********************************************************************************
* Summary:
* Reports if a finger is present or not at DVK button P0_5.
*
* Parameters:
* none
*
* Return:
* 1 if finger is present, 0 if finger is not present
*******************************************************************************/
uint8 GetButtonP0_5(void);

/*******************************************************************************
* Function Name: GetButtonP0_6
********************************************************************************
* Summary:
* Reports if a finger is present or not at DVK button P0_6.
*
* Parameters:
* none
*
* Return:
* 1 if finger is present, 0 if finger is not present
*******************************************************************************/
uint8 GetButtonP0_6(void);

/*******************************************************************************
* Function Name: GetSlider
********************************************************************************
* Summary:
* Reports the presence / position of a finger on the DVK slider.
*
* Parameters:
* none
*
* Return:
* Position 0 - 100 if finger is present, 0xFF if finger is not present
*******************************************************************************/
uint8 GetSlider(void);
A CapSense project must follow a basic pattern to sense the presence of a finger. First, the
CapSense component must be started, which also starts a clock and an interrupt associated with the
component. Then, after global interrupts are enabled, the baselines must be established. This is
done by calling the InitializeAllBaselines routine. After the baselines are initialized, periodically call
the ScanAllSlots and UpdateAllBaselines routines. The call to ScanAllSlots will read and save the
current capacitive measurement on each of the I/Os configured for CapSense. The UpdateAllBase-
lines routine will use the new capacitive measurements to determine the new baseline values for
each sensor.
The code in main.c implements both the initialization and periodic updating of the ScanAllSlots and
UpdateAllBaselines call. Do not forget to #include myCapsense.h in main.c.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 67

Learn By Example: CapSense

void main()
{
/* Components should be initialized in the following order:
* 1. interrupts
* 2. sources of interrupts (clocks are auto-initialized)
* 3. global interrupt enable
* This is all done in the following function:
*/
InitCapSense();

/* Print some label information on the LCD */

CharLCD_Start();
CharLCD_Position(0U, 0U); /* row, column */
CharLCD_PrintString("P05 P06 Slider");
for(;;) /* main loop - do forever */
{
/* Scan and update baselines for all buttons and slider */
UpdateCapSense();

/* report button P0_5 */

CharLCD_Position(1U, 0U); /* row, column */
CharLCD_PrintString(GetButtonP0_5() ? "On " : "Off");

/* report button P0_6 */

CharLCD_Position(1U, 5U); /* row, column */
CharLCD_PrintString(GetButtonP0_6() ? "On " : "Off");

/* report slider position, as a hex value */

CharLCD_Position(1U, 12U); /* row, column */
CharLCD_PrintInt8(GetSlider());
} /* end of do forever loop */
} /* end of main() */

The code in the main() routine uses the CharLCD to feed back the results of the capacitive sensing.
1. Compile and run your project. The code in main() displays labels on the first row of the LCD dis-
play corresponding to each element in the CapSense component. The result of each scan is dis-
played below the label.
2. Verify that your finger is detected properly by placing your finger in turn on each element. Notice
that the slider element returns an 0xFF when the finger is not present on the slider. It returns the
position 0x00 - 0x64 (0-100) when the finger is present. The position range is the Resolution
value set up when the Slider was defined - see Figure 5-5 on page 63.
We will reuse the code in myCapsense.c in later designs so that the buttons and slider can be used
in those designs. For now we have successfully added CapSense buttons and verified that they
work.

5.4 Conclusions
The PSoC platform makes capacitive sensing easy while still giving you full power to adjust and
modify the firmware. Capacitive sensing does not need to involve a separate microcontroller or
ASIC. It is available on the same chip using the same design resources. Cypress offers powerful
tools to help you tune your design and provides extreme flexibility in routing the CapSense signals to
the pins needed by your design criteria.

68 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: CapSense

Since capacitive sensing is done directly on the PSoC device, tuning the capacitive sensing can take
advantage of all the capabilities of the device. Debug information can be sent out of a communica-
tions port, logged for later investigation, or combined with other readings to make more complex
decisions.

5.5 Additional Information

Before beginning any production capacitive sensing project, and to ensure that your design works
the first time, visit Cypress.com and read through the application notes that describe PCB layout
guidelines, sensor design, and other general capacitive sensing design practices. Check the
Cypress website for the latest tools in tuning capacitive sensing. Newer tools can save you a lot of
time trying to tune your circuitry.
Take note that capacitive sensing can consume some of the analog resources. Always lay out the
necessary components of your design as soon as possible in PSoC Creator to make sure that you
have enough resources to complete your project. Configure the components and route all the sig-
nals, even if you do not have any firmware to verify that your design is feasible in the PSoC device
that you have selected.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 69

Learn By Example: CapSense

70 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 6. Learn By Example: Digital Logic

6.1 Project Overview

This chapter demonstrates the ability to add various digital logic elements into a design. The digital
logic will be used to create a state machine for the riddle Farmer, Corn, Goose, Fox.

6.2 Project Background Information

We will add digital logic elements to our design to create a state machine based around the riddle
Farmer, Corn, Goose, Fox. The riddle describes a farmer with some corn, a goose, and a fox who
needs to get all of these across a river. There is a boat for the farmer to use, but the farmer can only
fit one item with him on the boat to cross the river. He cannot leave the goose with the corn or the
goose will eat the corn. He cannot leave the fox with the goose, or the fox will eat the goose. You
need to determine what order the farmer must use to take all the items to the other side of the river.
There are seven steps that must be taken to get across the river. The logic will decode what step you
are on, if an error condition occurs, and when you have successfully completed the task.
My first experience with the Farmer, Corn, Goose, and Fox riddle was at Utah State University. The
assignment was to construct a circuit that modeled the riddle almost entirely out of two input NAND
gates. This solution took up two full bread boards with a rat’s nest of wires. This experience helped
build appreciation for more powerful logic and finally microcontrollers. The application of the Farmer,
Corn, Goose, and Fox riddle in this chapter implements the solution using a lookup table (LUT) for
the main comparison on inputs and uses some more simple logic for error checking.

6.3 Project Steps

6.3.1 Adding a Project
1. Create a new project in your workspace called Chapter6.
2. Recreate all the components and code added in Chapters 3 and 4. We aren’t going to use the
CapSense buttons in this chapter, so there is no need to duplicate the code in Chapter 5.

6.3.1.1 Setting Up Your Project

3. Before starting this implementation of logic, create a new page in the schematic to provide more
room to place your logic components.
4. Right click on the Page 1 tab at the bottom of the schematic and select Add Page. This creates a
Page 2 in the schematic.
5. Right click on the newly created Page 2 tab and select Rename Page.
6. Type in Digital Logic for the new page name.
7. Click on the letter T at the left of the schematic page to select the text tool. Note that you can also
simply press the [t] key on your keyboard to select this tool.
8. Click and drag in the schematic to form a text box.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 71

Learn By Example: Digital Logic

9. Type the following text into your box (Figure 6-1).

Step 0 - Farmer, Corn, Goose, Fox = 0
Step 1 - Corn, Fox = 0 & Farmer, Goose = 1
Step 2 - Farmer, Corn, Fox = 0 & Goose = 1
Step 3 - Fox = 0 & Farmer, Corn, Goose = 1
Step 4 - Farmer, Goose, Fox = 0 & Corn = 1
Step 5 - Goose = 0 & Farmer, Corn, Fox = 1
Step 6 - Farmer, Goose = 0 & Corn, Fox = 1
Step 7 - Farmer, Corn, Goose, Fox = 1
These are the steps that we are going to follow to solve the riddle. Each of the four items will be
represented by a bit of logic. A value of 0 for an particular bit means that object is on the near
side of the river. Likewise, a value of 1 for a bit means that item is on the far side of the river. I
have not allocated a bit for the boat since the boat must always reside on the same side as the
farmer. There is more than one solution for this riddle, but I am only implementing this solution for
simplicity. If you do not follow the steps as described above, then the logic rejects the answer.

Figure 6-1. Blank Digital Logic Schematic Page

6.3.1.2 Adding and Configuring a Control Register

The logic in the PSoC can be routed to external pins, but I have chosen to control and sense the
state of the logic using control and status registers. The control and status registers allow software
access to hardware signals within the PSoC. The use of registers allows us to use this logic without
any additional connections to the DVK1.

72 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

1. Add a Control Register to your project from the Digital-Registers group of the Component Cat-
alog.
2. Double click the Control Register and configure the Name to be Control_Reg_NextStep.
3. Change the NumOutputs variable to 4. This is the driving value that puts items on one side of
the river or the other. Each of the four bits represents one of the items in our riddle (Figure 6-2).
Figure 6-2. Control Register Configuration

6.3.1.3 Using Sheet Connectors

1. Place a Sheet Connector on the design. This is done by selecting the diamond-shaped Sheet
Connector at the left of the schematic window or by pressing the s button in the schematic.
2. Connect bit 0 of Control_Register_NextStep to the Sheet Connector with a wire.
3. Rename the wire attached to the sheet connector by right clicking on the wire and selecting the
Edit Name and Width option.
4. Clear the check mark to Use computed name and width.
5. Enter Farmer for the Name and verify that the Indices option is set to None (Figure 6-3 on
page 74).

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 73

Learn By Example: Digital Logic

Figure 6-3. Signal Name Configuration

The Sheet Connector component allows you to connect signals from different schematic pages. It
also allows you to connect signals on the same page that are not otherwise visibly connected. This is
going to help us organize the visual appearance of the logic devices. Without the Sheet Connectors,
it can be hard to follow the wire connections that cross (Figure 6-4 and Figure 6-5 on page 75).
6. Drag the name Farmer and place it on top of the wire. Figure 6-5 on page 75 gives you an idea of
what type of layout I am expecting to use.
7. Continue to add Sheet Connectors for the remaining three bits. Name these wires Corn,
Goose, and Fox in that order.
As you can see in Figure 6-5 on page 75. I have added two other text boxes to remind me of the
order of bits as they relate to the Control_Reg_NextStep and the LUT.

74 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

Figure 6-4. Disorderly Logic

Figure 6-5. Orderly Logic

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 75

Learn By Example: Digital Logic

6.3.1.4 Adding a Lookup Table

1. Add a Lookup Table to your project from the Digital group.
2. Name the Lookup Table LUT_Riddle.
3. Change the number of inputs to 4 and the number of outputs to 4.
In the table you need to set up the logic that will equate each step number with the appropriate
input states. Using the text description of each step added to the project, we can fill in the table
accordingly.
4. Enter 0x0F for each value that does not correspond to a step. The entries are given in order here:
0x00, 0x0F, 0x04, 0x0F, 0x02, 0x01, 0x0F, 0x03, 0x0F, 0x0F, 0x06, 0x05, 0x0F, 0x0F, 0x0F,
0x07 (Figure 6-6).
5. Connect the Farmer, Corn, Goose, and Fox sheet connectors to the LUT_Riddle inputs.ww
Figure 6-6. LUT Output Values

6.3.1.5 Adding More Registers

1. Add in another Control Register component named Control_Reg_Clock.

76 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

2. Configure Control_Reg_Clock to be one bit only.

3. Connect it to a Sheet Connector and name the wire clock.
4. Add a Status Register.
5. Name the Status Register Status_Reg_CurrentStep and configure it to have four inputs.
6. Connect the clock wire to the clock input terminal of Status_Reg_CurrentStep.
The clock input is needed for a status register to indicate when the status register should sample
the input terminals. We are going to use a Control_Reg_Clock to create a manual clock signal.
7. Connect the inputs of Status_Reg_CurrentStep to the outputs of LUT_Riddle.
8. Place Sheet Connectors on each of the wires connecting LUT_Riddle and
Status_Reg_CurrentStep.
9. Name the wires step, but use the Bit option for the Indices in the wire configuration dialog to
indicate whether it is bit 0, bit 1, bit 2, or bit 3 (Figure 6-7).
Figure 6-7. Clock and CurrentStep Registers

The LUT_Riddle compares each state of the Farmer, Corn, Goose, and Fox to see which step of the
riddle it is on. If the step is undefined, then the output of the LUT is 0x0F. Since there is not a clock
input for the LUT_Riddle, the output pins of the LUT change immediately after the input signals
change. Note, however, that the value of Status_Reg_CurrentStep does not change until I pulse the
Control_Reg_Clock value. Therefore, the process to progress to the next step in the riddle requires
me to first write to Control_Reg_NextStep and then set and clear the bit in Control_Reg_Clock. After
completing those two steps, I will have the current step value in the Status_Reg_CurrentStep regis-
ter.

6.3.1.6 Adding a Hardware Delay

We can add a hardware delay into our logic state machine with D Flip Flops from the Digital Logic
group of the Component Catalog.
1. Add four D Flip Flops to the schematic.
2. Add a Sheet Connector to the left of one of the flip flops. Connect this sheet connector to the
clock input of a flip flop and name the wire ‘clock’. By naming the two wires attached to sheet
connectors the same you connect them logically.
3. Connect the clock wire signal to each of the other flip flops’ clock inputs.
4. Add Sheet Connectors and connect one from each the step[0]-step[3] signals to a D Flip Flop
data (d) terminal.
5. Add another Status Register to the right of the D Flip Flops.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 77

Learn By Example: Digital Logic

6. Set the name to be Status_Reg_LastStep and configure it to be four bits.

7. Connect these four inputs to the outputs of the D Flip Flops.
8. Don't forget to connect the clock wire signal to the clock terminal of Status_Reg_LastStep
(Figure 6-8).
Figure 6-8. D Flip Flops and Status_Reg_LastStep

Status_Reg_LastStep contains the previous value of Status_Reg_CurrentStep. We will use this

delay to ensure we are solving the riddle in order. If I am on step 7 and I did not just come from step
6, then I know that I have not completed the puzzle in order. I will check the values of these two reg-
isters after each clock pulse. It is good to note that another LUT could perform this function beauti-
fully without any CPU intervention and could assert an error signal, but the method chosen here will
suffice. Note also that I did not give specific names for each of the D Flip Flops. The default names
work fine in our example because the devices are hardware logic.
Add some final error checking for the riddle. This error checking is easier to show to you than it is to
describe. Refer to Figure 6-9 on page 79. Each time a pulse is sent to the clock wire, the
Status_Reg_Error will be loaded with a bit set to the value of one (1) if the Farmer is not with the
Goose and the Fox or if the Farmer is not with the Goose and the Corn. Notice that I included checks
for both sides of the river in each case.

78 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

Figure 6-9. Error Logic

6.3.2 Code
1. Create two new files in the project called farmerRiddle.h and farmerRiddle.c.
2. Include farmerRiddle.h in the main.c file. The farmerRiddle.h file will only have three prototypes.

/***************************************
* Function Prototypes
***************************************/
/*******************************************************************************
* Function Name: InitRiddle()
********************************************************************************
* Summary:
* Initializes Riddle conditions, UART communications, and the display.
*
* Parameters:
* none
*
* Return:
* none
*******************************************************************************/
void InitRiddle(void);

/*******************************************************************************
* Function Name: UpdateRiddle()
********************************************************************************
* Summary:
* Processes commands from the UART, updating Riddle conditions and display.
* Since a display update may include an animation, this function can pend for
* a long time until it returns.
*
* Parameters:
* none
*
* Return:
* none
*******************************************************************************/

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 79

Learn By Example: Digital Logic

void UpdateRiddle(void);

/*******************************************************************************
* Function Name: TestRiddle()
********************************************************************************
* Summary:
* Tests the Riddle functions.
*
* Parameters:
* none
*
* Return:
* none
*******************************************************************************/
void TestRiddle(void);

3. Add calls to the InitRiddle and testRiddle functions to the main.c file just before the endless loop.
The TestRiddle call is usually commented out unless you want an automated method to test the
rest of the project.

/* Initialize other components, not associated with interrupts */

CharLCD_Start();
InitComPort(); /* UART component */

/* Riddle initialization */
/*TestRiddle();*/ /* optional function, typically commented out */
InitRiddle();

for(;;) /* main loop - do forever */

4. Add a call in main.c in the tenth second area for UpdateRiddle.

5. Delete or comment out the DisplayCount function call because it competes for the LCD display.
6. Also delete or comment out the UpdateComPort call because it clears the UART_1 receive buffer
before you get to UpdateRiddle.

80 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

/* This section contains code to be executed every millisecond */

if(milliSecond)
{
milliSecond = 0U;
/* poll the UART and execute a command if bytes received */
/* UpdateComPort(); */ /* comment this out if doing the riddle */
} /* end of millisecond section */

/* This section contains code to be executed every tenth second */

if(tenthSecond)
{
tenthSecond = 0U;
/* Toggle the LED if the button is NOT pressed. This will cause
* the LED to blink rapidly when the button is NOT pressed.
*/
if(Button_Pin_Read()) /* read a 1 when button is NOT pressed */
{
ToggleLed();
}

UpdateRiddle();
} /* end of tenth second section */

The function call TestRiddle is not needed for the project, but it does run through each of the steps in
turn to illustrate on the LCD what is expected to happen. I used it to test the operation of the code
that is included here.
Below I have included the code for farmerRiddle.c. Most of the code written in this file is simply to
have fun and illustrate the riddle on the LCD display. The tenthSecondDelay routine from timing.c is
called several times simply to give a short delay. This call does prevent the code execution from
returning to the main loop for some time, so you will need to wait for animations and displays to finish
before the DVK1 will respond to any further inputs. This limitation is intentional to keep the code as
clear and straightforward as possible. The code to talk to the LCD display and show what is going on
is more than 60% of what is contained here, but it makes the project a lot more fun.
The InitRiddle function sends instructions out the UART_1 component to a terminal program and
sets the logic to its initial state with all four items on the starting side of the river. It also pulses the
clock wire to make sure the Status_Reg_LastState has the proper value in it for starting.
The UpdateRiddle function checks the UART_1 component to see if a new command has come in. If
a command has been received, it processes the command with the ExecuteRiddle function. After the
command has been processed, the Control_Reg_Clock register is clocked to load the D Flip Flops
with their next value.
The ExecuteRiddle function checks to see if the farmer and desired passenger are on the same side
of the river. If they are on the same side of the river, then the boat is sent with farmer and passenger
to the other side. The digital logic will then determine the success of your choice after they reach the
other side. If the farmer and desired item is not on the same side of the river, then an error is
returned. The AnimateBoat function is called to display the moving boat of the farmer with his pas-
senger going from one side of the river to the other.

#include <device.h>
#include "farmerRiddle.h"
#include "timing.h"

/***************************************

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 81

Learn By Example: Digital Logic

* Private variables and macros

***************************************/
/* Bit-masking values for each element of the riddle */
#define FARMER 1U
#define CORN 2U
#define GOOSE 4U
#define FOX 8U

/* boat direction is 1 if on near side of the river, -1 if on far side */

static int8 boatDir = 1;

/***************************************
* Private functions
***************************************/
/*******************************************************************************
* Function Name: DisplayElements()
********************************************************************************
* Summary:
* Displays on the char LCD the positions, i.e. which side of the river, of
* each of the four elements of the riddle, i.e. Farmer (F), Corn (C), Goose
* (G), and Fox (X). The positions are read from the control reg NextStep.
* The current boat position is also displayed.
*
* Parameters:
* none
*
* Return:
* none
*******************************************************************************/
static void DisplayElements(void)
{
/* message buffers for displaying the positions of the riddle elements.
* msg[0] shows those elements on the near side of the river,
* msg[1] shows those elements on the far side of the river.
*/
char msg[2][5];

uint8 temp;

/* redisplay the river on the top row */

CharLCD_Position(0U, 4U); /* row, column */
CharLCD_PrintString("))))))))");

/* Build and redisplay two messages to show the current position, i.e. on the
* near or the far side of the river, of each element of the riddle, i.e.
* farmer, corn, goose, fox.
*/
/* messages are based on the values in the control reg NextStep */
temp = Control_Reg_NextStep_Read();
/* first build the far side message */
msg[1][0] = ((temp & FARMER) ? 'F' : ' ');
msg[1][1] = ((temp & CORN) ? 'C' : ' ');
msg[1][2] = ((temp & GOOSE) ? 'G' : ' ');
msg[1][3] = ((temp & FOX) ? 'X' : ' ');
/* Then build the near side message, as the opposite of the far side message */
msg[0][0] = ((msg[1][0] == ' ') ? 'F' : ' ');
msg[0][1] = ((msg[1][1] == ' ') ? 'C' : ' ');

82 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

msg[0][2] = ((msg[1][2] == ' ') ? 'G' : ' ');

msg[0][3] = ((msg[1][3] == ' ') ? 'X' : ' ');
/* Then display the two messages */
CharLCD_Position(0U, 0U); /* row, column */
msg[0][4] = '\0';
CharLCD_PrintString(msg[0]); /* near side message */
CharLCD_Position(0U, 12U); /* row, column */
msg[1][4] = '\0';
CharLCD_PrintString(msg[1]); /* far side message */

/* Based on the current step value, display on the bottom row

* either the empty boat and more river or "SUCCESS"
*/
CharLCD_Position(1U, 3U); /* row, column */
if(Status_Reg_CurrentStep_Read() != 7U) /* done? */
{
CharLCD_PrintString(((boatDir == 1) ? "< >((((( " : " (((((< >")); /*
boat and river */
}
else /* done */
{
CharLCD_PrintString(" SUCCESS!");
}
} /* end of DisplayElements() */

/*******************************************************************************
* Function Name: AnimateBoat()
********************************************************************************
* Summary:
* Does an animated display on the char LCD of the boat going across the river.
* Pends in this function until the animation is done.
*
* Parameters:
* passenger: ASCII character for the boat's passenger
*
* Return:
* none
*******************************************************************************/
static void AnimateBoat(char passenger)
{
/* animation display messages */
static const char* msgs[7] =
{
"<F >(((((", " <F >(((( ", " (<F >((( ", " ((<F >(( ", " (((<F >( ",
" ((((<F > ", " (((((<F >"
};

uint8 index = ((boatDir == 1) ? 0U : 6U); /* message array index */

uint8 count;

/* erase Farmer and other icon from land (farmer is always in boat) */
CharLCD_Position(0U, ((boatDir == 1) ? 0U : 12U)); /* row, column */
CharLCD_PutChar(' ');
if(passenger == 'C')
{
CharLCD_Position(0U, ((boatDir == 1) ? 1U : 13U)); /* row, column */
CharLCD_PutChar(' ');

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 83

Learn By Example: Digital Logic

}
else if(passenger == 'G')
{
CharLCD_Position(0U, ((boatDir == 1) ? 2U : 14U)); /* row, column */
CharLCD_PutChar(' ');
}
else if(passenger == 'X')
{
CharLCD_Position(0U, ((boatDir == 1) ? 3U : 15U)); /* row, column */
CharLCD_PutChar(' ');
}
else {} /* no default action */

/* start the animation, exit loop when done */

for (count = 6U; count != 0U; count--)
{
CharLCD_Position(1U, 3U); /* row, column */
CharLCD_PrintString(msgs[index]);
/* display the passenger in the boat */
CharLCD_Position(1U, 5U + index); /* row, column */
CharLCD_PutChar(passenger);
/* update index per boat direction */
index += (uint8)boatDir;
TenthSecondDelay(5U);
}

boatDir *= -1; /* change the boat direction */

} /* end of AnimateBoat() */

/*******************************************************************************
* Function Name: ExecuteRiddle()
********************************************************************************
* Summary:
* Executes a command based on an input byte. The input byte is expected to
* be an ASCII character. Updates riddle conditions and display. Since this
* function calls AnimateBoat(), this function can pend for a long time until
* it returns.
*
* Parameters:
* thisCommand: the command byte
*
* Return:
* none
*******************************************************************************/
static void ExecuteRiddle(char thisCommand)
{
char passenger = ' '; /* passenger in the boat */

/* flag for what to display after executing the command:

* 0 = no display action
* 1 = update element positions display
* 2 = display command error message then update element positions display
*/
uint8 display = 0U;

uint8 temp;

84 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

/* take some action based on the input command byte */

switch(thisCommand)
{
case 'c': /* C = move Corn (with Farmer) */
case 'C':
/* Check if Farmer and Corn are both on the same side */
temp = (Control_Reg_NextStep_Read() & (FARMER | CORN));
if((temp == 0U) || (temp == (FARMER | CORN)))
{
/* indicate these two are now on the other side */
Control_Reg_NextStep_Write(Control_Reg_NextStep_Read() ^ (FARMER | CORN));
passenger = 'C'; /* passenger is Corn */
display = 1U; /* update positions display */
}
else /* indicate element is on opposite side of river from farmer */
{
display = 2U; /* display command error message */
}
break;

case 'g': /* G = move Goose (with Farmer) */

case 'G':
/* Check if Farmer and Goose are both on the same side */
temp = (Control_Reg_NextStep_Read() & (FARMER | GOOSE));
if((temp == 0U) || (temp == (FARMER | GOOSE)))
{
/* indicate these two are now on the other side */
Control_Reg_NextStep_Write(Control_Reg_NextStep_Read() ^ (FARMER | GOOSE));
passenger = 'G'; /* passenger is Goose */
display = 1U; /* update positions display */
}
else /* indicate element is on opposite side of river from farmer */
{
display = 2U; /* display command error message */
}
break;

case 'f': /* F or X = move Fox (with Farmer) */

case 'F':
case 'x':
case 'X':
/* Check if Farmer and Fox are both on the same side */
temp = (Control_Reg_NextStep_Read() & (FARMER | FOX));
if((temp == 0U) || (temp == (FARMER | FOX)))
{
/* indicate these two are now on the other side */
Control_Reg_NextStep_Write(Control_Reg_NextStep_Read() ^ (FARMER | FOX));
passenger = 'X'; /* passenger is Fox */
display = 1U; /* update positions display */
}
else /* indicate element is on opposite side of river from farmer */
{
display = 2U; /* display command error message */
}
break;

case ' ': /* space bar = move Farmer alone */

/* indicate the Farmer is now on the other side */

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 85

Learn By Example: Digital Logic

Control_Reg_NextStep_Write(Control_Reg_NextStep_Read() ^ FARMER);
passenger = ' '; /* no passenger */
display = 1U; /* update positions display */
break;

default: /* ignore the command */

break;
} /* end of switch(thisCommand) */

/* command execution complete, now update display */

if(display == 2U) /* command error detected */
{
/* display error message */
CharLCD_ClearDisplay();
CharLCD_Position(0U, 0U); /* row, column */
CharLCD_PrintString("They are apart ");
TenthSecondDelay(20U);
DisplayElements(); /* redisplay original */
}

else if(display == 1U) /* update positions display */

{
AnimateBoat(passenger);

/* briefly display the order of steps and indicate out of order or not */
CharLCD_ClearDisplay();
CharLCD_Position(0U, 0U); /* row, column */
temp = Status_Reg_CurrentStep_Read();
if((temp != 0U) && (temp != 7U))
{
CharLCD_PrintString(
(temp == (Status_Reg_LastStep_Read() + 1U)) ?
"Correct order" : "Incorrect order");
/* display the current and last step values */
CharLCD_Position(1U, 0U); /* row, column */
CharLCD_PrintString("Curr:");
CharLCD_PrintInt8(Status_Reg_CurrentStep_Read());
CharLCD_PrintString(" Last:");
CharLCD_PrintInt8(Status_Reg_LastStep_Read());
TenthSecondDelay(20U);
}

/* display new status or game error message */

CharLCD_ClearDisplay();
temp = Status_Reg_Error_Read(); /* 2-bit error register */
if(temp != 0U) /* 6 MS bits assumed to be 0 */
{
CharLCD_Position(0U, 0U); /* row, column */
/* display message per which error has occurred */
CharLCD_PrintString((temp & 1U) ? "Goose eats Corn!" : "Fox eats Goose!");
}
else /* no game error */
{
DisplayElements();
}
} /* end of else if(display == 1) */

else {} /* default display = 0, do nothing */

86 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

} /* end of ExecuteRiddle() */

/***************************************
* Global Functions
***************************************/
/*******************************************************************************
* Function Name: InitRiddle()
*******************************************************************************/
void InitRiddle(void)
{
UART_1_PutString("\r\nTime to play Farmer, Corn, Goose, and Fox\r\n");
UART_1_PutString("Press a Letter to put a passenger in the boat. \r\n");
UART_1_PutString("Press space bar for no passenger.\r\n");
UART_1_PutString("Press F or X for Fox, but he is displayed as X.\r\n");
UART_1_PutString("Press R to restart.\r\n");
UART_1_PutString("Watch the LCD for results.\r\n");

/* Initialize state in control reg, DFFs and status regs */

Control_Reg_NextStep_Write(0U); /* all four elements on near side of river */
Control_Reg_Clock_Write(1U); /* one pulse of the clock control reg */
Control_Reg_Clock_Write(0U);

/* initialize LCD display */

CharLCD_ClearDisplay();
boatDir = 1; /* near side of river */
DisplayElements();
} /* end of InitRiddle() */

/*******************************************************************************
* Function Name: UpdateRiddle
*******************************************************************************/
void UpdateRiddle(void)
{
/* if the UART has a received byte, execute a command based on that byte */
if(UART_1_ReadRxStatus() & (uint8)UART_1_RX_STS_FIFO_NOTEMPTY)
{
char inbyte = (char)UART_1_ReadRxData();
if ((inbyte == 'r') || (inbyte == 'R')) /* R = reinitialize game */
{
UART_1_PutStringConst("Restarting\r\n");
InitRiddle();
}
else /* not a restart command */
{
/* process other command if not done and no game error */
uint8 temp = Status_Reg_Error_Read();
if((Status_Reg_CurrentStep_Read() != 7U) && (temp == 0U))
{
/* This may involve a boat animation so may pend for a while */
ExecuteRiddle(inbyte);
/* Clock the DFFs and last step */
Control_Reg_Clock_Write(1U); /* single clock pulse */
Control_Reg_Clock_Write(0U);
}
}
} /* end of if UART byte received */

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 87

Learn By Example: Digital Logic

} /* end of UpdateRiddle() */

/*******************************************************************************
* Function Name: TestRiddle
*******************************************************************************/
void TestRiddle(void)
{
InitRiddle();
ExecuteRiddle('G'); /* bring the goose over */
/* Clock the DFFs and last step */
Control_Reg_Clock_Write(1U); /* single clock pulse */
Control_Reg_Clock_Write(0U);

ExecuteRiddle(' '); /* come back alone */

/* Clock the DFFs and last step */
Control_Reg_Clock_Write(1U); /* single clock pulse */
Control_Reg_Clock_Write(0U);

ExecuteRiddle('C'); /* bring the corn over */

/* Clock the DFFs and last step */
Control_Reg_Clock_Write(1U); /* single clock pulse */
Control_Reg_Clock_Write(0U);

ExecuteRiddle('G'); /* come back with the goose */

/* Clock the DFFs and last step */
Control_Reg_Clock_Write(1U); /* single clock pulse */
Control_Reg_Clock_Write(0U);

ExecuteRiddle('X'); /* bring the fox over */

/* Clock the DFFs and last step */
Control_Reg_Clock_Write(1U); /* single clock pulse */
Control_Reg_Clock_Write(0U);

ExecuteRiddle(' '); /* come back alone */

/* Clock the DFFs and last step */
Control_Reg_Clock_Write(1U); /* single clock pulse */
Control_Reg_Clock_Write(0U);

ExecuteRiddle('G'); /* bring the goose over */

/* Clock the DFFs and last step */
Control_Reg_Clock_Write(1U); /* single clock pulse */
Control_Reg_Clock_Write(0U);

TenthSecondDelay(30U);
} /* end of TestRiddle() */

6.4 Conclusions
The configurable digital functions available in the UDBs of the PSoC device can be customized for
your design and routed to any GPIO pin. The digital functions can operate independently from the
CPU or the CPU can monitor and control the digital logic fabric through the use of control and status
registers.

88 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Digital Logic

6.5 Additional Information

There is another possible solution to the Farmer, Corn, Goose, and Fox riddle. If you want to enable
logic to allow both solutions, then you simply alter the ninth and fourteenth entries of the output
states in LUT_Riddle. The new list for output states is: 0x0F, 0x04, 0x0F, 0x02, 0x01, 0x0F, 0x03,
0x04, 0x0F, 0x06, 0x05, 0x0F, 0x03, 0x0F, 0x07. Notice that there are now two entries for step 3 and
step 4.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 89

Learn By Example: Digital Logic

90 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 7. Learn By Example: Precision Analog

7.1 Project Overview

This chapter demonstrates some basic precision analog functions available in the PSoC platform. A
potentiometer and a voltage DAC will be used to generate analog signals. These signals are routed
to an ADC for conversion. The chapter demonstrates how multiplexers, analog references, and ana-
log ports are used to process the analog signals.

7.2 Project Background Information

“There is no digital, just funny looking analog.” Those are the words of a former coworker trying to
emphasize the importance of good analog design and knowledge. The PSoC platform excels in its
ability to process and manipulate analog signals. The term “precision analog” is fitting for the PSoC
platform. The capabilities extend well beyond a gain stage or a typical ADC. A PSoC device is able
to accurately process very small signals. The high precision becomes possible with a very low noise
floor through the analog system. This low noise floor coupled with very accurate reference levels are
essential for the 20-bit ADC to be accurate. The flexible analog routing system and integrated oper-
ational amplifiers allow for a variety of analog possibilities on the PSoC device itself.
There are some basic but valuable advantages to including analog capabilities in a microcontroller.
The first and primary advantage is noise immunity. Radiated noise in your circuit increases with
longer traces and larger ground loops. The traces on the silicon of the device are much smaller and
shorter than the traces on your PCB. Integrated analog also reduces device count and possibly addi-
tional communication circuits.
This project demonstrates some of the methods possible in the PSoC platform. The goal of the
project is to create a simple analog system that introduces the analog capabilities of the PSoC plat-
form. The voltage DAC and the potentiometer (R20) are connected to a multiplexer that switches
them to the ADC. The project also uses an optional amplifier to show how the internal amplifiers
work.
The operational amplifiers and multiplexers of the PSoC device allow for much of the routing to be
done internally and for access to outside pins when needed to apply external components.

7.3 Project Steps

This project begins with all of the components and code from Learn By Example: UART chapter on
page 41 and Learn By Example: CapSense chapter on page 59 projects. Create a new project
called Chapter7 and recreate all the components and code from the Chapter4 and Chapter5 proj-
ects. This project does not use the logic in the Farmer, Corn, Goose, Fox riddle, so you do not need
to bring in anything from Chapter6.

7.3.1 Adding Components

To see how the ADC works we need an analog signal to convert. We’re going to use a potentiometer
to provide one analog signal, a DAC to produce another signal, and a multiplexer to switch between

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 91

Learn By Example: Precision Analog

them. A basic potentiometer provides a great diagnostic tool for analog processing since you can
slowly sweep the signal through the range of the potentiometer and observe the output. The DAC is
used to create a few basic patterns using some timing and a lookup table. We will use the CapSense
buttons and slider to provide the controls, and the Char LCD and the UART to provide visual feed-
back.
1. Drag an Analog Pin component onto your design.
2. Name it VR_Pin. This pin will be connected to the potentiometer on the DVK.
3. Drag an Analog Mux component into the design.
4. Rename the Analog Mux component AMux_Signal.
5. Change the Channels parameter to 2 (Figure 7-1).
The AMux_Signal multiplexer selects between the potentiometer input and the DAC input and will
send the selected output to the ADC.
Figure 7-1. AMux Configuration

6. Add a Voltage DAC to your project from the DAC group of the component catalog.

92 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Precision Analog

7. Keep the default range of 0 - 1.020V and name it VDAC8 (Figure 7-2).
Figure 7-2. VDAC8 Configuration

The last component needed for this design is an analog to digital converter (ADC).
1. Add a Delta Sigma ADC component from the Component Catalog to your design.
2. Double Click the ADC to configure it.
3. Name the component ADC.
4. Configure the Power setting to Medium Power.
5. Set the Conversion Mode to Continuous.
6. Set the Resolution to be 14 bits and the Conversion Rate to be 5,000 SPS (samples per sec-
ond).
7. Set the Input Range to be Vssa to Vdda (Single Ended).
8. Set the Input Buffer Gain to 1 (Figure 7-3 on page 94).

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 93

Learn By Example: Precision Analog

Figure 7-3. ADC Configuration

7.3.2 Configuring Components

We want to send the analog signal to the ADC through the mux so that we can switch between an
amplified and unamplified signal to convert.
1. Connect the output of VDAC8 and VR_Pin to the inputs of AMux_Signal.
2. Connect the output of the AMux_Signal to the ADC.
Figure 7-4. VDAC and VR_Pin Connection

94 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Precision Analog

Figure 7-5. VDAC, Mux, and ADC Completed Design

7.3.3 Assigning Pins

This design adds only one new external pin for the potentiometer.
1. Open the design-wide resource file and assign the pins to match Figure 7-6.
2. Build the project.
3. Add a wire to the DVK board connecting P0_7 to the VR.
4. Make sure the VR_PWR jumper on the DVK is placed properly to provide power to the potenti-
ometer.
Figure 7-6. Pin Assignments

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 95

Learn By Example: Precision Analog

7.3.4 Code

1. Make the following changes to the beginning of main.c.

#include "myADC.h"
#include "myDAC.h"
....................

void main()
{
/* Components should be initialized in the following order:
* 1. interrupts
* 2. sources of interrupts (clocks are auto-initialized)
* 3. global interrupt enable
*/
InitTiming(); /* interrupt */
CapSense_Start(); /* interrupt and source of interrupt */
PWM_Timer_Start(); /* source of interrupt */
InitAdc(); /* source of interrupt */
CYGlobalIntEnable /* macro */

/* Initialize other components, not associated with interrupts */

CharLCD_Start();
InitComPort();
InitCapSense();
InitDac();

..........

2. Add the following lines to the tenth second area of the main loop to call the UpdateCapSense,
UpdateAdc, and UpdateDac routines.
3. Comment out the DisplayCount call.

/* This section contains code to be executed every tenth second */

if(tenthSecond)
{
tenthSecond = 0U;

/* Toggle the LED if the button is NOT pressed. This will cause
* the LED to blink rapidly when the button is NOT pressed.
*/
if(Button_Pin_Read()) /* read a 1 when button is NOT pressed */
{
ToggleLed();
}

UpdateCapSense();
UpdateAdc();
UpdateDac();
} /* end of tenth second section */

96 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Precision Analog

4. Create a file called myADC.c. Add the following code to the myADC.c file.

#include <device.h>
#include "myADC.h"
#include "myDAC.h"

/***************************************
* Global Functions
***************************************/
/*******************************************************************************
* Function Name: InitAdc()
*******************************************************************************/
void InitAdc(void)
{
ADC_Start();
ADC_StartConvert(); /* Starts a continuous cnversion process */
} /* end of InitAdc() */

/*******************************************************************************
* Function Name: UpdateAdc()
*******************************************************************************/
void UpdateAdc(void)
{
if(ADC_IsEndConversion(ADC_RETURN_STATUS))
{
uint8 adcval8;

/* Get 14-bit conversion reported in a signed 16-bit result, and limit

* negative and positive overflow.
*/
int16 adcval16 = ADC_GetResult16();
if(adcval16 < 0)
{
adcval16 = 0;
}
else if(adcval16 > 0x3FFF)
{
adcval16 = 0x3FFF;
}
else {} /* value is in range, do nothing */

/* Convert to an 8-bit result; grab the 8 MS bits. */

adcval8 = (uint8)(((uint16)adcval16 >> 6) & 0xFFU);

/* if reading from the DAC, amplify the reading, because the DAC is
* putting out voltage in the range 0 - 1.024V
*/
if(source != 0U)
{
adcval8 *= 3U;
}

/* display the result on the char LCD */

CharLCD_Position(1U, 6U); /* row, column */
CharLCD_PrintHexUint8(adcval8);

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 97

Learn By Example: Precision Analog

/* Display the result on the UART:

* Print (val / 4) (with rounding, add half the divisor) 'X' characters,
* which creates a horizontal line whose length is proportional to the
* ADC value.
*/
adcval8 = (uint8)(((uint16)adcval8 + 2U) / 4U);
if (adcval8 == 0U) /* make sure that at least one 'X' is printed */
{
adcval8 = 1U;
}
for( ; adcval8 != 0U; adcval8--)
{
UART_1_PutChar('X');
}
UART_1_PutString("\r\n");
} /* end of if(ADC_IsEndConversion(ADC_RETURN_STATUS)) */
}/* end of UpdateAdc() */

The beginning lines in main routine start the ADC and begin the first conversion. Every 100 millisec-
onds, the main loop will check the ADC to see if it has completed its conversion. If the conversion
has completed, it will process and display that conversion result. The next conversion starts auto-
matically (continuous conversion mode).
The ADC in this chapter is set to do a 14-bit conversion. The 8 most significant bits are preserved
and displayed as an 8-bit result on the LCD screen. The project begins by displaying the letters ADC
in the first row of the LCD display with its own conversion result displayed directly below this label.
The UpdateAdc routine also sends a string of X characters to the UART. Open a terminal window
while running this project to see a simple bar graph representation of the voltage read by the ADC.
1. Create a file called myDAC.c. Add the following code to the myDAC.c file.

#include <device.h>
#include "myCapsense.h"
#include "myDAC.h"

/***************************************
* Global Variables and Macros
***************************************/
uint8 source = 0U; /* current ADC source, 0 = POT, 1 = DAC */

/***************************************
* Private Variables and Macros
***************************************/
/* These variables are used to generate the DAC waveform */
static uint8 waveType = 0U; /* which waveform table to use (see below) */
static uint8 waveSpeed = 1U; /* how fast to move through the waveform table */

/* data to create sine, sawtooth, triangle and square waves */

static uint8 const tables[4][100] =
{
{ /* sine */

127U,135U,143U,151U,159U,166U,174U,181U,188U,195U,202U,208U,214U,220U,225U,230U,2
34U,238U,242U,245U,

98 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Precision Analog

248U,250U,252U,253U,254U,254U,254U,253U,252U,250U,248U,245U,242U,238U,234U,230U,2
25U,220U,214U,208U,
202U,195U,188U,181U,174U,166U,159U,151U,143U,135U,127U,119U,111U,103U, 96U,
88U, 80U, 73U, 66U, 59U,
53U, 46U, 40U, 35U, 29U, 24U, 20U, 16U, 12U, 9U, 6U, 4U, 2U, 1U, 0U, 0U,
0U, 1U, 2U, 4U,
6U, 9U, 12U, 16U, 20U, 24U, 29U, 34U, 40U, 46U, 52U, 59U, 65U, 73U, 80U,
87U, 95U,103U,111U,119U
},

{ /* sawtooth */
0U, 3U, 5U, 8U, 10U, 13U, 15U, 18U, 21U, 23U, 26U, 28U, 31U, 33U, 36U, 39U,
41U, 44U, 46U, 49U,
52U, 54U, 57U, 59U, 62U, 64U, 67U, 70U, 72U, 75U, 77U, 80U, 82U, 85U, 88U,
90U, 93U, 95U, 98U,100U,

103U,106U,108U,111U,113U,116U,118U,121U,124U,126U,129U,131U,134U,137U,139U,142U,1
44U,147U,149U,152U,

155U,157U,160U,162U,165U,167U,170U,173U,175U,178U,180U,183U,185U,188U,191U,193U,1
96U,198U,201U,203U,

206U,209U,211U,214U,216U,219U,222U,224U,227U,229U,232U,234U,237U,240U,242U,245U,2
47U,250U,252U,255U
},

{ /* triangle */
0U, 5U, 10U, 16U, 21U, 26U, 31U, 36U, 42U, 47U, 52U, 57U, 62U, 68U, 73U,
78U, 83U, 88U, 94U, 99U,

104U,109U,114U,120U,125U,130U,135U,141U,146U,151U,156U,161U,167U,172U,177U,182U,1
87U,193U,198U,203U,

208U,213U,219U,224U,229U,234U,239U,245U,250U,255U,255U,250U,245U,239U,234U,229U,2
24U,219U,213U,208U,

203U,198U,193U,187U,182U,177U,172U,167U,161U,156U,151U,146U,141U,135U,130U,125U,1
20U,114U,109U,104U,
99U, 94U, 88U, 83U, 78U, 73U, 68U, 62U, 57U, 52U, 47U, 42U, 36U, 31U, 26U,
21U, 16U, 10U, 5U, 0U
},

{ /* square */
10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U,
10U, 10U, 10U, 10U, 10U,
10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U,
10U, 10U, 10U, 10U, 10U,
10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U, 10U,
10U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,

245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,2
45U,245U,245U,245U,

245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,245U,2
45U,245U,245U,245U
}
};

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 99

Learn By Example: Precision Analog

/***************************************
* Private Functions
***************************************/
/*******************************************************************************
* Function Name: DisplayDac()
********************************************************************************
* Summary:
* Displays on the char LCD the current state of the analog mux and DAC
* waveform generation, including waveform speed.
*
* Parameters:
* none
*
* Return:
* none
*
*******************************************************************************/
static void DisplayDac(void)
{
static char* const msgs[4] = {"SIN", "SAW", "TRI", "SQR"};

/* display current parameters on the char LCD:

* analog mux setting, DAC or POT
*/
CharLCD_Position(0U, 9U); /* row, column */
CharLCD_PrintString(source ? "DAC" : "POT");

/* speed of DAC waveform */

CharLCD_Position(1U, 13U); /* row, column */
CharLCD_PrintInt8(waveSpeed);

/* DAC waveform type (sine, sawtooth, triangle, or square)*/

CharLCD_Position(0U, 13U); /* row, column */
if (waveType >= 4U) /* reset if incorrect value in variable */
{
waveType = 0U;
}
CharLCD_PrintString(msgs[waveType]);
} /* end of DisplayDac() */

/***************************************
* Global Functions
***************************************/
/*******************************************************************************
* Function Name: InitDac()
*******************************************************************************/
void InitDac(void)
{
AMux_Signal_Start();
AMux_Signal_Select(0U); /* start up looking at the potentiometer */
VDAC8_Start();
} /* end of InitDac() */

/*******************************************************************************

100 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Precision Analog

* Function Name: UpdateDac()

*******************************************************************************/
void UpdateDac(void)
{
/* initial display flag */
static uint8 init = 1U;

/* index into waveform table */

static uint8 index = 0U;

/* buttons pressed / released states

* [0] = current, [1] = previous
* bit 0 is button P0_5, bit 1 is button P0_6
* this is used to detect button unpressed to pressed events
*/
static uint8 buttons[2] = {0U, 0U};

int8 redisplay = 0;
uint8 temp;

/* Advance to the next value in the current waveform */

index += waveSpeed;
if(index >= 100U) /* handle overflow */
{
index -= 100U;
}
if (waveType > 3U) /* handle incorrect value in variable */
{
waveType = 0U;
}
VDAC8_SetValue((uint8)tables[waveType][index]);

/* update previous then current button values */

buttons[1] = buttons[0]; /* current to previous */
temp = GetButtonP0_5() & 1U; /* buttons to current */
buttons[0] = temp | ((uint8)(GetButtonP0_6() << 1) & 2U);

/* CapSense button P0_5 unpressed to pressed changes source */

if(((buttons[1] & 1U) == 0U) && ((buttons[0] & 1U) != 0U))
{
source ^= 1U;
AMux_Signal_Select(source);
redisplay = 1;
}

/* CapSense button P0_6 changes waveform type */

if(((buttons[1] & 2U) == 0U) && ((buttons[0] & 2U) != 0U))
{
waveType = (waveType + 1U) & 3U;
redisplay = 1;
}

/* CapSense slider changes waveform speed */

{
uint8 myCentroid = GetSlider();
/* translate centroid range 0 - 100 to waveSpeed range 1 - 5 */
if(myCentroid <= 100U)
{

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 101

Learn By Example: Precision Analog

/* divide with rounding (add (divisor / 2) to dividend before dividing)

*/
waveSpeed = ((myCentroid + 12U) / 25U) + 1U;
redisplay = 1;
}
}

/* Update display if initializing or something changed */

if (init || redisplay)
{
init = 0U;
DisplayDac();
}
} /* end of UpdateDac() */

The myDAC.c file indexes into four tables to create wave shapes that resemble a sine wave, saw-
tooth wave, triangle wave, and a square wave. The CapSense button P0_5 controls the mux and
switches between the potentiometer and the DAC as a signal source. Successive presses on button
P0_6 switch the DAC wave generation from the sine wave to the saw tooth, to the triangle, to the
square wave, and back to the sine wave. The speed of the wave varies from 1 to 5x, and is con-
trolled with the slider. The type of wave and speed of the wave being sent to the DAC are displayed
on the LCD display.

7.4 Conclusions
The PSoC device keeps the analog processing inside the microcontroller where it is more immune to
outside noise influences. The precision analog links with the digital resources to provide an interwo-
ven system inside a single chip.
Set up the components within your project before you start the PCB layout of the project. Make sure
the routing you need is possible after adding all the components to your schematic view. Note that if
you can alter your PCB to match the suggested pin assignments from PSoC Creator, you will be able
to fit the most components and functionality into your design.
The PSoC platform allows you to add external components to the design that interact with internal
analog to achieve custom gain and filter processing in the analog domain. Keep the power required
by the internal components to a minimum to guarantee the best accuracy. Experiment with different
power settings with the analog components. Power settings have tradeoffs in speed and power.
They may also have a slight effect on settling and accuracy.

7.5 Additional Information

Make sure to study the TRM and data sheet to understand the architecture of the analog systems in
the PSoC device. Do not be discouraged if your analog project does not route correctly the first time
or if it seems impossible to get the analog setup that you need for your project.
When developing a system that is particularly difficult or atypical, there is a tendency to give up too
early and decide that the design is not feasible. The PSoC system is flexible enough that it is very
likely there are some other approaches to your design that you have not thought of. Take some time
to consider all possible options. If the design requirements are not typical, then the best solution very
well may not be typical. I have worked on many designs that I did not think would work at the begin-
ning with PSoC microcontrollers and then found a way later after some experimentation and persis-
tence.

102 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Learn By Example: Precision Analog

There may be a bit of frustration when you cannot probe inside the chip to find out what is happening
with analog signals. It is good practice to leave a test point on your PCB to serve as a test output
point. Simply connect the point in question to this output point during development to measure what
is happening at that particular stage.
When you are developing more complex designs, the number of items in the schematic may make it
impossible to route the analog port components to any combination of pins that you want. In this sit-
uation it is best to first add your components and build the project without locking any analog or digi-
tal components to specific pins. PSoC Creator will optimize the routing inside the chip and suggest
the best pins to use according to its algorithms. After it has built successfully with the freedom to
assign pins, start with the pins that are most needed to be in specific locations and assign a few of
them to the desired I/O pins and rebuild the project.
If you do this a few pins at a time, you will have a better idea where the conflict is compared to lock-
ing all the pins in a particular location and then wondering why PSoC Creator cannot route the proj-
ect successfully.

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 103

Learn By Example: Precision Analog

104 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Index

Numerics central processing unit See CPU

8051 CPU 15 character LCD 43
CharLCD component 44, 68
clock 25, 49
clock input 77
A Clock_PWM component 49
ADC 91, 98 clock_PWM component 25, 26
sigma delta 8, 15, 93 clocking structure 51
adding a new project 42, 60, 71 code 31, 51, 65, 79, 96
adding a register 72, 76 COM port 41, 46, 57
adding components 25, 43, 60, 91 command 81
advanced high performance bus 7 comparator 15
AHB See advanced high performance bus Component Catalog 25, 93
analog mux 92 Components tab 19
analog port 91, 103 comport.h 51, 53
analog reference 91 Configure dialog 25
analog resources 69 Configure System Clocks dialog 51
analog system 8, 91, 102 configuring a register 72
AnimateBoat function 81 configuring a UART 41–58
application notes 69 configuring clocks 49
architecture configuring components 60, 94
PSoC 3 and PSoC 5 7 connecting components 28
PSoC platform 7
content and organization 5
ASIC 68
control register 72, 76, 88
assigning pins 30, 49, 64, 95
conventions 13
CPU 6, 47, 88
8051 15
B creating a new schematic page 71
baseline 62, 67 cydwr file 19, 30, 43, 49
baud rate 41, 58
bit rate 50, 58
blinking an LED 23–40 D
continual repeating blink 38
D Flip Flop 77
using a counter 39
DAC 8, 16
buffer 47, 80
current 8
Build/Debug toolbar 37 voltage 8, 91, 92
building a project 29, 37, 55 data integrity 50
button 59, 60 Data Sheet button 26
button component 37 datapath 10
debounce counter 62
Debug menu 37
C debugging a project 37, 55
CAN 15 design practices 69
capacitance 59, 61 design-wide resources 21
capacitive sensing 59, 68 file 30, 43, 64, 95
CapSense 17, 59–??, 68 DFB See digital filter block
CapSense_1 component 60 digital filter block 8

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 105

Index

digital I/O 47, 48 InitializeAllBaselines routine 67

digital logic 71, ??–88 InitRiddle function 80, 81
digital output pin 27 internal clock 47, 51
digital port 29 internal logic 30
digital to analog converter See DAC internal main oscillator See IMO
display.c 43 interrupt 29, 47
display.h 43 intializeComPort function 54
DisplayCount function 44, 80, 96 isr_PWM component 29
DisplayWelcome function 44 isr_PWM.c 37
DMA controller 8 isrPWM component 34
document
revision history 13
dPort_Button component 29 J
dPort_RxPin component 47
jumpers 17
dPort_TxPin component 48
DVK1 board 17, 30, 34, 37, 41, 56, 59, 64

L
E layout guidelines 69
LCD 16, 41, 45, 68, 80, 81, 98
embedded system 6
LCD_Char_1 component 43
error checking 78
LED 23, 27
error detection 50
blinking 23–40, 45, 56
example designs continual repeating blink 38
organization 22 using a counter 39
ExecuteRiddle function 81 ledEnabled 54
external clock 47 LEDPin 56
external crystal 51 liquid crystal display See LCD
logic component 71
lookup table See LUT
F LUT 71, 76, 77, 78, 92
farmerRiddle.c 79
farmerRiddle.h 79
finger threshold 62 M
firmware 68 main.c 31, 34, 38, 44, 53, 67, 79, 96
flag 23 Master Clock 51
flow control 46 memory 6
EEPROM 7
Flash 6
G RAM 7, 47
gesturing 59 microcontrollers 6, 68, 102
global interrupt flag 34 microprocessor 7
GPIO 16 MiniProg3 17
multi touch 59
multiplexer 30
myADC.c 97
H myCapsense.c 65
hardware delay 77 myCapsense.h 66
header files 22 myDAC.c 98, 102
headers 30
Hyperterminal 54
hysteresis 62
N
noise 91
noise floor 91
I noise immunity 91
I/O logic 34 noise threshold 62
IMO 49 non return to zero See NRZ communication
initialization 34, 67 NRZ communication 57

106 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 Index

O schematic 29, 48, 71, 77, 103

opamp 8, 15 schematic view 21
operational amplifier See opamp sensor design 69
output latches 34 serial communication device 41, 57
Output window 25 serial port connector 56
oversampling 47, 50 sheet connector 73, 77
sigma delta ADC 8, 15, 93
sine wave 102
slider 59, 62
P source files 22
parity bit 46 Source tab 19
PCB 30, 59, 91 start bit 41
layout 102 start function 31
period 23, 27, 38 Start Page 18, 24
periodic interrupt 38 starting a new project 24
periodic task management 23 state machine 71, 77
peripheral hub 7 status register 72, 77, 88
peripherals 7 stop bit 41, 46
PHUB See peripheral hub super I/O chip 57
PLD 9 SW1 button 34, 37, 38, 45
potentiometer 91, 92 switched cap 8
power settings 102
precision analog 91–103
prototyping area 30
proximity detection 59
T
PS register 34 tenth second area 44, 80, 96
PSoC 3 and PSoC 5 architecture 7 tenthSecondDelay function 81
PSoC Creator 18 Tera Term 54
Component Catalog 25 terminal program 54, 56
Configure dialog 25 terminal window 98
Debug menu 37 TestRiddle function 80, 81
Output window 25 timing flag 38
schematic view 21 timing system 23
Start Page 18, 24 timing.c 34, 81
View menu 25 timing.h 44
Workspace Explorer 19, 25
toggleLED function 34, 54
PSoC platform 5, 7, 91, 102
touchscreen 59
architecture 7
tuning capacitive sensing 69
PWM 23, 26, 38
TX 47
PWM_Pin 54
PWM_Timer component 27, 28, 54
PWMPin 56
U
UART 41–58, 98
R Mark state 57
Space state 57
RAM 7, 47 UART_1 component 47, 49, 50, 54, 81
Results tab 20 UDB 15, 88
revision history 13 array 11
routing 30, 91, 102, 103 See also universal digital block
RS232 41, 57, 58 universal digital block 8
RX 47 UpdateAdc function 96, 98
RxPin component 48 UpdateAllBaselines function 67
UpdateComPort function 80
updateComPort function 54
S UpdateDac function 96
sawtooth wave 102 UpdateRiddle function 80, 81
SC/CT block 8, 15 USB 15, 41, 57
ScanAllSlots routine 67 USB to RS232 converter 41

My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A 107

Index

USB to UART bridge 41

USB2UART component 41

V
Verilog 15
View menu 25

W
wave shapes 102
Workspace Explorer 19, 25
Components tab 19
Results tab 20
Source tab 19

108 My First Five PSoC 3 Designs, Spec. # 001-58878 Rev. *A

 MY FIR S T 5 P S O C 3 DES I G NS

CONTACT US

CYPRESS HEADQUARTERS FOR MORE INFORMATION ON CYPRESS SOLUTIONS:

Cypress Semiconductor Corporation PS O C TECHNOLOGY CYPRESS DEVELOPER COMMUNITY
198 Champion Court w w w.cypress.com/go/PSoC w w w.cypress.com/go/community
San Jose, CA 95134 USA
CYPRESS EDUCATION— CY P ROS ® CERTIFIED CONSULTANTS
Tel: +1 (408) 943-2600
UNIVERSITY ALLIANCE w w w.cypress.com/go/cypros
Fax: +1 (408) 943-6848
w w w.cypress.com/go/university
Toll-free: +1 (800) 858-1810 (U.S. only) CYPRESS ONLINE STORE
ONLINE TECHNICAL SUPPORT w w w.cypress.com/go/buyonline
www.cypress.com w w w.cypress.com/go/support

ABOUT CYPRESS

Cypress delivers high-performance, mixed-signal, programmable solutions that provide customers

with rapid time-to-market and exceptional system value. Cypress offerings include the PSoC
Programmable System-on-Chip, USB controllers, general-purpose programmable clocks, and
memories. Cypress also offers wired and wireless connectivity solutions ranging from its CyFi
Low-Power RF solution, to West Bridge and EZ-USB FX2LP controllers that enhance connectivity

and performance in multimedia handsets. Cypress serves numerous markets, including consumer,
computation, data communications, automotive and industrial. Cypress trades on the NYSE

under the ticker symbol CY. Visit Cypress online at www.cypress.com.

© 20 Cypress Semiconductor Corporation. All rights reseSWed. All other trademarks are the propFSUZ
PG
UIFJS
SFTQFDUJWF
PXOFST.

Job line: 0510/BALA/XNB/JONA'46
| ParU
number:


3FW
"