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

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#78 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
95/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Lĩnh vực
documentation, embedded-iot

Hướng nghiên cứu

Đọc bảng đấu dây tại AGENTS.md:356 và xác minh các giới hạn TMP108 được trích dẫn trong sources/datasheet.txt, đặc biệt là các phần 6.1, 6.3 và 9. Cập nhật bảng để loại bỏ tùy chọn 5 V và nêu rõ dải 1.4–3.6 V được tài liệu hóa; hoàn thành khi hướng dẫn đấu dây không còn cho phép nguồn cấp vượt quá định mức của thiết bị.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
Rust
Star
2
Fork
7
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của OpenDevicePartnership/tmp108

Tất cả issue của OpenDevicePartnership/tmp108

Issue tương tự

Thêm issue về Rust

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.