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

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#78 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
95/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Domaine
documentation, embedded-iot

Piste de recherche

Lisez le tableau de câblage dans AGENTS.md:356 et vérifiez les limites de TMP108 cités dans sources/datasheet.txt, en particulier les sections 6.1, 6.3 et 9. Mettez à jour le tableau pour supprimer l’option 5 V et indiquer la plage documentée de 1.4–3.6 V ; la tâche est terminée lorsque les instructions de câblage n’autorisent plus une alimentation supérieure aux spécifications du composant.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.

Langage dominant
Rust
Étoiles
2
Forks
7
Aucune PR mergée en 30 j

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de OpenDevicePartnership/tmp108

Toutes les issues de OpenDevicePartnership/tmp108

Issues similaires

Plus d'issues Rust

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.