Compare commits
14 Commits
Author | SHA1 | Date | |
---|---|---|---|
77da84a261 | |||
26fff7e5d8 | |||
9669064662 | |||
6f44b5b039 | |||
2caacc853a | |||
de5cde2ca9 | |||
7cf077d527 | |||
253b375923 | |||
f22300b438 | |||
a15dd29c53 | |||
d01b3cc124 | |||
31d80834a7 | |||
1aff4ba049 | |||
4f693c9859 |
8
.travis.yml
Normal file
8
.travis.yml
Normal file
@ -0,0 +1,8 @@
|
||||
language: node_js
|
||||
branches:
|
||||
only:
|
||||
- master
|
||||
- develop
|
||||
node_js:
|
||||
- "4"
|
||||
- "5"
|
34
Gruntfile.js
34
Gruntfile.js
@ -1,6 +1,9 @@
|
||||
/**
|
||||
* Grunt file for node-wifi-scanner
|
||||
* Grunt file for the ZigBeeSiteSurvey
|
||||
*
|
||||
* grunt update
|
||||
* Updates the local common files with the ones from the editor project
|
||||
|
||||
* Create a new bugfix version (x.y.++):
|
||||
* grunt v:patch
|
||||
*
|
||||
@ -10,7 +13,7 @@
|
||||
* Create a new major version (++.0.0)
|
||||
* grunt v:major
|
||||
*
|
||||
* Created by kc on 06.04.16
|
||||
* Created by kc on 27.06.15.
|
||||
*/
|
||||
|
||||
module.exports = function (grunt) {
|
||||
@ -26,43 +29,18 @@ module.exports = function (grunt) {
|
||||
commitFiles: ['-a'],
|
||||
tagName: 'v%VERSION%',
|
||||
tagMessage: 'Version %VERSION%',
|
||||
push: true,
|
||||
pushTo: 'git@github.com:ancasicolica/ZigBeeSiteSurvey.git',
|
||||
push: false,
|
||||
gitDescribeOptions: '--tags --always --abbrev=1 --dirty=-d',
|
||||
globalReplace: false,
|
||||
prereleaseName: false,
|
||||
regExp: false
|
||||
}
|
||||
},
|
||||
|
||||
zip: {
|
||||
'make': {
|
||||
src: ['./**/**'],
|
||||
dest: '../ZigBeeSiteSurvey_x.y.z_OS_.zip',
|
||||
compression: 'DEFLATE'
|
||||
}
|
||||
},
|
||||
|
||||
compress: {
|
||||
main: {
|
||||
options: {
|
||||
archive: 'dist/ZigBeeSiteSurvey-' + grunt.file.readJSON('package.json').version + '-Win-x64.zip'
|
||||
},
|
||||
files: [{
|
||||
src: ['*.js', 'LICENSE', '*.json', 'node.exe', '*.md', 'lib/**', 'node_modules/**', 'public/**', 'routes/**', 'views/**'],
|
||||
dest: 'ZigBeeSiteSurvey-' + grunt.file.readJSON('package.json').version + '-Win-x64'
|
||||
}]
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
|
||||
grunt.loadNpmTasks('grunt-bump');
|
||||
grunt.loadNpmTasks('grunt-zip');
|
||||
grunt.loadNpmTasks('grunt-contrib-compress');
|
||||
grunt.registerTask('minify', ['concat', 'uglify:js']);
|
||||
grunt.registerTask('v:patch', ['bump:patch']);
|
||||
grunt.registerTask('v:minor', ['bump:minor']);
|
||||
grunt.registerTask('v:major', ['bump:major']);
|
||||
grunt.registerTask('make', ['zip:make']);
|
||||
};
|
||||
|
15
README.md
15
README.md
@ -1,5 +1,9 @@
|
||||
#node-wifi-scanner
|
||||
|
||||
[](https://travis-ci.org/ancasicolica/node-wifi-scanner)
|
||||
[]()
|
||||
[](https://www.npmjs.com/package/node-wifi-scanner)
|
||||
|
||||
This module for node.js scans available wifi networks. The main purpose was to enhance my node.js based
|
||||
[ZigBee Site Survey Tool](http://ancasicolica.github.io/ZigBeeSiteSurvey/) with WiFi coexistence charts. This tool
|
||||
claims to be compatible with current versions of Mac OS-X, Windows and Linux so I'll fix bugs as fast as possible.
|
||||
@ -9,8 +13,6 @@ The module was inspired from Maurice Sways "[node-wifiscanner](https://github.co
|
||||
had to handle much more complex network environments and also wanted to be independent of the operating
|
||||
system language. The adaptions needed would have been too comprehensive for a pull request so I decided to write an own module.
|
||||
|
||||
**The module is currently in BETA testing, changes in functionality and interface are possible. Please report bugs on the projects GitHub page, Thanks!**
|
||||
|
||||
## Operating Systems
|
||||
|
||||
It was tested with the following operating systems:
|
||||
@ -19,6 +21,10 @@ It was tested with the following operating systems:
|
||||
* Ubuntu 14.04
|
||||
* Raspbian "Jessie"
|
||||
|
||||
## Installation
|
||||
|
||||
npm i node-wifi-scanner
|
||||
|
||||
## Usage
|
||||
|
||||
const scanner = require('node-wifi-scanner');
|
||||
@ -47,8 +53,8 @@ The module uses command line tools for gathering the network information:
|
||||
|
||||
* airport on Mac OS-X: `airport -s`
|
||||
* netsh on Windows: `netsh wlan show networks mode=Bssid`
|
||||
* iwlist (1st choice) on Linux: `iwlist scan`
|
||||
* nmcli (fallback only) on Linux: `nmcli -m tabular -f SSID,BSSID,SIGNAL,FREQ device wifi`
|
||||
* iwlist on Linux: `iwlist scan`
|
||||
|
||||
|
||||
Unfortunately, Mac OS-X and Windows use the system language for the output which requires a quite
|
||||
generic way of parsing the data. If you experience any troubles, please create a GitHub issue and supply
|
||||
@ -77,3 +83,4 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
|
||||
|
15
index.js
15
index.js
@ -8,7 +8,6 @@ const exec = require('child_process').exec;
|
||||
// The tools
|
||||
const airport = require('./lib/airport');
|
||||
const iwlist = require('./lib/iwlist');
|
||||
const nmcli = require('./lib/nmcli');
|
||||
const netsh = require('./lib/netsh');
|
||||
|
||||
var scanner;
|
||||
@ -24,19 +23,11 @@ function initTools(callback) {
|
||||
if (stats) {
|
||||
return callback(null, iwlist);
|
||||
}
|
||||
|
||||
fs.stat(nmcli.tool, function (err, stats) {
|
||||
fs.stat(netsh.tool, function (err, stats) {
|
||||
if (stats) {
|
||||
return callback(null, nmcli);
|
||||
return callback(null, netsh);
|
||||
}
|
||||
|
||||
fs.stat(netsh.tool, function (err, stats) {
|
||||
if (stats) {
|
||||
return callback(null, netsh);
|
||||
}
|
||||
|
||||
callback(new Error('No scanner found'));
|
||||
});
|
||||
callback(new Error('No scanner found'));
|
||||
});
|
||||
});
|
||||
});
|
||||
|
@ -18,9 +18,13 @@ function parseOutput(str, callback) {
|
||||
var wifis = [];
|
||||
var err = null;
|
||||
try {
|
||||
if (blocks.length < 2) {
|
||||
// 2nd try, with \r\n
|
||||
blocks = str.split('\r\n\r\n')
|
||||
}
|
||||
if (!blocks || blocks.length === 1) {
|
||||
// No WiFis found
|
||||
return [];
|
||||
return callback(null, []);
|
||||
}
|
||||
|
||||
// Each block has the same structure, while some parts might be available and others
|
||||
|
50
lib/nmcli.js
50
lib/nmcli.js
@ -1,50 +0,0 @@
|
||||
/**
|
||||
* Scanning WiFis on Mac OS X using nmcli
|
||||
* Created by kc on 04.04.16.
|
||||
*/
|
||||
|
||||
const _ = require('lodash');
|
||||
const tool = '/usr/bin/nmcli';
|
||||
const cmdLine = tool + ' -m tabular -f SSID,BSSID,SIGNAL,FREQ device wifi';
|
||||
|
||||
const macRegex = /([0-9a-zA-Z]{1}[0-9a-zA-Z]{1}[:]{1}){5}[0-9a-zA-Z]{1}[0-9a-zA-Z]{1}/;
|
||||
/**
|
||||
* Parsing the output of nmcli
|
||||
* @param str output of the tool
|
||||
* @param callback
|
||||
*/
|
||||
function parseOutput(str, callback) {
|
||||
var err = null;
|
||||
|
||||
try {
|
||||
var lines = str.split('\n');
|
||||
var wifis = [];
|
||||
|
||||
for (var i = 1, l = lines.length; i < l; i++) {
|
||||
var mac = lines[i].match(macRegex);
|
||||
if (!mac) {
|
||||
continue;
|
||||
}
|
||||
var macStart = lines[i].indexOf(mac[0]);
|
||||
var elements = lines[i].substr(macStart).split(/[ ]+/);
|
||||
wifis.push({
|
||||
'ssid' : _.trim(lines[i].substr(0, macStart), ' \''),
|
||||
'mac' : elements[0].trim(),
|
||||
'channel' : parseInt(elements[2].trim(), 10),
|
||||
'rssi' : parseInt(elements[1].trim())
|
||||
});
|
||||
}
|
||||
}
|
||||
catch (ex) {
|
||||
err = ex;
|
||||
}
|
||||
|
||||
callback(err, wifis);
|
||||
}
|
||||
|
||||
|
||||
module.exports = {
|
||||
parseOutput: parseOutput,
|
||||
cmdLine : cmdLine,
|
||||
tool : tool
|
||||
};
|
21
package.json
21
package.json
@ -1,27 +1,35 @@
|
||||
{
|
||||
"name": "node-wifi-scanner",
|
||||
"version": "0.0.2",
|
||||
"version": "1.0.0",
|
||||
"description": "node.js module for WiFi network detection",
|
||||
"main": "index.js",
|
||||
"keywords": [
|
||||
"WiFi",
|
||||
"Node.js",
|
||||
"scanner"
|
||||
"scanner",
|
||||
"airport",
|
||||
"netsh",
|
||||
"iwlist",
|
||||
"nmcli"
|
||||
],
|
||||
"author": {
|
||||
"name": "Christian Kuster, CH-8342 Wernetshausen",
|
||||
"email": "info@kusti.ch",
|
||||
"url": "http://www.kusti.ch/"
|
||||
},
|
||||
"homepage": "http://www.ferropoly.ch/",
|
||||
"homepage": "https://github.com/ancasicolica/node-wifi-scanner",
|
||||
"bugs": {
|
||||
"url": "https://github.com/ancasicolica/node-wifi-scanner/issues",
|
||||
"email": "info@ancasicolica.ch"
|
||||
},
|
||||
"license": "MIT",
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/ancasicolica/node-wifi-scanner.git"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">= 4.4.0",
|
||||
"npm": ">= 2.14.0"
|
||||
"node": ">= 4.0.0",
|
||||
"npm": ">= 2.0.0"
|
||||
},
|
||||
"scripts": {
|
||||
"test": "mocha test"
|
||||
@ -31,6 +39,7 @@
|
||||
},
|
||||
"devDependencies": {
|
||||
"grunt": "0.4.5",
|
||||
"grunt-bump": "0.7.0"
|
||||
"grunt-bump": "0.7.0",
|
||||
"mocha": "2.2.5"
|
||||
}
|
||||
}
|
||||
|
20
test/fixtures/nmcli/nmcli01.txt
vendored
20
test/fixtures/nmcli/nmcli01.txt
vendored
@ -1,20 +0,0 @@
|
||||
SSID BSSID SIGNAL FREQUENZ
|
||||
'PDANet1' 00:35:1A:90:56:06 100 2412 MHz
|
||||
'ExoNet1' 00:35:1A:90:56:05 100 2412 MHz
|
||||
'TEST-Wifi' 00:35:1A:90:56:00 96 2412 MHz
|
||||
'OurTest' 00:35:1A:90:56:0C 96 2412 MHz
|
||||
'OurDev' 00:35:1A:90:56:0B 76 2412 MHz
|
||||
'PDANet1' 00:35:1A:6F:0F:46 48 2437 MHz
|
||||
'TEST-Wifi' 00:35:1A:6F:0F:40 58 2437 MHz
|
||||
'ExoNet1' 00:35:1A:6F:0F:45 58 2437 MHz
|
||||
'OurDev' 00:35:1A:6F:0F:4B 58 2437 MHz
|
||||
'OurTest' 00:35:1A:6F:0F:4C 60 2437 MHz
|
||||
'TEST-Wifi' 00:F2:8B:8F:58:70 58 2462 MHz
|
||||
'ExoNet1' 00:F2:8B:8F:58:75 72 2462 MHz
|
||||
'PDANet1' 00:F2:8B:8F:58:76 58 2462 MHz
|
||||
'PDANet1' 00:35:1A:5B:46:76 56 2412 MHz
|
||||
'OurDev' 00:35:1A:5B:46:7B 48 2412 MHz
|
||||
'OurDev' 00:F2:8B:8F:58:7B 58 2462 MHz
|
||||
'OurTest' 00:F2:8B:8F:58:7C 72 2462 MHz
|
||||
'TEST-Wifi' 00:35:1A:5B:46:70 56 2412 MHz
|
||||
'OurTest' 00:35:1A:5B:46:7C 48 2412 MHz
|
@ -93,7 +93,7 @@ describe('netsh', function () {
|
||||
netsh.parseOutput(fs.readFileSync(path.join(__dirname, 'fixtures', 'netsh', 'netsh_sp.txt'), {encoding: 'utf8'}), (err, info) => {
|
||||
assert.ok(info);
|
||||
assert.equal(info.length, 8);
|
||||
console.log(info);
|
||||
|
||||
var ap = info[0];
|
||||
assert.equal(ap.mac, '98:fc:11:b6:88:9e');
|
||||
assert.equal(ap.ssid, 'CARAMANZANAS_BAJA');
|
||||
|
@ -1,30 +0,0 @@
|
||||
/**
|
||||
* nmcli unit test
|
||||
* Created by kc on 04.04.16.
|
||||
*/
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const assert = require('assert');
|
||||
|
||||
const nmcli = require('../lib/nmcli');
|
||||
|
||||
describe.skip('nmcli', () => {
|
||||
it('parses the output of file 1', function(done) {
|
||||
nmcli.parseOutput(fs.readFileSync(path.join(__dirname, 'fixtures','nmcli','nmcli01.txt'), { encoding: 'utf8' }), (err, info) => {
|
||||
|
||||
console.log(info);
|
||||
assert.ok(info);
|
||||
assert.equal(info.length, 19);
|
||||
|
||||
var ap = info[0];
|
||||
assert.equal(ap.mac, '00:35:1A:90:56:06');
|
||||
assert.equal(ap.ssid, 'PDANet1');
|
||||
//assert.equal(ap.rssi, -70);
|
||||
assert.strictEqual(ap.channel, 112);
|
||||
|
||||
done(err);
|
||||
});
|
||||
});
|
||||
|
||||
});
|
Reference in New Issue
Block a user