#context #error #protocols #driver #communication #logic #pc-sc

smartcard

PC/SC包装器,用于与智能卡通信

7个版本

使用旧的Rust 2015

0.3.4 2017年5月4日
0.3.3 2017年4月18日
0.3.2 2017年2月15日
0.2.0 2016年12月23日
0.1.0 2016年12月22日

#1074硬件支持

MIT 许可证

30KB
417

这是一个早期版本的库,任何东西都可能随时崩溃。

Smartcard-rs

此库允许使用PC/SC驱动程序在PC和智能卡(SC)之间进行通信。

如何使用此库

添加包

在您的 Cargo.toml

[dependencies]
smartcard = "0.3"

在您的 main.rslib.rs

extern crate smartcard;

示例代码

main.rs

extern crate smartcard;

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

use std::sync::Arc;

fn run() -> Result<()> {
    //First we create the resource manager context. I think of it as 'the driver'.
    let context = Arc::new(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));
    //we use an Arc<Context> so that even if we
    //drop(context)
    //the context still exists while the card is alive

    //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));//256 is the maximum size of the expected answer

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

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

支持的平台和依赖项

使用 pcsc-sys 包进行驱动程序链接。它应该在Linux、Windows和MacOS上工作,但我只在Linux上进行了测试。

基于ubuntu的系统

sudo apt-get install pcscd libpcsclite1

可选地,您可以安装始终有用的pcsc-tools包

sudo apt-get install pcsc-tools

使用此工具,您可以检测您的读卡器

pcsc_scan

欢迎PR。

替代方案

您可以检查 pcsc-rust 以获取另一个具有相同目标的库。我从该项目中重新使用了 pcsc-sys 包,用于库绑定(从 smartcard-rs v 0.3.0 开始)。pcsc-rust 应该比 smartcard-rs 具有更好的性能,但API的易用性略低(据我所知)。在 pcsc-rust 中,Card和Context通过生命周期与lifetimes相关联,以防止不适当的Context丢弃(与 smartcard-rs 中的Arc不同),这可能会在某些应用程序中引起自我借用问题。

依赖项

~2.7–4MB
~77K SLoC