docs(wiring): 누수 저항식 2선 프로브·SHT30 모듈 직결로 배선도 정정

- 누수 §4 배선도: 3핀(VCC/SIG/GND) → 2전극 프로브(전극 A→3V3, 전극 B→GPIO17).
  10MΩ 풀다운은 GPIO17↔GND 보드 부품(센서 선 아님)으로 명시. 펌웨어(ACTIVE_LOW=False) 일치.
  §2 범례·§3 핀표·§8 통합표 GND 문구도 "풀다운용(센서 선 아님)"으로 통일.
- SHT30 §4: 외부 풀업 R1/R2·SDA hop 제거 → VCC/GND/SDA/SCL 4선 직결(내장 풀업). §3 표 문구 갱신.
- 납품 리포트(센서 형태·내용): 누수 "2선 저항식 프로브", SHT30 "모듈 직결" 반영.
- 브라우저 렌더 검증: 두 §4 텍스트·선 겹침 0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015Dj4n17ZvGAhga6D4pNRjn
This commit is contained in:
cw2007 2026-07-19 23:34:27 +09:00
parent b9d47000e9
commit 2046b2f292
3 changed files with 466 additions and 44 deletions

File diff suppressed because one or more lines are too long

View file

@ -243,7 +243,7 @@
<div class="legend"> <div class="legend">
<div class="lg"><span class="sw sig"></span><b>Signal (GPIO17 · Pin 11)<span>Sensor signal line input</span></b></div> <div class="lg"><span class="sw sig"></span><b>Signal (GPIO17 · Pin 11)<span>Sensor signal line input</span></b></div>
<div class="lg"><span class="sw pwr"></span><b>Power 3V3 (Pin 1)<span>Sensor power supply</span></b></div> <div class="lg"><span class="sw pwr"></span><b>Power 3V3 (Pin 1)<span>Sensor power supply</span></b></div>
<div class="lg"><span class="sw gnd"></span><b>Ground GND (Pin 6 · used)<span>Default sensor GND connection</span></b></div> <div class="lg"><span class="sw gnd"></span><b>GND (Pin 6) · 풀다운용<span>10MΩ 풀다운 리턴 · 센서 선 아님</span></b></div>
<div class="lg"><span class="sw alt"></span><b>Ground alternatives<span>Pin 9 / 14 / 20 / 25 / 30 / 34 / 39</span></b></div> <div class="lg"><span class="sw alt"></span><b>Ground alternatives<span>Pin 9 / 14 / 20 / 25 / 30 / 34 / 39</span></b></div>
<div class="lg"><span class="sw exp"></span><b>Expansion example (optional)<span>GPIO27·Pin 13, GPIO22·Pin 15</span></b></div> <div class="lg"><span class="sw exp"></span><b>Expansion example (optional)<span>GPIO27·Pin 13, GPIO22·Pin 15</span></b></div>
<div class="lg"><span class="sw off"></span><b>Unused pins<span>Not connected on this node</span></b></div> <div class="lg"><span class="sw off"></span><b>Unused pins<span>Not connected on this node</span></b></div>
@ -273,10 +273,10 @@
<td>Sensor VCC supply. (Spare 3V3 = Pin 17)</td> <td>Sensor VCC supply. (Spare 3V3 = Pin 17)</td>
</tr> </tr>
<tr> <tr>
<td><span class="tag gnd">Ground</span> Sensor GND</td> <td><span class="tag gnd">Ground</span> 풀다운 GND <span style="color:#868e96">(센서 선 아님)</span></td>
<td class="mono">GND</td> <td class="mono">GND</td>
<td class="mono">Pin 6</td> <td class="mono">Pin 6</td>
<td>Alternatives: any GND among Pin 9 / 14 / 20 / 25 / 30 / 34 / 39.</td> <td>10MΩ 풀다운(GPIO17↔GND) 리턴용. Alternatives: any GND among Pin 9 / 14 / 20 / 25 / 30 / 34 / 39.</td>
</tr> </tr>
<tr class="exprow"> <tr class="exprow">
<td><span class="tag exp">Expansion</span> Additional sensor example</td> <td><span class="tag exp">Expansion</span> Additional sensor example</td>
@ -299,7 +299,7 @@
<section> <section>
<h2><span class="num">4</span>Wiring Schematic</h2> <h2><span class="num">4</span>Wiring Schematic</h2>
<div class="diagram"> <div class="diagram">
<svg viewBox="0 0 640 400" role="img" aria-label="Leak sensor wiring schematic — 3V3·GPIO17·GND and external 10MΩ pull-down" xmlns="http://www.w3.org/2000/svg" style="width:100%;height:auto"> <svg viewBox="0 0 640 400" role="img" aria-label="누수 저항식 2전극 프로브 배선 — 전극A→3V3, 전극B→GPIO17. 10MΩ 풀다운은 GPIO17↔GND 보드 부품(센서 선 아님)" xmlns="http://www.w3.org/2000/svg" style="width:100%;height:auto">
<!-- Pi header block --> <!-- Pi header block -->
<rect x="36" y="70" width="150" height="250" rx="10" fill="#f1f3f5" stroke="#adb5bd" stroke-width="1.5"/> <rect x="36" y="70" width="150" height="250" rx="10" fill="#f1f3f5" stroke="#adb5bd" stroke-width="1.5"/>
<text x="111" y="60" text-anchor="middle" font-size="13" font-weight="700" fill="#212529">Raspberry Pi 4 · 40-pin header</text> <text x="111" y="60" text-anchor="middle" font-size="13" font-weight="700" fill="#212529">Raspberry Pi 4 · 40-pin header</text>
@ -314,36 +314,39 @@
<text x="74" y="274" text-anchor="start" font-family="Consolas,monospace" font-size="12" fill="#212529">Pin 6 · GND</text> <text x="74" y="274" text-anchor="start" font-family="Consolas,monospace" font-size="12" fill="#212529">Pin 6 · GND</text>
<rect x="182" y="264" width="10" height="12" rx="2" fill="#1971c2"/> <rect x="182" y="264" width="10" height="12" rx="2" fill="#1971c2"/>
<!-- sensor block --> <!-- sensor block -->
<rect x="470" y="95" width="150" height="190" rx="10" fill="#ffffff" stroke="#495057" stroke-width="1.5"/> <rect x="470" y="92" width="164" height="150" rx="10" fill="#ffffff" stroke="#495057" stroke-width="1.5"/>
<text x="545" y="84" text-anchor="middle" font-size="13" font-weight="700" fill="#212529">e-con 5C-08 leak sensor</text> <text x="552" y="82" text-anchor="middle" font-size="13" font-weight="700" fill="#212529">e-con 5C-08 리크 프로브</text>
<text x="552" y="106" text-anchor="middle" font-size="11" font-weight="700" fill="#2b8a3e">2선(2전극)</text>
<rect x="462" y="114" width="10" height="12" rx="2" fill="#e03131"/> <rect x="462" y="114" width="10" height="12" rx="2" fill="#e03131"/>
<text x="484" y="124" text-anchor="start" font-family="Consolas,monospace" font-size="12" fill="#212529">VCC 3.3V</text> <text x="484" y="124" text-anchor="start" font-family="Consolas,monospace" font-size="12" fill="#212529">전극 A</text>
<rect x="462" y="189" width="10" height="12" rx="2" fill="#2f9e44"/> <rect x="462" y="189" width="10" height="12" rx="2" fill="#2f9e44"/>
<text x="484" y="199" text-anchor="start" font-family="Consolas,monospace" font-size="12" fill="#212529">SIG signal</text> <text x="484" y="199" text-anchor="start" font-family="Consolas,monospace" font-size="12" fill="#212529">전극 B</text>
<rect x="462" y="264" width="10" height="12" rx="2" fill="#1971c2"/> <rect x="556" y="150" width="9" height="58" rx="2" fill="#e03131"/>
<text x="484" y="274" text-anchor="start" font-family="Consolas,monospace" font-size="12" fill="#212529">GND</text> <rect x="580" y="150" width="9" height="58" rx="2" fill="#2f9e44"/>
<path d="M560,208 q13,9 25,0" fill="none" stroke="#4dabf7" stroke-width="2.5"/>
<text x="572" y="228" text-anchor="middle" font-size="10.5" fill="#1971c2">물 닿으면 도통</text>
<!-- wires --> <!-- wires -->
<path d="M192,120 H462" stroke="#e03131" stroke-width="2.5" fill="none"/> <path d="M192,120 H462" stroke="#e03131" stroke-width="2.5" fill="none"/>
<path d="M192,195 H462" stroke="#2f9e44" stroke-width="2.5" fill="none"/> <path d="M192,195 H462" stroke="#2f9e44" stroke-width="2.5" fill="none"/>
<path d="M192,270 H462" stroke="#1971c2" stroke-width="2.5" fill="none"/> <path d="M192,270 H340" stroke="#1971c2" stroke-width="2.5" fill="none"/>
<text x="327" y="111" text-anchor="middle" font-size="11" fill="#c92a2a">3.3V power · Pin 1</text> <text x="322" y="111" text-anchor="middle" font-size="11" fill="#c92a2a">① 전극 A → 3V3 · Pin 1</text>
<text x="250" y="186" text-anchor="middle" font-size="11" fill="#2b8a3e">Signal · GPIO17 · Pin 11</text> <text x="248" y="186" text-anchor="middle" font-size="11" fill="#2b8a3e">② 전극 B → GPIO17 · Pin 11</text>
<text x="250" y="261" text-anchor="middle" font-size="11" fill="#1864ab">GND · Pin 6</text> <text x="228" y="288" text-anchor="middle" font-size="11" fill="#1864ab">GND · Pin 6 (풀다운용)</text>
<!-- external pulldown between SIG wire and GND wire --> <!-- external pulldown between GPIO17 wire and GND wire (board part, not a sensor lead) -->
<circle cx="340" cy="195" r="4" fill="#2f9e44"/> <circle cx="340" cy="195" r="4" fill="#2f9e44"/>
<circle cx="340" cy="270" r="4" fill="#1971c2"/> <circle cx="340" cy="270" r="4" fill="#1971c2"/>
<polyline points="340,199 340,206 330,210 350,218 330,226 350,234 330,242 340,246 340,266" fill="none" stroke="#343a40" stroke-width="2"/> <polyline points="340,199 340,206 330,210 350,218 330,226 350,234 330,242 340,246 340,266" fill="none" stroke="#343a40" stroke-width="2"/>
<text x="360" y="226" text-anchor="start" font-size="13" font-weight="700" fill="#343a40">10MΩ</text> <text x="356" y="222" text-anchor="start" font-size="12" font-weight="700" fill="#343a40">10MΩ 풀다운</text>
<text x="360" y="242" text-anchor="start" font-size="11" fill="#495057">External pull-down (required)</text> <text x="356" y="238" text-anchor="start" font-size="10" fill="#c92a2a">(보드 부품·센서 선 아님)</text>
<!-- internal pull off note --> <!-- internal pull off note -->
<rect x="60" y="300" width="330" height="26" rx="6" fill="#fff5f5" stroke="#ffa8a8" stroke-width="1.5" stroke-dasharray="4 3"/> <rect x="60" y="300" width="330" height="26" rx="6" fill="#fff5f5" stroke="#ffa8a8" stroke-width="1.5" stroke-dasharray="4 3"/>
<text x="72" y="317" text-anchor="start" font-size="11" font-weight="700" fill="#c92a2a">Internal pull OFF · USE_INTERNAL_PULL=False (PUD_OFF)</text> <text x="72" y="317" text-anchor="start" font-size="11" font-weight="700" fill="#c92a2a">내부 풀 OFF · USE_INTERNAL_PULL=False (PUD_OFF)</text>
<!-- logic box --> <!-- logic box -->
<rect x="60" y="350" width="520" height="30" rx="6" fill="#f1f3f5" stroke="#ced4da"/> <rect x="60" y="350" width="540" height="30" rx="6" fill="#f1f3f5" stroke="#ced4da"/>
<text x="320" y="369" text-anchor="middle" font-size="11.5" fill="#343a40">Dry → GPIO=LOW(0) · Leak → GPIO=HIGH(1) · ACTIVE_LOW=False</text> <text x="330" y="369" text-anchor="middle" font-size="11.5" fill="#343a40">건조 → GPIO17=LOW(0) · 누수(물 도통) → GPIO17=HIGH(1) · ACTIVE_LOW=False</text>
</svg> </svg>
</div> </div>
<div class="hint">How it works: when dry, the sensor sits in an ultra-high-impedance (nearly open) state, so the external 10MΩ pull-down holds GPIO17 <b>LOW</b>. When a leak bridges the electrodes with water, 3.3V pulls the signal line up through ~1.5MΩ and GPIO17 switches to <b>HIGH</b>.</div> <div class="hint"><b>센서는 2선(2전극).</b> 전극 A는 3V3(Pin 1), 전극 B는 GPIO17(Pin 11)에 연결한다. Pin 6 GND는 <b>센서 선이 아니라</b> GPIO17↔GND 사이 10MΩ 풀다운 저항용이다. 건조 시 프로브가 초고임피던스(거의 개방)라 풀다운이 GPIO17을 <b>LOW</b>로 잡고, 물이 두 전극을 이으면 3.3V가 ~1.5MΩ를 통해 전극 B 선을 끌어올려 GPIO17이 <b>HIGH</b>가 된다.</div>
</section> </section>
<!-- 5) Electrical design · cautions --> <!-- 5) Electrical design · cautions -->
@ -487,7 +490,7 @@
<td><span class="tag gnd">Ground</span> GND</td> <td><span class="tag gnd">Ground</span> GND</td>
<td class="mono">GND</td> <td class="mono">GND</td>
<td class="mono">Pin 20</td> <td class="mono">Pin 20</td>
<td>Keep the high-impedance leak ground <b>short &amp; solid</b>. (alt: Pin 25)</td> <td>10MΩ 풀다운 리턴 GND(<b>센서 선 아님</b>). 고임피던스 라인이라 짧고 견고하게. (alt: Pin 25)</td>
</tr> </tr>
<!-- SHT30 --> <!-- SHT30 -->
<tr> <tr>

