Debugging CodeCell

CodeCell is designed to be simple to use, but like any microcontroller, issues can happen. This quick guide covers the most common problems you might face when using CodeCell C3 or CodeCell C6 - and how to fix them fast.

Before You Start

• Make sure your CodeCell Library is up to date in the Arduino IDE.
• Check that the ESP32 board package (by Espressif Systems) is updated.
• Always use a USB-C cable that supports data transfer, not just charging.

1. CodeCell Not Showing Up in Arduino IDE

• Unplug and reconnect CodeCell, wait a few seconds.
• Go to Tools > Port and check if a new port appears.
• If not, try another USB-C cable or USB port.
• Ensure USB_CDC_On_Boot is enabled in Tools.
• On Windows, open Device Manager → under “Ports (COM & LPT)” check if CodeCell is listed.

2. Code Upload Fails

• Check that you selected the correct board:
  • CodeCell C3 → ESP32C3 Dev Module
  • CodeCell C6 → ESP32C6 Dev Module
• Go to Tools > Port and pick the right COM port.
• Enable USB_CDC_On_Boot.
• If CodeCell is stuck or not responding:
  • Short SCL (GPIO9) to GND.
  • Unplug the battery and unplug the USB, wait a few seconds, and reconnect the USB.
  • Re-upload your sketch, then remove the short once done.

3. Serial Monitor Not Showing Data

• Ensure the Serial Monitor baud rate is set to 115200.
• Confirm USB_CDC_On_Boot is enabled.
• Close and reopen the Serial Monitor after uploading a sketch.
• Try unplugging and replugging the board.

4. LED Behavior Reference

• 🔵 Static Blue → Charging
• 🟢 Breathing Green → Running on battery
• 🔵 Breathing Blue → Fully charged
• 🔴 Flashing Red → Low battery (<3.3 V)

5. Battery or Power Issues

• If the LED doesn’t light up, check your USB cable or adapter.
• If using a battery, make sure it’s properly connected and charged.
• If still off, remove all power for 10 seconds, then reconnect.

6. Sensors Not Responding

• Make sure the correct sensor is initialized using:
  

  myCodeCell.Init(SENSOR_MACRO);

• Check the Serial Monitor for “sensor not found” messages.
• If using external sensors, avoid I²C addresses:
  • 0x60 → VCNL4040 (light sensor)
  • 0x4A → BNO085 (IMU)

7. Still Having Trouble?

• Restart the Arduino IDE and reconnect your CodeCell.
• Update the CodeCell Library to the latest version.

Final Tip

If the issue persists, check the CodeCell GitHub Issues page, you’ll often find quick solutions from other makers and our team.

Still stuck? Reach out - We’re always happy to help you get your CodeCell back up and running!