NET2272.C代码分析 BindPhysicalEndpoints(ENDPOINT_OBJECT *pLogicalEp)

/***************************************************************************
 * Physical Endpoint structure. USB core operates at logical endpoint level.
 * once host selects a configuration and an interface the associated logical endpoint objects
 * of the currently active interface will be binded with the physical endpoint objects. 
 * The bind holds good until host again sets or resets the configuration and interface
 */
typedef struct PhysicalEndpointObject
{
   ENDPOINT_OBJECT   *pLogicalEndpointObj;   /* logical endpoint object */
   int      eEndpointStat;    /* endpoint state */
   int      PhysicalEndpointID;  /* Physical endpoint ID */
}PHYSICAL_ENDPOINT_OBJECT;



/* Endpoint Descriptor -Size 7 bytes - 6 fields */
typedef struct EndPointDescriptor
{
   u8_t bLength;     /* Descriptor size in bytes */
   u8_t bDescriptorType;   /* Descriptor type ENDPOINT 05h */
   u8_t bEndpointAddress;  /* Endpoint Address */
   u8_t bAttributes; /* Transfer type supported */    
   u16_t wMaxPacketSize;   /* Maximum packet size supported */
   u8_t bInternal;      /* Maximum latency/polling/NACK rate */
}ENDPOINT_DESCRIPTOR, *PENDPOINT_DESCRIPTOR;


/* Endpoint Object */
typedef struct EndpointObject
{
   ENDPOINT_DESCRIPTOR     *pEndpointDesc;      /*Endpoint Descriptor */
   ENDPOINT_SPECIFIC_OBJECT   *pEndpointSpecificObj;  /* EP-Specific Config Obj */
   struct EndponitObject      *pNext;        /* Next Endpoint object */
   /* pNextActiveEp is used by the peripheral driver to get the currently active endpoint list */
   struct EndponitObject      *pNextActiveEpObj;   /* Pointers to the next peer endpoint object */
   int            ID;         /* Endpoint ID */
   USB_EP_INFO       EPInfo;  
}ENDPOINT_OBJECT, *PENDPOINT_OBJECT;



/* Endpoint Specific Configuration Object */
typedef struct EndpointSpecificObject
{
   int   length;        /* total length of ep specific config */
   void  *pEpSpecificData; /* Endpoint specific data */
   struct   EndpointSpecificObject *pNext; /* Next object */
}ENDPOINT_SPECIFIC_OBJECT, *PENDPOINT_SPECIFIC_OBJECT;


typedef enum {          /* Data direction       */
   ADI_DEV_DIRECTION_UNDEFINED,  /* undefined         */
   ADI_DEV_DIRECTION_INBOUND, /* inbound (read)       */
   ADI_DEV_DIRECTION_OUTBOUND,   /* outbound (write)     */
   ADI_DEV_DIRECTION_BIDIRECTIONAL,/* both (read and write) */
} ADI_DEV_DIRECTION;

typedef enum DeviceState
{
   DEV_STATE_RESET=0,
   DEV_STATE_OPEN_IN_PROCESS,
   DEV_STATE_OPENED,
   DEV_STATE_CLOSED,
   DEV_STATE_STARTED,
}DEVICE_STATE;

typedef enum {                          // Stream IDs for memory DMA
    ADI_DMA_MDMA_0,                         // memory DMA stream 0
    ADI_DMA_MDMA_1,                         // memory DMA stream 1

    ADI_DMA_MEMORY_STREAM_COUNT,            // number of memory DMA streams
} ADI_DMA_STREAM_ID;

/* USB bus speeds */
typedef enum UsbDeviceSpeed
{
    ADI_USB_DEVICE_SPEED_UNKNOWN,
    ADI_USB_DEVICE_SPEED_HIGH,
    ADI_USB_DEVICE_SPEED_FULL,
    ADI_USB_DEVICE_SPEED_LOW,
}ADI_USB_DEVICE_SPEED;

