Add ISO 15693 cmds

.clang-format

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 ---

.github/workflows/arduino-ci.yml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 name: Arduino CI

.github/workflows/publish.yml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 name: Publish to PyPI

.github/workflows/python-ci.yml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 name: Python CI

.github/workflows/reuse.yml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 name: REUSE Compliance

MANIFEST.in

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 include README.md

Makefile

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 VENV := venv

README.md

@@ -1,7 +1,7 @@
 # PN5180-tagomatic
 
 <!--
-SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 SPDX-License-Identifier: GPL-3.0-or-later
 -->
 

REUSE.toml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: CC0-1.0
 
 version = 1
@@ -9,13 +9,13 @@ SPDX-PackageDownloadLocation = "https://github.com/bofh69/PN5180-tagomatic"
 [[annotations]]
 path = ["sketch/board.jpg"]
 precedence = "aggregate"
-SPDX-FileCopyrightText = "2025 PN5180-tagomatic contributors"
+SPDX-FileCopyrightText = "2026 PN5180-tagomatic contributors"
 SPDX-License-Identifier = "GPL-3.0-or-later"
 
 [[annotations]]
 path = [".gitignore", ".clang-format"]
 precedence = "aggregate"
-SPDX-FileCopyrightText = "2025 PN5180-tagomatic contributors"
+SPDX-FileCopyrightText = "2026 PN5180-tagomatic contributors"
 SPDX-License-Identifier = "CC0-1.0"
 
 [[annotations]]

examples/basic_example.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """Example program demonstrating PN5180 reader usage.

examples/iso_14443-a-get-uid.py → examples/iso_14443-get-uid.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """Example program demonstrating PN5180 reader usage.

examples/iso_14443-read-memory.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """Example program demonstrating PN5180 reader usage.

examples/iso_14443_reqa.py → examples/iso_14443-reqa.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """Example program demonstrating PN5180 reader usage.

examples/iso_14443-write-memory.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """Example program demonstrating PN5180 reader usage.
@@ -48,7 +48,7 @@ def main() -> int:
                 # Write memory based on card type
                 if len(card.uid) == 4:
                     # MIFARE Classic card
-                    raise NotImplemented("Not yet implemented")
+                    raise NotImplementedError("Not yet implemented")
                 else:
                     # Other ISO 14443-A card (e.g., NTAG)
                     card.write_memory(16//4, 0xEFBEADDE)

examples/iso_15693_inventory.py → examples/iso_15693-inventory.py

@@ -1,10 +1,10 @@
 #!/usr/bin/env python3
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """Example program demonstrating PN5180 ISO 15693 inventory.
 
-This example program finds the UID of ISO-15963 cards
+This example program finds the UID of ISO-15693 cards
 
 Usage:
     examples/iso_15693_inventory.py /dev/ttyACM0

