[patternflow-bot]

dev / https://claude.ai/code/session_01NitpYZAot3zeUJsjGVUSyf

패널 드라이버에 원래 라이브러리의 고침 하나(7bf3b6c)를 들였어요. 3.0.13 은 패널 설정의 줄 디코더 값을 비워 둬서 스택에 남은 값이 들어갔는데, 이제 늘 기본값(TYPE138)이에요. 목록 첫 커밋 c09362a 가 이 값을 읽어 줄 주소를 정해서 이것부터 받았고, 패치 파일은 바이트까지 그대로예요.

좋아지는 것: 없음

체크리스트

• 계획표 PR 12 줄 — 고칠 파일: 그 커밋이 고치는 원래 파일 · UPSTREAM.md · patternflow.patch
• PR 11([DONE] 정리 3단계 PR 11 — 패널 드라이버가 원래 라이브러리와 다른 줄이 패치 한 장에 다 적힌다 #47)의 목록 아홉 개를 원래 레포에서 다시 확인, 받을 순서 정하기(아래 「가정」)
• 7bf3b6c 를 src/hub75/ESP32-HUB75-MatrixPanel-I2S-DMA.h 에 그대로 붙이기(git apply, 한 줄)
• UPSTREAM.md — 받은 커밋 한 줄, 다시 만드는 명령에 cherry-pick -n 한 줄
• 패치 다시 만들기 — 바이트까지 같아요(sha256 그대로)
• check_blit.py · check_oe.py · check_boundaries.py · check_presets.py · console_pages.py check · check_versions.py · check_sources.py
• firmware-build.yml 다섯 조합 초록, 크기 비교
• check:drift · check:human-lock · check:voice · doc-map · typecheck · lint · check:ci
• dev(d910ecc)가 이미 브랜치에 들어 있다 — merge 할 것 없음
• 창작자 몫: 기준 패널에 구워 보고 이 PR 에 한 줄(계획서 k12 · §2.5)

한 일

• firmware/patternflow/src/hub75/ESP32-HUB75-MatrixPanel-I2S-DMA.h: 원래 레포 7bf3b6c(Christopher King, 2026-04-03, "Fix: Properly set line_decoder in HUB75_I2S_CFG struct constructor")를 그대로 붙였어요. 생성자 초기화 목록에 line_decoder(_line_drv) 하나가 들어가요. 필드 선언 순서(driver, line_decoder, double_buff)와 맞아서 -Wreorder 가 안 나요.
• firmware/patternflow/src/hub75/UPSTREAM.md: 「Taken from upstream since」의 「None yet」 자리에 이 커밋 한 줄과 먼저 받은 까닭. 「Rebuilding the patch」 명령에 git -C "$U/upstream" cherry-pick -n 7bf3b6c… 한 줄. 맨 위 두 문단과 확인 명령 앞 문장은 「태그」를 「태그와 받은 커밋」으로 고쳤어요.
• firmware/patternflow/src/hub75/patternflow.patch: 다시 만들었고 바뀐 바이트가 없어요. 고친 줄이 15 hunk 어디에도 안 걸리고 한 줄을 한 줄로 바꿔서 줄 번호도 그대로예요.

왜 c09362a 보다 먼저

3.0.13 의 HUB75_I2S_CFG 생성자는 _line_drv 를 받기만 하고 line_decoder 에 넣지 않아요. core_display.h:20 의 initDisplay() 는 mxconfig 를 스택에 만들어서, 그 필드는 그 자리에 남아 있던 값이에요. 지금 드라이버는 그 값을 SM5266P · SM5368 과만 견줘요(.cpp 173 · 1129–1194줄). 패널이 잘 나오니 그 둘은 아니었다는 것만 알 수 있어요.

목록 첫 커밋 c09362a 는 clearFrameBuffer() 에서 line_decoder == TYPE_DIRECT(2) 이면 줄 주소를 1 << row 로 바꿔요. 순서대로 받으면 그 PR 부터 7bf3b6c PR 이 머지될 때까지 모든 줄 주소가 스택에 남은 값에 달려요. 그 값은 조합마다, 앞서 부른 함수마다 다를 수 있어서 한 대에 구워 보는 것으로는 다섯 조합을 다 확인하지 못해요. 이것부터 받으면 그 값이 늘 TYPE138(0)이고 c09362a 의 새 줄은 이 패널에서 아무것도 안 해요.

바뀐 순서로 남은 여덟 개도 다 붙는지 해 봤어요. 7bf3b6c 다음 c09362a 538cb41 3ab92ad b40a838 203502b a15a887 6a49f09 c005c7b 순서로 「3.0.13 + 앞의 것」과 「이 폴더 + 앞의 것」 양쪽에 git apply 로 문맥 그대로 붙고, 끝에서 다시 만든 패치가 fuzz 0 으로 붙어 같은 트리가 돼요(15 hunk). 계획서 순서로도 똑같이 돼요. 다음 PR 12 는 c09362a 예요.

증거

UPSTREAM.md 의 두 명령을 글자 그대로(GitHub 에서 새로 clone) 저장소 맨 위에서 돌린 결과:

Auto-merging src/ESP32-HUB75-MatrixPanel-I2S-DMA.h
patching file ESP32-HUB75-MatrixPanel-I2S-DMA.cpp
patching file ESP32-HUB75-MatrixPanel-I2S-DMA.h
diff -r exit 0
rebuild: identical to the committed patch
3b251e58a429f23385e977bc1d9475bde2b995559b2a09825812cfedb3201038  firmware/patternflow/src/hub75/patternflow.patch

sha256 이 PR 11 이 적은 값과 같아요. cherry-pick -n 줄을 빼고 다시 만들면 패치에 원래 레포의 그 줄이 16번째 hunk(.h @@ -347,7 +347,7 @@)로 들어가요. 그래서 그 줄이 있어야 패치가 우리 변경만 담아요. cherry-pick -n 은 git 사용자 설정 없이도(HOME 을 빈 폴더로) 돌아요.

펌웨어 검사:

check_boundaries.py: boundary holds: 73 core files know none of 42 feature namespaces across 9 features
check_presets.py:    presets in step: 34 twins, 14 web-only on purpose, 1 firmware-only on purpose
console_pages.py check: all 12 console headers match their HTML
check_blit.py:       blit exact: 82779840 DMA words, FIFO swap=0 / blit exact: 70709760 DMA words, FIFO swap=1
check_oe.py:         OE windows binary and response monotone; 13093 assertions, full scale 993
check_versions.py:   versions agree: core v3.11.0, audio v0.7.0, performance v0.4.0
check_sources.py:    all checks passed

CI firmware-build.yml(8465f80) 다섯 조합 초록, 크기를 PR 11 이 적은 dev 값과 견줬어요:

composition   .bin bytes          RAM used  Flash used          static DRAM  IRAM    window left
audio         1208688 (+16)       105648    1208317 (+4)        161,216      71,951  330,304
clock         1187088 (+0)        86888     1186721 (+4)        141,976      71,471  349,544
default       1102688 (+16)       86600     1102317 (+4)        141,688      71,471  349,832
midi          1163488 (+16)       100000    1163117 (+4)        154,288      70,671  337,232
performance   1526640 (+16)       103108    1526269 (+4)        158,200      71,471  333,320

플래시 4바이트는 생성자에서 필드 하나를 쓰는 명령 하나예요. .bin 은 16바이트 단위로 채워서 +16 이거나 그대로예요. RAM · DRAM · IRAM 은 그대로예요. build.sh 판정은 다섯 다 ok, check_footprint.py 는 「every edition within tolerance」. 로그에 Wreorder 도, hub75 를 가리키는 warning: 도 없어요(midi 의 경고 141줄은 모두 NimBLE 의 CONFIG_BT_NIMBLE_NVS_PERSIST 재정의예요). PR 의 체크 여덟 개 모두 초록이에요.

사이트(web/, npm ci 뒤):

npm run typecheck        → 출력 없음
npm run lint             → 경고 0
npm run check:ci         → exit 0 (check:panels: Test Files 35 passed, Tests 478 passed · check:sandbox-sync · check:modcache · check:drift 통과)
npm run check:voice      → base d910ecc, 19 added lines in 2 files, nothing found
npm run check:human-lock → this diff touches 0 locked files

doc-map(git fetch --tags 뒤 — dev d910ecc 에서 돌려도 같은 두 줄이에요. 두 CSV 는 다시 checkout 했어요):

1074 links from 215 files → docs/investigations/2026-10-doc-map.csv
1366 Korean/English pairs → docs/investigations/2026-10-doc-parity.csv

2026-10-doc-map.csv 는 dev 에서도 두 줄(2026-10-panel-geometry.md 의 링크)이 늘어요. 이 PR 과 상관없고 k27 몫이에요.

실행법

저장소 맨 위에서 firmware/patternflow/src/hub75/UPSTREAM.md 「Rebuilding the patch」의 두 명령을 그대로 돌려요. 첫째 뒤 git diff 가 비고, 둘째의 diff -r 이 아무것도 안 찍으면 돼요. GNU diff 가 필요해요.

가정

• 순서: 계획서 k12 는 「목록의 순서대로」라고 해요. 목록 여섯째 7bf3b6c 를 첫째로 당겼어요. 까닭은 위 「왜 c09362a 보다 먼저」예요. 나머지 여덟은 목록 순서 그대로이고, 다음 PR 12 들이 UPSTREAM.md 「Taken from upstream since」를 보고 안 받은 것 중 맨 앞을 받으면 돼요. 그래서 그 절의 「oldest first」를 「받은 순서」로 고쳤어요.
• 한 PR 에 한 커밋: 작업 글의 「PR 12 하나만」과 표의 「one PR per commit」을 함께 읽어 커밋 하나만 받았어요.
• 다시 만드는 명령: PR 11 이 남긴 문장대로 cherry-pick -n 이에요. 커밋마다 줄을 따로 두지 않고, 다음 커밋은 같은 줄 끝에 해시를 이어 붙이게 적었어요(cherry-pick -n A B 는 차례로 붙여요).
• build.sh all: 이 컨테이너에서 PlatformIO 는 깔리지만 espressif32 플랫폼을 못 받아요(Platform Manager: Installing espressif32 @ 7.0.1 → HTTPClientError). CI firmware-build.yml 다섯 조합으로 갈음했어요.
• 구워 보기: 계획서가 창작자 몫으로 둔 기준 패널 확인은 제가 할 수 없어서 체크리스트에 열어 뒀어요.
• check:drift 의 roadmap 은 이 세션의 gh 가 engmung/Patternflow 를 못 읽어 건너뛰었어요. CI 는 자기 토큰으로 읽어요.
• CHANGELOG.md 는 고치지 않았어요. 넣을 줄은 아래에 있어요.

찾았지만 이 PR 의 파일 밖이라 고치지 않은 것:

• VENDORED.md 는 3.0.13 기준 이야기를 그대로 해요. 이 커밋은 우리 변경이 아니라서 거기 적을 것이 없어요.

Changelog

Firmware

• The vendored HUB75 driver takes upstream's fix for its config constructor. HUB75_I2S_CFG now sets line_decoder from its argument (upstream 7bf3b6c), so the field is TYPE138 instead of whatever was on the stack where initDisplay() builds the config. src/hub75/UPSTREAM.md lists the commit and its rebuild cherry-picks it, so patternflow.patch still holds only Patternflow's changes and comes out byte for byte the same.

Upstream

• What: take upstream 7bf3b6c into src/hub75/, so the HUB75_I2S_CFG constructor sets line_decoder; UPSTREAM.md lists it ahead of older commits and its rebuild cherry-picks it; patternflow.patch rebuilds byte for byte unchanged.
• Checks: check_blit.py, check_oe.py, check_boundaries.py, npm run check:ci and check:drift pass; the patch on 3.0.13 with 7bf3b6c picked gives an empty diff -r; build.sh all is green in firmware-build.yml.
• Docs map: none

🤖 Generated with Claude Code

https://claude.ai/code/session_01NitpYZAot3zeUJsjGVUSyf