#include "Librairie.h"
#include "TypeDefs.h"
#include "Hardware.h"

Graphe des dépendances par inclusion de Sw_Mf_Classic.h:

Macros
#define	ACC_BLOCK_TRANSPORT 0x00

#define	ACC_BLOCK_READWRITE 0x04

#define	ACC_BLOCK_VALUE 0x06

#define	ACC_AUTH_TRANSPORT 0x01

#define	ACC_AUTH_NORMAL 0x03

#define	AuthKeyA TRUE

#define	AuthKeyB FALSE

Fonctions
ODALID_LIB int16_t	Mf_Classic_LoadKey (ReaderName pName, BOOL AuthKey, uint8_t pKey, uint8_t KeyIndex)
	Chargement des clés MIFARE dans le secure element du lecteur pour lecteurs CDC1 / CDC2 / TCP1 et TCP2.

ODALID_LIB int16_t	Mf_Classic_LoadKey2 (ReaderName pName, uint8_t pKeyA, uint8_t *pKeyB, uint8_t KeyIndex)
	Chargement des clés MIFARE dans le secure element du lecteur pour lecteurs AccessControl / CDC1 / CDC2 / CDC3 / TCP1 / TCP2 et TCP3.

ODALID_LIB int16_t	Mf_Classic_PersonalizeUID (ReaderName *pName, uint8_t Type)
	Personnalisation de l'UID.

ODALID_LIB int16_t	Mf_Classic_Authenticate (ReaderName pName, BOOL AuthKey, BOOL internal_Key, uint8_t Sector, uint8_t pKey, uint8_t KeyIndex)
	Phase d'Authentification pour la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_Read_Block (ReaderName pName, BOOL Auth, uint8_t Block, uint8_t pData, BOOL AuthKey, uint8_t KeyIndex)
	Lecture d’un Block de la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_Write_Block (ReaderName pName, BOOL Auth, uint8_t Block, uint8_t pData, BOOL AuthKey, uint8_t KeyIndex)
	Écriture d’un Block de la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_Read_Sector (ReaderName pName, BOOL Auth, uint8_t Sector, uint8_t pData, BOOL AuthKey, uint8_t KeyIndex)
	Lecture d’un Secteur de la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_Write_Sector (ReaderName pName, BOOL Auth, uint8_t Sector, uint8_t pData, BOOL AuthKey, uint8_t KeyIndex)
	Ecriture d’un Secteur de la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_UpdadeAccessBlock (ReaderName pName, BOOL Auth, uint8_t Sector, uint8_t OldKeyIndex, uint8_t pNewKeyA, uint8_t *pNewKeyB, uint8_t Bc0, uint8_t Bc1, uint8_t Bc2, uint8_t Bc3, BOOL AuthKey)
	Mise à jour des conditions d'accès et des clés de sécurité

ODALID_LIB int16_t	Mf_Classic_Read_Value (ReaderName pName, BOOL Auth, uint8_t Block, uint32_t pValue, BOOL AuthKey, uint8_t KeyIndex)
	Lecture de la Value contenue dans le Block de la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_Write_Value (ReaderName *pName, BOOL Auth, uint8_t Block, uint32_t Value, BOOL AuthKey, uint8_t KeyIndex)
	Écriture d'une Value dans un Block de la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_Increment_Value (ReaderName *pName, BOOL Auth, uint8_t Block, uint32_t Value, uint8_t trans_Block, BOOL AuthKey, uint8_t KeyIndex)
	Incrément de la Value du Block de la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_Decrement_Value (ReaderName *pName, BOOL Auth, uint8_t Block, uint32_t Value, uint8_t trans_Block, BOOL AuthKey, uint8_t KeyIndex)
	Décrémentation du Block de la carte MIFARE Classic.

ODALID_LIB int16_t	Mf_Classic_Restore_Value (ReaderName *pName, BOOL Auth, uint8_t Block, uint8_t trans_Block, BOOL AuthKey, uint8_t KeyIndex)
	Restauration de la Value.

Description détaillée

Fonction Mf_Classic

Auteur: Vincent T.

Version: 0.1

Date: 18 Novembre 2021

Documentation des macros

