usr/src/boot/sys/boot/efi/include/efinet.h

   1 /* $FreeBSD$ */
   2 #ifndef _EFINET_H
   3 #define _EFINET_H
   4
   5
   6 /*++
   7 Copyright (c)  1999 - 2002 Intel Corporation. All rights reserved
   8 This software and associated documentation (if any) is furnished
   9 under a license and may only be used or copied in accordance
  10 with the terms of the license. Except as permitted by such
  11 license, no part of this software or documentation may be
  12 reproduced, stored in a retrieval system, or transmitted in any
  13 form or by any means without the express written consent of
  14 Intel Corporation.
  15
  16 Module Name:
  17     efinet.h
  18
  19 Abstract:
  20     EFI Simple Network protocol
  21
  22 Revision History
  23 --*/
  24
  25
  26 ///////////////////////////////////////////////////////////////////////////////
  27 //
  28 //      Simple Network Protocol
  29 //
  30
  31 #define EFI_SIMPLE_NETWORK_PROTOCOL \
  32     { 0xA19832B9, 0xAC25, 0x11D3, {0x9A, 0x2D, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D} }
  33
  34
  35 INTERFACE_DECL(_EFI_SIMPLE_NETWORK);
  36
  37 ///////////////////////////////////////////////////////////////////////////////
  38 //
  39
  40 typedef struct {
  41     //
  42     // Total number of frames received.  Includes frames with errors and
  43     // dropped frames.
  44     //
  45     UINT64  RxTotalFrames;
  46
  47     //
  48     // Number of valid frames received and copied into receive buffers.
  49     //
  50     UINT64  RxGoodFrames;
  51
  52     //
  53     // Number of frames below the minimum length for the media.
  54     // This would be <64 for ethernet.
  55     //
  56     UINT64  RxUndersizeFrames;
  57
  58     //
  59     // Number of frames longer than the maxminum length for the
  60     // media.  This would be >1500 for ethernet.
  61     //
  62     UINT64  RxOversizeFrames;
  63
  64     //
  65     // Valid frames that were dropped because receive buffers were full.
  66     //
  67     UINT64  RxDroppedFrames;
  68
  69     //
  70     // Number of valid unicast frames received and not dropped.
  71     //
  72     UINT64  RxUnicastFrames;
  73
  74     //
  75     // Number of valid broadcast frames received and not dropped.
  76     //
  77     UINT64  RxBroadcastFrames;
  78
  79     //
  80     // Number of valid mutlicast frames received and not dropped.
  81     //
  82     UINT64  RxMulticastFrames;
  83
  84     //
  85     // Number of frames w/ CRC or alignment errors.
  86     //
  87     UINT64  RxCrcErrorFrames;
  88
  89     //
  90     // Total number of bytes received.  Includes frames with errors
  91     // and dropped frames.
  92     //
  93     UINT64  RxTotalBytes;
  94
  95     //
  96     // Transmit statistics.
  97     //
  98     UINT64  TxTotalFrames;
  99     UINT64  TxGoodFrames;
 100     UINT64  TxUndersizeFrames;
 101     UINT64  TxOversizeFrames;
 102     UINT64  TxDroppedFrames;
 103     UINT64  TxUnicastFrames;
 104     UINT64  TxBroadcastFrames;
 105     UINT64  TxMulticastFrames;
 106     UINT64  TxCrcErrorFrames;
 107     UINT64  TxTotalBytes;
 108
 109     //
 110     // Number of collisions detection on this subnet.
 111     //
 112     UINT64  Collisions;
 113
 114     //
 115     // Number of frames destined for unsupported protocol.
 116     //
 117     UINT64  UnsupportedProtocol;
 118
 119 } EFI_NETWORK_STATISTICS;
 120
 121 ///////////////////////////////////////////////////////////////////////////////
 122 //
 123
 124 typedef enum {
 125     EfiSimpleNetworkStopped,
 126     EfiSimpleNetworkStarted,
 127     EfiSimpleNetworkInitialized,
 128     EfiSimpleNetworkMaxState
 129 } EFI_SIMPLE_NETWORK_STATE;
 130
 131 ///////////////////////////////////////////////////////////////////////////////
 132 //
 133
 134 #define EFI_SIMPLE_NETWORK_RECEIVE_UNICAST               0x01
 135 #define EFI_SIMPLE_NETWORK_RECEIVE_MULTICAST             0x02
 136 #define EFI_SIMPLE_NETWORK_RECEIVE_BROADCAST             0x04
 137 #define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS           0x08
 138 #define EFI_SIMPLE_NETWORK_RECEIVE_PROMISCUOUS_MULTICAST 0x10
 139
 140 ///////////////////////////////////////////////////////////////////////////////
 141 //
 142
 143 #define EFI_SIMPLE_NETWORK_RECEIVE_INTERRUPT        0x01
 144 #define EFI_SIMPLE_NETWORK_TRANSMIT_INTERRUPT       0x02
 145 #define EFI_SIMPLE_NETWORK_COMMAND_INTERRUPT        0x04
 146 #define EFI_SIMPLE_NETWORK_SOFTWARE_INTERRUPT       0x08
 147
 148 ///////////////////////////////////////////////////////////////////////////////
 149 //
 150 #define MAX_MCAST_FILTER_CNT    16
 151 typedef struct {
 152     UINT32                      State;
 153     UINT32                      HwAddressSize;
 154     UINT32                      MediaHeaderSize;
 155     UINT32                      MaxPacketSize;
 156     UINT32                      NvRamSize;
 157     UINT32                      NvRamAccessSize;
 158     UINT32                      ReceiveFilterMask;
 159     UINT32                      ReceiveFilterSetting;
 160     UINT32                      MaxMCastFilterCount;
 161     UINT32                      MCastFilterCount;
 162     EFI_MAC_ADDRESS             MCastFilter[MAX_MCAST_FILTER_CNT];
 163     EFI_MAC_ADDRESS             CurrentAddress;
 164     EFI_MAC_ADDRESS             BroadcastAddress;
 165     EFI_MAC_ADDRESS             PermanentAddress;
 166     UINT8                       IfType;
 167     BOOLEAN                     MacAddressChangeable;
 168     BOOLEAN                     MultipleTxSupported;
 169     BOOLEAN                     MediaPresentSupported;
 170     BOOLEAN                     MediaPresent;
 171 } EFI_SIMPLE_NETWORK_MODE;
 172
 173 ///////////////////////////////////////////////////////////////////////////////
 174 //
 175
 176 typedef
 177 EFI_STATUS
 178 (EFIAPI *EFI_SIMPLE_NETWORK_START) (
 179     IN struct _EFI_SIMPLE_NETWORK  *This
 180 );
 181
 182 ///////////////////////////////////////////////////////////////////////////////
 183 //
 184
 185 typedef
 186 EFI_STATUS
 187 (EFIAPI *EFI_SIMPLE_NETWORK_STOP) (
 188     IN struct _EFI_SIMPLE_NETWORK  *This
 189 );
 190
 191 ///////////////////////////////////////////////////////////////////////////////
 192 //
 193
 194 typedef
 195 EFI_STATUS
 196 (EFIAPI *EFI_SIMPLE_NETWORK_INITIALIZE) (
 197     IN struct _EFI_SIMPLE_NETWORK  *This,
 198     IN UINTN                       ExtraRxBufferSize  OPTIONAL,
 199     IN UINTN                       ExtraTxBufferSize  OPTIONAL
 200 );
 201
 202 ///////////////////////////////////////////////////////////////////////////////
 203 //
 204
 205 typedef
 206 EFI_STATUS
 207 (EFIAPI *EFI_SIMPLE_NETWORK_RESET) (
 208     IN struct _EFI_SIMPLE_NETWORK   *This,
 209     IN BOOLEAN                      ExtendedVerification
 210 );
 211
 212 ///////////////////////////////////////////////////////////////////////////////
 213 //
 214
 215 typedef
 216 EFI_STATUS
 217 (EFIAPI *EFI_SIMPLE_NETWORK_SHUTDOWN) (
 218     IN struct _EFI_SIMPLE_NETWORK  *This
 219 );
 220
 221 ///////////////////////////////////////////////////////////////////////////////
 222 //
 223
 224 typedef
 225 EFI_STATUS
 226 (EFIAPI *EFI_SIMPLE_NETWORK_RECEIVE_FILTERS) (
 227     IN struct _EFI_SIMPLE_NETWORK   *This,
 228     IN UINT32                       Enable,
 229     IN UINT32                       Disable,
 230     IN BOOLEAN                      ResetMCastFilter,
 231     IN UINTN                        MCastFilterCnt     OPTIONAL,
 232     IN EFI_MAC_ADDRESS              *MCastFilter       OPTIONAL
 233 );
 234
 235 ///////////////////////////////////////////////////////////////////////////////
 236 //
 237
 238 typedef
 239 EFI_STATUS
 240 (EFIAPI *EFI_SIMPLE_NETWORK_STATION_ADDRESS) (
 241     IN struct _EFI_SIMPLE_NETWORK   *This,
 242     IN BOOLEAN                      Reset,
 243     IN EFI_MAC_ADDRESS              *New      OPTIONAL
 244 );
 245
 246 ///////////////////////////////////////////////////////////////////////////////
 247 //
 248
 249 typedef
 250 EFI_STATUS
 251 (EFIAPI *EFI_SIMPLE_NETWORK_STATISTICS) (
 252     IN struct _EFI_SIMPLE_NETWORK   *This,
 253     IN BOOLEAN                      Reset,
 254     IN OUT UINTN                    *StatisticsSize   OPTIONAL,
 255     OUT EFI_NETWORK_STATISTICS      *StatisticsTable  OPTIONAL
 256 );
 257
 258 ///////////////////////////////////////////////////////////////////////////////
 259 //
 260
 261 typedef
 262 EFI_STATUS
 263 (EFIAPI *EFI_SIMPLE_NETWORK_MCAST_IP_TO_MAC) (
 264     IN struct _EFI_SIMPLE_NETWORK   *This,
 265     IN BOOLEAN                      IPv6,
 266     IN EFI_IP_ADDRESS               *IP,
 267     OUT EFI_MAC_ADDRESS             *MAC
 268 );
 269
 270 ///////////////////////////////////////////////////////////////////////////////
 271 //
 272
 273 typedef
 274 EFI_STATUS
 275 (EFIAPI *EFI_SIMPLE_NETWORK_NVDATA) (
 276     IN struct _EFI_SIMPLE_NETWORK  *This,
 277     IN BOOLEAN                     ReadWrite,
 278     IN UINTN                       Offset,
 279     IN UINTN                       BufferSize,
 280     IN OUT VOID                    *Buffer
 281 );
 282
 283 ///////////////////////////////////////////////////////////////////////////////
 284 //
 285
 286 typedef
 287 EFI_STATUS
 288 (EFIAPI *EFI_SIMPLE_NETWORK_GET_STATUS) (
 289     IN struct _EFI_SIMPLE_NETWORK  *This,
 290     OUT UINT32                     *InterruptStatus  OPTIONAL,
 291     OUT VOID                       **TxBuf           OPTIONAL
 292 );
 293
 294 ///////////////////////////////////////////////////////////////////////////////
 295 //
 296
 297 typedef
 298 EFI_STATUS
 299 (EFIAPI *EFI_SIMPLE_NETWORK_TRANSMIT) (
 300     IN struct _EFI_SIMPLE_NETWORK   *This,
 301     IN UINTN                        HeaderSize,
 302     IN UINTN                        BufferSize,
 303     IN VOID                         *Buffer,
 304     IN EFI_MAC_ADDRESS              *SrcAddr     OPTIONAL,
 305     IN EFI_MAC_ADDRESS              *DestAddr    OPTIONAL,
 306     IN UINT16                       *Protocol    OPTIONAL
 307 );
 308
 309 ///////////////////////////////////////////////////////////////////////////////
 310 //
 311
 312 typedef
 313 EFI_STATUS
 314 (EFIAPI *EFI_SIMPLE_NETWORK_RECEIVE) (
 315     IN struct _EFI_SIMPLE_NETWORK   *This,
 316     OUT UINTN                       *HeaderSize  OPTIONAL,
 317     IN OUT UINTN                    *BufferSize,
 318     OUT VOID                        *Buffer,
 319     OUT EFI_MAC_ADDRESS             *SrcAddr     OPTIONAL,
 320     OUT EFI_MAC_ADDRESS             *DestAddr    OPTIONAL,
 321     OUT UINT16                      *Protocol    OPTIONAL
 322 );
 323
 324 ///////////////////////////////////////////////////////////////////////////////
 325 //
 326
 327 #define EFI_SIMPLE_NETWORK_INTERFACE_REVISION   0x00010000
 328
 329 typedef struct _EFI_SIMPLE_NETWORK {
 330     UINT64                              Revision;
 331     EFI_SIMPLE_NETWORK_START            Start;
 332     EFI_SIMPLE_NETWORK_STOP             Stop;
 333     EFI_SIMPLE_NETWORK_INITIALIZE       Initialize;
 334     EFI_SIMPLE_NETWORK_RESET            Reset;
 335     EFI_SIMPLE_NETWORK_SHUTDOWN         Shutdown;
 336     EFI_SIMPLE_NETWORK_RECEIVE_FILTERS  ReceiveFilters;
 337     EFI_SIMPLE_NETWORK_STATION_ADDRESS  StationAddress;
 338     EFI_SIMPLE_NETWORK_STATISTICS       Statistics;
 339     EFI_SIMPLE_NETWORK_MCAST_IP_TO_MAC  MCastIpToMac;
 340     EFI_SIMPLE_NETWORK_NVDATA           NvData;
 341     EFI_SIMPLE_NETWORK_GET_STATUS       GetStatus;
 342     EFI_SIMPLE_NETWORK_TRANSMIT         Transmit;
 343     EFI_SIMPLE_NETWORK_RECEIVE          Receive;
 344     EFI_EVENT                           WaitForPacket;
 345     EFI_SIMPLE_NETWORK_MODE             *Mode;
 346 } EFI_SIMPLE_NETWORK;
 347
 348 #endif /* _EFINET_H */