Aprender

Uma porta RFID com Arduino e o leitor RC522

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: porta RFID com um RC522ao vivo0.000 s 0.00x
Clique para abrir no editor
O exemplo da porta RFID num ATmega328P simulado. Encoste um cartão: o UID é impresso e o LED verde ou vermelho responde.

O RC522 é a placa RFID azul que vem em quase todo kit de Arduino, com um cartão branco e um chaveiro azul no saquinho. Encoste um cartão nele e a placa lê o número de ID do cartão. Isso é tudo de que você precisa para montar uma tranca de porta, um relógio de ponto ou um registro de "quem está aqui".

O circuito acima é um Arduino Uno com um RC522 e dois LEDs. Encoste um cartão ao lado do leitor e o Uno imprime o ID dele. Dois dos quatro cartões acendem o LED verde. Os outros dois acendem o vermelho. Ele roda no seu navegador com o mesmo sketch que você pode ler abaixo, então você pode mudar a lista de cartões e rodar de novo.

O que você precisa

  • Um Arduino Uno
  • Um módulo RFID RC522 (MFRC522) com seu cartão e chaveiro
  • Um LED verde e um LED vermelho, cada um com um resistor de 220 ohms
  • Uma protoboard de meio tamanho e fios jumpers

Ligação

Componente e pinoVai paraNota
RC522 SDAPino 10Este é o chip select do SPI, mesmo estando rotulado como SDA
RC522 SCKPino 13Clock do SPI
RC522 MOSIPino 11Dados do Uno para o leitor
RC522 MISOPino 12Dados do leitor para o Uno
RC522 RSTPino 9Reset; o sketch dá nome a este pino
RC522 3.3V3.3 VNão é 5 V
RC522 GNDGNDTerra compartilhado
RC522 IRQNão conectadoA maioria dos sketches deixa sem ligação
LED verdePino 7Por um resistor de 220 ohms até o GND
LED vermelhoPino 6Por um resistor de 220 ohms até o GND

Como o leitor encontra um cartão

O RC522 conversa com cartões de 13,56 MHz, o mesmo tipo usado em chaves de hotel e cartões de ônibus. Cada cartão tem um UID, um número de identificação curto definido na fábrica. O cartão MIFARE branco tem um UID de quatro bytes. Um adesivo NFC tem um de sete bytes.

O Uno conversa com o leitor por SPI, que são quatro fios: um clock, um fio de dados para cada lado e um chip select. A biblioteca MFRC522 faz a parte difícil. Seu sketch faz duas perguntas seguidas: tem um cartão novo, e dá para ler o número de série dele? Se as duas respostas forem sim, o UID está esperando em reader.uid.

O sketch, passo a passo

Em setup(), o sketch inicia o SPI e o leitor, e então imprime a versão de firmware do leitor. Essa única linha é o seu teste de ligação. Com uma conexão boa, ele imprime "Firmware Version: 0x92 = v2.0".

Em loop(), ele espera um cartão. Quando um chega, imprime cada byte do UID em hexadecimal. Depois compara o UID com uma lista curta chamada ALLOWED. Uma correspondência acende o LED verde por um segundo e meio. Qualquer outra coisa acende o vermelho.

A última chamada, PICC_HaltA(), coloca o cartão para dormir. Um cartão dormindo fica quieto até sair do campo. É por isso que um cartão deixado sobre o leitor abre a porta uma vez, e não uma vez a cada loop. Retire-o do campo e aproxime-o de novo para ler de novo.

O loop, do exemplo da porta com RFID
void loop()
{
    if (!reader.PICC_IsNewCardPresent() || !reader.PICC_ReadCardSerial()) {
        return;
    }
    Serial.print("UID:");
    for (byte i = 0; i < reader.uid.size; i++) {
        Serial.print(reader.uid.uidByte[i] < 0x10 ? " 0" : " ");
        Serial.print(reader.uid.uidByte[i], HEX);
    }
    Serial.println();

    int led = onTheList() ? GREEN_LED : RED_LED;
    Serial.println(led == GREEN_LED ? "Welcome in." : "Not this card.");
    reader.PICC_HaltA();

    digitalWrite(led, HIGH);
    delay(1500);
    digitalWrite(led, LOW);
}

