Skip to content

Commit bd6a9df

Browse files
authored
Update README for network scanning and packet capture (#56)
Update README
1 parent 22d2ccb commit bd6a9df

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

README.md

+36
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,42 @@ Some devices (like older Aqara sensors) may not migrate.
137137
$ zigpy radio znp /dev/ttyUSB0 change-channel --channel 25
138138
```
139139

140+
## Network scan
141+
142+
On supported radios, you can perform an active beacon scan for nearby 802.15.4 networks:
143+
144+
```console
145+
$ zigpy radio ezsp /dev/ttyUSB0 network-scan --channels 11,15,20,25 --duration-exponent 3
146+
channel: 11, network: 0x1D13 (00:07:81:00:0e:e9:d8:9f), permitting joins: 1, nwk update id: 0, lqi: 180, rssi: -66
147+
channel: 11, network: 0x2857 (00:07:81:00:fc:9e:ef:95), permitting joins: 0, nwk update id: 0, lqi: 224, rssi: -55
148+
channel: 11, network: 0x08C7 (00:07:81:00:50:d2:be:2e), permitting joins: 0, nwk update id: 0, lqi: 216, rssi: -57
149+
channel: 15, network: 0x2ABB (00:07:81:00:c5:10:10:4b), permitting joins: 0, nwk update id: 0, lqi: 212, rssi: -58
150+
Scanning channel 15
151+
```
152+
153+
## Packet capture
154+
155+
On supported radios, you can capture packets and pipe the PCAP output to Wireshark:
156+
157+
```console
158+
$ zigpy radio ezsp /dev/cu.SLAB_USBtoUART14 packet-capture -c 12,13,14,26 --interleave --channel-hop-period 1 -o - | wireshark -k -S -i -
159+
```
160+
161+
If you have multiple adapters, you can capture with multiple interfaces concurrently:
162+
163+
```console
164+
(
165+
zigpy radio ezsp /dev/cu.SLAB_USBtoUART packet-capture -c 11 --interleave -o - &
166+
zigpy radio ezsp /dev/cu.SLAB_USBtoUART8 packet-capture -c 15 --interleave -o - &
167+
zigpy radio ezsp /dev/cu.SLAB_USBtoUART10 packet-capture -c 20 --interleave -o - &
168+
zigpy radio ezsp /dev/cu.SLAB_USBtoUART13 packet-capture -c 25 --interleave -o - &
169+
zigpy radio ezsp /dev/cu.SLAB_USBtoUART14 packet-capture -c 12,13,14,26 --interleave --channel-hop-period 1 -o - &
170+
zigpy radio ezsp /dev/cu.SLAB_USBtoUART17 packet-capture -c 16,17,18,19 --interleave --channel-hop-period 1 -o - &
171+
zigpy radio ezsp /dev/cu.SLAB_USBtoUART18 packet-capture -c 21,22,23,24 --interleave --channel-hop-period 1 -o - &
172+
wait
173+
) | zigpy pcap interleave-combine -o - | wireshark -k -S -i -
174+
```
175+
140176
# OTA
141177
## Display basic information about OTA files
142178
```console

0 commit comments

Comments
 (0)