Back
Documentation

Bit4id miniLector

Ultra-compact

Bit4id·USB

Overview

The Bit4id miniLector is an ultra-compact USB contact smart card reader designed for field officers, mobile deployments, and laptop-based verification stations. At under 40 mm in length, it plugs directly into a USB port like a keychain fob and supports full ISO 7816 T=0/T=1 communication via CCID. It has no moving parts (no eject button — cards are friction-held), which makes it durable for field use. The miniLector is popular among Ghanaian immigration officers, field health workers, and verification personnel who need a portable, lightweight reader that disappears into a laptop bag.

Requirements

  • USB-A port (the miniLector is a direct plug-in dongle — no cable)
  • PC/SC daemon (pcscd on Linux/macOS, built-in on Windows 10+)
  • Python 3.9+ with pyscard
  • ECOWAS biometric identity card

Setup Guide

1

Connect the Reader

Steps
1

Plug the miniLector dongle directly into a USB-A port.

2

The amber LED illuminates when powered.

3

No driver installation is needed — the CCID driver loads automatically.

4

Insert a DREWQ gently into the card slot (no click — friction hold).

2

Configure PC/SC

Steps
1

macOS: `brew install pcsc-lite && brew services start pcsc-lite`

2

Ubuntu/Debian: `sudo apt-get install -y pcscd pcsc-tools && sudo systemctl enable --now pcscd`

3

Install pyscard: `pip install pyscard`

4

Bit4id provides optional utilities at bit4id.com but they are not required for CCID use.

3

Verify Detection

Steps
1

Run `pcsc_scan` — appears as `bit4id miniLector` or similar.

2

Insert a DREWQ and confirm the LED changes.

3

Python: `python -c "from smartcard.System import readers; print(readers())"`

4

Verify `GET /card/status` returns the reader and `card_present: true`.

4

Test with the API

Steps
1

Start the server: `uvicorn main:app --reload`

2

POST to `/card/scan` with the required BAC fields.

3

Remove the card by gently pulling it straight out (no eject button).

4

Confirm the scan log via `GET /scans?limit=1`.

Troubleshooting

Card slips out of reader during use

The miniLector uses a friction-hold mechanism — there is no locking clip. Avoid moving the laptop or reader while a card is being read. For high-movement environments, consider the ACR39U-N1 which has a more secure card seat.

Dongle blocks adjacent USB port

The miniLector's compact form factor may overlap an adjacent USB port on tightly spaced hubs. Use a short USB extension cable or a USB hub to give the dongle clearance.

Reader not detected after hot-unplug

If the miniLector was removed while a card was present, pcscd may have cached a stale reader state. Restart pcscd: `sudo systemctl restart pcscd`, then re-plug the reader.

Need more help?

Check the full documentation or the reader compatibility guide for additional context.