search

RfidResearchGroup / ChameleonUltra

The new generation chameleon based on NRF52840 makes the performance of card emulation more stable. And gave the chameleon the ability to read, write, and decrypt cards.
https://chameleonultra.com
GNU General Public License v3.0
867 stars 147 forks source link

Where is the Documentation / Basic User Guide #44

Closed GarethWright closed 1 year ago

GarethWright commented 1 year ago

Forgive me if I've overlooked something but there's no user guide or basic instructions on how to use it? Not even a description of what each button does?

GameTec-live commented 1 year ago

nope, none yet... for the buttons afaik theres some info in the indigogo description. Proper documentation is coming SoonTM

GarethWright commented 1 year ago

Yeah I read that. Updated to latest firmware but buttons just seem to cycle empty slots.

On Thu, 27 Jul 2023 at 14:41, GameTec-live @.***> wrote:

nope, none yet... for the buttons afaik theres some info in the indigogo description. Proper documentation is coming SoonTM

— Reply to this email directly, view it on GitHub https://github.com/RfidResearchGroup/ChameleonUltra/issues/44#issuecomment-1653653312, or unsubscribe https://github.com/notifications/unsubscribe-auth/AACMME7GRBROQS7ENUEETXTXSJVYLANCNFSM6AAAAAA22DKFKU . You are receiving this because you authored the thread.Message ID: @.***>

-- Kind regards

Gareth Wright

SieGoz commented 1 year ago

Hello, I have the same problem...

GameTec-live commented 1 year ago

to load something into the slot you need to use client software currently (please be pantient and understand that a lot of this is community driven and also the firmware as well as the client software are in early stages)...

For the client software there are more or less 2 options. The official CLI which supports all currently available functions (It can be found in this repo under the software folder and requires python, etc. watch icemans video on a good tutorial to building it) and my GUI. it works on android windows as well as linux but for example slot managment is still being worked on.

SieGoz commented 1 year ago

Ok thanks !

pl4nty commented 1 year ago

For the CLI, the following worked for me in WSL2 Ubuntu based on Iceman's video. If you're also using WSL2, make sure to attach the USB device and set permissions first.

Setup:

git clone https://github.com/RfidResearchGroup/ChameleonUltra
cd ChameleonUltra/software/src
mkdir build
cd build
cmake ..
cd ../../script
python3 -m pip install -r requirements.txt

Usage:

python3 chameleon_cli_main.py
hw connect
hw mode set -m e
hw slot openall

Select a slot with the physical buttons. A red LED will indicate the selected slot.

hf mf eload -f yourbin.bin
hf mf sim --sak [hex SAK] --atqa [hex ATQA] --uid [hex UID]

Now you can disconnect and use buttons to select the slot. The LED will be red when selected, and green after it's read.

GameTec-live commented 1 year ago

For the CLI, the following worked for me in WSL2 Ubuntu based on Iceman's video. If you're also using WSL2, make sure to attach the USB device and set permissions first.

Setup:

git clone https://github.com/RfidResearchGroup/ChameleonUltra
cd ChameleonUltra/software/src
mkdir build
cd build
cmake ..
cd ../../script
python3 -m pip install -r requirements.txt

Usage:

python3 chameleon_cli_main.py
hw connect
hw mode set -m e
hw slot openall

Select a slot with the physical buttons. A red LED will indicate the selected slot.

hf mf eload -t bin -f yourbin.bin
hf mf sim --sak [hex SAK] --atqa [hex ATQA] --uid [hex UID]

You can also use hf mf eload -t hex -f yourhex.eml for hex-encoded dumps.

Now you can disconnect and use buttons to select the slot. The LED will be red when selected, and green after it's read.

on the latest cli specifying the type when using eload isnt required. also: its strongly recommended to update the fw...

you can either use the gui for that or do hw dfu and then use nrfutil: 

nrfutil device program --firmware lite-dfu-app.zip --traitd nordicDfu
GibbilyGooo commented 1 year ago

I’m getting errors at the cmake .. command when using git bash. What do you suggest is the appropriate install for cmake?

Thank you

Sent from Proton Mail for iOS

