Review must-fix: LICENSE, dangling ref, obsolete markers

- LICENSE (MIT, own work) + README license section
- FINDINGS.md per-version notes point into docs/firmware/
- checksum brute-forcers marked superseded (code + tool docs)
This commit is contained in:
Dejvino
2026-09-30 22:52:21 +02:00
parent 8913cb4314
commit 1eb6ba6b9f
6 changed files with 37 additions and 5 deletions
+1 -1
View File
@@ -1,7 +1,7 @@
# Lofi-12 XT — Findings Library
Living knowledge base for this device. Process/tips live in `RE-PROCESS.md`.
Per-version firmware notes: `Lofi-12XT_v*/…/reversed.md`; version diff: `rev-diff.md`;
Per-version structural notes: `docs/firmware/notes-v{1.1.156,1.2.179,1.5.205}.md`; version diff: `rev-diff.md`;
mod feasibility: `tweakability-report.md`; tool docs: `tools/README.md`.
Deep dives: `docs/hardware.md`, `docs/bootloader.md`, `docs/firmware-update.md`,
`docs/firmware/v1.5.205.md`.
+21
View File
@@ -0,0 +1,21 @@
MIT License
Copyright (c) 2026 Dejvino
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
+5
View File
@@ -60,3 +60,8 @@ watch `SYSTEM UPDATE` on the OLED. Keep a stock SD for revert.
- **No vendor binaries or flash dumps are shipped in this repo** (Sonicware IP).
Bring your own `.bin` from an official update ZIP; distribute mods as scripts,
never as full images.
## License
MIT — see `LICENSE`. Covers the code, docs, and photos in this repo (own work
only); no vendor binaries are shipped.
+2 -2
View File
@@ -9,8 +9,8 @@ Stdlib-only Python (`tools/`). Verified against v1.1.156 / v1.2.179 / v1.5.205.
| `lofi_pack.py` | `indir/ out.bin [--checksum HEX]` — rebuild exact-fit image |
| `lofi_patch_string.py` | Same-length UI string swap (Level-0 mod, addresses stable) |
| `lofi_xref.py` | Count code/self pointers, list slack zero-gaps, locate string + refs |
| `lofi_checksum.py` | Quick check: CRC/adler/fletcher/sum/xor over obvious spans |
| `lofi_checksum_crack.py` | Long-running cracker: Phase A fast hashes + xor-mask detect, Phase B generic CRC param search (1,008 combos, multiprocessed), Phase C seeded CRC32-IEEE brute force 0..2²⁴ (hours) |
| `lofi_checksum.py` | Quick check: CRC/adler/fletcher/sum/xor over obvious spans (historical) |
| `lofi_checksum_crack.py` | Long-running cracker (**superseded** — checksum solved; kept for methodology) |
## Safe first loop (do not flash until checksum is cracked)
+4 -1
View File
@@ -1,5 +1,8 @@
#!/usr/bin/env python3
"""Long-running checksum cracker for Lofi-12 XT cmtd+0x08.
"""SUPERSEDED 2026-09-30: checksum solved (see lofi_image.compute_checksum).
Kept for methodology only — do not run expecting new results.
Long-running checksum cracker for Lofi-12 XT cmtd+0x08.
Strategy: 3 known (image, checksum) pairs let us test each hypothesis fast
with early exit, plus detect CONSTANT-XOR-masked CRCs (stored = crc ^ mask).
+4 -1
View File
@@ -1,5 +1,8 @@
#!/usr/bin/env python3
"""Phase D checksum cracker: 16-bit/ones-complement/chained/DJB2/Murmur batch.
"""SUPERSEDED 2026-09-30: checksum solved (see lofi_image.compute_checksum).
Kept for methodology only — do not run expecting new results.
Phase D checksum cracker: 16-bit/ones-complement/chained/DJB2/Murmur batch.
Covers what Phases A-C did not: every candidate must match ALL 3 builds.
Stdlib only, read-only on stock .bin files.