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: toml [dependencies] smartcard = "0.2"

In your main.rs or lib.rs: rust extern crate smartcard;

Example code

In the main.rs: ```rust 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::establishcontextauto());

//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.tostring()) } } ```

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.