Programming 8-bit PIC microcontrollers in C with interactive hardware simulation 9780750689601, 0750689609

Citation preview

Foreword

Embedded microcontrollers are everywhere today. In the average household you will find them far beyond the obvious places like cell phones, calculators, and MP3 players. Hardly any new appliance arrives in the home without at least one controller and, most likely, there will be several—one microcontroller for the user interface (buttons and display), another to control the motor, and perhaps even an overall system manager. This applies whether the appliance in question is a washing machine, garage door opener, curling iron, or toothbrush. If the product uses a rechargeable battery, modern high density battery chemistries require intelligent chargers. A decade ago, there were significant barriers to learning how to use microcontrollers. The cheapest programmer was about a hundred dollars and application development required both erasable windowed parts—which cost about ten times the price of the one time programmable (OTP) version—and a UV Eraser to erase the windowed part. Debugging tools were the realm of professionals alone. Now most microcontrollers use Flash-based program memory that is electrically erasable. This means the device can be reprogrammed in the circuit—no UV eraser required and no special packages needed for development. The total cost to get started today is about twenty-five dollars which buys a PICkit™ 2 Starter Kit, providing programming and debugging for many Microchip Technology Inc. MCUs. Microchip Technology has always offered a free Integrated Development Environment (IDE) including an assembler and a simulator. It has never been less expensive to get started with embedded microcontrollers than it is today. While MPLAB® includes the assembler for free, assembly code is more cumbersome to write, in the first place, and also more difficult to maintain. Developing code using C frees the programmer from the details of multi-byte math and paging and generally improves code readability and maintainability. CCS and Hi-Tech both offer free “student” versions of the compiler to get started and even the full versions are relatively inexpensive once the savings in development time has been taken into account.

w w w.new nespress.com

xii

Foreword

While the C language eliminates the need to learn the PIC16 assembly language and frees the user from managing all the details, it is still necessary to understand the architecture. Clocking options, peripherals sets, and pin multiplexing issues still need to be solved. Martin’s book guides readers, step-by-step, on the journey from “this is a microcontroller” to “here’s how to complete an application.” Exercises use the fully featured PIC16F877A, covering the architecture and device configuration. This is a good starting point because other PIC16s are similar in architecture but differ in terms of IO lines, memory, or peripheral sets. An application developed on the PIC16F877A can easily be transferred to a smaller and cheaper midrange PICmicro. The book also introduces the peripherals and shows how they can simplify the firmware by letting the hardware do the work. MPLAB®, Microchip’s Integrated Development Environment, is also covered. MPLAB includes an editor and a simulator and interfaces with many compilers, including the CCS compiler used in this book. Finally, the book includes the Proteus® simulator which allows complete system simulation, saving time and money on prototype PCBs. Dan Butler Principal Applications Engineer Microchip Technology Inc.

www.n ewn es p res s .c o m

Preface

This book is the third in a series, including ●

PIC Microcontrollers: An Introduction to Microelectronic Systems.

●

Interfacing PIC Microcontrollers: Embedded Design by Interactive Simulation.

●

Programming 8-bit PIC Microcontrollers in C: With Interactive Hardware Simulation.

It completes a set that introduces embedded application design using the Microchip PIC® range, from Microchip Technology Inc. of Arizona. This is the most popular microcontroller for education and training, which is also rapidly gaining ground in the industrial and commercial sectors. Interfacing PIC Microcontrollers and Programming PIC Microcontrollers present sample applications using the leading design and simulation software for microcontroller based circuits, Proteus VSM® from Labcenter Electronics. Demo application files can be downloaded from the author’s support Web site (see later for details) and run on-screen so that the operation of each program can be studied in detail. The purpose of this book is to ●

Introduce C programming specifically for microcontrollers in easy steps.

●

Demonstrate the use of the Microchip MPLAB IDE for C projects.

●

Provide a beginners’ guide to the CCS PCM C compiler for 16 series PICs.

●

Explain how to use Proteus VSM to test C applications in simulated hardware.

●

Describe applications for the Microchip PICDEM mechatronics board.

●

Outline the principles of embedded system design and project development.

w w w.new nespress.com

xiv

Preface

C is becoming the language of choice for embedded systems, as memory capacity increases in microcontrollers. Microchip supplies the 18 and 24 series chips specifically designed for C programming. However, C can be used in the less complex 16 series PIC, as long as the applications are relatively simple and therefore do not exceed the more limited memory capacity. The PIC 16F877A microcontroller is used as the reference device in this book, as it contains a full range of peripherals and a reasonable memory capacity. It was also used in the previous work on interfacing, so there is continuity if the book series is taken as a complete course in PIC application development. Microcontrollers are traditionally programmed in assembly language, each type having its own syntax, which translates directly into machine code. Some students, teachers, and hobbyists may wish to skip a detailed study of assembler coding and go straight to C, which is generally simpler and more powerful. It is therefore timely to produce a text that does not assume detailed knowledge of assembler and introduces C as gently as possible. Although several C programming books for microcontrollers are on the market, many are too advanced for the C beginner and distract the learner with undesirable detail in the early stages. This text introduces embedded programming techniques using the simplest possible programs, with on-screen, fully interactive circuit simulation to demonstrate a range of basic techniques, which can then be applied to your own projects. The emphasis is on simple working programs for each topic, with hardware block diagrams to clarify system operation, full circuit schematics, simulation screenshots, and source code listings, as well as working downloads of all examples. Students in college courses and design engineers can document their projects to a high standard using these techniques. Each part concludes with a complete set of self-assessment questions and assignments designed to complete the learning package. An additional feature of this book is the use of Proteus VSM (virtual system modeling). The schematic capture component, ISIS, allows a circuit diagram to be created using an extensive library of active components. The program is attached to the microcontroller, and the animated schematic allows the application to be comprehensively debugged before downloading to hardware. This not only saves time for the professional engineer but provides an excellent learning tool for the student or hobbyist.

www.n ewn es p res s .c o m

Preface

xv

Links, Resources, and Acknowledgments Microchip Technology Inc. (www.microchip.com) Microchip Technology Inc. is a manufacturer of PIC® microcontrollers and associated products. I gratefully acknowledge the support and assistance of Microchip Inc. in the development of this book and the use of the company trademarks and intellectual property. Special thanks are due to John Roberts of Microchip UK for his assistance and advice. The company Web site contains details of all Microchip hardware, software, and development systems. MPLAB IDE (integrated development system) must be downloaded and installed to develop new applications using the tools described in this book. The data sheet for the PIC 16F877A microcontroller should also be downloaded as a reference source. PIC, PICmicro, MPLAB, MPASM, PICkit, dsPIC, and PICDEM are trademarks of Microchip Technology Inc.

Labcenter Electronics (www.labcenter.co.uk) Labcenter Electronics is the developer of Proteus VSM (virtual system modeling), the most advanced cosimulation system for embedded applications. I gratefully acknowledge the assistance of the Labcenter team, especially John Jameson, in the development of this series of books. A student/evaluation version of the simulation software may be downloaded from www.proteuslite.com. A special offer for ISIS Lite, ProSPICE Lite, and the 16F877A simulator model can be found at www.proteuslite.com/register/ ipmbundle.htm. Proteus VSM, ISIS, and ARES are trademarks of Labcenter Electronics Ltd.

Custom Computer Services Inc. (www.ccsinfo.com) Custom Computer Services Inc. specializes in compilers for PIC microcontrollers. The main range comprises PCB compiler for 12-bit PICs, PCM for 16-bit, and PCH for the 18 series chips. The support provided by James Merriman at CCS Inc. is gratefully acknowledged. The manual for the CCS compiler should be downloaded from the company Web site (Version 4 was used for this book). A 30-day trial version, which will compile code for the 16F877A, is available at the time of writing.

w w w.ne w nespress.com

xvi

Preface

The Author’s Web Site (www.picmicros.org.uk) This book is supported by a dedicated Web site, www.picmicros.org.uk. All the application examples in the book may be downloaded free of charge and tested using an evaluation version of Proteus VSM. The design files are locked so that the hardware configuration cannot be changed without purchasing a suitable VSM license. Similarly, the attached program cannot be modified and recompiled without a suitable compiler license, available from the CCS Web site. Special manufacturer’s offers are available via links at my site. This site is hosted by www.larrytech.com and special thanks are due to Gabe Hudson of Larrytech® Internet Services for friendly maintenance and support. I can be contacted at the e-mail address [email protected] with any queries or comments related to the PIC book series. Finally, thanks to Julia for doing the boring domestic stuff so I can do the interesting technical stuff.

About the Author Martin P. Bates is the author of PIC Microcontrollers, Second Edition. He is currently lecturing on electronics and electrical engineering at Hastings College, UK. His interests include microcontroller applications and embedded system design.

www.n ewn es p res s .c o m

Introduction

