[DONE] 정리 3단계 PR 11 — 패널 드라이버가 원래 라이브러리와 다른 줄이 패치 한 장에 다 적힌다

firmware/patternflow/src/core_canvas.h

@@ -25,9 +25,9 @@
 
 #include <Arduino.h>
 #include "core_loop_sync.h"   // onLoopTask(): present() belongs to the frame
-// Vendored HUB75 driver (src/hub75/), not the Library Manager copy: it
-// carries one addition, blitRGB888(), that upstream has no equivalent for.
-// See src/hub75/VENDORED.md.
+// Vendored HUB75 driver (src/hub75/), not the Library Manager copy. Every
+// change from upstream is in src/hub75/patternflow.patch, and
+// src/hub75/VENDORED.md says why.
 #include "hub75/ESP32-HUB75-MatrixPanel-I2S-DMA.h"
 #include "config.h"
 

firmware/patternflow/src/core_display.h

@@ -1,7 +1,7 @@
 #pragma once
-// Vendored HUB75 driver (src/hub75/), not the Library Manager copy: it
-// carries one addition, blitRGB888(), that upstream has no equivalent for.
-// See src/hub75/VENDORED.md.
+// Vendored HUB75 driver (src/hub75/), not the Library Manager copy. Every
+// change from upstream is in src/hub75/patternflow.patch, and
+// src/hub75/VENDORED.md says why.
 #include "hub75/ESP32-HUB75-MatrixPanel-I2S-DMA.h"
 #include "config.h"
 

firmware/patternflow/src/hub75/UPSTREAM.md

@@ -0,0 +1,70 @@
+# Upstream
+
+This folder is [ESP32-HUB75-MatrixPanel-DMA](https://github.com/mrcodetastic/ESP32-HUB75-MatrixPanel-DMA)
+at tag `3.0.13`, commit `a6221865c71fd5aeba885c31b81fe41bd36c5705` (25 October
+2025). It was copied in on 31 July 2026, in `42bfc10`. Upstream's `master` was
+already past the tag that day, but the copy is the tag: every upstream file here
+that [patternflow.patch](patternflow.patch) does not name is byte for byte the
+one at `a622186`.
+
+The patch is every change since. It is `diff -ruN` of upstream's `src/` against
+this folder, over the files both carry, and [VENDORED.md](VENDORED.md) says why
+each change is there.
+
+## What was not copied
+
+Only upstream's `src/` is here, and without its three images:
+
+- `platforms/esp32/RGB_HUB75_PINS.png`
+- `platforms/esp32s3/ESP32-S3-DevKitC-1-pin-layout.png`
+- `platforms/esp32s3/ReservedPinsForPSRAM.PNG`
+
+Everything at upstream's root stayed behind: `examples/`, `doc/`, `testing/`,
+`LICENSE.txt` and the build manifests. One manifest came along under another
+name. `library.properties` is `UPSTREAM_library.properties` here, kept for its
+version line.
+
+## Upstream's TODO
+
+`setupDMA()` in `ESP32-HUB75-MatrixPanel-I2S-DMA.cpp` has
+`// TODO: should we release all previous rowBitStructs here???`. It is
+upstream's, and it stays as it is. Editing it would add a hunk to the patch.
+
+## Rebuilding the patch
+
+From the repository root, with GNU diff:
+
+```sh
+U=$(mktemp -d)
+git clone -q https://github.com/mrcodetastic/ESP32-HUB75-MatrixPanel-DMA "$U/upstream"
+git -C "$U/upstream" checkout -q a6221865c71fd5aeba885c31b81fe41bd36c5705
+ln -s "$U/upstream/src" "$U/a"
+ln -s "$PWD/firmware/patternflow/src/hub75" "$U/b"
+(cd "$U" && diff -ruN -x VENDORED.md -x UPSTREAM.md -x UPSTREAM_library.properties \
+    -x patternflow.patch -x '*.png' -x '*.PNG' a b) |
+  sed -E -e '/^diff /d' -e 's/^(---|\+\+\+) ([ab]\/[^[:space:]]+).*/\1 \2/' \
+  > firmware/patternflow/src/hub75/patternflow.patch
+```
+
+The `sed` drops the timestamps and the command lines diff prints, so the same
+tree always gives the same file. Rebuild the patch instead of editing it.
+Upstream ends some lines in spaces, the patch carries them as context, and an
+editor that trims trailing whitespace (`.editorconfig` asks for that) breaks
+those hunks.
+
+To check it, apply it to a clean copy of the tag. The last `diff -r` prints
+nothing:
+
+```sh
+cp -R "$U/upstream/src" "$U/check"
+patch -p1 --fuzz=0 -d "$U/check" < firmware/patternflow/src/hub75/patternflow.patch
+diff -r -x VENDORED.md -x UPSTREAM.md -x UPSTREAM_library.properties \
+    -x patternflow.patch -x '*.png' -x '*.PNG' "$U/check" firmware/patternflow/src/hub75
+```
+
+## Taken from upstream since
+
+None yet. A commit taken from upstream gets a line here, oldest first, with its
+hash and title. The rebuild above then picks it after the checkout
+(`git -C "$U/upstream" cherry-pick -n <hash>`), so the patch stays Patternflow's
+changes and nothing upstream wrote.

firmware/patternflow/src/hub75/VENDORED.md

@@ -354,12 +354,13 @@ which is what makes comparing tens of millions of DMA words worth doing.
 
 ## What this costs
 
-- Upstream updates are manual. Diff a new release against this tree and re-apply
-  the additions.
-- The additions are marked `PATTERNFLOW ADDITION (not upstream)`, and the two
-  in-place changes above are marked `PATTERNFLOW FIX` —
-  `blitRGB888()` in `ESP32-HUB75-MatrixPanel-I2S-DMA.h` and `.cpp`,
-  `resumeDMAoutput()` in the `.h` only. Nothing else is modified.
+- Upstream updates are manual. [UPSTREAM.md](UPSTREAM.md) names the commit this
+  copy was taken from and the command that rebuilds the patch.
+- [patternflow.patch](patternflow.patch) is every change from upstream. A
+  `PATTERNFLOW ADDITION (not upstream)` or `PATTERNFLOW FIX` marker heads the
+  larger changes in the source, but not every change has one: the two fields
+  behind `lastFrameOnTime()`, which `../core_power.h` reads, carry neither. The
+  patch is the list.
 - The build server compiles the sketch folder, so it picks this up with no
   separate configuration.
 - If the Library Manager copy is still installed it is simply unused: the sketch