On Sat, Jul 29, 2023 at 2:56 AM, GameTec-live @.***(mailto:On Sat, Jul 29, 2023 at 2:56 AM, GameTec-live < wrote:

For the CLI, the following worked for me in WSL2 Ubuntu based on Iceman's video. If you're also using WSL2, make sure to attach the USB device and set permissions first.

Setup:

git clone https://github.com/RfidResearchGroup/ChameleonUltra cd ChameleonUltra/software/src mkdir build cd build cmake .. cd ../../script python3 -m pip install -r requirements.txt

Usage:

python3 chameleon_cli_main.py hw connect hw mode set -m e hw slot openall

Select a slot with the physical buttons. A red LED will indicate the selected slot.

hf mf eload -t bin -f yourbin.bin hf mf sim --sak [hex SAK] --atqa [hex ATQA] --uid [hex UID]

You can also use hf mf eload -t hex -f yourhex.eml for hex-encoded dumps.

Now you can disconnect and use buttons to select the slot. The LED will be red when selected, and green after it's read.

on the latest cli specifying the type wheb using eload isnt required. also: its strongly recommended to update the fw...

you can either use the gui for that or do hw dfu and thn use nrfutil:

nrfutil device program --firmware lite-dfu-app.zip --traitd nordicDfu

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you are subscribed to this thread.Message ID: @.***>

pl4nty commented 1 year ago

@GameTec-live thanks for the eload tip, I've updated my comment. how is the firmware versioned? I'm running v1.0 at the moment, but the other releases seem to be rolling. not sure I want to run rolling-release firmware at the moment

GameTec-live commented 1 year ago

@GameTec-live thanks for the eload tip, I've updated my comment. how is the firmware versioned? I'm running v1.0 at the moment, but the other releases seem to be rolling. not sure I want to run rolling-release firmware at the moment

they arent versioned, because as you guessed, they are rolling... the factory fw is just old and has some bugs (same for v1 release) good news though, the chameleon is unbrickable, because unless you intentionally unlock it, the bootloader is read only...

GameTec-live commented 1 year ago

I’m getting errors at the cmake .. command when using git bash. What do you suggest is the appropriate install for cmake?

Thank you

Sent from Proton Mail for iOS

On Sat, Jul 29, 2023 at 2:56 AM, GameTec-live @.***(mailto:On Sat, Jul 29, 2023 at 2:56 AM, GameTec-live < wrote:

For the CLI, the following worked for me in WSL2 Ubuntu based on Iceman's video. If you're also using WSL2, make sure to attach the USB device and set permissions first.

Setup:

git clone https://github.com/RfidResearchGroup/ChameleonUltra cd ChameleonUltra/software/src mkdir build cd build cmake .. cd ../../script python3 -m pip install -r requirements.txt

Usage:

python3 chameleon_cli_main.py hw connect hw mode set -m e hw slot openall

Select a slot with the physical buttons. A red LED will indicate the selected slot.

hf mf eload -t bin -f yourbin.bin hf mf sim --sak [hex SAK] --atqa [hex ATQA] --uid [hex UID]

You can also use hf mf eload -t hex -f yourhex.eml for hex-encoded dumps.

Now you can disconnect and use buttons to select the slot. The LED will be red when selected, and green after it's read.

on the latest cli specifying the type wheb using eload isnt required. also: its strongly recommended to update the fw...

you can either use the gui for that or do hw dfu and thn use nrfutil:

nrfutil device program --firmware lite-dfu-app.zip --traitd nordicDfu

— Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you are subscribed to this thread.Message ID: @.***>

i recommend you use proxspace or wsl (as shown in video), proxspace has all tools already setup

konkeydong75 commented 1 year ago

Can the device read/emulate Paxton Net2 cards?

GarethWright commented 1 year ago

HW yes, Firmware not implemented yet.

On Tue, 1 Aug 2023 at 08:55, KN75 @.***> wrote:

Can the device read/emulate Paxton Net2 cards?

— Reply to this email directly, view it on GitHub https://github.com/RfidResearchGroup/ChameleonUltra/issues/44#issuecomment-1659765319, or unsubscribe https://github.com/notifications/unsubscribe-auth/AACMMEYAIZBYRAWK7WULKGLXTCY7BANCNFSM6AAAAAA22DKFKU . You are receiving this because you authored the thread.Message ID: @.***>

-- Kind regards

Gareth Wright

konkeydong75 commented 1 year ago

Perfect, many thanks @GarethWright

atkinchris commented 1 year ago

cmake ..

Depending on your setup, you might need to run make after running cmake .., to actually build the binaries for nested, etc.

ComicBit commented 1 year ago

Solid documentation is super important for any product, especially for the new folks trying to get into this. Without it, they might just get turned off. Right now, the product's documentation isn't even close to what Flipper Zero has. The Flipper is killing it with both their detailed guides and a kickass community. We're really missing out by not focusing on this. It's kinda frustrating to see honestly.

doegox commented 1 year ago

Agreed. But hard to document an early moving target with new or changed features every day. And a few million dollars difference. Will you be part of the kickass community and help documenting?

ComicBit commented 1 year ago

I feel like the project's at a point where we could at least start drafting a basic guide on how to use it. A few examples and maybe some guidance on expanding its capabilities would be great. Creating "app-like" modules for people that want to develop new attacks sounds cool, though I get we're not there just yet. The main aim should be to encourage more contributions. I'm up for helping with docs and building the community, but I need a clearer grasp on the tool. Right now, I'm struggling in the most basic things. About the budget, I'm with you. But if the Chameleon Ultra can outdo what Flipper can't because of its hardware, we might be onto something big and some viral video could bring also some cash. It'd be awesome to see this become the new standard in NFC/RFID testing.

xianglin1998 commented 1 year ago

This is indeed our negligence. Starting from next week, I will try my best to arrange time to complete some of the community's existing needs, and write product's documentation.

nuvious commented 1 year ago

Let me know if you need help on this issue. I just got mine today and am loving it. Happy to draft some Quickstart user guides.

GameTec-live commented 1 year ago

Okay, because noone is doing it, ima write guide for hw, fw, cli and gui...

ComicBit commented 1 year ago

I think we also need as part of this wiki how the device operates, which buttons to press and what does what, what's the bootloader mode etc. I was able to find for instance a reference on the fact that if you don't press the B button (i hope I remember that right) while pairing bluetooth, the device will refuse connection. I could find this only in some platform to purchase the device into the description

GameTec-live commented 1 year ago

@ComicBit My plan is to put all of that into the FW section 🤷