The book is organized in five parts. Part 1 includes an overview of the PIC microcontroller internal architecture, describing the features of the 16F877A specifically. This chip is often used as representative of the 16 series MCUs because it has a full range of peripheral interfaces. All 16 series chips have a common program execution core, with variation mainly in the size of program and data memory. During programming, certain operational features are configurable: type of clock circuit, watchdog timer enable, reset mechanisms, and so on. Internal features include the file register system, which contains the control registers and RAM block, and a nonvolatile EEPROM block. The parallel ports provide the default I/O for the MCU, but most pins have more than one function. Eight analog inputs and serial interfaces (UART, SPI, and I2C) are brought out to specific pins. The hardware features of all these are outlined, so that I/O programming can be more readily understood later on. The application development process is described, using only MPLAB IDE in this initial phase. A sample C program is edited, compiled, downloaded, and tested to demonstrate the basic process and the generated file set analyzed. The debugging features of MPLAB are also outlined: run, single step, breakpoints, watch windows, and so on. Disassembly of the object code allows the intermediate assembly language version of the C source program to be analyzed. Part 2 introduces C programming, using the simplest possible programs. Input and output are dealt with immediately, since this is the key feature of embedded programs. Variables, conditional blocks (IF), looping (WHILE,FOR) are quickly introduced, with a complete example program. Variables and sequence control are considered in a little more detail and functions introduced. This leads on to library functions for operating timers and ports. The keypad and alphanumeric LCD are used in a simple calculator program. More data types (long integers, floating point numbers, arrays, etc.) follow as well as assembler directives and the purpose of the header file. Finally, insertion of assembler into C programs is outlined.

w w w.new nespress.com

xviii

Introduction

Part 3 focuses on programming input and output operations using the CCS C library functions. These simplify the programming process, with a small set of functions usually providing all the initialization and operating sequences required. Example programs for analog input and the use of interrupts and timers are developed and the serial port functions demonstrated in sample applications. The advantages of each type of serial bus are compared, and examples showing the connection of external serial EEPROM for data storage and a digital to analog converter output are provided. These applications can be tested in VSM, but this is not essential; use of VSM is optional throughout the book. Part 4 focuses specifically on the PICDEM mechatronics board from Microchip. This has been selected as the main demonstration application, as it is relatively inexpensive and contains a range of features that allow the features of a typical mechatronics system to be examined: input sensors (temperature, light, and position) and output actuators (DC and stepper motor). These are tested individually then the requirements of a temperature controller outlined. Operation of the 3.5-digit seven-segment LCD is explained in detail, as this is not covered elsewhere. A simulation version of the board is provided to aid further application design and implementation. Part 5 outlines some principles of software and hardware design and provides some further examples. A simple temperature controller provides an alternative design to that based on the mechatronics board, and a data logger design is based on another standard hardware system, which can be adapted to a range of applications—the BASE board. Again, a full-simulation version is provided for testing and further development work. This is followed by a section on operating systems, which compares three program design options: a polling loop, interrupt driven systems, and real-time operating systems. Consideration of criteria for the final selection of the MCU for a given application and some general design points follow. Three appendices (A, B, and C) cover hardware design using ISIS schematic capture, software design using CCS C, and system testing using Proteus VSM. These topics are separated from the main body of the book as they are related more to specific products. Taken together, MPLAB, CCS C, and Proteus VSM constitute a complete learning/design package, but using them effectively requires careful study of product-specific tutorials. VSM, in particular, has comprehensive, well-designed help files; and it is therefore unnecessary to duplicate that material here. Furthermore, as with all good design tools, VSM evolves very quickly, so a detailed tutorial quickly becomes outdated. Appendix D compares alternative compilers, and application development areas are identified that would suit each one. Appendix E provides a summary of CCS C syntax

www.n ewn es p res s .c o m

Introduction

xix

requirements, and Appendix F contains a list of the CCS C library functions provided with the compiler, organized in functional groups for ease of reference. These are intended to provide a convenient reference source when developing CCS C programs, in addition to the full CCS compiler reference manual. Each part of the book is designed to be as self-contained as possible, so that parts can be skipped or studied in detail, depending on the reader’s previous knowledge and interests. On the other hand, the entire book should provide a coherent narrative leading to a solid grounding in C programming for embedded systems in general.

w w w.new nespress.com

PART 1

PIC Microcontroller Systems

1.1 PIC16 Microcontrollers ●

MCU features

●

Program execution

●

RAM file registers

●

Other PIC chips

The microcontroller unit (MCU) is now big, or rather small, in electronics. It is one of the most significant developments in the continuing miniaturization of electronic hardware. Now, even trivial products, such as a musical birthday card or electronic price tag, can include an MCU. They are an important factor in the digitization of analog systems, such as sound systems or television. In addition, they provide an essential component of larger systems, such as automobiles, robots, and industrial systems. There is no escape from microcontrollers, so it is pretty useful to know how they work. The computer or digital controller has three main elements: input and output devices, which communicate with the outside world; a processor, to make calculations and handle data operations; and memory, to store programs and data. Figure 1.1 shows these in a little more detail. Unlike the conventional microprocessor system (such as a PC), which has separate chips on a printed circuit board, the microcontroller contains all these elements in one chip. The MCU is essentially a computer on a chip; however, it still needs input and output devices, such as a keypad and display, to form a working system. The microcontroller stores its program in ROM (read only memory). In the past, UV (ultraviolet) erasable programmable ROM (EPROM) was used for prototyping or

w w w.ne w nespress.com

2

Part 1

User Input

Input Peripherals

CPU

Output Peripherals

Program Download

ROM Read Only Memory

Central Processing Unit

RAM Read & Write Memory

User Output

Figure 1.1: Elements of a Digital Controller small batch production, and one-time programmable ROM for longer product runs. Programmable ROM chips are programmed in the final stages of manufacture, while EPROM could be programmed by the user. Flash ROM is now normally used for prototyping and low-volume production. This can be programmed in circuit by the user after the circuit has been built. The prototyping cycle is faster, and software variations are easier to accommodate. We are all now familiar with flash ROM as used in USB memory sticks, digital camera memory, and so on, with Gb (109 byte) capacities commonplace. The range of microcontrollers available is expanding rapidly. The first to be widely used, the Intel 8051, was developed alongside the early Intel PC processors, such as the 8086. This device dominated the field for some time; others emerged only slowly, mainly in the form of complex processors for applications such as engine management systems. These devices were relatively expensive, so they were justified only in high-value products. The potential of microcontrollers seems to have been realized only slowly. The development of flash ROM helped open up the market, and Microchip was among the first to take advantage. The cheap and reprogrammable PIC16F84 became the most widely known, rapidly becoming the number one device for students and hobbyists. On the back of this success, the Microchip product range rapidly developed and diversified. The supporting development system, MPLAB, was distributed free, which helped the PIC to dominate the low-end market. Flash ROM is one of the technical developments that made learning about microsystems easier and more interesting. Interactive circuit design software is another. The whole design process is now much more transparent, so that working systems are more quickly achievable by the beginner. Low-cost in-circuit debugging is another technique that helps get the final hardware up and running quickly, with only a modest expenditure on development tools.

www.n ewn es p res s .c o m

PIC Microcontroller Systems

3

MCU Features The range of microcontrollers now available developed because the features of the MCU used in any particular circuit must be as closely matched as possible to the actual needs of the application. Some of the main features to consider are ●

Number of inputs and outputs.

●

Program memory size.

●

Data RAM size.

●

Nonvolatile data memory.

●

Maximum clock speed.

●

Range of interfaces.

●

Development system support.

●

Cost and availability.

The PIC16F877A is useful as a reference device because it has a minimal instruction set but a full range of peripheral features. The general approach to microcontroller application design followed here is to develop a design using a chip that has spare capacity, then later select a related device that has the set of features most closely matching the application requirements. If necessary, we can drop down to a lower range (PIC10/12 series), or if it becomes clear that more power is needed, we can move up to a higher specification chip (PIC18/24 series). This is possible as all devices have the same core architecture and compatible instructions sets. The most significant variation among PIC chips is the instruction size, which can be 12, 14, or 16 bits. The A suffix indicates that the chip has a maximum clock speed of 20 MHz, the main upgrade from the original 16F877 device. These chips can otherwise be regarded as identical, the suffix being optional for most purposes. The 16F877A pin-out is seen in Figure 1.2 and the internal architecture in Figure 1.3. The latter is a somewhat simplified version of the definitive block diagram in the data sheet.

Program Execution The chip has 8 k (8096  14 bits) of flash ROM program memory, which has to be programmed via the serial programming pins PGM, PGC, and PGD. The fixed-length

w w w.ne w nespress.com

Part 1 MCLR/VPP RA0/AN0 RA1/AN1 RA2/AN2/VREF/CVREF RA3/AN3/VREF RA4/T0CKI/C1OUT RA5/AN4/SS/C2OUT RE0/RD/AN5 RE1/WR/AN6 RE2/CS/AN7 VDD VSS OSC1/CLKI OSC2/CLKO RC0/T1OSO/T1CKI RC1/T1OSI/CCP2 RC2/CCP1 RC3/SCK/SCL RD0/PSP0 RD1/PSP1

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

PIC16F874A/877A

4

40 39 38 37 36 35 34 33 32 31 30 29 28 27 26 25 24 23 22 21

RB7/PGD RB6/PGC RB5 RB4 RB3/PGM RB2 RB1 RB0/INT VDD VSS RD7/PSP7 RD6/PSP6 RD5/PSP5 RD4/PSP4 RC7/RX/DT RC6/TX/CK RC5/SDO RC4/SDI/SDA RD3/PSP3 RD2/PSP2

Figure 1.2: 16F877 Pin-out (reproduced by permission of Microchip Inc.)