◆ ACC_AUTH_NORMAL

#define ACC_AUTH_NORMAL 0x03

???.

◆ ACC_AUTH_TRANSPORT

#define ACC_AUTH_TRANSPORT 0x01

???.

◆ ACC_BLOCK_READWRITE

#define ACC_BLOCK_READWRITE 0x04

???.

◆ ACC_BLOCK_TRANSPORT

#define ACC_BLOCK_TRANSPORT 0x00

???.

◆ ACC_BLOCK_VALUE

#define ACC_BLOCK_VALUE 0x06

???.

◆ AuthKeyA

#define AuthKeyA TRUE

???.

◆ AuthKeyB

#define AuthKeyB FALSE

???.

Documentation des fonctions

◆ Mf_Classic_Authenticate()

ODALID_LIB int16_t Mf_Classic_Authenticate	(	ReaderName *	pName,
		BOOL	AuthKey,
		BOOL	internal_Key,
		uint8_t	Sector,
		uint8_t *	pKey,
		uint8_t	KeyIndex )

Phase d'Authentification pour la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
internal_Key	[In] Authentification via les clés contenues dans le lecteur TRUE -> OK ou FALSE -> utilisation de la chaîne Key.
Sector	[In] secteur de la carte MIFARE Classic 1K (0 à 15) / MIFARE Classic 4K (0 à 39).
pKey	[In] pKey[6] Clé ignorée si internal_Key = TRUE.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_Decrement_Value()

ODALID_LIB int16_t Mf_Classic_Decrement_Value	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Block,
		uint32_t	Value,
		uint8_t	trans_Block,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Décrémentation du Block de la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Block	[In] Bloc de la carte MIFARE.
Value	[In] Valeur de décrémentation.
trans_Block	[In] Bloc dans lequel la Value sera transmise.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_Increment_Value()

ODALID_LIB int16_t Mf_Classic_Increment_Value	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Block,
		uint32_t	Value,
		uint8_t	trans_Block,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Incrément de la Value du Block de la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Block	[In] Bloc de la carte MIFARE.
Value	[In] Valeur d'incrémentation.
trans_Block	[In] Bloc dans lequel la Value sera transmise.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_LoadKey()

ODALID_LIB int16_t Mf_Classic_LoadKey	(	ReaderName *	pName,
		BOOL	AuthKey,
		uint8_t *	pKey,
		uint8_t	KeyIndex )

Chargement des clés MIFARE dans le secure element du lecteur pour lecteurs CDC1 / CDC2 / TCP1 et TCP2.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
pKey	[In] pKey[6] Clé
KeyIndex	[In] Index de l’EEPROM (0 à 15).

◆ Mf_Classic_LoadKey2()

ODALID_LIB int16_t Mf_Classic_LoadKey2	(	ReaderName *	pName,
		uint8_t *	pKeyA,
		uint8_t *	pKeyB,
		uint8_t	KeyIndex )

Chargement des clés MIFARE dans le secure element du lecteur pour lecteurs AccessControl / CDC1 / CDC2 / CDC3 / TCP1 / TCP2 et TCP3.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
pKeyA	[In] pKeyA[6] Clé A
pKeyB	[In] pKeyB[6] Clé B
KeyIndex	[In] Index de l’EEPROM (0 à 15).

◆ Mf_Classic_PersonalizeUID()

ODALID_LIB int16_t Mf_Classic_PersonalizeUID	(	ReaderName *	pName,
		uint8_t	Type )

Personnalisation de l'UID.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Type	[In] ???.

◆ Mf_Classic_Read_Block()

ODALID_LIB int16_t Mf_Classic_Read_Block	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Block,
		uint8_t *	pData,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Lecture d’un Block de la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Block	[In] Bloc de la carte MIFARE.
pData	[Out] pData[16] Données lu.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_Read_Sector()

ODALID_LIB int16_t Mf_Classic_Read_Sector	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Sector,
		uint8_t *	pData,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Lecture d’un Secteur de la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Sector	[In] Secteur de la carte MIFARE.
pData	[Out] pData[48] Données lu.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_Read_Value()

