Tutorial for basic usage / commands

[cons0l3]

A few simple examples or step by step instructions would be wonderful:

1. How to read and existing card and dump the data to a file (READER)?
2. How to take a dump and upload it to a virtual card 1-8?
3. How to clone a card from READER to directly to a virtual card?
4. How to set random UID without using buttons?

[...]

Thanks for your constructive feedback ; however, ChameleonMini has so many use cases / things to explain that it is hard to create step-by-step instructions for every use case... the documentation is pretty complete and it took some time to write it... and it also contains a few step-by-step instructions. Getting known to Chameleon requires some "playing" I guess ; some additional examples such as uploading dumps, random UID are also in the kickstarter video (lab tests): Video. The reader function as in the current firmware is still - as announced in the kickstarter campaign - quiet basic, so advanced functions (via SEND or SEND_RAW) require an understanding of NFC commands / ISO14443. Easy functions such as IDENTIFY or DUMP_MFU to dump an Ultralight card are already provided (see here: Chameleon Commands ). For impementing tons of more reader functions we count on the open-source community: The firmware and documentation is only a starting point for everyone and you are welcome to add any new function / new card / new codec / tutorial / step-by-step infos / improved documentation etc. - we will gladly integrate it into the project.

[rweijnen]

First of all, the documentation is a good starting point and has clearly taken a lot of time to write. However the documentation is written as a programmers documentation, a reference guide if you will. It explains what commands do but not which commands would be required for a certain task.

So I agree with @cons0l3 a few more examples would be very helpful and could accelerate community to start working with the chameleon and start contributing!

[cons0l3]

Yes, the documentation is a good starting point. But simple examples for someone who just starts with NFC, ISO14443A, etc. (like me)

You would not belief the big smile I had yesterday, when I got the UID from a card. 3 other near field type cards did not work. Reasons unknown. I use my android tablet with a "nfc reader" app to dig into the cards.

To study test cases is usually a good starting point to understand the usage of a "thing". So I am considering to write a few python test cases (for learning purposes) to
a) test the firmware
b) test the python clients
So prepare and embrace yourself for incoming pull requests.

For myself, I have had a look at the firmware and was overwhelmed (for now). I will put some love into the python toolset.

[gogobd]

I second the proposal of a tutorial for some ste by staep procedures. It was easy to u derstand how to clone a UID, but dumoing a whole card to emulate it is not covered well in the current documentation.

[dev-zzo]

FWIW, I am putting together a tutorial here for my colleagues: https://gist.github.com/dev-zzo/88bd6e78dc62e2ed32616c4889151f8a
Let me know if I can improve it in any way. :-)

[grymoire]

Suggested tip for Minicom/Linux users:

Turn on Local Echo (Control-A E) and Line Wrap mode on (Control-A W)

[johanveen]

First of all everyone the best wishes for 2017.
I must agree that the documentation for basic usage can/should be better.

There are several video tutorials but none of them explain how you can extract the dump to the computer. They only show how to make some modifications and what the possibilities are of the card.

I can make a dump_mfu of a card and upload an example dump to the chameleon mini, but I cannot download a dump to the PC (OS Ubuntu 16.04 LTS).

So if someone could help me I would be grateful.

[dev-zzo]

@johanveen could you please explain in more detail the "cannot download" part? What happens when you issue the DOWNLOAD command?

[zenroth1752]

Switch to Kali Linux - As all the NFC is set up. I have had issues with OS Ubuntu 16.04 LTS. It is a quick solution as I don't know much of the background.