//==========================================================================
//
//      dev/dp83902a.h
//
//      National Semiconductor DP83902a ethernet chip
//
//==========================================================================
// ####ECOSGPLCOPYRIGHTBEGIN####                                            
// -------------------------------------------                              
// This file is part of eCos, the Embedded Configurable Operating System.   
// Copyright (C) 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
//
// eCos is free software; you can redistribute it and/or modify it under    
// the terms of the GNU General Public License as published by the Free     
// Software Foundation; either version 2 or (at your option) any later      
// version.                                                                 
//
// eCos is distributed in the hope that it will be useful, but WITHOUT      
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or    
// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License    
// for more details.                                                        
//
// You should have received a copy of the GNU General Public License        
// along with eCos; if not, write to the Free Software Foundation, Inc.,    
// 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.            
//
// As a special exception, if other files instantiate templates or use      
// macros or inline functions from this file, or you compile this file      
// and link it with other works to produce a work based on this file,       
// this file does not by itself cause the resulting work to be covered by   
// the GNU General Public License. However the source code for this file    
// must still be made available in accordance with section (3) of the GNU   
// General Public License v2.                                               
//
// This exception does not invalidate any other reasons why a work based    
// on this file might be covered by the GNU General Public License.         
// -------------------------------------------                              
// ####ECOSGPLCOPYRIGHTEND####                                              
//==========================================================================
//#####DESCRIPTIONBEGIN####
//
// Author(s):    gthomas
// Contributors: gthomas, jskov
// Date:         2001-06-13
// Purpose:      
// Description:  
//
//####DESCRIPTIONEND####
//
//==========================================================================

#include <cyg/hal/hal_io.h>
#include <pkgconf/devs_eth_ns_dp83902a.h>

#define __WANT_CONFIG
#include CYGDAT_DEVS_ETH_NS_DP83902A_INL
#undef __WANT_CONFIG

// ------------------------------------------------------------------------
// Debugging details

// Set to perms of:
// 0 disables all debug output
// 1 for process debug output
// 2 for added data IO output: get_reg, put_reg
// 4 for packet allocation/free output
// 8 for only startup status, so we can tell we're installed OK
#define DEBUG 0x0

#if DEBUG & 1
#define DEBUG_FUNCTION() do { diag_printf("%s\n", __FUNCTION__); } while (0)
#define DEBUG_LINE() do { diag_printf("%d\n", __LINE__); } while (0)
#else
#define DEBUG_FUNCTION() do {} while(0)
#define DEBUG_LINE() do {} while(0)
#endif

// ------------------------------------------------------------------------
// MAcros for keeping track of statistics
#if defined(ETH_DRV_GET_IF_STATS) || defined (ETH_DRV_GET_IF_STATS_UD)
#define KEEP_STATISTICS
#endif

#ifdef KEEP_STATISTICS
#define INCR_STAT( _x_ )        (dp->stats. _x_ ++)
#else
#define INCR_STAT( _x_ )        CYG_EMPTY_STATEMENT
#endif

// ------------------------------------------------------------------------
// Private driver structure
typedef struct dp83902a_priv_data {
    cyg_uint8* base;
    cyg_uint8* data;
    cyg_uint8* reset;
    int tx_next;           // First free Tx page
    int tx_int;            // Expecting interrupt from this buffer
    int rx_next;           // First free Rx page
    int tx1, tx2;          // Page numbers for Tx buffers
    unsigned long tx1_key, tx2_key;   // Used to ack when packet sent
    int tx1_len, tx2_len;
    bool tx_started, running, hardwired_esa;
    struct cyg_netdevtab_entry *tab;
    cyg_uint8 esa[6];
    cyg_vector_t interrupt;             // Interrupt vector used by controller
    cyg_handle_t  interrupt_handle;
    cyg_interrupt interrupt_object;
    void* plf_priv;

    // For debugging
    volatile int cr_lock;
    volatile int cr_owner;

    // Buffer allocation
    int tx_buf1, tx_buf2;
    int rx_buf_start, rx_buf_end;
} dp83902a_priv_data_t;

