https://github.com/patatetom/libs9
Python library for IC Card Reader S9-BU-00-01 from Fongwah
https://github.com/patatetom/libs9
nfc nfc-reader nfc-tag nfc-writer rfid rfid-reader tag
Last synced: 11 months ago
JSON representation
Python library for IC Card Reader S9-BU-00-01 from Fongwah
- Host: GitHub
- URL: https://github.com/patatetom/libs9
- Owner: patatetom
- Created: 2021-09-10T11:13:57.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-09-10T14:10:32.000Z (almost 5 years ago)
- Last Synced: 2025-01-14T05:28:29.456Z (over 1 year ago)
- Topics: nfc, nfc-reader, nfc-tag, nfc-writer, rfid, rfid-reader, tag
- Language: C
- Homepage:
- Size: 858 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# libS9
Python library for IC Card Reader S9-BU-00-01 from Fongwah
## foreword
the library is intended to be used with `Python3` under `Linux`.
it only implements some functions from `libS8.so` around `Mifare S50 tags` (classic 1k EV1).
only the `A key` is used.
except `readUID`, all the proposed functions expect a `block number` as input.
## usage
```pycon
>>> from libS9 import Reader
>>> reader = Reader('/dev/usb/hiddev3')
>>> # get UID tag
>>> reader.readUID()
'0BDA3FF0'
>>> # read first block
>>> reader.readBlock()
'0BDA3FF0:0:F03FDA0B1E8804000000000000000000'
>>> reader.readBlock(0)
'0BDA3FF0:0:F03FDA0B1E8804000000000000000000'
>>> reader.readBlock(0, 'FF'*6)
'0BDA3FF0:0:F03FDA0B1E8804000000000000000000'
>>> # blocks 0, 1, 2 & 3 are on the same sector 0 [012[3]][456[7]]...
>>> reader.readBlock(0)
'0BDA3FF0:0:F03FDA0B1E8804000000000000000000'
>>> reader.readBlock(1)
'0BDA3FF0:1:00000000000000000000000000000000'
>>> reader.readBlock(2)
'0BDA3FF0:2:00000000000000000000000000000000'
>>> reader.readBlock(3)
'0BDA3FF0:3:000000000000FF078000FFFFFFFFFFFF'
>>> reader.readSector(2)
['0BDA3FF0:0:F03FDA0B1E8804000000000000000000', '0BDA3FF0:1:00000000000000000000000000000000', '0BDA3FF0:2:00000000000000000000000000000000', '0BDA3FF0:3:000000000000FF078000FFFFFFFFFFFF']
>>> reader.writeBlock(2, '1234567890ABCDEF'*2)
'0BDA3FF0:2:1234567890ABCDEF1234567890ABCDEF'
>>> reader.readSector(1)
['0BDA3FF0:0:F03FDA0B1E8804000000000000000000', '0BDA3FF0:1:00000000000000000000000000000000', '0BDA3FF0:2:1234567890ABCDEF1234567890ABCDEF', '0BDA3FF0:3:000000000000FF078000FFFFFFFFFFFF']
>>> # can't use writeBlock on access control block (trailer)
>>> # block 3 is the trailer block of sector 0 [012[3]][456[7]]...
>>> reader.writeBlock(1, '11'*16)
'0BDA3FF0:1:11111111111111111111111111111111'
>>> reader.writeBlock(3, '4BAD'*4)
>>> print(reader.writeBlock(3, '4BAD'*4))
None
>>> # and of course on manufacturer block
>>> reader.writeBlock(0, '4BAD'*4)
>>> print(reader.writeBlock(0, '4BAD'*4))
None
>>> # change keyA on block 7 (trailer) of sector 1 [012[3]][456[7]]...
>>> # REMEMBER (WRITE DOWN) THE KEYS YOU INSTALL
>>> reader.changeKey(4, 'EE'*6)
'0BDA3FF0:4:[EEEEEEEEEEEE]'
>>> reader.changeKey(5, 'AA'*6, 'EE'*6)
'0BDA3FF0:5:[AAAAAAAAAAAA]'
>>> reader.resetKey(6, 'AA'*6)
'0BDA3FF0:6:[FFFFFFFFFFFF]'
>>> reader.readBlock(7)
'0BDA3FF0:7:000000000000FF078000FFFFFFFFFFFF'
>>> # key (6 bytes) can be passed as bytes, string or integer
>>> reader.readBlock(2, b'\xff'*6)
'0BDA3FF0:2:1234567890ABCDEF1234567890ABCDEF'
>>> reader.readBlock(2, 'ff'*6)
'0BDA3FF0:2:1234567890ABCDEF1234567890ABCDEF'
>>> reader.readBlock(2, 0xFFFFFFFFFFFF)
'0BDA3FF0:2:1234567890ABCDEF1234567890ABCDEF'
>>> # data (16 bytes) can be passed as bytes or string
>>> reader.writeBlock(60, b'\x01'*16)
'0BDA3FF0:60:01010101010101010101010101010101'
>>> reader.writeBlock(61, '10'*16)
'0BDA3FF0:61:10101010101010101010101010101010'
>>> reader.readSector(60)
['0BDA3FF0:60:01010101010101010101010101010101', '0BDA3FF0:61:10101010101010101010101010101010', '0BDA3FF0:62:00000000000000000000000000000000', '0BDA3FF0:63:000000000000FF078000FFFFFFFFFFFF']
>>> # "protect" sector 15 with new keyA
>>> # REMEMBER (WRITE DOWN) THE KEYS YOU INSTALL
>>> reader.changeKey(60, '102030'*2)
'0BDA3FF0:60:[102030102030]'
>>> reader.readBlock(60)
False
>>> reader.writeBlock(60, '88'*16)
False
>>> reader.readSector(60)
[False, False, False, False]
>>> reader.readSector(60, '102030102030')
['0BDA3FF0:60:01010101010101010101010101010101', '0BDA3FF0:61:10101010101010101010101010101010', '0BDA3FF0:62:00000000000000000000000000000000', '0BDA3FF0:63:000000000000FF078000FFFFFFFFFFFF']
>>> # reset a sector
>>> reader.resetSector(60, '123456'*2)
False
>>> reader.resetSector(60, '102030'*2)
['0BDA3FF0:60:00000000000000000000000000000000', '0BDA3FF0:61:00000000000000000000000000000000', '0BDA3FF0:62:00000000000000000000000000000000', '0BDA3FF0:60:[FFFFFFFFFFFF]']
>>> # reset a block
>>> reader.readBlock(2)
'0BDA3FF0:2:1234567890ABCDEF1234567890ABCDEF'
>>> reader.resetBlock(2)
'0BDA3FF0:2:00000000000000000000000000000000'
```
## S9-BU-00-01
