Add FMCOS TID card support

This commit is contained in:
klks committed 2026-05-25 06:46:29 +08:00
1 parent cec95558df
commit ed5d7d2b0c
2 files changed
+908

No files matched your search

+393
View File
@@ -47,6 +47,16 @@ All commands in this family are reachable via `hf fmcos <subcommand>`.
- [File Protection Modes](#file-protection-modes)
- [Access Rights Byte](#access-rights-byte)
- [Complete Wallet Session Walkthrough](#complete-wallet-session-walkthrough)
- [TID Tag Provisioning](#tid-tag-provisioning)
- [tid setcard](#tid-setcard)
- [tid setuid](#tid-setuid)
- [tid setauth](#tid-setauth)
- [tid erase](#tid-erase)
- [tid provision](#tid-provision)
- [tid createdf](#tid-createdf)
- [tid createbin](#tid-createbin)
- [tid createrec](#tid-createrec)
- [TID Vendor Card Templates](#tid-vendor-card-templates)
---
@@ -880,3 +890,386 @@ Common values:
| `ff` | No protection required, key0 for both read/write |
| `7f` | Protection required, key0 for both read/write |
| `f0` | No protection required (permission byte for directories/keys) |
---
## TID Tag Provisioning
A TID tag is a magic FMCOS tag that bypasses certain authentication mechanisms and
allows custom UID. These commands below allow a TID tag to be provisioned — UID,
auth key, and file system, these commands are not the same as the standard fmcos commands.
These cards can often be found on taobao by searching for (CPU卡TID卡)
When hf fmcos auth external is called with any key, the card will always return
[+] SW: 9000 - Success
[+] External authentication successful
All TID subcommands are reached via `hf fmcos tid <subcommand>`.
| Subcommand | Description |
|------------|-------------|
| `setcard` | Write fixed card configuration block (`INS 0xEF`) |
| `setuid` | Program the ISO14443-A UID (`INS 0x85`) |
| `setauth` | Write the internal auth key and lock state (`INS 0x21`) |
| `erase` | Erase the card file system (`CLA 0xE0 INS 0xEC`) |
| `provision` | Full provisioning sequence in one command |
> **Order matters.** When provisioning manually, always run `setcard` → `setuid` → `setauth`
> → `erase` → create file structure. `provision` does this automatically.
---
### tid setcard
Send the fixed 39-byte SET CARD configuration APDU. The payload is hardcoded — there is
limited information on what the fields do. This must be sent before any other provisioning step.
```
hf fmcos tid setcard
```
| Flag | Description |
|------|-------------|
| `-k` / `--keep` | Keep field on after command |
**APDU:** `00 EF 00 00 27 <39-byte config>`
---
### tid setuid
Program the card's ISO14443-A UID.
```
hf fmcos tid setuid --uid 13371337
hf fmcos tid setuid --uid 0102030405060708
```
| Flag | Description |
|------|-------------|
| `--uid <hex>` | UID bytes (4–7 bytes, i.e. 8–14 hex chars) |
| `-k` / `--keep` | Keep field on after command |
**APDU:** `00 85 00 00 <len> <uid>`
---
### tid setauth
Write the 8-byte internal authentication key and set the lock state.
```
hf fmcos tid setauth --key 1122334455667788
hf fmcos tid setauth --key 1122334455667788 --lock
```
| Flag | Description |
|------|-------------|
| `--key <hex>` | Internal auth key (8 bytes) |
| `--lock` | Lock the key permanently (`0xAA`); default is unlocked (`0x55`) |
| `-k` / `--keep` | Keep field on after command |
**APDU:** `00 21 00 00 0A <key[8]> <lock_byte> 00`
> **Warning:** `--lock` not much is known about how this functions, use with care.
---
### tid erase
Erase the card's file system. Uses `CLA=0xE0` (not `0x80` as in standard FMCOS erase).
```
hf fmcos tid erase
```
| Flag | Description |
|------|-------------|
| `-k` / `--keep` | Keep field on after command |
**APDU:** `E0 EC 00 00 00`
---
### tid provision
Full provisioning sequence in a single command. Chains all steps with the RF field held on
and aborts with an error message if any step fails.
Steps performed:
1. SET CARD (fixed config block)
2. SET UID
3. SET INTERNAL AUTH
4. ERASE
5. SELECT MF (`3F00`)
6. CREATE MF (`3F00`, name `1PAY.SYS.DDF01`)
7. SELECT MF (`3F00`)
8. CREATE KEYFILE
```
hf fmcos tid provision --uid 13371337 --key 1122334455667788
hf fmcos tid provision --uid 13371337 --key 1122334455667788 --lock
```
| Flag | Description |
|------|-------------|
| `--uid <hex>` | UID bytes (4–7 bytes) |
| `--key <hex>` | Internal auth key (8 bytes) |
| `--lock` | Lock the auth key permanently after writing |
| `-k` / `--keep` | Keep field on after completion |
After `provision`, use `tid createdf` / `tid createbin` / `tid createrec` to build
the file structure, then `hf fmcos write binary` / `hf fmcos write record` to populate data.
---
### tid createdf
CREATE a sub-DF using the TID APDU format. The standard `hf fmcos create dir` uses a
different data layout (FID in P1/P2, leading `0x38` byte); this command uses the TID layout
where P1=`0x01` and the FID is the first field in the data.
```
hf fmcos tid createdf --id 3f01 --size 0f00 --sfi 96 --name 444446303133
```
| Flag | Description |
|------|-------------|
| `--id <4hex>` | 2-byte file ID |
| `--size <hex>` | DF space to allocate in bytes (hex) |
| `--sfi <hex>` | Short file ID (1 byte) |
| `--name <hex>` | DF name bytes (0–16 bytes, optional) |
| `-k` / `--keep` | Keep field on after command |
**APDU:** `80 E0 01 00 <lc> [fid_hi][fid_lo] [size_hi][size_lo] F0 F0 [sfi] 01 FF [name...]`
---
### tid createbin
CREATE a binary EF or KEYFILE using the TID APDU format. The standard `hf fmcos create file --type bin`
uses a different layout (FID in P1/P2, 7-byte payload); this command uses the TID layout
where P1=`0x02` and the FID is in the data with a fixed 11-byte payload.
Use `--type keyfile` to create the fixed TID keyfile (subtype `1E`) in the currently selected DF.
Every sub-DF needs a keyfile before EFs can be created inside it.
```
hf fmcos tid createbin --id 0001 --size 0100 --sfi 01
hf fmcos tid createbin --id 0002 --size 0040 --sfi 02 --rperm 20 --wperm f0
hf fmcos tid createbin --type keyfile
```
| Flag | Description |
|------|-------------|
| `--type <type>` | `bin` (default) or `keyfile` |
| `--id <4hex>` | 2-byte file ID (required for `bin`) |
| `--size <hex>` | File size in bytes, hex (required for `bin`) |
| `--sfi <hex>` | Short file ID, 1 byte (required for `bin`) |
| `--rperm <hex>` | Read permission byte (default `F0`, `bin` only) |
| `--wperm <hex>` | Write permission byte (default `F0`, `bin` only) |
| `-k` / `--keep` | Keep field on after command |
**APDU (bin):** `80 E0 02 00 0B 00 [fid_hi][fid_lo] [size_hi][size_lo] [rperm][wperm] [sfi] 00 FF 00`
**APDU (keyfile):** `80 E0 02 00 0B 1E 00 00 00 30 FF FF 00 30 00 00`
---
### tid createrec
CREATE a fixed-length record EF using the TID APDU format. The standard `hf fmcos create file --type fix`
uses a different layout; this command uses the TID layout where P1=`0x02`, subtype=`0x01`,
and count+reclen replace the size field.
```
hf fmcos tid createrec --id 0003 --count 04 --reclen 08 --sfi 03
hf fmcos tid createrec --id 0003 --count 04 --reclen 10 --sfi 03 --rperm 20 --wperm f0
```
| Flag | Description |
|------|-------------|
| `--id <4hex>` | 2-byte file ID |
| `--count <hex>` | Number of records (1 byte) |
| `--reclen <hex>` | Bytes per record (1 byte) |
| `--sfi <hex>` | Short file ID (1 byte) |
| `--rperm <hex>` | Read permission byte (default `F0`) |
| `--wperm <hex>` | Write permission byte (default `F0`) |
| `-k` / `--keep` | Keep field on after command |
**APDU:** `80 E0 02 00 0B 01 [fid_hi][fid_lo] [count][reclen] [rperm][wperm] [sfi] 00 FF 00`
> **Note**: To write data into TID EFs after creation, use the standard `hf fmcos write binary`
> and `hf fmcos write record` — those APDUs (`00 D6` / `00 DC`) are identical in TID and standard FMCOS.
---
## TID Vendor Card Templates
Six real-world Chinese access-control layouts were translated from the app that is
normally provided when you buy these TID cards.
### Provisioning notes
- Replace `--uid` and `--key` in the `provision` call with your actual values.
- `-k` keeps the RF field on between commands, preserving the card's file context. When a
command finishes without `-k` the field drops and the card resets to MF context on the
next activation.
- Each sub-DF requires a TID-format keyfile created immediately after selecting it. Use
`hf fmcos tid createbin --type keyfile` — the standard `hf fmcos create keyfile` uses a
different APDU layout and cannot create TID keyfiles.
---
### 01 — Dingbo (鼎博)
```
MF 3F00 "1PAY.SYS.DDF01" SFI 0x02
└── DF 7572 39 01 30 99 08 07 SFI 0x02 (proprietary 6-byte name)
└── EF-rec 0001 SFI 0x03 6 records × 16 bytes
```
```
hf fmcos tid provision --uid 13371337 --key 0001020304050607
hf fmcos tid createdf --id 7572 --size 0200 --sfi 02 --name 390130990807 -k
hf fmcos select --id 7572 -k
hf fmcos tid createbin --type keyfile -k
hf fmcos tid createrec --id 0001 --count 06 --reclen 10 --sfi 03 -k
hf fmcos write record --rec 01 --fid 03 --data 018609DD110000000000010100000000 -k
hf fmcos write record --rec 02 --fid 03 --data 00000000000000000000000000000000 -k
hf fmcos write record --rec 03 --fid 03 --data 0000000000070A0D1707120000008800 -k
hf fmcos write record --rec 04 --fid 03 --data 00000000000000000000000000000000 -k
hf fmcos write record --rec 05 --fid 03 --data 00000000000000000000000000000000 -k
hf fmcos write record --rec 06 --fid 03 --data 00000000000000000000000000000000
```
---
### 02 — Anjubao (安居宝)
```
MF 3F00 "1PAY.SYS.DDF01" SFI 0x02
└── DF 1001 A0 00 00 00 03 86 98 07 01 SFI 0x02 (9-byte AID)
├── EF-bin 0018 SFI 0x18 140 bytes (wallet balance file)
└── EF-bin 0019 SFI 0x19 140 bytes (passbook balance file)
```
```
hf fmcos tid provision --uid 13371337 --key 0001020304050607
hf fmcos tid createdf --id 1001 --size 0200 --sfi 02 --name A00000000386980701 -k
hf fmcos select --id 1001 -k
hf fmcos tid createbin --type keyfile -k
hf fmcos tid createbin --id 0018 --size 008C --sfi 18 -k
hf fmcos select --id 0018 -k
hf fmcos write binary --p1 00 --p2 00 --data 001FD921090700000001000023590000000000E0FFFFFF7F0700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 -k
hf fmcos tid createbin --id 0019 --size 008C --sfi 19 -k
hf fmcos select --id 0019 -k
hf fmcos write binary --p1 00 --p2 00 --data 001FD921090700000001000023590000FFFFFFFFFFFF010000000000E0FFFFFF0F0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
```
---
### 03 — Jinbo (金博)
```
MF 3F00 "1PAY.SYS.DDF01" SFI 0x02
└── DF 4A54 6A 69 6E 00 00 00 62 6F A5 04 9F 08 01 02 SFI 0x02 (14-byte name, starts "jin")
└── EF-bin 4200 SFI 0x01 624 bytes (32 B payload at offset 592, remainder zeros)
```
```
hf fmcos tid provision --uid 13371337 --key 0001020304050607
hf fmcos tid createdf --id 4A54 --size 0300 --sfi 02 --name 6A696E00000000626FA5049F080102 -k
hf fmcos select --id 4A54 -k
hf fmcos tid createbin --type keyfile -k
hf fmcos tid createbin --id 4200 --size 0270 --sfi 01 -k
hf fmcos select --id 4200 -k
hf fmcos write binary --p1 02 --p2 50 --data 530030FFFFFFFFFFFFFF3A2B0000000022012200002403081106000000007F00
```
---
### 04 — Jingkong (晶控)
```
MF 3F00 "1PAY.SYS.DDF01" SFI 0x02
└── DF 3F01 "DDF01" SFI 0x02
├── EF-bin 0001 SFI 0x01 1 byte (placeholder)
├── EF-bin 0003 SFI 0x03 28 bytes (key / config data)
├── EF-bin 0004 SFI 0x04 120 bytes (zeroed)
├── EF-bin 0005 SFI 0x05 36 bytes (key / config data)
├── EF-bin 0006 SFI 0x06 132 bytes (key / config data)
└── EF-bin 0007 SFI 0x07 102 bytes (zeroed)
```
```
hf fmcos tid provision --uid 13371337 --key 0001020304050607
hf fmcos tid createdf --id 3F01 --size 0400 --sfi 02 --name 4444463031 -k
hf fmcos select --id 3F01 -k
hf fmcos tid createbin --type keyfile -k
hf fmcos tid createbin --id 0001 --size 0001 --sfi 01 -k
hf fmcos tid createbin --id 0003 --size 001C --sfi 03 -k
hf fmcos select --id 0003 -k
hf fmcos write binary --p1 00 --p2 00 --data FE937B922D7EDEF50000000000000000000000000000000000000000 -k
hf fmcos tid createbin --id 0004 --size 0078 --sfi 04 -k
hf fmcos select --id 0004 -k
hf fmcos write binary --p1 00 --p2 00 --data 000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 -k
hf fmcos tid createbin --id 0005 --size 0024 --sfi 05 -k
hf fmcos select --id 0005 -k
hf fmcos write binary --p1 00 --p2 00 --data 6403FE9C7434FCBC6E00FC9F2802F1448F06F3BA8CF6F0B98DF7F1B84D0BF60000000000 -k
hf fmcos tid createbin --id 0006 --size 0084 --sfi 06 -k
hf fmcos select --id 0006 -k
hf fmcos write binary --p1 00 --p2 00 --data 616BEACE7705FCBD7604FDBC7107F2BB7006F3BA7309F0B97208F1B84D0B09B74C0AF7494F0DF4B5B10CF5B449F0EAB3480E14B24B31E84E4A30E9B0BA33EEAF44CDEFAE473513AD4634ED534137E2ABBF36E3AA43C6E0A942381EA85D3BE6585C3AE7A6A03DE4A55E000000000000000000000000000000000000000000000000000000 -k
hf fmcos tid createbin --id 0007 --size 0066 --sfi 07 -k
hf fmcos select --id 0007 -k
hf fmcos write binary --p1 00 --p2 00 --data 000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
```
---
### 05 — Kangtuo (康拓)
```
MF 3F00 "1PAY.SYS.DDF01" SFI 0x02
├── DF D0F1 "XL123" SFI 0x02
│ └── EF-bin 0005 SFI 0x05 64 bytes
└── DF D0F2 "XL456" SFI 0x02
└── EF-bin 0005 SFI 0x05 64 bytes
```
```
hf fmcos tid provision --uid 13371337 --key 0001020304050607
hf fmcos tid createdf --id D0F1 --size 0100 --sfi 02 --name 584C313233 -k
hf fmcos select --id D0F1 -k
hf fmcos tid createbin --type keyfile -k
hf fmcos tid createbin --id 0005 --size 0040 --sfi 05 -k
hf fmcos select --id 0005 -k
hf fmcos write binary --p1 00 --p2 00 --data 0200FC20006200000000000000000000000000272E2C6A0000000000000000080000000000000000000000000000000000000000000000000000000000000000
hf fmcos tid createdf --id D0F2 --size 0100 --sfi 02 --name 584C343536 -k
hf fmcos select --id D0F2 -k
hf fmcos tid createbin --type keyfile -k
hf fmcos tid createbin --id 0005 --size 0040 --sfi 05 -k
hf fmcos select --id 0005 -k
hf fmcos write binary --p1 00 --p2 00 --data 0200FC20006200000000000000000000000000272E2C6A0000000000000000080000000000000000000000000000000000000000000000000000000000000000
```
---
### 06 — Youhe (友禾)
```
MF 3F00 "1PAY.SYS.DDF01" SFI 0x02
└── DF 3F01 "ADF01" SFI 0x02
└── EF-bin 0003 SFI 0x03 250 bytes (key / credential data)
```
```
hf fmcos tid provision --uid 13371337 --key 0001020304050607
hf fmcos tid createdf --id 3F01 --size 0200 --sfi 02 --name 4144463031 -k
hf fmcos select --id 3F01 -k
hf fmcos tid createbin --type keyfile -k
hf fmcos tid createbin --id 0003 --size 00FA --sfi 03 -k
hf fmcos select --id 0003 -k
hf fmcos write binary --p1 00 --p2 00 --data D15190D7E1E379732295C97D62A3172BE3BBA1D1B32CE32FED72CB3DCDB115E7DC2670978E241822F298C9951260FC55D54F9988C7FCAC5032F94281DFC39C973E570101764D5BBF367F84EBDA1B012ABD4568F35D5BC08BAFD76B988CA916C985692337FCF02C9FD2C8BDD583BC05EF55582C3921FA2CAFAE26308FBADE0598DB750EE1F0522D29EAB6FA5D0F3971F785692337FCF02C9FD2C8BDD583BC05EF55582C3921FA2CAFAE26308FBADE0598DB750EE1F0522D29EAB6FA5D0F3971F7EA545FC5B27B7F40DF6D0F71FCEE2A1BCED2DEDE67BB57B1C1F98C8CDA5259CC7BD83158086F215F5E1E0246EE0504760000000000 -k
hf fmcos write binary --p1 00 --p2 F5 --data 0000000000
```