OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	05/09/2024 07:14:16 AM	rwxr-xr-x
📄 cvmx-address.h	9.15 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-agl-defs.h	70.87 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-asm.h	5.08 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-asxx-defs.h	17.73 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-boot-vector.h	1.57 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-bootinfo.h	13.44 KB	06/16/2023 05:32:39 PM	rw-r--r--
📄 cvmx-bootmem.h	14.02 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-ciu-defs.h	214.08 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-ciu2-defs.h	173.44 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-ciu3-defs.h	10.71 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-cmd-queue.h	18.46 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-config.h	6.31 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-coremask.h	2.13 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-dbg-defs.h	2.73 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-dpi-defs.h	27 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-fau.h	18.21 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-fpa-defs.h	37.39 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-fpa.h	8.14 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-gmxx-defs.h	226.41 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-gpio-defs.h	13.3 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-board.h	4.91 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-errata.h	1.25 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-jtag.h	1.49 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-loop.h	1.93 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-npi.h	1.91 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-rgmii.h	3.45 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-sgmii.h	3.3 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-spi.h	2.71 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-util.h	5.92 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper-xaui.h	3.29 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-helper.h	7 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-iob-defs.h	35.77 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-ipd-defs.h	56.09 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-ipd.h	10.45 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-l2c-defs.h	7.94 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-l2c.h	11.13 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-l2d-defs.h	1.9 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-l2t-defs.h	5.18 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-led-defs.h	7.7 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-lmcx-defs.h	88.35 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-mio-defs.h	141.79 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-mixx-defs.h	14.58 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-npei-defs.h	94.93 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-npi-defs.h	67.92 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-packet.h	2.07 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pci-defs.h	56.08 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pciercx-defs.h	11.23 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pcsx-defs.h	33.81 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pcsxx-defs.h	25.23 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pemx-defs.h	20.62 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pescx-defs.h	15.88 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pexp-defs.h	16.64 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pip-defs.h	87.19 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pip.h	16.01 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pko-defs.h	73.09 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pko.h	19.17 KB	06/16/2023 05:32:39 PM	rw-r--r--
📄 cvmx-pow-defs.h	33.51 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-pow.h	63.82 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-rnm-defs.h	6.03 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-rst-defs.h	7.27 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-scratch.h	3.78 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-sli-defs.h	3.95 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-smix-defs.h	11.01 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-spi.h	8.93 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-spinlock.h	6.24 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-spxx-defs.h	12.86 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-sriox-defs.h	42.13 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-srxx-defs.h	4.49 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-stxx-defs.h	10.42 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-sysinfo.h	3.95 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-uctlx-defs.h	12.78 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx-wqe.h	17.06 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 cvmx.h	13.85 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 octeon-feature.h	6.38 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 octeon-model.h	16.49 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 octeon.h	12.26 KB	01/28/2018 09:20:33 PM	rw-r--r--
📄 pci-octeon.h	1.65 KB	01/28/2018 09:20:33 PM	rw-r--r--

Editing: cvmx-fpa.h

/***********************license start***************
 * Author: Cavium Networks
 *
 * Contact: support@caviumnetworks.com
 * This file is part of the OCTEON SDK
 *
 * Copyright (c) 2003-2008 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**************************************/

/**
 * @file
 *
 * Interface to the hardware Free Pool Allocator.
 *
 *
 */

#ifndef __CVMX_FPA_H__
#define __CVMX_FPA_H__

#include <linux/delay.h>

#include <asm/octeon/cvmx-address.h>
#include <asm/octeon/cvmx-fpa-defs.h>

#define CVMX_FPA_NUM_POOLS	8
#define CVMX_FPA_MIN_BLOCK_SIZE 128
#define CVMX_FPA_ALIGNMENT	128

/**
 * Structure describing the data format used for stores to the FPA.
 */
