Flipper Zero项目中的iButton钥匙文件格式解析

Flipper Zero项目中的iButton钥匙文件格式解析

flipperzero-firmware Flipper Zero firmware source code 项目地址: https://gitcode.com/gh_mirrors/fl/flipperzero-firmware

什么是iButton钥匙文件

iButton钥匙文件是Flipper Zero设备用于存储和管理iButton物理钥匙数据的专用文件格式。这种文件格式能够完整记录不同类型iButton钥匙的所有必要信息，包括只读存储器(ROM)、静态RAM(SRAM)和EEPROM等数据。

文件基本结构

iButton钥匙文件采用文本格式存储，具有以下基本结构：

Filetype: Flipper iButton key
Version: 2
Protocol: [协议类型]
[协议特定数据字段]

文件扩展名为.ibtn，采用键值对的形式组织数据，便于阅读和解析。

当前版本(V2)详解

支持的协议类型

当前版本支持多种iButton协议，包括：

1. Dallas系列协议：

   • DS1990：最简单的iButton设备
   • DS1992：带有SRAM的iButton
   • DS1996：增强型带有SRAM的iButton
   • DS1971：带有EEPROM的iButton
   • DSGeneric：通用1-Wire设备协议

2. 其他厂商协议：

   • Cyfral
   • Metakom

各协议对应的数据字段

不同协议使用不同的数据字段：

1. Dallas协议通用字段：

   • Rom Data：只读存储器数据，以十六进制表示

2. 特定Dallas协议字段：

   • DS1992和DS1996：Sram Data - 静态RAM数据
   • DS1971：Eeprom Data - EEPROM数据

3. Cyfral和Metakom协议：

   • Data：钥匙的核心数据

特殊协议说明

DSGeneric协议是一个通用解决方案，用于处理：

• 未知的1-Wire设备
• 需要故意使用无效家族代码或校验和的情况
• 仅读取ROM数据而不进行校验的场景

实际应用示例

以下是一个DS1992协议的iButton钥匙文件示例：

Filetype: Flipper iButton key
Version: 2
Protocol: DS1992
Rom Data: 08 DE AD BE EF FA CE 4E
Sram Data: 4E 65 76 65 72 47 6F 6E 6E 61 47 69 76 65 59 6F 75 55 70 4E 65 76 65 72 47 6F 6E 6E 61 4C 65 74 59 6F 75 44 6F 77 6E 4E 65 76 65 72 47 6F 6E 6E 61 52 75 6E 41 72 6F 75 6E 64 41 6E 64 44 65 73 65 72 74 59 6F 75 4E 65 76 65 72 47 6F 6E 6E 61 4D 61 6B 65 59 6F 75 43 72 79 4E 65 76 65 72 47 6F 6E 6E 61 53 61 79 47 6F 6F 64 62 79 65 4E 65 76 65 72 47 6F 6E 6E 61 54 65 6C 6C 41 4C 69 65

这个示例展示了：

1. 文件类型和版本声明
2. 使用的协议类型(DS1992)
3. ROM数据(8字节)
4. SRAM数据(112字节)

技术细节与最佳实践

1. 版本兼容性：

   • 旧版V1文件在保存时会自动转换为V2格式
   • 新增协议通常不需要更新文件格式版本

2. 数据表示：

   • 所有数据字段使用十六进制表示
   • 字节间用空格分隔
   • 大小写不敏感

3. 扩展建议：

   • 实现新协议时，应在协议实现中定义格式
   • 保持向后兼容性

总结

Flipper Zero的iButton钥匙文件格式设计灵活且可扩展，能够支持多种iButton协议。通过这种标准化的文件格式，用户可以方便地存储、分享和管理各种类型的iButton钥匙数据。理解这一文件格式对于开发iButton相关应用和进行高级配置至关重要。

flipperzero-firmware Flipper Zero firmware source code 项目地址: https://gitcode.com/gh_mirrors/fl/flipperzero-firmware