search

iceman1001 / ChameleonMini-rebooted

Chameleon Mini revE rebooted - Iceman Fork, the ChameleonMini is a versatile contactless smartcard emulator (NFC/RFID)
Other
396 stars 85 forks source link

Getting started on Windows 10 : beginners walkthrough #88

Closed securechicken closed 5 years ago

securechicken commented 5 years ago

Quick insights for RevE beginners as I am really new to all this, and it took me some hours figuring it all. Some directions here may be added to wiki (I don't know how to git, sorry).

First of all, do Windows before anything else if your goal is to get RevE working fast. It is the easiest way. On Linux and MacOS, the Qt based GUI did not work each time from me, flashing has been a pain, and temped to build firmware, I have been burning time on some traditional compilation and environment issues. Working on a Windows VM is possible, it worked just as well for me.

Just check your device can be talked with on Windows 10. This should be plug & play. Plug your device in USB port, and use a GUI tool (had the better results with this one from Lab401, based on this repo). The output console of GUI Tool should say Success, found Chameleon Mini device on 'COMX' with Firmware RevE rebooted installed

Put your RevE in boot loader mode, directly from the GUI (Settings tab, then "Upgrade"). Your RevE should be setup as a new unknown device.

Setup the DFU drivers so that device is correctly recognized. To do so in Windows 10, get the Drivers files from this repo (you can get all files from this repo by choosing "Clone or Download" then "Download ZIP" on the main repo page), then in Windows type "Device manager" in start menu, open it, right click on unknown USB device, and choose "Update driver". Then points the assistant to the folder with "Drivers" from this repo, and it will be installed. You should then see your USB device as "Atmel USB Devices" ATxmega32A4U.

Get existing firmwares, or build a new one from source :

Setup Windows C++ Redistributable for Visual Studio 2013 (VC 12.0). If you use a 64bits Windows, you ALSO have to setup the x86 ones (I had a hard time on that, the flash utility does not start if you do not have the x86 VC 12.0 redistributable on a 64bits system). Both (x64 and x86) can be downloaded from Microsoft here..

Flash your firmware with "BOOT_LOADER_EXE.exe", that you will already have in the "Extras" folder of the GUI tool you downloaded earlier. You just have to put the "myfile.bin" and "myfilee.bin" files you downloaded as ZIP archive from links in "Get existing firmwares" in the same folder, and double click the "BOOT_LOADER_EXE.exe". Detailed instructions, including case where you compiled your firmware (an extra step and more tools from the "Software" dir in this repo is necessary, to pack .hex and .eep files as .bin. You will use "flash.bat" directly and only - it will fire up BOOT_LOADER_EXE by itself at the end), can be found on this repo wiki.

Close GUI, disconnect USB RevE, connect it back and fire the GUI up once again. Now you should be all set.

Commands reference will be useful if you want to check or get ready to set your RevE from a command line terminal. Also useful to set an emulated MIFARE as readonly. It is all here on this repo wiki. Just note that for any linked firmware in this issue, you must add "MY" at the end of each command. (i.e. commands names all end with "my"). If you compiled the firmware by yourself from this repo recently, you should not have the "my" suffix.

You will get some more beginners info from #36.

securechicken commented 5 years ago

If you happen to completely "brick" the device (it does not light at all anymore, but it still can be plugged and recognized as a ATxmega32A4u USB device), playing with compiled firmwares, dfu-programmer, and/or avrdude on all platforms, like I did and like you probably will:

iceman1001 commented 5 years ago

yup, the how-to guides that doesn't exist should have included this :) There is a german pdf version, but if you find time to make a Wiki entry that would be great.

If you want the latest version of the GUI, https://github.com/iceman1001/ChameleonMini-rebootedGUI

slurdge commented 5 years ago

@shinhub Thank you for the how-to guide. I have one question, did you buy the hardware on Lab401 or on other website ? Also, if you need help to put it in the wiki, I can help you (or if you're fine with it, edit it and put it for you).

securechicken commented 5 years ago

Would definitely fit in the Wiki, but was not quite sure it would fit any "editorial" standards first, and I do not know how to git (at all: commit, requests and so) + new to GitHub then. If it seems OK for you to start with that, and if I can edit Wiki without messing with the repo sources (it seems I just have to "edit" on the web page), then I will go with that! Do you want me to put it somewhere in particular, or do I go with like a "Getting started" page?

@slurdge yes bought on Lab401, but as far as I understand, there is a whole network of providers selling the same one ("ProxGrind" labelled).

iceman1001 commented 5 years ago

Here you go, just edit this page https://github.com/iceman1001/ChameleonMini-rebooted/wiki/Getting-started

I am also a fan of getting things done rather waiting until perfect.

securechicken commented 5 years ago

Great, I also messed with a Sidebar in an attempt to organize content. I think it helps with readability. If you don't like it you can simply remove it (flat pages list is still available). I will integrate this content.

securechicken commented 5 years ago

Done!