#pcsc #smartcard

pcsc

Bindings to the PC/SC API for smart card communication

16 releases (9 stable)

Uses old Rust 2015

2.4.0 Apr 20, 2020
2.3.1 Dec 19, 2019
2.3.0 Nov 25, 2019
2.1.1 Feb 11, 2019
0.1.0 Feb 6, 2017

#11 in Hardware support

Download history 114/week @ 2020-06-01 149/week @ 2020-06-08 151/week @ 2020-06-15 71/week @ 2020-06-22 61/week @ 2020-06-29 55/week @ 2020-07-06 69/week @ 2020-07-13 67/week @ 2020-07-20 62/week @ 2020-07-27 20/week @ 2020-08-03 138/week @ 2020-08-10 99/week @ 2020-08-17 156/week @ 2020-08-24 205/week @ 2020-08-31 158/week @ 2020-09-07 161/week @ 2020-09-14

531 downloads per month
Used in 5 crates (4 directly)

MIT license

78KB
1.5K SLoC

pcsc-rust

crates.io docs.rs license

Linux, macOS, Windows:

Rust bindings to the PC/SC API for smart card communication.

  • Nice, safe API.
  • Tested on Linux, Windows, macOS.
  • Mostly zero overhead.

See the Documentation for more details.

See the pcsc/examples directory for some common tasks.

Contents

The pcsc-sys crate contains direct, low-level bindings to the C API.

The pcsc crate contains high-level Rust wrappers.

Usage

In your Cargo.toml:

[dependencies]
pcsc = "2"

Example

Connect to the card in the first available reader, send the card an APDU command, print the APDU response.

use pcsc::*;

fn main() {
    // Establish a PC/SC context.
    let ctx = match Context::establish(Scope::User) {
        Ok(ctx) => ctx,
        Err(err) => {
            eprintln!("Failed to establish context: {}", err);
            std::process::exit(1);
        }
    };

    // List available readers.
    let mut readers_buf = [0; 2048];
    let mut readers = match ctx.list_readers(&mut readers_buf) {
        Ok(readers) => readers,
        Err(err) => {
            eprintln!("Failed to list readers: {}", err);
            std::process::exit(1);
        }
    };

    // Use the first reader.
    let reader = match readers.next() {
        Some(reader) => reader,
        None => {
            println!("No readers are connected.");
            return;
        }
    };
    println!("Using reader: {:?}", reader);

    // Connect to the card.
    let card = match ctx.connect(reader, ShareMode::Shared, Protocols::ANY) {
        Ok(card) => card,
        Err(Error::NoSmartcard) => {
            println!("A smartcard is not present in the reader.");
            return;
        }
        Err(err) => {
            eprintln!("Failed to connect to card: {}", err);
            std::process::exit(1);
        }
    };

    // Send an APDU command.
    let apdu = b"\x00\xa4\x04\x00\x0A\xA0\x00\x00\x00\x62\x03\x01\x0C\x06\x01";
    println!("Sending APDU: {:?}", apdu);
    let mut rapdu_buf = [0; MAX_BUFFER_SIZE];
    let rapdu = match card.transmit(apdu, &mut rapdu_buf) {
        Ok(rapdu) => rapdu,
        Err(err) => {
            eprintln!("Failed to transmit APDU command to card: {}", err);
            std::process::exit(1);
        }
    };
    println!("APDU response: {:?}", rapdu);
}

Example output:

$ ./target/debug/examples/readme
Using reader: "SCM Microsystems Inc. SCR 355 [CCID Interface] 00 00"
Sending APDU: [0, 164, 4, 0, 10, 160, 0, 0, 0, 98, 3, 1, 12, 6, 1]
APDU response: [106, 130]

License

The MIT license.

Dependencies