instructions contain both the operation code and operand (immediate data, register address, or jump address). The mid-range PIC has a limited number of instructions (35) and is therefore classified as a RISC (reduced instruction set computer) processor. Looking at the internal architecture, we can identify the blocks involved in program execution. The program memory ROM contains the machine code, in locations numbered from 0000h to 1FFFh (8 k). The program counter holds the address of the current instruction and is incremented or modified after each step. On reset or power up, it is reset to zero and the first instruction at address 0000 is loaded into the instruction register, decoded, and executed. The program then proceeds in sequence, operating on the contents of the file registers (000–1FFh), executing data movement instructions to transfer data between ports and file registers or arithmetic and logic instructions to process it. The CPU has one main working register (W), through which all the data must pass. If a branch instruction (conditional jump) is decoded, a bit test is carried out; and if the result is true, the destination address included in the instruction is loaded into the program counter to force the jump. If the result is false, the execution sequence continues unchanged. In assembly language, when CALL and RETURN are used to implement

www.n ewn es p res s .c o m

PIC Microcontroller Systems

Flash ROM Program Memory 8192  14 bits

5

Program Counter (13 bits) Address

Stack 13 bits 8 Levels

Instructions

RAM File Registers 368  8 bits

Instruction Register File Address Program Address Working (W) Register

Literal

Status

File Select Register

Arithmetic & Logic Unit

Opcode

Status (Flag) Register

Data Bus (8 bits) EEPROM 256 bytes

MCU control lines

Instruction Decode & CPU control

Ports, Timers ADC, Serial I/O Timing control Clock

Reset Port

A

B

C

D

E

Figure 1.3: PIC16F877 MCU Block Diagram subroutines, a similar process occurs. The stack is used to store return addresses, so that the program can return automatically to the original program position. However, this mechanism is not used by the CCS C compiler, as it limits the number of levels of subroutine (or C functions) to eight, which is the depth of the stack. Instead, a simple GOTO instruction is used for function calls and returns, with the return address computed by the compiler.

w w w.new nespress.com

6

Part 1 Table 1.1: PIC16F877 Simplified File Register Map Bank 0 (000–07F)

Bank 1 (080–0FF)

Bank 2 (100–180)

Bank 3 (180–1FF)

Address

Register

Address

Register

Address

Register

Address

Register

000h

Indirect

080h

Indirect

100h

Indirect

180h

Indirect

001h

Timer0

081h

Option

101h

Timer0

181h

Option

002h

Prog. count. low

082h

Prog. count. low

102h

Prog. count. low

182h

Prog. count. low

003h

Status reg

083h

Status reg

103h

Status reg

183h

Status reg

004h

File select

084h

File select

104h

File select

184h

File select

005h

Port A data

085h

Port A direction

105h

—

185h

—

006h

Port B data

086h

Port B direction

106h

Port B data

186h

Port B direction

007h

Port C data

087h

Port C direction

107h

—

187h

—

008h

Port D data

088h

Port D direction

108h

—

188h

—

009h

Port E data

089h

Port E direction

109h

—

189h

—

00Ah

Prog. count. high

08Ah

Prog. count. high

10Ah

Prog. count. high

18Ah

Prog. count. high

00Bh

Interrupt control

08Bh

Interrupt control

10Bh

Interrupt control

18Bh

Interrupt control

10Ch– 10Fh

4 peripheral control registers

18Ch– 18Fh

4 peripheral control registers

110h– 11Fh

16 general purpose registers

190h– 19Fh

16 general purpose registers

20 peripheral control registers

08Ch– 09Fh

020h– 06Fh

80 general purpose registers

0A0h– 0EFh

80 general purpose registers

120h– 16Fh

80 general purpose registers

1A0h– 1EFh

80 general purpose registers

070h– 07Fh

16 common access GPRs

0F0h– 0FFh

Accesses 070h– 07Fh

170h– 17Fh

Accesses 070h– 07Fh

1F0h– 1FFh

Accesses 070h– 07Fh

00Ch– 01Fh

www.n ewn es p res s .c o m

20 peripheral control registers

PIC Microcontroller Systems

7

RAM File Registers The main RAM block (Table 1.1) is a set of 368 8-bit file registers, including the special function registers (SFRs), which have a dedicated function, and the general purpose registers (GPRs). When variables are created in C, they are stored in the GPRs, starting at address 0020h. The file registers are divided into four blocks, register banks 0 to 3. The SFRs are located at the low addresses in each RAM bank. Some registers are addressable across the bank boundaries; for example, the status register can be accessed in all blocks at the corresponding address in each bank. Others are addressable in only a specific page, for example, Port A data register. Some register addresses are not physically implemented. Since some registers are accessible in multiple banks, bank switching can be minimized by the compiler when assembling the machine code, thus saving program code space and execution time. For full details of the file register set, see the MCU data sheet. The program counter uses two 8-bit registers to store a 13-bit program memory address. Only the low byte at address 002h is directly addressable. The status register 003h records results from ALU (arithmetic and logic unit) operations, such as zero and carry/ borrow. The indirect and file select registers are used for indexed addressing of the GPRs. Timer0 is the timer/counter register available in all PIC MCUs, while Timer1 and Timer2 registers are in the peripheral block. The port registers are located in Bank 0 at addresses 05h (Port A) to 09h (Port E) with the data direction register for each at the corresponding location in bank 1. We can see that a total of 80  16  80  96  96  368 GPRs are available for use as data RAM. Note that the number of registers used for each C variable depends on the variable type and can range from 1 to 32 bits (1–4 GPRs).

Other PIC Chips In any embedded design, the features of the MCU need to be matched to the application requirements. The manufacturer needs to make sure that, as applications become more demanding, a more powerful device of a familiar type is available. We can see this process at work where Microchip started out producing basic chips such as the 16C84, then developed the product range to meet the growing market. PIC microcontrollers are currently available in distinct groups, designated the 10, 12, 16, 18, and 24 series. Their general characteristics are outlined in Table 1.2. The original 16 series CMOS devices were designated as 16CXX. When flash memory was introduced, they became 16FXXX. Currently, a limited number of devices are

w w w.ne w nespress.com

8

Part 1 Table 1.2: PIC Microcontroller Types MCU

Pins

10FXXX

Data Word (bits)

6

Program Memory (bytes)

8

512

Typical Instruction Set 33  12 bits

Speed MIPS

Description

2

Low pin count, small form factor, cheap, no EEPROM, no low-power, assembler program

12FXXX

8

8

2 kB

12/14 bits

0.5

Low pin count, small form factor, cheap, EEPROM, 10-bit ADC, some low power, assembler

16FXXX

64

8

14 kB

35  14 bits

5

Mid-range, UART, I2C, SPI, many low power, C or assembler program

18FXXXX

100

8

128 kB

75  16 bits

16

High range, CAN, USB J series 3V supply, C program

24FXXXX

100

16

128 kB

76  24 bits

 16

Power range, 3V supply, no EEPROM, data RAM 8 kB, C program

available in the low pin count (LPC) ranges (10/12 series), while the power ranges are expanding rapidly. In addition are those listed in the 24HXXXX range, which runs at 40 MIPS, and the dsPIC (digital signal processor) high-specification range.

1.2

PIC16 MCU Configuration

●

Clock oscillator types

●

Watchdog, power-up, brown-out timers

●

Low-voltage programming

●

Code protection

●

In-circuit debug mode

When programming the PIC microcontroller, certain operational modes must be set prior to the main program download. These are controlled by individual bits in a special

www.n ewn es p res s .c o m

PIC Microcontroller Systems

9

configuration register separated from the main memory block. The main options are as follows.

Clock Options The ‘877 chip has two main clock modes, CR and XT. The CR mode needs a simple capacitor and resistor circuit attached to CLKIN, whose time constant (C  R) determines the clock period. R should be between 3 k and 100 k, and C greater than 20 pF. For example, if R  10 kΩ and C  10 nF, the clock period will be around 2  C  R  200 µs (calculated from the CR rise/fall time) and the frequency about 5 kHz. This option is acceptable when the program timing is not critical. The XT mode is the one most commonly used, since the extra component cost is small compared with the cost of the chip itself and accurate timing is often a necessity. An external crystal and two capacitors are fitted to CLKIN and CLKOUT pins. The crystal frequency in this mode can be from 200 kHz to 4 MHz and is typically accurate to better than 50 ppm (parts per million) or 0.005%. A convenient value is 4 Mz, as this is the maximum frequency possible with a standard crystal and gives an instruction execution time of 1.000 µs (1 million instructions per second, or 1 Mip). A low-speed crystal can be used to reduce power consumption, which is proportional to clock speed in CMOS devices. The LP (low-power) mode supports the clock frequency range 32–200 kHz. To achieve the maximum clock speed of 20 MHz, a high-speed (HS) crystal is needed, with a corresponding increase in power consumption. The MCU configuration fuses must be set to the required clock mode when the chip is programmed. Many PIC chips now have an internal oscillator, which needs no external components. It is more accurate than the RC clock but less accurate than a crystal. It typically runs at 8 MHz and can be calibrated in the chip configuration phase to provide a more accurate timing source.

Configuration Options Apart from the clock options, several other hardware options must be selected. Watchdog Timer When enabled, the watchdog timer (WDT) automatically resets the processor after a given period (default 18 ms). This allows, for example, an application to escape from an endless loop caused by a program bug or run-time condition not anticipated by the

w w w.new nespress.com

10

Part 1

