Skip to content

Getting started

Three parts make the kit: the sensor, the Mac with the app, and optionally a Mist API token. Set them up once; a session then takes a few minutes to start.

An operator handed a sensor sets up only the Mac. The sensor comes installed, with a spare card flashed from its image:

  1. The app: the app built from source, Wireshark for tshark, and the Mist token.
  2. Your key on the sensor: a key pair of your own and the SSH host on your Mac; someone who already has access adds your key to the sensor.

Whoever builds a sensor starts from the parts:

  1. The kit: what to buy, about €350 for the sensor.
  2. The sensor: Raspberry Pi OS Lite on the Pi, linkside-cap and linkside-radio installed, the two sticks assigned to their roles, the Ethernet link to the Mac, and the image of the card.

Checking the kit

With all three in place:

  1. Connect the sensor to the Mac with the Ethernet cable and power it on. It is reachable as sensor-1.local (its number) after about a minute: Settings > Sensor > Test connection says so.
  2. In the app, File > New Session…: the sensor line turns green once the Pi answers, both radios are in monitor mode and the checks of linkside-radio status pass. It names what fails otherwise.
  3. Without hardware, choose a simulated sensor in Settings: it plays a recorded session as if live, to try the whole flow.