sys/dev/netif/nv/phy.h.patch

   1 $DragonFly: src/sys/dev/netif/nv/Attic/phy.h.patch,v 1.2 2005/04/04 18:45:07 joerg Exp $
   2
   3 --- phy.h.orig  2005-03-12 10:59:28.000000000 +0100
   4 +++ phy.h       2005-04-02 20:35:16.000000000 +0200
   5 @@ -22,8 +22,8 @@
   6  #ifndef _PHY_H_
   7  #define _PHY_H_
   8
   9 -//#include "basetype.h"
  10 -//#include "nvevent.h"
  11 +/*#include "basetype.h" */
  12 +/*#include "nvevent.h" */
  13
  14  #ifdef __cplusplus
  15  extern "C" {
  16 @@ -34,9 +34,9 @@
  17
  18  #define HDP_VERSION_STRING "HDR P: $Revision: #23 $"
  19
  20 -//
  21 -// Defaults for PHY timeout values.
  22 -//
  23 +/*
  24 +** Defaults for PHY timeout values.
  25 +*/
  26  #define PHY_POWER_ISOLATION_MS_TIMEOUT_DEFAULT      50
  27  #define PHY_RESET_MS_TIMEOUT_DEFAULT                50
  28  #define PHY_AUTONEG_MS_TIMEOUT_DEFAULT              3000
  29 @@ -45,13 +45,13 @@
  30  #define PHY_POWER_DOWN_US_TIMEOUT_DEFAULT           500
  31
  32
  33 -/////////////////////////////////////////////////////////////////////////
  34 -// The phy module knows the values that need to go into the phy registers
  35 -// but typically the method of writing those registers is controlled by
  36 -// another module (usually the adapter because it is really the hardware
  37 -// interface.) Hence, the phy needs routines to call to read and write the
  38 -// phy registers. This structure with appropriate routines will be provided
  39 -// in the PHY_Open call.
  40 +/***********************************************************************/
  41 +/* The phy module knows the values that need to go into the phy registers
  42 +** but typically the method of writing those registers is controlled by
  43 +** another module (usually the adapter because it is really the hardware
  44 +** interface.) Hence, the phy needs routines to call to read and write the
  45 +** phy registers. This structure with appropriate routines will be provided
  46 +** in the PHY_Open call. */
  47
  48  typedef NV_API_CALL NV_SINT32 (* PFN_READ_PHY)  (PNV_VOID pvData, NV_UINT32 ulPhyAddr, NV_UINT32 ulPhyReg, NV_UINT32 *pulValue);
  49  typedef NV_API_CALL NV_SINT32 (* PFN_WRITE_PHY) (PNV_VOID pvData, NV_UINT32 ulPhyAddr, NV_UINT32 ulPhyReg, NV_UINT32 ulValue);
  50 @@ -61,13 +61,13 @@
  51      PNV_VOID            pADCX;
  52      PFN_READ_PHY        pfnRead;
  53      PFN_WRITE_PHY       pfnWrite;
  54 -       // PFN_EVENT_OCCURED   pfnEventOccurred;
  55 +       /* PFN_EVENT_OCCURED   pfnEventOccurred; */
  56
  57 -    //
  58 -    // These fields are passed down via the FD.  FD get's them
  59 -    // from the registry.  They allow one to fine tune the timeout
  60 -    // values in the PHY.
  61 -    //
  62 +    /*
  63 +    ** These fields are passed down via the FD.  FD get's them
  64 +    ** from the registry.  They allow one to fine tune the timeout
  65 +    ** values in the PHY.
  66 +    */
  67      NV_UINT32  PhyPowerIsolationTimeoutInms;
  68         NV_UINT32       PhyResetTimeoutInms;
  69         NV_UINT32       PhyAutonegotiateTimeoutInms;
  70 @@ -75,11 +75,11 @@
  71         NV_UINT32       PhyPowerdownOnCloseInus;
  72
  73  }   PHY_SUPPORT_API, *PPHY_SUPPORT_API;
  74 -/////////////////////////////////////////////////////////////////////////
  75 +/***********************************************************************/
  76
  77
  78 -/////////////////////////////////////////////////////////////////////////
  79 -// The functional typedefs for the PHY Api
  80 +/***********************************************************************/
  81 +/* The functional typedefs for the PHY Api */
  82  typedef NV_SINT32 (* PFN_PHY_INIT) (PNV_VOID pvContext, NV_UINT32 *pulLinkState, NV_UINT32 PhyMode);
  83  typedef NV_SINT32 (* PFN_PHY_DEINIT) (PNV_VOID pvContext);
  84  typedef NV_SINT32 (* PFN_PHY_CLOSE) (PNV_VOID pvContext);
  85 @@ -95,8 +95,8 @@
  86
  87  typedef struct  _PHY_API
  88  {
  89 -    // This is the context to pass back in as the first arg on all
  90 -    // the calls in the API below.
  91 +    /* This is the context to pass back in as the first arg on all */
  92 +    /* the calls in the API below. */
  93      PNV_VOID               pPHYCX;
  94
  95      PFN_PHY_INIT                pfnInit;
  96 @@ -112,22 +112,22 @@
  97      PFN_PHY_POWERDOWN            pfnPowerdown;
  98      PFN_SET_LOW_SPEED_FOR_PM    pfnSetLowSpeedForPM;
  99  }   PHY_API, *PPHY_API;
 100 -/////////////////////////////////////////////////////////////////////////
 101 +/***********************************************************************/
 102
 103
 104 -/////////////////////////////////////////////////////////////////////////
 105 -// This is the one function in the PHY interface that is publicly
 106 -// available. The rest of the interface is returned in the pPhyApi;
 107 -// The first argument needs to be cast to a POS_API structure ptr.
 108 -// On input the second argument is a ptr to a PPHY_SUPPORT_API.
 109 -// On output, the second argument should be treated as a ptr to a
 110 -// PPHY_API and set appropriately.
 111 +/***********************************************************************/
 112 +/* This is the one function in the PHY interface that is publicly
 113 +** available. The rest of the interface is returned in the pPhyApi;
 114 +** The first argument needs to be cast to a POS_API structure ptr.
 115 +** On input the second argument is a ptr to a PPHY_SUPPORT_API.
 116 +** On output, the second argument should be treated as a ptr to a
 117 +** PPHY_API and set appropriately. */
 118  extern NV_SINT32 PHY_Open (PNV_VOID pvOSApi, PNV_VOID pPhyApi, NV_UINT32 *pulPhyAddr, NV_UINT32 *pulPhyConnected);
 119 -/////////////////////////////////////////////////////////////////////////
 120 +/***********************************************************************/
 121
 122
 123 -/////////////////////////////////////////////////////////////////////////
 124 -// Here are the error codes the phy functions can return.
 125 +/***********************************************************************/
 126 +/* Here are the error codes the phy functions can return. */
 127  #define PHYERR_NONE                                 0x0000
 128  #define PHYERR_COULD_NOT_ALLOC_CONTEXT              0x0001
 129  #define PHYERR_RESET_NEVER_FINISHED                 0x0002
 130 @@ -144,21 +144,21 @@
 131
 132  #define PHY_INVALID_PHY_ADDR                    0xFFFF;
 133
 134 -/////////////////////////////////////////////////////////////////////////
 135 +/***********************************************************************/
 136
 137 -// This value can be used in the ulPhyLinkSpeed field.
 138 +/* This value can be used in the ulPhyLinkSpeed field. */
 139  #define PHY_LINK_SPEED_UNKNOWN          0x0FFFFFFFF
 140
 141 -//
 142 -// Values used to configure PHY mode.
 143 -//
 144 +/*
 145 +** Values used to configure PHY mode.
 146 +*/
 147  #define PHY_MODE_MII    1
 148  #define PHY_MODE_RGMII  2
 149
 150  typedef NV_VOID (* PTIMER_FUNC) (PNV_VOID pvContext);
 151
 152  #ifdef __cplusplus
 153 -} // extern "C"
 154 +} /* extern "C" */
 155  #endif
 156
 157 -#endif //_PHY_H_
 158 +#endif /*_PHY_H_ */