diff --git a/README.md b/README.md index 4eaf1cd7..a5d32074 100644 --- a/README.md +++ b/README.md @@ -1,34 +1,83 @@ -# RFIDtools -RRG Android App for use with the following devices + +[img_pm3]: /githubsrc/rdv4x173.png +[img_nfc]: /githubsrc/phone_nfcx173.png +[img_122]: /githubsrc/acr122ux173.png +[img_cml]: /githubsrc/chameleonx173.png +[img_532]: /githubsrc/PN532x173.png +[link_download_google]: https://play.google.com/store/apps/details?id=com.rfidresearchgroup.rfidtools&hl=en_US -- Proxmark3 -- NFC Reader -- ACS ACR-122u -- Chameleon Mini -- PN532 +

+ RFID Tools +

-The app runs on a non-rooted phone. +

RFID Tools

+
-## APK download at Google playstore -You find the app on playstore [RRG RFID Tools](https://play.google.com/store/apps/details?id=com.rfidresearchgroup.rfidtools&hl=en_US) +

:boom:Devices:dash:

+ +

RRG Android App for use with the following devices

+ +|Proxmark3 |NFC Reader |ACS ACR-122u |Chameleon Mini |PN532 | +|----------- |----------- |------------- |--------------- |----------- | +| ![img_pm3] | ![img_nfc] | ![img_122] | ![img_cml] | ![img_532] | + +## Where to buy these devices? + +- www.sneaktechnology.com + +## Feature for application + +- (non-rooted) The app runs on a non-rooted phone. +- (mult device supported) has 5 device supported, More support in the future. +- (easy user interface) abstract ui action, implement all (MIREFA Classic) Tag read & write Simple operation. + +## Firmware for proxmark3 -## Special firmware To use your Proxmark3 RDV4 with blueshark via bluetooth with this app there is an extra step. Until some android issues is resolved with the RRG/Iceman repo you must use a special android adapted firmware with your Proxmark3 RDV4. Download and flash this one [Compiled FW 12 August](https://www.dropbox.com/s/416lsrqpr2lfeis/%5BCompiled%5DPM3-RRG-20190812.rar?dl=0) -## Where to buy these devices? -- www.sneaktechnology.com +## Where to download app? -## Developement tools +- Google playstore: [RRG RFID Tools][link_download_google] +- Download on this: [Click][link_download_google] (if have the apk) -## Core implementation +## Developement tools list + +- IDE: Android Studio 3.5 +- JRE: 1.8.0_202-release-1483-b03 amd64 +- JVM: OpenJDK 64-Bit Server VM by JetBrains s.r.o +- OS: Windows 10 10.0 +- SDK: MIN 18 -> MAX 29 +- ANDROID SDK Tools: 26.1.1 +- CMAKE: 3.10 +- NDK: 20.0.5594570 + +## App core implementation + +If you want to join our project, you must comply with the following development specifications to some extent, including macro architecture and micro implementation. Let's coding happy. :) + +- Communication implementation: using JNI mapping C & Java communication, encapsulating posix-compliant UART library, using Google API in the upper layer (Java) and posix-compliant UART in the lower layer (C/C+++). + +- Console program: Android defaults stdin, stdout, stderr to / dev / null, so the console program will not get normal output, we need to redirect them to the correct path, such as pointing to the file / sdcard / forward. stdxx, core: function freopen (), defined by C stdio. h, can redirect the standard stream. To local file. + +- Program architecture: DXL programming complies with MVP, the core architecture uses MVP to achieve layering, all the underlying data is placed in Model, all UI actions are placed in View, and all data calls are placed in Presenter. Module is used to realize resource management, reusable, and separate business can be placed in separate modules to reduce coupling and achieve reuse. Replacing concrete implementation with abstraction achieves the effects of extracting public implementation, abstracting private implementation, Interface-oriented and abstract programming, such as PN53X and mobile phone NFC read-write card use same UI, and information display. ## Maintainer + - DXL +Looking forward to your joining :) + ## Compability + These Android phones has been tested with + +- Redmi k20 pro (MIUI 10 & android 9) +- Redmi k20 (MIUI 10 & android 9) +- OnePlus 5T (H2OS 5.1.2 & Android 8.1.0) + +Welcome to add. :) diff --git a/githubsrc/PN532x173.png b/githubsrc/PN532x173.png new file mode 100644 index 00000000..60066653 Binary files /dev/null and b/githubsrc/PN532x173.png differ diff --git a/githubsrc/acr122ux173.png b/githubsrc/acr122ux173.png new file mode 100644 index 00000000..7b36d90b Binary files /dev/null and b/githubsrc/acr122ux173.png differ diff --git a/githubsrc/chameleonx173.png b/githubsrc/chameleonx173.png new file mode 100644 index 00000000..ba6d733a Binary files /dev/null and b/githubsrc/chameleonx173.png differ diff --git a/githubsrc/dxl.txt b/githubsrc/dxl.txt new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/githubsrc/dxl.txt @@ -0,0 +1 @@ + diff --git a/githubsrc/phone_nfcx173.png b/githubsrc/phone_nfcx173.png new file mode 100644 index 00000000..d95fc332 Binary files /dev/null and b/githubsrc/phone_nfcx173.png differ diff --git a/githubsrc/rdv4x173.png b/githubsrc/rdv4x173.png new file mode 100644 index 00000000..e7c7c938 Binary files /dev/null and b/githubsrc/rdv4x173.png differ diff --git a/githubsrc/rfidx100.png b/githubsrc/rfidx100.png new file mode 100644 index 00000000..f563786b Binary files /dev/null and b/githubsrc/rfidx100.png differ