PROJECT001public
← Project library

ESP32 + BME280 planning starter

Turn an exact ESP32 board and BME280 breakout into a confirmed pin-and-power plan before generating firmware.

UPDATED 2026-10-04Finn Andre HotvedtMarkdown ↗JSON ↗
OUTCOME FIRST

Turn an exact ESP32 board and BME280 breakout into a confirmed pin-and-power plan before generating firmware.

A reference-reviewed teaching example for an I2C environmental sensor. The wiring has not been physically tested by Teach the Company, so the prompt first makes the learner identify and confirm their actual board, module, pins, toolchain and electrical limits.

01
REAL DEMONSTRATION

Project video

No project video is published yet.

A video will appear here only when it is real, publicly accessible and has matching metadata. The current entry does not use a placeholder as evidence.

02
EXACT PARTS BEFORE CODE

Hardware and boundaries

Board
Espressif ESP32-DevKitC V4 example family
Revision
The actual board revision and module marking must be confirmed by the learner.
Toolchain
Arduino-ESP32 example; exact IDE/CLI and core versions must be confirmed before code is generated.
Logic
3.3 V board logic; confirm the exact breakout and supply before connection.
Power
USB-powered development board; sensor current and complete power budget must be checked for the exact parts.
QtyItemModelRevision / checkPurpose
1Development boardEspressif ESP32-DevKitC V4 example familyConfirm the printed board and ESP32 module revisionRuns the firmware and provides the example I2C bus.
1Environmental sensor breakoutAdafruit BME280 I2C or SPI breakoutConfirm the exact product/revision and pin labelsMeasures temperature, humidity and pressure in the teaching example.
4Jumper wireFemale-to-femaleInspect before useCarries 3.3 V, ground, SDA and SCL.
1USB data cableSuitable for the exact development boardKnown data-capable cablePowers and uploads to the board.
03
STATUS: Reference-reviewed; not hardware-verified

Wiring map

Reference-reviewed; not hardware-verified

Reference-reviewed against the linked Espressif Arduino I2C and Adafruit BME280 pinout documentation. Not physically tested by Teach the Company. Some clones, revisions and other BME280 breakouts differ.

Diagram description: Reference diagram: ESP32 3V3 to BME280 VIN, GND to GND, GPIO21 to SDI/SDA and GPIO22 to SCK/SCL. Every endpoint must be checked against the labels on the actual boards before connection.

Board pinModule pinSignalElectrical note
3V3VINPowerExample uses 3.3 V so power and logic share the same level; confirm the exact breakout.
GNDGNDCommon groundConnect ground before interpreting signal behavior.
GPIO21SDII2C SDAArduino-ESP32 documentation lists GPIO21 as the generic ESP32 default SDA pin.
GPIO22SCKI2C SCLArduino-ESP32 documentation lists GPIO22 as the generic ESP32 default SCL pin.
04
FINISHED PUBLIC PROMPT · v1.0.0

Copy the safe starting point

Only the accepted, finished prompt is public. It asks for the actual board, module, pins, toolchain and electrical facts before it allows wiring, code or upload instructions.

SHA-256 2cb2843c797776af514e06393ea58fc3ce1d6fc11b32dcd090ec30eb8afc910b
You are a careful microcontroller integration assistant. Help me produce a board-specific, testable implementation without guessing my hardware or wiring.

Before you provide final wiring, firmware, build commands, upload commands or pin-dependent advice, ask me for all of the following:
1. Exact development board manufacturer, product name, board revision and the marking on the microcontroller/module.
2. Exact sensor, actuator or breakout manufacturer, model and revision; ask for a clear pin-label photo or official pinout link if the identity is uncertain.
3. Toolchain and exact version: Arduino IDE/CLI, PlatformIO, ESP-IDF or another named environment, including the selected board package and target.
4. My actual proposed connection for every wire: board pin, module pin and signal name. Do not replace this with a typical pinout.
5. Power source, supply voltage, logic voltage, expected current and whether grounds are already common. Ask about external drivers, pull-ups or level shifting where the hardware can require them.
6. Intended behavior, timing, communication protocol, expected output and what should happen when the sensor is missing or returns an error.
7. Existing source files, libraries and upload/debug port, if any.

Then normalize my answers into two short tables:
- Pin and power map: board pin | module pin | signal | voltage/current note.
- Build map: board target | framework/toolchain version | libraries | upload/debug method.

Check the proposed map against the exact board and module documentation. Call out boot/strapping, reserved, input-only, ADC, pull-up, current, voltage and common-ground constraints that apply. Never infer that a similarly named clone has the same pinout. Stop if mains voltage, high current, batteries without suitable protection, unclear grounds or incompatible logic levels are involved.

Ask: “Is this exact pin, power and build map correct? Reply YES, or reply NO with corrections.” Accept short YES/NO quick replies. Do not continue until I confirm YES.

After confirmation, provide only what is supported by the confirmed map:
1. Final BOM with exact models/revisions and required support parts.
2. Final wiring table plus a concise text diagram.
3. Complete minimal source code with explicit pin constants and error handling.
4. Reproducible build and upload steps for the confirmed toolchain.
5. Expected serial/output evidence and a bounded troubleshooting checklist.
6. A verification record that separately labels: reference review, build result, upload observation and physical hardware result.

Never report a build, upload or physical test as successful unless I provide the corresponding real result or you actually performed that exact check with an authorized connected tool. Preserve uncertainty and cite the exact documentation used.

05
CONFIRM, THEN BUILD

How to use it

  1. 01

    Copy or download the finished prompt.

  2. 02

    Paste it into the agent you use for the project.

  3. 03

    Answer with the exact markings, toolchain, real wiring proposal, power information and intended behavior.

  4. 04

    Check the normalized pin/power and build maps; reply YES only when every row matches the physical hardware.

  5. 05

    Generate and build the minimal firmware, then record build, upload and physical results separately.

06
NO COLLAPSED CLAIMS

Actual results and limits

Prompt reviewEditorially reviewed
Firmware buildNot tested
UploadNot observed
WiringReference-reviewed; not hardware-verified
Physical testNot hardware-verified

Observed

  • The public prompt and project record passed automated content, route and consistency tests in the Teach the Company source tree.
  • No firmware build was run for this adaptable example.
  • No upload was observed and no physical ESP32/BME280 assembly was tested by Teach the Company.

Limits

  • This is a planning and teaching foundation, not a claim that one exact hardware assembly was completed.
  • Board clones and BME280 breakouts can use different labels, regulators, pull-ups, addresses and pin arrangements.
  • The example covers low-voltage I2C only; it does not authorize mains, high-current or safety-critical work.
  • A successful compile does not prove that upload, wiring or sensor behavior works on physical hardware.
07
PUBLIC SOURCE TRAIL

Source and evidence

NEXT STEPARCHIVEBrowse the project library→COMPOSEBuild an agent learning pack→