samcommands.hpp

Go to the documentation of this file.

 
#ifndef LOGICALACCESS_SAMCOMMANDS_HPP
#define LOGICALACCESS_SAMCOMMANDS_HPP
 
#include <logicalaccess/cards/location.hpp>
#include <logicalaccess/cards/commands.hpp>
#include <logicalaccess/plugins/cards/samav/samkeyentry.hpp>
#include <logicalaccess/plugins/cards/samav/samkucentry.hpp>
 
namespace logicalaccess
{
#define CMD_SAM "SAM"
 
typedef struct s_SAMManufactureInformation
{
    unsigned char uniqueserialnumber[7];
    unsigned char productionbatchnumber[5];
    unsigned char dayofproduction;
    unsigned char monthofproduction;
    unsigned char yearofproduction;
    unsigned char globalcryptosettings;
    unsigned char modecompatibility;
} SAMManufactureInformation;
 
typedef struct s_SAMVersionInformation
{
    unsigned char vendorid;
    unsigned char type;
    unsigned char subtype;
    unsigned char majorversion;
    unsigned char minorversion;
    unsigned char storagesize;
    unsigned char protocoltype;
} SAMVersionInformation;
 
typedef struct s_SAMVersion
{
    SAMVersionInformation hardware;
    SAMVersionInformation software;
    SAMManufactureInformation manufacture;
} SAMVersion;
 
enum SAMLockUnlock
{
    Unlock                   = 0x00,
    LockWithoutSpecifyingKey = 0x01,
    LockWithSpecifyingKey    = 0x02,
    SwitchAV2Mode            = 0x03
};
 
class DESFireKey;
 
// todo: We removed export macro to fix link issue. need to investigate more.
template <typename T, typename S>
class SAMCommands : public Commands
{
  public:
    SAMCommands()
        : Commands(CMD_SAM)
    {
    }
    explicit SAMCommands(std::string ct)
        : Commands(ct)
    {
    }
    virtual SAMVersion getVersion() = 0;
    virtual std::shared_ptr<SAMKeyEntry<T, S>> getKeyEntry(unsigned char keyno) = 0;
    virtual std::shared_ptr<SAMKucEntry> getKUCEntry(unsigned char keyno) = 0;
    virtual void changeKeyEntry(unsigned char keyno,
                                std::shared_ptr<SAMKeyEntry<T, S>> keyentry,
                                std::shared_ptr<DESFireKey> key) = 0;
    virtual void changeKUCEntry(unsigned char keyno,
                                std::shared_ptr<SAMKucEntry> keyentry,
                                std::shared_ptr<DESFireKey> key) = 0;
    virtual void authenticateHost(std::shared_ptr<DESFireKey> key,
                                  unsigned char keyno) = 0;
    virtual std::string getSAMTypeFromSAM()            = 0;
    virtual void disableKeyEntry(unsigned char keyno)  = 0;
    virtual void selectApplication(ByteVector aid)     = 0;
    virtual ByteVector dumpSessionKey()                = 0;
    virtual void loadInitVector(ByteVector iv)         = 0;
    virtual ByteVector decipherData(ByteVector data, bool islastdata) = 0;
    virtual ByteVector encipherData(ByteVector data, bool islastdata) = 0;
    virtual ByteVector changeKeyPICC(const ChangeKeyInfo &info,
                                     const ChangeKeyDiversification &diversifycation) = 0;
    virtual void lockUnlock(std::shared_ptr<DESFireKey> masterKey, SAMLockUnlock state,
                            unsigned char keyno, unsigned char unlockkeyno,
                            unsigned char unlockkeyversion) = 0;
    virtual ByteVector transmit(ByteVector cmd, bool first = true, bool last = true) = 0;
};
}
 
#endif /* LOGICALACCESS_SAMCOMMANDS_HPP */