# Using Encoders

This page is a  tutorial on using encoders.  First, a brief overview of the hardware so we all understand what is going on, then into algorithms and software to read the encoders.

While encoders can be constructed with other sensing mechanisms, like mechanical or magnetic; we'll discuss the optical encoder as an example.

Encoders may measure other motions than rotary motion (e.g. linear), we will use a rotary encoder for an example as that is what you will probably be most likely to use to measure wheel rotation.

There are two basic kinds of encoder information:  absolute and relative.  Absolute provides a code which tells you the exact position of the wheel.  Incremental encoders just measure how far the wheel has moved.  Incremental encoders are used for measuring robot wheel travel.

Two examples of the innards of an incremental optical rotary encoder are shown above.  In each case, a light beam is emitted and sensed by a photo detector.  In the left picture, the light beam passes through slots in the sensing wheel; in the right picture, the light beam reflects from light and dark portions of the sensing wheel providing strong and weak reflections.  Circuitry, either within the encoder package itself or supplied by you, will take the signal sensed by the photo detector and turn it into a nice 0 to 5 vdc signal suitable for interfacing to your processor.

The picture on the right shows how the photo detector sees the light and dark lines (or holes) and what the resulting voltage is.   The light and dark horizontal strips represents the bars (or holes) on the rotary encoder strip.  Whenever a light strip is in front of the detector, the output voltage switches to high (5 vdc).  Whenever a dark strip is in front, the voltage is low (0 vdc).

Your processor can read these pulses and count them (by various methods to be described later).  By knowing how many pulses are detected per wheel revolution, and the circumference of your wheel, you can calculate how far the robot has moved.  Usually.  But, there is one deficiency with this simple encoder.  The processor will receive pulses that look the same whether the wheel is turning forward or reverse.  Hence, the processor doesn't know whether to add or subtract the pulses from the distance traveled without some additional information.  Your software may be able to ASSUME which direction the wheel is turning (i.e. if the motor is being commanded forward, then probably the encoder pulses are counting forward), but using a more sophisticated encoder solves the problem directly.

