mirror of
https://github.com/DarkFlippers/unleashed-firmware
synced 2024-12-18 16:53:45 +00:00
1d91a572cc
* Fix a typo: right shift instead of greater than * Fix a typo: proper iButton part number Co-authored-by: あく <alleteam@gmail.com>
53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
# 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, DS1971, DS1420, 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.
|
|
|
|
**DS1420 is fully compatible with DS1990, only difference is a familiy code 0x01 for DS1990 and 0x81 for DS1420**
|
|
|
|
### 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 |
|
|
|
|
|
|
|