From 5bad84c251c2a14d946aeafa4cc8518db2cac910 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ladislav=20Jane=C4=8Dek?= Date: Thu, 23 Apr 2026 10:28:17 -0700 Subject: [PATCH 1/2] Revise NFC Data Format Specification Updated NFC Data Format Specification to include additional standards, structural details, and UUID derivation algorithm. --- docs_src/nfc_data_format.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs_src/nfc_data_format.md b/docs_src/nfc_data_format.md index 3a4cefe..2d0d102 100644 --- a/docs_src/nfc_data_format.md +++ b/docs_src/nfc_data_format.md @@ -145,15 +145,15 @@ material_name = "PLA Prusa Galaxy Black" material_uuid = generate_uuid(material_namespace, brand_uuid.bytes, material_name.encode("utf-8")) print(f"material_uuid = {material_uuid}") -material_package_namespace = "6f7d485e-db8d-4979-904e-a231cd6602b2" +package_namespace = "6f7d485e-db8d-4979-904e-a231cd6602b2" gtin = "1234" -material_package_uuid = generate_uuid(material_package_namespace, brand_uuid.bytes, gtin.encode("utf-8")) -print(f"material_package_uuid = {material_package_uuid}") +package_uuid = generate_uuid(package_namespace, brand_uuid.bytes, gtin.encode("utf-8")) +print(f"package_uuid = {package_uuid}") -material_package_instance_namespace = "31062f81-b5bd-4f86-a5f8-46367e841508" +instance_namespace = "31062f81-b5bd-4f86-a5f8-46367e841508" nfc_tag_uid = b"\xE0\x04\x01\x08\x66\x2F\x6F\xBC" -material_package_instance_uuid = generate_uuid(material_package_instance_namespace, nfc_tag_uid) -print(f"material_package_instance_uuid = {material_package_instance_uuid}") +instance_uuid = generate_uuid(instance_namespace, nfc_tag_uid) +print(f"instance_uuid = {instance_uuid}") {% endpython %} ## 4. Meta section From 38931d5224331bd58811c33d22ce0067a7b2a707 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ladislav=20Jane=C4=8Dek?= Date: Fri, 24 Apr 2026 00:12:04 -0700 Subject: [PATCH 2/2] Fix naming in documentation --- docs_src/nfc_data_format.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs_src/nfc_data_format.md b/docs_src/nfc_data_format.md index 2d0d102..4c3a593 100644 --- a/docs_src/nfc_data_format.md +++ b/docs_src/nfc_data_format.md @@ -120,7 +120,7 @@ UUIDs are derived from the brand-specific IDs using UUIDv5 with the `SHA1` hash, 1. NFC tag UID is represented as a bytestream with the MSB being the first byte in the bytestream. * **Important:** Various apps/readers report these UIDs in various byte orders, and sometimes as hex strings instead of bytestreams. For NFCV, the UID MUST be a 8 bytes long bytestream with `0xE0` as the **first** byte (SLIX2 then follows with `0x04, 0x01`). -| UID | Derviation formula | Namespace (`N`) | +| UUID | Derviation formula | Namespace (`N`) | | --- | --- | --- | | `brand_uuid` | `N + brand_name` | `5269dfb7-1559-440a-85be-aba5f3eff2d2` | | `material_uuid` | `N + brand_uuid + material_name` | `616fc86d-7d99-4953-96c7-46d2836b9be9` |