5.1 KiB
5.1 KiB
VENDOR_NOTES — os.meow.ncm 技术栈选型备查
预研：
patch_v2/ncm_app（仅此目录）。库全部静态编入 mipsel（zig-mipsel-cc 交叉）， 产物在out/，各库构建脚本见build_*.sh。体积口径：sizeBerkerleytext/data/bss， mipsel 静态、-Os；flash≈text，RAM≈data+bss。基准：空printf静态 mipsel = text 5888。 实测于 2026-08-31。
选型结论（先看）
| 库 | 版本 | 许可 | mipsel text | 选/不选 |
|---|---|---|---|---|
| mbedtls（裁剪） | 3.6.2 | Apache-2.0 | 链接 Demo ≈ 388 KB（库文本合计 ~410 KB） | ✅ 选（TLS+AES/MD5/RSA/base64/X509 一体） |
| BearSSL | master@7bea48e | MIT | TLS client 参考子集 ≈ 96 KB | 备选（更省 flash，但集成面更杂） |
| jsmn | 1.1.0 | MIT | 2.2 KB | ✅ 选（解析器） |
| cJSON | 1.7.18 | MIT | 20.0 KB | 参考对比（未选，太大） |
| qrcodegen | nayuki@993ccbb | MIT | 10.8 KB | ✅ 选（二维码） |
| minimp3 | master@ea99364 | CC0 | 37.4 KB | ✅ 选（MP3 v1 解码） |
| dr_mp3 | 0.7.4 | MIT/public-domain | 40.7 KB | 参考对比（未选，质量更好但更大更吃内存） |
各库明细
mbedtls 3.6.2（Mbed TLS）— Apache-2.0
- 上游：https://github.com/Mbed-TLS/mbedtls （tag mbedtls-3.6.2，commit 107ea89）
- 裁剪配置：
config/mbedtls_config_ncm.h（由build_mbedtls.sh从默认 141 个 define 减到 102 个）。 保留：TLS1.2 client、AES-CBC/ECB/GCM、MD5、RSA(1024)+BIGNUM、PK/ASN1、X509 证书解析、Base64、PEM_PARSE、ECP/ECDH(P-256 等)。 裁掉：TLS1.3、全部 DTLS、PSA_CRYPTO/IS/LMS、CTR_DRBG/ENTROPY(用自定义 rng)、 CAMELLIA/ARIA/DES/CHACHA/CHACHAPOLY/CCM、HKDF/NIST_KW/ECJPAKE、PKCS5/7/12、PEM_WRITE、MD4、X509_CRL/CSR、 SSL_SESSION_TICKETS/ALPN/RENEGOTIATION/MAX_FRAGMENT/CTX_SERIALIZATION/KEEP_PEER_CERT 等。 裁剪说明：原默认配置裁剪前text更大；按config.py get/unset逐项减；build_mbedtls.sh里列出清单。 - 产物：
out/mbedtls/mipsel/（libmbedcrypto.a / libmbedx509.a / libmbedtls.a）， text 合计 420236（≈410 KB）；实际链接 Demo（含 libc）text=397102（≈388 KB）。 - 为什么它覆盖了我们全部需求：
mbedtls_aes_crypt_ecb(AES-128-ECB)、mbedtls_aes_crypt_cbc(CBC+PKCS7 手写)、mbedtls_md(MD5)、mbedtls_base64_*、mbedtls_rsa_public(无 padding 纯模幂 = weapi)、mbedtls_ssl_*(TLS1.2 client)。
BearSSL（TLS 备选）— MIT
- 上游：https://www.bearssl.org/git/BearSSL （GitHub
bearssl/bearssl已 404，已迁移至官方站点；commit 7bea48e，无语义化版本号） - 构建：
build_bearssl.sh（make lib，CC/AR 用 zig 包装；产物out/bearssl/mipsel/bm/libbearssl.a）。 - 全库 text=317177(≈310 KB)；但只取 TLS client+handshake+rsa+x509 并
--gc-sections后 text≈98620(≈96 KB)。 - 特点：体积小、常量时间；但库里没有 base64（需自带 ~0.5KB 例程），
AES-ECB 也无现成封装（需用 block primitive 逐块或 CBC 变通），RSA raw 用
br_rsa_i31_public（已确认存在）。 - 结论：省 flash 的备选；v1 若集成想省事、且要保 weapi 精确性，仍以 mbedtls 优先。
jsmn 1.1.0 — MIT
- 上游：https://github.com/zserge/jsmn（tag v1.1.0）
- header-only 分词器，无 DOM/无 malloc；编译为最小 TU 后 text=2208(≈2.2 KB)。
- 用于解析响应 JSON（如
{"code":200,"unikey":"..."}取 unikey）。demo 已实测解析正确。
cJSON 1.7.18 — MIT（参考对比，未选）
- 上游：https://github.com/DaveGamble/cJSON（tag v1.7.18）。text=20503(≈20 KB)。
- 优点：现成 DOM、好取值；缺点：20 KB + 需要 malloc、对 14MB 内存也偏大。选 jsmn。
qrcodegen（nayuki QR-Code-generator）— MIT
- 上游：https://github.com/nayuki/QR-Code-generator（c/qrcodegen.c，commit 993ccbb）
- 纯 C 单文件、无图形依赖。text=11082(≈10.8 KB)。
- 用途：把
https://music.163.com/login?codekey=<unikey>渲染成位图给 MeowOS UI 显示。
minimp3 — CC0
- 上游：https://github.com/lieff/minimp3（master@ea99364）。header-only（minimp3.h + minimp3_ex.h）。
- 采用
minimp3_ex（带 ID3/CRC 处理、可 seek 的流式解码）text=38292(≈37.4 KB)。 - 用途：v1 播放（standard/higher = mp3 128/192k）。内存占用小、MIPS 单核可实时（见 benchmark）。
dr_mp3 0.7.4 — MIT/public-domain（参考对比，未选）
- 上游：https://github.com/mackron/dr_libs（dr_mp3.h 单文件）。
- text=41679(≈40.7 KB)；兼容性/音质更好，但更大、解码中间态内存更高。minimp3 更契合 14MB 限制。
备注（工程）
- mbedtls 产物默认写在
vendor/mbedtls/library/（3.6 的 Makefile 不理会 BUILD 变量），脚本再拷贝到out/。 MBEDTLS_SSL_IN_CONTENT_LEN/OUT_CONTENT_LEN默认 16KB；对 14MB 也不大，可再按需调小（见 REPORT 内存估）。- CA 根：demo 从
/etc/ssl/certs/ca-certificates.crt加载；设备侧需内置 CA bundle（eapi 用 iPhone UA，域名 interface.music.163.com）。 - 恢复 mbedtls 默认 config：
git -C vendor/mbedtls checkout -- include/mbedtls/mbedtls_config.h。