[DONE] 정리 3단계 PR 8 — 펌웨어가 사이트와 같이 쓰는 값을 한 파일에서 읽는다

[patternflow-bot]

lsh / https://claude.ai/code/session_019raaKug4zzwsoT9eFKgJ78

정리 3단계 계획서 표의 PR 8 이다. 펌웨어가 손으로 따로 적던 패널 크기, 디텐트, 버튼 타이밍, 버스 눈금을 PR 7 이 만든 core_shared.h 에서 읽게 바꿨다. 값은 하나도 바뀌지 않아 다섯 펌웨어가 바이트 수까지 같게 빌드되고, 머지하면 shared/constants.json 한 곳을 고칠 때 펌웨어도 따라온다.

좋아지는 것: 없음

할 일

• 계획서 표의 PR 8 행(k8)과 D5·발견 9·10, docs/rfc-cleanup.md §2.1·§2.5·§2.11, docs/voice.md 를 읽는다
• 커밋 1 (926bde0): 바꿀 숫자마다 옆에 static_assert 로 core_shared.h 의 값과 같은지 묻는다. CI 가 다섯 composition 을 빌드해 모두 success
• 커밋 2 (b5556da): 숫자를 매크로로 바꾸고 assert 를 뺀다. CI 다섯 composition 의 bin·flash·RAM·DRAM·IRAM 이 커밋 1 과 하나도 다르지 않다
• 세 geometry 모두 config.h·net_config.h 값이 바뀌지 않았는지 호스트에서 컴파일해 본다
• typecheck, lint, check:ci, 펌웨어 호스트 검사 17개, 잠금, 글투, doc-map 을 돌린다(CSV 는 되돌린다)
• dev 를 merge 한다(8c006a9 를 44ef69d 로. 겹치는 파일은 없다)

한 일

• config.h: PANEL_GEOM_* 셋이 PF_SHARED_PANEL_GEOM_* 를, 세 갈래의 PANEL_PHYS_W·PANEL_PHYS_H·PANEL_CHAIN·PANEL_RES_W·PANEL_RES_H 가 각 geometry 의 크기 매크로를 가리킨다. PANEL_GEOMETRY 의 기본은 PF_SHARED_PANEL_GEOM_DEFAULT 다. #ifndef PANEL_GEOMETRY 와 -DPANEL_GEOMETRY=PANEL_GEOM_64x64_CHAIN2 는 그대로 된다. PANEL_RES_W·PANEL_RES_H 를 쓰는 곳은 하나도 건드리지 않았다(5단계가 센다).
• net_config.h: PF_LANE_MOTION_SCALE 기본이 48.0f 대신 (float)(PF_SHARED_DETENTS_PER_TURN * PF_SHARED_TURNS_PER_FULL_RANGE) 다. #ifndef 와 옛 이름 PF_AUDIO_VIRTUAL_KNOB_SCALE 는 그대로다.
• src/core_encoders.h: knobSubSteps 초기값과 clampSubSteps 의 기본이 PF_SHARED_EDGES_PER_DETENT, 버튼 디바운스가 PF_SHARED_BUTTON_DEBOUNCE_MS, longPressed() 기본 문턱이 PF_SHARED_LONG_PRESS_MS 다.
• src/core_bus.h: PF_BUS_MAX 가 PF_SHARED_BUS_MAX, 클릭 환산의 / 10·* 10 이 PF_SHARED_BUS_UNITS_PER_CLICK 다.
• patternflow.ino: MODE_HOLD_MS 가 PF_SHARED_LONG_PRESS_MS 다.
• firmware/toolchain/check_midi.py: 호스트 빌드에 복사하는 파일에 src/core_shared.h 한 줄을 더했다(가정 첫 줄).

증거

GitHub, 이 PR. 「Firmware builds」 run 38695323066(커밋 1, 926bde0)과 run 38695723382(커밋 2, b5556da)의 다섯 job 이 모두 success 고, build.sh 가 찍은 크기와 check_footprint.py 가 같다:

