Android Open Source - MifareClassicTool Access Condition Tool






From Project

Back to project page MifareClassicTool.

License

The source code is released under:

GNU General Public License

If you think the Android project MifareClassicTool listed in this page is inappropriate, such as containing malicious code/tools or violating the copyright, please email info at java2s dot com, thanks.

Java Source Code

/*
 * Copyright 2013 Gerhard Klostermeier/*from w  ww  . j  a va  2s.com*/
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */


package de.syss.MifareClassicTool.Activities;

import android.app.AlertDialog;
import android.os.Bundle;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ArrayAdapter;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ListAdapter;
import android.widget.ListView;
import android.widget.Toast;
import de.syss.MifareClassicTool.Common;
import de.syss.MifareClassicTool.R;

/**
 * Decode Mifare Classic Access Conditions from their hex format
 * to a more human readable format and vice versa.
 * @author Gerhard Klostermeier
 */
public class AccessConditionTool extends BasicActivity {

    private EditText mAC;
    private Button[] mBlockButtons;
    private boolean mWasKeyBReadable;
    /**
     * True if the Access Conditions of the Sector Trailer state that key B
     * is readable. Many methods rely on this member variable
     * ({@link #getResourceForDataBlocksByRowNr(int)},
     * {@link #getResourceForSectorTrailersByRowNr(int)},
     * {@link #acRowNrToACBits(int, boolean)},
     * {@link #acBitsToACRowNr(byte[], boolean)},
     * {@link #buildDataBlockDialog(boolean)}).
     */
    private boolean mIsKeyBReadable;
    /**
     * Matrix of access conditions bits (C1-C3) where the first
     * dimension is the "C" parameter (C1-C3, Index 0-2) and the second
     * dimension is the block number (Index 0-3).
     * This matrix will be updated each time a user chooses an Access Condition
     * via {@link #mDataBlockDialog} or {@link #mSectorTrailerDialog}
     */
    private byte[][] mACMatrix;
    /**
     * The last clicked "choose Access Conditions for data block"-button.
     * @see #onChooseACforDataBock(View)
     */
    private Button mSelectedButton;
    /**
     * A dialog which allow the user to choose between all possible
     * Access Conditions for a data block.
     */
    private AlertDialog mDataBlockDialog;
    /**
     * A dialog which allow the user to choose between all possible
     * Access Conditions for a Sector Trailer.
     */
    private AlertDialog mSectorTrailerDialog;

