Built-in project · Arduino Uno R3

Level crossing on an Arduino Uno

Two IR detectors start alternating red lamps and a bell, a gate servo comes down after a delay, and everything stops once the train has cleared the far detector. The whole build, an Arduino Uno and 8 more parts, runs here in your browser on the firmware below; open it in the editor to change the wiring or the code and run it again.

Teaching? Assign it to your class in one click.

Intermediate About 35 minutes to build and run. Runs in your browser. Free, and no account needed.

The parts retail for about $37. On Mokxi they're free.

The circuit runs here once the page has loaded.

What you'll learn

  • Phases of a sequence: idle, warning, clearing
  • Timing several actions with millis() at once
  • Moving a servo slowly, one degree at a time
  • Alternating flashers without delay
  • Ignoring a sensor for a while after use
  • Difficulty: Intermediate
  • Time: About 35 minutes
  • Board: Arduino Uno R3
  • Parts: 11

How it works

Two slot sensors watch the track: west on pin 3 and east on pin 2. A pin reads HIGH while something sits in the beam. When either one trips, two red lamps on pins 5 and 4 start alternating and a piezo bell on pin 8 rings.

The gate servo on pin 9 waits 3 seconds, then lowers one degree every 40 ms, about 3.6 seconds. The delay lets a car already on the crossing get out.

The sensor the train enters by is not the one it leaves by. When the far sensor has been quiet for 2 seconds, the gate rises and the lamps and bell stop.

Wiring table

Every connection, pin by pin, read from the circuit itself. Each row joins the pin on the left to the pin on the right, by a jumper wire or a breadboard strip.

Part and pinConnects to
Hobby servo pin GNDArduino Uno R3 pin GND
Photo interrupter, slot (1) pin GNDArduino Uno R3 pin GND
Photo interrupter, slot (2) pin GNDArduino Uno R3 pin GND
Resistor, 220 Ω (1) pin 2Arduino Uno R3 pin GND
Resistor, 220 Ω (2) pin 2Arduino Uno R3 pin GND
Piezo speaker pin 2Arduino Uno R3 pin GND
Hobby servo pin PWMArduino Uno R3 pin 9
Piezo speaker pin 1Arduino Uno R3 pin 8
LED, red (1) pin AArduino Uno R3 pin 5
LED, red (2) pin AArduino Uno R3 pin 4
Photo interrupter, slot (1) pin SIGArduino Uno R3 pin 3
Photo interrupter, slot (2) pin SIGArduino Uno R3 pin 2
Hobby servo pin VCC5 V
Photo interrupter, slot (1) pin VCC5 V
Photo interrupter, slot (2) pin VCC5 V
Resistor, 220 Ω (1) pin 1LED, red (1) pin C
Resistor, 220 Ω (2) pin 1LED, red (2) pin C

The code

The firmware exactly as the editor opens it. Change a line there and press Run: it compiles in the browser.

sketch.ino · Arduino Uno R3
// Level crossing: two infrared beam detectors, alternating red lamps, a gate servo and a bell.
//
//   pin 3   west detector (a slotted beam sensor, HIGH while a car breaks the beam)
//   pin 2   east detector, the same
//   pin 5   left red lamp     pin 4   right red lamp
//   pin 9   the gate servo    pin 8   the bell, a piezo
//
// The sequence follows the prototype. A train reaches either detector: the lamps
// start alternating and the bell rings at once, and the gate waits a few seconds
// before it comes down, slowly, so a car already on the crossing can clear it.
// The train trips the far detector as it leaves; once that detector has seen
// nothing for CLEAR_MS (the gaps between cars are short), the gate rises and the
// lamps and bell stop. The detector a train leaves by is ignored for a moment, so
// the last car rolling off it does not start the crossing again.
//
// The lamps flash 50 times a minute each, inside the range U.S. rules set for
// real crossing lights. Many crossings stop the bell once the gates are down;
// RING_WHILE_DOWN chooses.
//
// Mokxi has no train: click a detector's card into its slot to put a car in the beam.

#include <Servo.h>

