drivers/bus/dpaa/include/fsl_usd.h

   1 /*-
   2  * This file is provided under a dual BSD/GPLv2 license. When using or
   3  * redistributing this file, you may do so under either license.
   4  *
   5  *   BSD LICENSE
   6  *
   7  * Copyright 2010-2011 Freescale Semiconductor, Inc.
   8  * All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions are met:
  12  * * Redistributions of source code must retain the above copyright
  13  * notice, this list of conditions and the following disclaimer.
  14  * * Redistributions in binary form must reproduce the above copyright
  15  * notice, this list of conditions and the following disclaimer in the
  16  * documentation and/or other materials provided with the distribution.
  17  * * Neither the name of the above-listed copyright holders nor the
  18  * names of any contributors may be used to endorse or promote products
  19  * derived from this software without specific prior written permission.
  20  *
  21  *   GPL LICENSE SUMMARY
  22  *
  23  * ALTERNATIVELY, this software may be distributed under the terms of the
  24  * GNU General Public License ("GPL") as published by the Free Software
  25  * Foundation, either version 2 of that License or (at your option) any
  26  * later version.
  27  *
  28  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  29  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  30  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  31  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
  32  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  33  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  34  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  35  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  36  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  37  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  38  * POSSIBILITY OF SUCH DAMAGE.
  39  */
  40
  41 #ifndef __FSL_USD_H
  42 #define __FSL_USD_H
  43
  44 #include <compat.h>
  45 #include <fsl_qman.h>
  46
  47 #ifdef __cplusplus
  48 extern "C" {
  49 #endif
  50
  51 /* Thread-entry/exit hooks; */
  52 int qman_thread_init(void);
  53 int bman_thread_init(void);
  54 int qman_thread_finish(void);
  55 int bman_thread_finish(void);
  56
  57 #define QBMAN_ANY_PORTAL_IDX 0xffffffff
  58
  59 /* Obtain and free raw (unitialized) portals */
  60
  61 struct dpaa_raw_portal {
  62         /* inputs */
  63
  64         /* set to non zero to turn on stashing */
  65         uint8_t enable_stash;
  66         /* Stashing attributes for the portal */
  67         uint32_t cpu;
  68         uint32_t cache;
  69         uint32_t window;
  70
  71         /* Specifies the stash request queue this portal should use */
  72         uint8_t sdest;
  73
  74         /* Specifes a specific portal index to map or QBMAN_ANY_PORTAL_IDX
  75          * for don't care.  The portal index will be populated by the
  76          * driver when the ioctl() successfully completes.
  77          */
  78         uint32_t index;
  79
  80         /* outputs */
  81         uint64_t cinh;
  82         uint64_t cena;
  83 };
  84
  85 int qman_allocate_raw_portal(struct dpaa_raw_portal *portal);
  86 int qman_free_raw_portal(struct dpaa_raw_portal *portal);
  87
  88 int bman_allocate_raw_portal(struct dpaa_raw_portal *portal);
  89 int bman_free_raw_portal(struct dpaa_raw_portal *portal);
  90
  91 /* Post-process interrupts. NB, the kernel IRQ handler disables the interrupt
  92  * line before notifying us, and this post-processing re-enables it once
  93  * processing is complete. As such, it is essential to call this before going
  94  * into another blocking read/select/poll.
  95  */
  96 void qman_thread_irq(void);
  97 void bman_thread_irq(void);
  98
  99 /* Global setup */
 100 int qman_global_init(void);
 101 int bman_global_init(void);
 102
 103 #ifdef __cplusplus
 104 }
 105 #endif
 106
 107 #endif /* __FSL_USD_H */