// ------------------------------------------------------------------------
// Macros for accessing structure elements

#define _SU8( _base_, _offset_) \
        *((volatile cyg_uint8 *)((CYG_ADDRWORD)_base_+(_offset_)))
#define _SU16( _base_, _offset_) \
        *((volatile cyg_uint16 *)((CYG_ADDRWORD)_base_+(_offset_)))
#define _SU32( _base_, _offset_) \
        *((volatile cyg_uint32 *)((CYG_ADDRWORD)_base_+(_offset_)))

#define _SI8( _base_, _offset_) \
        *((volatile cyg_int8 *)((CYG_ADDRWORD)_base_+(_offset_)))
#define _SI16( _base_, _offset_) \
        *((volatile cyg_int16 *)((CYG_ADDRWORD)_base_+(_offset_)))
#define _SI32( _base_, _offset_) \
        *((volatile cyg_int32 *)((CYG_ADDRWORD)_base_+(_offset_)))

// ------------------------------------------------------------------------
// Macros for accessing DP registers
// These can be overridden by the platform header

#ifndef DP_IN
# define DP_IN(_b_, _o_, _d_)  HAL_READ_UINT8 ((cyg_addrword_t)(_b_)+(_o_), (_d_))
# define DP_OUT(_b_, _o_, _d_) HAL_WRITE_UINT8((cyg_addrword_t)(_b_)+(_o_), (_d_))
#endif

#ifndef DP_IN_DATA
# ifdef CYGHWR_NS_DP83902A_PLF_16BIT_DATA
#  ifdef BIGEND
#   define DP_IN_DATA(_b_, _d_)                                 \
    CYG_MACRO_START                                             \
    cyg_uint16 _t;                                              \
    HAL_READ_UINT16 ((cyg_addrword_t)(_b_), _t);                \
    DELAY();                                                    \
    (_d_) = ((_t >> 8) & 0xff) | ((_t & 0xff) << 8);            \
    CYG_MACRO_END

#   define DP_OUT_DATA(_b_, _d_)                                \
    CYG_MACRO_START                                             \
    cyg_uint16 _t;                                              \
    _t = (_d_);                                                 \
    (_t) = (((_t) >> 8) & 0xff) | ((_t & 0xff) << 8);           \
    HAL_WRITE_UINT16((cyg_addrword_t)(_b_), _t);                \
    DELAY();                                                    \
    CYG_MACRO_END
#  else
#   define DP_IN_DATA(_b_, _d_)  HAL_READ_UINT16  ((cyg_addrword_t)(_b_), (_d_))
#   define DP_OUT_DATA(_b_, _d_) HAL_WRITE_UINT16 ((cyg_addrword_t)(_b_), (_d_))
#  endif
# else
#  define DP_IN_DATA(_b_, _d_)  HAL_READ_UINT8  ((cyg_addrword_t)(_b_), (_d_))
#  define DP_OUT_DATA(_b_, _d_) HAL_WRITE_UINT8 ((cyg_addrword_t)(_b_), (_d_))
# endif
#endif

// ------------------------------------------------------------------------
// Macros allowing platform to customize some of the driver details

#ifndef CYGHWR_NS_DP83902A_PLF_RESET
# define CYGHWR_NS_DP83902A_PLF_RESET(_b_) do { } while (0)
#endif

#ifndef CYGHWR_NS_DP83902A_PLF_INT_CLEAR
# define CYGHWR_NS_DP83902A_PLF_INT_CLEAR(_dp_)
#endif

#ifndef CYGHWR_NS_DP83902A_PLF_INIT
#define CYGHWR_NS_DP83902A_PLF_INIT(dp) do { } while (0)
#endif

// ------------------------------------------------------------------------
// Hack that should go away, probably
#define CR_UP()                                                  \
    CYG_MACRO_START                                              \
        if (++dp->cr_lock > 1) {                                 \
          diag_printf("*** Race on CR %s:%d owner %d\n",      \
                      __FUNCTION__, __LINE__, dp->cr_owner);     \
          for (;;);                                              \
        }                                                        \
        dp->cr_owner = __LINE__;                                 \
    CYG_MACRO_END