A "quadrature" encoder has one additional detector.  Note that in the drawing to the right, detector A is pointed at the start of a white sector and detector B is pointed to the center of a black sector.  This offset provides the additional information.
If the black/white strip is passing from right to left (moving left), the processor will get a pulse to count from detector A as it reaches the beginning of a white strip (in the position shown).  At that time, detector B is looking at a black strip and is putting out a 0 logic signal.  Using your imagination (since I don't want to redraw the picture), if the black/white strip is moving to the right instead,  when the A detector encounters the beginning of a white strip, detector B will be in the middle of a white strip.  Hence, the direction of motion when detector A gets a pulse can be determined by looking at the status of detector B.    Note that if your are building your own quadrature encoder, the A and B detectors don't have to be measuring the same light strip (that is, right next to each other), they can be located anywhere around the wheel as long as they have the same offset of one half the width of a black or white strip.

You may find an occasional encoder with 5 wires (one ground, one power, two signals for the A & B detectors, and a fifth wire called the Index.  This signal provides a pulse when the encoder is oriented in one specific direction.  This permits you to use an incremental in a manner similar to an absolute encoder; by rotating the encoder until the index mark is detected then counting incremental pulses away from the index.

#### So, how you determine distance in software?

First, you have to detect the pulses. Two common methods exist to read a pulsing signal to a processor.  Polling and interrupts.

But, there is a better way.   Many processors have interrupt capabilities.  An interrupt is a hardware/software device which causes a software function to occur when something happens in hardware.  Specifically, whenever the detector A pulse goes high, the processor can be interrupted such that it suspends its ongoing navigation or motor control task, runs a special software routine (called an interrupt handler) which can compute the new distance traveled. When the interrupt handler is done, the processor automatically returns to the task it was working on when the interrupt occurred.   Sounds much easier doesn't it.  Actually, it takes more software to set it up, but it just does the job SO much better.

We'll get to some code examples in a bit, but first lets look at the logic which can be used to read the encoders.

With one detector:

When leading edge of pulse occurs:
IF (motor command is forward) THEN distance = distance + 1
IF (motor command is reverse) THEN distance = distance -1

Note that if the motor command is not forward or reverse, distance is not changed.  This avoids the possible problem of the robot stopping where the detector is right on the edge of a white strip and might be tripping on and off with no real motion.

Another problem is that if the motor is rolling along and is commanded to zero, it might coast a little before stopping.  The pseudo code above would miss the pulses that occur during coasting.  One way to minimize this problem is to slowly decelerate to a stop so there is little or no coasting after the motor is set to zero.

When leading edge of pulse occurs:
IF (detector B is high) THEN distance = distance + 1
IF (detector B is low) THEN distance = distance -1

This logic will count all wheel motion properly.  Even coasting after motor shutdown, and even if the motor is commanding reverse and the wheel happens to be going forward (probably more coasting).  The problem of stopping on the edge of a white sector still exists.  I haven't found it to be a problem, but it could be that the encoders I use take care of it with some hysteresis.

Improved resolution:

The reflective sample encoder in the first picture on this page (right side) has 16 white sectors per revolution.  The counting schemes described so far count only transitions to a white sector so 16 counts per revolution is the best they can do.
Some processors (including my favorite the Motorola types like HC11 and HC12 series) can generate interrupts both when a signal goes high OR when it goes low OR for both high and low transitions.  This says that we can double the resolution of the encoder by counting both transitions.

This could be handled by two separate interrupts:

When leading edge of pulse occurs:        (transition to high interrupt)
IF (detector B is high) THEN distance = distance + 1
IF (detector B is low) THEN distance = distance -1

When trailing edge of pulse occurs:         (transition to low interrupt)
IF (detector B is low) THEN distance = distance + 1
IF (detector B is high) THEN distance = distance -1

Or by a single interrupt if it can be generated by either transition:

When leading or trailing edge of pulse occurs:    (transition to high or low interrupt)
IF (detector A is high AND detector B is high) THEN distance = distance + 1
IF (detector A is high AND detector B is low) THEN distance = distance -1
IF (detector A is low AND detector B is low) THEN distance = distance + 1
IF (detector A is low AND detector B is high) THEN distance = distance -1

(I'm sure you can find more concise ways of coding this!!)

The ultimate:

Now, if you were able to do interrupts on both high and low transitions, it is possible to add one (or two) more interrupts based on detector B (which switches half way between the detector A pulses) which will give double the distance resolution again.  I'll leave it to you to figure out the additional code required.

Hardware:

All these improved schemes aren't free (except for the software).

The simplest pulse counter takes just one input pin (with interrupt capability) per encoder.

Doubling the resolution by reading high and low transitions will require one more pin. Either another interrupt pin if you can't read high and low on the same pin), or another pin to read the status of the detector A signal.

And doubling the resolution again may require one or two more interrupt pins depending on whether you can read high and low on the same pin.

Of course, if you are reading the detectors by polling, I guess you can do it all with just two input pins.

All the schemes above for doubling the encoder resolution depend on the output signals from the detectors being close to a square wave. This is because if you are going to measure distance from the leading edge to the trailing edge to the next leading edge, they should be equal distances apart.  A commercially available encoder will probably be square.
But, if you made your own encoder, it could be that you are getting a short pulse during the white segment and a long pulse during the dark (or vice versa).  So, take a look at your pulses before assuming you can improve your resolution.

Computing Speed:

Sample Code:

A program written by  for the Basic Stamp follows which shows a way to read single detector encoders from two wheels using polling. Go to Lior Elazary's website for more information on this program.

''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
'''
'''
''' AUTHORS: Lior Elazary (lelazary@yahoo.com)
'''
''' LOG: 7/3/01 Created (Lior Elazary)
'''
'''
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''

' Wheels Vars

Right_Wheel         Con 0     ' The right wheel pin connection
Left_Wheel           Con 1     ' The left wheel pin connection

Right_Encoder Var     IN2     ' The pin the right encoder is attached
Left_Encoder Var       IN3     ' The pin the left encoder is attached

Right_Stop     Con 650     ' The right stop value determined by simple.bs2
Left_Stop       Con 642

Right_Speed     Var Word
Left_Speed       Var Word

Right_Encode_Speed     Var byte
Left_Encode_Speed       Var word

Last_Right_Encoder       Var Bit
Last_Left_Encoder         Var Bit

Odom         Var word

X     Var byte
T     Var byte

Input 2
Input 3

Speed     Con 30

Move_Forward:
Right_Speed = Right_Stop - Speed         'Set the right and left speed
Left_Speed = Left_Stop + Speed
Odom = 0 ' Reset odometer

Move_Forward_Loop:
Right_Encode_Speed = 0 'reset encode speed values
Left_Encode_Speed = 0
For x = 1 to 46 'loop 46 times to make about 1s
pulsout Right_Wheel, Right_Speed 'set the servos speed
Pulsout Left_Wheel, Left_Speed
For t = 1 to 10 ' Loop 10 times to make ~21ms of loop
If Last_Right_Encoder = Right_Encoder THEN Cont_Right 'count changes from 1 to 0 and 0 to 1
Last_Right_Encoder = Right_Encoder
Right_Encode_Speed = Right_Encode_Speed + 1
Cont_Right:
If Last_Left_Encoder = Left_Encoder THEN Cont_Left
Last_Left_Encoder = Left_Encoder
Left_Encode_Speed = Left_Encode_Speed + 1
Cont_Left:

Next
Next                                                  ' ~1 sec total time for loop (21ms+1ms) * 46 = 1.012s
pulsout Right_Wheel, Right_Speed     ' Set the servos speed again to give about 21ms for calculations
Pulsout Left_Wheel, Left_Speed

Odom = Odom + ((Right_Encode_Speed + Left_Encode_Speed) / 2)     ' Set the odometer to the average values of the two speeds

'''
''' Speed is at encode_speed/32 RPS
'''
debug "ODOM:", dec Odom, " RS:", dec Right_Encode_Speed, " ", dec (Right_Encode_Speed/32), " LS:", dec Left_Encode_Speed, CR 'Display results

Goto Move_Forward_Loop

And a program to read two encoders using interrupts on a Motorola 68HC912B32 is here

The program defines two distance variables, odomL and odomR.  It has an interrupt for each of the left and right wheels.  These interrupts increment or decrement the odom counters based on the status of detector B.  The program also requires initialization of the timer to generate interrupts when encoder pulses are received.

/* Software for Ebot 7/10/01
Alex Brown rbirac@home.com

written in ImageCraft ICC12 C for the Adapt912 board (68HC912B32)
This code extract shows how wheel encoders are run using interrupts
*/

/* I/O usage
13     PT0     Drive wheel encoder input A Left
12     PT1     Drive wheel encoder input A Right
11     PT2     Drive wheel encoder input B Left
10     PT3     Drive wheel encoder input B Right
*/

//Global Variable definitions

//Encoders
long int     odomL;     //raw count left encoder
long int     odomR;    //raw count right encoder
//---------------------------------------------------------------------------
//Drive wheel encoder interrupt Left (TC0)

void odom_handler_L(void)

{ TFLG1 = 0x01;                                           //Reset timer 0 interrupt flag
if (PORTT & 0x04) odomL = odomL + 1;     //increment raw encoder count
else odomL = odomL - 1;
}
(return from interrupt)

//---------------------------------------------------------------------------
//Drive wheel encoder interrupt Right (TC1)

void odom_handler_R(void)

{ TFLG1 = 0x02;                                              //Reset timer 1 interrupt flag
if (PORTT & 0x08) odomR = odomR - 1;         //increment raw encoder count
else odomR = odomR + 1;
}
(return from interrupt)

/*---------------------------------------------------------------------------
Initialization of timer for encoders
TC0 used for drive wheel encoder left capture (chan A)
TC1 used for drive wheel encoder right capture (chan A)
TC2 used for drive wheel encoder left (direction, chan B)
TC3 used for drive wheel encoder right (direction, chan B)
*/
void timerinit()
{
TMSK1 = 0x03;             //enable timer interrupts TC0 & TC1
TMSK2 = 0x2B;            //disable overflow intr, enable pull ups,
//prescale = 8, reset after OC7 compare
TCTL4 = 0x05;              //TC0 & TC1 to cap on rising edge
TSCR = 0x80;                //enable timer
}

main()
{
timerinit();                         //initialize timer

//---------------------------------------------------------------------------
// Control program

while (1)
{
/* Do any tasks in background mode. All of my control programs run under
a real time interrupt driven program, not shown.*/
};

return(0);
}