Bindings over pcsclite to access Smart Cards
In order to install the package you need to have installed in the system the pcsclite libraries. In Debian/Ubuntu:
apt-get install libpcsclite1 libpcsclite-dev
Once they are installed just run:
npm install pcsclite
To run any code you will also need to have installed the pcsc daemon:
apt-get install pcscd
var pcsc = require('pcsclite');
var pcsc = pcsc();
/* Check for new card reader detection */
pcsc.on('reader', function(reader) {
console.log('New reader detected', reader.name);
/* Check for reader status changes such a new card insertion */
reader.on('status', function(status) {
console.log('Status(', this.name, '):', status);
/* check what has changed */
var changes = this.state ^ status.state;
if (changes) {
if ((changes & this.SCARD_STATE_EMPTY) && (status.state & this.SCARD_STATE_EMPTY)) {
console.log("card removed");/* card removed */
reader.disconnect(function(err) {
if (err) {
console.log(err);
} else {
console.log('Disconnected');
}
});
} else if ((changes & this.SCARD_STATE_PRESENT) && (status.state & this.SCARD_STATE_PRESENT)) {
console.log("card inserted");/* card inserted */
reader.connect(function(err, protocol) {
if (err) {
console.log(err);
} else {
console.log('Protocol(', this.name, '):', protocol);
reader.transmit(new Buffer([0x00, 0xB0, 0x00, 0x00, 0x20]), 40, protocol, function(err, data) {
if (err) {
console.log(err);
} else {
console.log('Data received', data);
}
});
}
});
}
}
});
reader.on('end', function() {
console.log('Reader', this.name, 'removed');
});
reader.on('error', function(err) {
console.log('Error(', this.name, '):', err.message);
});
});
pcsc.on('error', function(err) {
console.log('PCSC error', err.message);
});
The PCSCLite object is an EventEmitter that notifies the existence of Card Readers.
- err
Error Object
. The error.
- reader
CardReader
. A CardReader object associated to the card reader detected
Emitted whenever a new card reader is detected.
The CardReader object is an EventEmitter that allows to manipulate a card reader.
- err
Error Object
. The error.
Emitted when the card reader has been removed.
- status
Object
.- state The current status of the card reader as returned by
SCardGetStatusChange
- atr ATR of the card inserted (if any)
- state The current status of the card reader as returned by
Emitted whenever the status of the reader changes.
- options
Object
Optional- share_mode
Number
Shared mode. Defaults toSCARD_SHARE_EXCLUSIVE
- protocol
Number
Preferred protocol. Defaults toSCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1
- share_mode
- callback
Function
called when connection operation ends- error
Error
- protocol
Number
Established protocol to this connection.
- error
Wrapper around SCardConnect
. Establishes a connection to the reader.
- callback
Function
called when disconnection operation ends- error
Error
- error
Wrapper around SCardDisconnect
. Terminates a connection to the reader.
- input
Buffer
input data to be transmitted - res_len
Number
. Max. expected length of the response - protocol
Number
. Protocol to be used in the transmission - callback
Function
called when transmit operation ends- error
Error
- output
Buffer
- error
Wrapper around SCardTransmit
. Sends an APDU to the smart card contained in the reader connected to.
- input
Buffer
input data to be transmitted - control_code
Number
. Control code for the operation - res_len
Number
. Max. expected length of the response - callback
Function
called when control operation ends- error
Error
- output
Buffer
- error
Wrapper around SCardControl
. Sends a command directly to the IFD Handler (reader driver) to be processed by the reader.