/* NET2272 Core Device Structure */
typedef struct Net2272DeviceData
{
   ADI_DEV_DEVICE_HANDLE   DeviceHandle;     /* 设备控制 */
   ADI_DMA_MANAGER_HANDLE  DMAHandle;        /* DMA控制 */
   ADI_DCB_HANDLE          DCBHandle;        /* 数据控制块(DCB) */
   ADI_DCB_CALLBACK_FN     DMCallback;       /* 回调函数 */
   ADI_DEV_DIRECTION       Direction;        /* 设备方向 */
   void                    *pCriticalRegionArg;    /* 关键区参数指针 */
   bool                    Started;       /* 开始标志 */
   DEVICE_STATE            State;         /* 设备状态 */
   PHYSICAL_ENDPOINT_OBJECT  PhysicalEndpointObjects[NUM_PHYSICAL_ENDPOINTS]; /* 物理终点对象*/
   int                     NumPhysicalEndpoints;   /* 物理中点数量 */
   ADI_DMA_STREAM_ID       DmaStreamID;         /* DMA流的ID */
   void*                   DmaChannelHandle;    /* DMA通道句柄 */
   ADI_INT_PERIPHERAL_ID   PeripheralID;     /* 外围设备ID *、
   u32                     PeripheralIVG;    /* 外围设备中断向量优先级*/
   int                     PF_Reset;         /* PF(Programmable Flag)角复位 */
   int                     PF_Int;        /* PF角中断 */
   int                     PF_Clear;         /* PF角清空 */
   int                     PF_Set;        /* PF角设置 */
   int                     DeviceID;         /* 设备ID */
   DEVICE_OBJECT           *pDeviceObj;         /* 设备对象指针 */
   NET2272_STATS           Stats;         /* NET2272的状态 */
   bool                    Cache;         /* Cache */
   void                    *ConfigMemoryArea;      /* 配置内存区指针 */
   int                     ConfigMemorySize;    /* 配置内存区大小 */
   int                     BufferPrefix;     /* 缓冲区前缀 */
   ADI_USB_DEVICE_SPEED      Speed;       /* USB 设备速度 */
}ADI_NET2272_DEVICE;


/* We bind each logical Endpoint object with the physical Endpoint objects. The Endpoint Object 
 * that is passed in is the logical endpoint object present in the currently active configuration */

section("L1_code") int BindPhysicalEndpoints(ENDPOINT_OBJECT *pLogicalEp)
{
   int i = 1;
   PHYSICAL_ENDPOINT_OBJECT *pPhyEpO;
   ENDPOINT_OBJECT pLogEp = pLogicalEp;
   ENDPOINT_DESCRIPTOR *pEpD;
   ADI_NET2272_DEVICE *pDev = &Net2272Device;
   volatile unsigned char EpCfg = 0x00, e;
   
   for (i = 1; ((i <= NUM_PHYSICAL_ENDPOINTS) && (pLogEp != NULL)); i++)
   {
      _outpb_d(PAGESEL_ADDR, (unsigned char)i & 0xff);
      e = _inpb_d(PAGESEL_ADDR);
      /* Set the logical endpoint object associated for this point */
      pDev->PhysicalEndpointObject[i].pLogicalEndpointObj = pLogEp;
      
      /* Get the endpoint descriptor */
      pEpD = pLogEp->pEndpointDesc;
      
      /* Set endpoint ID */
      pDev->PhysicalEndpointObjects[i].PhysicalEndpointID = pEpD->bEndpointAddress & 0x0F;
      
      /* configure the Max packet size */
      _outpb_ind(EP_MAXPKT0, LOW_BYTE_LW(pEpD->wMaxPacketSize));
      _outpb_ind(EP_MAXPKT1, HIGH_BYTE_LW(pEpD->wMaxPacketSize));
      
      /* EP_CFG register settings */
      EpCfg = ((pEpD->bEndpointAddress & 0x0F) |      /* Endpoint Number */
         (((pEpD->bEndpointAddress >> 7) & 0x1) << 4) |  /* Endpoint Direction. Host in from device */
         (pEpD->bAttributes << 5) |          /* Endpoint type */
         1 << 7);             /* Endpoint Enable */
      
      _outpb_ind(EP_CFG, EpCfg);
      
      e = _inpb_d(PAGESEL_ADDR);
      
      /* disable all interrupts */
      _outpb_d(EP_IRQENB_ADDR, 0x00);
      
      /* reset all status registers */ /* write 1 set and write 1 clear */
      _outpb_d(EP_STAT0_ADDR, _inpb_d(EP_STAT0_ADDR));
      _outpb_d(EP_STAT1_ADDR, _inpb_d(EP_STAT1_ADDR));
      
      /* Check the direction if its 0x1 means IN endpoint (host perspective)
       * i.e you are going to send data on it, since endpoints are uni-directional 
       * we really care about only one handler at a time */
      if ((pEpD->bEndpointAddress >> 7) & 0x1)
      {
         _outpb_d(EP_IRQENB_ADDR, EP_DATA_XMTD_INT);
      }
      else /* OUT endpoint, you receive data on it */
      {
         _outpb_d(EP_IRQENB_ADDR, EP_DATA_RCVD_INT | EP_DATA_OUT_TOKEN_INT);
         
         /* initially clear  NAK_OUT_PACKETS */
         _outpb_d(EP_RSPCLR_ADDR, (_inpb_d(EP_RSPCLR_ADDR) | EP_NAK_OUT_PACKETS_MODE));
      }
      DUMP_REGISTER();
      
      /* get the next logical endpoint */
      pLogEp = pLogEp->pNextActiveEpObj;
   }
   /* If the number of logical endpoint objects if larger than physical ones, then it's an error */
   /* enable interrupt */
   _outpb_ind(IRQENB0, (_inpb_ind(IRQENB0) | (EP_A_INTERRUPT | EP_B_INTERRUPT | EP_C_INTERRUPT | EP_0_INTERRUPT)));
   DUMP_REGISTER();
   return 1;
}