    /**
     * Build the two dialogs for choosing the Access Conditions
     * ({@link #mDataBlockDialog} and {@link #mSectorTrailerDialog}) and
     * initialize the some member variables.
     */
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_access_condition_tool);

        // Init. member vars.
        mAC = (EditText) findViewById(R.id.editTextAccessConditionToolAC);
        mBlockButtons = new Button[4];
        mBlockButtons[0] = (Button) findViewById(
                R.id.buttonAccessConditionToolBlock0);
        mBlockButtons[1] = (Button) findViewById(
                R.id.buttonAccessConditionToolBlock1);
        mBlockButtons[2] = (Button) findViewById(
                R.id.buttonAccessConditionToolBlock2);
        mBlockButtons[3] = (Button) findViewById(
                R.id.buttonAccessConditionToolBlock3);
        // Init AC matrix with factory setting/transport configuration.
        mACMatrix = new byte[][] {
                {0, 0, 0, 0},
                {0, 0, 0, 0},
                {0, 0, 0, 1} };

        // Build the dialog with Access Conditions for the Sector Trailer.
        String[] items = new String[8];
        for (int i = 0; i < 8; i++) {
            items[i] = getString(getResourceForSectorTrailersByRowNr(i));
        }
        ArrayAdapter<String> adapter = new ArrayAdapter<String>(
                this, R.layout.list_item_small_text, items);
        ListView lv = new ListView(this);
        lv.setAdapter(adapter);
        lv.setOnItemClickListener(
                new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, final View view,
                    int position, long id) {
                // Change button text to selected Access Conditions.
                mBlockButtons[3].setText(getString(
                        getResourceForSectorTrailersByRowNr(position)));
                // Set Access Condition bits for sector trailer.
                byte[] acBits = acRowNrToACBits(position, true);
                mACMatrix[0][3] = acBits [0];
                mACMatrix[1][3] = acBits [1];
                mACMatrix[2][3] = acBits [2];
                // Rebuild the data block dialog based on the readability of
                // key B.
                mIsKeyBReadable = position < 2 || position == 4;
                buildDataBlockDialog(true);
                // Close dialog.
                mSectorTrailerDialog.dismiss();
            }
        });
        mSectorTrailerDialog = new AlertDialog.Builder(this)
                .setTitle(R.string.dialog_choose_ac_title)
                .setView(lv)
                .create();

        // Build the dialog with Access Conditions for data blocks.
        // Key B is readable in the default configuration.
        mIsKeyBReadable = true;
        buildDataBlockDialog(false);
    }

    /**
     * Convert the 3 Access Condition bytes into a more human readable format
     * using {@link Common#acBytesToACMatrix(byte[])},
     * {@link #acBitsToACRowNr(byte[], boolean)},
     * {@link #getResourceForDataBlocksByRowNr(int)} and
     * {@link #getResourceForSectorTrailersByRowNr(int)}.
     * @param view The View object that triggered the method
     * (in this case the decode button).
     * @see Common#acBytesToACMatrix(byte[])
     * @see #acBitsToACRowNr(byte[], boolean)
     * @see #getResourceForDataBlocksByRowNr(int)
     * @see #getResourceForDataBlocksByRowNr(int)
     * @see #mACMatrix
     */
    public void onDecode(View view) {
        String ac = mAC.getText().toString();
        if (ac.length() != 6) {
            // Error. Access Conditions are not 3 byte (6 characters) long.
            Toast.makeText(this, R.string.info_ac_not_3_byte,
                    Toast.LENGTH_LONG).show();
            return;
        }
        if (!ac.matches("[0-9A-Fa-f]+")) {
            // Error. Not hex.
            Toast.makeText(this, R.string.info_ac_not_hex,
                    Toast.LENGTH_LONG).show();
            return;
        }

        byte[][] acMatrix = Common.acBytesToACMatrix(
                Common.hexStringToByteArray(ac));
        boolean error = false;
        if (acMatrix != null) {
            // First check & set Sector Trailer.
            byte[] acBits = {acMatrix[0][3], acMatrix[1][3], acMatrix[2][3]};
            int rowNr = acBitsToACRowNr(acBits, true);
            if (rowNr != -1) {
                // Check if key B is readable.
                mIsKeyBReadable = rowNr < 2 || rowNr == 4;
                mBlockButtons[3].setText(getString(
                        getResourceForSectorTrailersByRowNr(rowNr)));

                // Now check & set Data blocks.
                for (int i = 0; i < 3; i++) {
                    acBits = new byte [] {acMatrix[0][i], acMatrix[1][i],
                            acMatrix[2][i]};
                    rowNr = acBitsToACRowNr(acBits, false);
                    if (rowNr == -1) {
                        // Error.
                        error = true;
                        break;
                    }
                    mBlockButtons[i].setText(getString(
                            getResourceForDataBlocksByRowNr(rowNr)));
                }
            } else {
                // Error.
                error = true;
            }
        } else {
            // Error.
            error = true;
        }

        // Were there some error during this process?
        if (error) {
            // Display an error message.
            Toast.makeText(this, R.string.info_ac_format_error,
                    Toast.LENGTH_LONG).show();
            return;
        }
        mACMatrix = acMatrix;
        buildDataBlockDialog(false);
    }

    /**
     * Convert the {@link #mACMatrix} to 3 Access Condition bytes using
     * {@link Common#acMatrixToACBytes(byte[][])} and display them.
     * @param view The View object that triggered the method
     * (in this case the encode button).
     * @see Common#acMatrixToACBytes(byte[][])
     * @see #mACMatrix
     * @see #acRowNrToACBits(int, boolean)
     */
    public void onEncode(View view) {
        mAC.setText(Common.byte2HexString(Common.acMatrixToACBytes(mACMatrix)));
    }

    /**
     * Backup the button which triggered this method to {@link #mSelectedButton}
     * to change its text later and show the Access Condition chooser dialog
     * for data blocks ({@link #mDataBlockDialog}).
     * @param view The View object that triggered the method
     * (in this case one of the data block buttons).
     * @see #mDataBlockDialog
     * @see #mSelectedButton
     */
    public void onChooseACforDataBock(View view) {
        mSelectedButton = (Button) view;
        mDataBlockDialog.show();
    }

    /**
     * Show the Access Condition chooser dialog for Sector Trailers
     * ({@link #mSectorTrailerDialog}).
     * @param view The View object that triggered the method
     * (in this case the Sector Trailer button).
     * @see #mSectorTrailerDialog
     */
    public void onChooseACforSectorTrailer(View view) {
        mSectorTrailerDialog.show();
    }

    /**
     * Copy the Mifare Classic Access Conditions to the Android clipboard.
     * @param view The View object that triggered the method
     * (in this case the copy button).
     */
    public void onCopyToClipboard(View view) {
        Common.copyToClipboard(mAC.getText().toString(), this);
    }

    /**
     * Paste the content of the Android clipboard (if plain text) to the
     * access conditions edit text.
     * @param view The View object that triggered the method
     * (in this case the paste button).
     */
    public void onPasteFromClipboard(View view) {
        String text = Common.getFromClipboard(this);
        if (text != null) {
            mAC.setText(text);
        }
    }

    /**
     * Return the resource ID of an Access Condition string for data
     * blocks based on its position in the table
     * (see: res/values/access_conditions.xml and
     * NXP's MF1S50yyX, Chapter 8.7.1, 8.7.2, 8.7.3, Table 7 and 8).
     * @param rowNr Row number of the Access Condition table.
     * @return The resource ID of an Access Condition string.
     * @see #mIsKeyBReadable
     */
    private int getResourceForDataBlocksByRowNr(int rowNr) {
        String prefix = "ac_data_block_";
        if (mIsKeyBReadable) {
            prefix = "ac_data_block_no_keyb_";
        }
        return getResourceForAccessCondition(prefix, rowNr);
    }

    /**
     * Return the resource ID of an Access Condition string for Sector
     * Trailers based on its position in the table
     * (see: res/values/access_conditions.xml and
     * NXP's MF1S50yyX, Chapter 8.7.1, 8.7.2, 8.7.3, Table 7 and 8).
     * @param rowNr Row number of the Access Condition table.
     * @return The resource ID of an Access Condition string.
     * @see #mIsKeyBReadable
     */
    private int getResourceForSectorTrailersByRowNr(int rowNr) {
        return getResourceForAccessCondition("ac_sector_trailer_", rowNr);
    }

    /**
     * A helper function for {@link #getResourceForDataBlocksByRowNr(int)} and
     * {@link #getResourceForSectorTrailersByRowNr(int)}.
     * @param prefix The prefix of the resource name
     * ("ac_data_block_", "ac_data_block_no_keyb_" or "ac_sector_trailer_").
     * @param rowNr Row number of the Access Condition table.
     * @return The resource ID of an Access Condition string.
     */
    private int getResourceForAccessCondition(String prefix, int rowNr) {
        return getResources().getIdentifier(
                prefix + rowNr, "string", getPackageName());
    }

    /**
     * Convert the the row number of the Access Condition table to its
     * corresponding access bits C1, C2 and C3
     * (see: res/values/access_conditions.xml and
     * NXP's MF1S50yyX, Chapter 8.7.1, 8.7.2, 8.7.3, Table 7 and 8).
     * @param rowNr The row number of the Access Condition table (0-7).
     * @param isSectorTrailer True if the row number refers to a Sector Trailer.
     * @return The access bits C1, C2 and C3. On error null will be returned.
     * @see #mIsKeyBReadable
     */
    private byte[] acRowNrToACBits(int rowNr, boolean isSectorTrailer) {
        if (!isSectorTrailer && mIsKeyBReadable && rowNr > 1) {
            switch (rowNr) {
            case 2:
                return new byte[] {0, 0, 1};
            case 3:
                return new byte[] {1, 1, 1};
            default:
                return null;
            }
        }

        switch (rowNr) {
        case 0:
            return new byte[] {0, 0, 0};
        case 1:
            return new byte[] {0, 1, 0};
        case 2:
            return new byte[] {1, 0, 0};
        case 3:
            return new byte[] {1, 1, 0};
        case 4:
            return new byte[] {0, 0, 1};
        case 5:
            return new byte[] {0, 1, 1};
        case 6:
            return new byte[] {1, 0, 1};
        case 7:
            return new byte[] {1, 1, 1};
        default:
            // Error.
            return null;
        }
    }

    /**
     * Convert the access bits C1, C2 and C3 to its corresponding row number
     * in the Access Condition table (see: res/values/access_conditions.xml and
     * NXP's MF1S50yyX, Chapter 8.7.1, 8.7.2, 8.7.3, Table 7 and 8).
     * @param acBits The access bits C1, C2 and C3.
     * @param isSectorTrailer True if the row number refers to a Sector Trailer.
     * @return The row number of the Access Condition table. On error -1 will
     * be returned.
     * @see #mIsKeyBReadable
     */
    private int acBitsToACRowNr(byte[] acBits, boolean isSectorTrailer) {
        if (acBits != null && acBits.length != 3) {
            return -1;
        }

        if (!isSectorTrailer && mIsKeyBReadable) {
            if (acBits[0] == 0 && acBits[1] == 0 && acBits[2] == 0) {
                return 0;
            } else if (acBits[0] == 0 && acBits[1] == 1 && acBits[2] == 0) {
                return 1;
            } else if (acBits[0] == 0 && acBits[1] == 0 && acBits[2] == 1) {
                return 2;
            } else if (acBits[0] == 1 && acBits[1] == 1 && acBits[2] == 1) {
                return 3;
            }
        } else {
            if (acBits[0] == 0 && acBits[1] == 0 && acBits[2] == 0) {
                return 0;
            } else if (acBits[0] == 0 && acBits[1] == 1 && acBits[2] == 0) {
                return 1;
            } else if (acBits[0] == 1 && acBits[1] == 0 && acBits[2] == 0) {
                return 2;
            } else if (acBits[0] == 1 && acBits[1] == 1 && acBits[2] == 0) {
                return 3;
            } else if (acBits[0] == 0 && acBits[1] == 0 && acBits[2] == 1) {
                return 4;
            } else if (acBits[0] == 0 && acBits[1] == 1 && acBits[2] == 1) {
                return 5;
            } else if (acBits[0] == 1 && acBits[1] == 0 && acBits[2] == 1) {
                return 6;
            } else if (acBits[0] == 1 && acBits[1] == 1 && acBits[2] == 1) {
                return 7;
            }
        }

        // Error.
        return -1;
    }

    /**
     * Rebuild the {@link #mDataBlockDialog} based on {@link #mIsKeyBReadable}.
     * If key B is readable due to the Access Conditions of a Sector Trailer,
     * the Access Conditions for a normal data block are limited to
     * conditions that don't use key B.
     * @param resetBlockACs If True the Access Conditions of all data blocks
     * will be reseted (C1=0, C2=0, C3=0).
     * @see #mDataBlockDialog
     * @see #mIsKeyBReadable
     */
    private void buildDataBlockDialog(boolean resetBlockACs) {
        String[] items = null;
        if (mIsKeyBReadable && !mWasKeyBReadable) {
            // Rebuild dialog (because key B is now readable).
            items = new String[4];
            for (int i = 0; i < 4; i++) {
                items[i] = getString(getResourceForDataBlocksByRowNr(i));
            }
            mWasKeyBReadable = true;
        } else if (!mIsKeyBReadable && mWasKeyBReadable){
            // Rebuild dialog (because key B is no longer readable).
            items = new String[8];
            for (int i = 0; i < 8; i++) {
                items[i] = getString(getResourceForDataBlocksByRowNr(i));
            }
            mWasKeyBReadable = false;
        } else {
            // No build is needed.
            return;
        }

        if (resetBlockACs) {
            // Reset mACMatrix and update button text.
            for (int i = 0; i < 3; i++) {
                mBlockButtons[i].setText(items[0]);

                mACMatrix[0][i] = 0;
                mACMatrix[1][i] = 0;
                mACMatrix[2][i] = 0;
            }
            int r = 0;
            if (mIsKeyBReadable) {
                r = R.string.info_ac_reset_keyb_readable;
            } else {
                r = R.string.info_ac_reset_keyb_not_readable;
            }
            Toast.makeText(this, r, Toast.LENGTH_LONG).show();
        }

        ListAdapter adapter = new ArrayAdapter<String>(
                this, R.layout.list_item_small_text, items);
        ListView lv = new ListView(this);
        lv.setAdapter(adapter);
        lv.setOnItemClickListener(
                new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, final View view,
                    int position, long id) {
                // Change button text to selected Access Conditions.
                mSelectedButton.setText(getString(
                        getResourceForDataBlocksByRowNr(position)));
                // Set Access Condition bits for this block.
                byte[] acBits = acRowNrToACBits(position, false);
                int blockNr = Integer.parseInt(
                        mSelectedButton.getTag().toString());
                mACMatrix[0][blockNr] = acBits [0];
                mACMatrix[1][blockNr] = acBits [1];
                mACMatrix[2][blockNr] = acBits [2];
                // Close dialog.
                mDataBlockDialog.dismiss();
            }
        });
        mDataBlockDialog =  new AlertDialog.Builder(this)
                .setTitle(R.string.dialog_choose_ac_title)
                .setView(lv)
                .create();
    }

}