software designer. To maintain normal operation, the WDT must be disabled or reset within the program loop before the set time-out period has expired. It is therefore important to set the MCU configuration bits to disable the WDT if it is not intended to use this feature. Otherwise, the program is liable to misbehave, due to random resetting of the MCU. Power-up Timer The power-up timer (PuT) provides a nominal 72 ms delay between the power supply voltage reaching the operating value and the start of program execution. This ensures that the supply voltage is stable before the clock starts up. It is recommended that it be enabled as a precaution, as there is no adverse effect on normal program execution. Oscillator Start-up Timer After the power-up timer has expired, a further delay allows the clock to stabilize before program execution begins. When one of the crystal clock modes is selected, the CPU waits 1024 cycles before the CPU is enabled. Brown-out Reset (BoR) It is possible for a transitory supply voltage drop, or brown-out, to disrupt the MCU program execution. When enabled, the brown-out detection circuit holds the MCU in reset while the supply voltage is below a given threshold and releases it when the supply has recovered. In CCS C, a low-voltage detect function triggers an interrupt that allows the program to be restarted in an orderly way. Code Protection (CP) The chip can be configured during programming to prevent the machine code being read back from the chip to protect commercially valuable or secure code. Optionally, only selected portions of the program code may be write protected (see WRT_X% later). In-Circuit Programming and Debugging Most PIC chips now support in-circuit programming and debugging (ICPD), which allows the program code to be downloaded and tested in the target hardware, under the control of the host system. This provides a final test stage after software simulation has been used to eliminate most of the program bugs. MPLAB allows the same interface to be

www.n ewn es p res s .c o m

PIC Microcontroller Systems

11

used for debugging in both the simulation and in-circuit modes. The slight disadvantage of this option is that care must be taken that any application circuit connected to the programming/ICPD pins does not interfere with the operation of these features. It is preferable to leave these pins for the exclusive use of the ICPD system. In addition, a small section of program memory is required to run the debugging code. Low-Voltage Programming Mode The low-voltage programming mode can be selected during programming so that the customary high (12V) programming voltage is not needed, and the chip can be programmed at Vdd (5 V). The downside is that the programming pin cannot then be used for digital I/O. In any case, it is recommended here that the programming pins not be used for I/O by the inexperienced designer, as hardware contention could occur. Electrically Erasable Programmable Read Only Memory Many PIC MCUs have a block of nonvolatile user memory where data can be stored during power-down. These data could, for example, be the secure code for an electronic lock or smart card reader. The electrically erasable programmable read only memory (EEPROM) can be rewritten by individual location, unlike flash program ROM. The ‘877 has a block of 256 bytes, which is a fairly typical value. There is a special read/write sequence to prevent accidental overwriting of the data.

Configuration in C The preprocessor directive #fuses is used to set the configuration fuses in C programs for PICs. A typical statement is #fuses XT,PUT,NOWDT,NOPROTECT,NOBROWNOUT

The options defined in the standard CCS C 16F877 header file are Clock Type Select Watchdog Timer Enable Power Up Timer Enable Program Code Protect In Circuit Debugging Enable Brownout Reset Enable Low Voltage Program Enable EEPROM Write Protect

LP, XT, HS, RC WDT, NOWDT PUT, NOPUT PROTECT, NOPROTECT DEBUG, NODEBUG BROWNOUT, NOBROWNOUT LVP, NOLVP CPD, NOCPD

Program Memory Write Protect (with percentage protected)

WRT_50%, WRT_25%, WRT_5%, NOWRT

w w w.new nespress.com

12

Part 1

The default condition for the fuses if no such directive is included is equivalent to #fuses RC,WDT,NOPUT,BROWNOUT,LVP,NOCPD,NOWRT

This corresponds to all the bits of configuration register being default high.

1.3

PIC16 MCU Peripherals

●

Digital I/O

●

Timers

●

A/D converter

●

Comparator

●

Parallel slave port

●

Interrupts

Basic digital input and output (I/O) in the microcontroller uses a bidirectional port pin. The default pin configuration is generally digital input, as this is the safest option if some error has been made in the external connections. To set the pin as output, the corresponding data direction bit must be cleared in the port data direction register (e.g., TRISD). Note, however, that pins connected to the analog-to-digital (A/D) converter default to the analog input mode. The basic digital I/O hardware is illustrated in simplified form in Figure 1.4, with provision for analog input. The 16 series reference manual shows equivalent circuits for individual pins in more detail. For input, the current driver output is disabled by loading the data direction bit with a 1, which switches off the tristate gate. Data are read into the input data latch from the outside world when its control line is pulsed by the CPU in the course of a port register read instruction. The data are then copied to the CPU working register for processing. When the port is set up for output, a 0 is loaded into the data direction bit, enabling the current output. The output data are loaded into the data latch from the CPU. A data 1 at the output allows the current driver to source up to 25 mA at 5 V, or whatever the supply voltage is (2–6 V). A data 0 allows the pin to sink a similar current at 0 V.

www.n ewn es p res s .c o m

PIC Microcontroller Systems Write TRIS bit

Data Direction Latch

Write Data bit

Output Data Latch

Read Data bit

Input Data Latch

CPU Data Bus

13

Tristate Output Enable Output Current Driver

Analog Input Multiplexer

Figure 1.4: I/O Pin Operation The 16F877 has the following digital I/O ports available: Port A RA0–RA5 Port B RB0–RB7 Port C RC0–RC7 Port D RD0–RD7 Port E RE0–RE2 Total digital I/O available

6 bits 8 bits 8 bits 8 bits 3 bits 33 pins

Most of the pins have alternate functions, which are described later.

Timers Most microcontrollers provide hardware binary counters that allow a time interval measurement or count to be carried out separately from program execution. For example, a fixed period output pulse train can be generated while the program continues with another task. The features of the timers found in the typical PIC chip are represented in Figure 1.5, but none of those in the ‘877 has all the features shown. The count register most commonly is operated by driving it from the internal instruction clock to form a timer. This signal runs at one quarter of the clock frequency; that is, one instruction takes four cycles to execute. Therefore, with a 4-MHz clock, the timer counts in microseconds (1-MHz instruction clock). The number of bits in the timer (8 or 16)

w w w.ne w nespress.com

14

Part 1 Capture Signal Instruction Clock External Pulse

Clock Source Select

Prescaler (Clock Divide)

Capture Register

Binary Counter

Postscaler (Output Divide)

Compare Register

Match Flag

Timer Overflow/ Time-out (Interrupt) Flag

Figure 1.5: General Timer Operation determines the maximum count (256 or 65536, respectively). When the timer register overflows and returns to zero, an overflow flag bit is set. This flag can be polled (tested) to check if an overflow has occurred or an interrupt generated, to trigger the required action. To modify the count period, the timer register can be preloaded with a given number. For example, if an 8-bit register is preloaded with the value 156, a time-out occurs after 256  156  100 clocks. Many timer modules allow automatic preloading each time it is restarted, in which case the required value is stored in a preload register during timer initialization. A prescaler typically allows the timer input frequency to be divided by 2, 4, 8, 16, 32, 64, or 128. This extends the maximum count proportionately but at the expense of timer precision. For example, the 8-bit timer driven at 1 MHz with a prescale value of 4 counts up to 256  4  1024 µs, at 4 µs per bit. A postscaler has a similar effect, connected at the output of the counter. In the compare mode, a separate period register stores a value that is compared with the current count after each clock and the status flag set when they match. This is a more elegant method of modifying the time-out period, which can be used in generating a pulse width modulated (PWM) output. A typical application is to control the output power to a current load, such as a small DC motor—more on this later. In the capture mode, the timer count is captured (copied to another register) at the point in time when an external signal changes at one of the MCU pins. This can be used to measure the length of an input pulse or the period of a waveform. The ’877 has three counter/timer registers. Timer0 has an 8-bit counter and 8-bit prescaler. It can be clocked from the instruction clock or an external signal applied to RA4. The prescaler can also be used to extend the watchdog timer interval (see later), in which case it is not available for use with Timer0. Timer1 has a 16-bit counter and prescaler and can be clocked internally or externally as per Timer0. It offers capture and

www.n ewn es p res s .c o m

PIC Microcontroller Systems

Analog Inputs

Multiplexer

Input Volts 0-Vf

Setup ADC

ANx

Read ADC

Analogto-Digital Converter Reference Volts

15

8-bit or 16-bit Integer Result

Vref

Figure 1.6: ADC Operation compare modes of operation. Timer2 is another 8-bit counter but has both a prescaler and postscaler (up to 1:16) and a compare register for period control. Further details are provided in Interfacing PIC Microcontrollers by the author and the MCU data books. When programming in C, only a limited knowledge of timer operation is necessary, as the C functions generally take care of the details.

A/D Converter Certain PIC pins can be set up as inputs to an analog-to-digital converter (ADC). The ’877 has eight analog inputs, which are connected to Port A and Port E. When used in this mode, they are referred to as AD0–AD7. The necessary control registers are initialized in CCS C using a set of functions that allow the ADC operating mode and inputs to be selected. An additional “device” directive at the top of the program sets the ADC resolution. An analog voltage presented at the input is then converted to binary and the value assigned to an integer variable when the function to read the ADC is invoked. The default input range is set by the supply (nominally 0–5 V). If a battery supply is used (which drops over time) or additional accuracy is needed, a separate reference voltage can be fed in at AN2 (Vref) and optionally AN3 (–Vref). If only Vref is used, the lower limit remains 0 V, while the upper is set by the reference voltage. This is typically supplied using a zener diode and voltage divider. The 2.56 V derived from a 2V7 zener gives a conversion factor of 10 mV per bit for an 8-bit conversion. For a 10-bit input, a reference of 4.096 V might be convenient, giving a resolution of 4 mV per bit. The essentials of ADC operation are illustrated in Figure 1.6.

Comparator The comparator (Figure 1.7) is an alternative type of analog input found in some microcontrollers, such as the 16F917 used in the mechatronics board described later.

w w w.ne w nespress.com

