feat: add IDTECK PSK1 tag type support

Adds IDTECK to the supported LF protocols on the GUI side, matching
the firmware support added upstream.

- TagType.idteck (310) in the PSK range, matching the firmware enum
- IdteckCard model (8-byte 64-bit frame: 32-bit preamble + 32-bit payload)
- ChameleonCommand entries: writeIdteckToT5577 (3017),
  setIdteckEmulatorID (5010), getIdteckEmulatorID (5011)
- Bridge RPC wrappers following the Viking pattern
- Wired into the LF type list, display name, card factory, and slot
  manager "add card" flow, plus the T55xx write helper
- uidSizeForLfTag returns 8 for IDTECK

No read path: firmware-side PSK demodulation is not implemented yet
(the tag-emulation ADC is envelope-only at 125kHz), so the GUI does
not expose a "read IDTECK" action. Emulation and T55xx clone work.

Depends on firmware PR #407 landing for the command IDs.

Author: matteoscrugli

chameleonultragui/lib/bridge/chameleon.dart

@@ -611,6 +611,10 @@ class ChameleonCommunicator {
     await sendCmd(ChameleonCommand.setIoProxEmulatorID, data: uid);
   }
 
+  Future<void> setIdteckEmulatorID(Uint8List uid) async {
+    await sendCmd(ChameleonCommand.setIdteckEmulatorID, data: uid);
+  }
+
   Future<void> writeEM410XtoT55XX(
       Uint8List uid, Uint8List newKey, List<Uint8List> oldKeys) async {
     List<int> keys = [];
@@ -687,6 +691,20 @@ class ChameleonCommunicator {
         data: Uint8List.fromList([...uid, ...newKey, ...keys]));
   }
 
