Improve README

This commit is contained in:
Martin Endler
2020-01-24 22:07:10 +01:00
parent 74d0b388c6
commit caba89fbb8

124
README.md
View File

@@ -5,8 +5,9 @@
Bindings over pcsclite to access Smart Cards. It works in **Linux**, **macOS** and **Windows**.
> **Looking for library to work easy with NFC tags?**
take a look at [nfc-pcsc](https://github.com/pokusew/nfc-pcsc) which offers easy to use high level API for detecting / reading and writing NFC tags and cards
> 📌 **Looking for library to work easy with NFC tags?**
> take a look at [nfc-pcsc](https://github.com/pokusew/nfc-pcsc) which offers easy to use high level API
> for detecting / reading and writing NFC tags and cards
## Content
@@ -61,8 +62,12 @@ Once you have all needed libraries, you can install using npm:
npm install @pokusew/pcsclite --save
```
## Example
> 👉 **If you'd prefer an easy to use high level API** for detecting / reading and writing NFC tags and cards,
> take a look at [nfc-pcsc](https://github.com/pokusew/nfc-pcsc).
```javascript
const pcsclite = require('@pokusew/pcsclite');
@@ -70,82 +75,83 @@ const pcsc = pcsclite();
pcsc.on('reader', (reader) => {
console.log('New reader detected', reader.name);
console.log('New reader detected', reader.name);
reader.on('error', err => {
console.log('Error(', reader.name, '):', err.message);
});
reader.on('error', err => {
console.log('Error(', reader.name, '):', err.message);
});
reader.on('status', (status) => {
reader.on('status', (status) => {
console.log('Status(', reader.name, '):', status);
console.log('Status(', reader.name, '):', status);
// check what has changed
const changes = reader.state ^ status.state;
// check what has changed
const changes = reader.state ^ status.state;
if (!changes) {
return;
}
if ((changes & reader.SCARD_STATE_EMPTY) && (status.state & reader.SCARD_STATE_EMPTY)) {
console.log("card removed");
reader.disconnect(reader.SCARD_LEAVE_CARD, err => {
if (err) {
console.log(err);
return;
}
console.log('Disconnected');
});
}
else if ((changes & reader.SCARD_STATE_PRESENT) && (status.state & reader.SCARD_STATE_PRESENT)) {
console.log("card inserted");
reader.connect({ share_mode: reader.SCARD_SHARE_SHARED }, (err, protocol) => {
if (err) {
console.log(err);
return;
}
console.log('Protocol(', reader.name, '):', protocol);
reader.transmit(Buffer.from([0x00, 0xB0, 0x00, 0x00, 0x20]), 40, protocol, (err, data) => {
if (err) {
console.log(err);
if (!changes) {
return;
}
}
console.log('Data received', data);
reader.close();
pcsc.close();
if ((changes & reader.SCARD_STATE_EMPTY) && (status.state & reader.SCARD_STATE_EMPTY)) {
});
console.log("card removed");
});
reader.disconnect(reader.SCARD_LEAVE_CARD, err => {
}
if (err) {
console.log(err);
return;
}
});
console.log('Disconnected');
reader.on('end', () => {
console.log('Reader', reader.name, 'removed');
});
});
}
else if ((changes & reader.SCARD_STATE_PRESENT) && (status.state & reader.SCARD_STATE_PRESENT)) {
console.log("card inserted");
reader.connect({ share_mode: reader.SCARD_SHARE_SHARED }, (err, protocol) => {
if (err) {
console.log(err);
return;
}
console.log('Protocol(', reader.name, '):', protocol);
reader.transmit(Buffer.from([0x00, 0xB0, 0x00, 0x00, 0x20]), 40, protocol, (err, data) => {
if (err) {
console.log(err);
return;
}
console.log('Data received', data);
reader.close();
pcsc.close();
});
});
}
});
reader.on('end', () => {
console.log('Reader', reader.name, 'removed');
});
});
pcsc.on('error', err => {
console.log('PCSC error', err.message);
console.log('PCSC error', err.message);
});
```
## Behavior on different OS
TODO document