16

Part 1 Vc Comparator Status Bit Vc  Vc

Vc

Figure 1.7: Comparator Operation

Chip Select Read Write EXTERNAL Data  8

Interrupt Parallel Slave Port

INTERNAL Data  8

Figure 1.8: Parallel Slave Port Operation It compares the voltage at a pair of inputs, and a status bit is set if the C pin is higher than C–. The comparator status bit may also be monitored at an output pin. The ’917 has two such comparator modules; they are enabled using a system function to set the operating mode. The ’877 has no comparators, so the ADC must be used instead.

Parallel Slave Port The parallel slave port on the ’877 chip is designed to allow parallel communications with an external 8-bit system data bus or peripheral (Figure 1.8). Port D provides the eight I/O data pins, and Port E three control lines: Read, Write, and Chip Select. If data are to be input to the port, the pin data direction is set accordingly and data presented to Port D. The chip select input must be set low and the data latched into the port data register by taking the write line low. Conversely, data can be read from the port using the read line. Either operation can initiate an interrupt.

Interrupts Interrupts can be generated by various internal or external hardware events. They are studied in more detail later in relation to programming peripheral operations. However, at this stage, it is useful to have some idea about the interrupt options provided within the MCU. Table 1.3 lists the devices that can be set up to generate an interrupt.

www.n ewn es p res s .c o m

PIC Microcontroller Systems

17

Table 1.3: Interrupts Sources in the PIC16F877 Interrupt Source

Interrupt Trigger Event

Interrupt Label

Timer0

Timer0 register overflow

INT_TIMER0

Timer1

Timer1 register overflow

INT_TIMER1

CCP1

Timer1 capture or compare detected

INT_CCP1

Timer2

Timer2 register overflow

INT_TIMER2

CCP2

Timer2 capture or compare detected

INT_CCP2

RB0/INT pin

Change on single pin RB0

INT_EXT

Port B pins

Change on any of four pins, RB4–RB7

INT_RB

Parallel Slave Port

Data received at PSP (write input active)

INT_PSP

Analog Converter

A/D conversion completed

INT_AD

Analog Comparator

Voltage compare true

INT_COMP

UART Serial Port

Received data available

INT_RDA

UART Serial Port

Transmit data buffer empty

INT_TBE

SPI Serial Port

Data transfer completed (read or write)

INT_SSP

I2C Serial Port

Interface activity detected

INT_SSP

Bus collision detected

INT_BUSCOL

Nonvolatile data memory write complete

INT_EEPROM

Timers

Ports

Serial

2

I C Serial Port Memory EEPROM

The most effective way of integrating timer operations into an application program is by using a timer interrupt. Figure 1.9 shows a program sequence where a timer is run to generate an output pulse interval. An interrupt routine (ISR) has been written and assigned to the timer interrupt. The timer is set up during program initialization and started by preloading or clearing it. The main program and timer count then proceed concurrently, until a time-out occurs and the interrupt is generated. The main program is suspended and the ISR executed. When finished, the main program is resumed at the original point. If the ISR contains a statement to toggle an output bit, a square wave could be obtained with a period of twice the timer delay. When interrupts are used in assembly language programs, it is easier to predict the effect, as the programmer has more direct control over the exact sequence of the ISR.

w w w.ne w nespress.com

18

Part 1 Program Execution

1 Start Counter Statement Program Execution

2 Run Counter until Overflow

3 Time-out Interrupt 4 Jump to ISR 7 Continue

5 Time-out Process (Interrupt Service Routine)

6 Return from Interrupt

Figure 1.9: Timer Interrupt Process A C program is generated automatically by the compiler, so the precise timing that results from an interrupt is less obvious. For this reason, the use of a real-time operating system (RTOS) is sometimes preferred in the C environment, especially when programs become more complex. In fact, C was originally developed for precisely this purpose, to write operating systems for computers. C interrupts are considered further in Section 3.2, and RTOS principles are outlined in Section 5.4.

1.4 PIC16 Serial Interfaces ●

USART asynchronous link

●

SPI synchronous bus

●

I2C synchronous bus

Serial data connections are useful because only one or two signal wires are needed, compared with at least eight data lines for a parallel bus plus control signals. The typical

www.n ewn es p res s .c o m

PIC Microcontroller Systems

19

HOST PC

PIC MCU Line Driver Interface

TX1 Transmit RX1 Receive

RX2 TX2

/ 12 V

COM PORT Ground

Ground

Figure 1.10: USART Operation Bit Period 1 Time

0 Idle

Start Bit

Bit 0

Bit 1

Bit 2

Bit 3

Bit 4

Bit 5

Bit 6

Bit 7

Stop Bit

Figure 1.11: USART RS232 Signal PIC microcontroller offers a choice of serial interfaces. The best one for any given communication channel depends on the distance between nodes, the speed, and the number of hardware connections required.

USART The universal synchronous/asynchronous receive transmit (USART) device is typically used in asynchronous mode to implement off-board, one-to-one connections. The term asynchronous means no separate clock signal is needed to time the data reception, so only a data send, data receive, and ground wires are needed. It is quick and simple to implement if a limited data bandwidth is acceptable. A common application is connecting the PIC chip to a host PC for uploading data acquired by the MCU subsystem (Figure 1.10). The USART link can send data up to 100 meters by converting the signal to higher-voltage levels (typically 12V). The digital signal is inverted and shifted to become bipolar (symmetrical about 0 V, line negative when inactive) for transmission. The PIC 16F877 has a dedicated hardware RS232 port, but CCS C allows any pin to be set up as an RS232 port, providing functions to generate the signals in software. The basic form of the signal has 8 data bits and a stop and start bit. The bit period is set by the baud rate. A typical value is 9600 baud, which is about 10 k bits per second. The bit period is then about 100 µs, about 1 byte per millisecond, or 1 K byte per second.

w w w.ne w nespress.com

20

Part 1

The data are transferred between shift registers operating at the same bit rate; the receiver has to be initialized to the same baud setting as the transmitter. Assuming we are looking at TTL level data, in the idle state, the line is high. When it goes low, the receiver clock is started, the data are sampled in the middle of each following data bit period, and data are shifted into the receive register (Figure 1.11). RS232 is used to access the standard serial LCD display, in which case, line drivers are not necessarily required. ASCII characters and control codes are sent to operate the display, which has its own MCU with a serial interface to receive and decode the data. It then drives the pixel array to display alphanumeric characters. Most LCDs may also be set up to display simple bit-mapped graphics. In simulation mode, an RS232 virtual terminal provides a convenient way of generating alphanumeric input into the MCU for testing. The ASCII codes are listed in Table 2.5.

Master Serial Data Out, SDO Serial Data In, SDI Serial Clock, SCK Slave 1

Slave Select Outputs

Slave 2

SDO SDI SCK

SDO SDI SCK

!SS

!SS

SS1 SS2 SS3

Figure 1.12: SPI Connections

SDO/SDI

7

6

5

4

3

2

SCK

0

Data Bits

Clock

Figure 1.13: SPI Signals

www.n ewn es p res s .c o m

1

PIC Microcontroller Systems

21

SPI Bus The serial peripheral interface (SPI) bus provides high-speed synchronous data exchange over relatively short distances (typically within a set of connected boards), using a master/slave system with hardware slave selection (Figure 1.12). One processor must act as a master, generating the clock. Others act as slaves, using the master clock for timing the data send and receive. The slaves can be other microcontrollers or peripherals with an SPI interface. The SPI signals are ●

Serial Clock (SCK)

●

Serial Data In (SDI)

●

Serial Data Out (SDO)

●

Slave Select (!SS)

To transfer data, the master selects a slave device to talk to, by taking its SS line low. Eight data bits are then clocked in or out of the slave SPI shift register to or from the master (Figure 1.13). No start and stop bits are necessary, and it is much faster than RS232. The clock signal runs at the same speed as the master instruction clock, that is, 5 MHz when the chip is running at the maximum 20 MHz (16 series MCUs).

I2C Bus The interintegrated circuit (I2C) bus is designed for short-range communication between chips in the same system using a software addressing system. It requires only two signal wires and operates like a simplified local area network. The basic form of the hardware and data signal are illustrated in Figures 1.14 and 1.15. The I2C slave chips are attached to a two-wire bus, which is pulled up to logic 1 when idle. Passive slave devices have their register or location addresses determined by a combination of external input address code pins and fixed internal decoding. If several memory devices are connected to the bus, they can be mapped into a continuous address space. The master sends data in 8-bit blocks, with a synchronous clock pulse alongside each bit. As for SPI, the clock is derived from the instruction clock, up to 5 MHz at the maximum clock rate of 20 MHz. To send a data byte, the master first sends a control code to set up the transfer, then the 8-bit or 10-bit address code, and finally the data. Each byte has a start and acknowledge bit, and each byte must be acknowledged before the next is sent, to improve reliability.

w w w.ne w nespress.com

22

Part 1 5 V

Master

Slave 1

Slave 2

etc. SDA SCL

Figure 1.14: I2C Connections Start SDA

Acknowledge

Address/Data Bits 7

6

5

4

3

2

1

0

SCL

Figure 1.15: I2C Signals The sequence to read a single byte requires a total of 5 bytes to complete the process, 3 to set the address, and 2 to return the data. Thus, a substantial software overhead is involved. To alleviate this problem, data can be transferred in continuous blocks (memory page read/write), which speeds up the transmission.

1.5

PIC16 MPLAB Projects

●

MPLAB C Project

●

Project Files