#define CR_DOWN()                               \
    dp->cr_lock--;

// ------------------------------------------------------------------------
// Some forward declarations
static void dp83902a_poll(struct eth_drv_sc *sc);

// ------------------------------------------------------------------------
// Register offsets

#define DP_CR          0x00
#define DP_CLDA0       0x01
#define DP_PSTART      0x01             // write
#define DP_CLDA1       0x02
#define DP_PSTOP       0x02             // write
#define DP_BNDRY       0x03
#define DP_TSR         0x04
#define DP_TPSR        0x04             // write
#define DP_NCR         0x05
#define DP_TBCL        0x05             // write
#define DP_FIFO        0x06
#define DP_TBCH        0x06             // write
#define DP_ISR         0x07
#define DP_CRDA0       0x08
#define DP_RSAL        0x08             // write
#define DP_CRDA1       0x09
#define DP_RSAH        0x09             // write
#define DP_RBCL        0x0a             // write
#define DP_RBCH        0x0b             // write
#define DP_RSR         0x0c
#define DP_RCR         0x0c             // write
#define DP_FER         0x0d
#define DP_TCR         0x0d             // write
#define DP_CER         0x0e
#define DP_DCR         0x0e             // write
#define DP_MISSED      0x0f
#define DP_IMR         0x0f             // write
#define DP_DATAPORT    0x10             // "eprom" data port

#define DP_P1_CR       0x00
#define DP_P1_PAR0     0x01
#define DP_P1_PAR1     0x02
#define DP_P1_PAR2     0x03
#define DP_P1_PAR3     0x04
#define DP_P1_PAR4     0x05
#define DP_P1_PAR5     0x06
#define DP_P1_CURP     0x07
#define DP_P1_MAR0     0x08
#define DP_P1_MAR1     0x09
#define DP_P1_MAR2     0x0a
#define DP_P1_MAR3     0x0b
#define DP_P1_MAR4     0x0c
#define DP_P1_MAR5     0x0d
#define DP_P1_MAR6     0x0e
#define DP_P1_MAR7     0x0f

#define DP_P2_CR       0x00
#define DP_P2_PSTART   0x01
#define DP_P2_CLDA0    0x01             // write
#define DP_P2_PSTOP    0x02
#define DP_P2_CLDA1    0x02             // write
#define DP_P2_RNPP     0x03
#define DP_P2_TPSR     0x04
#define DP_P2_LNPP     0x05
#define DP_P2_ACH      0x06
#define DP_P2_ACL      0x07
#define DP_P2_RCR      0x0c
#define DP_P2_TCR      0x0d
#define DP_P2_DCR      0x0e
#define DP_P2_IMR      0x0f

// Command register - common to all pages

#define DP_CR_STOP    0x01   // Stop: software reset
#define DP_CR_START   0x02   // Start: initialize device
#define DP_CR_TXPKT   0x04   // Transmit packet
#define DP_CR_RDMA    0x08   // Read DMA  (recv data from device)
#define DP_CR_WDMA    0x10   // Write DMA (send data to device)
#define DP_CR_SEND    0x18   // Send packet
#define DP_CR_NODMA   0x20   // Remote (or no) DMA
#define DP_CR_PAGE0   0x00   // Page select
#define DP_CR_PAGE1   0x40
#define DP_CR_PAGE2   0x80
#define DP_CR_PAGEMSK 0x3F   // Used to mask out page bits

// Data configuration register

#define DP_DCR_WTS    0x01   // 1=16 bit word transfers
#define DP_DCR_BOS    0x02   // 1=Little Endian
#define DP_DCR_LAS    0x04   // 1=Single 32 bit DMA mode
#define DP_DCR_LS     0x08   // 1=normal mode, 0=loopback
#define DP_DCR_ARM    0x10   // 0=no send command (program I/O)
#define DP_DCR_FIFO_1 0x00   // FIFO threshold
#define DP_DCR_FIFO_2 0x20
#define DP_DCR_FIFO_4 0x40
#define DP_DCR_FIFO_6 0x60

