DFRobot_PN532

SKU: DFR0231-H

   /*!
    * @fn readData
    * @brief 读取nfc卡中一个block的所有数据(每一个block中有 16 byte 的数据)
    * @param buffer 缓存已经读到数据的
    * @param block 要读取block的编号.
    * @return 状态码. 
    * @retval 1 成功读取数据
    * @retval -1 读取数据失败
    */   
   uint8_t readData(uint8_t *buffer,uint8_t block);

   /*!
    * @fn readData
    * @brief 读取nfc卡片中某一个block中的某一个数据(每一个block中有 16 byte 的数据)
    * @param block 要读取的block的编号
    * @param offset 要读取数据在block中的偏移. 
    * @return 从nfc卡片中读到的一个数据. 
    */  
   uint8_t readData(int block, uint8_t offset);

   /*!
    * @fn writeData
    * @brief 写一个数据道到nfc卡片中.
    * @param block 需要写入数据的block.
    * @param num 需要写入数据在block中的偏移. 
    * @param data 要写入的数据.
    */  
   void writeData (int block, uint8_t num ,uint8_t data);

   /*!
    * @fn scan
    * @brief  扫描是否有nfc卡片. 
    * @return 布尔类型, 扫描的结果
    * @retval true 发现一个nfc卡片.
    * @retval false 未发现卡片
    */ 
   bool  scan(void);

   /*!
    * @fn scan
    * @brief Scan 扫描是否存在一个特定id的nfc卡片
    * @param nfcuid UID.
    * @return 布尔类型, 扫描的结果
    * @retval true 存在一个特定UID的卡片
    * @retval false 不存在一个特定UID的卡片
    */   
   bool  scan(String nfcuid);

   /*!
    * @fn readUid
    * @brief 获取卡片的UID .
    * @return UID .
    */  
   String  readUid();

   /*!
    * @fn writeData
    * @brief 写一个block的数据到nfc卡片中(每一个block中有 16 byte 的数据).
    * @param block 要写入block的编号.
    * @param data 要写入的数据. 
    */  
   bool  writeData(int block, uint8_t data[]);

   /*!
    * @fn readUltralight
    * @brief 读取一个block的数据从 Ultralight类型的nfc卡片
    * @param buffer 缓存读到数据的buffer. 
    * @param block 要读取block的编号.
    * @return 错误码
    */
   uint8_t readUltralight(uint8_t *buffer,uint8_t block);

   /*!
    * @fn writeUltralight
    * @brief 写一个block的数据到Ultralight类型的nfc卡片
    * @param block 需要写入的block的编号.
    * @param data 需要写入的数据. 
    * @return 布尔类型, 写入的结果
    * @retval true 写成功
    * @retval false 写失败
    */
   bool  writeUltralight(int block, uint8_t data[]);

   /*!
    * @fn readNTAG
    * @brief 读取一个block的数据从NTAG类型的nfc卡片
    * @param buffer 缓存读到数据的buffer. 
    * @param block 要读取block的编号.
    * @return 错误码
    * @retval 1 读取成功
    * @retval -1 读取失败
    */
   uint8_t readNTAG(uint8_t *buffer,uint8_t block);

   /*!
    * @fn writeNTAG
    * @brief 写一个block的数据到NTAG类型的nfc卡片
    * @param block 需要写入的block的编号.
    * @param data 需要写入的数据. 
    * @return 布尔类型, 写入的结果
    * @retval true 写成功
    * @retval false 写失败
    */
   bool  writeNTAG(int block, uint8_t data[]);

   /*!
    * @fn readData
    * @brief 读取NFC卡片的基本信息. 
    * @return 保存信息的结构体.
    */
   sCard_t getInformation();