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