MIFARE® Card Programming - µFR Simple Software SDK

• • ReaderÖffnen: Öffnet einen Port des verbundenen Lesegeräts. Bei Multithread-Anwendungen müssen Entwickler darauf achten, den Zugriff auf die Ressourcen des RFID-Lesegeräts zu synchronisieren, um unvorhergesehene Situationen zu vermeiden.
  • GetReaderType: Gibt die Gerätetyp-ID zurück. Bei IS21-Lesegeräten ist dieser Wert 0xD1150021.
  • GetReaderSerialNumber: Gibt die Seriennummer des Geräts zurück.
  • GetCardId: Diese Funktion gibt die Typkennung und die Seriennummer der Karte zurück, die in das RFID-Lesegerät eingegeben werden.
  • ReaderClose: Schließt den Port des Lesers. Dies ermöglicht den Zugriff auf das RFID-Lesegerät aus anderen Prozessen.

ReaderUISignal:

Die Funktion dient zur Steuerung des Licht- und Tonsignals des NFC-RFID-Lesers. Es gibt vier Modi von Lichtsignalen und fünf Tonmodi:
• • ucLightSignalMode Definiert den Lichtsignalmodus. Es kann Werte von 0 bis 4 haben. Ein Wert von 0 zeigt Inaktivität von Lichtsignalen an.
  • ucBeepSignalMode Definiert den Tonsignalmodus. Es kann Werte von 0 bis 5 haben. Der Wert 0 zeigt Inaktivität von Tonsignalen an.

LinearWrite

Diese Funktion wird verwendet, um Daten mithilfe der Emulation des linearen Adressraums auf die Karte zu schreiben. Das Verfahren zum Nachweis der Authentizität wird durch das Suffix im Namen der Funktion bestimmt:

• aucData – Zeiger auf die Sequenz von Bytes, die Daten zum Schreiben auf der Karte enthalten
• usLinearAddress – Lineare Adresse der Karte, auf der das Schreiben von Daten vorgesehen ist
• usDataLength – Anzahl der Bytes für den Eintrag. In UC-Daten müssen mindestens usDataLength-Bytes zugewiesen werden, bevor die Funktion aufgerufen werden kann.
• lpusBytesWritten – Zeiger auf eine Variable vom Typ "unsigned short", in die die Anzahl der erfolgreich gelesenen Bytes von der Karte geschrieben wird. Wenn der Eintrag erfolgreich abgeschlossen wurde, entsprechen diese Daten dem usDataLength-Parameter. Wenn beim Schreiben einiger Blöcke ein Fehler aufgetreten ist, gibt die Funktion die Anzahl der erfolgreich geschriebenen Bytes über diesen Parameter zurück.
• ucAuthKey – Dieser Parameter definiert, ob die Authentifizierung mit dem Schlüssel A oder dem Schlüssel B durchgeführt werden soll. Es kann zwei Werte haben, nämlich: AUTHENT1A (0x60) oder AUTHENT1B (0x61).
• ucReaderKeyIndex – Die Standardauthentifizierungsmethode (wenn die Funktionen ohne Suffix verwendet werden) führt den Authentizitätsnachweis mithilfe des ausgewählten Schlüsselindexes aus dem RFID-Lesegerät durch. Im linearen Adressmodus gilt dies für alle Sektoren, die geschrieben werden.

LinearRead

Diese Funktionen werden zum Lesen von Kartendaten mithilfe der linearen Adressraumemulation verwendet.

• aucData – Zeiger auf die Sequenz von Bytes, in denen gelesene Daten gespeichert werden.
• usLinearAddress – Lineare Adresse auf der Karte, von der die Daten gelesen werden sollen
• usDataLength – Anzahl der zu lesenden Bytes. Für aucData müssen vor dem Aufruf der Funktion mindestens usDataLength-Bytes zugewiesen werden.
• lpusBytesReturned – Zeiger auf die Variable vom Typ "unsigned short", in die die Anzahl der erfolgreich gelesenen Bytes von der Karte geschrieben wird. Wenn das Lesen vollständig verwaltet wird, entsprechen diese Daten dem usDataLength-Parameter. Wenn beim Lesen einiger Blöcke ein Fehler auftritt, gibt die Funktion alle erfolgreich gelesenen Daten in den AUC-Daten vor dem Auftreten des Fehlers zurück, und die Anzahl der erfolgreich gelesenen Bytes wird über diesen Parameter zurückgegeben
• ucAuthMode – Dieser Parameter definiert, ob die Authentifizierung mit Schlüssel A oder Schlüssel B durchgeführt werden soll. Es kann zwei Werte haben, nämlich: AUTHENT1A (0x60) oder AUTHENT1B (0x61).
• ucReaderKeyIndex – Die Standardauthentifizierungsmethode (wenn die Funktionen ohne Suffix verwendet werden) führt den Authentizitätsnachweis mithilfe des ausgewählten Schlüsselindexes aus dem RFID-Lesegerät durch. Im linearen Adressmodus gilt dies für alle Sektoren, die gelesen werden.

LinearFormatCard

Diese Funktion wird zum Formatieren einer Karte verwendet, indem alle Kartendaten mit Standardbytedaten [32 (Dec), 20(hex)]neu geschrieben werden.

• ucReaderKeyIndex – Die Standardauthentifizierungsmethode (wenn die Funktionen ohne Suffix verwendet werden) führt den Authentizitätsnachweis mithilfe des ausgewählten Schlüsselindexes aus dem RFID-Lesegerät durch. Im linearen Adressmodus gilt dies für alle Sektoren, die geschrieben werden.