typedef union {
	uint64_t u64;
	struct {
#ifdef __BIG_ENDIAN_BITFIELD
		/*
		 * the (64-bit word) location in scratchpad to write
		 * to (if len != 0)
		 */
		uint64_t scraddr:8;
		/* the number of words in the response (0 => no response) */
		uint64_t len:8;
		/* the ID of the device on the non-coherent bus */
		uint64_t did:8;
		/*
		 * the address that will appear in the first tick on
		 * the NCB bus.
		 */
		uint64_t addr:40;
#else
		uint64_t addr:40;
		uint64_t did:8;
		uint64_t len:8;
		uint64_t scraddr:8;
#endif
	} s;
} cvmx_fpa_iobdma_data_t;

/**
 * Structure describing the current state of a FPA pool.
 */
typedef struct {
	/* Name it was created under */
	const char *name;
	/* Size of each block */
	uint64_t size;
	/* The base memory address of whole block */
	void *base;
	/* The number of elements in the pool at creation */
	uint64_t starting_element_count;
} cvmx_fpa_pool_info_t;

/**
 * Current state of all the pools. Use access functions
 * instead of using it directly.
 */
extern cvmx_fpa_pool_info_t cvmx_fpa_pool_info[CVMX_FPA_NUM_POOLS];

/* CSR typedefs have been moved to cvmx-csr-*.h */

/**
 * Return the name of the pool
 *
 * @pool:   Pool to get the name of
 * Returns The name
 */
static inline const char *cvmx_fpa_get_name(uint64_t pool)
{
	return cvmx_fpa_pool_info[pool].name;
}

/**
 * Return the base of the pool
 *
 * @pool:   Pool to get the base of
 * Returns The base
 */
static inline void *cvmx_fpa_get_base(uint64_t pool)
{
	return cvmx_fpa_pool_info[pool].base;
}

/**
 * Check if a pointer belongs to an FPA pool. Return non-zero
 * if the supplied pointer is inside the memory controlled by
 * an FPA pool.
 *
 * @pool:   Pool to check
 * @ptr:    Pointer to check
 * Returns Non-zero if pointer is in the pool. Zero if not
 */
static inline int cvmx_fpa_is_member(uint64_t pool, void *ptr)
{
	return ((ptr >= cvmx_fpa_pool_info[pool].base) &&
		((char *)ptr <
		 ((char *)(cvmx_fpa_pool_info[pool].base)) +
		 cvmx_fpa_pool_info[pool].size *
		 cvmx_fpa_pool_info[pool].starting_element_count));
}

/**
 * Enable the FPA for use. Must be performed after any CSR
 * configuration but before any other FPA functions.
 */
static inline void cvmx_fpa_enable(void)
{
	union cvmx_fpa_ctl_status status;

status.u64 = cvmx_read_csr(CVMX_FPA_CTL_STATUS);
	if (status.s.enb) {
		cvmx_dprintf
		    ("Warning: Enabling FPA when FPA already enabled.\n");
	}

/*
	 * Do runtime check as we allow pass1 compiled code to run on
	 * pass2 chips.
	 */
	if (cvmx_octeon_is_pass1()) {
		union cvmx_fpa_fpfx_marks marks;
		int i;
		for (i = 1; i < 8; i++) {
			marks.u64 =
			    cvmx_read_csr(CVMX_FPA_FPF1_MARKS + (i - 1) * 8ull);
			marks.s.fpf_wr = 0xe0;
			cvmx_write_csr(CVMX_FPA_FPF1_MARKS + (i - 1) * 8ull,
				       marks.u64);
		}

/* Enforce a 10 cycle delay between config and enable */
		__delay(10);
	}

/* FIXME: CVMX_FPA_CTL_STATUS read is unmodelled */
	status.u64 = 0;
	status.s.enb = 1;
	cvmx_write_csr(CVMX_FPA_CTL_STATUS, status.u64);
}

/**
 * Get a new block from the FPA
 *
 * @pool:   Pool to get the block from
 * Returns Pointer to the block or NULL on failure
 */
static inline void *cvmx_fpa_alloc(uint64_t pool)
{
	uint64_t address =
	    cvmx_read_csr(CVMX_ADDR_DID(CVMX_FULL_DID(CVMX_OCT_DID_FPA, pool)));
	if (address)
		return cvmx_phys_to_ptr(address);
	else
		return NULL;
}

