Skip to content

exp-3/OpenZxicEditor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenZxicEditor

一个 POSIX 兼容的 ZXIC 设备固件编辑器


For English documentation or detatiled information, please refer to Ask DeepWiki.


简介

一键解包和打包 zxic 烧录器固件的工具。

附带 MTD 分区的拆分和合并功能。

兼容性

已确认在以下系统环境中可使用:

Ubuntu

  • 22.04 及更高版本请直接使用installers/install_apt.sh完成安装
  • 低于 22.04 的版本可能还需手动安装lua5.4 python3-pipjefferson

Debian

  • 12 及更高版本请直接使用installers/install_apt.sh完成安装
  • 11 版本还需手动安装jefferson
  • 低于 11 的版本还需手动安装lua5.4

使用方法

一键解包

./diffindo -d [烧录器镜像路径]

把烧录器固件拆分为分区文件并解包。

解包后的文件会放在名称以z.开头的工程文件夹中。

Note

烧录器固件拆分依赖 mtdcut ,但它并非完全开源的,因此属于 restricted 组件。
OpenZxicEditor 已取得部分权利并默认附带。如果您反感此行为,请自行将其移除。

一键打包

./diffindo -c [工程文件夹路径]?

打包所有解包的分区,并重新整合成烧录器固件。

解包数据与 Windows 中的 ufiStudio 不通用,请在 Linux/Unix 环境中生成*_unpacked解包文件夹。

如果未通过参数输入工程文件夹路径,则会使用默认值MTDs

打包后将在对应工程文件夹中生成新的镜像文件full_new.bin,可直接使用烧录器写入闪存。

更多用法

您可以通过以下命令查看更多用法:

./diffindo --help

注意事项

  1. 此程序尚不完善,可能存在一些问题,欢迎提出建议。
  2. 开发时已留意了空格和中文路径的问题,但如果遇到迷惑 bug 可以尝试将文件放到简单路径下再试。
  3. 软件会解包所有受支持的分区类型。如果某分区不需要修改,那么建议删除相应的解包文件夹,合并时将会自动使用原版。
  4. 如需查看分区解包/打包时的详细信息(日志),请创建文件__lib__\--enable-log

使用须知

  1. 禁止将此项目用于任何非法和不道德的行为,所造成的任何后果由使用者承担。
    且不建议将此项目用于商业用途,如遇纠纷及其他不良后果请贩卖者自行承担。
  2. 如需二次开发,请遵守 AGPLv3 协议 (详见 开源许可.md),并明确标注版权信息和出处。
    如果出于规避 AGPLv3 协议等目的需要仿制/重制本项目,请遵循白盒净室开发流程,并注明参考资料出处。

关于项目

  1. 本项目的开发目的是研究 ZXIC 路由的固件格式,并希望为爱好者学习提供便利。
  2. 目前仅确认支持 ZX7520v3 芯片平台的固件,其他固件格式可能存在差异,请自行研究。
  3. OpenZxicEditor 现已完全由社区独立维护。即日起不再通过第三方渠道发布。
  4. 欢迎各位用户和开发者提出建议,协助完善本项目。

特别声明

  • 某名为 OpenZxicEditor-For-Windows 的仓库与 OpenZxicEditor 无任何关联。事实上它是基于同类闭源软件 ufiStudio 二次破解的。我们对这种冒名顶替、疑似侵权的伪开源表示谴责,请不要使用这种来历不明的软件以免造成不必要的损失。
  • 最近某项目几乎完全“复刻”了 OpenZxicEditor 的代码,结构和实现几乎完全一致,显然未遵循净室开发流程、也未注明参考资料来源。本项目并非使用了放弃署名权的许可证发布,因此我们认为这是一种侵权行为,特此在此声明。

About

这才是更好更专业的ZXIC固件编辑器。

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published