The PIC microcontroller program comprises a list of machine code instructions, decoded and executed in sequence, resulting in data movement between registers, and arithmetic and logic operations. MCU reset starts execution at address zero, and the instructions are executed in address order until a program branch is decoded, at which point a new target address is derived from the instruction. A decision is made to take the branch or continue in sequence based on the result of a bit condition test. This process is described in detail in PIC Microcontrollers by the author. The program could be written in raw binary code, but this would require manual interpretation of the instruction set. Therefore, the machine code is generated from assembly code, where each instruction has a corresponding mnemonic form that is

www.n ewn es p res s .c o m

PIC Microcontroller Systems

23

more easily recognizable, such as MOVF05,W (move the data at Port A to the working register). This low-level language is fine for relatively simple programs but becomes time consuming for more complex programs. In addition, assembly language is specific to a particular type of processor and, therefore, not “portable.” Another level of abstraction is needed, requiring a high-level language. C has become the universal language for microcontrollers. It allows the MCU memory and peripherals to be controlled directly, while simplifying peripheral setup, calculations, and other program functions. All computer languages need an agreed set of programming language rules. The definitive C reference is The C Programming Language by Kernighan and Ritchie, second edition, incorporating ANSI C standards, published in 1983. A processor-specific compiler converts the standard syntax into the machine code for a particular processor. The compiler package may also provide a set of function libraries, which implement the most commonly needed operations. There is variation between compilers in the library function syntax, but the general rules are the same. Usually, a choice of compilers is available for any given MCU family. Options for the PIC at time of writing are Microchip’s own C18 compiler, Hi-Tech PICC, and CCS C. CCS was selected for the current work because it is specifically designed for the PIC MCU, supports the 16 series devices, and has a comprehensive set of peripheral driver functions.

MPLAB C Project The primary function of the compiler is to take a source text file PROJNAME.C and convert it to machine code, PROJNAME.HEX. The hex file can then be downloaded to the PIC MCU. The source file must be written in the correct form, observing the conventions of both ANSI C and the specific compiler dialect. The first program we see later in the tutorial section is shown in Listing 1.1. This can be typed into any text editor, but we normally use the editor in MPLAB, the standard Microchip development system software package. This provides file management, compiler interface and debugging facilities for PIC projects, and may be downloaded free of charge from www.microchip.com. Before starting work, the complier also has to be installed. The compiler file path is set in MPLAB by selecting Project, Set Language Tool Locations. The compiler can then be selected via the Project, Select Language Tool Suite menu option. Browse for the compiler executable file (CCSC.EXE) and select it.

w w w.ne w nespress.com

24

Part 1

Listing 1.1 A Simple C Program /* OUTBYTE.C MPB 2-1-07 V1.0 */ #include "16F877A.h"

// MCU select

void main( ) { output_D(255);

// Main block // Switch on outputs

}

A project folder called PROJNAME should now be created to hold the files that will be generated and a new project created with the same name. A workspace window appears with file project folders named Source Files, Header Files, and Other Files. Open a new source window, type in the program header comment at the top of the program as shown in Listing 1.1, and save the file as PROJNAME.C in the project folder. Type the rest of the program in and save it. The source code must now be attached to the project, by right clicking on Source Files workspace folder to open the “add file” dialog. Note, in the source code, a statement #include 16F877A.h. This defines the specific chip for which the program is created and refers to a header file supplied with the compiler. This file must be included because it holds information about the chip register addresses, labeling, and so on (it can be viewed in any text editor and is listed in full in Section 2.8). The file should be copied from the Devices folder in the CCS C program file folder set into the project folder. It can then be attached to this project by right clicking on the Header Files folder. We are now ready to compile the program by clicking on the Compile button in the MPLAB main toolbar. The compiler execution dialog briefly appears and, ideally, a “build succeeded” message is displayed. The program can now be tested in simulation mode by selecting Debugger, Select Tool, MPLAB SIM. This brings up a control panel in the main toolbar. Press Reset, and a green arrow indicates the execution point at the top of the program. Run seems to have little effect, but if View, Special Function Registers is selected, Port D can be seen to have been written with the data FF. To see the program listed in assembler, select View, Disassembler Listing. This shows an assembler version of the program derived from the compiler output.

www.n ewn es p res s .c o m

PIC Microcontroller Systems

25

Project Files Let us now look at some of files created in the project folder. Some, which are concerned with MPLAB project management, do not need to be considered at this stage. outbyte.c The source code file is created in a text edit window, in line with the compiler and ANSI C syntax rules. For viewing outside MPLAB, it can be “opened with” (right click) Notepad. The syntax requirements are detailed in the C programming sections later.

The hex file, the program download file, is shown in Listing 1.2, as it is displayed in a text editor. The fact that it is readable shows that it is stored as ASCII characters. It must be converted by the program downloading utility to actual binary code for loading into program flash memory in the MCU. If the hex listing is compared with the machine code column in the Disassembler listing visible in Figure 1.16, we can see that the first 4 bytes (eight digits) contain the start address 0000. The program code starts at the ninth digit, but the bytes of the four-digit instruction code are reversed. Therefore, the first instruction is code 3000 (MOVLW 0), but this is listed in the hex file as 0030, indicating that, in program memory, the low byte is at the lower (even) address, which is logical. The whole program is 40 bytes (80 hex digits), ending at 6300 and highlighted in bold. Additional configuration data follow, and the file ends with the MCU identifier.

outbyte.hex

This contains the intermediate assembly language version of the program, plus the configuration fuse settings. When viewed in a text window, it can be seen that the configuration code is 3F73h, consistent with the program code. outbyte.lst

This file contains the machine code plus source file information that allows debugging tools to display the source code and variables using their original labels. This file is attached to the MCU in Proteus VSM to support source code debugging. outbyte.cof

Listing 1.2 Program hex File :1000000000308A0004280000840183131F30830518 :1000100083161F149F141F159F1107309C00880121 :08002000FF3083128800630029 :02400E00733FFE :00000001FF ;PIC16F877A

w w w.ne w nespress.com

26

Part 1

Figure 1.16: Screenshot of MPLAB Project The error file provides debugging messages, which are displayed in the Output, Build window after compilation. outbyte.err

The symbol map shows the register locations in which the program variables are stored. outbyte.sym outbyte.mcp

This is the MPLAB project information file.

outbyte.mcw

This is the MPLAB workspace information file.

outbyte.pjt

This is the CCS compiler project information file.

1.6

PIC16 Program and Debug

●

Programming the chip

●

In-circuit debugging

●

Design package

www.n ewn es p res s .c o m

PIC Microcontroller Systems

27

Figure 1.17: PICkit2 Demo System Hardware (reproduced by permission of Microchip Inc.) Once the compiler has produced the hex file, it can be downloaded to the target application board. However, it is generally preferable to test it first by software simulation. This means running the program in a virtual MCU to test its logical function. This can be done within MPLAB (tabular output) or using a third party debugging tool such as Proteus VSM (graphical output). More details on simulation are provided in Appendix C, and VSM interactive simulation is referred to throughout the text to provide circuit schematics and debugging facilities.

Programming A low-cost programmer available at the time of writing is the Microchip PICkit2 programmer (Figure 1.17). This connects to the USB port of the host PC, with the programming module plugging direct into the target PCB. The six-way in-circuit serial programming (ICSP) connector, between the programmer module and the target board, must be designed into the application circuit. An in-line row of pins provides the programmer connection to the target MCU, as shown in Figure 1.18. Pin 1 carries the programming voltage (12–14 V) and is connected to pin Vpp, which doubles as the MCU reset input, !MCLR. Pin 4 (PGD) carries the program data and pin 5 (PGC), the program clock. Any other circuits connected to these pins must be designed with care, so that they do not interfere with the programmer. The USB output provides the target board power, up to a limit of 500 mA, on pins 2 and 3. If necessary, a separate target board supply must be provided.

w w w.ne w nespress.com

28

Part 1 Reset 10k

ICSP Interface

1 2 3 4 5

MCU Vpp/!MCLR Vdd Vss PGD PGC

Vdd Vss Board 5 V Supply

Figure 1.18: ICSP Target Board Connections

Figure 1.19: PICkit2 Programmer Dialog

Once the hardware is connected up and the programmer drivers loaded, the programming utility window (Figure 1.19) can be opened by running PICkit2.exe file, selected from the Programmer menu. The hex file created by the compiler is imported via the file menu and downloaded using the write button. The target program is run by checking the On box.

www.n ewn es p res s .c o m

PIC Microcontroller Systems

29

Figure 1.20: Microchip ICD2 Module

Host PC MPLAB Development System  C Compiler

USB

ICD2 Interface

6-WAY connector

PIC MCU Target System

Figure 1.21: ICD2 Program and Debug System

Debugging If in-circuit debugging is required, the Microchip MPLAB ICD2® in-circuit debugger (Figures 1.20 and 1.21) is recommended. This allows the application program to be tested in real hardware by using the same MPLAB debugging tools used in the simulation mode: source code display, run, stop, step, reset, breakpoints, and variable watch windows. The target system needs its own power supply and an ICD connector. With power supplied to the target, load the application project files. Select Debugger, Select Tool, MPLAB ICD2. The debug control panel appears with controls to run, step, and reset (Figure 1.22). If the program is recomplied after a change in the source code, the target can be automatically reprogrammed. Use of breakpoints is generally the most useful debugging technique in C, as it allows complete blocks of assembler to be executed at full speed. These are enabled by right clicking on the source code and indicated by a red marker. Once set, they can be temporarily enabled and disabled. The watch window, selected from the View menu, allows program variable values to be monitored as the program progresses.

