Quelle  cvmx-address.h   Sprache: C

/***********************license start***************
 * Author: Cavium Networks
 *
 * Contact: support@caviumnetworks.com
 * This file is part of the OCTEON SDK
 *
 * Copyright (c) 2003-2009 Cavium Networks
 *
 * This file is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License, Version 2, as
 * published by the Free Software Foundation.
 *
 * This file is distributed in the hope that it will be useful, but
 * AS-IS and WITHOUT ANY WARRANTY; without even the implied warranty
 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, TITLE, or
 * NONINFRINGEMENT.  See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this file; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 * or visit http://www.gnu.org/licenses/.
 *
 * This file may also be available under a different license from Cavium.
 * Contact Cavium Networks for more information
 ***********************license end**************************************/

/**
 * Typedefs and defines for working with Octeon physical addresses.
 *
 */
#ifndef __CVMX_ADDRESS_H__
#define __CVMX_ADDRESS_H__

#if 0
typedef enum {
 CVMX_MIPS_SPACE_XKSEG = 3LL,
 CVMX_MIPS_SPACE_XKPHYS = 2LL,
 CVMX_MIPS_SPACE_XSSEG = 1LL,
 CVMX_MIPS_SPACE_XUSEG = 0LL
} cvmx_mips_space_t;
#endif

typedef enum {
 CVMX_MIPS_XKSEG_SPACE_KSEG0 = 0LL,
 CVMX_MIPS_XKSEG_SPACE_KSEG1 = 1LL,
 CVMX_MIPS_XKSEG_SPACE_SSEG = 2LL,
 CVMX_MIPS_XKSEG_SPACE_KSEG3 = 3LL
} cvmx_mips_xkseg_space_t;

/* decodes <14:13> of a kseg3 window address */
typedef enum {
 CVMX_ADD_WIN_SCR = 0L,
 /* see cvmx_add_win_dma_dec_t for further decode */
 CVMX_ADD_WIN_DMA = 1L,
 CVMX_ADD_WIN_UNUSED = 2L,
 CVMX_ADD_WIN_UNUSED2 = 3L
} cvmx_add_win_dec_t;

/* decode within DMA space */
typedef enum {
 /*
 * Add store data to the write buffer entry, allocating it if
 * necessary.
 */
 CVMX_ADD_WIN_DMA_ADD = 0L,
 /* send out the write buffer entry to DRAM */
 CVMX_ADD_WIN_DMA_SENDMEM = 1L,
 /* store data must be normal DRAM memory space address in this case */
 /* send out the write buffer entry as an IOBDMA command */
 CVMX_ADD_WIN_DMA_SENDDMA = 2L,
 /* see CVMX_ADD_WIN_DMA_SEND_DEC for data contents */
 /* send out the write buffer entry as an IO write */
 CVMX_ADD_WIN_DMA_SENDIO = 3L,
 /* store data must be normal IO space address in this case */
 /* send out a single-tick command on the NCB bus */
 CVMX_ADD_WIN_DMA_SENDSINGLE = 4L,
 /* no write buffer data needed/used */
} cvmx_add_win_dma_dec_t;

/*
 *   Physical Address Decode
 *
 * Octeon-I HW never interprets this X (<39:36> reserved
 * for future expansion), software should set to 0.
 *
 *  - 0x0 XXX0 0000 0000 to  DRAM       Cached
 *  - 0x0 XXX0 0FFF FFFF
 *
 *  - 0x0 XXX0 1000 0000 to  Boot Bus     Uncached (Converted to 0x1 00X0 1000 0000
 *  - 0x0 XXX0 1FFF FFFF  + EJTAG    to 0x1 00X0 1FFF FFFF)
 *
 *  - 0x0 XXX0 2000 0000 to  DRAM       Cached
 *  - 0x0 XXXF FFFF FFFF
 *
 *  - 0x1 00X0 0000 0000 to  Boot Bus     Uncached
 *  - 0x1 00XF FFFF FFFF
 *
 *  - 0x1 01X0 0000 0000 to  Other NCB    Uncached
 *  - 0x1 FFXF FFFF FFFF  devices
 *
 * Decode of all Octeon addresses
 */
