This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

atmel,sam-gmac

Vendor: Atmel Corporation

Description

Atmel SAM-family GMAC Ethernet

Properties

Properties not inherited from the base binding file.

Name

Type

Details

peripheral-id

int

The peripheral identifier is required for Atmel SAMs MCUs to indicate
which is the clock line associated with a specific peripheral.  This
clock line is defined at Power Management Controller (PMC) and it
enables the peripheral.

This property is required.

num-queues

int

Number of hardware TX and RX queues.

This property is required.

max-frame-size

int

Maximum ethernet frame size.  The current ethernet frame sizes
supported by hardware are 1518, 1536 and 10240 (jumbo frames).  This
means that normally gmac will reject any frame above max-frame-size
value.  The default value is 1518, which represents an usual
IEEE 802.3 ethernet frame:

  Ethernet Frame [ 14 MAC HEADER | 1500 MTU | 4 FCS ] = 1518 bytes

When using value 1536 it is possible extend ethernet MAC HEADER up
to 32 bytes.  The hardware have support to jumbo frames and it can be
enabled by selecting the value 10240.

Default value: 1518

max-speed

int

This specifies maximum speed in Mbit/s supported by the device.  The
gmac driver supports 10Mbit/s and 100Mbit/s.  Using 100, as default
value, enables driver to configure 10 and 100Mbit/s speeds.

Default value: 100

phy-connection-type

string

Phy connection type define the physical interface connection between
PHY and MAC.  The default value uses gmac register reset value, which
represents Reduced Media-Independent Interface (RMII) mode.

This property must be used with pinctrl-0.

Default value: rmii

Legal values: 'rmii', 'mii'

pinctrl-0

phandles

PIO pin configuration for the various GMAC signals that include GTXCK,
GTXEN, GTX[3..0], GTXER, GRXCK, GRXDV, GRX[3..0], GRXER, GCRS, GCOL,
GMDC, and GMDIO.  Which signals are used vary based on if the PHY
connection is MII or RMII (see datasheet for more details).  We expect
that the phandles will reference pinctrl nodes.  These nodes will have
a nodelabel that matches the Atmel SoC HAL defines and be of the form
p<port><pin><periph>_<inst>_<signal>.

For example the GMAC on SAME7x would be for RMII
  pinctrl-0 = <&pd0a_gmac_gtxck &pd1a_gmac_gtxen
               &pd2a_gmac_gtx0 &pd3a_gmac_gtx1
               &pd4a_gmac_grxdv &pd5a_gmac_grx0
               &pd6a_gmac_grx1 &pd7a_gmac_grxer
               &pd8a_gmac_gmdc &pd9a_gmac_gmdio>;

This property must be used with phy-connection-type.

local-mac-address

uint8-array

Specifies the MAC address that was assigned to the network device

zephyr,random-mac-address

boolean

Use a random MAC address generated when the driver is initialized.
Note that using this choice and rebooting a board may leave stale
MAC address in peers' ARP caches and lead to issues and delays in
communication.  (Use "ip neigh flush all" on Linux peers to clear
ARP cache.)

It is driver specific how the OUI octets are handled.

If set we ignore any setting of the local-mac-address property.