AGENTS.md's wiring table permits a 5 V supply; the absolute maximum is 4 V

オープン 初心者向け
#78 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
1/5
見積もり時間
1時間未満
初心者へのやさしさ
95/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発

調査の方向性

AGENTS.md:356 の配線表を読み、sources/datasheet.txt に記載された TMP108 の制限値、特にセクション 6.1、6.3、9 を確認してください。表を更新して 5 V オプションを削除し、文書化されている 1.4–3.6 V の範囲を記載してください。配線ガイダンスでデバイスの定格を超える電源を許可しなくなれば完了です。

索引モデルが issue の本文から書いたものです。

説明

audit:SBOS663A bug documentation impact:field-visible verdict:contradicts

AGENTS.md's hardware table tells contributors to wire the TMP108's V+
to either 3.3 V or 5 V:

| `V+`  | 3.3 V (or 5 V, datasheet range) | — |

AGENTS.md:356

5 V is not in the datasheet range. It exceeds both the recommended
operating maximum and the absolute maximum rating, and the parenthetical
attributes the permission to the datasheet.

Source

SBOS663A §6.3, Recommended Operating Conditions:

V+ Supply voltage 1.4 3.6 V

sources/datasheet.txt:191

SBOS663A §6.1, Absolute Maximum Ratings:

Supply voltage 4 V

sources/datasheet.txt:158

SBOS663A §6.1, footnote 1:

(1) Stresses beyond those listed under Absolute Maximum Ratings may cause permanent damage to the device. These are stress ratings

sources/datasheet.txt:167

SBOS663A §9:

The TMP108 operates on a power supply range from 1.4 V to 3.6 V. A power-supply bypass capacitor is

sources/datasheet.txt:1196

Why it matters

This is the wiring recipe a new contributor or agent follows before
running any of the five examples. 5 V is 1 V above the absolute maximum,
so following the instruction risks permanently damaging the part — and
unlike every other finding in this audit, no amount of driver-side
handling can recover from it.

The Pico de Gallo host adapter can source 5 V, so this is reachable, not
theoretical.

Suggested fix

Drop the 5 V option and state the documented range:

| `V+`  | 3.3 V (1.4–3.6 V per SBOS663A §6.3) | — |

Docs-only; no code, no semver impact.

Provenance

Raised by the datasheet compliance audit of PR #77 against the four
pinned sources. Found independently by two of the three audit agents.
Pre-existing on main; not introduced by #77.

Datasheet pinned at sha256:ec086250fc4331e7fc923be62173062bbf0fccedad6894c2741b73cd1c084556.

主要言語
Rust
スター
2
フォーク
7
PR マージ指標
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

OpenDevicePartnership/tmp108 のほかの issue

OpenDevicePartnership/tmp108 の issue をすべて見る

似ている issue

Rust の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。