const int WEST_PIN = 3;
const int EAST_PIN = 2;
const int LAMP_LEFT = 5;
const int LAMP_RIGHT = 4;
const int BELL_PIN = 8;
const int GATE_PIN = 9;

const int GATE_UP = 90;
const int GATE_DOWN = 0;
const unsigned long GATE_DELAY_MS = 3000;  // lamps and bell first, then the gate
const unsigned long GATE_STEP_MS = 40;     // one degree per step: about 3.6 s to lower
const unsigned long FLASH_MS = 600;        // each lamp on for 0.6 s: 50 flashes a minute
const unsigned long CLEAR_MS = 2000;       // the exit detector quiet this long
const unsigned long IGNORE_MS = 4000;      // then ignore detectors while things settle
const bool RING_WHILE_DOWN = false;

enum Phase { IDLE, WARNING, CLEARING };
Phase phase = IDLE;
int exitPin = -1;              // the detector the train will leave by
bool exitSeen = false;
unsigned long phaseAt = 0, lastExit = 0, idleAt = 0, lastGateStep = 0, lastStrike = 0;
int gateAngle = GATE_UP;
Servo gate;

bool over(int pin) { return digitalRead(pin) == HIGH; }

void startWarning(int enteredBy) {
  phase = WARNING;
  phaseAt = millis();
  exitPin = enteredBy == WEST_PIN ? EAST_PIN : WEST_PIN;
  exitSeen = false;
  Serial.println(enteredBy == WEST_PIN ? "train from the west: warning" : "train from the east: warning");
}

void setup() {
  Serial.begin(9600);
  pinMode(WEST_PIN, INPUT);  // the sensor board has its own pull-up
  pinMode(EAST_PIN, INPUT);
  pinMode(LAMP_LEFT, OUTPUT);
  pinMode(LAMP_RIGHT, OUTPUT);
  gate.attach(GATE_PIN);
  gate.write(GATE_UP);
  Serial.println("Level crossing ready");
}

void loop() {
  unsigned long now = millis();

  if (phase == IDLE) {
    if (now - idleAt > IGNORE_MS || idleAt == 0) {
      if (over(WEST_PIN)) startWarning(WEST_PIN);
      else if (over(EAST_PIN)) startWarning(EAST_PIN);
    }
  } else {
    // Wait for the train at the far detector, then for that detector to stay clear.
    if (over(exitPin)) {
      exitSeen = true;
      lastExit = now;
    }
    if (phase == WARNING && exitSeen && now - lastExit >= CLEAR_MS) {
      phase = CLEARING;
      Serial.println("train clear: gate rising");
    }
  }

  // The gate: down after the delay while warning, back up when clearing.
  int target = (phase == WARNING && now - phaseAt >= GATE_DELAY_MS) ? GATE_DOWN : GATE_UP;
  if (gateAngle != target && now - lastGateStep >= GATE_STEP_MS) {
    lastGateStep = now;
    gateAngle += gateAngle < target ? 1 : -1;
    gate.write(gateAngle);
    if (gateAngle == GATE_DOWN) Serial.println("gate down");
    if (gateAngle == GATE_UP && phase == CLEARING) {
      phase = IDLE;
      idleAt = now;
      Serial.println("gate up: crossing idle");
    }
  }

  // Lamps alternate while the crossing is active, and go dark when it is idle.
  bool active = phase != IDLE;
  bool leftOn = (now / FLASH_MS) % 2 == 0;
  digitalWrite(LAMP_LEFT, active && leftOn ? HIGH : LOW);
  digitalWrite(LAMP_RIGHT, active && !leftOn ? HIGH : LOW);

  // The bell: a short strike every 300 ms, like an electronic crossing bell.
  bool ringing = active && (RING_WHILE_DOWN || gateAngle != GATE_DOWN);
  if (ringing && now - lastStrike >= 300) {
    lastStrike = now;
    tone(BELL_PIN, 1800, 60);
  }
  delay(5);
}

Code walkthrough

The key functions of the sketch, and what each one does.

over sketch.ino