#ifdef CYGHWR_NS_DP83902A_PLF_16BIT_DATA
# ifdef BIGENDIAN
#  define DP_DCR_INIT   (DP_DCR_BOS|DP_DCR_WTS|DP_DCR_LS|DP_DCR_FIFO_4)
# else
#  define DP_DCR_INIT   (DP_DCR_WTS|DP_DCR_LS|DP_DCR_FIFO_4)
# endif
#else
# define DP_DCR_INIT   (DP_DCR_LS|DP_DCR_FIFO_4)
#endif

// Interrupt status register

#define DP_ISR_RxP    0x01   // Packet received
#define DP_ISR_TxP    0x02   // Packet transmitted
#define DP_ISR_RxE    0x04   // Receive error
#define DP_ISR_TxE    0x08   // Transmit error
#define DP_ISR_OFLW   0x10   // Receive overflow
#define DP_ISR_CNT    0x20   // Tally counters need emptying
#define DP_ISR_RDC    0x40   // Remote DMA complete
#define DP_ISR_RESET  0x80   // Device has reset (shutdown, error)

// Interrupt mask register

#define DP_IMR_RxP    0x01   // Packet received
#define DP_IMR_TxP    0x02   // Packet transmitted
#define DP_IMR_RxE    0x04   // Receive error
#define DP_IMR_TxE    0x08   // Transmit error
#define DP_IMR_OFLW   0x10   // Receive overflow
#define DP_IMR_CNT    0x20   // Tall counters need emptying
#define DP_IMR_RDC    0x40   // Remote DMA complete

#define DP_IMR_All    0x3F   // Everything but remote DMA

// Receiver control register

#define DP_RCR_SEP    0x01   // Save bad(error) packets
#define DP_RCR_AR     0x02   // Accept runt packets
#define DP_RCR_AB     0x04   // Accept broadcast packets
#define DP_RCR_AM     0x08   // Accept multicast packets
#define DP_RCR_PROM   0x10   // Promiscuous mode
#define DP_RCR_MON    0x20   // Monitor mode - 1=accept no packets

// Receiver status register

#define DP_RSR_RxP    0x01   // Packet received
#define DP_RSR_CRC    0x02   // CRC error
#define DP_RSR_FRAME  0x04   // Framing error
#define DP_RSR_FO     0x08   // FIFO overrun
#define DP_RSR_MISS   0x10   // Missed packet
#define DP_RSR_PHY    0x20   // 0=pad match, 1=mad match
#define DP_RSR_DIS    0x40   // Receiver disabled
#define DP_RSR_DFR    0x80   // Receiver processing deferred

// Transmitter control register

#define DP_TCR_NOCRC  0x01   // 1=inhibit CRC
#define DP_TCR_NORMAL 0x00   // Normal transmitter operation
#define DP_TCR_LOCAL  0x02   // Internal NIC loopback
#define DP_TCR_INLOOP 0x04   // Full internal loopback
#define DP_TCR_OUTLOOP 0x08  // External loopback
#define DP_TCR_ATD    0x10   // Auto transmit disable
#define DP_TCR_OFFSET 0x20   // Collision offset adjust

// Transmit status register

#define DP_TSR_TxP    0x01   // Packet transmitted
#define DP_TSR_COL    0x04   // Collision (at least one)
#define DP_TSR_ABT    0x08   // Aborted because of too many collisions
#define DP_TSR_CRS    0x10   // Lost carrier
#define DP_TSR_FU     0x20   // FIFO underrun
#define DP_TSR_CDH    0x40   // Collision Detect Heartbeat
#define DP_TSR_OWC    0x80   // Collision outside normal window

#define IEEE_8023_MAX_FRAME         1518    // Largest possible ethernet frame
#define IEEE_8023_MIN_FRAME           64    // Smallest possible ethernet frame

