hallko1234/cr4501-ral-hack

Source: https://github.com/hallko1234/cr4501-ral-hack

色差仪 3nh CR4501 RAL 修改

Deutsche Fassung

3nh CR4501 测量颜色非常准确——但它就是不告诉你这是哪个 RAL 色调。为此，你需要掏出手机、打开应用并通过蓝牙配对。这个修改直接把答案显示在设备自己的屏幕上：每次测量后，它会显示最接近的 RAL Classic 色调，包括名称和匹配程度。测量、读取、继续。

🔴 启动工具 (https://hallko1234.github.io/cr4501-ral-hack/) 🔴

一切都在浏览器中运行——不会上传任何内容

打开工具（https://hallko1234.github.io/cr4501-ral-hack/）

Chrome 或 Edge · 五分钟 · 完全可逆

该工具会逐步引导你完成：将设备置于更新模式、检查驱动、先备份、然后刷写、再试一下。不会上传任何内容，没有服务器，你设备的固件绝不会离开你的电脑。额外的好处是，它解锁了出厂固件在测量屏幕上禁用的按钮——左、右和确认键开始按你预期的方式工作。

开始之前

• Chrome 或 Edge。 Firefox 和 Safari 不支持 WebUSB。
• 在 Windows 上，设备需要安装一次 WinUSB 驱动，见下文。
• 时间： 五分钟，其中四分钟是等待。

进入更新模式

这一步需要一点手感。设备必须处于关机状态——按住测量键直到它关闭。然后至少等待五秒钟，不要碰任何东西；没有这个停顿，设备不会响应。

选项 A——再次按住测量键，直到周围的圆环闪烁红色。立即松手。
选项 B——同时按下测量键和确认键，即向中心按压摇杆。红色闪烁会立刻出现；马上松手。

当圆环闪烁红色时，设备就绪。屏幕保持黑屏，这是正常的。

接下来

1. 通过 USB 连接，打开工具，查找设备
2. 读取并备份——保留该文件，这是你恢复的途径
3. 刷写——工具会预先检查每个补丁位置，只要有一点不匹配就会中止
4. 重新启动设备，测量，用确认键循环切换视图

Windows 上的驱动

Windows 没有附带浏览器可与之通信的更新模式驱动。Zadig（https://zadig.akeo.ie）一分钟就能解决：

1. 将设备以更新模式插入
2. 启动 Zadig，Options → List All Devices（选项 → 列出所有设备）
3. 选择 STM32 DownLoad Firmware Update（0483:DF11）
4. 在右侧设置为 WinUSB，然后 Install Driver（安装驱动）

只需一次。必须选择 WinUSB——不是 libusbK，也不是 libusb-win32。那些可与 dfu-util 配合使用，但浏览器无法识别设备。这是最常见的错误。

修改了什么

七个位置，仅五千多字节，全部位于应用区域 0x08004000–0x0802FFFF 内。0x08030000 以上的内容完全不会被触碰——启动画面、设置，尤其是出厂校准。这些在每台设备上都不同。写入其他设备的值会导致仪器永久测量错误，而且没人会注意到。工具拒绝对该区域进行任何写入访问。

颜色来源

216 个 RAL Classic 色调，每个颜色测量三次。可重复性平均为 0.08 ΔE，最差为 0.50。使用原装 RAL® K5 半哑光测量。其色板比扇卡大得多，因此 8 mm 孔径完全位于色板内部，不会碰到边缘。这不是细节问题：配件市场出售的仿制色卡通常有明显偏差，有时偏差达数个 ΔE，而且它们彼此之间也不一致。如果你的读数与其中一张不符，通常问题出在色卡上。

每个条目十个字节：L、a、b 以整数乘以一百存储，加上 RAL 编号和用于显示的 RGB 颜色值。名称跟在后面，作为共享的单词片段块，使用引用而不是重复——否则它们无法放入可用内存中。

老实说：这些值来自一个扇卡和一台设备。扇卡会老化和发黄，每台仪器都有自己的校准。对于“这大概是哪个 RAL”来说，这正好合适。如果要签字确认或提出投诉，请拿出扇卡。

测量你自己的颜色

这里附带的表格来自一个扇卡和一台设备。如果你想要自己的数值——不同的扇卡、自己的设备，或者只是作为检查——相应的程序在 werkzeug/ 下（德语）。它会依次测量 216 种颜色，检查分散度和重复读数，并最终从你自己的备份构建出完整的固件。然后在工具中的 Restore a backup（恢复备份）下刷写该固件。

python ral_einlernen.py COM3 --original cr4501_original_....bin

参考文件

用于反汇编或继续开发：屏幕代码、颜色表以及开发过程中的原始图像位于 referenz/ 下。这些东西都不应盲目刷写——尤其是加载器，它带有某一台特定设备的出厂校准。原因见那里的 README。

技术文档

内存映射、按键系统、屏幕处理、颜色测量、USB 协议以及如何写入持久内存：→ doku/（德语——但地址、字节序列和表格不言自明）

其中的每个地址都在设备或闪存转储上得到验证。它还记录了哪里出了问题以及原因，从而省去昂贵的弯路。

如何撤销

在工具的第 5 步，选择你的备份文件。如果页面无法访问，也可以使用：

dfu-util -a 0 -s 0x08004000 -D your_backup.bin

切勿使用 -t 选项，并且始终一次性写入整个区域——引导加载程序会在第一条写入命令时擦除所有内容，之后期望得到完整映像。

免责声明

这是一个周末项目，不是 3nh 的产品，不提供任何担保。使用风险自负——但有安全恢复途径，并且你的设备校准在任何情况下都保持不变。如果工具因无法识别固件版本而在你的设备上中止，请联系我，我会查看。

▶ 打开工具（https://hallko1234.github.io/cr4501-ral-hack/）