Build an Automated ESP32 Resistor Code Calc Using a TCS34725 Color Sensor

Reading faded, tiny color bands on a 1/4W carbon film resistor is a universal frustration at the electronics workbench. While you can always reach for a multimeter, building an automated resistor code calc bench tool is a fantastic embedded systems project that forces you to deal with real-world sensor calibration, I2C bus physics, and color-space mathematics.

In this guide, we are building a standalone optical resistor reader. It uses an ESP32 to poll a TCS34725 RGB color sensor, maps the raw RGB data to standard E12/E24 resistor band colors using a Euclidean distance algorithm, and outputs the calculated resistance value to an I2C OLED display. No phone apps required.

Project Spec Sheet & Parts List

This build targets the ESP32-DevKitC V4 (equipped with the ESP32-WROOM-32 module). We chose the ESP32 over an Arduino Nano because its 3.3V logic natively matches the TCS34725 sensor, eliminating the need for logic level shifters that often introduce I2C bus capacitance issues.

Required Components

• Microcontroller: ESP32-DevKitC V4 (30-pin variant, ESP32-WROOM-32)
• Color Sensor: Adafruit TCS34725 RGB Color Sensor Breakout (or high-quality clone with onboard 3.3V LDO)
• Display: 0.96" SSD1306 I2C OLED (128x64, 0x3C address)
• Passives: Two 4.7kΩ pull-up resistors (mandatory if using a clone sensor board)
• Mechanical: 3D-printed light shroud (crucial for blocking ambient bench lighting)

Wiring the TCS34725 to the ESP32-WROOM-32

Both the TCS34725 and the SSD1306 OLED communicate over I2C. The ESP32's default hardware I2C pins are GPIO 21 (SDA) and GPIO 22 (SCL). We will wire both devices to this same bus.

The Resistor Code Calc Firmware

The firmware below handles I2C initialization, RGB polling, and the core resistor code calc logic. It uses a Euclidean distance formula in 3D RGB space to match the sensor's raw output to a calibrated array of known resistor band colors.

Required Libraries (install via Arduino Library Manager): Adafruit TCS34725, Adafruit SSD1306, Adafruit GFX.

#include <Wire.h>
#include <Adafruit_TCS34725.h>
#include <Adafruit_SSD1306.h>
#include <Adafruit_GFX.h>
#include <math.h>

// --- PIN & HARDWARE DEFINITIONS ---
#define I2C_SDA 21
#define I2C_SCL 22
#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64
#define OLED_RESET -1
#define SCREEN_ADDRESS 0x3C

// --- SENSOR INITIALIZATION ---
// 50ms integration time and 4x gain provides a good balance for close-range LED illumination
Adafruit_TCS34725 tcs = Adafruit_TCS34725(TCS34725_INTEGRATIONTIME_50MS, TCS34725_GAIN_4X);
Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);

// Calibrated RGB targets for standard 1/4W resistor bands under TCS34725 white LED
// Format: {Red, Green, Blue, Multiplier/Digit Value}
const float colorTargets[10][4] = {
  { 40,  40,  40, 0}, // Black
  {140,  80,  50, 1}, // Brown
  {220,  60,  60, 2}, // Red
  {240, 140,  40, 3}, // Orange
  {240, 220,  80, 4}, // Yellow
  { 60, 180,  80, 5}, // Green
  { 60,  80, 200, 6}, // Blue
  {160,  80, 200, 7}, // Violet
  {160, 160, 160, 8}, // Grey
  {240, 240, 240, 9}  // White
};

const char* colorNames[10] = {"BLK", "BRN", "RED", "ORG", "YEL", "GRN", "BLU", "VIO", "GRY", "WHT"};

int matchResistorColor(uint16_t r, uint16_t g, uint16_t b) {
  float minDist = 999999;
  int bestMatch = -1;
  
  for (int i = 0; i < 10; i++) {
    // Euclidean distance in RGB space
    float dist = sqrt(pow(r - colorTargets[i][0], 2) + 
                      pow(g - colorTargets[i][1], 2) + 
                      pow(b - colorTargets[i][2], 2));
    if (dist < minDist) {
      minDist = dist;
      bestMatch = i;
    }
  }
  // Reject match if the color is too far from any known target (e.g., looking at empty space)
  return (minDist > 150) ? -1 : bestMatch;
}

void setup() {
  Serial.begin(115200);
  
  // Initialize I2C with explicit pins for ESP32
  Wire.begin(I2C_SDA, I2C_SCL);
  
  // Initialize OLED
  if(!display.begin(SSD1306_SWITCHCAPVCC, SCREEN_ADDRESS)) {
    Serial.println(F("SSD1306 allocation failed"));
    for(;;); // Halt
  }
  display.clearDisplay();
  display.setTextSize(1);
  display.setTextColor(SSD1306_WHITE);
  
  // Initialize Color Sensor
  if (!tcs.begin()) {
    display.setCursor(0, 0);
    display.println("ERROR:");
    display.println("TCS34725 not found");
    display.println("Check I2C wiring!");
    display.display();
    Serial.println("Couldn't find TCS34725 ... check your wiring!");
    for(;;); // Halt
  }
  
  // Enable the sensor's integrated white LED for consistent illumination
  tcs.setInterrupt(false); 
  
  display.setCursor(0, 20);
  display.println("Resistor Code Calc");
  display.println("System Ready.");
  display.display();
  delay(1500);
}

