chore: HERV 통합 저장소 재초기화 커밋

손상된 .git 히스토리(missing tree)로 재초기화 후 작업트리 전체 커밋.
.claude/ 만 제외(로컬 에이전트 설정). 구 저장소 백업(.git_corrupt_backup/) 포함.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
jeon
2026-06-16 09:29:03 +09:00
commit a502322188
630 changed files with 65126 additions and 0 deletions
+142
View File
@@ -0,0 +1,142 @@
# EW11 (RS-485 ↔ WiFi) HOMENET 연결 검토
- 작성일: 2026-05-26
- 대상 장비: Elfin EW11A (Hi-Flying) — RS-485 ↔ WiFi 투명 시리얼 브리지
- 대상 MCU: Nuvoton Nano100 시리즈 (HERV)
- 관련 문서:
- `EW11_RS485 TO WIFI/EW11A manual/Elfin-EW1X_User ManualV1.3(20200415).pdf`
- `EW11_RS485 TO WIFI/IOTService3.1.0_20220926/`
- `doc/HERV_MCU PINMAP & CONNECTOR.txt`
---
## 1. 결론
**하드웨어/펌웨어 모두 가능**. 단, UART1 채널이 PC_Monitoring(디버그)과 HOMENET(CVnet)에 동시에 사용될 수 없는 구조적 트레이드오프가 있음.
EW11은 **투명 시리얼 브리지(Transparent Serial Bridge)**이므로 UART ↔ TCP/WiFi 변환을 EW11 내부에서 처리한다. MCU 펌웨어 측에서는 EW11의 존재를 알 필요가 없고, 기존 CVnet 프로토콜 코드를 그대로 사용하면 된다.
---
## 2. 현재 시스템 UART 채널 구성
| 채널 | 용도 | 초기화 위치 | Baud |
|---|---|---|---|
| UART0 | Hood (후드, CN6/CN13) | `program/User/My_system.c:36` | 9600 |
| **UART1** | **HOMENET (CVnet) — CN15** | `program/User/My_system.c:50` | 9600 |
| SC0 (SCUART) | Roomcon 232 | `program/User/My_system.c:64` | 1200 |
| SC1 (SCUART) | Bunbaegi 분배기 | `program/User/My_system.c:73` | 115200 |
### HOMENET 핀맵 (CN15, RED, HOMENET_485)
- TX: PB.5 (E485_TX)
- RX: PB.4 (E485_RX)
- DIR: PB.6 (E485_DIR)
> Nano100 시리즈는 **UART0/UART1 2개만 제공**하므로 추가 UART 확보가 불가능하다.
---
## 3. 하드웨어 연결 방안
| 항목 | 기존 HOMENET | EW11 연결 |
|---|---|---|
| 커넥터 | CN15 (RED), HOMENET_485 | CN15 RS-485 A/B 라인에 EW11 RS-485 단자 병렬 연결 |
| MCU 핀 | UART1: PB.4(RX), PB.5(TX), PB.6(DIR) | 변경 없음 |
| Baud | 9600 8N1 | EW11도 9600 8N1로 설정 |
EW11은 자체 RS-485 트랜시버를 가지고 DIR을 자동 제어하므로 MCU의 PB.6 DIR 제어와 충돌하지 않는다(RS-485 멀티드롭 버스 구성).
```
[홈넷 서버/앱] ──(WiFi/TCP)── [EW11] ──(RS-485 A/B)── [CN15] ── [MCU UART1]
```
---
## 4. 펌웨어 측 필요 작업
### 4.1 CVnet 프로토콜 복구 (직전 작업 되돌리기)
직전 작업으로 비활성화한 두 곳을 다시 활성화해야 HOMENET 패킷을 처리할 수 있다.
- `program/User/main.c:110`
```c
CVnet_Com_process();
```
- `program/User/My_Uart.c:1758`
```c
rx_debug_check(u8InChar);
Rx_CVnet_TimeOut = 50;
```
### 4.2 PC_Monitoring과 동시 사용 불가 ⚠️
UART1은 단 하나의 물리 채널이므로 PC_Monitoring(디버그)과 CVnet(홈넷)이 **동시에 사용 불가**하다. 다음 중 하나를 선택해야 한다.
| 옵션 | 설명 | 비용 | 권장 |
|---|---|---|---|
| ① 평소 CVnet만, 디버그 시에만 PC_Monitoring | `#ifdef DEBUG_PC_MODE` 컴파일 스위치로 분리 | 펌웨어만 수정 | **★ 권장** |
| ② PC_Monitoring을 UART0(Hood)로 이전 | Hood 통신을 잠시 끊고 디버그 | Hood 제어 일시 중단 | △ |
| ③ 다른 시리얼(SC0/SC1) 사용 | 기존 통신 영향 | 다른 통신 끊김 | △ |
### 4.3 CVnet 타임아웃 검토
WiFi 경로는 **20 ~ 200 ms의 가변 지연**이 발생한다.
- MCU 측 `Rx_CVnet_TimeOut = 50` (50 ms): **패킷 수신 중단 감지용**이므로 EW11 bridge엔 직접 영향 없음.
- 홈넷 마스터(서버) 측의 응답 타임아웃은 EW11 RTT를 감안해 설정 필요. 너무 짧으면 재전송 빈발.
---
## 5. EW11 설정 (PC에서 IOTService 도구로)
| 항목 | 권장값 |
|---|---|
| Serial Baudrate | 9600 |
| Data / Parity / Stop | 8 / None / 1 |
| Flow Control | None |
| Protocol | **TCP Server** (홈넷 서버가 클라이언트로 접속) 또는 **TCP Client** (EW11이 서버에 접속) |
| Port | 홈넷 게이트웨이와 합의된 포트 |
| Buffer length | 8 (CVnet 패킷이 8바이트 고정) — 패킷 단위 전송 보장 |
| Heartbeat / KeepAlive | 활성화 (WiFi 연결 유지) |
| WiFi 보안 | WPA2-PSK |
| Reconnect | 자동 재접속 활성화 |
IOTService 다운로드: `http://ftp.hi-flying.com:9000/IOTService/`
---
## 6. 위험 요소 및 평가
| 항목 | 평가 |
|---|---|
| 펌웨어 변경량 | 매우 적음 (CVnet 코드 복구만) |
| 하드웨어 비용 | EW11 1개 + 5V 전원 + WiFi AP |
| 응답 지연 | WiFi RTT 20~200 ms 추가 — 시나리오 제어용으론 충분 |
| 신뢰성 | WiFi 끊김 시 홈넷 단절. EW11 자동 재접속 설정 필수 |
| 보안 | EW11 자체 암호화는 제한적. 동일 LAN 내 사용 권장. 외부 노출 시 VPN/방화벽 필요 |
| 디버그 병행 | **불가** — PC 디버그 채널을 별도 UART로 이전하거나 컴파일 분리 필요 |
| 멀티드롭 충돌 | MCU와 EW11이 같은 RS-485 버스 → 마스터-슬레이브 규칙 준수 시 문제없음 |
---
## 7. 권장 진행 순서
1. **CVnet 코드 복구** — `main.c:110`, `My_Uart.c:1758` 주석 해제
2. **PC_Monitoring 조건부 컴파일 분리** — `#ifdef DEBUG_PC_MODE`로 양산 빌드에서 제외
3. **EW11 평가보드 1대 확보** 후 단독 테스트
- PC ↔ EW11(WiFi) ↔ RS-485 루프백 (송수신 확인)
- PC ↔ EW11(WiFi) ↔ RS-485 ↔ MCU 통신 (CVnet 패킷 응답 확인)
4. **응답 지연 측정** — 마스터-슬레이브 타임아웃 마진 검증
5. **장시간 안정성 시험** — WiFi 끊김/재접속 시나리오 포함
---
## 8. 참고
- EW11A 매뉴얼: `EW11_RS485 TO WIFI/EW11A manual/Elfin-EW1X_User ManualV1.3(20200415).pdf`
- 운용 가이드: `EW11_RS485 TO WIFI/EW11A manual/HF2211S_EW1X_PW1X_Wport-W30_Operation Guide(20220525).pdf`
- 소프트웨어 기능: `EW11_RS485 TO WIFI/EW11A manual/IOT_Device_Series_Software_Funtion_20250328.pdf`
- IOTService 매뉴얼: `EW11_RS485 TO WIFI/IOTService3.1.0_20220926/IOTService_User_Manual_20200708.pdf`
- 핀맵: `doc/HERV_MCU PINMAP & CONNECTOR.txt`
- HOMENET 프로토콜: `Protocol/힘펠_환기장치프로토콜V3.7_240111.xlsx`
- 시나리오 프로토콜: `Protocol/DL 환기 시나리오 제어 프로토콜_20260319-1_노량진모델하우스_2차.xlsx`