Build a 3-Axis Arduino Animatronic Eye Mechanism: Wiring & Code

To build a reliable, jitter-free Arduino animatronic eye mechanism, you must bypass the microcontroller's internal PWM timers and offload servo control to a dedicated I2C driver. The optimal baseline configuration uses an Arduino Nano V3 (ATmega328P) paired with a PCA9685 16-channel PWM driver, two MG996R metal-gear servos for pan/tilt, and two SG90 micro servos for eyelid actuation. Driving four servos directly from the Nano's 5V rail and digital pins will inevitably cause voltage brownouts, I2C bus lockups, and visible servo jitter. This guide details the exact power topology, pin mapping, and compilable C++ code required to get your animatronic moving smoothly on the bench.

Hardware Decision Tree: Picking Your Servos and Board

Animatronic mechanisms fail when builders mismatch servo torque to mechanical load or underestimate stall current. Use this decision matrix to select your components. If you are building a standard 3-inch to 4-inch eye mechanism, follow the default concrete picks in the bottom row.

Parts List & Pin Mapping Spec Sheet

Power math is where most animatronic builds stall. An MG996R can draw up to 2.5A at stall. Two MG996Rs plus two SG90s (0.7A each) yields a theoretical peak draw of 6.4A. A standard USB port supplies 0.5A. You must use a dedicated 5V switching power supply.

Bill of Materials (BOM)

• Microcontroller: Arduino Nano V3 (ATmega328P, 5V/16MHz variant)
• Servo Driver: PCA9685 16-Channel 12-bit PWM Breakout (Adafruit or generic equivalent)
• Pan/Tilt Servos: 2x TowerPro MG996R (Metal Gear, 180-degree rotation)
• Eyelid Servos: 2x TowerPro SG90 (9g Micro)
• Power Supply: Mean Well RS-75-5 (5V, 10A Enclosed Switching Supply) or equivalent 5V 10A brick
• Wiring: 22 AWG stranded silicone wire for servo power, 26 AWG solid core for I2C logic

Pin Mapping & Wiring Table

Step-by-Step Wiring & Mechanical Assembly

1. Prep the PCA9685 Power Block: Solder the green 2-pin terminal block to the top-left of the PCA9685. Connect your 5V 10A power supply directly to this block. Crucial: The VCC pin on the side header is for the I2C logic chip (draws milliamps). The V+ terminal block is for the servo rails (draws amps). Never backfeed servo power through the Nano's 5V pin.
2. Install the Bypass Capacitor: Solder a 1000µF 16V electrolytic capacitor across the V+ and GND pins on the PCA9685 terminal block. This absorbs the inductive voltage spikes when the MG996R servos start and stop, preventing I2C bus resets.
3. Wire the I2C Bus: Connect Nano A4 to PCA9685 SDA, and Nano A5 to SCL. Keep these wires under 12 inches. If you must run them longer, add 4.7kΩ pull-up resistors to the 5V logic line.
4. Establish Common Ground: Connect the GND from the 5V power supply, the GND on the PCA9685 header, and the GND on the Arduino Nano together. If the grounds are not shared, the I2C signals will lack a reference voltage and fail silently.
5. Mount Servos to Channels: Plug the Pan (MG996R) into Channel 0, Tilt (MG996R) into Channel 1, Left Eyelid (SG90) into Channel 2, and Right Eyelid (SG90) into Channel 3. Ensure the brown/black wires (ground) face the outside edge of the board.

Complete Compilable Code (Arduino Nano V3)

This code targets the Arduino Nano V3 (ATmega328P). It uses the Adafruit PWM Servo Driver library to handle the 12-bit I2C resolution. It includes a serial command parser for bench testing, complete with bounds checking and explicit error strings.

#include <Wire.h>
#include <Adafruit_PWMServoDriver.h>

// Target Board: Arduino Nano V3 (ATmega328P, 5V/16MHz)
// I2C Address: 0x40 (Default for Adafruit/Generic PCA9685)
Adafruit_PWMServoDriver pwm = Adafruit_PWMServoDriver(0x40);

// Servo Pulse Width Limits (12-bit resolution out of 4096)
// Adjust these if your specific servos do not reach full 180 degrees
#define SERVOMIN  125 // ~500us pulse width
#define SERVOMAX  625 // ~2500us pulse width

// Channel Mapping
#define CH_PAN      0
#define CH_TILT     1
#define CH_LID_L    2
#define CH_RID_R    3

