Tutorial

tutorial for Editing Mifare Classic data

README.md

@@ -68,6 +68,7 @@ Great thanks to him.
 ## 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:

doc/README/README_zh_CN.md

@@ -66,6 +66,7 @@ release页面中有含客户端的GUI。这个GUI也可以搭配你自己的客
 ***
 ## 教程
 [1.快速上手](../tutorial/Quickstart/quickstart_zh_CN.md)  
+[2.编辑Mifare(IC)卡数据](../tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data_zh_CN.md)（无需PM3硬件）  
 ***
 ## 更新日志:
 

doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data.md

@@ -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  

doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data_zh_CN.md

@@ -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)  
+
+## 文件格式转换
+如果你想用其它文本编辑器编辑二进制文件，可以参考以下步骤
++ 加载原始二进制文件  
++ 保存为文本文件  
++ 用自己喜欢的文本编辑器编辑后保存  
++ 加载编辑后的文件  
++ 保存为二进制文件  

doc/tutorial/Quickstart/quickstart.md

@@ -1,5 +1,6 @@
 # Quickstart
 
+[中文教程](quickstart_zh_CN.md)  
 ***
 **On Windows**
 ***

doc/tutorial/Quickstart/quickstart_zh_CN.md

@@ -1,5 +1,6 @@
 # 快速上手
 
+[English](quickstart.md)  
 ***
 **Windows用户**
 ***