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 在 硬件支持
30KB
417 行
这是一个早期版本的库,任何东西都可能随时崩溃。
Smartcard-rs
此库允许使用PC/SC驱动程序在PC和智能卡(SC)之间进行通信。
如何使用此库
添加包
在您的 Cargo.toml
[dependencies]
smartcard = "0.3"
在您的 main.rs 或 lib.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