void setup() {
  Serial.begin(115200);
  Serial.println("Arduino Animatronic Eye Controller Booting...");

  // Initialize I2C and check for PCA9685 presence
  Wire.begin();
  Wire.beginTransmission(0x40);
  byte i2cError = Wire.endTransmission();
  
  if (i2cError != 0) {
    Serial.println("Error: PCA9685 not detected on I2C bus");
    Serial.println("Halt. Check wiring, pull-ups, and I2C address.");
    while (1) { delay(100); } // Infinite loop to halt execution
  }

  pwm.begin();
  pwm.setOscillatorFrequency(27000000);
  pwm.setPWMFreq(50); // Standard 50Hz for analog servos
  delay(10);

  // Center all servos on boot
  moveServo(CH_PAN, 90);
  moveServo(CH_TILT, 90);
  moveServo(CH_LID_L, 90);
  moveServo(CH_RID_R, 90);
  
  Serial.println("Ready. Commands: P[0-180], T[0-180], L[0-180], R[0-180]");
}

void loop() {
  if (Serial.available() > 0) {
    String cmd = Serial.readStringUntil('\n');
    cmd.trim();
    
    if (cmd.length() < 2) {
      Serial.println("Error: Invalid command syntax");
      return;
    }

    char axis = cmd.charAt(0);
    int angle = cmd.substring(1).toInt();

    // Bounds checking to prevent mechanical binding
    if (angle < 0 || angle > 180) {
      Serial.println("Error: Servo angle out of bounds (Must be 0-180)");
      return;
    }

    switch (axis) {
      case 'P': case 'p': moveServo(CH_PAN, angle); break;
      case 'T': case 't': moveServo(CH_TILT, angle); break;
      case 'L': case 'l': moveServo(CH_LID_L, angle); break;
      case 'R': case 'r': moveServo(CH_RID_R, angle); break;
      default:
        Serial.println("Error: Unknown axis identifier");
        break;
    }
  }
}

// Helper function to map degrees to 12-bit PCA9685 pulse width
void moveServo(uint8_t channel, int angle) {
  int pulseLength = map(angle, 0, 180, SERVOMIN, SERVOMAX);
  pwm.setPWM(channel, 0, pulseLength);
}

Debugging: I2C Failures and Servo Jitter

When your animatronic fails to initialize or the servos twitch violently, do not guess. Follow this diagnostic path.

The First Three Things to Check

1. Power Rail Separation: Verify with a multimeter that the PCA9685 green terminal block reads exactly 5.0V to 5.2V under load. If it drops below 4.8V when a servo moves, your power supply is inadequate or your wires are too thin (upgrade to 18 AWG for the main feed).
2. Common Ground Continuity: Measure resistance between the Arduino Nano GND pin and the PCA9685 terminal block GND. It must read less than 1 ohm. If it reads open-loop (OL), your I2C bus will fail.
3. I2C Pull-ups: Generic PCA9685 boards sometimes lack onboard I2C pull-up resistors. If the bus fails, solder 4.7kΩ resistors between SDA/SCL and the VCC pin.

Ranked Causes for: Error: PCA9685 not detected on I2C bus

If the serial monitor outputs this exact string, the Nano's Wire library received a NACK (Not Acknowledged) on address 0x40.

• Cause 1 (60% likelihood): VCC and V+ are confused. You plugged 5V servo power into the side-header VCC pin, browned out the logic chip, or left VCC floating. Wire Nano 5V to PCA9685 VCC.
• Cause 2 (25% likelihood): Dupont wire failure. The internal crimp on cheap jumper wires frequently breaks. Swap the SDA/SCL wires for known-good solid core wire.
• Cause 3 (15% likelihood): I2C Address collision. If you soldered the address jumpers on the bottom of the PCA9685 board, the address is no longer 0x40. Run an I2C scanner sketch to find the new address and update Adafruit_PWMServoDriver(0x40) in the code.

Fixing Servo Jitter

If the code compiles but the MG996R servos vibrate or 'buzz' at rest, you are experiencing PWM signal noise or mechanical binding. First, increase the deadband in your mechanical linkage. Second, ensure your 5V power supply is a switching supply (like the Mean Well RS series) and not a linear transformer, which can introduce 60Hz/120Hz ripple that the PCA9685 interprets as micro-adjustments.

Extending vs. Simplifying the Build

Once the baseline 3-axis eye is functional on your bench, you will need to decide whether to scale up for a full character or scale down for a simpler prop.

How to Extend (Adding Audio Sync)

To make the eyes react to speech, add a DFPlayer Mini MP3 module. Wire the DFPlayer's RX pin to Nano D11 via a 1kΩ resistor (to drop the 5V logic to the DFPlayer's 3.3V tolerance). Use the DFPlayer Mini library to trigger audio tracks. You can map the analog audio envelope (read via a simple envelope follower circuit on A0) to the Tilt and Eyelid channels to create a rudimentary lip-sync and eye-dart effect.

How to Simplify (Dropping the I2C Driver)

If you are building a simple haunted house prop that only requires a pan/tilt gimbal (2x MG996R servos) and no eyelids, you can delete the PCA9685 entirely. Wire the two servos directly to Nano pins D9 and D10. Use the standard Servo.h library. Warning: You still must use an external 5V power supply for the servos; do not power them from the Nano's onboard 5V regulator, which will overheat and shut down at currents above 500mA.