| 
10 |
11 | ## Play with the Chrome App sample
12 |
13 | * Check `Developer Mode` in `chrome://extensions`
14 | * Click "Load unpacked extension..." in `chrome://extensions` and select the [sample](/sample) folder.
15 | * Launch it.
16 |
17 | 
18 |
19 | ## Caveats
20 |
21 | Learn more about USB Devices Caveats at https://developer.chrome.com/apps/app_usb#caveats
22 |
23 | ## Usage
24 |
25 | Once you've imported the [chrome-nfc.js](https:///raw.github.com/GoogleChrome/chrome-nfc/master/sample/chrome-nfc.js) javascript library into your Chrome App, you need to add the permissions below to your manifest file:
26 |
27 | ```javascript
28 | "permissions": [
29 | "usb",
30 | {
31 | "usbDevices": [
32 | { "vendorId": 1254, "productId": 21905 }, // SCL3711
33 | { "vendorId": 1839, "productId": 8704 } // ACR122U
34 | ]
35 | }
36 | ]
37 | ```
38 |
39 | ### Enumerate NFC readers
40 |
41 | ``` javascript
42 | chrome.nfc.findDevices(function(devices) {
43 | console.log("Found " + devices.length + " NFC device(s)");
44 | for (var i = 0; i < devices.length; i++) {
45 | var device = devices[i];
46 | console.log(device.vendorId, device.productId);
47 | }
48 | });
49 | ```
50 |
51 | ### Read NFC tag
52 |
53 | ``` javascript
54 | chrome.nfc.findDevices(function(devices) {
55 | var device = devices[0];
56 | chrome.nfc.read(device, {}, function(type, ndef) {
57 | console.lof(ndef);
58 | var uri = ndef.ndef[0]["uri"];
59 | console.log(uri);
60 | var text = ndef.ndef[1]["text"];
61 | console.log(text);
62 | });
63 | });
64 | ```
65 |
66 | ### Write NFC tag
67 |
68 | ``` javascript
69 | chrome.nfc.findDevices(function(devices) {
70 | var device = devices[0];
71 | var ndef = [
72 | {"text": "Chromium.org website" },
73 | {"uri": "http://chromium.org" },
74 | {"aar": "com.google.samples.apps.iosched" },
75 | ];
76 | chrome.nfc.write(device, {"ndef": ndef}, function(rc) {
77 | if (!rc) {
78 | console.log("WRITE() success!");
79 | } else {
80 | console.log("WRITE() FAILED, rc = " + rc);
81 | }
82 | });
83 | });
84 | ```
85 |
86 | ### Emulate NFC tag
87 |
88 | ``` javascript
89 | chrome.nfc.findDevices(function(devices) {
90 | var device = devices[0];
91 | var ndef = [
92 | {"type": "URI", "uri": "http://chromium.org"}
93 | ];
94 | chrome.nfc.emulate_tag(device, {"ndef": ndef}, function(rc) {
95 | if (!rc) {
96 | console.log("EMULATE() success!");
97 | } else {
98 | console.log("EMULATE() FAILED, rc = " + rc);
99 | }
100 | });
101 | });
102 | ```
103 |
104 | ### Read Mifare Classic tag (Logic Mode)
105 |
106 | ``` javascript
107 | chrome.nfc.findDevices(function(devices) {
108 | var device = devices[0];
109 | chrome.nfc.read_logic(device, 0, 2, function(rc, data) {
110 | console.log(UTIL_BytesToHex(data));
111 | });
112 | });
113 | ```
114 |
115 | ### Write Mifare Classic tag (Logic Mode)
116 |
117 | ``` javascript
118 | chrome.nfc.findDevices(function(devices) {
119 | var device = devices[0];
120 | var data = new Uint8Array([ // NDEF(http://google.com)
121 | 0xdb, 0x00, 0x03, 0xe1, 0x00, 0x00, 0x00, 0x00, // block 0 (MAD1)
122 | 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
123 | 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // block 1 (MAD1)
124 | 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
125 | 0x03, 0x0f, 0xd1, 0x01, 0x0b, 0x55, 0x03, 0x67, // block 2 (NDEF)
126 | 0x6f, 0x6f, 0x67, 0x6c, 0x65, 0x2e, 0x63, 0x6f,
127 | 0x6d, 0xfe, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, // block 3 (NDEF)
128 | 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
129 | ]);
130 | chrome.nfc.write_logic(device, 0, data, function(rc) {
131 | console.log("WRITE_LOGIC() SUCCESS");
132 | });
133 | });
134 | ```
135 |
136 | ## Compiling the library
137 |
138 | Compiling script requires [Python 3.0](http://www.python.org/download/releases/3.0/) and will use online [Closure Compiler](https://developers.google.com/closure/). Just run
139 |
140 | python3 compile.py
141 |
142 | and the library will be written to `chrome-nfc.js`.
143 |
--------------------------------------------------------------------------------
/src/util.js:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright 2014 Google Inc. All rights reserved.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 |
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 |
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 |
17 | 'use strict';
18 |
19 | function UTIL_StringToBytes(s, bytes) {
20 | bytes = bytes || new Array(s.length);
21 | for (var i = 0; i < s.length; ++i)
22 | bytes[i] = s.charCodeAt(i);
23 | return bytes;
24 | }
25 |
26 | function UTIL_BytesToString(b) {
27 | var tmp = new String();
28 | for (var i = 0; i < b.length; ++i)
29 | tmp += String.fromCharCode(b[i]);
30 | return tmp;
31 | }
32 |
33 | function UTIL_BytesToHex(b) {
34 | if (!b) return '(null)';
35 | var hexchars = '0123456789ABCDEF';
36 | var hexrep = new Array(b.length * 2);
37 |
38 | for (var i = 0; i < b.length; ++i) {
39 | hexrep[i * 2 + 0] = hexchars.charAt((b[i] >> 4) & 15);
40 | hexrep[i * 2 + 1] = hexchars.charAt(b[i] & 15);
41 | }
42 | return hexrep.join('');
43 | }
44 |
45 | function UTIL_BytesToHexWithSeparator(b, sep) {
46 | var hexchars = '0123456789ABCDEF';
47 | var stride = 2 + (sep?1:0);
48 | var hexrep = new Array(b.length * stride);
49 |
50 | for (var i = 0; i < b.length; ++i) {
51 | if (sep) hexrep[i * stride + 0] = sep;
52 | hexrep[i * stride + stride - 2] = hexchars.charAt((b[i] >> 4) & 15);
53 | hexrep[i * stride + stride - 1] = hexchars.charAt(b[i] & 15);
54 | }
55 | return (sep?hexrep.slice(1):hexrep).join('');
56 | }
57 |
58 | function UTIL_HexToBytes(h) {
59 | var hexchars = '0123456789ABCDEFabcdef';
60 | var res = new Uint8Array(h.length / 2);
61 | for (var i = 0; i < h.length; i += 2) {
62 | if (hexchars.indexOf(h.substring(i, i + 1)) == -1) break;
63 | res[i / 2] = parseInt(h.substring(i, i + 2), 16);
64 | }
65 | return res;
66 | }
67 |
68 | function UTIL_equalArrays(a, b) {
69 | if (!a || !b) return false;
70 | if (a.length != b.length) return false;
71 | var accu = 0;
72 | for (var i = 0; i < a.length; ++i)
73 | accu |= a[i] ^ b[i];
74 | return accu === 0;
75 | }
76 |
77 | function UTIL_ltArrays(a, b) {
78 | if (a.length < b.length) return true;
79 | if (a.length > b.length) return false;
80 | for (var i = 0; i < a.length; ++i) {
81 | if (a[i] < b[i]) return true;
82 | if (a[i] > b[i]) return false;
83 | }
84 | return false;
85 | }
86 |
87 | function UTIL_geArrays(a, b) {
88 | return !UTIL_ltArrays(a, b);
89 | }
90 |
91 | function UTIL_getRandom(a) {
92 | var tmp = new Array(a);
93 | var rnd = new Uint8Array(a);
94 | window.crypto.getRandomValues(rnd); // Yay!
95 | for (var i = 0; i < a; ++i) tmp[i] = rnd[i] & 255;
96 | return tmp;
97 | }
98 |
99 | function UTIL_equalArrays(a, b) {
100 | if (!a || !b) return false;
101 | if (a.length != b.length) return false;
102 | var accu = 0;
103 | for (var i = 0; i < a.length; ++i)
104 | accu |= a[i] ^ b[i];
105 | return accu === 0;
106 | }
107 |
108 | function UTIL_setFavicon(icon) {
109 | // Construct a new favion link tag
110 | var faviconLink = document.createElement("link");
111 | faviconLink.rel = "Shortcut Icon";
112 | faviconLink.type = 'image/x-icon';
113 | faviconLink.href = icon;
114 |
115 | // Remove the old favion, if it exists
116 | var head = document.getElementsByTagName("head")[0];
117 | var links = head.getElementsByTagName("link");
118 | for (var i=0; i < links.length; i++) {
119 | var link = links[i];
120 | if (link.type == faviconLink.type && link.rel == faviconLink.rel) {
121 | head.removeChild(link);
122 | }
123 | }
124 |
125 | // Add in the new one
126 | head.appendChild(faviconLink);
127 | }
128 |
129 | // Erase all entries in array
130 | function UTIL_clear(a) {
131 | if (a instanceof Array) {
132 | for (var i = 0; i < a.length; ++i)
133 | a[i] = 0;
134 | }
135 | }
136 |
137 | // hr:min:sec.milli string
138 | function UTIL_time() {
139 | var d = new Date();
140 | var m = '000' + d.getMilliseconds();
141 | var s = d.toTimeString().substring(0, 8) + '.' + m.substring(m.length - 3);
142 | return s;
143 | }
144 |
145 | function UTIL_fmt(s) {
146 | return UTIL_time() + ' ' + s;
147 | }
148 |
149 | // a and b are Uint8Array. Returns Uint8Array.
150 | function UTIL_concat(a, b) {
151 | var c = new Uint8Array(a.length + b.length);
152 | var i, n = 0;
153 | for (i = 0; i < a.length; i++, n++) c[n] = a[i];
154 | for (i = 0; i < b.length; i++, n++) c[n] = b[i];
155 | return c;
156 | }
157 |
158 |
--------------------------------------------------------------------------------
/src/usb.js:
--------------------------------------------------------------------------------
1 | /*
2 | * Copyright 2014 Google Inc. All rights reserved.
3 | *
4 | * Licensed under the Apache License, Version 2.0 (the "License");
5 | * you may not use this file except in compliance with the License.
6 | * You may obtain a copy of the License at
7 |
8 | * http://www.apache.org/licenses/LICENSE-2.0
9 |
10 | * Unless required by applicable law or agreed to in writing, software
11 | * distributed under the License is distributed on an "AS IS" BASIS,
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 | * See the License for the specific language governing permissions and
14 | * limitations under the License.
15 | */
16 | /**
17 | * @fileoverview Low level usb cruft to SCL3711 NFC token.
18 | */
19 |
20 | 'use strict';
21 |
22 | // Low level 'driver'. One per physical USB device.
23 | function llSCL3711(dev, acr122) {
24 | this.dev = dev;
25 | this.txqueue = [];
26 | this.clients = [];
27 | this.acr122 = acr122;
28 | if (acr122) {
29 | this.endpoint = 2;
30 | } else {
31 | // scl3711
32 | this.endpoint = 4;
33 | }
34 |
35 | this.readLoop();
36 | }
37 |
38 | llSCL3711.prototype.notifyClientOfClosure = function(client) {
39 | var cb = client.onclose;
40 | if (cb) window.setTimeout(cb, 0);
41 | };
42 |
43 | llSCL3711.prototype.close = function() {
44 | // Tell clients.
45 | while (this.clients.length != 0) {
46 | this.notifyClientOfClosure(this.clients.shift());
47 | }
48 |
49 | // Tell global list to drop this device.
50 | dev_manager.dropDevice(this);
51 | };
52 |
53 | llSCL3711.prototype.publishFrame = function(f) {
54 | // Push frame to all clients.
55 | var old = this.clients;
56 |
57 | var remaining = [];
58 | var changes = false;
59 | for (var i = 0; i < old.length; ++i) {
60 | var client = old[i];
61 | if (client.receivedFrame(f)) {
62 | // Client still alive; keep on list.
63 | remaining.push(client);
64 | } else {
65 | changes = true;
66 | console.log(UTIL_fmt(
67 | '[' + client.cid.toString(16) + '] left?'));
68 | }
69 | }
70 | if (changes) this.clients = remaining;
71 | };
72 |
73 | llSCL3711.prototype.readLoop = function() {
74 | if (!this.dev) return;
75 |
76 | // console.log(UTIL_fmt('entering readLoop ' + this.dev.handle));
77 |
78 | var self = this;
79 | chrome.usb.bulkTransfer(
80 | this.dev,
81 | { direction:'in', endpoint:this.endpoint, length:2048 },
82 | function(x) {
83 | if (x.data) {
84 | if (x.data.byteLength >= 5) {
85 |
86 | var u8 = new Uint8Array(x.data);
87 | console.log(UTIL_fmt('<' + UTIL_BytesToHex(u8)));
88 |
89 | self.publishFrame(x.data);
90 |
91 | // Read more.
92 | window.setTimeout(function() { self.readLoop(); } , 0);
93 | } else {
94 | console.error(UTIL_fmt('tiny reply!'));
95 | console.error(x);
96 | // TODO(yjlou): I don't think a tiny reply requires close.
97 | // Maybe call dev_manager.close(null, clients[0])?
98 | // window.setTimeout(function() { self.close(); }, 0);
99 | }
100 |
101 | } else {
102 | console.log('no x.data!');
103 | console.log(x);
104 | throw 'no x.data!';
105 | }
106 | }
107 | );
108 | };
109 |
110 | // Register an opener.
111 | llSCL3711.prototype.registerClient = function(who) {
112 | this.clients.push(who);
113 | };
114 |
115 | // De-register an opener.
116 | // Returns number of remaining listeners for this device.
117 | llSCL3711.prototype.deregisterClient = function(who) {
118 | var current = this.clients;
119 | this.clients = [];
120 | for (var i = 0; i < current.length; ++i) {
121 | var client = current[i];
122 | if (client != who) this.clients.push(client);
123 | }
124 | return this.clients.length;
125 | };
126 |
127 | // Stuffs all queued frames from txqueue[] to device.
128 | llSCL3711.prototype.writePump = function() {
129 | if (!this.dev) return; // Ignore.
130 |
131 | if (this.txqueue.length == 0) return; // Done with current queue.
132 |
133 | var frame = this.txqueue[0];
134 |
135 | var self = this;
136 | function transferComplete(x) {
137 | self.txqueue.shift(); // drop sent frame from queue.
138 | if (self.txqueue.length != 0) {
139 | window.setTimeout(function() { self.writePump(); }, 0);
140 | }
141 | };
142 |
143 | var u8 = new Uint8Array(frame);
144 | console.log(UTIL_fmt('>' + UTIL_BytesToHex(u8)));
145 |
146 | chrome.usb.bulkTransfer(
147 | this.dev,
148 | {direction:'out', endpoint:this.endpoint, data:frame},
149 | transferComplete
150 | );
151 | };
152 |
153 | // Queue frame to be sent.
154 | // If queue was empty, start the write pump.
155 | // Returns false if device is MIA.
156 | llSCL3711.prototype.writeFrame = function(frame) {
157 | if (!this.dev) return false;
158 |
159 | var wasEmpty = (this.txqueue.length == 0);
160 | this.txqueue.push(frame);
161 | if (wasEmpty) this.writePump();
162 |
163 | return true;
164 | };
165 |
--------------------------------------------------------------------------------
/sample/app.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
11 |
13 |
14 |
32 | chrome.nfc API sample
12 |
33 |
115 |
34 | ![]()
35 |
44 | -
36 |
- Name 37 | 38 |
- Vendor ID 39 | 40 |
- Product ID 41 | 42 |
45 |
46 |
47 |
48 |
49 |
50 |
51 |
52 |
53 |
54 |
71 |
72 |
73 |
74 |
93 |
94 |
95 |
96 |
113 |
114 |