composition  bin bytes  flash used  RAM used  static DRAM  IRAM    window left   커밋 1 = 커밋 2
default      1102688    1102317     86600     141,688      71,471  349,832       같다
audio        1208688    1208317     105648    161,216      71,951  330,304       같다
performance  1526640    1526269     103108    158,200      71,471  333,320       같다
clock        1187088    1186721     86888     141,976      71,471  349,544       같다
midi         1163488    1163117     100000    154,288      70,671  337,232       같다

열 job 모두 every edition within tolerance, 스캔 줄은 <이름> <bytes> bytes ok 다. 「Core knows no features」·「Drift checks」도 두 커밋 모두 success.

로컬. CI 는 기본 geometry 만 빌드하니, config.h·net_config.h 를 빈 Arduino.h 로 호스트에서 컴파일해 세 geometry 의 값을 찍었다. 기준(adbe923)과 커밋 1·2 의 출력이 diff 로 같다:

[default]                  PANEL_GEOMETRY=1 PHYS_W=128 PHYS_H=64 CHAIN=1 RES_W=128 RES_H=64
[PANEL_GEOM_64x64_SINGLE]  PANEL_GEOMETRY=2 PHYS_W=64 PHYS_H=64 CHAIN=1 RES_W=64 RES_H=64
[PANEL_GEOM_64x64_CHAIN2]  PANEL_GEOMETRY=3 PHYS_W=64 PHYS_H=64 CHAIN=2 RES_W=128 RES_H=64
(-DPANEL_GEOMETRY=1, 2, 3 도 같다. 모두 PANEL_GEOM_* = 1 2 3)
PF_LANE_MOTION_SCALE=0x1.8p+5 (float)        # 48.0f, 다섯 줄 모두
probe: commit 2 values same as base, all geometries

$ python3 firmware/toolchain/check_<이름>.py [--sanitize]     # firmware-checks.yml 의 17개. 커밋 1 은 로컬 17개, 커밋 2 는 로컬 8개와 CI 「Core knows no features」 17개, 모두 exit 0
check_boundaries: boundary holds: 74 core files know none of 42 feature namespaces across 9 features
check_midi:       PASS: 200000 ordered cross-thread events, bounded overflow, absolute/relative/note no-echo, physical output
check_sources:    all checks passed
check_versions:   versions agree: core v3.11.0, audio v0.7.0, performance v0.4.0 ...
(abi_freeze, module_elf, blit, oe, math, libm, thumbs, network, runtime, crash, send, parser, presets 도 통과)

# check_midi.py 를 고치기 전 판으로 돌리면
src/core_bus.h:26:10: fatal error: core_shared.h: No such file or directory

$ cd web && npm ci
$ npm run typecheck                           # 출력 없음, exit 0
$ npm run lint                                # 출력 없음, exit 0
$ npm run check:ci                            # exit 0
 Test Files  35 passed (35)                   # check:panels
      Tests  478 passed (478)
pattern-sandbox.html is up to date            # check:sandbox-sync
passed   shared                               # check:drift, 그 밖에 bom·bom-schematic·changelog·editions·features·links-absolute·markers·presets passed, roadmap skipped(gh 로그인 없음)

# 모듈 캐시 키(builderRev.ts)가 해시하는 abi/*.h, core_color·core_math·core_noise·core_module_loader.h, module.ld, build_module.py, port_preset.py
$ git diff --name-only adbe923 HEAD -- <그 파일들> | wc -l
0                                             # 그중 core_shared.h 를 include 하는 파일도 0

$ npm run check:human-lock
this diff touches 0 locked files
check:human-lock: no locked words changed
$ npm run check:voice
read: 46 added lines in 6 files
check:voice: nothing found

$ git fetch --tags && npm run doc-map
1074 links from 215 files → docs/investigations/2026-10-doc-map.csv
0 do not resolve
1366 Korean/English pairs → docs/investigations/2026-10-doc-parity.csv
7 en-short, 18 ko-short, 1 missing-ko, 1340 ok

doc-map 이 커밋된 CSV 와 다르게 쓴 줄은 둘이고 둘 다 dev 에 이미 있는 docs/investigations/2026-10-panel-geometry.md 에서 나가는 링크다. 이 PR 의 줄은 없다. 두 CSV 는 git checkout 으로 되돌렸다. dev merge 뒤 check:drift·check:human-lock·check:voice·check_boundaries.py 를 다시 돌려 같은 결과다.