ODALID_LIB int16_t Mf_Classic_Read_Value	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Block,
		uint32_t *	pValue,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Lecture de la Value contenue dans le Block de la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Block	[In] Bloc de la carte MIFARE.
pValue	[Out] Valeur lue.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_Restore_Value()

ODALID_LIB int16_t Mf_Classic_Restore_Value	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Block,
		uint8_t	trans_Block,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Restauration de la Value.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Block	[In] Bloc de la carte MIFARE.
trans_Block	[In] Bloc dans lequel la Value sera transmise.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_UpdadeAccessBlock()

ODALID_LIB int16_t Mf_Classic_UpdadeAccessBlock	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Sector,
		uint8_t	OldKeyIndex,
		uint8_t *	pNewKeyA,
		uint8_t *	pNewKeyB,
		uint8_t	Bc0,
		uint8_t	Bc1,
		uint8_t	Bc2,
		uint8_t	Bc3,
		BOOL	AuthKey )

Mise à jour des conditions d'accès et des clés de sécurité

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Sector	[In] Information sur le lecteur.
OldKeyIndex	[In] Information sur le lecteur.
pNewKeyA	[In] pNewKeyA[6] Nouvelle Clé A.
pNewKeyB	[In] pNewKeyB[6] Nouvelle Clé B.
Bc0	[In] Conditions d'accès pour le Block 0.
Bc1	[In] Conditions d'accès pour le Block 1.
Bc2	[In] Conditions d'accès pour le Block 2.
Bc3	[In] Conditions d'accès pour le Block 3.
AuthKey	[In] Clé d'Authentification utilisé : AuthKeyA ou AuthKeyB.

◆ Mf_Classic_Write_Block()

ODALID_LIB int16_t Mf_Classic_Write_Block	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Block,
		uint8_t *	pData,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Écriture d’un Block de la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Block	[In] Bloc de la carte MIFARE.
pData	[In] pData[16] Données à écrire.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_Write_Sector()

ODALID_LIB int16_t Mf_Classic_Write_Sector	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Sector,
		uint8_t *	pData,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Ecriture d’un Secteur de la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Sector	[In] Secteur de la carte MIFARE.
pData	[In] pData[48] Données à écrire.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

◆ Mf_Classic_Write_Value()

ODALID_LIB int16_t Mf_Classic_Write_Value	(	ReaderName *	pName,
		BOOL	Auth,
		uint8_t	Block,
		uint32_t	Value,
		BOOL	AuthKey,
		uint8_t	KeyIndex )

Écriture d'une Value dans un Block de la carte MIFARE Classic.

Renvoie: Status code

Valeurs retournées

MI_OK Operation successful ou erreur

Paramètres

pName	[In] Information sur le lecteur.
Auth	[In] Authentification automatique TRUE -> Authentification automatique dans le lecteur FALSE -> pas d’Authentification automatique.
Block	[In] Bloc de la carte MIFARE.
Value	[In] Valeur à écrire.
AuthKey	[In] Clé d'Authentification AuthKeyA ou AuthKeyB.
KeyIndex	[In] Index de la clé stocké en interne dans le coupleur (0 à 15) ignorée si internal_Key = FALSE.

Macros

Fonctions

Description détaillée

Documentation des macros

◆ ACC_AUTH_NORMAL

◆ ACC_AUTH_TRANSPORT

◆ ACC_BLOCK_READWRITE

◆ ACC_BLOCK_TRANSPORT

◆ ACC_BLOCK_VALUE

◆ AuthKeyA

◆ AuthKeyB

Documentation des fonctions

◆ Mf_Classic_Authenticate()

◆ Mf_Classic_Decrement_Value()

◆ Mf_Classic_Increment_Value()

◆ Mf_Classic_LoadKey()

◆ Mf_Classic_LoadKey2()

◆ Mf_Classic_PersonalizeUID()

◆ Mf_Classic_Read_Block()

◆ Mf_Classic_Read_Sector()

◆ Mf_Classic_Read_Value()

◆ Mf_Classic_Restore_Value()

◆ Mf_Classic_UpdadeAccessBlock()

◆ Mf_Classic_Write_Block()

◆ Mf_Classic_Write_Sector()

◆ Mf_Classic_Write_Value()