docs: add I2C environmental sensor HAT tutorial

[MolhamHamwi]

Adds a build-focused I2C Environmental Sensor HAT tutorial for BME280-based temperature, humidity, and pressure logging.

Covers:

• BME280 integration in I2C mode
• SDA/SCL pull-up resistors
• local decoupling capacitors
• optional OLED and external I2C headers
• PCB layout guidance, Raspberry Pi bring-up, and Python logging example

/claim #602

Validation:

• bun run build

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	May 23, 2026 10:04am

[Copilot]

Pull request overview

Adds a new Raspberry Pi HAT tutorial documenting an I2C environmental sensor design centered around a BME280, including supporting passives, optional headers, layout guidance, and a basic Raspberry Pi/Python bring-up flow.

Changes:

• Added a new MDX tutorial for an I2C Environmental Sensor HAT (BME280 + pull-ups + decoupling + optional OLED/external header).
• Embedded interactive tscircuit snippets (3D overview + schematic-focused step).
• Included PCB layout guidance, Raspberry Pi I2C enablement steps, and a Python logging example.

Comments suppressed due to low confidence (1)

docs/tutorials/pi-hats/i2c-environmental-sensor-hat.mdx:131

• Same issue as above in the Step 2 snippet: footprint="soic8"/pin labeling for BME280 does not match the actual BME280 package/pinout, which can mislead readers into generating an unusable board. Align the footprint and labeled pins with the real BME280 (or model a breakout/module explicitly).

    <chip
      name="U1"
      manufacturerPartNumber="BME280"
      footprint="soic8"
      pinLabels={{ pin1: ["SDA"], pin2: ["SCL"], pin3: ["GND"], pin4: ["VCC"], pin5: ["CSB"], pin6: ["SDO"] }}

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[MolhamHamwi]

Follow-up update: addressed the Copilot tutorial feedback in eff0887:\n\n- changed the BME280 example from an inaccurate bare soic8 sensor to a common 3.3 V I2C breakout/module modeled as pinrow4 (VCC, GND, SCL, SDA) and documented the bare LGA distinction\n- changed the external connector wording to an unkeyed 1x4 header and added guidance to use keyed cables/connectors when needed\n- added a duplicate I2C pull-up note/DNP guidance for modules with onboard pull-ups\n- updated Raspberry Pi setup to install/use python3-venv and a virtualenv for the CircuitPython library on PEP 668 systems\n\nPR checks are green (build, format-check, type-check, Vercel).

[github-actions]

This PR has been automatically marked as stale because it has had no recent activity. It will be closed if no further activity occurs.

[MolhamHamwi]

Still active on this PR. Current checks are green, and this is ready for maintainer review.

[github-actions]

This PR has been automatically marked as stale because it has had no recent activity. It will be closed if no further activity occurs.

[MolhamHamwi]

Still active and ready for maintainer review. Current build, format-check, and type-check are green.

[MolhamHamwi]

Still active. Checks are green and this remains ready for maintainer review.

[github-actions]

This PR has been automatically marked as stale because it has had no recent activity. It will be closed if no further activity occurs.

[MolhamHamwi]

Still active. Checks are green and this remains ready for maintainer review.

[github-actions]

This PR has been automatically marked as stale because it has had no recent activity. It will be closed if no further activity occurs.

[MolhamHamwi]

Still active. Checks are green and this remains ready for maintainer review.

[MolhamHamwi]

Review follow-up is already pushed in eff0887: clarified the BME280 as a 3.3 V I2C breakout/module instead of a bare LGA sensor, changed the external header wording to unkeyed 1x4, added duplicate pull-up/DNP guidance for BME280/OLED modules, and updated Raspberry Pi OS setup to use a Python virtual environment. Checks are green.