search
Vist Xspence

laptop-binaryDeveloper_Kit

Detailed Device Support

Here, we break down troubleshooting by device, starting with common hardware and software pitfalls. If you're still stuck, join our community channels for support we're here to help!

For initial setup and installation guidance, we recommend checking out our Quickstart Guides for your device to get your environment up and running before diving into the troubleshooting steps below.

hashtag
Developer_Kit

The Developer Kit is designed to help you get familiar with electronics. However, it is expected that at some point wires may be crossed and you may need some help to get you over the line. Following the steps below should help you get back on track.

hashtag
Wiring

The Developer Kit is built up step by step through the basics section of the tutorial. This confirms each part is installed correctly and is operational before moving onto the ledger monitors. If you have not completed the basic walkthrough, then it's possible wires may not be matching their assigned locations.

  • LEDs (for Visual Notifications):

    • For the single LED blink test: Anode → GPIO 2 (BUILTIN_LED) .

    • For RGB LED (if using): Red → GPIO 5, Green → GPIO 19, Blue → GPIO 18 , GND.

    • Test: Blink sketcharrow-up-right on the pin. If not lighting, check polarity, and pin definition in code.

  • Tactile Button (for Mode Selection):

    • Connect the Anode -> GPIO 4 and Ground pins on the same side of the button

    • Test: Button sketcharrow-up-right on the pin. If not changing the light sequence, check polarity, and pin definition in code.

  • Speaker (Buzzer for Audio Alerts):

    • Positive pin → GPIO 17 (or any digital pin; adjust in code)

    • Negative pin → GND

    • Test: Alert sketcharrow-up-right to play a note. If no sound, swap pins or check volume in code.

  • SSD1306 OLED Screen (I2C Connection):

    • VCC → 3.3V on ESP32

    • GND → GND on ESP32

    • SDA → GPIO 21 (default SDA pin)

    • SCL → GPIO 22 (default SCL pin)

    • Test: Upload our Display sketcharrow-up-right. If blank, check for loose wires or I2C address (default 0x3C; use an I2C scanner sketch to verify).

  • Jumper Wires and Breadboard:

    • Use jumpers for connections. Ensure no shorts on the breadboard (e.g., power rails not crossed).

    • Pro Tip: Color-code wires (red for VCC, black for GND) to avoid mistakes.

Here's the complete wire diagram for each component of the Developer Kit. ( Use a breadboard for easy prototyping.)

If wiring issues persist, double-check against our basic tutorials' photos. Use a multimeter to test continuity and voltage (ESP32 outputs 3.3V logic). If components seem fried, replacements are affordable – start simple!

PreviousDebuggingNextMicro_Ledger

Last updated