# VesiScan BASIC - Zephyr (nRF Connect SDK)

nRF52840 기반 VesiScan BASIC 펌웨어의 Zephyr 포팅 프로젝트입니다.

## 현재 구현 상태

| Stage | 내용 | 상태 |
|-------|------|------|
| 1 | GPIO + 전원 래치 + 버튼 상태머신 | 완료 |
| 1 | LED 제어 (green/orange 패턴) | 완료 |
| 2 | BLE 스택 + NUS (advertising, 연결, 재연결) | 완료 |
| 3 | 배터리 ADC (AIN2, 12bit, 저전압 자동 OFF) | 진행중 |
| 3 | 커맨드 파서 (msn? 구현) | 진행중 |
| - | Flash 저장소 (NVS) | 미구현 |
| - | 온도 센서 (TMP235, AIN3) | 미구현 |
| - | IMU (ICM42670P, I2C) | 미구현 |
| - | 피에조 + ADC121S051 | 미구현 |
| - | BLE 보안 (본딩, 패스키) | 미구현 |

## 프로젝트 구조

```
blinky/
├── CMakeLists.txt                          # 빌드 설정 (소스 파일 등록)
├── prj.conf                                # Kconfig 설정 (기능 ON/OFF)
├── boards/
│   └── nrf52840dk_nrf52840.overlay         # Devicetree Overlay (핀 매핑)
└── src/
    ├── main.c                              # 메인 진입점 + 부팅 시퀀스 + 버튼 상태머신
    ├── main.h                              # 전역 상수/변수/타입 정의
    ├── debug_print.h                       # 디버그 출력 매크로 (RTT)
    ├── parser.c / .h                       # BLE 커맨드 파서 (TAG+DATA+CRC16)
    ├── power_control.c / .h                # 전원 시퀀스 상태머신
    ├── ble/
    │   └── ble_service.c / .h              # BLE NUS 서비스 (advertising, 연결, TX/RX)
    └── drivers/
        ├── battery/
        │   └── battery_adc.c / .h          # 배터리 전압 ADC (AIN2, 12bit)
        └── led/
            └── led_control.c / .h          # LED 패턴 제어 (k_timer 기반)
```

## 빌드 방법

### 일반 빌드
소스 파일(.c/.h)만 변경한 경우.

### Pristine Build
아래 파일을 변경한 경우 반드시 Pristine Build:
- `prj.conf` (Kconfig 설정)
- `boards/*.overlay` (Devicetree 핀 매핑)
- `CMakeLists.txt` (소스/include 경로 추가)

nRF Connect for VS Code → Build 패널 → **Pristine Build** 또는 `build` 폴더 삭제 후 빌드.

## 핀 매핑 (Devicetree Overlay)

| 이름 | 핀 | 방향 | 역할 |
|------|-----|------|------|
| `PWR_HOLD` | P0.08 | Output, Active HIGH | 전원 래치 |
| `BUTTON_CHECK` | P1.08 | Input, Pull-up, Active LOW | 전원 버튼 |
| `LED_BLE` | P0.12 | Output, Active LOW | 초록 LED |
| `FUNCTION_LED` | P0.29 | Output, Active LOW | 주황 LED |
| ADC AIN2 | P0.04 | Analog Input | 배터리 전압 분압 |

> UART0은 P0.08 충돌 방지를 위해 비활성화 (`status = "disabled"`)

## 전원 버튼 동작

| 동작 | 조건 | 결과 |
|------|------|------|
| 부팅 (OFF→ON) | 2초 이상 홀드 | 전원 래치 + LED 깜빡임 + BLE advertising |
| 무시 | 부팅 후 2초 미만 릴리스 | 전원 OFF (래치 안 됨) |
| 전원 OFF (ON→OFF) | 버튼 놓은 뒤 다시 2초 홀드 | advertising 중지 + LED OFF + 3초 후 전원 차단 |

## BLE 커맨드 프로토콜

