drivers/staging/media/atomisp/pci/atomisp_acc.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * Support for Clovertrail PNW Camera Imaging ISP subsystem.
   4  *
   5  * Copyright (c) 2012 Intel Corporation. All Rights Reserved.
   6  *
   7  * This program is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License version
   9  * 2 as published by the Free Software Foundation.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  *
  17  */
  18
  19 #ifndef __ATOMISP_ACC_H__
  20 #define __ATOMISP_ACC_H__
  21
  22 #include "../../include/linux/atomisp.h"
  23 #include "atomisp_internal.h"
  24
  25 #include "ia_css_types.h"
  26
  27 /*
  28  * Interface functions for AtomISP driver acceleration API implementation.
  29  */
  30
  31 struct atomisp_sub_device;
  32
  33 void atomisp_acc_cleanup(struct atomisp_device *isp);
  34
  35 /*
  36  * Free up any allocated resources.
  37  * Must be called each time when the device is closed.
  38  * Note that there isn't corresponding open() call;
  39  * this function may be called sequentially multiple times.
  40  * Must be called to free up resources before driver is unloaded.
  41  */
  42 void atomisp_acc_release(struct atomisp_sub_device *asd);
  43
  44 /* Load acceleration binary. DEPRECATED. */
  45 int atomisp_acc_load(struct atomisp_sub_device *asd,
  46                      struct atomisp_acc_fw_load *fw);
  47
  48 /* Load acceleration binary with specified properties */
  49 int atomisp_acc_load_to_pipe(struct atomisp_sub_device *asd,
  50                              struct atomisp_acc_fw_load_to_pipe *fw);
  51
  52 /* Unload specified acceleration binary */
  53 int atomisp_acc_unload(struct atomisp_sub_device *asd,
  54                        unsigned int *handle);
  55
  56 /*
  57  * Map a memory region into ISP memory space.
  58  */
  59 int atomisp_acc_map(struct atomisp_sub_device *asd,
  60                     struct atomisp_acc_map *map);
  61
  62 /*
  63  * Unmap a mapped memory region.
  64  */
  65 int atomisp_acc_unmap(struct atomisp_sub_device *asd,
  66                       struct atomisp_acc_map *map);
  67
  68 /*
  69  * Set acceleration binary argument to a previously mapped memory region.
  70  */
  71 int atomisp_acc_s_mapped_arg(struct atomisp_sub_device *asd,
  72                              struct atomisp_acc_s_mapped_arg *arg);
  73
  74 /*
  75  * Start acceleration.
  76  * Return immediately, acceleration is left running in background.
  77  * Specify either acceleration binary or pipeline which to start.
  78  */
  79 int atomisp_acc_start(struct atomisp_sub_device *asd,
  80                       unsigned int *handle);
  81
  82 /*
  83  * Wait until acceleration finishes.
  84  * This MUST be called after each acceleration has been started.
  85  * Specify either acceleration binary or pipeline handle.
  86  */
  87 int atomisp_acc_wait(struct atomisp_sub_device *asd,
  88                      unsigned int *handle);
  89
  90 /*
  91  * Used by ISR to notify ACC stage finished.
  92  * This is internally used and does not export as IOCTL.
  93  */
  94 void atomisp_acc_done(struct atomisp_sub_device *asd, unsigned int handle);
  95
  96 /*
  97  * Appends the loaded acceleration binary extensions to the
  98  * current ISP mode. Must be called just before atomisp_css_start().
  99  */
 100 int atomisp_acc_load_extensions(struct atomisp_sub_device *asd);
 101
 102 /*
 103  * Must be called after streaming is stopped:
 104  * unloads any loaded acceleration extensions.
 105  */
 106 void atomisp_acc_unload_extensions(struct atomisp_sub_device *asd);
 107
 108 /*
 109  * Set acceleration firmware flags.
 110  */
 111 int atomisp_acc_set_state(struct atomisp_sub_device *asd,
 112                           struct atomisp_acc_state *arg);
 113
 114 /*
 115  * Get acceleration firmware flags.
 116  */
 117 int atomisp_acc_get_state(struct atomisp_sub_device *asd,
 118                           struct atomisp_acc_state *arg);
 119
 120 #endif /* __ATOMISP_ACC_H__ */