기타등등

README.md

@@ -1,6 +1,6 @@
 # VesiScan BASIC - Zephyr (nRF Connect SDK)
 
-nRF52840 기반 VesiScan BASIC 펌웨어의 Zephyr 포팅 프로젝트입니다.
+nRF52840 기반 VesiScan BASIC 펌웨어의 Zephyr 포팅 프로젝트
 
 ## 현재 구현 상태
 
@@ -9,13 +9,16 @@ nRF52840 기반 VesiScan BASIC 펌웨어의 Zephyr 포팅 프로젝트입니다.
 | 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 | 미구현 |
+| 3 | 배터리 ADC (AIN2, 12bit) | 완료 |
+| 3 | 온도 센서 TMP235 (AIN3) | 완료 |
+| 3 | IMU ICM42670P (I2C0) | 완료 |
+| 3 | 피에조 TX + mux 제어 | 완료 |
+| 3 | ADC121S051 echo capture (nrfx SPIM3) | 완료 |
+| 3 | BLE 커맨드 파서 (TAG+DATA+CRC16) | 진행중 |
+| 4 | MCUboot + MCUmgr BLE DFU 설정 | 진행중 |
+| 4 | Flash 저장소 (NVS/settings, piezo config) | 완료 |
 | - | BLE 보안 (본딩, 패스키) | 미구현 |
+| - | HW/SN/Passkey 저장/복원 | 미구현 |
 
 ## 프로젝트 구조
 
@@ -36,14 +39,22 @@ blinky/
     └── drivers/
         ├── battery/
         │   └── battery_adc.c / .h          # 배터리 전압 ADC (AIN2, 12bit)