실행법

git log --oneline -3 -- firmware/patternflow/config.h   # 926bde0 이 assert, b5556da 가 바꿔 넣기
git show 926bde0 | grep static_assert                  # 바꾼 숫자마다 하나씩
cd web && npm run gen:shared   # shared/constants.json 의 값을 바꾸면 core_shared.h 가 바뀌고, 펌웨어가 그 값으로 빌드된다

가정

• 표가 PR 8 에 적은 파일 다섯 밖에서 firmware/toolchain/check_midi.py 한 줄을 고쳤다. 이 검사는 src/core_bus.h 를 임시 폴더에 복사해 호스트에서 빌드하는데, core_bus.h 가 core_shared.h 를 include 하면 그 파일도 옆에 있어야 한다. 고치지 않으면 firmware-checks.yml 이 빨개진다(위 증거). 다른 열린 정리 PR 의 표 행에 이 파일은 없다.
• core_bus.h·core_encoders.h 는 "core_shared.h" 를, config.h·net_config.h 는 "src/core_shared.h" 를 직접 include 한다. 스케치는 이미 "src/..." 꼴로 include 하고(pattern_registry.h), check_midi 처럼 core_encoders.h 를 빈 파일로 바꾸는 호스트 빌드에서도 core_bus.h 가 혼자 선다. patternflow.ino 는 config.h 를 거쳐 받는다.
• 계획서는 config.h 가 「PANEL_GEOM_* 와 크기」를 받는다고 했다. 기본값 PANEL_GEOM_DEFAULT 도 그 안으로 보고 PANEL_GEOMETRY 기본을 PF_SHARED_PANEL_GEOM_DEFAULT 로 했다. 값은 1 그대로다.
• clampSubSteps 의 v == 1 || v == 2 || v == 4 는 엔코더 부품이 낼 수 있는 클릭 크기 목록이라 숫자로 두고, 그 밖의 값이 돌아갈 기본만 PF_SHARED_EDGES_PER_DETENT 로 했다. encPos 의 「4 per detent」 같은 주석도 여전히 맞아 그대로 뒀다.
• CI 는 기본 geometry 만 빌드해서 다른 두 갈래 안의 static_assert 는 CI 에서 컴파일되지 않는다. 그 두 갈래는 위 호스트 컴파일로 값을 맞댔다.
• build.sh all 은 컨테이너가 PlatformIO 에 닿지 못해(기준선) 이 PR 의 firmware-build.yml 다섯 job 에 맡겼다. 이미지에 __DATE__·__TIME__ 이 들어가 바이트 비교는 안 되고, D5 대로 크기를 맞댔다.
• 바꾼 줄 76(+46 −30)으로 300줄 안. CHANGELOG.md, docs/rfc-cleanup-progress.md, doc-map CSV 는 안 고쳤다. 라벨 cleanup·step-3 은 포크에 없어 달지 않았다. 기준 브랜치는 dev(머리말).
• Changelog 절은 ### Firmware 하나로 했다. 바뀐 것이 모두 펌웨어고, 사이트 쪽은 PR 9 몫이다.

Changelog

Firmware

• The firmware reads the values it shares with the site from src/core_shared.h. config.h takes the panel geometries and their sizes from it, net_config.h writes the lane scale as 24 detents times two turns, and the encoders, the bus and the sketch take the debounce, the long press and the bus scale. All come from shared/constants.json. No value changed, and all five images build to the same size.

Upstream

• What: config.h, net_config.h, core_encoders.h, core_bus.h and patternflow.ino take the panel geometries, the lane scale, the button timings and the bus scale from src/core_shared.h, and check_midi.py copies that header for its host build. No value changes.
• Checks: build.sh all in CI on an assert commit and on the swap, every image the same size; npm run typecheck, npm run lint and npm run check:ci (with check:panels, check:sandbox-sync, check:modcache) and the firmware host checks pass.
• Docs map: none

🤖 Generated with Claude Code

https://claude.ai/code/session_019raaKug4zzwsoT9eFKgJ78

---

Generated by Claude Code