void loop() {
  float red, green, blue;
  tcs.getRGB(&red, &green, &blue);
  
  // The sensor reads Band 1, Band 2, Multiplier sequentially.
  // For this demo, we assume a single band is placed under the sensor.
  int bandValue = matchResistorColor((uint16_t)red, (uint16_t)green, (uint16_t)blue);
  
  display.clearDisplay();
  display.setCursor(0, 0);
  display.print("Raw RGB: ");
  display.print((int)red); display.print(",");
  display.print((int)green); display.print(",");
  display.println((int)blue);
  
  display.setCursor(0, 25);
  display.setTextSize(2);
  if (bandValue != -1) {
    display.print("Band: ");
    display.println(colorNames[bandValue]);
    display.print("Value: ");
    display.println(bandValue);
  } else {
    display.println("NO MATCH");
  }
  display.setTextSize(1);
  display.display();
  
  delay(250); // Debounce and prevent I2C bus flooding
}

Debugging: Sensor Failures and Calibration Errors

Color sensor projects rarely work perfectly on the first compile. If your serial monitor outputs the exact error string: Couldn't find TCS34725 ... check your wiring!, the ESP32 sent an I2C address request to 0x29 and received a NACK (No Acknowledge) response.

First Three Things to Check When It Fails

1. Run an I2C Scanner: Flash a basic I2C scanner sketch. If the scanner sees nothing, your SDA/SCL wires are swapped, or your pull-up resistors are missing. If it sees 0x3C (the OLED) but not 0x29 (the sensor), the sensor is dead or unpowered.
2. Verify Logic Levels: Did you accidentally wire the TCS34725 VCC to the ESP32's 5V/VIN pin? The TCS34725 silicon is strictly 3.3V. Feeding it 5V without an onboard LDO will instantly fry the I2C transceiver inside the chip.
3. Check the Interrupt Pin: Some breakout boards require the INT pin to be pulled high to 3.3V via a resistor to enable standard I2C polling. If left floating, the chip may lock up.

Ranked Causes for Color Misidentification

If the hardware works but the resistor code calc logic outputs "RED" when scanning a "BROWN" resistor, you are fighting specular reflection and ambient light bleed.

• Cause 1: Specular Glare (80% of cases). Resistors have a glossy epoxy coating. The TCS34725's onboard LED bounces directly off this gloss into the photodiodes, washing out the color to white/grey. Fix: Angle the sensor at 45 degrees to the resistor body, or lightly scuff the resistor with fine sandpaper.
• Cause 2: Ambient Light Contamination (15%). Overhead bench LEDs alter the RGB ratios. Fix: You must use an opaque 3D-printed shroud that physically touches the resistor body during scanning.
• Cause 3: Integration Time Saturation (5%). If the sensor's integration time is too long, the white LED maxes out the photodiode ADC. Fix: Change TCS34725_INTEGRATIONTIME_50MS to TCS34725_INTEGRATIONTIME_24MS in the code.

Extending and Simplifying the Build

This baseline firmware gives you a single-band reader. Depending on your bench needs, you can scale this project up or down.

How to Simplify: If you don't want to wire an OLED, delete the Adafruit_SSD1306 blocks and rely entirely on the Serial Plotter. This reduces the I2C bus capacitance and eliminates the 0x3C address conflict risk, making the build highly reliable for quick logging to a PC.

How to Extend: To read full 4-band resistors automatically, upgrade the hardware to an ESP32-CAM module and use Edge Impulse to train a lightweight TinyML image classification model. Alternatively, add a micro-servo with a silicone friction wheel to physically rotate the resistor under the stationary TCS34725, triggering a scan every 90 degrees to capture all four bands in sequence.

Resistor Code Calc FAQ

How does a 5-band resistor code calc handle the extra digit?

A standard 4-band resistor uses Band 1 and Band 2 as significant digits, and Band 3 as the multiplier. A 5-band resistor (typically 1% tolerance metal film) uses the first three bands as significant digits, and the 4th band as the multiplier. If you are programming a microcontroller to calculate this, your math shifts from (Band1 * 10 + Band2) * 10^Band3 to (Band1 * 100 + Band2 * 10 + Band3) * 10^Band4. The 5th band remains the tolerance indicator (Brown = 1%, Red = 2%).

What multiplier values should a resistor code calc use for gold and silver bands?

Gold and Silver are never used as significant digit bands; they exclusively appear as multipliers or tolerance indicators. If your sensor detects Gold in the multiplier position, the code must apply a multiplier of 0.1 (e.g., Red-Violet-Gold = 27 * 0.1 = 2.7Ω). If it detects Silver, the multiplier is 0.01. Note that the TCS34725 struggles to differentiate metallic Gold from Yellow, and metallic Silver from White/Grey, so manual verification of low-value resistors is still recommended.

Why does my automated resistor code calc confuse brown and red bands?

Brown and Red share a heavily overlapping spectral footprint, especially under the cool-white LED integrated into the TCS34725. Red reflects strongly in the 600-700nm range, while brown is essentially a dark, desaturated red/orange. If your resistor code calc confuses them, your sensor gain is likely too high, causing the red channel to saturate (clip at 255) on both colors. Lower the gain from TCS34725_GAIN_4X to TCS34725_GAIN_1X in the initialization code to preserve the dynamic range needed to see the luminance difference between the two.