# Connexions

You are here: Home » Content » 1.3 - Introduction to Programming the ez430

### Lenses

What is a lens?

#### Definition of a lens

##### Lenses

A lens is a custom view of the content in the repository. You can think of it as a fancy kind of list that will let you see content through the eyes of organizations and people you trust.

##### What is in a lens?

Lens makers point to materials (modules and collections), creating a guide that includes their own comments and descriptive tags about the content.

##### Who can create a lens?

Any individual member, a community, or a respected organization.

##### What are tags?

Tags are descriptors added by lens makers to help label content, attaching a vocabulary that is meaningful in the context of the lens.

#### Affiliated with (What does "Affiliated with" mean?)

This content is either by members of the organizations listed or about topics related to the organizations listed. Click each link to see a list of all content affiliated with the organization.
• TI MSP430

This module is included inLens: Texas Instruments MSP430
By: Texas Instruments

"This is a basic tutorial on how to program the basic digital peripherals on the ez430."

Click the "TI MSP430" link to see all content affiliated with them.

Click the tag icon to display tags associated with this content.

### Recently Viewed

This feature requires Javascript to be enabled.

### Tags

(What is a tag?)

These tags come from the endorsement, affiliation, and other lenses that include this content.

# 1.3 - Introduction to Programming the ez430

Module by: Naren Anand. E-mail the author

Summary: This is a basic tutorial on how to program the basic digital peripherals on the ez430.

## Configuring Digital I/O: Introduction

Digital I/O, such as the LED, is configured by modifying several registers pertaining to the port that they are attached to. Check the datasheet to find the respective port number of the peripheral you which to control. For more detailed information about Digital I/O on the MSP430 check Chapter 6: Digital I/O of the ez430's user guide. The basic logic behind seemingly trivial process of turning the LED on and off is the same behind the operation of every peripherial on the tool.

First, we must assign the direction of the corresponding I/O pins. This is done by setting the direction register, PxDIR, with the appropriate bit. By default, all I/O pins are assigned to be inputs.

• Bit = 0: The port pin is switched to input direction.
• Bit = 1: The port pin is switched to output direction.

On the ez430 the LED is located on port 1. The port number will correspond the to x value in registers such as PxIN, PxOUT, or PxDIR. Therefore, if we wanted to define the direction of a pin on port 1 we would write to P1DIR.

## A Useful Tangent: Common Bitwise C Operations

In order to modify values of registers you must first understand the following commonly used C logic operations:

~A
A | B
A & B
A ^ B
A |= B
A &= ~B
A ^=B


In C, the NOT: ~, OR: |, AND: & and XOR: ^ operators are all bitwise. This means that the operations are done bit by bit to the binary values of the two operands.

### Note:

The prefix "0b" to a number means that that number is binary. Similarly an "0x" prefix means that the number is hexadecimal.
Here are examples of the bitwise operations:
int A = 0b1101;
int B = 0b0101;
int C;

/*
The results of these operations are very straightforward.  If we are dealing with the "|"
operator then we OR together each bit to make the result. This means 0b1101 | 0b0101 is
computed as [1 OR 0, 1 OR 1, 0 OR 0, 1 OR 1] which is [1,1,1,1] thus the result is 0b1101;
*/

C = ~A;    // The value of C is 0b0010
C = A | B; // The value of C is 0b1101
C = A & B; // The value of C is 0b0101
C = A ^ B; // The value of C is 0b1000


Operators such as += or -=, implemented as A += B, are short forms for A = A + B. This is translated to "take the current value of A, add it to B, and finally store that result back into A." For -= it similarly translates to "subtract B from A and store the result back to A." If "@" is some operator, than A @= B would be "@ together A and B and store the result back into variable A."

If we combine the use of these two aspects of C then the aformentioned logic operations that are listed at the top of this section begin to make sense. The following examples will help you figure out why they are useful to us when we attempt to configure any register on our microcontroller. It is imperative that you understand how these function. You will use them in every program you write because these operations allow you to modify single bits of a register to modify a specific register and change a peripheral's settings.

## Configuring Digital I/O: Examples

### Exercise 1

How do we switch the pin (P1.0) corresponding to the LED to be an output?

Output pins may be toggled using the PxOUT register. The LED is turned on by setting its corresponding register bit high.

### Exercise 2

What code would turn on the LED without modifying any other bits in the register? What would turn it back off?

### Exercise 3

What would be the proper syntax for toggling the value of P1.0 so that we can turn the light on if it is off or vice versa?

### Exercise 4

Now, write the full C program to turn on the LED. Do the following:

1. Create a new project in Workbench as previosuly described
2. Do not delete the default code in the main.c file except for the return 0;, which is not necessary. All of your programs will use this as a skeleton
3. Include the correct header file by adding the following line at the top of the main.c file:
#include "msp430x20x3.h";
4. Consider defining macros for commonly used register values. For example, if we add #define led_on ~0x01 to the top of the file (after the #include) we may call led_on every time we wanted the value ~0x01. Similarly we may add #define led_off 0x01 to use when we wanted 0x01.
5. Complete the program. It is as simple as it seems; no more than two lines of code in the main function are necessary

## Content actions

PDF | EPUB (?)

### What is an EPUB file?

EPUB is an electronic book format that can be read on a variety of mobile devices.

For detailed instructions on how to download this content's EPUB to your specific device, click the "(?)" link.

### Add module to:

My Favorites (?)

'My Favorites' is a special kind of lens which you can use to bookmark modules and collections. 'My Favorites' can only be seen by you, and collections saved in 'My Favorites' can remember the last module you were on. You need an account to use 'My Favorites'.

| A lens I own (?)

#### Definition of a lens

##### Lenses

A lens is a custom view of the content in the repository. You can think of it as a fancy kind of list that will let you see content through the eyes of organizations and people you trust.

##### What is in a lens?

Lens makers point to materials (modules and collections), creating a guide that includes their own comments and descriptive tags about the content.

##### Who can create a lens?

Any individual member, a community, or a respected organization.

##### What are tags?

Tags are descriptors added by lens makers to help label content, attaching a vocabulary that is meaningful in the context of the lens.

| External bookmarks

### Reuse / Edit:

Reuse or edit module (?)

#### Check out and edit

If you have permission to edit this content, using the "Reuse / Edit" action will allow you to check the content out into your Personal Workspace or a shared Workgroup and then make your edits.

#### Derive a copy

If you don't have permission to edit the content, you can still use "Reuse / Edit" to adapt the content by creating a derived copy of it and then editing and publishing the copy.