sys/dev/drm/include/linux/firmware.h

   1 /*
   2  * Copyright (c) 2015 Michael Neumann
   3  * Copyright (c) 2016 François Tigeot
   4  * All rights reserved.
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted provided that the following conditions
   8  * are met:
   9  * 1. Redistributions of source code must retain the above copyright
  10  *    notice unmodified, this list of conditions, and the following
  11  *    disclaimer.
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions and the following disclaimer in the
  14  *    documentation and/or other materials provided with the distribution.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  17  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  18  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  19  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  21  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  22  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  23  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  26  */
  27
  28 #ifndef _LINUX_FIRMWARE_H_
  29 #define _LINUX_FIRMWARE_H_
  30
  31 #include <sys/bus.h>
  32 #include <sys/firmware.h>
  33 #include <linux/types.h>
  34 #include <linux/compiler.h>
  35 #include <linux/gfp.h>
  36 #include <linux/device.h>
  37
  38 static inline int
  39 request_firmware(const struct firmware **fw, const char *name, __unused struct device *dev) {
  40         *fw = firmware_get(name);
  41         if (*fw) {
  42                 return 0;
  43         }
  44         return -ENOENT;
  45 }
  46
  47 static inline int
  48 request_firmware_nowait(struct module *module, bool uevent,
  49     const char *name, struct device *device, gfp_t gfp, void *context,
  50     void (*cont)(const struct firmware *fw, void *context))
  51 {
  52         const struct firmware *fw;
  53
  54         fw = firmware_get(name);
  55         if (fw == NULL) {
  56                 return -ENOENT;
  57         }
  58
  59         cont(fw, context);
  60
  61         return 0;
  62 }
  63
  64 static inline void
  65 release_firmware(const struct firmware *fw) {
  66         if (fw != NULL) {
  67                 firmware_put(fw, FIRMWARE_UNLOAD);
  68         }
  69 }
  70
  71 #endif  /* _LINUX_FIRMWARE_H_ */