Reference Manual

Access Restricted

This page contains internal documentation that is not publicly available.


DHWCtrl.EthSendFrame

Transmit one Ethernet frame on Index. The MAC hardware appends the CRC; no firmware-side padding. Total wire length must be in [14, 1518] bytes (excl. CRC).

Properties

Parameters (request frame)

Name Type/Size Description
Index Integer (8 bits) Zero-based instance index within this peripheral category. The valid range is firmware / hardware-variant specific; discoverable via ListPeripherals.
DstMac Raw data (length 6 Bytes) Destination MAC address (6 bytes).
SrcMac Raw data (length 6 Bytes) Source MAC address (6 bytes). Should match the value passed to EthActivate for spec-compliant frames, but may be set freely for bench tests (MAC-spoofing scenarios).
EtherType Enumeration (16 bits) Outer EtherType of the frame to send.
EtherType field of an Ethernet II frame header, identifying the upper-layer protocol carried in the payload. IEEE 802.3 distinguishes by value: <= 1500 (0x05DC) is interpreted as a legacy LLC frame length; >= 1536 (0x0600) is an EtherType per the IANA registry. The enum lists the common values seen on the bench; the field is extendable so any 16-bit value can be sent / received for bench tests (malformed-frame scenarios, experimental protocols).
Values (12):
  • IPv4 (0x0800)
    Internet Protocol version 4.
  • ARP (0x0806)
    Address Resolution Protocol.
  • ReverseARP (0x8035)
    Reverse Address Resolution Protocol.
  • IPv6 (0x86DD)
    Internet Protocol version 6.
  • VlanTagged (0x8100)
    IEEE 802.1Q VLAN tag (TPID). The 2 bytes following the EtherType slot carry the TCI (priority + DEI + VLAN ID); the inner EtherType identifying the actual payload protocol follows after that.
  • ServiceVlanTagged (0x88A8)
    IEEE 802.1ad service VLAN tag ("QinQ"). Outer provider tag in stacked-VLAN frames.
  • LACP (0x8809)
    Link Aggregation Control Protocol (IEEE 802.3ad).
  • MplsUnicast (0x8847)
    MPLS unicast.
  • MplsMulticast (0x8848)
    MPLS multicast.
  • LLDP (0x88CC)
    Link Layer Discovery Protocol (IEEE 802.1AB).
  • MACsec (0x88E5)
    MAC Security (IEEE 802.1AE).
  • Loopback (0x9000)
    Ethernet Configuration Testing Protocol (loopback).
Payload Raw data (until end of frame) Bytes following the EtherType. For VLAN-tagged frames the first 2 bytes are the TCI followed by the inner EtherType, then the actual payload.

Returned values (response frame)

None