-        └── led/
-            └── led_control.c / .h          # LED 패턴 제어 (k_timer 기반)
+        ├── echo_adc/
+        │   └── echo_adc.c / .h             # ADC121S051 echo capture (SPIM3)
+        ├── imu/
+        │   └── imu_i2c.c / .h              # ICM42670P IMU (I2C0)
+        ├── led/
+        │   └── led_control.c / .h          # LED 패턴 제어 (k_timer 기반)
+        ├── piezo/
+        │   └── piezo.c / .h                # 피에조 전원, mux, SW burst
+        └── temperature/
+            └── tmp235.c / .h               # TMP235 온도 센서 (AIN3)
 ```
 
 ## 빌드 방법
 
 ### 일반 빌드
-소스 파일(.c/.h)만 변경한 경우.
+소스 파일(.c/.h)만 변경한 경우
 
 ### Pristine Build
 아래 파일을 변경한 경우 반드시 Pristine Build:
@@ -51,7 +62,7 @@ blinky/
 - `boards/*.overlay` (Devicetree 핀 매핑)
 - `CMakeLists.txt` (소스/include 경로 추가)
 
-nRF Connect for VS Code → Build 패널 → **Pristine Build** 또는 `build` 폴더 삭제 후 빌드.
+nRF Connect for VS Code → Build 패널 → **Pristine Build** 또는 `build` 폴더 삭제 후 빌드
 
 ## 핀 매핑 (Devicetree Overlay)
 
@@ -62,6 +73,21 @@ nRF Connect for VS Code → Build 패널 → **Pristine Build** 또는 `build`
 | `LED_BLE` | P0.12 | Output, Active LOW | 초록 LED |
 | `FUNCTION_LED` | P0.29 | Output, Active LOW | 주황 LED |
 | ADC AIN2 | P0.04 | Analog Input | 배터리 전압 분압 |
+| ADC AIN3 | P0.05 | Analog Input | TMP235 온도 센서 |
+| I2C0 SCL | P1.14 | I2C | ICM42670P SCL |
+| I2C0 SDA | P1.15 | I2C | ICM42670P SDA |
+| `PIEZO_PWR` | P1.09 | Output, Active HIGH | 피에조/TMP235 전원 enable |
+| `PIEZO_PE` | P0.25 | Output, Active HIGH | 피에조 pulse enable |
+| `PIEZO_P_OUT` | P1.07 | Output | 피에조 P 출력 |
+| `PIEZO_N_OUT` | P1.06 | Output | 피에조 N 출력 |
+| `PIEZO_DMP` | P1.00 | Output | 피에조 dump |
+| `MUX_EN_A` | P0.21 | Output | 피에조 mux enable A |
+| `MUX_EN_B` | P0.23 | Output | 피에조 mux enable B |
+| `MUX_SEL0` | P1.10 | Output | 피에조 mux select 0 |
+| `MUX_SEL1` | P0.28 | Output | 피에조 mux select 1 |
+| `ECHO_SCLK` | P0.14 | SPIM/GPIO | ADC121S051 SCLK |
+| `ECHO_MISO` | P0.15 | SPIM/GPIO | ADC121S051 MISO |
+| `ECHO_CS` | P0.19 | Output, Active LOW | ADC121S051 CS |
 
 > UART0은 P0.08 충돌 방지를 위해 비활성화 (`status = "disabled"`)
 
@@ -89,30 +115,62 @@ nRF Connect for VS Code → Build 패널 → **Pristine Build** 또는 `build`
 | 커맨드 | 응답 | 기능 |
 |--------|------|------|
 | `msn?` | `rsn:` + uint16 mV | 배터리 전압 측정 |
+| `mls?` | `rls:` + state | LED 상태 변경 |
+| `msp?` | `rsp:` + accel/gyro | IMU 단발 측정 |
+| `mst?` | `rso:` + int16 cdeg | TMP235 온도 측정 |
+| `mpa?` | `rpa:` + status | 피에조 전원 ON |
+| `mpb?` | `rpb:` + status | 피에조 전원 OFF |
+| `mpc?` | `rpc:` + cycles/status | 피에조 burst 테스트 |
+| `mec?` | `reb:` + `raa:` | 단일 채널 echo capture |
+| `maa?` | `reb:` x6 + `raa:` | 6채널 echo sweep |
+| `mbb?` | `rbb:` + `reb:` x6 + `raa:` | 배터리+IMU+온도+6채널 echo |
+| `mcf?` | `rcf:` | 측정 파라미터 읽기(현재 설정값 반환) |
+| `mcs?` | `rcs:` + status | 측정 파라미터 쓰기 + NVS 저장 |
+| `mfv?` | `rfv:` | FW version 읽기 |
+| `mrh?` | `rrh:` | HW version 읽기(RAM/default) |
+| `mwh?` | `rwh:` | HW version 쓰기(RAM only) |
+| `mrs?` | `rrs:` | Serial number 읽기(RAM/default) |
+| `mws?` | `rws:` | Serial number 쓰기(RAM only) |
+| `mqz?` | `rqz:` | Passkey 읽기(RAM/default) |
+| `mpz?` | `rpz:` | Passkey 쓰기(RAM only) |
 
-### 전체 커맨드 목록 (구현 예정)
+### 전체 커맨드 목록
 
 | # | 내용 | 명령 | 응답 | 비고 |
 |---|------|------|------|------|
-| 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 |
+| 1 | 전원 OFF | `msq?` | `rsq:` | 미구현 |
+| 2 | 재부팅 | `mss?` | `rss:` | 미구현 |
+| 3 | 본딩 삭제 + 재부팅 | `msr?` | `rsr:` | 미구현 |
+| 4 | LED 상태 | `mls?` | `rls:` | 구현 완료 |
+| 5 | HW Version 읽기 | `mrh?` | `rrh:` | 구현 완료, RAM/default |
+| 6 | HW Version 쓰기 | `mwh?` | `rwh:` | 구현 완료, RAM only |
+| 7 | Serial Number 읽기 | `mrs?` | `rrs:` | 구현 완료, RAM/default |
+| 8 | Serial Number 쓰기 | `mws?` | `rws:` | 구현 완료, RAM only |
+| 9 | FW Version 읽기 | `mfv?` | `rfv:` | 구현 완료 |
+| 10 | Passkey 읽기 | `mqz?` | `rqz:` | 구현 완료, RAM/default |
+| 11 | Passkey 쓰기 | `mpz?` | `rpz:` | 구현 완료, RAM only |
 | 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 |
+| 13 | IMU 단발 측정 | `msp?` | `rsp:` | 구현 완료 |
+| 14 | 온도 측정 | `mst?` | `rso:` | 구현 완료 |
+| 15 | 피에조 전원 ON | `mpa?` | `rpa:` | 구현 완료 |
+| 16 | 피에조 전원 OFF | `mpb?` | `rpb:` | 구현 완료 |
+| 17 | 피에조 burst 테스트 | `mpc?` | `rpc:` | 구현 완료, `freq_option`은 아직 미사용 |
+| 18 | 단일 채널 측정 | `mec?` | `reb:` → `raa:` | 구현 완료, 테스트용 |
+| 19 | 모든 채널(6) 측정 | `maa?` | `reb:`(6개) → `raa:` | 구현 완료 |
+| 20 | 전체 측정 | `mbb?` | `rbb:` → `reb:`(6개) → `raa:` | 구현 완료 |
+| 21 | 측정 파라미터 읽기 | `mcf?` | `rcf:` | 구현 완료, 현재 설정값 반환 |
+| 22 | 측정 파라미터 쓰기 | `mcs?` | `rcs:` | 구현 완료, NVS 저장 |
+
+## 남은 포팅 작업
+
+| 항목 | 현재 상태 | 다음 작업 |
+|------|-----------|-----------|
+| NVS/settings | piezo config 저장/복원 구현 완료 | HW/SN/Passkey 저장으로 확장 |
+| 측정 파라미터 | `piezo_config` 구조체 사용 | 실제 하드웨어에서 값별 파형 검증 |
+| `mcs?` | 구현 완료 | 앱/테스트툴에서 쓰기 후 재부팅 유지 확인 |
+| HW/SN/Passkey 저장 | RAM only | `mwh?`, `mws?`, `mpz?` 값을 NVS에 저장 |
+| BLE 보안 | `CONFIG_BT_SMP=n`, dev mode | bonding, fixed passkey, MITM/LESC 적용 |
+| BLE DFU | MCUboot/mcumgr 설정 있음 | SMP 광고/업로드/리셋 후 confirm 검증 |
 
 ## 디버그 로그 (RTT)
 
@@ -130,6 +188,11 @@ nRF Connect for VS Code → Build 패널 → **Pristine Build** 또는 `build`
 | `[NUS TX]` | NUS 송신 |
 | `[CMD]` | 커맨드 파서 처리 결과 |
 | `[BATT]` | 배터리 ADC 측정값 |
+| `[IMU]` | IMU 초기화/측정 |
+| `[ECHO]` | ADC121S051 echo capture |
+| `[PIEZO]` | 피에조 mux/burst/power |
+| `[MBB]` | 전체 측정 시퀀스 |
+| `[DFU]` | MCUboot 이미지 상태 |
 | `[SYS]` | 슬립 진입 |
 
 ## prj.conf 주요 설정
@@ -145,3 +208,11 @@ nRF Connect for VS Code → Build 패널 → **Pristine Build** 또는 `build`
 | `CONFIG_BT_L2CAP_TX_MTU` | 247 | MTU 크기 |
 | `CONFIG_BT_CTLR_TX_PWR_PLUS_8` | y | TX power +8dBm |
 | `CONFIG_ADC` | y | ADC 드라이버 (배터리, 온도) |
+| `CONFIG_I2C` | y | IMU I2C 드라이버 |
+| `CONFIG_NRFX_SPIM` | y | ADC121S051용 nrfx SPIM |
+| `CONFIG_BOOTLOADER_MCUBOOT` | y | MCUboot 사용 |
+| `CONFIG_MCUMGR_TRANSPORT_BT` | y | BLE mcumgr transport |
+| `CONFIG_NVS` | y | NVS 플래시 저장소 |
+| `CONFIG_SETTINGS` | y | Zephyr settings subsystem |
+| `CONFIG_SETTINGS_NVS` | y | settings NVS backend |
+| `CONFIG_BT_SMP` | n | BLE 보안 비활성화(개발 모드) |