zephyr/doc/reference/networking/ethernet_mgmt.rst
Gerard Marull-Paretas 8c4b757fd4 doc: remove redundant breathe project
The default breathe project is `Zephyr`, so there is no need to specify
it.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2021-05-20 20:04:51 +02:00

34 lines
948 B
ReStructuredText

.. _ethernet_mgmt_interface:
Ethernet Management
###################
.. contents::
:local:
:depth: 2
Overview
********
Ethernet management API provides functions to manage the Ethernet
network interface low level status. The caller of these functions can:
* raise ``carrier ON`` or ``carrier OFF`` management events
* raise ``VLAN enabled`` or ``VLAN disabled`` management events
Typically the ``carrier OFF`` event would be generated by the Ethernet
device driver when it notices that the Ethernet cable is disconnected.
The ``carrier ON`` event would be generated if the Ethernet device driver
notices that the Ethernet cable is re-connected.
Currently the VLAN events are generated by the Ethernet L2 layer when a
specific VLAN tag is either enabled or disabled.
The user application can monitor these events if it needs to act
when the corresponding status changes.
API Reference
*************
.. doxygengroup:: ethernet_mgmt