使用低级 NFC 通信方法将 NDEF 数据写入 NTAG216 标签
Writing NDEF data to NTAG216 tag using low-level NFC communication methods
我已经实现了通过低级通信方法与 NTAG216 交互的代码(遵循 NTAG212 Mifare Ultralight with Authentication 和 NTAG216 的数据表)。
到目前为止我取得的成就:
- 如果未设置或 new/blank 标记,请在 NTAG216 上设置密码写保护。
- 如果密码已经设置,使用PWD_AUTH验证并比较PACK。
- 读取数据。
- Write/overwrite数据。
到目前为止我没能做到的事情:
- 检测我在其他应用程序中写入标签的 NDEF 消息。换句话说,我可以使用
writePage()
方法写入标签,也可以使用 readPage()
读取标签。但是,在编写页面时,我将 NdefMessage
转换为字节数组,既可以读取也可以写入。但是,在其他应用程序中未检测到此 NDEF 消息。
我需要做什么才能检测到我从其他应用程序写入的 NDEF 消息?
NTAG216 是 NFC 论坛 2 类标签。因此,在将数据写入此类 NFC 标签时,您必须遵循 NFC 论坛 Type 2 Tag Operation specification。
因此,您需要遵循一些规则才能使标签作为 NDEF 标签(类型 2 标签)被发现:
首先,需要配置能力容器(位于块3)。
- 字节 0 必须设置为 "magic" 值
0xE1
。
- 字节 1 必须设置为
0x10
以指示映射版本 1.0。
- 字节 2 必须设置为
0x6D
以指示 NTAG216 的内存大小。
- 字节 3 可以设置为
0x00
以指示 read/write 访问 NDEF 数据或设置为 0x0F
以指示 read-only 访问(请注意,这些是对应用层)。
所以你可以把能力容器写成:
byte[] response = nfc.transceive(new byte[] {
(byte)0xA2, // WRITE
(byte)3, // block address
(byte)0xE1, (byte)0x10, (byte)0x6D, (byte)0x00
});
NTAG216 已附带正确配置的功能容器,因此无需手动执行此操作。另请注意,块 3 是 one-time-programmable,这意味着位只能设置为 1,而不能再次清零。因此,如果您确实已经用不同的值覆盖了功能容器,那么该标签很可能不再用作 NDEF 标签。
数据必须写入从块 4 开始的数据块。NDEF 消息必须包装到 NDEF 消息 TLV (tag-length-value) 结构中。此 TLV 的标签是 0x03
。长度可以是 one-byte 格式(对于长度在 0 到 254 字节之间的 NDEF 消息)或 three-byte 格式(对于长度为 255 或更多字节的 NDEF 消息)。此 TLV 块的数据是实际的 NDEF 消息(您可以从 ndefMessage.toByteArray()
获得)。
例如,对于 NDEF 消息 D1 01 0C 55 01 65 78 61 6D 70 6C 65 2E 63 6F 6D 2F
(这是一个带有 URL“http://www.example.com/”的 URI 记录),您将获得以下 TLV 结构:
03 11 D1010C55016578616D706C652E636F6D2F
如果您有更长的 NDEF 消息(例如一个有 259 字节的消息),您将使用 three-byte 长度格式:
03 FF0103 D101FF5501...
此外,您应该使用终结符 TLV 标记标签上数据的结尾(标签 0xFE
,无长度和数据字段):
FE
然后您可以将此数据写入标签:
byte[] ndefMessage = new byte[] {
(byte)0xD1, (byte)0x01, (byte)0x0C, (byte)0x55, (byte)0x01, (byte)0x65, (byte)0x78, (byte)0x61, (byte)0x6D, (byte)0x70, (byte)0x6C, (byte)0x65, (byte)0x2E, (byte)0x63, (byte)0x6F, (byte)0x6D, (byte)0x2F
};
// wrap into TLV structure
byte[] tlvEncodedData = null;
if (ndefMessage.length < 255) {
tlvEncodedData = new byte[ndefMessage.length + 3];
tlvEncodedData[0] = (byte)0x03; // NDEF TLV tag
tlvEncodedData[1] = (byte)(ndefMessage.length & 0x0FF); // NDEF TLV length (1 byte)
System.arraycopy(ndefMessage, 0, tlvEncodedData, 2, ndefMessage.length);
tlvEncodedData[2 + ndefMessage.length] = (byte)0xFE; // Terminator TLV tag
} else {
tlvEncodedData = new byte[ndefMessage.length + 5];
tlvEncodedData[0] = (byte)0x03; // NDEF TLV tag
tlvEncodedData[1] = (byte)0xFF; // NDEF TLV length (3 byte, marker)
tlvEncodedData[2] = (byte)((ndefMessage.length >>> 8) & 0x0FF); // NDEF TLV length (3 byte, hi)
tlvEncodedData[3] = (byte)(ndefMessage.length & 0x0FF); // NDEF TLV length (3 byte, lo)
System.arraycopy(ndefMessage, 0, tlvEncodedData, 4, ndefMessage.length);
tlvEncodedData[4 + ndefMessage.length] = (byte)0xFE; // Terminator TLV tag
}
// fill up with zeros to block boundary:
tlvEncodedData = Arrays.copyOf(tlvEncodedData, (tlvEncodedData.length / 4 + 1) * 4);
for (int i = 0; i < tlvEncodedData.length; i += 4) {
byte[] command = new byte[] {
(byte)0xA2, // WRITE
(byte)((4 + i / 4) & 0x0FF), // block address
0, 0, 0, 0
};
System.arraycopy(tlvEncodedData, i, command, 2, 4);
byte[] response = nfc.transceive(command);
}
最后,请注意,如果在 NDEF 数据区域设置了 read-password,则不能将标签用作 NDEF 标签,因为 NFC 论坛类型 2 标签操作规范要求标签可自由读取.
我已经实现了通过低级通信方法与 NTAG216 交互的代码(遵循 NTAG212 Mifare Ultralight with Authentication 和 NTAG216 的数据表)。
到目前为止我取得的成就:
- 如果未设置或 new/blank 标记,请在 NTAG216 上设置密码写保护。
- 如果密码已经设置,使用PWD_AUTH验证并比较PACK。
- 读取数据。
- Write/overwrite数据。
到目前为止我没能做到的事情:
- 检测我在其他应用程序中写入标签的 NDEF 消息。换句话说,我可以使用
writePage()
方法写入标签,也可以使用readPage()
读取标签。但是,在编写页面时,我将NdefMessage
转换为字节数组,既可以读取也可以写入。但是,在其他应用程序中未检测到此 NDEF 消息。
我需要做什么才能检测到我从其他应用程序写入的 NDEF 消息?
NTAG216 是 NFC 论坛 2 类标签。因此,在将数据写入此类 NFC 标签时,您必须遵循 NFC 论坛 Type 2 Tag Operation specification。
因此,您需要遵循一些规则才能使标签作为 NDEF 标签(类型 2 标签)被发现:
首先,需要配置能力容器(位于块3)。
- 字节 0 必须设置为 "magic" 值
0xE1
。 - 字节 1 必须设置为
0x10
以指示映射版本 1.0。 - 字节 2 必须设置为
0x6D
以指示 NTAG216 的内存大小。 - 字节 3 可以设置为
0x00
以指示 read/write 访问 NDEF 数据或设置为0x0F
以指示 read-only 访问(请注意,这些是对应用层)。
所以你可以把能力容器写成:
byte[] response = nfc.transceive(new byte[] {
(byte)0xA2, // WRITE
(byte)3, // block address
(byte)0xE1, (byte)0x10, (byte)0x6D, (byte)0x00
});
NTAG216 已附带正确配置的功能容器,因此无需手动执行此操作。另请注意,块 3 是 one-time-programmable,这意味着位只能设置为 1,而不能再次清零。因此,如果您确实已经用不同的值覆盖了功能容器,那么该标签很可能不再用作 NDEF 标签。
数据必须写入从块 4 开始的数据块。NDEF 消息必须包装到 NDEF 消息 TLV (tag-length-value) 结构中。此 TLV 的标签是 0x03
。长度可以是 one-byte 格式(对于长度在 0 到 254 字节之间的 NDEF 消息)或 three-byte 格式(对于长度为 255 或更多字节的 NDEF 消息)。此 TLV 块的数据是实际的 NDEF 消息(您可以从 ndefMessage.toByteArray()
获得)。
例如,对于 NDEF 消息 D1 01 0C 55 01 65 78 61 6D 70 6C 65 2E 63 6F 6D 2F
(这是一个带有 URL“http://www.example.com/”的 URI 记录),您将获得以下 TLV 结构:
03 11 D1010C55016578616D706C652E636F6D2F
如果您有更长的 NDEF 消息(例如一个有 259 字节的消息),您将使用 three-byte 长度格式:
03 FF0103 D101FF5501...
此外,您应该使用终结符 TLV 标记标签上数据的结尾(标签 0xFE
,无长度和数据字段):
FE
然后您可以将此数据写入标签:
byte[] ndefMessage = new byte[] {
(byte)0xD1, (byte)0x01, (byte)0x0C, (byte)0x55, (byte)0x01, (byte)0x65, (byte)0x78, (byte)0x61, (byte)0x6D, (byte)0x70, (byte)0x6C, (byte)0x65, (byte)0x2E, (byte)0x63, (byte)0x6F, (byte)0x6D, (byte)0x2F
};
// wrap into TLV structure
byte[] tlvEncodedData = null;
if (ndefMessage.length < 255) {
tlvEncodedData = new byte[ndefMessage.length + 3];
tlvEncodedData[0] = (byte)0x03; // NDEF TLV tag
tlvEncodedData[1] = (byte)(ndefMessage.length & 0x0FF); // NDEF TLV length (1 byte)
System.arraycopy(ndefMessage, 0, tlvEncodedData, 2, ndefMessage.length);
tlvEncodedData[2 + ndefMessage.length] = (byte)0xFE; // Terminator TLV tag
} else {
tlvEncodedData = new byte[ndefMessage.length + 5];
tlvEncodedData[0] = (byte)0x03; // NDEF TLV tag
tlvEncodedData[1] = (byte)0xFF; // NDEF TLV length (3 byte, marker)
tlvEncodedData[2] = (byte)((ndefMessage.length >>> 8) & 0x0FF); // NDEF TLV length (3 byte, hi)
tlvEncodedData[3] = (byte)(ndefMessage.length & 0x0FF); // NDEF TLV length (3 byte, lo)
System.arraycopy(ndefMessage, 0, tlvEncodedData, 4, ndefMessage.length);
tlvEncodedData[4 + ndefMessage.length] = (byte)0xFE; // Terminator TLV tag
}
// fill up with zeros to block boundary:
tlvEncodedData = Arrays.copyOf(tlvEncodedData, (tlvEncodedData.length / 4 + 1) * 4);
for (int i = 0; i < tlvEncodedData.length; i += 4) {
byte[] command = new byte[] {
(byte)0xA2, // WRITE
(byte)((4 + i / 4) & 0x0FF), // block address
0, 0, 0, 0
};
System.arraycopy(tlvEncodedData, i, command, 2, 4);
byte[] response = nfc.transceive(command);
}
最后,请注意,如果在 NDEF 数据区域设置了 read-password,则不能将标签用作 NDEF 标签,因为 NFC 论坛类型 2 标签操作规范要求标签可自由读取.