typedef union {

 uint64_t u64;
#ifdef __BIG_ENDIAN_BITFIELD
 /* mapped or unmapped virtual address */
 struct {
  uint64_t R:2;
  uint64_t offset:62;
 } sva;

 /* mapped USEG virtual addresses (typically) */
 struct {
  uint64_t zeroes:33;
  uint64_t offset:31;
 } suseg;

 /* mapped or unmapped virtual address */
 struct {
  uint64_t ones:33;
  uint64_t sp:2;
  uint64_t offset:29;
 } sxkseg;

 /*
 * physical address accessed through xkphys unmapped virtual
 * address.
 */
 struct {
  uint64_t R:2; /* CVMX_MIPS_SPACE_XKPHYS in this case */
  uint64_t cca:3; /* ignored by octeon */
  uint64_t mbz:10;
  uint64_t pa:49; /* physical address */
 } sxkphys;

 /* physical address */
 struct {
  uint64_t mbz:15;
  /* if set, the address is uncached and resides on MCB bus */
  uint64_t is_io:1;
  /*
 * the hardware ignores this field when is_io==0, else
 * device ID.
 */
  uint64_t did:8;
  /* the hardware ignores <39:36> in Octeon I */
  uint64_t unaddr:4;
  uint64_t offset:36;
 } sphys;

 /* physical mem address */
 struct {
  /* technically, <47:40> are dont-cares */
  uint64_t zeroes:24;
  /* the hardware ignores <39:36> in Octeon I */
  uint64_t unaddr:4;
  uint64_t offset:36;
 } smem;

 /* physical IO address */
 struct {
  uint64_t mem_region:2;
  uint64_t mbz:13;
  /* 1 in this case */
  uint64_t is_io:1;
  /*
 * The hardware ignores this field when is_io==0, else
 * device ID.
 */
  uint64_t did:8;
  /* the hardware ignores <39:36> in Octeon I */
  uint64_t unaddr:4;
  uint64_t offset:36;
 } sio;

 /*
 * Scratchpad virtual address - accessed through a window at
 * the end of kseg3
 */
 struct {
  uint64_t ones:49;
  /* CVMX_ADD_WIN_SCR (0) in this case */
  cvmx_add_win_dec_t csrdec:2;
  uint64_t addr:13;
 } sscr;

 /* there should only be stores to IOBDMA space, no loads */
 /*
 * IOBDMA virtual address - accessed through a window at the
 * end of kseg3
 */
 struct {
  uint64_t ones:49;
  uint64_t csrdec:2; /* CVMX_ADD_WIN_DMA (1) in this case */
  uint64_t unused2:3;
  uint64_t type:3;
  uint64_t addr:7;
 } sdma;

 struct {
  uint64_t didspace:24;
  uint64_t unused:40;
 } sfilldidspace;
#else
 struct {
  uint64_t offset:62;
  uint64_t R:2;
 } sva;

 struct {
  uint64_t offset:31;
  uint64_t zeroes:33;
 } suseg;

 struct {
  uint64_t offset:29;
  uint64_t sp:2;
  uint64_t ones:33;
 } sxkseg;

 struct {
  uint64_t pa:49;
  uint64_t mbz:10;
  uint64_t cca:3;
  uint64_t R:2;
 } sxkphys;

 struct {
  uint64_t offset:36;
  uint64_t unaddr:4;
  uint64_t did:8;
  uint64_t is_io:1;
  uint64_t mbz:15;
 } sphys;

 struct {
  uint64_t offset:36;
  uint64_t unaddr:4;
  uint64_t zeroes:24;
 } smem;

 struct {
  uint64_t offset:36;
  uint64_t unaddr:4;
  uint64_t did:8;
  uint64_t is_io:1;
  uint64_t mbz:13;
  uint64_t mem_region:2;
 } sio;

 struct {
  uint64_t addr:13;
  cvmx_add_win_dec_t csrdec:2;
  uint64_t ones:49;
 } sscr;

 struct {
  uint64_t addr:7;
  uint64_t type:3;
  uint64_t unused2:3;
  uint64_t csrdec:2;
  uint64_t ones:49;
 } sdma;

 struct {
  uint64_t unused:40;
  uint64_t didspace:24;
 } sfilldidspace;
#endif

} cvmx_addr_t;

/* These macros for used by 32 bit applications */

#define CVMX_MIPS32_SPACE_KSEG0 1l
#define CVMX_ADD_SEG32(segment, add) \
 (((int32_t)segment << 31) | (int32_t)(add))

/*
 * Currently all IOs are performed using XKPHYS addressing. Linux uses
 * the CvmMemCtl register to enable XKPHYS addressing to IO space from
 * user mode.  Future OSes may need to change the upper bits of IO
 * addresses. The following define controls the upper two bits for all
 * IO addresses generated by the simple executive library.
 */
#define CVMX_IO_SEG CVMX_MIPS_SPACE_XKPHYS

