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 드라이버 (배터리, 온도)