A tiny helper. It returns true when the given sensor pin reads HIGH, which means something is breaking the beam. The sketch uses it to keep the code short and clear.

bool over(int pin) { return digitalRead(pin) == HIGH; }

startWarning sketch.ino

Begins the crossing sequence. It records the time, switches to the warning phase, and picks the opposite detector as the exit. It also clears exitSeen and prints which side the train came from.

void startWarning(int enteredBy) {
  phase = WARNING;
  phaseAt = millis();
  exitPin = enteredBy == WEST_PIN ? EAST_PIN : WEST_PIN;
  exitSeen = false;
  Serial.println(enteredBy == WEST_PIN ? "train from the west: warning" : "train from the east: warning");
}

loop sketch.ino

Checks the sensors, then runs three things on their own timers. The gate steps toward its target. The lamps swap every FLASH_MS (600). The bell strikes every 300 ms, and stops once the gate is down because RING_WHILE_DOWN is false.

void loop() {
  unsigned long now = millis();

  if (phase == IDLE) {
    if (now - idleAt > IGNORE_MS || idleAt == 0) {
      if (over(WEST_PIN)) startWarning(WEST_PIN);
      else if (over(EAST_PIN)) startWarning(EAST_PIN);
    }
  } else {
    // Wait for the train at the far detector, then for that detector to stay clear.
    if (over(exitPin)) {
      exitSeen = true;
      lastExit = now;
    }
    if (phase == WARNING && exitSeen && now - lastExit >= CLEAR_MS) {
      phase = CLEARING;
      Serial.println("train clear: gate rising");
    }
  }

  // The gate: down after the delay while warning, back up when clearing.
  int target = (phase == WARNING && now - phaseAt >= GATE_DELAY_MS) ? GATE_DOWN : GATE_UP;
  if (gateAngle != target && now - lastGateStep >= GATE_STEP_MS) {
    lastGateStep = now;
    gateAngle += gateAngle < target ? 1 : -1;
    gate.write(gateAngle);
    if (gateAngle == GATE_DOWN) Serial.println("gate down");
    if (gateAngle == GATE_UP && phase == CLEARING) {
  // ... 20 more lines in the editor

Troubleshooting

The usual mistakes with this circuit, and the fix for each.

  • The crossing starts again right after the gate rises. This project
    The sketch ignores both detectors for IGNORE_MS (4000) after finishing. If the last car is slow, raise that value.
  • The gate rises while the train is still passing. This project
    It rises when the exit sensor has been clear for CLEAR_MS (2000). If gaps between cars are longer than that, raise it.
  • Both lamps light together or stay dark. This project
    The left lamp is on pin 5 and the right on pin 4. Each needs its own 220 ohm resistor to ground.
  • The servo jitters, twitches or resets the board when it moves. Hobby servo
    Power it from its own 5 V supply, not the Arduino 5 V pin, and join the grounds. A hobby servo can pull several hundred milliamps. Add a 100 uF to 470 uF capacitor across its supply.
  • The servo hums at the end of its travel or will not reach full angle. Hobby servo
    Stay inside the pulse range, about 1000 to 2000 us for most hobby servos. Pushing past the end stop makes it strain. Calibrate the min and max pulse for your servo.
  • The output never changes, or is always the same. The LED side needs a series resistor, and the phototransistor side needs a pull-up. Photo interrupter
    Put about 220 ohms in series with the LED from 5 V. Pull the output up with about 10k, or use INPUT_PULLUP. Output goes low when the beam is clear and high when blocked, or the reverse on some modules.
  • Pulses are missed or counted twice at higher speeds because the loop is too slow or the edge is noisy. Photo interrupter
    Count with an interrupt on the pin, on one edge only. Make sure the wheel slots are wide enough to pass the beam and the object fully blocks it.
  • The LED does not light, or it lights once and then dies. LED
    LEDs have polarity. The longer leg (anode) goes toward the positive side. Always add a series resistor, about 220 ohms to 1 k ohm on a 5 V pin.

Change it and keep it

Open it in the editor, change the circuit or the code, and keep your version in a free account.