+  Future<void> writeIdteckToT55XX(
+      Uint8List uid, Uint8List newKey, List<Uint8List> oldKeys) async {
+    List<int> keys = [];
+
+    keys.addAll(newKey);
+
+    for (var oldKey in oldKeys) {
+      keys.addAll(oldKey);
+    }
+
+    await sendCmd(ChameleonCommand.writeIdteckToT5577,
+        data: Uint8List.fromList([...uid, ...newKey, ...keys]));
+  }
+
   Future<void> setSlotTagName(
       int index, String name, TagFrequency frequency) async {
     await sendCmd(ChameleonCommand.setSlotTagNick,
@@ -1029,6 +1047,11 @@ class ChameleonCommunicator {
         (await sendCmd(ChameleonCommand.getIoProxEmulatorID))!.data);
   }
 
+  Future<IdteckCard> getIdteckEmulatorID() async {
+    return IdteckCard.fromBytes(
+        (await sendCmd(ChameleonCommand.getIdteckEmulatorID))!.data);
+  }
+
   Future<DeviceSettings> getDeviceSettings() async {
     var resp = (await sendCmd(ChameleonCommand.getDeviceSettings))!.data;
     if (resp[0] != 5) {

chameleonultragui/lib/gui/menu/dialogs/slot/edit.dart

@@ -104,6 +104,12 @@ class SlotEditMenuState extends State<SlotEditMenu> {
             await appState.communicator!.getIoProxEmulatorID();
         uidController.text = bytesToHexSpace(ioProxCard.uid);
       } catch (_) {}
+    } else if (selectedType! == TagType.idteck) {
+      try {
+        IdteckCard idteckCard =
+            await appState.communicator!.getIdteckEmulatorID();
+        uidController.text = bytesToHexSpace(idteckCard.uid);
+      } catch (_) {}
     } else if (isMifareClassic(selectedType!) ||
         isMifareUltralight(selectedType!)) {
       try {
@@ -206,6 +212,9 @@ class SlotEditMenuState extends State<SlotEditMenu> {
     } else if (selectedType! == TagType.ioProx) {
       await appState.communicator!.setIoProxEmulatorID(
           hexToBytes(uidController.text.replaceAll(' ', '')));
+    } else if (selectedType! == TagType.idteck) {
+      await appState.communicator!.setIdteckEmulatorID(
+          hexToBytes(uidController.text.replaceAll(' ', '')));
     } else if (isMifareClassic(selectedType!) ||
         isMifareUltralight(selectedType!)) {
       var cardData = CardData(

chameleonultragui/lib/gui/menu/dialogs/slot/export.dart

@@ -71,6 +71,12 @@ class SlotExportMenuState extends State<SlotExportMenu> {
           name: widget.names.lf,
           tag: widget.slotTypes.lf,
         );
+      } else if (widget.slotTypes.lf == TagType.idteck) {
+        return CardSave(
+          uid: (await appState.communicator!.getIdteckEmulatorID()).toString(),
+          name: widget.names.lf,
+          tag: widget.slotTypes.lf,
+        );
       }
     } else {
       CardData data = await appState.communicator!.mf1GetAntiCollData();

chameleonultragui/lib/gui/page/home.dart

@@ -53,8 +53,8 @@ class HomePageState extends State<HomePage> {
     // Checks that firmware supports all functions of current app
     // If not, prompt user to update firmware (as outdated firmware might break app)
 
-    int ultraCapability = ChameleonCommand.setIoProxEmulatorID.value;
-    int liteCapability = ChameleonCommand.setIoProxEmulatorID.value;
+    int ultraCapability = ChameleonCommand.setIdteckEmulatorID.value;
+    int liteCapability = ChameleonCommand.setIdteckEmulatorID.value;
 
     var appState = context.read<ChameleonGUIState>();
     List<int> capabilities;

chameleonultragui/lib/gui/page/read_card.dart

@@ -130,6 +130,7 @@ class ReadCardPageState extends State<ReadCardPage> {
     card ??= await appState.communicator!.readPac();
     card ??= await appState.communicator!.readIoProx();
 
+
     if (card != null) {
       setState(() {
         lfInfo.card = card;

chameleonultragui/lib/gui/page/slot_manager.dart

@@ -234,6 +234,22 @@ class SlotManagerPageState extends State<SlotManagerPage> {
       await appState.communicator!.saveSlotData();
       appState.changesMade();
       refreshSlot();
+    } else if (card.tag == TagType.idteck) {
+      close(context, card.name);
+      await appState.communicator!.setReaderDeviceMode(false);
+      await appState.communicator!
+          .enableSlot(gridPosition, TagFrequency.lf, true);
+      await appState.communicator!.activateSlot(gridPosition);
+      await appState.communicator!.setSlotType(gridPosition, card.tag);
+      await appState.communicator!.setDefaultDataToSlot(gridPosition, card.tag);
+      await appState.communicator!.setIdteckEmulatorID(hexToBytes(card.uid));
+      await appState.communicator!.setSlotTagName(
+          gridPosition,
+          (card.name.isEmpty) ? localizations.no_name : card.name,
+          TagFrequency.lf);
+      await appState.communicator!.saveSlotData();
+      appState.changesMade();
+      refreshSlot();
     } else if (isMifareUltralight(card.tag)) {
       close(context, card.name);
       setUploadState(0);

chameleonultragui/lib/helpers/definitions.dart

@@ -87,6 +87,7 @@ enum ChameleonCommand {
   writeIoProxToT5577(3011),
   scanPacTag(3014),
   writePacToT5577(3015),
+  writeIdteckToT5577(3017),
 
   mf1LoadBlockData(4000),
   mf1SetAntiCollision(4001),
@@ -146,7 +147,10 @@ enum ChameleonCommand {
   getPacEmulatorID(5007),
 
   setIoProxEmulatorID(5008),
-  getIoProxEmulatorID(5009);
+  getIoProxEmulatorID(5009),
+
+  setIdteckEmulatorID(5010),
+  getIdteckEmulatorID(5011);
 
   const ChameleonCommand(this.value);
   final int value;
@@ -163,6 +167,7 @@ enum TagType {
   viking(170),
   hidProx(200),
   ioProx(201),
+  idteck(310),
   mifareMini(1000),
   mifare1K(1001),
   mifare2K(1002),
@@ -618,3 +623,18 @@ class IoProxCard extends LFCard {
     required super.uid,
   });
 }
+
+class IdteckCard extends LFCard {
+  factory IdteckCard.fromBytes(Uint8List bytes) {
+    return IdteckCard(uid: bytes);
+  }
+
+  factory IdteckCard.fromUID(String uid) {
+    return IdteckCard.fromBytes(hexToBytes(uid));
+  }
+
+  IdteckCard({
+    super.type = TagType.idteck,
+    required super.uid,
+  });
+}

chameleonultragui/lib/helpers/general.dart

@@ -169,6 +169,8 @@ String chameleonTagToString(TagType tag, AppLocalizations localizations) {
     return "PAC/Stanley";
   } else if (tag == TagType.ioProx) {
     return "ioProx";
+  } else if (tag == TagType.idteck) {
+    return "IDTECK";
   } else if (tag == TagType.ntag210) {
     return "NTAG210";
   } else if (tag == TagType.ntag212) {
@@ -455,7 +457,8 @@ List<TagType> getTagTypesByFrequency(TagFrequency frequency) {
       TagType.hidProx,
       TagType.viking,
       TagType.pac,
-      TagType.ioProx
+      TagType.ioProx,
+      TagType.idteck
     ];
   }
 
@@ -557,6 +560,10 @@ LFCard getLFCardFromUID(TagType type, String uid) {
     return IoProxCard.fromUID(uid);
   }
 
+  if (type == TagType.idteck) {
+    return IdteckCard.fromUID(uid);
+  }
+
   return EM410XCard.fromUID(uid, type: type);
 }
 
@@ -573,6 +580,8 @@ int uidSizeForLfTag(TagType type) {
     return 8;
   } else if (type == TagType.ioProx) {
     return 16;
+  } else if (type == TagType.idteck) {
+    return 8;
   }
 
   return 0;

chameleonultragui/lib/helpers/t55xx/write/base.dart

@@ -171,6 +171,14 @@ class BaseT55XXCardHelper extends AbstractWriteHelper {
           hexToBytes(newKey), [hexToBytes(currentKey), Uint8List(4)]);
       var newCard = await communicator.readIoProx();
       return newCard.toString() == card.uid;
+    } else if (card.tag == TagType.idteck) {
+      await communicator.writeIdteckToT55XX(hexToBytes(card.uid),
+          hexToBytes(newKey), [hexToBytes(currentKey), Uint8List(4)]);
+      // IDTECK read is not implemented in the firmware (PSK demodulation
+      // on the envelope-only tag-emulation ADC path is a follow-up), so we
+      // cannot read back the tag for verification. Assume the T55xx write
+      // succeeded if the firmware did not raise an error.
+      return true;
     }
 
     return false;

chameleonultragui/lib/helpers/write.dart

@@ -65,7 +65,8 @@ abstract class AbstractWriteHelper {
         type == TagType.hidProx ||
         type == TagType.viking ||
         type == TagType.pac ||
-        type == TagType.ioProx) {
+        type == TagType.ioProx ||
+        type == TagType.idteck) {
       return BaseT55XXCardHelper(appState.communicator!);
     }