w w w.ne w nespress.com

30

Part 1

Figure 1.22: ICD Debugging Windows When debugging has been completed, the chip must be reprogrammed for the final time by selecting Programmer, Select Tool, MPLAB ICD2. Then, hit the Program Target Device button. When done, the program can be stopped and started using the Hold In Reset and Release From Reset buttons. When the ICD pod is disconnected, the program should auto-run in the target system.

Design Package The components of the ECAD design package used in this book are listed below. The PCB implementation tools are not described further, as they are outside the scope of this programming guide. ●

Circuit schematic capture (Proteus ISIS)

●

Interactive circuit simulation (Proteus VSM)

●

PCB layout design (Proteus ARES)

●

PIC development system (Microchip MPLAB)

●

PIC C Compiler (Custom Computer Services CCS C)

●

PIC programming and in-circuit testing (Microchip ICD2)

www.n ewn es p res s .c o m

PIC Microcontroller Systems

31

Assessment 1 5 points each, total 100 1.

List five consumer products that typically include a microcontroller.

2.

Identify the five functional elements of a microcontroller.

3.

Explain why flash ROM is an important technology in microcontrollers.

4.

State five important characteristics of a microcontroller that should be considered when selecting the best part for a given application.

5.

Describe briefly the process of program execution in a microcontroller, referring to the role of the program memory, instruction register, program counter, file registers, and working register.

6.

State the function of the following registers in the PIC16F877: 02h, 03h, 09h, 89h, 20h.

7.

Explain the significance of the following abbreviations in relation to the configuration of the PIC microcontroller: RC, XT, WDT, PUT, NOWRT.

8.

Explain the function of the following elements of the PIC I/O circuit: tristate gate, current driver, data direction latch, input data latch, output data latch.

9.

A 16-bit PIC hardware timer is driven from the internal clock signal, and the MCU is operating with a 20-MHz crystal. Calculate the preload value required to produce an interrupt every 10 ms.

10.

If an analog-to-digital converter has a positive input reference voltage of 2.048 V and is set up as for 8-bit conversion, calculate the resolution of the ADC in millivolts per bit and the output code if the input voltage is 1.000 V.

11.

Refer to Figure 1.9, and briefly explain the timer interrupt process and why it is useful.

12.

Sketch the RS232 signal that transmits the character X (ASCII code 01011000) on a line operating at 12V. Indicate the stop and start bits as S and P.

13.

Explain the difference between an asynchronous and synchronous data transmission by reference to RS232 and SPI.

14.

Explain the difference between hardware and software addressing as used by SPI and I2C.

w w w.ne w nespress.com

32

Part 1 15.

Explain briefly why SPI is generally faster than I2C.

16.

A page of plain text contains about 1000 ASCII characters. Estimate the minimum time required to transmit this page over a 9600-baud RS232 link and an SPI line, under the control of an MCU running at 20 MHz, stating any assumptions made.

17.

State the function of each of the C project files that have the following extension: C, HEX, COF, LST, and ERR.

18.

State the function of the five connections in the PIC in-circuit programming and debugging interface.

19.

Study the content of the dissembler window in Figure 1.22, and state the function of the five visible windows.

20.

List a minimum set of development system hardware and software components required to create a C application for the PIC microcontroller.

Assignments 1 Assignment 1.1 Download the data book for the PIC16F87X MCUs from www.microchip.com. Study Figure 1.2, the PIC16F877 block diagram. Describe in detail the sequence of events that occurs when the data code for 25510 (111111112) from a machine code instruction is output to Port D. Refer to the role of the program memory, program counter, instruction register, instruction decoder, file register addressing, internal data bus, and clock. What path must the data follow to get from the program memory to Port C? Describe the setup required in Port C to enable the data byte to be observed on the port pins (Figure 1.4). Refer, if necessary, to PIC Microcontrollers: An Introduction to Microelectronics by the author.

Assignment 1.2 Research a list of SPI and I2C peripherals that might be useful in constructing PIC applications. Identify typical memory, interfacing, and sensor chips that use these interfaces and summarize the range of devices available for each interface.

www.n ewn es p res s .c o m

PIC Microcontroller Systems

33

Assignment 1.3 Download and install MPLAB development system from www.microchip.com, and the demo C complier for the PIC16F877 from www.ccsinfo.com. Create the project OUTBYTE as described in Section 1.5. Enter the source code and save in the project folder. Copy the header file into the same folder. Compile the program and view the files created in the folder. Check that the .hex, .lst, and .cof files have been created. Test the program in simulation mode; arrange the MPLAB windows as seen in Figure 1.6 and check that Port C is loaded with the output byte FFh. Study the assembler version of the program; note the number of instructions required to implement the C output statement. Reset and step through the program, noting the two phases: initialization and loop. Change the output number in the source code from 255 to 8510, recompile, and run. What is the Port D output now in binary and hex?

w w w.ne w nespress.com

PART 2

C Programming Essentials

2.1

PIC16 C Getting Started

●

Simple program and test circuit

●

Variables, looping, and decisions

●

SIREN program

Programming PIC microcontrollers in C is introduced here using the simplest possible programs, assuming that the reader has no previous experience of the language. The CCS compiler uses ANSI standard syntax and structures. However, a compiler for any given microcontroller uses its own variations for processor-specific operations, particularly input and output processes. These are fundamental to MCU programs and so will be introduced from the start.

Simple Program Microcontroller programs contain three main features: ●

Sequences of instructions

●

Conditional repetition of sequences

●

Selection of alternative sequences

The following basic programs show how these processes are implemented in CCS C. The program in Listing 2.1 is a minimal program that simply sets the bits of an 8-bit port in the 16F877 to any required combination.

w w w.ne w nespress.com

36

Part 2

Listing 2.1 A Program to Output a Binary Code // OUTNUM.C Outputs an 8-bit code at Port D in the 16F877 MCU #include "16F877A.h"

// MCU header file

void main() { output_D(255); }

// Main block start // Switch on outputs

The essential source code components can be identified. The include statement tells the compiler to incorporate the header file for a particular MCU. It provides information about the chip hardware features that the compiler needs to tailor the program. The keywords void main indicate the start of the main program block, and the associated braces (curly brackets) enclose the program statements. This program only contains one statement, the function call output_D(nnn)that sends a binary code to Port D.

Program Creation The development process was introduced in Part 1, and further details are provided in Appendices A, B, and C. Briefly, the program project is created as follows: 1. Assuming that MPLAB and CCS C compiler are installed, create a folder for the project files, and an MPLAB project called OUTNUM. Copy the MCU header file 16F877.h from the CCS header file folder to the project folder. 2. Write the program (OUTNUM.C) in the source code edit window of MPLAB, referring to the compiler manual for the correct syntax, and save it in the project folder. Assign the source code and header file in the project window. 3. Build the project (compile and link all files) to create OUTNUM.COF. Correct any syntax and linker errors. 4. Run the program in MPSIM simulation mode. Use the source code debugging window to trace the program execution and the watch window to track the CPU variables. Correct any logical errors. 5. Optionally, the program can be tested in Proteus VSM, which once installed, can be selected from the debugger menu.

www.n ewn es p res s .c o m

C Programming Essentials

37

Figure 2.1: ISIS Dialog to Attach the Program

Program Testing The program could be tested by downloading to a suitable hardware target system, but it is preferable to debug it first in simulation mode, either in MPLAB or, preferably, in Proteus VSM. In the VSM schematic capture and cosimulation module ISIS, the target PIC is selected from the component library and placed on the schematic. The application file OUTNUM.COF previously created by the compiler is attached to it (Figure 2.1) and the schematic saved in the project folder. When the simulation is run, the state of the outputs is indicated by red and blue indicators. Although not absolutely necessary for program testing in simulation mode, a set of LEDs with their load resistors are attached to Port D, since these are required in the actual hardware to display the outputs (Figure 2.2). No other circuit components or connections are required at this stage, since the simulation runs correctly without a clock circuit. In the real hardware, the clock circuit must be added and !MCLR input tied to Vdd (⫹5 V). Here, the clock frequency is set in the MCU properties dialog when the program is attached. To take advantage of the full debugging facilities of MPLAB, Proteus VSM can be run from within MPLAB by installing it in the debug tool menu. For this, a plug-in needs to be downloaded from www.labcenter.co.uk. When selected, the simulator runs in a VSM viewer window (Figure 2.3).

w w w.ne w nespress.com

38

Part 2 U1 13 14 1 2 3 4 5 6 7 8 9 10

OSC1/CLKIN OSC2/CLKOUT MCLR/VPP/THV

RB0/INT RB1 RB2 RB3/PGM RB4 RB5 RB6/PGC RB7/PGD

RAO/ANO RA1/AN1 RA2/AN2VREF RA3/AN3/VREF⫹ RA4/TOCKI RC0/T10S0/T1CKl RA5/AN4/SS RC1/T10Si/CCP2 RC2/CCP1 REO/AN5/RD RC3/SCK/SCL RE1/AN6/WR RC4/SDI/SDA RE2/AN7/CS RC5/SDO RC6/TX/CK RC7/RX/DT RD0/PSP0 RD1/PSP1 RD2/PSP2 RD3/PSP3 RD4/PSP4 RD5/PSP5 RD6/PSP6 RD7/PSP7

33 34 35 36 37 38 39 40 15 16 17 18 23 24 25 26 19 20 21 22 27 28 29 30

