Skip to content

discover

Jump to bottom
John Serock edited this page Apr 23, 2023 · 17 revisions

The discover command returns a list of power line adapters.

Sample Usage

$ pla-util discover
c4:12:f5:03:04:05 via MII1 interface, HFID: small-bedroom
c4:12:f5:03:04:06 via PLC interface, HFID: computer-room

Request Message

Field Octet Number Field Size (Octets) Definition
ODA 0 – 5 6 Original Destination Address (typically, ff:ff:ff:ff:ff:ff)
OSA 6 – 11 6 Original Source Address
MTYPE 12 – 13 2 IEEE-assigned Ethertype (0x8912)
MMV 14 1 Management Message Version (0x01)
MMTYPE 15 – 16 2 Management Message Type (0xa070)
FMI 17 – 18 2 Fragmentation Management Information (00:00)
MME 19 – 38 20 Management Message Entry
MME PAD 39 – 59 21 MME padding (0x00 … 0x00)

MME Details

Field Octet Number Field Size (Octets) Definition
OUI 19 – 21 3 Organizationally Unique Identifier (00:1f:84 – Gigle Semiconductor)
Seq Num 22 1 Sequence Number
Sig 23 – 38 16 Gigle Signature
(0xa3 0x97 0xa2 0x55 0x53 0xbe 0xf1 0xfc 0xf9 0x79 0x6b 0x52 0x14 0x13 0xe9 0xe2)

Sample Packet Capture of Request Message

No.     Time           Source                Destination           Protocol      Length Info
      1 0.000000000    4c:ed:fb:00:01:02     ff:ff:ff:ff:ff:ff     MEDIAXTREAM   60     Discover request

Frame 1: 60 bytes on wire (480 bits), 60 bytes captured (480 bits) on interface eth0, id 0
Ethernet II, Src: 4c:ed:fb:00:01:02, Dst: ff:ff:ff:ff:ff:ff
    Destination: ff:ff:ff:ff:ff:ff
    Source: 4c:ed:fb:00:01:02
    Type: Unknown (0x8912)
Mediaxtream Protocol
    Management Message Version: 1
    Management Message Type: Discover request (0xa070)
        .... .... .... ..00 = Two LSBs: request (0)
    Fragmentation Management Information: 00:00
        0000 .... = Number of Fragments: 0
        .... 0000 = Fragment Number: 0
        Fragmentation Message Sequence Number: 0
    Management Message Entry
        Organizationally Unique Identifier: 00:1f:84 (Gigle Semiconductor)
        Sequence Number: 1
        Signature: a3 97 a2 55 53 be f1 fc f9 79 6b 52 14 13 e9 e2

0000  ff ff ff ff ff ff 4c ed  fb 00 01 02 89 12 01 70   ......L. .......p
0010  a0 00 00 00 1f 84 01 a3  97 a2 55 53 be f1 fc f9   ........ ..US....
0020  79 6b 52 14 13 e9 e2 00  00 00 00 00 00 00 00 00   ykR..... ........
0030  00 00 00 00 00 00 00 00  00 00 00 00               ........ ....

Confirm Message

One confirm is returned from each adapter, unless the adapter is

  • in power saving mode, or
  • in a different network; that is, the adapter has a different Network Membership Key (NMK).
Field Octet Number Field Size (Octets) Definition
ODA 0 – 5 6 Original Destination Address
OSA 6 – 11 6 Original Source Address
MTYPE 12 – 13 2 IEEE-assigned Ethertype (0x8912)
MMV 14 1 Management Message Version (0x02)
MMTYPE 15 – 16 2 Management Message Type (0xa071)
FMI 17 – 18 2 Fragmentation Management Information (00:00)
MME – 6 – 70 Management Message Entry
MME PAD – 0 – 35 MME padding (0x00 … 0x00)

MME Details

Field Octet Number Field Size (Octets) Definition
OUI 19 – 21 3 Organizationally Unique Identifier (00:1f:84 – Gigle Semiconductor)
Seq Num 22 1 Sequence Number (matches request sequence number)
Interface 23 1 0x00 : MII0
0x01 : MII1
0x02 : PLC
0x03 : PLC
0x04 : SDR
Len 24 1 Length of HFID
User-set HFID – 0 – 64 User-set Human Friendly Identifier

Sample Packet Captures of Confirm Messages

No.     Time           Source                Destination           Protocol      Length Info
      2 0.001705505    c4:12:f5:03:04:05     4c:ed:fb:00:01:02     MEDIAXTREAM   60     Discover confirmation

Frame 2: 60 bytes on wire (480 bits), 60 bytes captured (480 bits) on interface eth0, id 0
Ethernet II, Src: c4:12:f5:03:04:05, Dst: 4c:ed:fb:00:01:02
    Destination: 4c:ed:fb:00:01:02
    Source: c4:12:f5:03:04:05
    Type: Unknown (0x8912)
Mediaxtream Protocol
    Management Message Version: 2
    Management Message Type: Discover confirmation (0xa071)
        .... .... .... ..01 = Two LSBs: confirmation (1)
    Fragmentation Management Information: 00:00
        0000 .... = Number of Fragments: 0
        .... 0000 = Fragment Number: 0
        Fragmentation Message Sequence Number: 0
    Management Message Entry
        Organizationally Unique Identifier: 00:1f:84 (Gigle Semiconductor)
        Sequence Number: 1
        Interface: MII1 (0x01)
        Human-Friendly Identifier Length: 13
        Human-Friendly Identifier: small-bedroom

0000  4c ed fb 00 01 02 c4 12  f5 03 04 05 89 12 02 71   L....... .......q
0010  a0 00 00 00 1f 84 01 01  0d 73 6d 61 6c 6c 2d 62   ........ .small-b
0020  65 64 72 6f 6f 6d 00 00  00 00 00 00 00 00 00 00   edroom.. ........
0030  00 00 00 00 00 00 00 00  00 00 00 00               ........ ....

No.     Time           Source                Destination           Protocol      Length Info
      3 0.003109117    c4:12:f5:03:04:06     4c:ed:fb:00:01:02     MEDIAXTREAM   60     Discover confirmation

Frame 3: 60 bytes on wire (480 bits), 60 bytes captured (480 bits) on interface eth0, id 0
Ethernet II, Src: c4:12:f5:03:04:06, Dst: 4c:ed:fb:00:01:02
    Destination: 4c:ed:fb:00:01:02
    Source: c4:12:f5:03:04:06
    Type: Unknown (0x8912)
Mediaxtream Protocol
    Management Message Version: 2
    Management Message Type: Discover confirmation (0xa071)
        .... .... .... ..01 = Two LSBs: confirmation (1)
    Fragmentation Management Information: 00:00
        0000 .... = Number of Fragments: 0
        .... 0000 = Fragment Number: 0
        Fragmentation Message Sequence Number: 0
    Management Message Entry
        Organizationally Unique Identifier: 00:1f:84 (Gigle Semiconductor)
        Sequence Number: 1
        Interface: PLC (0x02)
        Human-Friendly Identifier Length: 13
        Human-Friendly Identifier: computer-room

0000  4c ed fb 00 01 02 c4 12  f5 03 04 06 89 12 02 71   L....... .......q
0010  a0 00 00 00 1f 84 01 02  0d 63 6f 6d 70 75 74 65   ........ .compute
0020  72 2d 72 6f 6f 6d 00 00  00 00 00 00 00 00 00 00   r-room.. ........
0030  00 00 00 00 00 00 00 00  00 00 00 00               ........ ....

Commands

Other Pages

Clone this wiki locally