[proxmark3-svn] / CHANGELOG.md

# Change Log
All notable changes to this project will be documented in this file.
This project uses the changelog in accordance with [keepchangelog](http://keepachangelog.com/). Please use this to write notable changes, which is not the same as git commit log...

## [unreleased][unreleased]

### Added
- Added lf cotag read, and added it to lf search (iceman)
- Added hitag2 read UID only and added that to lf search (marshmellow)
- Added lf pyramid commands (iceman)
- Added lf presco commands - some bits not fully understood... (iceman)
- Added experimental HitagS support (Oguzhan Cicek, Hendrik Schwartke, Ralf Spenneberg)
  see https://media.ccc.de/v/32c3-7166-sicherheit_von_125khz_transpondern_am_beispiel_hitag_s
  English video available
- Added a LF ASK Sequence Terminator detection option to the standard ask demod - and applied it to `lf search u`, `lf t55xx detect`, and `data rawdemod am s` (marshmellow)
- `lf t55xx bruteforce <start password> <end password> [i <*.dic>]` - Simple bruteforce attack to find password - (iceman and others)
- `lf viking clone`- clone viking tag to t55x7 or Q5 from 4byte hex ID input 
- `lf viking sim`  - sim full viking tag from 4byte hex ID input
- `lf viking read` - read viking tag and output ID
- `lf t55xx wipe`  - sets t55xx back to factory defaults
- Added viking demod to `lf search` (marshmellow)
- `data askvikingdemod` demod viking id tag from graphbuffer (marshmellow)
- `lf t55xx resetread` added reset then read command - should allow determining start of stream transmissions (marshmellow)
- `lf t55xx wakeup` added wake with password (AOR) to allow lf search or standard lf read after (iceman, marshmellow)
- `hf iclass managekeys` to save, load and manage iclass keys.  (adjusted most commands to accept a loaded key in memory) (marshmellow)
- `hf iclass readblk` to select, authenticate, and read 1 block from an iclass card (marshmellow)
- `hf iclass writeblk` to select, authenticate, and write 1 block to an iclass card (or picopass) (marshmellow + others)
- `hf iclass clone` to take a saved dump file and clone selected blocks to a new tag (marshmellow + others)
- `hf iclass calcnewkey` - to calculate the div_key change to change a key - (experimental) (marshmellow + others)
- `hf iclass encryptblk` - to encrypt a data block hex to prep for writing that block (marshmellow)
- ISO14443a stand-alone operation with ARM CFLAG="WITH_ISO14443a_StandAlone". This code can read & emulate two banks of 14a tag UIDs and write to "magic" cards  (Craig Young) 
- AWID26 command context added as 'lf awid' containing realtime demodulation as well as cloning/simulation based on tag numbers (Craig Young)
- Added 'hw status'. This command makes the ARM print out some runtime information. (holiman) 
- Added 'hw ping'. This command just sends a usb packets and checks if the pm3 is responsive. Can be used to abort certain operations which supports abort over usb. (holiman)
- Added `data hex2bin` and `data bin2hex` for command line conversion between binary and hexadecimal (holiman)
- Added 'hf snoop'. This command take digitalized signal from FPGA and put in BigBuffer. (pwpiwi + enio)
- Added Topaz (NFC type 1) protocol support ('hf topaz reader', 'hf list topaz', 'hf 14a raw -T', 'hf topaz snoop'). (piwi)
- Added option c to 'hf list' (mark CRC bytes) (piwi)

### Changed
- Fixed bug in lf sim and continuous demods not turning off antenna when finished
- Fixed bug(s) in hf iclass write
- Fixed bug in lf biphase sim - `lf simask b` (and any tagtype that relies on it - gproxii...) (marshmellow)
- Fixed bug in lf viking clone/sim (iceman)
- Fixed broken `data askedgedetect` (marshmellow)
- Adjusted hf mf sim command (marshmellow)
    added auto run mfkey32 to extract all keys 
    also added f parameter to allow attacking with UIDs from a file (implies x and i parameters)
    also added e parameter to allow adding the extracted keys to emulator memory for the next simulation
    added 10 byte uid option
- Added `[l] <length>` option to data printdemodbuffer (marshmellow)
- Adjusted lf awid clone to optionally clone to Q5 tags (marshmellow)
- Adjusted lf t55xx detect to find Q5 tags (t5555) instead of just t55x7 (marshmellow)
- Adjusted all lf NRZ demods - works more accurately and consistently (as long as you have strong signal) (marshmellow)
- Adjusted lf pskindalademod to reduce false positive reads. (marshmellow)
- Small adjustments to psk, nrz, and ask clock detect routines - more reliable. (marshmellow)
- Adjusted lf em410x em410xsim to accept a clock argument (marshmellow)
- Adjusted lf t55xx dump to allow overriding the safety check and warning text (marshmellow)
- Adjusted lf t55xx write input variables (marshmellow)
- Adjusted lf t55xx read with password safety check and warning text and adjusted the input variables (marshmellow & iceman)
- Adjusted LF FSK demod to account for cross threshold fluctuations (898 count waves will adjust the 9 to 8 now...) more accurate. (marshmellow)
- Adjusted timings for t55xx commands.  more reliable now. (marshmellow & iceman)
- `lf cmdread` adjusted input methods and added help text (marshmellow & iceman)
- changed `lf config t <threshold>` to be 0 - 128 and will trigger on + or - threshold value (marshmellow) 
- `hf iclass dump` cli options - can now dump AA1 and AA2 with different keys in one run (does not go to multiple pages for the larger tags yet) (marshmellow)
- Revised workflow for StandAloneMode14a (Craig Young)
- EPA functions (`hf epa`) now support both ISO 14443-A and 14443-B cards (frederikmoellers)
- 'hw version' only talks to ARM at startup, after that the info is cached. (pwpiwi)
- Added `r` option to iclass functions - allows key to be provided in raw block 3/4 format 

## [2.2.0][2015-07-12]

### Changed
- Added `hf 14b raw -s` option to auto select a 14b std tag before raw command 
- Changed `hf 14b write` to `hf 14b sriwrite` as it only applied to sri tags (marshmellow)
- Added `hf 14b info` to `hf search` (marshmellow)
- Added compression of fpga config and data, *BOOTROM REFLASH REQUIRED* (piwi)
- Implemented better detection of mifare-tags that are not vulnerable to classic attacks (`hf mf mifare`, `hf mf nested`) (piwi)

### Added
- Add `hf 14b info` to find and print info about std 14b tags and sri tags (using 14b raw commands in the client)  (marshmellow)
- Add PACE replay functionality (frederikmoellers)

### Fixed 
- t55xx write timing (marshmellow)


## [2.1.0][2015-06-23]

### Changed
- Added ultralight/ntag tag type detection to `hf 14a read` (marshmellow)
- Improved ultralight dump command to auto detect tag type, take authentication, and dump full memory (or subset specified) of known tag types (iceman1001 / marshmellow)
- Combined ultralight read/write commands and added authentication (iceman1001)
- Improved LF manchester and biphase demodulation and ask clock detection especially for reads with heavy clipping. (marshmellow)
- Iclass read, `hf iclass read` now also reads tag config and prints configuration. (holiman)
- *bootrom* needs to be flashed, due to new address boundaries between os and fpga, after a size optimization (piwi)

### Fixed
- Fixed EM4x50 read/demod of the tags broadcasted memory blocks. 'lf em4x em4x50read' (not page read) (marshmellow)
- Fixed issue #19, problems with LF T55xx commands (iceman1001, marshmellow)
- Fixed various problems with iso14443b, issue #103 (piwi, marshmellow)

### Added
- Added `hf search` - currently tests for 14443a tags, iclass tags, and 15693 tags (marshmellow) 
- Added `hf mfu info` Ultralight/NTAG info command - reads tag configuration and info, allows authentication if needed (iceman1001, marshmellow)
- Added Mifare Ultralight C and Ultralight EV1/NTAG authentication. (iceman1001)
- Added changelog

## [2.0.0] - 2015-03-25
### Changed
- LF sim operations now abort when new commands arrive over the USB - not required to push the device button anymore.

### Fixed
- Mifare simulation, `hf mf sim` (was broken a long time) (pwpiwi)
- Major improvements in LF area and data operations. (marshmellow, iceman1001)
- Issues regarding LF simulation (pwpiwi)

### Added
- iClass functionality: full simulation of iclass tags, so tags can be simulated with data (not only CSN). Not yet support for write/update, but readers don't seem to enforce update. (holiman).
- iClass decryption. Proxmark can now decrypt data on an iclass tag, but requires you to have the HID decryption key locally on your computer, as this is not bundled with the sourcecode.
Commit	Line	Data
616970b3 MHS	1	# Change Log
	2	All notable changes to this project will be documented in this file.
	3	This project uses the changelog in accordance with [keepchangelog](http://keepachangelog.com/). Please use this to write notable changes, which is not the same as git commit log...
	4
5ebdce44 MHS	5	## [unreleased][unreleased]
5ebdce44 MHS	6
e46fe044	7	### Added
f1e6629b	8	- Added lf cotag read, and added it to lf search (iceman)
89696b8b	9	- Added hitag2 read UID only and added that to lf search (marshmellow)
76ef5273	10	- Added lf pyramid commands (iceman)
76ef5273	11	- Added lf presco commands - some bits not fully understood... (iceman)
5cfd18ac RS	12	- Added experimental HitagS support (Oguzhan Cicek, Hendrik Schwartke, Ralf Spenneberg)
	13	see https://media.ccc.de/v/32c3-7166-sicherheit_von_125khz_transpondern_am_beispiel_hitag_s
	14	English video available
e452cfb4	15	- Added a LF ASK Sequence Terminator detection option to the standard ask demod - and applied it to `lf search u`, `lf t55xx detect`, and `data rawdemod am s` (marshmellow)
506672c4	16	- `lf t55xx bruteforce <start password> <end password> [i <*.dic>]` - Simple bruteforce attack to find password - (iceman and others)
	17	- `lf viking clone`- clone viking tag to t55x7 or Q5 from 4byte hex ID input
	18	- `lf viking sim` - sim full viking tag from 4byte hex ID input
	19	- `lf viking read` - read viking tag and output ID
	20	- `lf t55xx wipe` - sets t55xx back to factory defaults
415274a7	21	- Added viking demod to `lf search` (marshmellow)
415274a7	22	- `data askvikingdemod` demod viking id tag from graphbuffer (marshmellow)
76ef5273	23	- `lf t55xx resetread` added reset then read command - should allow determining start of stream transmissions (marshmellow)
88f475cf	24	- `lf t55xx wakeup` added wake with password (AOR) to allow lf search or standard lf read after (iceman, marshmellow)
7a8344d0	25	- `hf iclass managekeys` to save, load and manage iclass keys. (adjusted most commands to accept a loaded key in memory) (marshmellow)
7a8344d0	26	- `hf iclass readblk` to select, authenticate, and read 1 block from an iclass card (marshmellow)
85f581c7	27	- `hf iclass writeblk` to select, authenticate, and write 1 block to an iclass card (or picopass) (marshmellow + others)
7a8344d0	28	- `hf iclass clone` to take a saved dump file and clone selected blocks to a new tag (marshmellow + others)
	29	- `hf iclass calcnewkey` - to calculate the div_key change to change a key - (experimental) (marshmellow + others)
	30	- `hf iclass encryptblk` - to encrypt a data block hex to prep for writing that block (marshmellow)
e46fe044	31	- ISO14443a stand-alone operation with ARM CFLAG="WITH_ISO14443a_StandAlone". This code can read & emulate two banks of 14a tag UIDs and write to "magic" cards (Craig Young)
769791d4	32	- AWID26 command context added as 'lf awid' containing realtime demodulation as well as cloning/simulation based on tag numbers (Craig Young)
c89274cc CY	33	- Added 'hw status'. This command makes the ARM print out some runtime information. (holiman)
c89274cc CY	34	- Added 'hw ping'. This command just sends a usb packets and checks if the pm3 is responsive. Can be used to abort certain operations which supports abort over usb. (holiman)
f6821167	35	- Added `data hex2bin` and `data bin2hex` for command line conversion between binary and hexadecimal (holiman)
edc9ce00	36	- Added 'hf snoop'. This command take digitalized signal from FPGA and put in BigBuffer. (pwpiwi + enio)
d9cc4e1a	37	- Added Topaz (NFC type 1) protocol support ('hf topaz reader', 'hf list topaz', 'hf 14a raw -T', 'hf topaz snoop'). (piwi)
d9cc4e1a	38	- Added option c to 'hf list' (mark CRC bytes) (piwi)
769791d4	39
2c3c08bd	40	### Changed
89696b8b	41	- Fixed bug in lf sim and continuous demods not turning off antenna when finished
89696b8b	42	- Fixed bug(s) in hf iclass write
76ef5273	43	- Fixed bug in lf biphase sim - `lf simask b` (and any tagtype that relies on it - gproxii...) (marshmellow)
	44	- Fixed bug in lf viking clone/sim (iceman)
	45	- Fixed broken `data askedgedetect` (marshmellow)
	46	- Adjusted hf mf sim command (marshmellow)
	47	added auto run mfkey32 to extract all keys
	48	also added f parameter to allow attacking with UIDs from a file (implies x and i parameters)
	49	also added e parameter to allow adding the extracted keys to emulator memory for the next simulation
	50	added 10 byte uid option
	51	- Added `[l] <length>` option to data printdemodbuffer (marshmellow)
	52	- Adjusted lf awid clone to optionally clone to Q5 tags (marshmellow)
	53	- Adjusted lf t55xx detect to find Q5 tags (t5555) instead of just t55x7 (marshmellow)
	54	- Adjusted all lf NRZ demods - works more accurately and consistently (as long as you have strong signal) (marshmellow)
	55	- Adjusted lf pskindalademod to reduce false positive reads. (marshmellow)
	56	- Small adjustments to psk, nrz, and ask clock detect routines - more reliable. (marshmellow)
	57	- Adjusted lf em410x em410xsim to accept a clock argument (marshmellow)
88f475cf	58	- Adjusted lf t55xx dump to allow overriding the safety check and warning text (marshmellow)
	59	- Adjusted lf t55xx write input variables (marshmellow)
	60	- Adjusted lf t55xx read with password safety check and warning text and adjusted the input variables (marshmellow & iceman)
76ef5273	61	- Adjusted LF FSK demod to account for cross threshold fluctuations (898 count waves will adjust the 9 to 8 now...) more accurate. (marshmellow)
88f475cf	62	- Adjusted timings for t55xx commands. more reliable now. (marshmellow & iceman)
21a615cb	63	- `lf cmdread` adjusted input methods and added help text (marshmellow & iceman)
7a8344d0	64	- changed `lf config t <threshold>` to be 0 - 128 and will trigger on + or - threshold value (marshmellow)
76ef5273	65	- `hf iclass dump` cli options - can now dump AA1 and AA2 with different keys in one run (does not go to multiple pages for the larger tags yet) (marshmellow)
c89274cc	66	- Revised workflow for StandAloneMode14a (Craig Young)
2c3c08bd	67	- EPA functions (`hf epa`) now support both ISO 14443-A and 14443-B cards (frederikmoellers)
c89274cc	68	- 'hw version' only talks to ARM at startup, after that the info is cached. (pwpiwi)
59296346	69	- Added `r` option to iclass functions - allows key to be provided in raw block 3/4 format
5ebdce44 MHS	70
5ebdce44 MHS	71	## [2.2.0][2015-07-12]
475aefa5	72
b7eddc14	73	### Changed
1c7d367e	74	- Added `hf 14b raw -s` option to auto select a 14b std tag before raw command
b7eddc14	75	- Changed `hf 14b write` to `hf 14b sriwrite` as it only applied to sri tags (marshmellow)
1c7d367e	76	- Added `hf 14b info` to `hf search` (marshmellow)
60034782	77	- Added compression of fpga config and data, BOOTROM REFLASH REQUIRED (piwi)
5ebdce44	78	- Implemented better detection of mifare-tags that are not vulnerable to classic attacks (`hf mf mifare`, `hf mf nested`) (piwi)
b7eddc14	79
dd3d1b70	80	### Added
1c7d367e	81	- Add `hf 14b info` to find and print info about std 14b tags and sri tags (using 14b raw commands in the client) (marshmellow)
dd3d1b70 MHS	82	- Add PACE replay functionality (frederikmoellers)
	83
	84	### Fixed
	85	- t55xx write timing (marshmellow)
475aefa5 MHS	86
	87
	88	## [2.1.0][2015-06-23]
	89
616970b3	90	### Changed
be10fe2f	91	- Added ultralight/ntag tag type detection to `hf 14a read` (marshmellow)
	92	- Improved ultralight dump command to auto detect tag type, take authentication, and dump full memory (or subset specified) of known tag types (iceman1001 / marshmellow)
	93	- Combined ultralight read/write commands and added authentication (iceman1001)
acaeccf8	94	- Improved LF manchester and biphase demodulation and ask clock detection especially for reads with heavy clipping. (marshmellow)
616970b3	95	- Iclass read, `hf iclass read` now also reads tag config and prints configuration. (holiman)
2c772e6c	96	- bootrom needs to be flashed, due to new address boundaries between os and fpga, after a size optimization (piwi)
616970b3 MHS	97
616970b3 MHS	98	### Fixed
acaeccf8	99	- Fixed EM4x50 read/demod of the tags broadcasted memory blocks. 'lf em4x em4x50read' (not page read) (marshmellow)
acaeccf8	100	- Fixed issue #19, problems with LF T55xx commands (iceman1001, marshmellow)
475aefa5	101	- Fixed various problems with iso14443b, issue #103 (piwi, marshmellow)
616970b3 MHS	102
616970b3 MHS	103	### Added
be10fe2f	104	- Added `hf search` - currently tests for 14443a tags, iclass tags, and 15693 tags (marshmellow)
	105	- Added `hf mfu info` Ultralight/NTAG info command - reads tag configuration and info, allows authentication if needed (iceman1001, marshmellow)
	106	- Added Mifare Ultralight C and Ultralight EV1/NTAG authentication. (iceman1001)
616970b3 MHS	107	- Added changelog
	108
	109	## [2.0.0] - 2015-03-25
	110	### Changed
	111	- LF sim operations now abort when new commands arrive over the USB - not required to push the device button anymore.
	112
	113	### Fixed
	114	- Mifare simulation, `hf mf sim` (was broken a long time) (pwpiwi)
	115	- Major improvements in LF area and data operations. (marshmellow, iceman1001)
	116	- Issues regarding LF simulation (pwpiwi)
	117
	118	### Added
	119	- iClass functionality: full simulation of iclass tags, so tags can be simulated with data (not only CSN). Not yet support for write/update, but readers don't seem to enforce update. (holiman).
	120	- iClass decryption. Proxmark can now decrypt data on an iclass tag, but requires you to have the HID decryption key locally on your computer, as this is not bundled with the sourcecode.
	121
	122