1 2 3 4 5 6 7 8 9 10

20 19 18 17 16 15 14 13 12 11

PlC16F877

9 8 7 6 5 4 3 2 1

Figure 2.2: OUTBYTE Test Circuit with Output LEDs

Program Analysis The main program contains just one statement, output_D(255). This means output the number 25510 as a binary code to Port D of the chip, setting all pins high (obviously, any number between 0 and 255 results in a corresponding output bit combination). All statements are terminated with a semicolon. This statement is a function call, which means the compiler gets the machine code for this operation from the standard set of built-in functions supplied with the compiler. This particular function is one of a set of library functions of the form output_x(n), where x is the port number (A–E), and n is the output value (0–255). The general form of the C function is function_name(). Any information needed by the function, the function parameter(s), is inserted into the parentheses. The main program starts with the key words void main() and is enclosed between curly brackets, or braces, as they are officially known. All program blocks are enclosed

www.n ewn es p res s .c o m

C Programming Essentials

39

Figure 2.3: MPLAB IDE Screenshot by braces, allowing a multilevel hierarchical structure. Main is a special function that contains the main program block, within which all lower-level functions are contained. These can return a result to the calling function, but the keyword void preceding the function name main means that this function returns no result, since it is the top-level function. The preprocessor directive #include "16F877A.h" instructs the compiler to include this processor-specific file at the top of the program. It contains labels for the registers in the selected MCU, so that the compiler knows where to store MCU control variables. Comments can be enclosed between slash/star (/*...*/) control characters or can follow a double slash (//), in which case the comment is terminated with a line return. The program header should contain as much information as possible to assist the user and facilitate future modifications. Ideally, line comments should describe the effect of the statement in the target system. The meaning of the C program is independent of the layout on the page. Only the sequence of characters is significant to the compiler. However, in practice, the program source code should be arranged to make it as easy to understand as possible. Spaces or tabs can be used to indent each block (program level), and the open and close braces should be lined up in the same column so that the brace pairs can be matched up when

w w w.new nespress.com

40

Part 2

checking the program. This makes subsequent source code debugging and modification easier. The benefits of good layout become more obvious later, when more complex programs are developed. By tradition, C source code is written mainly in lower case, with upper case used for certain key words.

2.2 PIC16 C Program Basics ●

Variables

●

Looping

●

Decisions

The purpose of an embedded program is to read in data or control inputs, process them, and operate the outputs as required. Input from parallel, serial, and analog ports are held in the file registers for temporary storage and processing; and the results are output later on, as data or a signal. The program for processing the data usually contains repetitive loops and conditional branching, which depends on an input or calculated value.

Variables Most programs need to process data in some way, and named variables are needed to hold their values. A variable name is a label attached to the memory location where the variable value is stored. When working in assembly language, a register label acts as the variable name and has to be assigned explicitly. In C, the variable label is automatically assigned to the next available location or locations (many variable types need more than 1 byte of memory). The variable name and type must be declared at the start of the program block, so that the compiler can allocate a corresponding set of locations. Variable values are assumed to be in decimal by default; so if a value is given in hexadecimal in the source code, it must be written with the prefix 0x, so that 0xFF represents 255, for example. A variable called x is used in the program in Listing 2.2, VARI.C. Longer labels are sometimes preferable, such as “output_value,” but spaces are not allowed. Only alphanumeric characters (a–z, A–Z, 0–9) and underscore, instead of space, can be used. By default, the CCS compiler is not case sensitive, so ‘a’ is the same as ‘A’ (even though the ASCII code is different). A limited number of key words in C, such as main and include, must not be used as variable names.

www.n ewn es p res s .c o m

C Programming Essentials

41

Listing 2.2 Variables /* Source code file: VARI.C Author, date, version: MPB 11-7-07 V1.0 Program function: Outputs an 8-bit variable Simulation circuit: OUTBYTE.DSN ***************************************************************/ #include "16F877A.h" void main() { int x; x=99; output_D(x);

// Declare variable and type // Assign variable value // Display the value in binary

}

The variable x is an 8-bit integer with whole number values 0–25510. The value in binary can be seen when it is output at an 8-bit port. Generally, C integers (int) are stored as 16bit values, but C for 8-bit microcontrollers uses a default 8-bit integer format. In Program VARI.C, an initial value is assigned to the variable (99), which is then used in the output function. The point here is that the variable value can now be modified without having to change the output function call itself. In the program, an 8-bit variable x is declared and assigned a value 99 using the “equals” operator. It is then output to Port D using the standard output function.

Looping Most real-time applications need to execute continuously until the processor is turned off or reset. Therefore, the program generally jumps back at the end to repeat the main control loop. In C this can be implemented as a “while” loop, as in Listing 2.3. The condition for continuing to repeat the block between the while braces is contained in the parentheses following the while keyword. The block is executed if the value, or result of the expression, in the parentheses is not zero. In this case, it is 1, which means the condition is always true; and the loop repeats endlessly. This program represents in simple form the general structure of embedded applications, where an initialization phase is followed by an endless control loop. Within the loop, the value of x is incremented (x++). The output

w w w.ne w nespress.com

42

Part 2

Listing 2.3 Endless Loop // Source code file: // Program function:

ENDLESS.C Outputs variable count

#include "16F877A.h" void main() { int x;

// Declare variable

while(1) { output_D(x); x++; }

// Loop endlessly // Display value // Increment value

}

therefore appears to count up in binary when executing. When it reaches the maximum for an 8-bit count (11111111 ⫽ 255), it rolls over to 0 and starts again.

Decision Making The simplest way to illustrate basic decision making is to change an output depending on the state of an input. A circuit for this is shown in Figure 2.4, INBIT.DSN. The switch generates an input at RC0 and RD0 provides the test output. The common keyword for selection in many high level languages is IF. Program IFIN.C (Listing 2.4) has the usual endless “while” loop but contains a statement to switch off Port D initially. The input state is read within the loop using the bit read function input(PIN_C0). This assigns the input value 1 or 0 to the variable x. The value is then tested in the if statement and the output set accordingly. Note that the test uses a double equals to differentiate it from the assignment operator used in the previous statement. The effect of the program is to switch on the output if the input is high. The switch needs to be closed before running to see this effect. The LED cannot be switched off again until the program is restarted.

Loop Control The program can be simplified by combining the input function with the condition statement as follows: if(input(PIN_C0))output_high(PIN_D0);

www.n ewn es p res s .c o m

C Programming Essentials

43

U1 13 14 1 2 3 4 5 6 7 8 9 10

OSC1/CLKIN OSC2/CLKOUT MCLR/VPP/THV

RB0/INT RB1 RB2 RB3/PGM RB4 RB5 RB6/PGC RB7/PGD

RAO/ANO RA1/AN1 RA2/AN2VREF RA3/AN3/VREF⫹ RA4/TOCKI RC0/T10S0/T1CKl RA5/AN4/SS RC1/T10Si/CCP2 RC2/CCP1 REO/AN5/RD RC3/SCK/SCL RE1/AN6/WR RC4/SDI/SDA RE2/AN7/CS RC5/SDO RC6/TX/CK RC7/RX/DT RD0/PSP0 RD1/PSP1 RD2/PSP2 RD3/PSP3 RD4/PSP4 RD5/PSP5 RD6/PSP6 RD7/PSP7

33 34 35 36 37 38 39 40 15 16 17 18 23 24 25 26 19 20 21 22 27 28 29 30

R1 10k

D1 220R LED-RED

PlC16F877

Figure 2.4: INBIT.DSN Test Circuit with Input Switch

Listing 2.4 IF Statement // IFIN.C Tests an input #include "16F877A.h" void main() { int x; output_D(0); while(1) { x = input(PIN_C0); if(x==1)output_high(PIN_D0); }

// Declare variable // Clear all outputs // Loop always // Get input state // Change output

}

w w w.new nespress.com

44

Part 2

Listing 2.5 Conditional Loop // WHILOOP.C Input switch controls output flashing #include "16F877A.h" #use delay (clock=1000000) // MCU clock = 1 MHz void main() { while(1) { while(input(PIN_C0)) { output_high(PIN_D0); delay_ms(300); output_low(PIN_D0); delay_ms(500); } output_low(PIN_D0); } }

// Repeat while switch open

// Delay 0.3s // Delay 0.5s // Switch off LED

The conditional sequence can also be selected by a while condition. In Program WHILOOP.C (Listing 2.5), the input is tested in the loop condition statement and the output flashed on and off while the switch is open (input high). If the switch is closed, the flash loop is not executed and the LED is switched off. The program also demonstrates the delay function. If this were absent, the loop would execute in just a few microseconds, since each machine code instruction takes 4 µs at a clock rate of 1 MHz.The flashing of the output would be invisible. The delay required (in milliseconds) is given as the function parameter, and a reference to the function library is provided at the start of the program with the #use directive. This allows the compiler to find the library routine delay_ms(). The clock speed of the target processor must be given in the use directive, so that the correct delay is calculated within the function. Compare the syntax of the I/O statements. The function output_high(PIN_nn) is an output operation to set the port pin high. The function input(PIN_nn) is an input function that returns a 1 or 0 from the input pin, which can be tested by an IF or WHILE statement. The ports are initialized automatically within these functions.

www.n ewn es p res s .c o m

C Programming Essentials

45

Listing 2.6 FOR Loop // FORLOOP.C Repeat loop a set number of times #include "16F877A.h" #use delay (clock=1000000) void main() { int x; while(input(PIN_C0)){};

// Wait until switch closed

for (x=0; x