flipperzero-firmware/documentation/file_formats/iButtonFileFormat.md
Guido Giorgi 25fd3c3400
iButton: Add support for Dallas DS1971 v2 (#2492)
* iButton: Add DS1971 Support refactored for v2
* Fix requested by gsurkov
* Fix DALLAS_COMMON_CMD_* use, cusotm data field to Eeprom and COPY_SCRAPTCHPAD
* Fix Emulation + Memory Info + Docs
* Fix docs, strings, refactor code

Co-authored-by: Georgii Surkov <georgii.surkov@outlook.com>
Co-authored-by: あく <alleteam@gmail.com>
2023-03-16 23:12:43 +09:00

2.1 KiB

iButton key file format

Example

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

Description

Filename extension: .ibtn

The file stores a single iButton key, complete with all data required by the protocol.

Version history

2. Current version.

Changelog:

  • Added support for different Dallas protocols
  • Fields after Protocol are protocol-dependent for flexibiliy

Format fields

Name Type Description
Protocol string Currently supported: DS1990, DS1992, DS1996, DS1997, DSGeneric*, Cyfral, Metakom
Rom Data hex Read-only memory data (Dallas protocols only)
Sram Data hex Static RAM data (DS1992 and DS1996 only)
Eeprom Data hex EEPROM data (DS1971 only)
Data hex Key data (Cyfral & Metakom only)

NOTE 1: DSGeneric is a catch-all protocol for all unknown 1-Wire devices. It reads only the ROM and does not perform any checks on the read data. It can also be used if a key with a deliberately invalid family code or checksum is required.

NOTE 2: When adding new protocols, it is not necessarily to increase the format version, define the format in the protocol implementation instead.

1. Initial version.

Deprecated, will be converted to current version upon saving.

Format fields

Name Type Description
Key type string Currently supported: Cyfral, Dallas, Metakom
Data hex Key data