This is a early version library, everything can break at any moment.

Smartcard-rs

This library is a wrapper for the PC/SC driver. It enables communication between a PC and a smartcard (SC).

How to use this library

Add the crate

In your Cargo.toml:

[dependencies]
smartcard = "0.2"

In your main.rs or lib.rs:

extern crate smartcard;

Example code

In the main.rs:

extern crate smartcard;

use smartcard::logic::Context;
use smartcard::parameters::{ShareMode, Protocol};
use smartcard::errors::*;

fn run() -> Result<()> {
    //First we create the resource manager context. I think of it as 'the driver'.
    let context = try!(Context::establish_context_auto());

    //The context allows to list all available card readers.
    let mut readers = try!(context.list_readers());

    println!("{} readers found:", readers.len());
    for r in readers.iter() {
        println!("- {}", r.get_name());
    }

    //Let's get the first reader.
    let reader = try!(readers.pop().ok_or(format!("no readers found")));

    //From the reader, we can connect to its smartcard this way.
    let card = try!(reader.connect_to(&context, ShareMode::Auto, Protocol::Auto));

    //Now that we have a card available, we can send commands to it.
    //select app on my card
    let cmd_vec = vec![0x00, 0xA4, 0x04, 0x00, 0x0B, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x00, 0x00];
    let answer = try!(card.send_raw_command(&cmd_vec, 256));

    println!("Answer: {:?}", answer);//I get 0x90 0x00, perfect!
    Ok(())
}

fn main() {
    match run() {
        Ok(_) => {},
        Err(e) => println!("An error occured: {}.", e.to_string())
    }
}

Supported platform and dependencies

Linux only for now. The library pcsclite and the pcscd deamon are required.

On ubuntu based systems:

sudo apt-get install pcscd libpcsclite1

Optionnally you can install the always useful pcsc-tools package:

sudo apt-get install pcsc-tools

With this tools you can detect your readers with

pcsc_scan

Windows and MacOS are not supported (yet?). PRs welcome.