PROTOCOLS
Device
Defined in fuchsia.hardware.ethernet/ethernet.fidl
Operation
Packets are transmitted by writing data into the IO buffer and writing a FifoEntry referencing that data (offset + length) into the tx fifo. When the driver is done accessing the data, a FifoEntry with the same cookie value (opaque to the driver) will be readable from the tx fifo.
Packets are received by writing a FifoEntry referencing an available buffer (offset + length) in the IO buffer. When a packet is received, a FifoEntry with the same cookie value (opaque to the driver) will be readable from the rx fifo. The offset field will be the same as was sent. The length field will reflect the actual size of the received packet. The flags field will indicate success or a specific failure condition.
IMPORTANT: The driver will not buffer response messages. It is the client's responsibility to ensure that there is space in the reply side of each fifo for each outstanding tx or rx request. The fifo sizes are returned along with the fifo handles from GetFifos().
See //zircon/system/public/zircon/device/ethernet.h for fifo entry layout and request / response message bits.
GetInfo
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
info |
Info
|
GetFifos
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
status |
zx/status
|
info |
Fifos?
|
SetIOBuffer
Request
| Name | Type |
|---|---|
h |
handle<vmo>
|
Response
| Name | Type |
|---|---|
status |
zx/status
|
Start
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
status |
zx/status
|
Stop
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|
ListenStart
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
status |
zx/status
|
ListenStop
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|
SetClientName
Request
| Name | Type |
|---|---|
name |
string[16]
|
Response
| Name | Type |
|---|---|
status |
zx/status
|
GetStatus
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
device_status |
uint32
|
SetPromiscuousMode
Request
| Name | Type |
|---|---|
enabled |
bool
|
Response
| Name | Type |
|---|---|
status |
zx/status
|
ConfigMulticastAddMac
Request
| Name | Type |
|---|---|
addr |
MacAddress
|
Response
| Name | Type |
|---|---|
status |
zx/status
|
ConfigMulticastDeleteMac
Request
| Name | Type |
|---|---|
addr |
MacAddress
|
Response
| Name | Type |
|---|---|
status |
zx/status
|
ConfigMulticastSetPromiscuousMode
Request
| Name | Type |
|---|---|
enabled |
bool
|
Response
| Name | Type |
|---|---|
status |
zx/status
|
ConfigMulticastTestFilter
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
status |
zx/status
|
DumpRegisters
Request
| Name | Type |
|---|
Response
| Name | Type |
|---|---|
status |
zx/status
|
STRUCTS
MacAddress
Defined in fuchsia.hardware.ethernet/ethernet.fidl
| Name | Type | Description | Default |
|---|---|---|---|
octets |
uint8[6]
|
No default |
Info
Defined in fuchsia.hardware.ethernet/ethernet.fidl
| Name | Type | Description | Default |
|---|---|---|---|
features |
uint32
|
No default | |
mtu |
uint32
|
No default | |
mac |
MacAddress
|
No default |
Fifos
Defined in fuchsia.hardware.ethernet/ethernet.fidl
| Name | Type | Description | Default |
|---|---|---|---|
rx |
handle<fifo>
|
No default | |
tx |
handle<fifo>
|
No default | |
rx_depth |
uint32
|
No default | |
tx_depth |
uint32
|
No default |
CONSTANTS
| Name | Value | Type | Description |
|---|---|---|---|
| INFO_FEATURE_WLAN |
1
|
uint32 |
|
| INFO_FEATURE_SYNTH |
2
|
uint32 |
|
| INFO_FEATURE_LOOPBACK |
4
|
uint32 |
|
| SIGNAL_STATUS |
16777216
|
uint32 |
|
| DEVICE_STATUS_ONLINE |
1
|
uint32 |
|
| MAX_CLIENT_NAME_LEN |
15
|
uint32 |
|
| SET_CLIENT_NAME_MAX_LEN |
16
|
uint32 |