Line Following Buggy Code

by | Jan 18, 2018 | 0 comments

In this project we learn how to code our buggy to follow a course made from a dark line on a large white sheet of paper.

To start with we need to know how the buggy works.

1. How does it work?


The two motors are quite simple. They are connected by two wires to a power source such as a set of batteries.

When the power is turned on, the motor turns. If the power source is connected the other way, the motor runs in reverse. You can also force the motor to stop (brake). This means that each motor can be in four possible states:

  • Coast (no current)
  • Forward (current turned on)
  • Back (current turned on in reverse)
  • Brake (current shorted)

Motor Driver Board

It would be very hard to control the motors by turning each one on and off and swapping the wires around by hand. The motor driver board does this for us.

The power from the battery pack is connected to the board and the board connects to both motors. The board can arrange for power to go to one or both motors, and in either direction. It takes its instructions from the micro:bit which plugs into the board.


The micro:bit has a set of connectors (also called pins) on its edge connector. You can see 5 main pins, labelled 0, 1, 2, 3V and GND. If you look closer, you can see more, smaller pins in between. These pins connect to the motor driver board when we plug it in.

In our code we can alter the state of these pins, a bit like turning them on and off. In this way we communicate with the driver board and tell it what to do with the motors:

  • To turn a pin ON we set it to 1
  • To turn a pin OFF we set it to 0

We need to know which pin does what so that we can program the correct ones.

These are the pins that affect the motors:

Looking back at our code, we can see where we use these:

# Set both motors to forward

For example, pin8.write_digital(0) means: set Pin1 OFF

We then need to pause to let the motors run for a length of time (in milliseconds):

# Run the motors for 3 seconds (5000 milliseconds)

We can also read information from the pins, which we’ll use to detect the dark lines on the course later in the project.

Complete code for the line-following buggy. You’ll need a suitable course for the buggy which you can create using a large sheet of white paper and black tape or marker pen.