examples/iso_15693-update-memory.py

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+"""Example program demonstrating PN5180 ISO 15693 operations.
+
+This example program finds the UID of ISO-15693 cards
+
+Usage:
+    examples/iso_15693-update-memory.py /dev/ttyACM0
+    examples/iso_15693-update-memory.py COM3
+"""
+
+import argparse
+import sys
+
+from pn5180_tagomatic import PN5180
+
+
+def main() -> int:
+    """Main entry point for the example program."""
+    parser = argparse.ArgumentParser(
+        description="PN5180 ISO 15693 Inventory Example",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    parser.add_argument(
+        "tty",
+        help="Serial port device (e.g., /dev/ttyACM0 or COM3)",
+    )
+    args = parser.parse_args()
+
+    try:
+        # Create PN5180 reader instance
+        with PN5180(args.tty) as reader:
+            print("PN5180 reader initialized")
+
+            # Start ISO 15693 communication session
+            # 0x0D = TX config for ISO 15693
+            # 0x8D = RX config for ISO 15693
+            with reader.start_session(0x0D, 0x8D) as session:
+                print("Performing ISO 15693 inventory...")
+
+                # Perform inventory
+                uids = session.iso15693_inventory()
+
+                # Display results
+                if uids:
+                    print(f"\nFound {len(uids)} tag(s):")
+                    for i, uid in enumerate(uids, 1):
+                        print(f"  {i}. UID: {uid.hex(':')}")
+
+                    card = session.connect_iso15693(uids[0])
+                    card.write_memory(4, b' Hello! ')
+
+                    memory = card.read_memory()
+                    for offset in range(0, len(memory), 16):
+                        chunk = memory[offset : offset + 16]
+                        ascii_values = "".join(
+                            chr(byte) if 32 <= byte <= 126 else "."
+                            for byte in chunk
+                        )
+                        print(f"({offset:03x}): {chunk.hex(' ')} {ascii_values}")
+                else:
+                    print("\nNo tags found")
+
+        return 0
+
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

pyproject.toml

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 [build-system]

sketch/README.md

@@ -1,5 +1,5 @@
 <!--
-SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 SPDX-License-Identifier: GPL-3.0-or-later
 -->
 

sketch/pn5180_reader/pn5180_reader.ino

@@ -1,4 +1,4 @@
-// SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+// SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 // SPDX-License-Identifier: GPL-3.0-or-later
 
 /*

src/pn5180_tagomatic/README.md

@@ -1,5 +1,5 @@
 <!--
-SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 SPDX-License-Identifier: GPL-3.0-or-later
 -->
 

src/pn5180_tagomatic/__init__.py

@@ -1,11 +1,12 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """PN5180-tagomatic: USB based RFID reader with Python interface."""
 
 from .constants import (
     ISO14443ACommand,
     ISO15693Command,
+    ISO15693Error,
     MifareKeyType,
     PN5180Error,
     RegisterOperation,
@@ -14,6 +15,7 @@
     TimeslotBehavior,
 )
 from .iso14443a import ISO14443ACard
+from .iso15693 import ISO15693Card
 from .pn5180 import PN5180
 from .proxy import PN5180Helper, PN5180Proxy
 from .session import PN5180RFSession
@@ -22,7 +24,9 @@
 __all__ = [
     "ISO14443ACard",
     "ISO14443ACommand",
+    "ISO15693Card",
     "ISO15693Command",
+    "ISO15693Error",
     "MifareKeyType",
     "PN5180",
     "PN5180Error",

src/pn5180_tagomatic/constants.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """Constants and enumerations for PN5180 RFID reader."""
@@ -21,6 +21,28 @@ def __init__(self, operation: str, error_code: int) -> None:
         super().__init__(f"{operation} failed with error code {error_code}")
 
 
+class ISO15693Error(Exception):
+    """Exception raised when an ISO 15693 command returns an error response."""
+
+    def __init__(
+        self, command: int, error_code: int, response_data: bytes
+    ) -> None:
+        """Initialize ISO15693Error.
+
+        Args:
+            command: The ISO 15693 command that triggered the error (8-bit value).
+            error_code: The error code from the tag's error response.
+            response_data: The full error response data from the tag.
+        """
+        self.command = command
+        self.error_code = error_code
+        self.response_data = response_data
+        super().__init__(
+            f"ISO 15693 command 0x{command:02X} failed "
+            f"with error code 0x{error_code:02X}"
+        )
+
+
 class MifareKeyType(IntEnum):
     """Mifare authentication key types."""
 
@@ -115,4 +137,14 @@ class ISO14443ACommand(IntEnum):
 class ISO15693Command(IntEnum):
     """ISO 15693 protocol command bytes."""
 
-    INVENTORY = 0x01  # Inventory command
+    GET_SYSTEM_INFORMATION = 0x2B
+    GET_MULTIPLE_BLOCK_SECURITY_STATUS = 0x2C
+    INVENTORY = 0x01
+    LOCK_BLOCK = 0x22
+    READ_SINGLE_BLOCK = 0x20
+    READ_MULTIPLE_BLOCKS = 0x23
+    RESET_TO_READY = 0x26
+    SELECT = 0x25
+    STAY_QUIET = 0x02
+    WRITE_SINGLE_BLOCK = 0x21
+    WRITE_MULTIPLE_BLOCKS = 0x24

src/pn5180_tagomatic/iso14443a.py

@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2025 PN5180-tagomatic contributors
+# SPDX-FileCopyrightText: 2026 PN5180-tagomatic contributors
 # SPDX-License-Identifier: GPL-3.0-or-later
 
 """ISO 14443-A card implementation."""