/**
 * Asynchronously get a new block from the FPA
 *
 * @scr_addr: Local scratch address to put response in.	 This is a byte address,
 *		    but must be 8 byte aligned.
 * @pool:      Pool to get the block from
 */
static inline void cvmx_fpa_async_alloc(uint64_t scr_addr, uint64_t pool)
{
	cvmx_fpa_iobdma_data_t data;

/*
	 * Hardware only uses 64 bit aligned locations, so convert
	 * from byte address to 64-bit index
	 */
	data.s.scraddr = scr_addr >> 3;
	data.s.len = 1;
	data.s.did = CVMX_FULL_DID(CVMX_OCT_DID_FPA, pool);
	data.s.addr = 0;
	cvmx_send_single(data.u64);
}

/**
 * Free a block allocated with a FPA pool.  Does NOT provide memory
 * ordering in cases where the memory block was modified by the core.
 *
 * @ptr:    Block to free
 * @pool:   Pool to put it in
 * @num_cache_lines:
 *		 Cache lines to invalidate
 */
static inline void cvmx_fpa_free_nosync(void *ptr, uint64_t pool,
					uint64_t num_cache_lines)
{
	cvmx_addr_t newptr;
	newptr.u64 = cvmx_ptr_to_phys(ptr);
	newptr.sfilldidspace.didspace =
	    CVMX_ADDR_DIDSPACE(CVMX_FULL_DID(CVMX_OCT_DID_FPA, pool));
	/* Prevent GCC from reordering around free */
	barrier();
	/* value written is number of cache lines not written back */
	cvmx_write_io(newptr.u64, num_cache_lines);
}

/**
 * Free a block allocated with a FPA pool.  Provides required memory
 * ordering in cases where memory block was modified by core.
 *
 * @ptr:    Block to free
 * @pool:   Pool to put it in
 * @num_cache_lines:
 *		 Cache lines to invalidate
 */
static inline void cvmx_fpa_free(void *ptr, uint64_t pool,
				 uint64_t num_cache_lines)
{
	cvmx_addr_t newptr;
	newptr.u64 = cvmx_ptr_to_phys(ptr);
	newptr.sfilldidspace.didspace =
	    CVMX_ADDR_DIDSPACE(CVMX_FULL_DID(CVMX_OCT_DID_FPA, pool));
	/*
	 * Make sure that any previous writes to memory go out before
	 * we free this buffer.	 This also serves as a barrier to
	 * prevent GCC from reordering operations to after the
	 * free.
	 */
	CVMX_SYNCWS;
	/* value written is number of cache lines not written back */
	cvmx_write_io(newptr.u64, num_cache_lines);
}

/**
 * Setup a FPA pool to control a new block of memory.
 * This can only be called once per pool. Make sure proper
 * locking enforces this.
 *
 * @pool:	Pool to initialize
 *		     0 <= pool < 8
 * @name:	Constant character string to name this pool.
 *		     String is not copied.
 * @buffer:	Pointer to the block of memory to use. This must be
 *		     accessible by all processors and external hardware.
 * @block_size: Size for each block controlled by the FPA
 * @num_blocks: Number of blocks
 *
 * Returns 0 on Success,
 *	   -1 on failure
 */
extern int cvmx_fpa_setup_pool(uint64_t pool, const char *name, void *buffer,
			       uint64_t block_size, uint64_t num_blocks);

/**
 * Shutdown a Memory pool and validate that it had all of
 * the buffers originally placed in it. This should only be
 * called by one processor after all hardware has finished
 * using the pool.
 *
 * @pool:   Pool to shutdown
 * Returns Zero on success
 *	   - Positive is count of missing buffers
 *	   - Negative is too many buffers or corrupted pointers
 */
extern uint64_t cvmx_fpa_shutdown_pool(uint64_t pool);

/**
 * Get the size of blocks controlled by the pool
 * This is resolved to a constant at compile time.
 *
 * @pool:   Pool to access
 * Returns Size of the block in bytes
 */
uint64_t cvmx_fpa_get_block_size(uint64_t pool);

#endif /*  __CVM_FPA_H__ */