View file

@ -403,13 +403,13 @@
<td><b>I2C data</b> (SDA)</td> <td><b>I2C data</b> (SDA)</td>
<td class="mono">GPIO2 / SDA1</td> <td class="mono">GPIO2 / SDA1</td>
<td><span class="pinbadge">3</span></td> <td><span class="pinbadge">3</span></td>
<td>4.7kΩ pull-up → 3.3V <span style="color:var(--muted)">(omit if built into module)</span></td> <td><span style="color:var(--muted)">모듈 내장 풀업 → 직결 시 불필요</span> (풀업 없는 베어 칩만 4.7kΩ→3.3V)</td>
</tr> </tr>
<tr> <tr>
<td><b>I2C clock</b> (SCL)</td> <td><b>I2C clock</b> (SCL)</td>
<td class="mono">GPIO3 / SCL1</td> <td class="mono">GPIO3 / SCL1</td>
<td><span class="pinbadge">5</span></td> <td><span class="pinbadge">5</span></td>
<td>4.7kΩ pull-up → 3.3V <span style="color:var(--muted)">(omit if built into module)</span></td> <td><span style="color:var(--muted)">모듈 내장 풀업 → 직결 시 불필요</span> (풀업 없는 베어 칩만 4.7kΩ→3.3V)</td>
</tr> </tr>
<tr> <tr>
<td><b>Ground</b> (GND)</td> <td><b>Ground</b> (GND)</td>
@ -429,7 +429,7 @@
<!-- ============ 4. SCHEMATIC SVG ============ --> <!-- ============ 4. SCHEMATIC SVG ============ -->
<section> <section>
<h2><span class="n">4</span>Wiring Schematic <small>sensor ↔ header ↔ pull-up resistors</small></h2> <h2><span class="n">4</span>Wiring Schematic <small>센서 모듈 ↔ 헤더 · 4선 직결(내장 풀업)</small></h2>
<svg class="svg-sch" viewBox="0 0 840 400" role="img" aria-label="SHT30 wiring schematic"> <svg class="svg-sch" viewBox="0 0 840 400" role="img" aria-label="SHT30 wiring schematic">
<!-- component boxes --> <!-- component boxes -->
@ -459,8 +459,8 @@
<path class="w-gnd" d="M220 305 H640"/> <path class="w-gnd" d="M220 305 H640"/>
<text class="wlbl" x="300" y="322" fill="#2b3541">Ground GND</text> <text class="wlbl" x="300" y="322" fill="#2b3541">Ground GND</text>
<!-- SDA wire (with hop over SCL pull-up branch at x=480) --> <!-- SDA wire (direct, no hop — module has on-board pull-ups) -->
<path class="w-i2c" d="M220 200 H470 A10 9 0 0 1 490 200 H640"/> <path class="w-i2c" d="M220 200 H640"/>
<text class="wlbl" x="300" y="216" fill="#155a9c">SDA → GPIO2</text> <text class="wlbl" x="300" y="216" fill="#155a9c">SDA → GPIO2</text>
<!-- SCL wire --> <!-- SCL wire -->
@ -472,26 +472,13 @@
<text class="wlbl" x="228" y="368" fill="#3b444d">ADDR → GND = 0x44</text> <text class="wlbl" x="228" y="368" fill="#3b444d">ADDR → GND = 0x44</text>
<circle class="jn" cx="300" cy="305" r="4"/> <circle class="jn" cx="300" cy="305" r="4"/>
<!-- Pull-up R1 on SDA (x=400) --> <!-- Purchased part is a breakout module with on-board pull-ups → no external resistors (direct 4-wire) -->
<path class="w-i2c" d="M400 200 V190"/> <text x="430" y="282" text-anchor="middle" font-size="12" font-weight="700" fill="#2b8a3e">모듈 내장 풀업 · 외부 저항 불필요 (4선 직결)</text>
<rect class="res" x="390" y="165" width="20" height="25" rx="3"/>
<path class="w-i2c" d="M400 165 V150"/>
<circle class="jn" cx="400" cy="200" r="4"/>
<circle class="jn" cx="400" cy="150" r="4"/>
<text class="rlbl" x="416" y="180">R1 4.7kΩ</text>
<!-- Pull-up R2 on SCL (x=480), branch rises past SDA (hop) up to rail -->
<path class="w-i2c" d="M480 250 V188"/>
<rect class="res" x="470" y="163" width="20" height="25" rx="3"/>
<path class="w-i2c" d="M480 163 V150"/>
<circle class="jn" cx="480" cy="250" r="4"/>
<circle class="jn" cx="480" cy="150" r="4"/>
<text class="rlbl" x="496" y="178">R2 4.7kΩ</text>
</svg> </svg>
<p class="sch-note"> <p class="sch-note">
Pull-up resistors R1·R2 (4.7kΩ ×2) connect to the 3.3V rail. <b>Omit if built into the SHT30 module</b>. 구매품은 온보드 풀업이 있는 <b>SHT30 브레이크아웃 모듈</b>이라 외부 풀업 저항이 필요 없다.
The half-circle (hop) on the SDA line only marks a wire crossing — it is not an electrical connection. VCC·GND·SDA·SCL 4선을 헤더에 직결한다. (풀업 없는 베어 SHT30 칩을 쓸 때만 SDA·SCL에 4.7kΩ×2 → 3.3V 를 추가한다.)
</p> </p>
</section> </section>