V0.2.4

EM410x clone support
New project structure
2026-06-30 23:34:27 +08:00 · 2022-03-01 18:52:04 +08:00 · 2022-03-01 18:47:33 +08:00 · 2022-03-01 11:13:07 +08:00 · 2022-01-31 00:58:57 +08:00 · 2022-01-21 17:21:38 +08:00
94 changed files with 4166 additions and 1546 deletions
@@ -1,72 +1,2 @@
-# This file is used to ignore files which are generated
-# ----------------------------------------------------------------------------
-
-*~
-*.autosave
-*.a
-*.core
-*.moc
-*.o
-*.obj
-*.orig
-*.rej
-*.so
-*.so.*
-*_pch.h.cpp
-*_resource.rc
-.#*
-*.*#
-core
-!core/
-tags
-.DS_Store
-.directory
-*.debug
-Makefile*
-*.prl
-*.app
-moc_*.cpp
-ui_*.h
-qrc_*.cpp
-Thumbs.db
-*.res
-*.rc
-/.qmake.cache
-/.qmake.stash
-
-# qtcreator generated files
-*.pro.user*
-
-# xemacs temporary files
-*.flc
-
-# Vim temporary files
-.*.swp
-
-# Visual Studio generated files
-*.ib_pdb_index
-*.idb
-*.ilk
-*.pdb
-*.sln
-*.suo
-*.vcproj
-*vcproj.*.*.user
-*.ncb
-*.sdf
-*.opensdf
-*.vcxproj
-*vcxproj.*
-
-# MinGW generated files
-*.Debug
-*.Release
-
-# Python byte code
-*.pyc
-
-# Binaries
-# --------
-*.dll
-*.exe
-
+/build*
+/data
@@ -1,21 +1,504 @@
-MIT License
+                  GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 2.1, February 1999

-Copyright (c) 2020 wh201906
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.

-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]

-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+                            Preamble