Java Source Code List

de.syss.MifareClassicTool.Common.java
de.syss.MifareClassicTool.MCDiffUtils.java
de.syss.MifareClassicTool.MCReader.java
de.syss.MifareClassicTool.Activities.AccessConditionDecoder.java
de.syss.MifareClassicTool.Activities.AccessConditionTool.java
de.syss.MifareClassicTool.Activities.BasicActivity.java
de.syss.MifareClassicTool.Activities.DiffTool.java
de.syss.MifareClassicTool.Activities.DumpEditor.java
de.syss.MifareClassicTool.Activities.FileChooser.java
de.syss.MifareClassicTool.Activities.HelpAndInfo.java
de.syss.MifareClassicTool.Activities.HexToAscii.java
de.syss.MifareClassicTool.Activities.IActivityThatReactsToSave.java
de.syss.MifareClassicTool.Activities.KeyEditor.java
de.syss.MifareClassicTool.Activities.KeyMapCreator.java
de.syss.MifareClassicTool.Activities.MainMenu.java
de.syss.MifareClassicTool.Activities.Preferences.java
de.syss.MifareClassicTool.Activities.ReadTag.java
de.syss.MifareClassicTool.Activities.TagInfoTool.java
de.syss.MifareClassicTool.Activities.ValueBlockTool.java
de.syss.MifareClassicTool.Activities.ValueBlocksToInt.java
de.syss.MifareClassicTool.Activities.WriteTag.java
de.syss.MifareClassicTool.Activities.package-info.java
de.syss.MifareClassicTool.package-info.java