fix: 260618 내부댐퍼·스마트수면·쾌적조리 동작 수정

- 내부댐퍼: 모드전환 중 명령경로(CTRL_FAN)가 팬 감속에 끼어들어 댐퍼가 간헐적으로 안 움직이던 문제 수정 (Fan_Speed_process 게이트 보호) - 명령경로 즉시 팬설정(My_Homenet/My_Hood) 모드변경분 주석 — 마스터 정렬 - 스마트수면: 거실(room1) CO2 무관 항상 CLOSE (사양 8p) - 대시보드: 쾌적조리 버튼 강조=ComfortCook(연동 Enable), 활성=후드/시나리오 무관 항상 토글 (사양 9p 3.1 독립 토글) - doc/260618 수정 정리 + 개발사양서 갱신 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 18:48:41 +09:00
parent 82caac3872
commit c5e4c48d24
7 changed files with 206 additions and 10 deletions
@@ -0,0 +1,172 @@
+# 260618 수정 요약 (핸드오프용)
+
+> 작업 PC 이전 시점 기준. 아래 상세 항목 (1)~(5) 의 최종 변경 정리.
+
+## 변경 파일 (커밋 포함)
+| 파일 | 변경 요지 | 관련 항목 |
+|---|---|---|
+| `Source/HECO2/User/MyMotor.c` | 모드전환 중(`Damper_wait_time==5`) 팬 강제 0 → 내부댐퍼 이동 게이트 보호 | (3) |
+| `Source/HECO2/User/My_Homenet.c` | 모드변경 시 명령경로 즉시 `Fan_Speed_Setting` 호출 주석(L259/293) — 마스터 정렬 | (1) |
+| `Source/HECO2/User/My_Hood.c` | 후드연동 모드변경 시 즉시 `Fan_Speed_Setting` 주석(L192/207) — 마스터 정렬 | (1) |
+| `Source/HECO2/User/My_system.c` | 스마트수면 거실(room1) CO2 무관 항상 CLOSE | (2) |
+| `TestProgram/PCDashBoard/MainWindow.xaml.cs` | 쾌적조리 버튼 강조=ComfortCook(L583), 활성=항상(L587) | (4)(5) |
+| `개발사양서/...DL_동작로직_260613.pptx` | 사양서 갱신(바이너리) | - |
+
+## 빌드 상태
+- 펌웨어: `cd SOURCE/HECO2 && bash build.sh all` → 경고/오류 0.
+- 대시보드: `dotnet publish ErvDashboard.csproj -c Release` → 오류 0 (NU1701 경고만).
+- 대시보드 exe: `TestProgram/PCDashBoard/bin/Release/net10.0-windows/win-x64/publish/ErvDashboard.exe`
+
+## 실장비/대시보드 확인 필요(테스트 대기)
+- 환기→공청 반복 전환 시 내부댐퍼 매번 이동(간헐성 해소). 전환 시 팬이 잠깐 0까지 멈췄다 복귀하는 것이 정상.
+- 스마트수면 진입 시 거실 닫힘 + 침실 CO2 개폐.
+- 쾌적조리 버튼이 후드 연결/전원 무관하게 항상 토글되는지.
+
+## 미적용/보류
+- (선택) 쾌적조리를 스마트수면/안심회복과의 **상호배타에서 분리**(사양상 독립 토글) — SubMode_Click L401~406.
+- (보류) 펌웨어 쾌적조리를 `Ext_Run_Mode==2` 상태머신으로 배선(현재 My_system 846/952 dead code). 1차 대시보드 수정으로 충분한지 검증 후 결정.
+- 1차 명령경로 주석(My_Homenet/My_Hood)은 (3) 게이트 보호로 중복이나 무해 — 정리 보류.
+
+---
+
+# 260618 내부댐퍼 — 운전모드 변경 시 미동작 수정 (1차: 명령경로 즉시 팬설정 제거)
+
+## 증상
+- 환기 → 공청 전환 시 **팬은 정상 동작하는데 내부댐퍼(본체 6개)가 안 움직임.**
+
+## 원인 (마스터 `D:\Project\nuvoton\HERV_DL_MH_2nd\Program` 비교로 확정)
+- 내부댐퍼 이동 트리거(`Fan_Speed_process`가 모드변경 시 `Damper_Mode()` 호출)는 HECO2/마스터 **동일하게 존재**. 빠진 게 아님.
+- 그 트리거는 **"팬이 0까지 감속"되어야 발동**하도록 게이팅됨(공기 흐름 중 댐퍼 미동작 의도):
+  `모드변경 → 팬타깃0 → 팬=0 도달 → Damper_Mode 호출(댐퍼 이동) → 정렬(Step_Status==0x3F) → 팬 복원`
+- **마스터:** 명령 핸들러가 팬 타깃을 안 건드림 → 팬이 0 도달 → 댐퍼 이동.
+- **HECO2:** 명령 핸들러가 모드변경 즉시 `Fan_Speed_Setting()` 직접 호출 → 팬 타깃이 곧바로 운전속도로 올라감 → **팬이 0에 도달 못 함 → `if(Fan!=0) if(wait==5) goto PASS1` 게이트가 `Damper_Mode` 영원히 스킵 → 댐퍼 미동작, 팬만 정상.**
+- 마스터엔 없고 HECO2에만 추가된 명령경로 `Fan_Speed_Setting` 호출이 게이트를 막은 것.
+
+## 변경 파일/내용 (1차 = 모드 변경 시 호출만 제거, 풍량단수 변경 호출은 유지)
+주석 처리(삭제 아님, 복원 용이). 마커: `[모드변경댐퍼테스트]`
+- `Source/HECO2/User/My_Homenet.c`
+  - L259 CTRL_POWER(전원ON→환기) `Fan_Speed_Setting` 주석
+  - L293 CTRL_RUNMODE(운전모드 변경) `Fan_Speed_Setting` 주석  ← 보고 증상(대시보드 환기→공청)의 직접 경로
+  - **L306 CTRL_FAN(풍량단수만 변경)은 유지** (댐퍼 무관, 팬 단수 반응 필요)
+- `Source/HECO2/User/My_Hood.c`
+  - L192 후드ON(→환기) `Fan_Speed_Setting` 주석
+  - L207 후드OFF(모드 복귀) `Fan_Speed_Setting` 주석
+  - **L219 후드 단수변경(풍량만)은 유지**
+
+## 핵심 결정
+- 모드 변경 후 팬 복원은 `Fan_Speed_process`의 wait==1 호출(MyMotor.c 1018/1056/1090/1124, ③)이 담당 → 팬이 꺼진 채 남지 않음.
+- RJ2(`My_RJ2.c`)·분배기(`My_bunbaegi.c`)는 두 소스 동일 → 미수정.
+- 이번엔 "동작모드 변경 트리거 복원(①, 디퓨저 시퀀스 명령트리거)"은 보류 — ②(땜빵) 제거만으로 댐퍼가 움직이는지 먼저 검증.
+
+## 빌드 결과
+- `cd SOURCE/HECO2 && bash build.sh all` → 성공, 경고/오류 0.
+- text 43920 / data 1940 / bss 3388 (HERV.elf). (이전 44008 → 코드 제거로 감소)
+
+## 미해결 / 후속
+- 실장비/시뮬레이터에서 **환기→공청 시 내부댐퍼 이동** 확인 필요(특히 고풍량 전환 시 팬 감속 대기시간 체감).
+- 검증 후: 필요하면 ①(동작모드 변경 트리거 = MyMotor.c 디퓨저/팬복원 타이밍의 명령 트리거)도 마스터 정렬 검토.
+- 풍량단수만 바꿀 때(L306/L219) 팬 즉시 반응 정상인지 확인.
+
+---
+
+# 260618 (2) 스마트수면 모드 — 거실 댐퍼 미닫힘 수정
+
+## 증상
+- 스마트수면 동작 중 **거실 댐퍼가 열려 있음**. 사양(개발사양서 8p)상 거실은 항상 CLOSE여야 함.
+
+## 사양 (개발사양서 8p, 스마트수면)
+- 환기 수동·풍량 1단 고정.
+- 초기상태: **거실 CLOSE, 침실1~3 OPEN**.
+- 거실 급기(SA)/배기(RA) 모두 **X(항상 닫힘)** — CO2 무관.
+- 침실1~3: CO2 >= 1000 PPM → 해당 침실 OPEN, CO2 <= 800 PPM → CLOSE.
+
+## 원인
+- `My_system.c` `Air_Quality_damper_process()` `Ext_Run_Mode == 4` 블록.
+- 진입 1회(L905)는 거실(room1)을 올바르게 CLOSE 하지만, **매 틱 CO2 루프가 `Room_Num = 1`부터 돌아(L916) 거실까지 CO2 기준으로 다시 OPEN** 시킴.
+- 룸 인덱스: room1=거실, room2~4=침실1~3.
+
+## 변경 파일/내용
+- `Source/HECO2/User/My_system.c` (스마트수면 매 틱 처리)
+  - 거실(room1) 매 틱 강제 CLOSE + LED off 추가.
+  - CO2 히스테리시스 루프 시작을 `Room_Num = 1` → **`Room_Num = 2`** (침실1~3만 개폐).
+
+## 빌드 결과
+- `bash build.sh all` → 성공, 경고/오류 0. text 43940 / data 1940 / bss 3388.
+
+## 후속
+- 실장비에서 스마트수면 진입 시 거실 닫힘 + 침실 CO2 개폐 확인.
+
+---
+
+# 260618 (3) 내부댐퍼 미동작 — 진짜 원인(타이밍 레이스) 수정
+
+## 추가 진단 (사용자 확인)
+- 테스트 경로 = **PC 대시보드**(My_Homenet 경로).
+- 팬 거동 = **0까지 안 내려감**, 그리고 **간헐적**(어쩌다 정상 댐퍼 동작).
+- → 전형적 **타이밍 레이스**. (1)차 수정으로 CTRL_RUNMODE(293)는 막았지만, 대시보드가 모드변경과 함께 보내는 **CTRL_FAN(306, 유지됨)** 이 모드전환 감속창(팬→0 구간)에 끼어드는 타이밍이면 팬 타깃을 다시 켜서 팬이 0 도달 못 함 → Damper_Mode 게이트 안 열림.
+- 끼어드는 타이밍이 아니면 정상 → 간헐성 설명됨.
+
+## 수정 (2차 = 게이트 보호, 단일 지점)
+- `Source/HECO2/User/MyMotor.c` `Fan_Speed_process()` PASS1 직후(정상운전 분기, VSP 제외):
+  - `Damper_wait_time == 5`(=모드전환 진행중 전용 신호. 4개 모드 진입에서만 set, Step 정렬 전까지 5 유지)일 때
+    `Target_Fan1_Speed = 0; Target_Fan2_Speed = 0;` **강제** → 명령경로(CTRL_FAN 등)가 감속창에 끼어들어도 무시하고 팬을 0으로 떨굼 → 댐퍼 이동 보장.
+  - 전환 완료(Step_Status==0x3F) 후 wait가 5→1로 감소하며 wait==1에서 Fan_Speed_Setting(③)이 팬 복원.
+- 풍량단수만 변경(같은 모드, wait==0)은 force-zero 미적용 → CTRL_FAN(306) 즉시 반응 유지.
+
+## 동작 변화(주의)
+- 이제 환기→공청 전환 시 **팬이 잠깐 0까지 멈췄다가**(댐퍼 이동) 다시 도는 게 정상(설계상 공기흐름 중 댐퍼 미동작). 기존 "안 멈추던" 거동에서 바뀜.
+
+## 빌드 결과
+- `bash build.sh all` → 성공, 경고/오류 0. text 43948.
+
+## 후속
+- 실장비에서 환기→공청 **반복 전환** 시 매번 댐퍼 이동(간헐성 사라짐) 확인.
+- 같은 모드 풍량단수 변경 시 팬 즉시 반응 정상 확인.
+
+---
+
+# 260618 (4) 쾌적조리 재선택 안됨 — 대시보드 버튼 강조 버그
+
+## 증상
+- 쾌적조리 동작 마치고 이전 모드 복귀 후 다시 쾌적조리 버튼 누르면 선택(ON)이 안 됨. 눌러도 토글 반응이 안 보임.
+
+## 사양 (개발사양서 9p)
+- 쾌적조리 = 운전모드가 아닌 **'후드 연동 UI 토글 스위치'**. 사용자가 켤 때까지 ON 유지.
+- 3.1 매트릭스: 토글 ON + 후드꺼짐 = 대기(본래 모드 가동), 토글 ON + 후드켜짐 = 메이크업 강제연동.
+- 3.3 Roll-back: 후드 OFF 후 20분 환기 약 후 이전 모드 복귀 — 이는 메이크업 복귀 타이밍이지 토글 OFF가 아님.
+- → 토글은 **계속 armed**가 정상. 펌웨어 `Hood_YeunDong_Enable`(토글)은 정상.
+
+## 원인 (순수 대시보드 버그)
+- `_state.ComfortCook` = status byte4 bit1 = 펌웨어 `Hood_YeunDong_Enable`(토글 Enable).
+- 대시보드가 **토글 판단은 `_state.ComfortCook`(L386), 버튼 강조는 `_state.HoodRunning`(L581, 후드 실제 가동중)** 으로 서로 다른 변수 사용.
+- 대기/Roll-back 상태(HoodRunning=0, ComfortCook=1)에서 버튼이 꺼져 보이고, 다시 누르면 `next=!ComfortCook=false` → OFF 전송 → "선택 안됨".
+
+## 변경 파일/내용
+- `TestProgram/PCDashBoard/MainWindow.xaml.cs` L581:
+  - `SetActive(ComfortCookBtn, _state.HoodRunning);` → `SetActive(ComfortCookBtn, _state.ComfortCook);`
+  - 토글 상태(=Enable)를 강조하도록 일치. (모드/풍량 잠금 `subActive`는 사양 3.1대로 HoodRunning 유지 — 대기 중 본래 모드 조작 허용.)
+
+## 빌드 결과
+- `dotnet build ErvDashboard.csproj` → 오류 0 (NU1701 경고 9개는 기존 패키지 호환 경고, 무관).
+
+## 미해결 / 후속(선택)
+- 사양상 쾌적조리는 운전모드 시나리오(스마트수면/안심회복)와 **독립**인데, 대시보드는 셋을 상호배타 처리(SubMode_Click L401~406, ApplySubModeLocal). 스마트수면/안심회복 켤 때 쾌적조리가 강제 OFF됨 → 사양과 불일치 가능. 필요 시 분리 검토.
+
+---
+
+# 260618 (5) 쾌적조리 버튼 활성(Enable)이 후드 상태에 묶임 — 독립 토글로 수정
+
+## 증상
+- 쾌적조리 버튼이 디폴트 비활성, 전원 ON/후드 연결 시에야 토글됨. 사양 9p 3.1상 쾌적조리는 후드 연결과 무관한 독립 토글.
+
+## 원인
+- `MainWindow.xaml.cs` L587 `ComfortCookBtn.IsEnabled = !subActive || _state.ComfortCook;`
+- `subActive = SmartSleep || HoodRunning || ReliefRecover` 에 **HoodRunning(후드 가동중)** 포함 → 후드 상태가 쾌적조리 버튼 활성을 좌우.
+
+## 변경 파일/내용
+- `TestProgram/PCDashBoard/MainWindow.xaml.cs` L587:
+  - `ComfortCookBtn.IsEnabled = !subActive || _state.ComfortCook;` → `ComfortCookBtn.IsEnabled = true;`
+  - 쾌적조리는 독립 토글 → 후드 연결/가동·다른 시나리오와 무관하게 항상 토글 가능. (모드/풍량 버튼은 기존대로 subActive 잠금 유지.)
+
+## 빌드/배포
+- `dotnet publish ErvDashboard.csproj -c Release` → 오류 0. publish 단일 exe 갱신.