### 패킷 포맷
```
[TAG 4바이트] [DATA N바이트] [CRC16 2바이트]
```
- TAG: ASCII 4글자 (예: `msn?`, `mfv?`)
- DATA: uint16 little-endian 값들
- CRC16: CRC-CCITT (초기값 0xFFFF)
- 응답 TAG: 첫 글자 `m` → `r` (예: `msn?` → `rsn:`)

### 구현된 커맨드

| 커맨드 | 응답 | 기능 |
|--------|------|------|
| `msn?` | `rsn:` + uint16 mV | 배터리 전압 측정 |

### 전체 커맨드 목록 (구현 예정)

| # | 내용 | 명령 | 응답 | 비고 |
|---|------|------|------|------|
| 1 | 전원 OFF | `msq?` | `rsq:` | |
| 2 | 재부팅 | `mss?` | `rss:` | |
| 3 | 본딩 삭제 + 재부팅 | `msr?` | `rsr:` | |
| 4 | LED 상태 | `mls?` | - | |
| 5 | HW Version 읽기 | `mrh?` | `rrh:` | FDS |
| 6 | HW Version 쓰기 | `mwh?` | `rwh:` | FDS |
| 7 | Serial Number 읽기 | `mrs?` | `rrs:` | FDS |
| 8 | Serial Number 쓰기 | `mws?` | `rws:` | FDS |
| 9 | FW Version 읽기 | `mfv?` | `rfv:` | |
| 10 | Passkey 읽기 | `mqz?` | `rqz:` | FDS |
| 11 | Passkey 쓰기 | `mpz?` | `rpz:` | FDS |
| 12 | 배터리 측정 | `msn?` | `rsn:` | 구현 완료 |
| 13 | IMU 단발 측정 | `msp?` | `rsp:` | |
| 14 | 온도 측정 | `mso?` | `rso:` | |
| 15 | 단일 채널 측정 | `mec?` | `reb:` → `raa:` | 테스트용 |
| 16 | 모든 채널(6) 측정 | `maa?` | `reb:`(6개) → `raa:` | |
| 17 | 전체 측정 | `mbb?` | `rbb:` → `reb:`(6개) → `raa:` | 배터리+IMU+온도+피에조 |
| 18 | 측정 파라미터 읽기 | `mcf?` | `rcf:` | FDS |
| 19 | 측정 파라미터 쓰기 | `mcs?` | `rcs:` | FDS |

## 디버그 로그 (RTT)

- **VS Code**: nRF Connect 패널 → Connected Devices → 보드 선택 → 터미널 아이콘
- **J-Link RTT Viewer**: Connection: USB, Target Device: NRF52840_XXAA

### 로그 태그
| 태그 | 내용 |
|------|------|
| `[BTN]` | 버튼 이벤트 (2s 홀드, 릴리스) |
| `[PWR]` | 전원 래치 ON/OFF |
| `[BOOT]` | 부팅 시퀀스 완료 |
| `[BLE]` | BLE 연결/해제/advertising/파라미터 |
| `[BLE RX]` | NUS 수신 데이터 (hex dump) |
| `[NUS TX]` | NUS 송신 |
| `[CMD]` | 커맨드 파서 처리 결과 |
| `[BATT]` | 배터리 ADC 측정값 |
| `[SYS]` | 슬립 진입 |

## prj.conf 주요 설정

| 설정 | 값 | 역할 |
|------|-----|------|
| `CONFIG_GPIO` | y | GPIO 드라이버 |
| `CONFIG_LOG` | y | 로깅 시스템 |
| `CONFIG_LOG_BACKEND_RTT` | y | RTT 로그 출력 |
| `CONFIG_SERIAL` | n | UART 비활성화 (P0.08 충돌 방지) |
| `CONFIG_BT` | y | BLE 스택 |
| `CONFIG_BT_NUS` | y | Nordic UART Service |
| `CONFIG_BT_L2CAP_TX_MTU` | 247 | MTU 크기 |
| `CONFIG_BT_CTLR_TX_PWR_PLUS_8` | y | TX power +8dBm |
| `CONFIG_ADC` | y | ADC 드라이버 (배터리, 온도) |