Klippain-Shaketune项目v5.1.0版本发布：彻底解决低功耗主机"timer too close"错误

Klippain-Shaketune是一个基于Klipper固件的3D打印机振动补偿工具，它通过分析加速度计数据来自动优化打印机的输入整形参数，从而减少打印过程中的振动和共振问题，提高打印质量。该项目特别适合DIY 3D打印机用户，能够显著改善打印机的运动性能。

重大改进：全新的.stdata数据存储格式

本次v5.1.0版本最重要的改进是彻底解决了在使用低功耗主机（如CB1）时出现的"timer too close"错误。这个问题的根源在于之前版本中数据收集和存储方式对系统资源的占用过高。

开发团队完全重写了数据收集和存储机制，引入了基于JSON和Zstandard压缩的全新.stdata文件格式，取代了之前基于pickle的格式。这一改进带来了几个关键优势：

1. 异步写入机制：现在使用一个专门的子进程和队列来管理写入操作，与主Klipper进程分离，避免了直接干扰Klipper的正常运行。

2. 智能数据分块：系统会将加速度计读数分块存储，而不是实时写入每个数据点，大大减少了I/O操作频率。

3. 资源优化：通过精心设计的同步机制，在数据写入磁盘时能够合理等待，避免资源争用，同时采用了多种技巧来限制RAM、CPU和I/O的使用。

其他重要改进

除了核心的数据存储机制改进外，本次更新还包含以下重要优化：

• 频率参数精度提升：静态频率命令现在支持使用浮点数而不仅仅是整数作为频率参数，提高了调谐精度。

• 峰值对齐修复：修复了输入整形图表中可能导致边界错误的峰值对齐问题，使分析结果更加准确。

• 测量位置优化：在使用扫描测量时，现在会在每次测量前自动重新校准工具头位置，确保测量条件一致。

• 代码质量提升：修复了代码中的拼写错误和日志信息，提高了整体代码质量。

技术实现细节

新的数据收集系统采用了生产者-消费者模式，主Klipper进程作为生产者将加速度计数据放入队列，而专门的子进程作为消费者负责将数据写入磁盘。这种架构带来了几个关键好处：

1. 解耦数据处理：数据处理和存储不再阻塞主Klipper进程，确保打印机运动控制的实时性。

2. 资源隔离：压缩和写入操作在独立进程中完成，即使出现高负载也不会影响打印质量。

3. 数据完整性：通过队列和同步机制确保即使在系统负载高的情况下也不会丢失数据。

Zstandard压缩算法的选择也经过精心考虑，它在压缩率和速度之间取得了良好平衡，特别适合实时数据收集场景。JSON格式的使用则提高了数据的可读性和互操作性，便于后期分析和调试。

对用户的实际影响

对于使用低功耗主机（如树莓派、CB1等）的用户来说，这一版本解决了长期困扰的稳定性问题。更新后，用户将体验到：

• 更稳定的测量过程，不再出现因系统过载导致的测量中断
• 更低的系统资源占用，打印机主控可以更专注于运动控制
• 更可靠的数据存储，测量结果不会因系统问题而丢失
• 整体更流畅的调谐体验，特别是在进行长时间或高精度测量时

升级建议

对于所有用户，特别是那些曾经遇到过"timer too close"错误或使用低功耗主机的用户，强烈建议升级到v5.1.0版本。新版本不仅解决了稳定性问题，还带来了多项使用体验的改进。

对于开发者而言，这次更新也展示了如何通过架构优化解决嵌入式系统中的资源限制问题，其中的异步处理和数据压缩技术值得借鉴。