Skip to content

get capabilities

Jump to bottom
John Serock edited this page Apr 22, 2023 · 5 revisions

The get-capabilities command retrieves capabilities of a power line adapter.

Sample Usage

$ pla-util get-capabilities
AV Version:             2.0
MAC Address:            c4:12:f5:03:04:05
OUI:                    001f84
Backup CCo:             CAPABLE
Proxy:                  NOT_CAPABLE
Implementation Version: 1

Request Message [1]

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 (0x88e1)
MMV 14 1 Management Message Version (0x01)
MMTYPE 15 – 16 2 Management Message Type (0x6034)
FMI 17 – 18 2 Fragmentation Management Information (00:00)
MME PAD 19 – 59 41 MME padding (0x00 … 0x00)

Sample Packet Capture of Request Message

No.     Time           Source                Destination           Protocol    Length Info
      1 0.503621980    4c:ed:fb:00:01:02     c4:12:f5:03:04:05     HOMEPLUGAV  60     Station Capabilities 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: c4:12:f5:03:04:05
    Destination: c4:12:f5:03:04:05
    Source: 4c:ed:fb:00:01:02
    Type: Homeplug AV (0x88e1)
HomePlug AV Protocol
    Management Message Version: 1.1 (1)
    Management Message Type: Station Capabilities request (0x6034)
        011. .... .... .... = Three MSBs: Station -- Station (3)
        .... .... .... ..00 = Two LSBs: request (0)
    Fragmentation Management Information: 00:00
        0000 .... = Number of Fragments: 0
        .... 0000 = Fragment Number: 0
        Fragmentation Message Sequence Number: 0

0000  c4 12 f5 03 04 05 4c ed  fb 00 01 02 88 e1 01 34   ......L. .......4
0010  60 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00   `....... ........
0020  00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00   ........ ........
0030  00 00 00 00 00 00 00 00  00 00 00 00               ........ ....

Confirm Message [1]

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 (0x88e1)
MMV 14 1 Management Message Version (0x01)
MMTYPE 15 – 16 2 Management Message Type (0x6035)
FMI 17 – 18 2 Fragmentation Management Information (00:00)
MME 19 – 43 25 Management Message Entry
MME PAD 44 – 59 16 MME padding (0x00 … 0x00)

MME Details [2]

Field Octet Number Field Size (Octets) Definition
AVVersion 19 1 HomePlug AV Version
0x00 : HomePlug AV 1.1
0x01 : HomePlug AV 2.0
MACAddr 20 – 25 6 MAC Address
OUI 26 – 28 3 Organizationally Unique Identifier (001f84 – Gigle Semiconductor)
AutoConnect 29 1 Auto Connect Capability
0x00 : Not supported
0x01 : Supported
Smoothing 30 1 Smoothing Capability
0x00 : Not supported
0x01 : Supported
CCoCapability 31 1 CCo Capability
Proxy Capable 32 1 Proxy Capability
0x00 : Not capable of being a Proxy Coordinator
0x01 : Capable of being a Proxy Coordinator
BackupCCo 33 1 Backup CCo-capable
0x00 : Not supported
0x01 : Supported
SoftHandOver 34 1 Soft Hand Over Support
0x00 : Not supported
0x01 : Supported
TwoSymFC 35 1 Two Symbol Frame Control
MaxFL_AV 36 – 37 2 Maximum Value of FL_AV that the station is capable of supporting in multiples of 1.28 µsec.
0x00 : 0 µsec
0x01 : 1.28 µsec
0x02 : 2.56 µsec
⋮
HomePlug1.1Cap 38 1 Ability to Support Enhanced Coexistence with HomePlug 1.1
0x00 : Not capable
0x01 : Capable
HomePlug1.0Interop 39 1 HomePlug 1.0.1 Interoperability
0x00 : Not capable
0x01 : Capable
RegulatoryCap 40 1 Capability of Operating in Various Regulatory Domains
0x00 : North America only
Bidirectional Bursting 41 1 Bidirectional Bursting Capability
0x00 : Not supported
0x01 : Supports bursts ending with SACK
0x02 : Supports bursts ending with SACK or Reverse SOF
ImplementationVer 42 – 43 2 Implementation Version

Sample Packet Capture of Confirm Message

No.     Time           Source                Destination           Protocol    Length Info
      2 0.503880037    c4:12:f5:03:04:05     4c:ed:fb:00:01:02     HOMEPLUGAV  60     Station Capabilities 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: Homeplug AV (0x88e1)
HomePlug AV Protocol
    Management Message Version: 1.1 (1)
    Management Message Type: Station Capabilities confirmation (0x6035)
        011. .... .... .... = Three MSBs: Station -- Station (3)
        .... .... .... ..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
        HomePlug AV Version: 2.0 (1)
        MAC Address: c4:12:f5:03:04:05
        Organizationally Unique Identifier: 00:1f:84 (Gigle Semiconductor)
        Auto Connect Capability: no (0)
        Smoothing Capability: no (0)
        CCo Capability: yes (1)
        Proxy Capability: no (0)
        Backup CCo Capability: yes (1)
        Soft Handover Capability: no (0)
        Two-Symbol Frame Control Capability: no (0)
        Maximum Frame Length: 2501.12 microseconds
        HomePlug 1.1 Capability: yes (1)
        HomePlug 1.0 Interoperability: no (0)
        Regulatory Capability: North America only (0)
        Bidirectional Bursting Capability: Selective ACK only (1)
        Implementation Version: 1

0000  4c ed fb 00 01 02 c4 12  f5 03 04 05 88 e1 01 35   L....... .......5
0010  60 00 00 01 c4 12 f5 03  04 05 00 1f 84 00 00 01   `....... ........
0020  00 01 00 00 a2 07 01 00  00 01 01 00 00 00 00 00   ........ ........
0030  00 00 00 00 00 00 00 00  00 00 00 00               ........ ....

[1] (2014). HomePlug AV Specification Version 2.1. (pp. 647–650, 661). Retrieved from https://docbox.etsi.org/Reference/homeplug_av21/homeplug_av21_specification_final_public.pdf.

[2] (2014). HomePlug AV Specification Version 2.1. (pp. 774–777).

Commands

Other Pages

Clone this wiki locally