dojo.tzsp: Python and PHP library for MikroTik’s TZSP remote sniffer

Installation and usage

Installation (Python)

pip install --index-url https://mikrotikdojo.com/en/pypi/<your-address>/simple/ dojo-tzsp

Usage example (Python)

from dojo.tzsp import TzspReceiver, ethernet

with TzspReceiver() as rx:                 # ascolta su 0.0.0.0:37008
    for addr, pkt in rx.packets():
        eth = ethernet(pkt.payload)         # dissezione L2 minimale
        vlan = " vlan%s" % eth["vlan"] if eth["vlan"] else ""
        print(addr[0], eth["src"], "->", eth["dst"], eth["type_name"] + vlan)

# decodificare un singolo datagramma gia' catturato:
from dojo.tzsp import decode
pkt = decode(data)
print(pkt.version, pkt.protocol_name, len(pkt.payload))

Installation (PHP)

composer config repositories.dojo composer https://mikrotikdojo.com/en/composer/<your-address>/
composer require dojo/tzsp

Usage example (PHP)

use Dojo\Tzsp\TzspReceiver;
use Dojo\Tzsp\Tzsp;

$rx = new TzspReceiver();                       // 0.0.0.0:37008
foreach ($rx->packets() as [$addr, $pkt]) {
    $eth = Tzsp::ethernet($pkt->payload);
    echo "$addr  {$eth['src']} -> {$eth['dst']}  {$eth['type_name']}\n";
}

// decodificare un singolo datagramma gia' catturato:
$pkt = Tzsp::decode($data);
echo $pkt->version, " ", $pkt->protocolName(), " ", strlen($pkt->payload), "\n";