ChameleonMini

This is NOT the official repository of ChameleonMini, a freely programmable portable tool for NFC security analysis that can emulate and clone contactless cards, read RFID tags, and sniff/log RF data. This repository brings support for the Chameleon Tiny.

Our Project is based on the open-source project ChameleonMini RevG by Kasper & Oswald. They also have their own Webshop.

• Information:
  • Chameleon Tiny Site: Here
  • Chameleon BLE API: Here
  • Doxygen: Here
    • For viewing some of the documentation
    • Binaries: Here
    • Install: Here
  • Documentation (RfidResearchgroup):
    • Source: Here
      • Need to manually download and view
      • Open Doc/Doxyfile and then in application Show HTML Output
  • Documentation (emsec):
    • Doxygen: Here
    • Source: Here
• Tools:
  • Phone APP:
    • Android: Chameleon
      • The Android APP is currently NOT compatible with the official firmware
    • IOS: ChameleonTiny Manager
      • The IOS APP is currently NOT compatible with the official firmware
      • Credit to bettse
    • Password: e4g1
  • Optional GUI (Windows Only):
    • Windows: Here
    • Source: Here
  • Chameleon Firmware:
    • Compile the latest firmware: Here
      • Or use the precompiled: Here
    • The Chameleon Mini REV.G version uses the same firmware for both the Mini with Bluetooth version and Tiny
    • The hardware design of the RF part is exactly the same
    • The hardware is also compatible with the official firmware of the KAOS brothers
  • Terminal APP:
    • Putty or similar APP
  • DFU driver:
    • The DFU driver comes from ATMEL's official LIBUSB driver library
    • You can download it yourself or from the repo: Here
  • DFU Programmer:
    • Zip file from SourceForge: Here
• Resellers:
  • Our Asia & Oceania Reseller: Here
  • Our Europe Reseller: Here
  • Our US Reseller: Here
• Repository Structure:
  • Doc: A folder for doxygen documentation
  • Drivers: Chameleon drivers for Windows and Linux
  • Dumps: Dumps of different smartcards
  • Hardware: The layout and schematics of the PCB
  • Firmware: The complete firmware including a modified Atmel DFU bootloader and LUFA
  • Software: Contains a python tool for an easy configuration (and more) of the ChameleonMini
    • WARNING: This is currently under construction
  • RevE: Contains the entire contents of the discontinued RevE repository
  • RevE-light: Contains our development files for the RevE-light
    • WARNING: This is currently not supported / not functional

A. Upgrade to the latest firmware

A1. Upgrade Chameleon AVR Firmware

---

1. Obtain and Prepare Tools:

• Optional GUI (Windows Only)
• Terminal APP
• Firmware
• DFU Driver
• DFU Programmer

2. Create a Working Directory

1. Create a directory to work from
2. Place the Chameleon firmware in the directory
3. Unzip the DFU Programmer folder to the working directory
4. If you are using the auto install on Windows, place ChameleonFirmwareUpgrade.bat in the working directory as well

• Further information:
  • Here
  • emsec

3. Enter the Chameleon Direct Firmware Update (DFU) mode:

Method 1: GUI (Windows Only)

• Mini or Tiny:

  1. If it is a Chameleon Mini, ensure it is in the OFF position
  2. Connect it via USB cable to your computer
     • On the Mini, it may be a good idea to remove the battery before putting the device into DFU mode
  3. Under the Settings tab, Send the Upgrade command while the Chameleon is connected
     • This only puts the Chameleon in DFU mode
     • It does NOT start installing the firmware at all
  4. Chameleon should now be in DFU mode

• Further information:

  • emsec
  • Iceman GUI

Method 2: CLI

• Mini:

  1. With the Chameleon in the OFF state, press and hold the black (Rev E) or yellow (Rev G) button near the USB while inserting it into the USB port
     • It may be a good idea to remove the battery before putting the device into DFU mode
  2. Use your favorite terminal application to connect to it. Type upgrade and hit Enter
     • This only puts the Chameleon in DFU mode
     • It does NOT start installing the firmware at all
  3. Chameleon should now be in DFU mode

• Tiny:

  1. Press and hold the B button while inserting it into the USB port
  2. Use your favorite terminal application to connect to it. Type upgrade and hit Enter
     • This only puts the Chameleon in DFU mode
     • It does NOT start installing the firmware at all
  3. Chameleon should now be in DFU mode

• Further information: - Here - emsec

4. Install DFU Driver:

Windows

• Mini or Tiny:
  1. Download the drivers from the repo
  2. Ensure you have connected your Chameleon and that it is in DFU mode
  3. You should have an unknow USB device in device manager
  4. Update the device with the driver files from the repo
  5. You should now have an 'ATxmega*' device

5. Start Firmware Upgrade:

Method 1: Automatic (Windows Only)