/* These macros simplify the process of creating common IO addresses */
#define CVMX_ADD_SEG(segment, add) ((((uint64_t)segment) << 62) | (add))
#ifndef CVMX_ADD_IO_SEG
#define CVMX_ADD_IO_SEG(add) CVMX_ADD_SEG(CVMX_IO_SEG, (add))
#endif
#define CVMX_ADDR_DIDSPACE(did) (((CVMX_IO_SEG) << 22) | ((1ULL) << 8) | (did))
#define CVMX_ADDR_DID(did) (CVMX_ADDR_DIDSPACE(did) << 40)
#define CVMX_FULL_DID(did, subdid) (((did) << 3) | (subdid))

  /* from include/ncb_rsl_id.v */
#define CVMX_OCT_DID_MIS 0ULL /* misc stuff */
#define CVMX_OCT_DID_GMX0 1ULL
#define CVMX_OCT_DID_GMX1 2ULL
#define CVMX_OCT_DID_PCI 3ULL
#define CVMX_OCT_DID_KEY 4ULL
#define CVMX_OCT_DID_FPA 5ULL
#define CVMX_OCT_DID_DFA 6ULL
#define CVMX_OCT_DID_ZIP 7ULL
#define CVMX_OCT_DID_RNG 8ULL
#define CVMX_OCT_DID_IPD 9ULL
#define CVMX_OCT_DID_PKT 10ULL
#define CVMX_OCT_DID_TIM 11ULL
#define CVMX_OCT_DID_TAG 12ULL
  /* the rest are not on the IO bus */
#define CVMX_OCT_DID_L2C 16ULL
#define CVMX_OCT_DID_LMC 17ULL
#define CVMX_OCT_DID_SPX0 18ULL
#define CVMX_OCT_DID_SPX1 19ULL
#define CVMX_OCT_DID_PIP 20ULL
#define CVMX_OCT_DID_ASX0 22ULL
#define CVMX_OCT_DID_ASX1 23ULL
#define CVMX_OCT_DID_IOB 30ULL

#define CVMX_OCT_DID_PKT_SEND     CVMX_FULL_DID(CVMX_OCT_DID_PKT, 2ULL)
#define CVMX_OCT_DID_TAG_SWTAG     CVMX_FULL_DID(CVMX_OCT_DID_TAG, 0ULL)
#define CVMX_OCT_DID_TAG_TAG1     CVMX_FULL_DID(CVMX_OCT_DID_TAG, 1ULL)
#define CVMX_OCT_DID_TAG_TAG2     CVMX_FULL_DID(CVMX_OCT_DID_TAG, 2ULL)
#define CVMX_OCT_DID_TAG_TAG3     CVMX_FULL_DID(CVMX_OCT_DID_TAG, 3ULL)
#define CVMX_OCT_DID_TAG_NULL_RD    CVMX_FULL_DID(CVMX_OCT_DID_TAG, 4ULL)
#define CVMX_OCT_DID_TAG_CSR     CVMX_FULL_DID(CVMX_OCT_DID_TAG, 7ULL)
#define CVMX_OCT_DID_FAU_FAI     CVMX_FULL_DID(CVMX_OCT_DID_IOB, 0ULL)
#define CVMX_OCT_DID_TIM_CSR     CVMX_FULL_DID(CVMX_OCT_DID_TIM, 0ULL)
#define CVMX_OCT_DID_KEY_RW     CVMX_FULL_DID(CVMX_OCT_DID_KEY, 0ULL)
#define CVMX_OCT_DID_PCI_6     CVMX_FULL_DID(CVMX_OCT_DID_PCI, 6ULL)
#define CVMX_OCT_DID_MIS_BOO     CVMX_FULL_DID(CVMX_OCT_DID_MIS, 0ULL)
#define CVMX_OCT_DID_PCI_RML     CVMX_FULL_DID(CVMX_OCT_DID_PCI, 0ULL)
#define CVMX_OCT_DID_IPD_CSR     CVMX_FULL_DID(CVMX_OCT_DID_IPD, 7ULL)
#define CVMX_OCT_DID_DFA_CSR     CVMX_FULL_DID(CVMX_OCT_DID_DFA, 7ULL)
#define CVMX_OCT_DID_MIS_CSR     CVMX_FULL_DID(CVMX_OCT_DID_MIS, 7ULL)
#define CVMX_OCT_DID_ZIP_CSR     CVMX_FULL_DID(CVMX_OCT_DID_ZIP, 0ULL)

#endif /* __CVMX_ADDRESS_H__ */