-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+                  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+                            NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+           How to Apply These Terms to Your New Libraries
+
+  If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change.  You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms of the
+ordinary General Public License).
+
+  To apply these terms, attach the following notices to the library.  It is
+safest to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the library's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301
+    USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the library, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the
+  library `Frob' (a library for tweaking knobs) written by James Random
+  Hacker.
+
+  <signature of Ty Coon>, 1 April 1990
+  Ty Coon, President of Vice
+
+That's all there is to it!
@@ -3,7 +3,7 @@

 A cross-platform GUI for [Proxmark3](https://github.com/Proxmark/proxmark3) client

-[中文介绍](README/doc/README_zh_CN.md)
+[中文介绍](doc/README/README_zh_CN.md)

 ***

@@ -26,16 +26,16 @@ A cross-platform GUI for [Proxmark3](https://github.com/Proxmark/proxmark3) clie
 ***

 ## Preview
-![preview](README/img/preview.png)  
+![preview](doc/README/preview.png)  

-[more previews](README/doc/previews.md)  
+[more previews](doc/preview/previews.md)  

 ***

 ## About Iceman fork/repo

-The [Iceman fork/repo](https://github.com/RfidResearchGroup/proxmark3) has more powerful functions like offline sniff. These guys even developed a new hardware called Proxmark3 RDV4 with smart card support. But the official repo and the Iceman repo is not fully compatible.  
-This GUI is compatible with Iceman/RRG repo(tested on v4.9237)  
+The [Iceman fork/repo](https://github.com/RfidResearchGroup/proxmark3) has more powerful functions. These guys even developed a new hardware called Proxmark3 RDV4 with smart card support. But the official repo and the Iceman repo is not fully compatible.  
+This GUI is compatible with Iceman/RRG repo(tested on v4.13441)  

 ***

@@ -51,20 +51,42 @@ Great thanks to him.
 ## Build on Linux

    cd ~
-    git clone https://github.com/wh201906/Proxmark3GUI.git
+    sudo apt-get update
+    sudo apt-get install qt5-default libqt5serialport5 libqt5serialport5-dev 
+    git clone https://github.com/wh201906/Proxmark3GUI.git --depth=1
    cd Proxmark3GUI
-    mkdir build
-    cd build
-    qmake ../
-    make
-    make clean
-    cp -r ../lang ./
+    mkdir build && cd build
+    qmake ../src
+    make -j4 && make clean
+    cp -r ../config ./
    ./Proxmark3GUI

 ***
+## Tutorial
+
+[1.Quickstart](doc/tutorial/Quickstart/quickstart.md)  
+[2.Edit Mifare Classic data](doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data.md)(Proxmark3 hardware is not necessary)  
+***

 ## Update Log:

+### V0.2.4
+ Clone EM410x card to T55xx card  
+
+### V0.2.3
+ Fix bug [#27](https://github.com/wh201906/Proxmark3GUI/issues/27)
+ Try to support Non-ASCII path
+
+### V0.2.2
+ Load command format from external json file  
+ Fix bug [#20](https://github.com/wh201906/Proxmark3GUI/issues/20), [#21](https://github.com/wh201906/Proxmark3GUI/issues/21), [#22](https://github.com/wh201906/Proxmark3GUI/issues/22)  
+ Support Iceman/RRG repo v4.13441
+
+### V0.2.1
+ Optimize MIFARE Classic reading logic  
+ Fix bug [#16](https://github.com/wh201906/Proxmark3GUI/issues/16)  
+ Fix bug [#15](https://github.com/wh201906/Proxmark3GUI/issues/15) partially (the path can contain spaces now)  
+
 ### V0.2
 + Use Dock widget for more flexible layout  
 + Support basic LF commands  
@@ -1,20 +0,0 @@
-## Previews
-
-Raw Command:  
-![raw_command](../img/raw_command.gif) 
-
-Mifare Nested Attack:  
-![nested_attack](../img/mf_nested_attack.gif)  
-
-Mifare Load File:  
-![mf_loadfile](../img/mf_loadfile.gif)  
-
-Mifare Edit File:  
-![mf_editfile](../img/mf_editfile.gif)  
-
-Mifare Trailer Decoder:  
-![mf_trailer](../img/mf_trailer.gif)
-
-Dock Widget:  
-![dock1](../img/dock1.png)  
-![dock2](../img/dock2.png)  
@@ -0,0 +1,205 @@
+{
+    "//": "Based on Proxmark3 official repo v3.1.0, commit 6116334",
+    "//": "You can change this file if the command format of client changes",
+    "mifare classic": {
+        "nested": {
+            "cmd": "hf mf nested <card type> *",
+            "card type": {
+                "mini": "0",
+                "1k": "1",
+                "2k": "2",
+                "4k": "4"
+            },
+            "key pattern": "\\|\\s*\\d{3}\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|",
+            "key A index": 2,
+            "key B index": 4
+        },
+        "check": {
+            "cmd": "hf mf chk *<card type> ?",
+            "card type": {
+                "mini": "0",
+                "1k": "1",
+                "2k": "2",
+                "4k": "4"
+            },
+            "key pattern": "\\|\\s*\\d{3}\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|",
+            "key A index": 2,
+            "key B index": 3
+        },
+        "info": {
+            "cmd": "hf 14a info"
+        },
+        "sniff": {
+            "cmd": "hf mf sniff"
+        },
+        "sniff 14a": {
+            "cmd": "hf 14a snoop"
+        },
+        "list": {
+            "cmd": "hf list mf"
+        },
+        "dump": {
+            "cmd": "hf mf dump"
+        },
+        "restore": {
+            "cmd": "hf mf restore"
+        },
+        "emulator wipe": {
+            "cmd": "hf mf eclr"
+        },
+        "Magic Card wipe": {
+            "cmd": "hf mf cwipe <card type> f",
+            "card type": {
+                "mini": "0",
+                "1k": "1",
+                "2k": "2",
+                "4k": "4"
+            }
+        },
+        "emulator read block": {
+            "cmd": "hf mf eget <block>",
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "Magic Card read block": {
+            "cmd": "hf mf cgetblk <block>",
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "normal read block": {
+            "cmd": "hf mf rdbl <block> <key type> <key>",
+            "key type": {
+                "A": "A",
+                "B": "B"
+            },
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "darkside": {
+            "cmd": "hf mf mifare"
+        },
+        "save sniff": {
+            "cmd": "hf list mf -s <filename>"
+        },
+        "load sniff": {
+            "cmd": "hf list mf -l <filename>"
+        },
+        "hardnested": {
+            "cmd": "hf mf hardnested <known key block> <known key type> <known key> <target key block> <target key type>",
+            "known key type": {
+                "A": "A",
+                "B": "B"
+            },
+            "target key type": {
+                "A": "A",
+                "B": "B"
+            }
+        },
+        "normal read sector": {
+            "cmd": "hf mf rdsc <sector> <key type> <key>",
+            "key type": {
+                "A": "A",
+                "B": "B"
+            },
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "Magic Card read sector": {
+            "cmd": "hf mf cgetsc <sector>",
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "//": "When writing a block, if the result is not empty and doesn't contain the failed flag, the function will return true",
+        "normal write block": {
+            "cmd": "hf mf wrbl <block> <key type> <key> <data>",
+            "key type": {
+                "A": "A",
+                "B": "B"
+            },
+            "failed flag": [
+                "isOk:00"
+            ]
+        },
+        "Magic Card write block": {
+            "cmd": "hf mf csetblk <block> <data>",
+            "failed flag": [
+                "No chinese magic"
+            ]
+        },
+        "emulator write block": {
+            "cmd": "hf mf eset <block> <data>"
+        },
+        "Magic Card lock": {
+            "cmd": "hf 14a raw ",
+            "sequence": [
+                "-pa -b7 40",
+                "-pa 43",
+                "-pa E0 00 39 F7",
+                "-pa E1 00 E1 EE",
+                "-pa 85 00 00 00 00 00 00 00 00 00 00 00 00 00 00 08 18 47",
+                "-a 52"
+            ]
+        },
+        "Magic Card set parameter": {
+            "cmd": "hf mf csetuid <uid> <atqa> <sak>"
+        }
+    },
+    "lf": {
+        "read": {
+            "cmd": "lf read",
+            "show cmd": "data plot"
+        },
+        "sniff": {
+            "cmd": "lf snoop",
+            "show cmd": "data plot"
+        },
+        "search": {
+            "cmd": "lf search u"
+        },
+        "tune": {
+            "cmd": "hw tune l"
+        },
+        "get config": {
+            "cmd": "hw status",
+            "field start": "LF Sampling config:",
+            "field end": "USB Speed:",
+            "divisor": {
+                "flag": "divisor:",
+                "pattern": "\\d+"
+            },
+            "bits per sample": {
+                "flag": "bps:",
+                "pattern": "\\d+"
+            },
+            "decimation": {
+                "flag": "decimation:",
+                "pattern": "\\d+"
+            },
+            "averaging": {
+                "flag": "averaging:",
+                "pattern": "\\d+"
+            },
+            "trigger threshold": {
+                "flag": "trigger threshold:",
+                "pattern": "\\d+"
+            },
+            "samples to skip": {
+                "flag": "samples to skip:",
+                "pattern": "\\d+"
+            },
+            "//": "execute 'cmd' then find parameters between 'field stard' and 'field end'",
+            "//": "for each line, if the line doesn't have any flag, skip",
+            "//": "otherwise, delete characters before 'flag' and 'flag' itself, then use 'pattern' to get the parameter",
+            "//": "If 'replace' dict exists, replace all keys with respective values before getting parameters"
+        },
+        "set config": {
+            "cmd": "lf config q <divisor> b <bits per sample> d <decimation> a <averaging> t <trigger threshold> s <samples to skip>",
+            "divisor cmd": "hw setlfdivisor <divisor>"
+        }
+    },
+    "t55xx":{
+        "clone em410x":{
+            "read":"lf search",
+            "successful read flag":"Valid EM410x ID",
+            "pattern":"EM TAG ID\\s*:\\s\\K[0-9a-fA-F]{10}",
+            "clone cmd":"lf em 410xwrite <id> <type>",
+            "t5555 flag":"0",
+            "t55x7 flag":"1"
+        }
+    }
+}
@@ -0,0 +1,213 @@
+{
+    "//": "Based on Proxmark3 rrg repo v4.13441, commit 35ddebc",
+    "//": "You can change this file if the command format of client changes",
+    "mifare classic": {
+        "nested": {
+            "cmd": "hf mf nested --<card type> --blk <block> -<key type> -k <key>",
+            "static cmd": "hf mf staticnested --<card type> --blk <block> -<key type> -k <key>",
+            "card type": {
+                "mini": "mini",
+                "1k": "1k",
+                "2k": "2k",
+                "4k": "4k"
+            },
+            "key type": {
+                "A": "a",
+                "B": "b"
+            },
+            "key pattern": "\\|\\s*\\d{3}\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|",
+            "key A index": 2,
+            "key B index": 4
+        },
+        "check": {
+            "cmd": "hf mf chk --<card type>",
+            "card type": {
+                "mini": "mini",
+                "1k": "1k",
+                "2k": "2k",
+                "4k": "4k"
+            },
+            "key pattern": "\\|\\s*\\d{3}\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|\\s*.+?\\s*\\|",
+            "key A index": 2,
+            "key B index": 4
+        },
+        "info": {
+            "cmd": "hf 14a info"
+        },
+        "sniff": {
+            "cmd": "hf sniff"
+        },
+        "sniff 14a": {
+            "cmd": "hf 14a sniff"
+        },
+        "list": {
+            "cmd": "trace list -t mf"
+        },
+        "dump": {
+            "cmd": "hf mf dump"
+        },
+        "restore": {
+            "cmd": "hf mf restore"
+        },
+        "emulator wipe": {
+            "cmd": "hf mf eclr"
+        },
+        "Magic Card wipe": {
+            "cmd": "hf mf cwipe"
+        },
+        "emulator read block": {
+            "cmd": "hf mf egetblk --blk <block>",
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "Magic Card read block": {
+            "cmd": "hf mf cgetblk --blk <block>",
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "normal read block": {
+            "cmd": "hf mf rdbl --blk <block> -<key type> -k <key>",
+            "key type": {
+                "A": "a",
+                "B": "b"
+            },
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "darkside": {
+            "cmd": "hf mf darkside"
+        },
+        "save sniff": {
+            "cmd": "trace save -f <filename>"
+        },
+        "load sniff": {
+            "cmd": "trace load -f <filename>",
+            "show cmd": "trace list --buffer -t mf"
+        },
+        "hardnested": {
+            "cmd": "hf mf hardnested --blk <known key block> -<known key type> -k <known key> --tblk <target key block> --t<target key type>",
+            "known key type": {
+                "A": "a",
+                "B": "b"
+            },
+            "target key type": {
+                "A": "a",
+                "B": "b"
+            }
+        },
+        "normal read sector": {
+            "cmd": "hf mf rdsc --sec <sector> -<key type> -k <key>",
+            "key type": {
+                "A": "a",
+                "B": "b"
+            },
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "Magic Card read sector": {
+            "cmd": "hf mf cgetsc --sec <sector>",
+            "data pattern": "([0-9a-fA-F]{2} ){15}[0-9a-fA-F]{2}"
+        },
+        "//": "When writing a block, if the result is not empty and doesn't contain the failed flag, the function will return true",
+        "normal write block": {
+            "cmd": "hf mf wrbl --blk <block> -<key type> -k <key> -d <data>",
+            "key type": {
+                "A": "a",
+                "B": "b"
+            },
+            "failed flag": [
+                "fail",
+                "error"
+            ]
+        },
+        "Magic Card write block": {
+            "cmd": "hf mf csetblk --blk <block> -d <data>",
+            "failed flag": [
+                "fail",
+                "error"
+            ]
+        },
+        "emulator write block": {
+            "cmd": "hf mf esetblk --blk <block> -d <data>"
+        },
+        "Magic Card lock": {
+            "cmd": "hf 14a raw ",
+            "sequence": [
+                "-ak -b 7 40",
+                "-ak 43",
+                "-ak E0 00 39 F7",
+                "-ak E1 00 E1 EE",
+                "-ak 85 00 00 00 00 00 00 00 00 00 00 00 00 00 00 08 18 47",
+                "-a 52"
+            ]
+        },
+        "Magic Card set parameter": {
+            "cmd": "hf mf csetuid --uid <uid> --atqa <atqa> --sak <sak>"
+        }
+    },
+    "lf": {
+        "read": {
+            "cmd": "lf read -v",
+            "show cmd": "data plot"
+        },
+        "sniff": {
+            "cmd": "lf sniff -v",
+            "show cmd": "data plot"
+        },
+        "search": {
+            "cmd": "lf search -u"
+        },
+        "tune": {
+            "cmd": "lf tune --divisor <divisor>"
+        },
+        "get config": {
+            "cmd": "hw status",
+            "field start": "LF Sampling config",
+            "field end": "LF Sampling Stack",
+            "divisor": {
+                "flag": "divisor",
+                "pattern": "\\d+"
+            },
+            "bits per sample": {
+                "flag": "bits per sample",
+                "pattern": "\\d+"
+            },
+            "decimation": {
+                "flag": "decimation",
+                "pattern": "\\d+"
+            },
+            "averaging": {
+                "flag": "averaging",
+                "pattern": "\\d+",
+                "replace": {
+                    "yes": "1",
+                    "no": "0",
+                    "Yes": "1",
+                    "No": "0"
+                }
+            },
+            "trigger threshold": {
+                "flag": "trigger threshold",
+                "pattern": "\\d+"
+            },
+            "samples to skip": {
+                "flag": "samples to skip",
+                "pattern": "\\d+"
+            },
+            "//": "execute 'cmd' then find parameters between 'field stard' and 'field end'",
+            "//": "for each line, if the line doesn't have any flag, skip",
+            "//": "otherwise, delete characters before 'flag' and 'flag' itself, then use 'pattern' to get the parameter",
+            "//": "If 'replace' dict exists, replace all keys with respective values before getting parameters"
+        },
+        "set config": {
+            "cmd": "lf config --divisor <divisor> --bps <bits per sample> --dec <decimation> --avg <averaging> --trig <trigger threshold> --skip <samples to skip>",
+            "divisor cmd": "hw setlfdivisor -d <divisor>"
+        }
+    },
+    "t55xx":{
+        "clone em410x":{
+            "read":"lf em 410x reader",
+            "successful read flag":"EM 410x ID",
+            "pattern":"EM 410x ID\\s*\\K[0-9a-fA-F]{10}",
+            "clone cmd":"lf em 410x clone --id <id> <type>",
+            "t5555 flag":"--q5",
+            "t55x7 flag":""
+        }
+    }
+}
@@ -26,15 +26,15 @@
 ***

 ## 预览图
-![preview](../img/preview_zh_CN.png)  
+![preview](preview_zh_CN.png)  

- [更多预览](../doc/previews.md)  
+ [更多预览](../preview/previews.md)  

 ***

 ## 关于冰人版
 [冰人版](https://github.com/RfidResearchGroup/proxmark3)(Iceman/RRG)的客户端和固件更新更为激进，相比官方版具有更多的功能  
- 此GUI所有功能均兼容冰人版（在v4.9237上测试通过）  
+ 此GUI所有功能均兼容冰人版（在v4.13441上测试通过）  

 ***

@@ -50,20 +50,40 @@ release页面中有含客户端的GUI。这个GUI也可以搭配你自己的客
 ## 在Linux系统下编译

    cd ~
-    git clone https://github.com/wh201906/Proxmark3GUI.git
+    sudo apt-get update
+    sudo apt-get install qt5-default libqt5serialport5 libqt5serialport5-dev 
+    git clone https://github.com/wh201906/Proxmark3GUI.git --depth=1
    cd Proxmark3GUI
-    mkdir build
-    cd build
-    qmake ../
-    make
-    make clean
-    cp -r ../lang ./
+    mkdir build && cd build
+    qmake ../src
+    make -j4 && make clean
+    cp -r ../config ./
    ./Proxmark3GUI

 ***
-
+## 教程
+[1.快速上手](../tutorial/Quickstart/quickstart_zh_CN.md)  
+[2.编辑Mifare(IC)卡数据](../tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data_zh_CN.md)（无需PM3硬件）  
+***
 ## 更新日志:

+### V0.2.4
+ 复制EM410x卡（一种常见的低频ID卡）  
+
+### V0.2.3
+ 修复 [#27](https://github.com/wh201906/Proxmark3GUI/issues/27)
+ 尝试支持中文启动路径
+
+### V0.2.2
+ 从外部文件加载客户端命令格式  
+ 修复 [#20](https://github.com/wh201906/Proxmark3GUI/issues/20), [#21](https://github.com/wh201906/Proxmark3GUI/issues/21), [#22](https://github.com/wh201906/Proxmark3GUI/issues/22)  
+ 兼容冰人版客户端 v4.13441
+
+### V0.2.1
+ 优化MIFARE Classic读卡逻辑
+ 修复 [#16](https://github.com/wh201906/Proxmark3GUI/issues/16) （配合新版RRG固件时无法读取扇区数据）
+ 修复 [#15](https://github.com/wh201906/Proxmark3GUI/issues/15) （路径中支持空格）
+
 ### V0.2
 + 使用浮动窗口，界面配置更加灵活  
 + 支持部分低频命令  
@@ -0,0 +1,20 @@
+## Previews
+
+Raw Command:  
+![raw_command](raw_command.gif) 
+
+Mifare Nested Attack:  
+![nested_attack](mf_nested_attack.gif)  
+
+Mifare Load File:  
+![mf_loadfile](mf_loadfile.gif)  
+
+Mifare Edit File:  
+![mf_editfile](mf_editfile.gif)  
+
+Mifare Trailer Decoder:  
+![mf_trailer](mf_trailer.gif)
+
+Dock Widget:  
+![dock1](dock1.png)  
+![dock2](dock2.png)  
@@ -0,0 +1,50 @@
+# Edit Mifare Classic data
+
+[中文教程](Edit_Mifare_Classic_data_zh_CN.md)  
+This function is useful even if you don't use Proxmark3.  
+
+## About card type
+There are four sizes of Mifare Classic card  
+ 320Byte, also known as MINI, S20  
+ 1kB, also known as S50  
+ 2kB  
+ 4kB, alsow known as S70  
+
+Before any operation, you need to choose the right card type.   
+If you don't know your card type, you can try 1K first. Mifare Classic S50(1K) is the most common type.  
+![](cardtype.png)  
+
+## About file format
+This program supports binary data file and text data file.  
+Binary data files have the same size of chosen card type.(e.g, type 1K->1024KB data file).  
+The file extensions of them are always .dump or .bin.  
+You can edit them by hex editor or this program.  
+![](binary_file.png)  
+Text data files can be open by any text editors.  
+The file extensions of them are always .eml or .txt.  
+![](text_file.png)  
+
+## Load
+Go to "Mifare"->"File"->, choose "data" on the left and click "Load", then choose the file you want to load. The program will detect the file type by context.  
+![](load.png)  
+![](after_load.png)  
+Also, you can drag the file into data widget to load the data file.  
+![](drag.png)  
+
+## Edit
+Double click any data row to start edit  
+![](edit.png)  
+You don't need to fill the space between every byte.  
+![](edit_nospace.png)  
+
+## Save
+Go to "Mifare"->"File"->, choose "data" on the left and click "Save", then choose the path you want to save and the file format.  
+![](save.png)  
+
+## File format convert
+If you got a binary data file and you want to edit with notepad, here are the steps.
+ Load the orignal binary file
+ Save it as a text file
+ Edit the new file with whatever you want then save it
+ Load the edited file
+ Save it as binary file  
@@ -0,0 +1,51 @@
+# 编辑Mifare(IC)卡数据
+
+[English](Edit_Mifare_Classic_data.md)  
+此功能对没有PM3硬件的用户也很有用。  
+
+## 关于卡类型
+Mifare Classic卡有四种不同的容量  
+ 320字节，也被称作MINI卡，S20卡  
+ 1k字节，也被称为S50卡，最常见的型号  
+ 2k字节  
+ 4k字节，也被称为S70卡  
+
+在操作前，请先选择卡类型。  
+如果自己不清楚卡类型，可尝试选择1k卡，这是最常见的型号。  
+![](cardtype_zh_CN.png)  
+
+## 关于文件格式
+此程序支持二进制文件格式和文本文件格式。  
+二进制文件的大小和所选卡类型的大小完全相等，文件中的每一个字节对应卡片数据中的一个字节。  
+二进制文件的后缀名一般是.dump或.bin。
+此类文件需要使用16进制编辑器或者此程序来编辑。  
+![](binary_file.png)  
+文本文件可被任意文本编辑器打开。  
+此类文件的后缀名一般是.eml或.txt。  
+![](text_file.png)  
+
+## 加载文件
+在“Mifare”选项卡->“文件”框中勾选“数据”，点击“加载”按钮载入文件。  
+此程序会根据文件内容判断待加载的文件格式。  
+![](load.png)  
+![](after_load_zh_CN.png)  
+程序还支持拖拽加载。你可以直接把文件拖入左边数据显示器中。  
+![](drag_zh_CN.png)  
+
+## 编辑数据
+双击数据行即可开始编辑。  
+![](edit_zh_CN.png)  
+编辑过程中无需手动补全字节间空格。  
+![](edit_nospace_zh_CN.png)  
+
+## 保存文件
+在“Mifare”选项卡->“文件”框中勾选“数据”，点击“保存”按钮，选择保存的路径和文件格式即可保存文件。  
+![](save.png)  
+
+## 文件格式转换
+如果你想用其它文本编辑器编辑二进制文件，可以参考以下步骤
+ 加载原始二进制文件  
+ 保存为文本文件  
+ 用自己喜欢的文本编辑器编辑后保存  
+ 加载编辑后的文件  
+ 保存为二进制文件  
@@ -0,0 +1,45 @@
+# Quickstart
+
+[中文教程](quickstart_zh_CN.md)  
+***
+**On Windows**
+***
+## Use GUI with included client
+(1) Download the GUI with included client on [release](https://github.com/wh201906/Proxmark3GUI/releases) page  
+![](download_withclient.png)  
+
+(2) Extract the .7z file to a path. The target path should not contain non-ASCII characters  
+![](pm3guipath.png)  
+
+(3) Open Proxmark3GUI.exe in the GUI folder, then select the language and click "OK". Now you can use it  
+![](pm3gui.png)  
+![](language.png)  
+
+## Use the GUI with your own client
+(1) Download the standalone GUI on [release](https://github.com/wh201906/Proxmark3GUI/releases) page  
+![](download.png)  
+
+(2) Extract the .7z file to a path. The target path should not contain non-ASCII characters. Make sure the client path and the GUI path are different.  
+
+(3) Open the GUI. Input the client path in the "Client Path" editbox on the top of the main window.  
+![](pm3path.png)  
+
+(4) Go to "Settings" panel. Input the config file path which matching the client you use.  
+![](configpath.png)  
+
+(5) If setup.bat is required, input the script path in the "Preload script path" editbox.
+![](preloadpath.png)  
+
+(6) If using RRG/Iceman repo, input "-p \<port\> -f" in the "Start arguments" editbox.
+![](args.png)  
+
+***
+**On Linux**
+***
+(1) Build the GUI by following the instructions on [README](../../../README.md)  
+(2) Config the GUI with the same steps of "On Windows"->"Use the GUI with your own client"  
+(3) You might need to change "\<port\>" to "/dev/\<port\>" in "Settings"->"Start arguments" editbox  
+![](args_linux.png)  
+
+(4) If you are using Raspbian(Raspberry OS), you might need to check "Keep the client active even the PM3 hardware is disconnected." in the "Steeings" panel  
+![](keep.png)  
@@ -0,0 +1,49 @@
+# 快速上手
+
+[English](quickstart.md)  
+***
+**Windows用户**
+***
+## 使用包含客户端的版本
+(1) 直接下载[release](https://github.com/wh201906/Proxmark3GUI/releases)当中包含客户端的版本即可  
+![](download_withclient.png)  
+（例如Vx.x.x-win-Officialclient.7z或Vx.x.x-win-RRGclient.7z，前者为官方客户端，后者为冰人版/RRG客户端）  
+
+(2) 下载完成后将压缩包内所有内容解压到不含中文的路径当中  
+![](pm3guipath.png)  
+
+(3) 双击GUI目录下的Proxmark3GUI.exe，选择语言，点击OK，即可正常运行  
+![](pm3gui.png)  
+![](language_zh_CN.png)  
+***
+
+## 使用现有客户端
+(1) 下载[release](https://github.com/wh201906/Proxmark3GUI/releases)当中不包含客户端的版本  
+![](download.png)  
+
+(2) 解压到不含中文的路径当中  
+（注意，GUI所在目录和PM3客户端所在目录不能相同）  
+
+(3) 双击打开，选择语言，在顶端“客户端路径”当中填入proxmark3.exe的路径  
+![](pm3path_zh_CN.png)  
+
+(4) 进入“设置”面板，根据自己使用的客户端类型（官方版/冰人版）选择正确的配置文件  
+（./config/config_official.json或./config/config_rrgv4.13.json）  
+![](configpath_zh_CN.png)  
+
+(5) 若客户端启动时需要双击setup.bat启动，而setup.bat内会设置客户端运行时的环境变量，则需要在“预加载脚本路径”当中填入setup.bat的路径  
+![](preloadpath_zh_CN.png)  
+
+(6) 若使用的是冰人固件，则可能需要在“启动参数”当中填入“-p \<port\> -f”  
+![](args_zh_CN.png)  
+
+***
+**Linux用户**
+***
+(1) 参考[README](../../README/README_zh_CN.md)当中的编译步骤手动编译Proxmark3GUI  
+(2) 参考“Windows用户”->“使用现有客户端”的(2)~(6)步进行配置  
+(3) “设置”->“启动参数”当中可能需要将“\<port\>”改为“/dev/\<port\>”  
+![](args_linux_zh_CN.png)  
+
+(4) 若使用树莓派Raspbian系统且连接成功若干秒后PM3会自动断开，则需要在“设置”面板中勾选“在PM3断开后保持客户端运行”  
+![](keep_zh_CN.png)  
@@ -1,3 +0,0 @@
-[Languages]
-en_US=English
-zh_CN=简体中文
@@ -1,167 +0,0 @@
-#include "lf.h"
-
-const LF::Config LF::defaultConfig;
-
-LF::LF(Ui::MainWindow *ui, Util *addr, QWidget *parent): QObject(parent)
-{
-    this->parent = parent;
-    util = addr;
-    this->ui = ui;
-
-    configPattern = new QRegularExpression("(\\d+)|Yes|No");
-    currConfig = defaultConfig;
-}
-
-void LF::read()
-{
-    if(Util::getClientType() == Util::CLIENTTYPE_OFFICIAL)
-        util->execCMD("lf read");
-    else if(Util::getClientType() == Util::CLIENTTYPE_ICEMAN)
-        util->execCMD("lf read -v");
-    Util::gotoRawTab();
-    util->execCMD("data plot");
-}
-
-void LF::sniff()
-{
-    if(Util::getClientType() == Util::CLIENTTYPE_OFFICIAL)
-        util->execCMD("lf snoop");
-    else if(Util::getClientType() == Util::CLIENTTYPE_ICEMAN)
-        util->execCMD("lf sniff -v");
-    Util::gotoRawTab();
-    util->execCMD("data plot");
-}
-
-void LF::search()
-{
-    if(Util::getClientType() == Util::CLIENTTYPE_OFFICIAL)
-        util->execCMD("lf search u");
-    else if(Util::getClientType() == Util::CLIENTTYPE_ICEMAN)
-        util->execCMD("lf search -u");
-    Util::gotoRawTab();
-}
-
-void LF::tune()
-{
-    if(Util::getClientType() == Util::CLIENTTYPE_OFFICIAL)
-        util->execCMD("hw tune l");
-    else if(Util::getClientType() == Util::CLIENTTYPE_ICEMAN)
-        util->execCMD("lf tune --divisor " + QString::number(currConfig.divisor));
-    Util::gotoRawTab();
-}
-
-void LF::getConfig()
-{
-    QRegularExpressionMatch reMatch;
-    QString result;
-    QStringList resultList;
-    QStringList symbolList =
-    {
-        "divisor",
-        "bps",
-        "bits per sample",
-        "decimation",
-        "averaging",
-        "trigger threshold",
-        "samples to skip"
-    };
-    int offset;
-    QStringList configList = {"", "", "", "", "", "", ""};
-    result = util->execCMDWithOutput("hw status", 400); // not all output from "hw status will be processed".
-    result = result.right(result.length() - result.indexOf("LF Sampling config"));
-    offset = result.indexOf("samples to skip");
-    offset = result.indexOf("\r\n", offset);
-    result = result.mid(0, offset + 2);
-    qDebug() << "LF CONFIG GET\n" << result;
-    resultList = result.split("\r\n");
-    for(int i = 0; i < resultList.length(); i++)
-    {
-        for(int j = 0; j < symbolList.length(); j++)
-        {
-            if(!configList[j].isEmpty())
-                continue;
-            offset = resultList[i].indexOf(symbolList[j]);
-            if(offset != -1)
-            {
-                reMatch = configPattern->match(resultList[i]);
-                qDebug() << "finded: " << resultList[i];
-                if(!reMatch.hasMatch())
-                    continue;
-                qDebug() << "captured: " << reMatch.captured();
-                configList[j] = reMatch.captured();
-                break;
-            }
-        }
-    }
-    qDebug() << "configList: " << configList;
-    currConfig.divisor = configList[0].toUInt();
-    currConfig.decimation = configList[3].toUInt();
-    currConfig.triggerThreshold = configList[5].toUInt();
-    currConfig.samplesToSkip = configList[6].toUInt();
-    if(Util::getClientType() == Util::CLIENTTYPE_OFFICIAL)
-    {
-        currConfig.bitPerSample = configList[1].toUInt();
-        currConfig.averaging = (configList[4] == "1");
-    }
-    else if(Util::getClientType() == Util::CLIENTTYPE_ICEMAN)
-    {
-        currConfig.bitPerSample = configList[2].toUInt();
-        currConfig.averaging = (configList[4] == "Yes");
-    }
-    syncWithUI();
-}
-
-void LF::setConfig(LF::Config config)
-{
-    currConfig = config;
-    if(Util::getClientType() == Util::CLIENTTYPE_OFFICIAL)
-    {
-        util->execCMDWithOutput(QString("lf config")
-                                + " q " + QString::number(currConfig.divisor)
-                                + " b " + QString::number(currConfig.bitPerSample)
-                                + " d " + QString::number(currConfig.decimation)
-                                + " a " + QString(currConfig.averaging ? "1" : "0")
-                                + " t " + QString::number(currConfig.triggerThreshold)
-                                + " s " + QString::number(currConfig.samplesToSkip),
-                                500);
-        util->execCMDWithOutput("hw setlfdivisor " + QString::number(currConfig.divisor), 500);
-    }
-    else if(Util::getClientType() == Util::CLIENTTYPE_ICEMAN)
-    {
-        util->execCMDWithOutput(QString("lf config")
-                                + " -a " + QString(currConfig.averaging ? "1" : "0")
-                                + " -b " + QString::number(currConfig.bitPerSample)
-                                + " --dec " + QString::number(currConfig.decimation)
-                                + " --divisor " + QString::number(currConfig.divisor)
-                                + " -s " + QString::number(currConfig.samplesToSkip)
-                                + " -t " + QString::number(currConfig.triggerThreshold),
-                                500);
-        util->execCMDWithOutput("hw setlfdivisor -d " + QString::number(currConfig.divisor), 500);
-    }
-}
-
-void LF::resetConfig()
-{
-    setConfig(defaultConfig);
-    getConfig();
-}
-
-float LF::divisor2Freq(uint8_t divisor)
-{
-    return (12000.0 / (divisor + 1.0));
-}
-
-uint8_t LF::freq2Divisor(float freq)
-{
-    return ((uint16_t)(12000.0 / freq + 0.5) - 1); // uint16_t for (divisor + 1) = 256
-}
-
-void LF::syncWithUI()
-{
-    ui->LF_Conf_freqDivisorBox->setValue(currConfig.divisor); // will trigger valueChanged()
-    ui->LF_Conf_bitPerSampleBox->setValue(currConfig.bitPerSample);
-    ui->LF_Conf_decimationBox->setValue(currConfig.decimation);
-    ui->LF_Conf_averagingBox->setChecked(currConfig.averaging);
-    ui->LF_Conf_thresholdBox->setValue(currConfig.triggerThreshold);
-    ui->LF_Conf_skipsBox->setValue(currConfig.samplesToSkip);
-}
@@ -0,0 +1,72 @@
+# This file is used to ignore files which are generated
+# ----------------------------------------------------------------------------
+
+*~
+*.autosave
+*.a
+*.core
+*.moc
+*.o
+*.obj
+*.orig
+*.rej
+*.so
+*.so.*
+*_pch.h.cpp
+*_resource.rc
+.#*
+*.*#
+core
+!core/
+tags
+.DS_Store
+.directory
+*.debug
+Makefile*
+*.prl
+*.app
+moc_*.cpp
+ui_*.h
+qrc_*.cpp
+Thumbs.db
+*.res
+*.rc
+/.qmake.cache
+/.qmake.stash
+
+# qtcreator generated files
+*.pro.user*
+
+# xemacs temporary files
+*.flc
+
+# Vim temporary files
+.*.swp
+
+# Visual Studio generated files
+*.ib_pdb_index
+*.idb
+*.ilk
+*.pdb
+*.sln
+*.suo
+*.vcproj
+*vcproj.*.*.user
+*.ncb
+*.sdf
+*.opensdf
+*.vcxproj
+*vcxproj.*
+
+# MinGW generated files
+*.Debug
+*.Release
+
+# Python byte code
+*.pyc
+
+# Binaries
+# --------
+*.dll
+*.exe
+
@@ -22,6 +22,7 @@ SOURCES += \
    common/util.cpp \
    module/lf.cpp \
    module/mifare.cpp \
+    module/t55xxtab.cpp \
    ui/mf_trailerdecoderdialog.cpp \
    ui/mf_sim_simdialog.cpp \
    ui/mf_uid_parameterdialog.cpp \
@@ -34,6 +35,7 @@ HEADERS += \
    common/util.h \
    module/lf.h \
    module/mifare.h \
+    module/t55xxtab.h \
    ui/mf_trailerdecoderdialog.h \
    ui/mf_sim_simdialog.h \
    ui/mf_uid_parameterdialog.h \
@@ -41,6 +43,7 @@ HEADERS += \
    ui/mf_attack_hardnesteddialog.h \

 FORMS += \
+    ui/t55xxtab.ui \
    ui/mf_trailerdecoderdialog.ui \
    ui/mf_sim_simdialog.ui \
    ui/mf_uid_parameterdialog.ui \
@@ -48,15 +51,18 @@ FORMS += \
    ui/mf_attack_hardnesteddialog.ui

 TRANSLATIONS += \
-    lang/zh_CN.ts \
-    lang/en_US.ts
+    i18n/zh_CN.ts \
+    i18n/en_US.ts

 # Default rules for deployment.
 qnx: target.path = /tmp/$${TARGET}/bin
 else: unix:!android: target.path = /opt/$${TARGET}/bin
 !isEmpty(target.path): INSTALLS += target

-VERSION = 0.2.0
+VERSION = 0.2.4
 QMAKE_TARGET_PRODUCT = "Proxmark3GUI"
 QMAKE_TARGET_DESCRIPTION = "Proxmark3GUI"
 QMAKE_TARGET_COMPANY = "wh201906"
+
+RESOURCES += \
+    i18n/language.qrc
@@ -26,7 +26,7 @@ void PM3Process::connectPM3(const QString& path, const QStringList args)
    currArgs = args;

    // using "-f" option to make the client output flushed after every print.
-    start(path, args, QProcess::Unbuffered | QProcess::ReadWrite);
+    start(path, args, QProcess::Unbuffered | QProcess::ReadWrite | QProcess::Text);
    if(waitForStarted(10000))
    {
        waitForReadyRead(10000);
@@ -36,11 +36,13 @@ void PM3Process::connectPM3(const QString& path, const QStringList args)
        {
            clientType = Util::CLIENTTYPE_ICEMAN;
            setRequiringOutput(true);
-            write("hw version\r\n");
-            for(int i = 0; i < 10; i++)
+            write("hw version\n");
+            for(int i = 0; i < 50; i++)
            {
                waitForReadyRead(200);
                result += *requiredOutput;
+                if(result.indexOf("os: ") != -1)
+                    break;
            }
            setRequiringOutput(false);
        }
@@ -52,8 +54,8 @@ void PM3Process::connectPM3(const QString& path, const QStringList args)
        {
            emit changeClientType(clientType);
            result = result.mid(result.indexOf("os: "));
-            result = result.left(result.indexOf("\r\n"));
-            result = result.mid(3, result.lastIndexOf(" ") - 3);
+            result = result.left(result.indexOf("\n"));
+            result = result.mid(4, result.indexOf(" ", 4) - 4);
            emit PM3StatedChanged(true, result);
        }
        else
@@ -105,6 +107,10 @@ void PM3Process::setSerialListener(bool state)

 void PM3Process::onTimeout() //when the proxmark3 client is unexpectedly terminated or the PM3 hardware is removed, the isBusy() will return false(only tested on Windows);
 {
+//    isBusy() is a deprecated function because it will block the serial port when the port is not in use.
+//    However, the PM3 client is supposed to use the target serial port exclusively, so it should be fine
+//    isBusy() will always return false on Raspbian, in this case, check "Keep the client active" in the Settings panel.
+//
 //    qDebug()<<portInfo->isBusy();
    if(!portInfo->isBusy())
    {
@@ -31,10 +31,10 @@ void Util::execCMD(const QString& cmd)
 {
    qDebug() << "executing: " << cmd;
    if(isRunning)
-        emit write(cmd + "\r\n");
+        emit write(cmd + "\n");
 }

-QString Util::execCMDWithOutput(const QString& cmd, ReturnTrigger trigger)
+QString Util::execCMDWithOutput(const QString& cmd, ReturnTrigger trigger, bool rawOutput)
 {
    // if the trigger is empty, this function will wait trigger.waitTime then return all outputs during the wait time.
    // otherwise, this function will return empty string if no trigger is detected, or return outputs if any trigger is detected.
@@ -78,7 +78,13 @@ QString Util::execCMDWithOutput(const QString& cmd, ReturnTrigger trigger)
        }
    }
    isRequiringOutput = false;
-    return (isResultFound || trigger.expectedOutputs.isEmpty() ? *requiredOutput : "");
+
+    // For functions without expected outputs in the return trigger, the result is the raw output.
+    // For functions with expected outputs in the return trigger,
+    // if rawOutput=true, the result is the raw output,
+    // otherwise, if the raw output contains one of the expected outputs, the result is the raw output,
+    // otherwise, the result is empty(as a failed flag).
+    return (trigger.expectedOutputs.isEmpty() || isResultFound || rawOutput ? *requiredOutput : "");
 }

 void Util::delay(unsigned int msec)
@@ -106,7 +112,7 @@ void Util::setRunningState(bool st)
 bool Util::chooseLanguage(QSettings* guiSettings, QMainWindow* window)
 {
    // make sure the GUISettings is not in any group
-    QSettings* langSettings = new QSettings("lang/languages.ini", QSettings::IniFormat);
+    QSettings* langSettings = new QSettings(":/i18n/languages.ini", QSettings::IniFormat);
    QMap<QString, QString> langMap;
    langSettings->setIniCodec("UTF-8");
    langSettings->beginGroup("Languages");
@@ -53,7 +53,7 @@ public:
    explicit Util(QObject *parent = nullptr);

    void execCMD(const QString& cmd);
-    QString execCMDWithOutput(const QString& cmd, ReturnTrigger trigger = 10000);
+    QString execCMDWithOutput(const QString& cmd, ReturnTrigger trigger = 10000, bool rawOutput = false);
    void delay(unsigned int msec);
    static ClientType getClientType();
    static int rawTabIndex;
@@ -0,0 +1,7 @@
+<RCC>
+    <qresource prefix="/i18n">
+        <file>en_US.qm</file>
+        <file>languages.ini</file>
+        <file>zh_CN.qm</file>
+    </qresource>
+</RCC>
@@ -0,0 +1,4 @@
+[Languages]
+en_US=English
+zh_CN=简体中文
+ext=Load from external file
@@ -1,53 +1,63 @@
-#include "ui/mainwindow.h"
-
-#include <QApplication>
-#include <QSettings>
-#include <QTranslator>
-#include <QMessageBox>
-#include <QTextCodec>
-
-int main(int argc, char *argv[])
-{
-    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
-    QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));
-    QApplication a(argc, argv);
-    MainWindow w;
-
-    QSettings* settings = new QSettings("GUIsettings.ini", QSettings::IniFormat);
-    settings->setIniCodec("UTF-8");
-    settings->beginGroup("lang");
-    QString currLang = settings->value("language", "").toString();
-    settings->endGroup();
-    if(currLang == "")
-    {
-        if(Util::chooseLanguage(settings, &w))
-        {
-            settings->beginGroup("lang");
-            currLang = settings->value("language", "").toString();
-            settings->endGroup();
-        }
-        else
-            currLang = "en_US";
-    }
-    currLang = "lang/" + currLang;
-#ifdef Q_OS_WIN
-    currLang += ".qm";
-#else
-    currLang += ".ts";;
-#endif
-    QTranslator* translator = new QTranslator(&w);
-    if(translator->load(currLang))
-    {
-        a.installTranslator(translator);
-    }
-    else
-    {
-        QMessageBox::information(&w, "Error", "Can't load " + currLang + " as translation file.");
-    }
-    delete settings;
-    w.initUI();
-    w.show();
-    return a.exec();
-}
-
-
+#include "ui/mainwindow.h"
+
+#include <QApplication>
+#include <QSettings>
+#include <QTranslator>
+#include <QMessageBox>
+#include <QTextCodec>
+#include <QDir>
+
+int main(int argc, char *argv[])
+{
+    // A trick to handle non-ascii path
+    // The application cannot find the plugins when the path contains non ascii characters.
+    // However, the plugins will be load after creating MainWindow(or QApplication?).
+    // QDir will handle the path correctly.
+    QDir* pluginDir = new QDir;
+    if(pluginDir->cd("plugins")) // has plugins folder
+    {
+        qputenv("QT_PLUGIN_PATH", pluginDir->absolutePath().toLocal8Bit());
+    }
+    delete pluginDir;
+
+    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
+    QTextCodec::setCodecForLocale(QTextCodec::codecForName("UTF-8"));
+    QApplication a(argc, argv);
+    MainWindow w;
+
+    QSettings* settings = new QSettings("GUIsettings.ini", QSettings::IniFormat);
+    settings->setIniCodec("UTF-8");
+    settings->beginGroup("lang");
+    QString currLang = settings->value("language", "").toString();
+    settings->endGroup();
+    if(currLang == "")
+    {
+        if(Util::chooseLanguage(settings, &w))
+        {
+            settings->beginGroup("lang");
+            currLang = settings->value("language", "").toString();
+            settings->endGroup();
+        }
+        else
+            currLang = "en_US";
+    }
+    if(currLang == "ext")
+        currLang = QFileDialog::getOpenFileName(nullptr, "Select the translation file:");
+    else
+        currLang = ":/i18n/" + currLang + ".qm";
+    QTranslator* translator = new QTranslator(&w);
+    if(translator->load(currLang))
+    {
+        a.installTranslator(translator);
+    }
+    else
+    {
+        QMessageBox::information(&w, "Error", "Can't load " + currLang + " as translation file.");
+    }
+    delete settings;
+    w.initUI();
+    w.show();
+    return a.exec();
+}
+
+
@@ -0,0 +1,157 @@
+#include "lf.h"
+#include <QJsonArray>
+
+const LF::LFConfig LF::defaultLFConfig;
+
+LF::LF(Ui::MainWindow *ui, Util *addr, QWidget *parent): QObject(parent)
+{
+    this->parent = parent;
+    util = addr;
+    this->ui = ui;
+
+    LFconfigPattern = new QRegularExpression("(\\d+)|Yes|No");
+    currLFConfig = defaultLFConfig;
+}
+
+void LF::read()
+{
+    QVariantMap config = configMap["read"].toMap();
+    util->execCMD(config["cmd"].toString());
+    Util::gotoRawTab();
+    util->execCMD(config["show cmd"].toString());
+}
+
+void LF::sniff()
+{
+    QVariantMap config = configMap["sniff"].toMap();
+    util->execCMD(config["cmd"].toString());
+    Util::gotoRawTab();
+    util->execCMD(config["show cmd"].toString());
+}
+
+void LF::search()
+{
+    QVariantMap config = configMap["search"].toMap();
+    util->execCMD(config["cmd"].toString());
+    Util::gotoRawTab();
+}
+
+void LF::tune()
+{
+    QVariantMap config = configMap["tune"].toMap();
+    QString cmd = config["cmd"].toString();
+    cmd.replace("<divisor>", QString::number(currLFConfig.divisor));
+    util->execCMD(cmd);
+    Util::gotoRawTab();
+}
+
+bool LF::getLFConfig_helper(const QVariantMap& map, QString& str, int* result)
+{
+    int len;
+    QString flag = map["flag"].toString();
+    QRegularExpressionMatch reMatch;
+    if(!str.contains(flag))
+        return false;
+    len = str.length() - (str.indexOf(flag) + flag.length());
+    str = str.right(len);
+    if(map.contains("replace"))
+    {
+        QVariantMap table = map["replace"].toMap();
+        for(auto it = table.begin(); it != table.end(); it++)
+        {
+            str.replace(it.key(), it.value().toString());
+        }
+    }
+    reMatch = QRegularExpression(map["pattern"].toString()).match(str);
+    if(!reMatch.hasMatch())
+        return false;
+    *result = reMatch.captured().toInt();
+    qDebug() << *result;
+    return true;
+
+}
+
+void LF::getLFConfig()
+{
+
+    QRegularExpressionMatch reMatch;
+    QString result;
+    QStringList resultList;
+    int start, end, temp;
+    QVariantMap config = configMap["get config"].toMap();
+    QString cmd = config["cmd"].toString();
+    result = util->execCMDWithOutput(cmd, 400);
+    start = result.indexOf(config["field start"].toString());
+    end = result.indexOf(config["field end"].toString());
+    result = result.mid(start, end - start);
+#if (QT_VERSION <= QT_VERSION_CHECK(5,14,0))
+    resultList = result.split("\n", QString::SkipEmptyParts);
+#else
+    resultList = result.split("\n", Qt::SkipEmptyParts);
+#endif
+    qDebug() << "LF CONFIG GET\n" << resultList;
+    for(auto it = resultList.begin(); it != resultList.end(); it++)
+    {
+        if(getLFConfig_helper(config["divisor"].toMap(), *it, &temp))
+            currLFConfig.divisor = temp;
+        else if(getLFConfig_helper(config["bits per sample"].toMap(), *it, &temp))
+            currLFConfig.bitsPerSample = temp;
+        else if(getLFConfig_helper(config["decimation"].toMap(), *it, &temp))
+            currLFConfig.decimation = temp;
+        else if(getLFConfig_helper(config["averaging"].toMap(), *it, &temp))
+            currLFConfig.averaging = (bool)temp;
+        else if(getLFConfig_helper(config["trigger threshold"].toMap(), *it, &temp))
+            currLFConfig.triggerThreshold = temp;
+        else if(getLFConfig_helper(config["samples to skip"].toMap(), *it, &temp))
+            currLFConfig.samplesToSkip = temp;
+    }
+    syncWithUI();
+}
+
+void LF::setLFConfig(LF::LFConfig lfconfig)
+{
+    currLFConfig = lfconfig;
+    QVariantMap config = configMap["set config"].toMap();
+    QString cmd = config["cmd"].toString();
+    cmd.replace("<divisor>", QString::number(currLFConfig.divisor));
+    cmd.replace("<bits per sample>", QString::number(currLFConfig.bitsPerSample));
+    cmd.replace("<decimation>", QString::number(currLFConfig.decimation));
+    cmd.replace("<averaging>", currLFConfig.averaging ? "1" : "0");
+    cmd.replace("<trigger threshold>", QString::number(currLFConfig.triggerThreshold));
+    cmd.replace("<samples to skip>", QString::number(currLFConfig.samplesToSkip));
+    util->execCMDWithOutput(cmd, 500);
+    cmd = config["divisor cmd"].toString();
+    cmd.replace("<divisor>", QString::number(currLFConfig.divisor));
+    util->execCMDWithOutput(cmd, 500);
+}
+
+void LF::resetLFConfig()
+{
+    setLFConfig(defaultLFConfig);
+    getLFConfig();
+}
+
+float LF::divisor2Freq(uint8_t divisor)
+{
+    return (12000.0 / (divisor + 1.0));
+}
+
+uint8_t LF::freq2Divisor(float freq)
+{
+    return ((uint16_t)(12000.0 / freq + 0.5) - 1); // uint16_t for (divisor + 1) = 256
+}
+
+void LF::syncWithUI()
+{
+    ui->LF_LFConf_freqDivisorBox->setValue(currLFConfig.divisor); // will trigger valueChanged()
+    ui->LF_LFConf_bitsPerSampleBox->setValue(currLFConfig.bitsPerSample);
+    ui->LF_LFConf_decimationBox->setValue(currLFConfig.decimation);
+    ui->LF_LFConf_averagingBox->setChecked(currLFConfig.averaging);
+    ui->LF_LFConf_thresholdBox->setValue(currLFConfig.triggerThreshold);
+    ui->LF_LFConf_skipsBox->setValue(currLFConfig.samplesToSkip);
+}
+
+void LF::setConfigMap(const QVariantMap& configMap)
+{
+    this->configMap = configMap;
+}
@@ -12,17 +12,17 @@ class LF : public QObject
 public:
    explicit LF(Ui::MainWindow *ui, Util *addr, QWidget *parent = nullptr);

-    struct Config
+    struct LFConfig
    {
        uint8_t divisor;
-        uint8_t bitPerSample;
+        uint8_t bitsPerSample;
        uint8_t decimation;
        bool averaging;
        uint8_t triggerThreshold;
        uint16_t samplesToSkip;
    };

-    static constexpr Config defaultConfig =
+    static constexpr LFConfig defaultLFConfig =
    {
        95,
        8,
@@ -36,19 +36,22 @@ public:
    void sniff();
    void search();
    void tune();
-    void getConfig();
-    void setConfig(LF::Config config);
-    void resetConfig();
+    void getLFConfig();
+    void setLFConfig(LF::LFConfig lfconfig);
+    void resetLFConfig();
    static float divisor2Freq(uint8_t divisor);
    static uint8_t freq2Divisor(float freq);

+    void setConfigMap(const QVariantMap &configMap);
 private:
    QWidget* parent;
    Ui::MainWindow *ui;
    Util* util;
-    Config currConfig;
-    QRegularExpression* configPattern;
+    LFConfig currLFConfig;
+    QRegularExpression* LFconfigPattern;
+    QVariantMap configMap;
    void syncWithUI();
+    bool getLFConfig_helper(const QVariantMap& map, QString& str, int* result);
 signals:

 };
@@ -11,6 +11,7 @@
 #include <QStringList>
 #include <QRegularExpression>
 #include <QMessageBox>
+#include <QJsonObject>
 class Mifare : public QObject
 {
    Q_OBJECT
@@ -64,9 +65,9 @@ public:
    static const AccessType trailerReadCondition[8][3];
    static const AccessType trailerWriteCondition[8][3];

-    QString info(bool isRequiringOutput = false);
+    QMap<QString, QString> info(bool isRequiringOutput = false);
    void chk();
-    void nested();
+    void nested(bool isStaticNested = false);
    void darkside();
    void hardnested();
    void sniff();
@@ -112,6 +113,8 @@ public:
    static int data_b2s(int block);
    static bool data_isACBitsValid(const QString& text, QList<quint8> *returnHalfBytes = nullptr);
    QString data_getUID();
+    quint16 getTrailerBlockId(quint8 sectorId, qint8 cardTypeId = -1); // -1: use current cardtype
+    void setConfigMap(const QVariantMap& configMap);
 public slots:
 signals:

@@ -120,6 +123,8 @@ private:
    Ui::MainWindow *ui;
    Util* util;

+    QVariantMap configMap;
+
    QStringList* keyAList;
    QStringList* keyBList;
    QStringList* dataList;
@@ -0,0 +1,68 @@
+#include "t55xxtab.h"
+#include "ui_t55xxtab.h"
+
+T55xxTab::T55xxTab(Util *addr, QWidget *parent) :
+    QWidget(parent),
+    ui(new Ui::T55xxTab)
+{
+    ui->setupUi(this);
+    util = addr;
+}
+
+T55xxTab::~T55xxTab()
+{
+    delete ui;
+}
+
+void T55xxTab::setConfigMap(const QVariantMap &configMap)
+{
+    this->configMap = configMap;
+}
+
+void T55xxTab::setGUIState(bool st)
+{
+    ui->cloneGroupBox->setEnabled(st);
+    emit setParentGUIState(st);
+}
+
+void T55xxTab::on_Clone_EM410xReadButton_clicked()
+{
+    setGUIState(false);
+
+    QVariantMap config = configMap["clone em410x"].toMap();
+    QString result;
+    QRegularExpressionMatch reMatch;
+
+    result = util->execCMDWithOutput(
+                 config["read"].toString(),
+                 Util::ReturnTrigger(6000, {config["successful read flag"].toString()}));
+    if(result.isEmpty())
+    {
+        setGUIState(true);
+        return;
+    }
+    reMatch = QRegularExpression(config["pattern"].toString()).match(result);
+    ui->Clone_EM410xIDEdit->setText(reMatch.captured());
+
+    setGUIState(true);
+}
+
+void T55xxTab::on_Clone_EM410xCloneButton_clicked()
+{
+    if(ui->Clone_EM410xIDEdit->text().isEmpty())
+        return;
+    setGUIState(false);
+
+    QVariantMap config = configMap["clone em410x"].toMap();
+    QString cmd = config["clone cmd"].toString();
+    cmd.replace("<id>", ui->Clone_EM410xIDEdit->text());
+    if(ui->Clone_T5555Button->isChecked())
+        cmd.replace("<type>", config["t5555 flag"].toString());
+    else
+        cmd.replace("<type>", config["t55x7 flag"].toString());
+    util->execCMD(cmd);
+    Util::gotoRawTab();
+
+    setGUIState(true);
+}
+
@@ -0,0 +1,36 @@
+#ifndef T55XXTAB_H
+#define T55XXTAB_H
+
+#include "common/util.h"
+#include <QWidget>
+
+namespace Ui
+{
+class T55xxTab;
+}
+
+class T55xxTab : public QWidget
+{
+    Q_OBJECT
+
+public:
+    explicit T55xxTab(Util *addr, QWidget *parent = nullptr);
+    ~T55xxTab();
+
+    void setConfigMap(const QVariantMap& configMap);
+private slots:
+    void on_Clone_EM410xReadButton_clicked();
+
+    void on_Clone_EM410xCloneButton_clicked();
+
+private:
+    Ui::T55xxTab *ui;
+    Util* util;
+    QVariantMap configMap;
+
+    void setGUIState(bool st);
+signals:
+    void setParentGUIState(bool st);
+};
+
+#endif // T55XXTAB_H
@@ -1,6 +1,8 @@
 #include "mainwindow.h"
 #include "ui_mainwindow.h"

+#include <QJsonDocument>
+
 MainWindow::MainWindow(QWidget *parent):
    QMainWindow(parent)
    , ui(new Ui::MainWindow)
@@ -37,13 +39,16 @@ MainWindow::MainWindow(QWidget *parent):
    Util::setUI(ui);
    mifare = new Mifare(ui, util, this);
    lf = new LF(ui, util, this);
+    t55xxTab = new T55xxTab(util);
+    connect(t55xxTab, &T55xxTab::setParentGUIState, this, &MainWindow::setState);
+    ui->funcTab->insertTab(2, t55xxTab, tr("T55xx"));

    keyEventFilter = new MyEventFilter(QEvent::KeyPress);
    resizeEventFilter = new MyEventFilter(QEvent::Resize);

    // hide unused tabs
 //    ui->funcTab->removeTab(1);
-    ui->funcTab->removeTab(2);
+    ui->funcTab->removeTab(3);

    portSearchTimer = new QTimer(this);
    portSearchTimer->setInterval(2000);
@@ -70,6 +75,22 @@ MainWindow::~MainWindow()
    delete pm3Thread;
 }

+void MainWindow::loadConfig()
+{
+    QFile configList(ui->Set_Client_configPathEdit->text());
+    if(!configList.open(QFile::ReadOnly | QFile::Text))
+    {
+        QMessageBox::information(this, tr("Info"), tr("Failed to load config file"));
+        return;
+    }
+
+    QByteArray configData = configList.readAll();
+    QJsonDocument configJson(QJsonDocument::fromJson(configData));
+    mifare->setConfigMap(configJson.object()["mifare classic"].toObject().toVariantMap());
+    lf->setConfigMap(configJson.object()["lf"].toObject().toVariantMap());
+    t55xxTab->setConfigMap(configJson.object()["t55xx"].toObject().toVariantMap());
+}
+
 void MainWindow::initUI() // will be called by main.app
 {
    ui->retranslateUi(this);
@@ -108,7 +129,7 @@ void MainWindow::on_PM3_connectButton_clicked()
    // on RRG repo, if no port is specified, the client will search the available port
    if(port == "" && startArgs.contains("<port>")) // has <port>, no port
    {
-        QMessageBox::information(NULL, tr("Info"), tr("Plz choose a port first"), QMessageBox::Ok);
+        QMessageBox::information(this, tr("Info"), tr("Plz choose a port first"), QMessageBox::Ok);
        return;
    }

@@ -123,20 +144,36 @@ void MainWindow::on_PM3_connectButton_clicked()
    if(envScriptPath.exists())
    {
        qDebug() << envScriptPath.absoluteFilePath();
+        // use the shell session to keep the environment then read it
 #ifdef Q_OS_WIN
        // cmd /c "<path>">>nul && set
-        envSetProcess.start("cmd /c \"" + envScriptPath.absoluteFilePath() + "\">>nul && set");
+        envSetProcess.start("cmd", {}, QProcess::Unbuffered | QProcess::ReadWrite | QProcess::Text);
+        envSetProcess.write(QString("\"" + envScriptPath.absoluteFilePath() + "\">>nul\n").toLatin1());
+        envSetProcess.waitForReadyRead(10000);
+        envSetProcess.readAll();
+        envSetProcess.write("set\n");
 #else
+        // need implementation(or test if space works)
        // sh -c '. "<path>">>/dev/null && env'
        envSetProcess.start("sh -c \' . \"" + envScriptPath.absoluteFilePath() + "\">>/dev/null && env");
 #endif
        envSetProcess.waitForReadyRead(10000);
-        clientEnv = QString(envSetProcess.readAll()).split(QRegExp("[\r\n]"), QString::SkipEmptyParts);
+        QString envSetResult = QString(envSetProcess.readAll());
+#if (QT_VERSION <= QT_VERSION_CHECK(5,14,0))
+        clientEnv = envSetResult.split("\n", QString::SkipEmptyParts);
+#else
+        clientEnv = envSetResult.split("\n", Qt::SkipEmptyParts);
+#endif
+        if(clientEnv.size() > 2) // the first element is "set" and the last element is the current path
+        {
+            clientEnv.removeFirst();
+            clientEnv.removeLast();
+            emit setProcEnv(&clientEnv);
+        }
 //      qDebug() << "Get Env List" << clientEnv;
    }
    else
        clientEnv.clear();
-    emit setProcEnv(&clientEnv);

    clientWorkingDir->setPath(QApplication::applicationDirPath());
    qDebug() << clientWorkingDir->absolutePath();
@@ -146,13 +183,14 @@ void MainWindow::on_PM3_connectButton_clicked()
    qDebug() << clientWorkingDir->absolutePath();
    emit setWorkingDir(clientWorkingDir->absolutePath());

+    loadConfig();
    emit connectPM3(ui->PM3_pathEdit->text(), args);
    if(port != "" && !keepClientActive)
        emit setSerialListener(port, true);
    else if(!keepClientActive)
        emit setSerialListener(false);

-
+    envSetProcess.kill();
 }

 void MainWindow::onPM3StateChanged(bool st, const QString& info)
@@ -601,10 +639,10 @@ void MainWindow::on_MF_File_loadButton_clicked()
 {
    QString title = "";
    QString filename = "";
-    if(ui->MF_File_dataBox->isChecked())
+    if(ui->MF_File_dataButton->isChecked())
    {
        title = tr("Plz select the data file:");
-        filename = QFileDialog::getOpenFileName(this, title, "./", tr("Binary Data Files(*.bin *.dump);;Text Data Files(*.txt *.eml);;All Files(*.*)"));
+        filename = QFileDialog::getOpenFileName(this, title, "./", tr("Binary Data Files(*.bin *.dump)") + ";;" + tr("Text Data Files(*.txt *.eml)") + ";;" + tr("All Files(*.*)"));
        qDebug() << filename;
        if(filename != "")
        {
@@ -614,10 +652,10 @@ void MainWindow::on_MF_File_loadButton_clicked()
            }
        }
    }
-    else if(ui->MF_File_keyBox->isChecked())
+    else if(ui->MF_File_keyButton->isChecked())
    {
        title = tr("Plz select the key file:");
-        filename = QFileDialog::getOpenFileName(this, title, "./", tr("Binary Key Files(*.bin *.dump);;Binary Data Files(*.bin *.dump);;All Files(*.*)"));
+        filename = QFileDialog::getOpenFileName(this, title, "./", tr("Binary Key Files(*.bin *.dump)") + ";;" + tr("All Files(*.*)"));
        qDebug() << filename;
        if(filename != "")
        {
@@ -641,27 +679,27 @@ void MainWindow::on_MF_File_saveButton_clicked()
        defaultName += "_";
    defaultName += QDateTime::currentDateTime().toString("yyyy-MM-dd-hh-mm-ss");

-    if(ui->MF_File_dataBox->isChecked())
+    if(ui->MF_File_dataButton->isChecked())
    {
        title = tr("Plz select the location to save data file:");
-        filename = QFileDialog::getSaveFileName(this, title, "./data_" + defaultName, tr("Binary Data Files(*.bin *.dump);;Text Data Files(*.txt *.eml)"), &selectedType);
+        filename = QFileDialog::getSaveFileName(this, title, "./data_" + defaultName, tr("Binary Data Files(*.bin *.dump)") + ";;" + tr("Text Data Files(*.txt *.eml)"), &selectedType);
        qDebug() << filename;
        if(filename != "")
        {
-            if(!mifare->data_saveDataFile(filename, selectedType == "Binary Data Files(*.bin *.dump)"))
+            if(!mifare->data_saveDataFile(filename, selectedType == tr("Binary Data Files(*.bin *.dump)")))
            {
                QMessageBox::information(this, tr("Info"), tr("Failed to save to") + "\n" + filename);
            }
        }
    }
-    else if(ui->MF_File_keyBox->isChecked())
+    else if(ui->MF_File_keyButton->isChecked())
    {
        title = tr("Plz select the location to save key file:");
        filename = QFileDialog::getSaveFileName(this, title, "./key_" + defaultName, tr("Binary Key Files(*.bin *.dump)"), &selectedType);
        qDebug() << filename;
        if(filename != "")
        {
-            if(!mifare->data_saveKeyFile(filename, selectedType == "Binary Key Files(*.bin *.dump)"))
+            if(!mifare->data_saveKeyFile(filename, selectedType == tr("Binary Key Files(*.bin *.dump)")))
            {
                QMessageBox::information(this, tr("Info"), tr("Failed to save to") + "\n" + filename);
            }
@@ -672,12 +710,12 @@ void MainWindow::on_MF_File_saveButton_clicked()

 void MainWindow::on_MF_File_clearButton_clicked()
 {
-    if(ui->MF_File_keyBox->isChecked())
+    if(ui->MF_File_keyButton->isChecked())
    {
        mifare->data_clearKey();
        mifare->data_syncWithKeyWidget();
    }
-    else if(ui->MF_File_dataBox->isChecked())
+    else if(ui->MF_File_keyButton->isChecked())
    {
        mifare->data_clearData();
        mifare->data_syncWithDataWidget();
@@ -842,15 +880,16 @@ void MainWindow::on_MF_Sniff_loadButton_clicked() // use a tmp file to support c
    QString filename = "";

    title = tr("Plz select the trace file:");
-    filename = QFileDialog::getOpenFileName(this, title, "./", tr("Trace Files(*.trc);;All Files(*.*)"));
+    filename = QFileDialog::getOpenFileName(this, title, clientWorkingDir->absolutePath(), tr("Trace Files(*.trc)") + ";;" + tr("All Files(*.*)"));
    qDebug() << filename;
    if(filename != "")
    {
        QString tmpFile = "tmp" + QString::number(QDateTime::currentDateTime().toTime_t()) + ".trc";
-        if(QFile::copy(filename, "./" + tmpFile))
+        if(QFile::copy(filename, clientWorkingDir->absolutePath() + "/" + tmpFile))
        {
            mifare->loadSniff(tmpFile);
-            QFile::remove("./" + tmpFile);
+            util->delay(3000);
+            QFile::remove(clientWorkingDir->absolutePath() + "/" + tmpFile);
        }
        else
        {
@@ -865,17 +904,23 @@ void MainWindow::on_MF_Sniff_saveButton_clicked()
    QString filename = "";

    title = tr("Plz select the location to save trace file:");
-    filename = QFileDialog::getSaveFileName(this, title, "./", tr("Trace Files(*.trc)"));
+    filename = QFileDialog::getSaveFileName(this, title, clientWorkingDir->absolutePath(), tr("Trace Files(*.trc)"));
    qDebug() << filename;
    if(filename != "")
    {
        QString tmpFile = "tmp" + QString::number(QDateTime::currentDateTime().toTime_t()) + ".trc";
        mifare->saveSniff(tmpFile);
-        if(!QFile::copy("./" + tmpFile, filename))
+        for(int i = 0; i < 100; i++)
+        {
+            util->delay(100);
+            if(QFile::exists(clientWorkingDir->absolutePath() + "/" + tmpFile))
+                break;
+        }
+        if(!QFile::copy(clientWorkingDir->absolutePath() + "/" + tmpFile, filename))
        {
            QMessageBox::information(this, tr("Info"), tr("Failed to save to") + "\n" + filename);
        }
-        QFile::remove("./" + tmpFile);
+        QFile::remove(clientWorkingDir->absolutePath() + "/" + tmpFile);
    }

 }
@@ -967,17 +1012,9 @@ void MainWindow::uiInit()
    ui->statusbar->addPermanentWidget(programStatusBar, 1);
    ui->statusbar->addPermanentWidget(stopButton);

-    ui->MF_dataWidget->setColumnCount(3);
-    ui->MF_dataWidget->setHorizontalHeaderItem(0, new QTableWidgetItem(tr("Sec")));
-    ui->MF_dataWidget->setHorizontalHeaderItem(1, new QTableWidgetItem(tr("Blk")));
-    ui->MF_dataWidget->setHorizontalHeaderItem(2, new QTableWidgetItem(tr("Data")));
    ui->MF_dataWidget->setColumnWidth(0, 55);
    ui->MF_dataWidget->setColumnWidth(1, 55);

-    ui->MF_keyWidget->setColumnCount(3);
-    ui->MF_keyWidget->setHorizontalHeaderItem(0, new QTableWidgetItem(tr("Sec")));
-    ui->MF_keyWidget->setHorizontalHeaderItem(1, new QTableWidgetItem(tr("KeyA")));
-    ui->MF_keyWidget->setHorizontalHeaderItem(2, new QTableWidgetItem(tr("KeyB")));
    ui->MF_keyWidget->setColumnWidth(0, 45);

    MF_widgetReset();
@@ -1034,6 +1071,7 @@ void MainWindow::uiInit()
    settings->beginGroup("Client_Env");
    ui->Set_Client_envScriptEdit->setText(settings->value("scriptPath").toString());
    ui->Set_Client_workingDirEdit->setText(settings->value("workingDir", "../data").toString());
+    ui->Set_Client_configPathEdit->setText(settings->value("configPath", "config.json").toString());
    settings->endGroup();

    ui->MF_RW_keyTypeBox->addItem("A", Mifare::KEY_A);
@@ -1152,7 +1190,7 @@ void MainWindow::setButtonsEnabled(bool st)
    ui->MF_sniffGroupBox->setEnabled(st);
    ui->Raw_CMDEdit->setEnabled(st);
    ui->Raw_sendCMDButton->setEnabled(st);
-    ui->LF_configGroupBox->setEnabled(st);
+    ui->LF_LFconfigGroupBox->setEnabled(st);
    ui->LF_operationGroupBox->setEnabled(st);
 }

@@ -1225,13 +1263,21 @@ void MainWindow::on_Set_Client_envScriptEdit_editingFinished()
    settings->endGroup();
 }

-void MainWindow::on_Set_Client_saveWorkingDirButton_clicked()
+void MainWindow::on_Set_Client_workingDirEdit_editingFinished()
 {
    settings->beginGroup("Client_Env");
    settings->setValue("workingDir", ui->Set_Client_workingDirEdit->text());
    settings->endGroup();
 }

+
+void MainWindow::on_Set_Client_configPathEdit_editingFinished()
+{
+    settings->beginGroup("Client_Env");
+    settings->setValue("configPath", ui->Set_Client_configPathEdit->text());
+    settings->endGroup();
+}
+
 void MainWindow::on_Set_Client_keepClientActiveBox_stateChanged(int arg1)
 {
    settings->beginGroup("Client_keepClientActive");
@@ -1241,37 +1287,37 @@ void MainWindow::on_Set_Client_keepClientActiveBox_stateChanged(int arg1)
    emit setSerialListener(!keepClientActive);
 }

-void MainWindow::on_LF_Conf_freqSlider_valueChanged(int value)
+void MainWindow::on_LF_LFConf_freqSlider_valueChanged(int value)
 {
    onLFfreqConfChanged(value, true);
 }

 void MainWindow::onLFfreqConfChanged(int value, bool isCustomized)
 {
-    ui->LF_Conf_freqDivisorBox->blockSignals(true);
-    ui->LF_Conf_freqSlider->blockSignals(true);
+    ui->LF_LFConf_freqDivisorBox->blockSignals(true);
+    ui->LF_LFConf_freqSlider->blockSignals(true);

    if(isCustomized)
-        ui->LF_Conf_freqOtherButton->setChecked(true);
-    ui->LF_Conf_freqLabel->setText(tr("Actural Freq: ") + QString("%1kHz").arg(LF::divisor2Freq(value), 0, 'f', 3));
-    ui->LF_Conf_freqDivisorBox->setValue(value);
-    ui->LF_Conf_freqSlider->setValue(value);
+        ui->LF_LFConf_freqOtherButton->setChecked(true);
+    ui->LF_LFConf_freqLabel->setText(tr("Actural Freq: ") + QString("%1kHz").arg(LF::divisor2Freq(value), 0, 'f', 3));
+    ui->LF_LFConf_freqDivisorBox->setValue(value);
+    ui->LF_LFConf_freqSlider->setValue(value);

-    ui->LF_Conf_freqDivisorBox->blockSignals(false);
-    ui->LF_Conf_freqSlider->blockSignals(false);
+    ui->LF_LFConf_freqDivisorBox->blockSignals(false);
+    ui->LF_LFConf_freqSlider->blockSignals(false);
 }

-void MainWindow::on_LF_Conf_freqDivisorBox_valueChanged(int arg1)
+void MainWindow::on_LF_LFConf_freqDivisorBox_valueChanged(int arg1)
 {
    onLFfreqConfChanged(arg1, true);
 }

-void MainWindow::on_LF_Conf_freq125kButton_clicked()
+void MainWindow::on_LF_LFConf_freq125kButton_clicked()
 {
    onLFfreqConfChanged(95, false);
 }

-void MainWindow::on_LF_Conf_freq134kButton_clicked()
+void MainWindow::on_LF_LFConf_freq134kButton_clicked()
 {
    onLFfreqConfChanged(88, false);
 }
@@ -1337,31 +1383,32 @@ void MainWindow::contextMenuEvent(QContextMenuEvent *event)
    contextMenu->exec(event->globalPos());
 }

-void MainWindow::on_LF_Conf_getButton_clicked()
+void MainWindow::on_LF_LFConf_getButton_clicked()
 {
    setState(false);
-    lf->getConfig();
+    lf->getLFConfig();
    setState(true);
 }

-void MainWindow::on_LF_Conf_setButton_clicked()
+void MainWindow::on_LF_LFConf_setButton_clicked()
 {
-    LF::Config config;
+    LF::LFConfig config;
    setState(false);
-    config.divisor = ui->LF_Conf_freqDivisorBox->value();
-    config.bitPerSample = ui->LF_Conf_bitPerSampleBox->value();
-    config.decimation = ui->LF_Conf_decimationBox->value();
-    config.averaging = ui->LF_Conf_averagingBox->isChecked();
-    config.triggerThreshold = ui->LF_Conf_thresholdBox->value();
-    config.samplesToSkip = ui->LF_Conf_skipsBox->value();
-    lf->setConfig(config);
+    config.divisor = ui->LF_LFConf_freqDivisorBox->value();
+    config.bitsPerSample = ui->LF_LFConf_bitsPerSampleBox->value();
+    config.decimation = ui->LF_LFConf_decimationBox->value();
+    config.averaging = ui->LF_LFConf_averagingBox->isChecked();
+    config.triggerThreshold = ui->LF_LFConf_thresholdBox->value();
+    config.samplesToSkip = ui->LF_LFConf_skipsBox->value();
+    lf->setLFConfig(config);
    Util::gotoRawTab();
    setState(true);
 }

-void MainWindow::on_LF_Conf_resetButton_clicked()
+void MainWindow::on_LF_LFConf_resetButton_clicked()
 {
    setState(false);
-    lf->resetConfig();
+    lf->resetLFConfig();
    setState(true);
 }
+
@@ -31,6 +31,7 @@
 #include "common/pm3process.h"
 #include "module/mifare.h"
 #include "module/lf.h"
+#include "module/t55xxtab.h"
 #include "common/util.h"
 #include "ui/mf_trailerdecoderdialog.h"

@@ -177,17 +178,15 @@ private slots:

    void on_Set_Client_envScriptEdit_editingFinished();

-    void on_Set_Client_saveWorkingDirButton_clicked();
-
    void on_Set_Client_keepClientActiveBox_stateChanged(int arg1);

-    void on_LF_Conf_freqSlider_valueChanged(int value);
+    void on_LF_LFConf_freqSlider_valueChanged(int value);

-    void on_LF_Conf_freqDivisorBox_valueChanged(int arg1);
+    void on_LF_LFConf_freqDivisorBox_valueChanged(int arg1);

-    void on_LF_Conf_freq125kButton_clicked();
+    void on_LF_LFConf_freq125kButton_clicked();

-    void on_LF_Conf_freq134kButton_clicked();
+    void on_LF_LFConf_freq134kButton_clicked();

    void on_LF_Op_searchButton_clicked();

@@ -197,12 +196,17 @@ private slots:

    void on_LF_Op_sniffButton_clicked();

-    void on_LF_Conf_getButton_clicked();
+    void on_LF_LFConf_getButton_clicked();

-    void on_LF_Conf_setButton_clicked();
+    void on_LF_LFConf_setButton_clicked();

-    void on_LF_Conf_resetButton_clicked();
+    void on_LF_LFConf_resetButton_clicked();

+    void on_Set_Client_workingDirEdit_editingFinished();
+
+    void on_Set_Client_configPathEdit_editingFinished();
+
+    void setState(bool st);
 private:
    Ui::MainWindow* ui;
    QButtonGroup* MFCardTypeBtnGroup;
@@ -233,6 +237,7 @@ private:
    QStringList clientEnv;
    QDir* clientWorkingDir;

+    T55xxTab* t55xxTab;
    Mifare* mifare;
    LF* lf;
    Util* util;
@@ -245,10 +250,10 @@ private:
    void signalInit();
    void MF_widgetReset();
    void setTableItem(QTableWidget *widget, int row, int column, const QString& text);
-    void setState(bool st);
    void saveClientPath(const QString& path);
    void onLFfreqConfChanged(int value, bool isCustomized);
    void dockInit();
+    void loadConfig();
 protected:
    void contextMenuEvent(QContextMenuEvent *event) override;
 signals:
@@ -0,0 +1,32 @@
+#include "mf_attack_hardnesteddialog.h"
+#include "ui_mf_attack_hardnesteddialog.h"
+
+MF_Attack_hardnestedDialog::MF_Attack_hardnestedDialog(int blocks, const QVariantMap& config, QWidget *parent) :
+    QDialog(parent),
+    ui(new Ui::MF_Attack_hardnestedDialog)
+{
+    ui->setupUi(this);
+    for(int i = 0; i < blocks; i++)
+    {
+        ui->knownKeyBlockBox->addItem(QString::number(i));
+        ui->targetKeyBlockBox->addItem(QString::number(i));
+    }
+    this->config = config;
+
+}
+
+MF_Attack_hardnestedDialog::~MF_Attack_hardnestedDialog()
+{
+    delete ui;
+}
+
+void MF_Attack_hardnestedDialog::on_buttonBox_accepted()
+{
+    QString cmd = config["cmd"].toString();
+    cmd.replace("<known key block>", ui->knownKeyBlockBox->currentText());
+    cmd.replace("<known key type>", config["known key type"].toMap()[ui->knownKeyTypeBox->currentText()].toString());
+    cmd.replace("<known key>", ui->knownKeyBox->text());
+    cmd.replace("<target key block>", ui->targetKeyBlockBox->currentText());
+    cmd.replace("<target key type>", config["target key type"].toMap()[ui->targetKeyTypeBox->currentText()].toString());
+    emit sendCMD(cmd);
+}
@@ -14,12 +14,13 @@ class MF_Attack_hardnestedDialog : public QDialog
    Q_OBJECT

 public:
-    explicit MF_Attack_hardnestedDialog(int blocks, QWidget *parent = nullptr);
+    explicit MF_Attack_hardnestedDialog(int blocks, const QVariantMap& config, QWidget *parent = nullptr);
    ~MF_Attack_hardnestedDialog();


 private:
    Ui::MF_Attack_hardnestedDialog *ui;
+    QVariantMap config;
 signals:
    void sendCMD(const QString& cmd);
 private slots:
@@ -31,7 +31,7 @@
      </widget>
     </item>
     <item>
-      <widget class="QComboBox" name="knownKeySectorBox">
+      <widget class="QComboBox" name="knownKeyBlockBox">
       <property name="minimumSize">
        <size>
         <width>60</width>
@@ -106,7 +106,7 @@
      </widget>
     </item>
     <item>
-      <widget class="QComboBox" name="targetKeySectorBox">
+      <widget class="QComboBox" name="targetKeyBlockBox">
       <property name="minimumSize">
        <size>
         <width>60</width>
@@ -85,15 +85,15 @@ void MF_trailerDecoderDialog::on_blockSizeChanged(int id, bool st)
    {
        if(id == 4)
        {
-            ui->dataBlockWidget->verticalHeaderItem(0)->setText("Block0");
-            ui->dataBlockWidget->verticalHeaderItem(1)->setText("Block1");
-            ui->dataBlockWidget->verticalHeaderItem(2)->setText("Block2");
+            ui->dataBlockWidget->verticalHeaderItem(0)->setText(tr("Block") + "0");
+            ui->dataBlockWidget->verticalHeaderItem(1)->setText(tr("Block") + "1");
+            ui->dataBlockWidget->verticalHeaderItem(2)->setText(tr("Block") + "2");
        }
        else if(id == 16)
        {
-            ui->dataBlockWidget->verticalHeaderItem(0)->setText("Block0~4");
-            ui->dataBlockWidget->verticalHeaderItem(1)->setText("Block5~9");
-            ui->dataBlockWidget->verticalHeaderItem(2)->setText("Block10~14");
+            ui->dataBlockWidget->verticalHeaderItem(0)->setText(tr("Block") + "0~4");
+            ui->dataBlockWidget->verticalHeaderItem(1)->setText(tr("Block") + "5~9");
+            ui->dataBlockWidget->verticalHeaderItem(2)->setText(tr("Block") + "10~14");
        }

    }
@@ -110,15 +110,15 @@ void MF_trailerDecoderDialog::setTableItem(QTableWidget* widget, int row, int co
    }
    else if(accessType == Mifare::ACC_KEY_A)
    {
-        text = "KeyA";
+        text = tr("KeyA");
    }
    else if(accessType == Mifare::ACC_KEY_B)
    {
-        text = "KeyB";
+        text = tr("KeyB");
    }
    else if(accessType == Mifare::ACC_KEY_AB)
    {
-        text = "KeyA+B";
+        text = tr("KeyA+B");
    }
    widget->item(row, column)->setText(text);
 }
@@ -0,0 +1,27 @@
+#include "mf_uid_parameterdialog.h"
+#include "ui_mf_uid_parameterdialog.h"
+
+MF_UID_parameterDialog::MF_UID_parameterDialog(const QString& uid, const QString& atqa, const QString& sak, const QVariantMap& config, QWidget *parent) :
+    QDialog(parent),
+    ui(new Ui::MF_UID_parameterDialog)
+{
+    ui->setupUi(this);
+    ui->UIDLineEdit->setText(uid);
+    ui->ATQALineEdit->setText(atqa);
+    ui->SAKLineEdit->setText(sak);
+    this->config = config;
+}
+
+MF_UID_parameterDialog::~MF_UID_parameterDialog()
+{
+    delete ui;
+}
+
+void MF_UID_parameterDialog::on_buttonBox_accepted()
+{
+    QString cmd = config["cmd"].toString();
+    cmd.replace("<uid>", ui->UIDLineEdit->text());
+    cmd.replace("<atqa>", ui->ATQALineEdit->text());
+    cmd.replace("<sak>", ui->SAKLineEdit->text());
+    emit sendCMD(cmd);
+}
@@ -14,11 +14,12 @@ class MF_UID_parameterDialog : public QDialog
    Q_OBJECT

 public:
-    explicit MF_UID_parameterDialog(const QString& uid, const QString& atqa, const QString& sak, QWidget *parent = nullptr);
+    explicit MF_UID_parameterDialog(const QString& uid, const QString& atqa, const QString& sak, const QVariantMap& config, QWidget *parent = nullptr);
    ~MF_UID_parameterDialog();

 private:
    Ui::MF_UID_parameterDialog *ui;
+    QVariantMap config;
 signals:
    void sendCMD(const QString& cmd);
 private slots:
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ui version="4.0">
+ <class>T55xxTab</class>
+ <widget class="QWidget" name="T55xxTab">
+  <property name="geometry">
+   <rect>
+    <x>0</x>
+    <y>0</y>
+    <width>400</width>
+    <height>300</height>
+   </rect>
+  </property>
+  <layout class="QVBoxLayout">
+   <item>
+    <widget class="QGroupBox" name="cloneGroupBox">
+     <property name="title">
+      <string>Clone to T55xx</string>
+     </property>
+     <layout class="QVBoxLayout" name="verticalLayout">
+      <item>
+       <layout class="QHBoxLayout" name="horizontalLayout_3">
+        <item>
+         <widget class="QLabel" name="label">
+          <property name="text">
+           <string>Target Type:</string>
+          </property>
+         </widget>
+        </item>
+        <item>
+         <widget class="QRadioButton" name="Clone_T5555Button">
+          <property name="text">
+           <string>T5555</string>
+          </property>
+         </widget>
+        </item>
+        <item>
+         <widget class="QRadioButton" name="Clone_T55x7Button">
+          <property name="text">
+           <string>T55x7</string>
+          </property>
+          <property name="checked">
+           <bool>true</bool>
+          </property>
+         </widget>
+        </item>
+        <item>
+         <spacer name="horizontalSpacer">
+          <property name="orientation">
+           <enum>Qt::Horizontal</enum>
+          </property>
+          <property name="sizeHint" stdset="0">
+           <size>
+            <width>40</width>
+            <height>20</height>
+           </size>
+          </property>
+         </spacer>
+        </item>
+       </layout>
+      </item>
+      <item>
+       <widget class="QGroupBox" name="Clone_EM410xGroupBox">
+        <property name="title">
+         <string>EM410x</string>
+        </property>
+        <layout class="QHBoxLayout" name="horizontalLayout">
+         <item>
+          <widget class="QPushButton" name="Clone_EM410xReadButton">
+           <property name="text">
+            <string>Read</string>
+           </property>
+          </widget>
+         </item>
+         <item>
+          <widget class="QLineEdit" name="Clone_EM410xIDEdit"/>
+         </item>
+         <item>
+          <widget class="QPushButton" name="Clone_EM410xCloneButton">
+           <property name="text">
+            <string>Clone</string>
+           </property>
+          </widget>
+         </item>
+        </layout>
+       </widget>
+      </item>
+     </layout>
+    </widget>
+   </item>
+   <item>
+    <spacer name="verticalSpacer">
+     <property name="orientation">
+      <enum>Qt::Vertical</enum>
+     </property>
+     <property name="sizeHint" stdset="0">
+      <size>
+       <width>20</width>
+       <height>40</height>
+      </size>
+     </property>
+    </spacer>
+   </item>
+  </layout>
+ </widget>
+ <resources/>
+ <connections/>
+</ui>
@@ -1,46 +0,0 @@
-#include "mf_attack_hardnesteddialog.h"
-#include "ui_mf_attack_hardnesteddialog.h"
-
-MF_Attack_hardnestedDialog::MF_Attack_hardnestedDialog(int blocks, QWidget *parent) :
-    QDialog(parent),
-    ui(new Ui::MF_Attack_hardnestedDialog)
-{
-    ui->setupUi(this);
-    for(int i = 0; i < blocks; i++)
-    {
-        ui->knownKeySectorBox->addItem(QString::number(i));
-        ui->targetKeySectorBox->addItem(QString::number(i));
-    }
-
-}
-
-MF_Attack_hardnestedDialog::~MF_Attack_hardnestedDialog()
-{
-    delete ui;
-}
-
-void MF_Attack_hardnestedDialog::on_buttonBox_accepted()
-{
-    if(Util::getClientType() == Util::CLIENTTYPE_OFFICIAL)
-        emit sendCMD("hf mf hardnested "
-                     + ui->knownKeySectorBox->currentText()
-                     + " "
-                     + ui->knownKeyTypeBox->currentText()
-                     + " "
-                     + ui->knownKeyBox->text()
-                     + " "
-                     + ui->targetKeySectorBox->currentText()
-                     + " "
-                     + ui->targetKeyTypeBox->currentText());
-    else if(Util::getClientType() == Util::CLIENTTYPE_ICEMAN) // same format in v4.9237
-        emit sendCMD("hf mf hardnested "
-                     + ui->knownKeySectorBox->currentText()
-                     + " "
-                     + ui->knownKeyTypeBox->currentText()
-                     + " "
-                     + ui->knownKeyBox->text()
-                     + " "
-                     + ui->targetKeySectorBox->currentText()
-                     + " "
-                     + ui->targetKeyTypeBox->currentText());
-}
@@ -1,35 +0,0 @@
-#include "mf_uid_parameterdialog.h"
-#include "ui_mf_uid_parameterdialog.h"
-
-MF_UID_parameterDialog::MF_UID_parameterDialog(const QString& uid, const QString& atqa, const QString& sak, QWidget *parent) :
-    QDialog(parent),
-    ui(new Ui::MF_UID_parameterDialog)
-{
-    ui->setupUi(this);
-    ui->UIDLineEdit->setText(uid);
-    ui->ATQALineEdit->setText(atqa);
-    ui->SAKLineEdit->setText(sak);
-}
-
-MF_UID_parameterDialog::~MF_UID_parameterDialog()
-{
-    delete ui;
-}
-
-void MF_UID_parameterDialog::on_buttonBox_accepted()
-{
-    if(Util::getClientType() == Util::CLIENTTYPE_OFFICIAL)
-        emit sendCMD("hf mf csetuid "
-                     + ui->UIDLineEdit->text()
-                     + " "
-                     + ui->ATQALineEdit->text()
-                     + " "
-                     + ui->SAKLineEdit->text());
-    else if(Util::getClientType() == Util::CLIENTTYPE_ICEMAN) // same format in v4.9237
-        emit sendCMD("hf mf csetuid "
-                     + ui->UIDLineEdit->text()
-                     + " "
-                     + ui->ATQALineEdit->text()
-                     + " "
-                     + ui->SAKLineEdit->text());
-}
Author	SHA1	Message	Date
wh201906	ae932778ce	V0.2.4	2022-03-01 18:52:04 +08:00
wh201906	1e728c891c	EM410x clone support	2022-03-01 18:47:33 +08:00
wh201906	f86cba8d56	New project structure Load translation file in the executable.	2022-03-01 11:13:07 +08:00
wh201906	b319f9fbe1	Fix a UI bug The dock widget will take as much space as it could get now	2022-01-31 00:58:57 +08:00
wh201906	c0afa6bb32	V0.2.3	2022-01-21 17:21:38 +08:00
wh201906	17c40fe941	Merge commit '60f965b' into dev	2022-01-21 10:50:26 +08:00
wh201906	60f965bfe7	Change LICENSE	2022-01-21 10:47:42 +08:00
wh201906	36307dcda0	Non-ASCII path support(partial) I didn't find other solutions on the Internet. I found the plugins are loaded when creating MainWindow, so this solution should be fine?	2021-12-15 21:43:10 +08:00
wh201906	dcc17963b6	Tutorial tutorial for Editing Mifare Classic data	2021-11-24 16:57:25 +08:00
wh201906	d4519f8667	Fix a bug Fix #27	2021-10-11 01:12:28 +08:00
wh201906	c2514602e8	Simple tutorial	2021-09-22 15:45:49 +08:00
wh201906	c277844cf4	Make SkipEmptyParts compatible with older Qt Fix #25	2021-09-21 11:13:32 +08:00
wh201906	f285f76a20	V0.2.2	2021-09-20 19:07:36 +08:00
wh201906	24adc08d84	LF config file	2021-09-20 15:32:00 +08:00
wh201906	d56c5f8dc7	Merge branch 'master' into dev	2021-09-20 00:01:57 +08:00
wh201906	222f271a31	Choose config file path	2021-09-19 23:59:55 +08:00
wh201906	0c339e91af	Revert part of the commit `12a0837` I forgot I have designed "Keep the client active" for issue #22 isBusy() is deprecated for blocking the port, but it doesn't matter.	2021-09-19 21:33:53 +08:00
wh201906	85ea3fd744	Config file _readsec(), hardnested(), _writeblk(), lockC(), setParameterC()	2021-09-19 21:00:23 +08:00
wh201906	d0bc6808d0	Config file for official client Unfinished Refactor darkside() _readblk(), loadSniff(), saveSniff() Add extra waiting time when handling temp file of load/saveSniff()	2021-09-19 01:10:12 +08:00
wh201906	03d9c601fc	Config fiie for official client Unfinished Refactor nested(), info(), chk()	2021-09-18 02:03:05 +08:00
wh201906	5a8ab42281	External command config file	2021-09-17 15:25:03 +08:00
wh201906	12a0837c50	Fix a bug Trying to fix #22 Open client with QProcess::Text for proper newline character(s) On Raspbian, the isBusy() function will always return false, even the serial port is actually connected.	2021-09-05 21:35:03 +08:00
wh201906	d6f02e7a69	Update building instructions	2021-08-14 17:05:13 +08:00
wh201906	02a8fe03e3	Fix a bug #21	2021-08-07 11:21:19 +08:00
wh201906	3523c1eace	Fix a bug #20 I got a wrong tutorial saying that I should use xxx.ts on Linux	2021-08-05 11:57:35 +08:00
wh201906	bac6207634	V0.2.1	2021-03-16 11:23:01 +08:00
wh201906	ccb07651cc	Mifare: Optimize read logic Fix bug #16 mentioned in http://www.proxmark.org/forum/viewtopic.php?pid=42123 (see the 17th post) This is caused by the output change in RRG repo Optimize _readsec() logic Implement getTrailerBlockId()	2021-03-16 11:06:26 +08:00
wh201906	f706d59c48	Update UI	2021-03-15 11:29:17 +08:00
wh201906	9e31496131	Fail to support non-ASCII chars in path Using "chcp" seems to have no effect there I fix a small bug then	2021-03-12 11:59:51 +08:00
wh201906	a232e4ec83	Fix #15 partially The path of the start script or the client can contain spaces now(on Windows) TODO: Test the issue on Linux and implement the fix if it's needed Support non-ASCII chars in the path	2021-03-11 00:46:56 +08:00
wh201906	1bec73d1ad	T55xx: Add some useless UI	2021-03-08 23:02:16 +08:00