arch/arm/include/asm/firmware.h

   1 /*
   2  * Copyright (C) 2012 Samsung Electronics.
   3  * Kyungmin Park <kyungmin.park@samsung.com>
   4  * Tomasz Figa <t.figa@samsung.com>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License version 2 as
   8  * published by the Free Software Foundation.
   9  */
  10
  11 #ifndef __ASM_ARM_FIRMWARE_H
  12 #define __ASM_ARM_FIRMWARE_H
  13
  14 #include <linux/bug.h>
  15
  16 /*
  17  * struct firmware_ops
  18  *
  19  * A structure to specify available firmware operations.
  20  *
  21  * A filled up structure can be registered with register_firmware_ops().
  22  */
  23 struct firmware_ops {
  24         /*
  25          * Enters CPU idle mode
  26          */
  27         int (*do_idle)(void);
  28         /*
  29          * Sets boot address of specified physical CPU
  30          */
  31         int (*set_cpu_boot_addr)(int cpu, unsigned long boot_addr);
  32         /*
  33          * Boots specified physical CPU
  34          */
  35         int (*cpu_boot)(int cpu);
  36         /*
  37          * Initializes L2 cache
  38          */
  39         int (*l2x0_init)(void);
  40 };
  41
  42 /* Global pointer for current firmware_ops structure, can't be NULL. */
  43 extern const struct firmware_ops *firmware_ops;
  44
  45 /*
  46  * call_firmware_op(op, ...)
  47  *
  48  * Checks if firmware operation is present and calls it,
  49  * otherwise returns -ENOSYS
  50  */
  51 #define call_firmware_op(op, ...)                                       \
  52         ((firmware_ops->op) ? firmware_ops->op(__VA_ARGS__) : (-ENOSYS))
  53
  54 /*
  55  * register_firmware_ops(ops)
  56  *
  57  * A function to register platform firmware_ops struct.
  58  */
  59 static inline void register_firmware_ops(const struct firmware_ops *ops)
  60 {
  61         BUG_ON(!ops);
  62
  63         firmware_ops = ops;
  64 }
  65
  66 #endif