chore: reorganize analysis/ by SDK lineage (linux/win/android) with README index, move legacy notes to history/, refresh root README, ignore .zcode/

This commit is contained in:
ZXCLI
2026-09-10 03:09:13 +08:00
parent 4ba98f62cd
commit e69a97436b
137 changed files with 123 additions and 62 deletions
+4 -4
View File
@@ -102,9 +102,9 @@ res/drawable/*.xml 自绘矢量图标(双弧圆等可靠几何图形
- 验证方式:`android/app/src/test/.../RenderPipelineTest.kt`JVM 差分测试,参照 `analysis/render_offline.c` 的 C 输出,60帧序列与官方DDT)。
### 4.2 USB 协议(权威版:analysis/magcx_official_flow.md
- **2026-09-10 已反编译官方普通版全量源码**(jadx:`analysis/jadx_magcx/`
- **2026-09-10 已反编译官方普通版全量源码**(jadx:`analysis/sdk_re/android_app/jadx_magcx/`
UsbCommunication.java 是 USB 层真身;Ghidralibcxsdk 全量伪代码
`analysis/ida/export/ghidra_dump/libcxsdk_decomp.txt`1290 函数)。
`analysis/sdk_re/android_app/libcxsdk_decomp.txt`1290 函数)。
- 协议要点:命令 4 字节**小端**;超时全线 800ms;序列
GetParameter1(66b)→GetParameter2(66c)→GetCaliInfo(66f)→[缓存缺失]
GetCaliFile(670)+EP 0x84 拉 16KB 块→StartTransferImg(673)FFC=672(帧驱动)。
@@ -173,8 +173,8 @@ git -C C:\Project\MAG160C commit -m "android: ..."
4. **写代码要谨慎**:本会话多次因急于成稿写出语法错误/残留死代码。每写一个文件后立即编译。
5. **ByteBuffer.putInt 默认大端**USB 命令必须小端(官方 intToByteArray)。
16 轮黑屏调试的根因就是它(66b 回文数掩盖了字节反转),MagProtocolTest 已锁死。
6. **官方 App 源码已入库,先读它再写协议代码**analysis/jadx_magcx/Java)、
analysis/ida/export/ghidra_dump/libcxsdk_decomp.txtnative)、
6. **官方 App 源码已入库,先读它再写协议代码**:analysis/sdk_re/android_app/jadx_magcx/Java)、
analysis/sdk_re/android_app/libcxsdk_decomp.txtnative)、
analysis/magcx_official_flow.md(权威结论)。不要凭旧文档猜协议。
## 7. 当前状态与待办
+2 -2
View File
@@ -366,8 +366,8 @@
GetParameter2/StartTransferImg/SetShutterState 的线缆字节序。
- [x] 构建+单测全过;APK 已更新。提交 623d62b。
- [x] **按用户要求完成全量解包复核**(产物入库 analysis/):
- `analysis/jadx_magcx/`:官方普通版全量 Java 源码(64 文件);
- `analysis/ida/export/ghidra_dump/libcxsdk_decomp.txt`Ghidra 11.3.2 全量
- `analysis/sdk_re/android_app/jadx_magcx/`:官方普通版全量 Java 源码(64 文件);
- `analysis/sdk_re/android_app/libcxsdk_decomp.txt`Ghidra 11.3.2 全量
反编译 libcxsdk.so1290 函数);
- `analysis/magcx_official_flow.md`:权威协议结论(命令表/BasePara/CaliInfo/
连接序列/FFC 逻辑/工具重跑命令)。