Corrigindo "Firmware Version: 0x0 = (unknown)" ou 0xFF

This is the RC522 error people ask about most. The full message is "Firmware Version: 0x0 = (unknown)", or the same with 0xFF, and then "WARNING: Communication failure, is the MFRC522 properly connected?" It means the Uno asked the reader a question and got nothing back: with nothing driving MISO, the pin floats and reads all zeros or all ones, whichever it happens to be sitting at.

Você pode provocar esse erro de propósito aqui. Abra o circuito no editor e apague o fio do MISO, ou o do 3,3 V, e aperte Rodar. O monitor serial imprime exatamente esse aviso, aqui com 0xFF, porque o pino solto está por acaso em nível alto. Coloque o fio de volta e a linha da versão volta também.

Numa bancada de verdade, verifique estas coisas em ordem. O MISO está no pino 12 e o MOSI no pino 11, sem troca? O SDA está no pino que o seu sketch indica (aqui, 10)? O módulo recebe 3,3 V e um terra compartilhado? Os pinos de cabeçalho estão soldados ao módulo? Um módulo com pinos frouxos apenas encaixados nos furos é uma causa muito comum.

Adicione o seu próprio cartão

Você não precisa saber o UID de um cartão com antecedência. Toque com qualquer cartão e copie os quatro bytes que o monitor serial imprime. Cole-os em ALLOWED como uma nova linha, como {0xC3, 0x5A, 0x1E, 0x94}, e rode o sketch de novo. Esse cartão agora abre a porta.

Você também pode mudar os próprios cartões. Clique no leitor e veja a propriedade uids dele no painel de propriedades. Ela guarda até quatro cartões como bytes em hexadecimal, separados por vírgulas.

Experimente no editor

Troque o delay(1500) por delay(5000) e a porta fica aberta por cinco segundos. Adicione um buzzer em outro pino que apita para o cartão vermelho.

Troque o LED verde por um servo e você tem uma tranca de verdade. A biblioteca Servo funciona aqui do mesmo jeito que funciona num Uno real.

Erros comuns

Alimentando o módulo com 5 V. O RC522 é uma placa de 3,3 V. Use o pino de 3,3 V do Uno.

Trocar o SDA e o pino de reset. O construtor da biblioteca recebe primeiro o pino de chip select e depois o pino de reset: MFRC522 reader(10, 9).

Esperar que um cartão seja lido a cada loop. Depois de PICC_HaltA(), um cartão precisa sair do campo e voltar antes de ser lido de novo.

Comparar um adesivo de sete bytes com uma lista de quatro bytes. Verifique primeiro reader.uid.size, como o exemplo faz.

Abra este circuito no editor. Arduino Uno: porta com RFID usando um RC522, ligado como aparece no topo desta página. Mude um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Quais pinos um RC522 usa num Arduino Uno?

SCK no 13, MOSI no 11, MISO no 12, SDA (chip select) no 10 e RST no 9, com 3,3 V e terra. Os pinos 11, 12 e 13 são os pinos SPI do Uno, então são fixos. SDA e RST podem mudar se você alterar os números no sketch.

Por que meu RC522 mostra "Firmware Version: 0x0" ou "0xFF"?

O Uno não recebeu resposta do leitor. Quase sempre é a ligação: MISO e MOSI trocados, sem 3,3 V, sem terra compartilhado, pino SDA errado no sketch, ou pinos de cabeçalho sem solda. Puxe um fio no circuito acima e você verá a mesma mensagem.

O RC522 pode gravar num cartão?

Sim. Com a chave certa, MIFARE_Read e MIFARE_Write funcionam num cartão MIFARE Classic aqui, e o que você grava fica no cartão pelo resto da execução. A chave de todo setor é FF FF FF FF FF FF, como vem de fábrica.

O que o Mokxi não simula no RC522?

O rádio. Não há alcance, nem força de campo, nem colisão entre dois cartões. Só um cartão fica sobre a antena por vez. Os registradores do chip, seu link SPI e o modo como os cartões respondem são simulados a partir das folhas de dados.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.