home Introduction

done Pycom Products
done Getting Started
done Tutorials & Examples
done Firmware & API Reference
- done Pycom Modules
  - done machine
  - done network
  - done AES
  - done Pycom
  - done Shields
    - done Pycoproc
    - done Pycoproc2
    - done LIS2HH12
    - done LTR329ALS01
    - done SI7006A20
    - done MPL3115A2
    - done MFRC630
    - done L76GNSS
- done MicroPython Modules
- done Interrupts
done Product Info, Datasheets
done Update Firmware
done Pybytes
done Cellular Services
done Pymesh
done Micropython Support
done Advanced topics
done License

Ask on the forum

Firmware & API Reference > Pycom Modules > Shields > MFRC630

NFC and RFID reader

The MFRC630 is a NFC and RFID card reader.

Constructors

class MFRC630(pycoproc=None, sda='P22’, scl='P21’, timeout=None, debug=False)

Creates a MFRC630 object. Constructor must be passed a Pycoproc or I2C object to successfully construct.

Methods

MFRC630.mfrc630_cmd_init()

Initialises the MFRC630.

MFRC630.mfrc630_cmd_reset()

Reset the device. Stops the currently active command and resets device.

MFRC630.mfrc630_cmd_idle()

Set the device into idle mode. Stops the currently active command and return to idle mode.

MFRC630.mfrc630_cmd_load_key(key)

Loads the provided key into the key buffer.

key Array which holds the MIFARE key, it is always 6 bytes long

MFRC630.mfrc630_MF_read_block(block_address, dest)

Reads a block of memory from an authenticated card. Try to read a block of memory from the card with the appropriate timeouts and error checking.

block_address The block to read
dest The array in which to write the 16 bytes read from the card

Returns 0 for failure, otherwise the number of bytes received.

MFRC630.mfrc630_MF_auth(uid, key_type, block)

Perform a MIFARE authentication procedure. This function is a higher-level wrapper around the MF authenticate command. The result of the authentication is checked to identify whether it appears to have succeeded. The key must be loaded into the key buffer with MFRC630.mfrc630_cmd_load_key(key).

Once authenticated, the authentication MUST be stopped manually by calling the mfrc630_MF_deauth() function or otherwise disabling the Crypto1 ON bit in the status register.

key_type: The MIFARE key A or B (MFRC630_MF_AUTH_KEY_A or MFRC630_MF_AUTH_KEY_B) to use
block: The block to authenticate
uid: The authentication procedure required the first four bytes of the card’s UID to authenticate

Returns 0 in case of failure, nonzero in case of success.

MFRC630.mfrc630_MF_deauth()

Disables MIFARE authentication. Disable the Crypto1 bit from the status register to disable encryption.

MFRC630.mfrc630_iso14443a_WUPA_REQA(instruction)

Send WUPA and REQA. Returns the response byte, the answer to request A byte (ATQA), or 0 in case of no answer.

instruction: MFRC630_ISO14443_CMD_WUPA, MFRC630_ISO14443_CMD_REQA

MFRC630.mfrc630_iso14443a_select(uid)

Performs the SELECT procedure to discover a card’s UID. This performs the SELECT procedure as explained in ISO14443A, this determines the UID of the card, if multiple cards are present, a collision will occur, which is handled according to the norm.

uid: The UID of the card will be stored into this array.

Returns the length of the UID in bytes (4, 7, 10), or 0 in case of failure.

MFRC630.print_debug(msg)

Prints debug statements if DEBUG is enabled.

MFRC630.format_block(block, length)

Prints block with length.

MFRC630.mfrc630_format_block(data, len)

Converts data to hexadecimal format.

data The array to be formatted
len The number of bytes to format

MFRC630.mfrc630_print_block(data, len)

Prints the bytes in data array in hexadecimal format, separated by spaces using the mfrc630_format_block method.

data The array to be printed
len The number of bytes to print