node-pcsclite

Bindings over pcsclite to access Smart Cards

Installation

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

Example

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);
});

API

Class: ChildProcess

The PCSCLite object is an EventEmitter that notifies the existence of Card Readers.

Event: 'error'

• err Error Object. The error.

Event: 'reader'

• reader CardReader. A CardReader object associated to the card reader detected

Emitted whenever a new card reader is detected.

Class: CardReader

The CardReader object is an EventEmitter that allows to manipulate a card reader.

Event: 'error'

• err Error Object. The error.

Event: 'end'

Emitted when the card reader has been removed.

Event: 'status'

• status Object.
  • state The current status of the card reader as returned by SCardGetStatusChange
  • atr ATR of the card inserted (if any)

Emitted whenever the status of the reader changes.

reader.connect([options], callback)

• options Object Optional
  • share_mode Number Shared mode. Defaults to SCARD_SHARE_EXCLUSIVE
  • protocol Number Preferred protocol. Defaults to SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1
• callback Function called when connection operation ends
  • error Error
  • protocol Number Established protocol to this connection.

Wrapper around SCardConnect. Establishes a connection to the reader.

reader.disconnect(callback)

• callback Function called when disconnection operation ends
  • error Error

Wrapper around SCardDisconnect. Terminates a connection to the reader.

reader.transmit(input, res_len, protocol, callback)

• 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

Wrapper around SCardTransmit. Sends an APDU to the smart card contained in the reader connected to.

reader.control(input, control_code, res_len, callback)

• 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

Wrapper around SCardControl. Sends a command directly to the IFD Handler (reader driver) to be processed by the reader.