Setup

Setup

While the web socket server only needs write access for the database,
the wifi sensor program either requires root access or some sort of suid-ness.

configure: npm install

see below notes on installing node pcap.

copy etc/config.js.dist to config.js and edit
install node-red flow and dependent modules
edit the configuration in the 'default configuration' node

pm2 is recommended as a daemon supervisor.

Websocket Server

server:

npm install -g pm2
pm2 start bin/smwss

Wifi Sensor:

configure gpsd, pointing it toward the BlueNMEA or Share GPS mobile apps, for instance.

configure wireless interface, setting it to monitor mode

node-pcap

install pcap:
node_pcap requires libpcap-dev for pcap.h, and the last LTS version of nodejs - 10.16.3.
There is experimental support for using pcap on the current LTS of 12.0.0 coming soon.
Using n is recommended to manage multiple installed versions of npm.

npm install -g n
n lts

included in package.json are the git versions of node_pcap and socketwatcher.
after npm finishes, you may need to cd to each build directoy located in <this package>/node_modules/<package>/build>
and issue make.

for more info check out the node_pcap issues page.

start the sensor:

pm2 start bin/smwifi

~~after the flow is deployed, the map will be available at your node-red URL with the endpoint /worldmap. ~~

to save the daemons to be restarted when the machine boots, issue pm2 save

etc/config.js

The main variables to change here are config.baseDir, ws.hostname/port, the gps settings, wifi.interface, and hopper.channels.

Most numeric time values are in milliseconds, with the exception of the oui update duration, which is in days.

Still working on how to handle channels and bands..

etc/devices.yaml

This file can hold any lists of devices you want to keep. Currently owned, ignored, tracked, or alert devices are used.

owned:
  - Wifi24: Old network
    band: g
  - 00:00:00:F0:00:0D: Open Free net
    notes: just a few ads here and there ... hmm.
  - 00:00:00:00:00:11: my new broken iphone 11 simulator
    type: phone
  - 00:00:00:00:00:22: main server
    chipset: Realtek RTL8187

And so on and such and such.

Use either an SSID or MAC address as the main key, and all other fields are user defined.

: Old network
band: g