nearfieldtargetinfo.cpp

/****************************************************************************
**
** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Andreas Jakl (andreas.jakl@nokia.com)
**
** Released under Nokia Example Code License.
** See license.txt in the main project folder.
**
****************************************************************************/

#include "nearfieldtargetinfo.h"

/*!
  \brief New target info, using default values.
  */
NearFieldTargetInfo::NearFieldTargetInfo()
{
    resetInfo();
}

/*!
  \brief Reset all stored data to the defaults.
  */
void NearFieldTargetInfo::resetInfo()
{
    tagTypeName = "";
    tagMajorVersion = 0;
    tagMinorVersion = 0;
    tagMemorySize = -1;
    tagWritableSize = -1;
    tagReadAccessCC = NfcAccessUnknown;
    tagWriteAccessCC = NfcAccessUnknown;
    tagReadAccessLockBits = NfcAccessUnknown;
    tagWriteAccessLockBits = NfcAccessUnknown;
    tagMemoryType = NfcMemoryUnknown;
}

/*!
  \brief Check if both the lock bits of the tag as well as the
  capability container (CC) indicate that the tag is readable.
  */
NearFieldTargetInfo::NfcTagAccessStatus NearFieldTargetInfo::combinedReadAccess() const
{
    return combineAccess(tagReadAccessCC, tagReadAccessLockBits);
}

/*!
  \brief Check if both the lock bits of the tag as well as the
  capability container (CC) indicate that the tag is writable.
  */
NearFieldTargetInfo::NfcTagAccessStatus NearFieldTargetInfo::combinedWriteAccess() const
{
    return combineAccess(tagWriteAccessCC, tagWriteAccessLockBits);
}

/*!
  \brief Internal method used to combine the access status of CC and lock bits.

  If either CC or lock bits, or both indicate it's forbidden, it is overall forbidden.
  If either CC or lock bits, or both indicate that access is allowed, it is overall allowed.
  In all othercases, the access is unknown.
  */
NearFieldTargetInfo::NfcTagAccessStatus NearFieldTargetInfo::combineAccess(const NfcTagAccessStatus accessCC, const NfcTagAccessStatus accessLockBits) const
{
    if (accessCC == NfcAccessForbidden ||
        accessLockBits == NfcAccessForbidden) {
        // If one access states access is forbidden, best estimate is
        // that it's not allowed in general.
        return NfcAccessForbidden;
    } else if (accessCC == NfcAccessAllowed ||
        accessLockBits == NfcAccessAllowed) {
        // Both CC and lock bits indicate that the access is allowed
        return NfcAccessAllowed;
    } else
    // Mixed status or unknown in general
    return NfcAccessUnknown;
}