Stephen Boyd | 6d67d25 | 2011-09-27 11:50:05 -0700 | [diff] [blame] | 1 | /* Copyright (c) 2010-2012, Code Aurora Forum. All rights reserved. |
Bryan Huntsman | 3f2bc4d | 2011-08-16 17:27:22 -0700 | [diff] [blame] | 2 | * |
| 3 | * This program is free software; you can redistribute it and/or modify |
| 4 | * it under the terms of the GNU General Public License version 2 and |
| 5 | * only version 2 as published by the Free Software Foundation. |
| 6 | * |
| 7 | * This program is distributed in the hope that it will be useful, |
| 8 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 9 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 10 | * GNU General Public License for more details. |
| 11 | */ |
Stephen Boyd | e4174b2 | 2011-09-20 00:19:43 -0700 | [diff] [blame] | 12 | #ifndef __MSM_PERIPHERAL_LOADER_H |
| 13 | #define __MSM_PERIPHERAL_LOADER_H |
Bryan Huntsman | 3f2bc4d | 2011-08-16 17:27:22 -0700 | [diff] [blame] | 14 | |
Stephen Boyd | 3f4da32 | 2011-08-30 01:03:23 -0700 | [diff] [blame] | 15 | struct device; |
Stephen Boyd | 6d67d25 | 2011-09-27 11:50:05 -0700 | [diff] [blame] | 16 | struct module; |
Bryan Huntsman | 3f2bc4d | 2011-08-16 17:27:22 -0700 | [diff] [blame] | 17 | |
Stephen Boyd | 36974ec | 2012-03-22 01:30:59 -0700 | [diff] [blame] | 18 | /** |
| 19 | * struct pil_desc - PIL descriptor |
| 20 | * @name: string used for pil_get() |
| 21 | * @depends_on: booted before this peripheral |
| 22 | * @dev: parent device |
| 23 | * @ops: callback functions |
| 24 | * @owner: module the descriptor belongs to |
| 25 | * @proxy_timeout: delay in ms until proxy vote is removed |
| 26 | */ |
Stephen Boyd | 3f4da32 | 2011-08-30 01:03:23 -0700 | [diff] [blame] | 27 | struct pil_desc { |
Bryan Huntsman | 3f2bc4d | 2011-08-16 17:27:22 -0700 | [diff] [blame] | 28 | const char *name; |
| 29 | const char *depends_on; |
Stephen Boyd | 3f4da32 | 2011-08-30 01:03:23 -0700 | [diff] [blame] | 30 | struct device *dev; |
| 31 | const struct pil_reset_ops *ops; |
Stephen Boyd | 6d67d25 | 2011-09-27 11:50:05 -0700 | [diff] [blame] | 32 | struct module *owner; |
Stephen Boyd | 36974ec | 2012-03-22 01:30:59 -0700 | [diff] [blame] | 33 | unsigned long proxy_timeout; |
Bryan Huntsman | 3f2bc4d | 2011-08-16 17:27:22 -0700 | [diff] [blame] | 34 | }; |
| 35 | |
Stephen Boyd | 36974ec | 2012-03-22 01:30:59 -0700 | [diff] [blame] | 36 | /** |
| 37 | * struct pil_reset_ops - PIL operations |
| 38 | * @init_image: prepare an image for authentication |
| 39 | * @verify_blob: authenticate a program segment, called once for each loadable |
| 40 | * program segment (optional) |
| 41 | * @proxy_vote: make proxy votes before auth_and_reset (optional) |
| 42 | * @auth_and_reset: boot the processor |
| 43 | * @proxy_unvote: remove any proxy votes (optional) |
| 44 | * @shutdown: shutdown the processor |
| 45 | */ |
Stephen Boyd | 5bd999a | 2011-08-02 18:50:57 -0700 | [diff] [blame] | 46 | struct pil_reset_ops { |
Stephen Boyd | 3f4da32 | 2011-08-30 01:03:23 -0700 | [diff] [blame] | 47 | int (*init_image)(struct pil_desc *pil, const u8 *metadata, |
Stephen Boyd | 5bd999a | 2011-08-02 18:50:57 -0700 | [diff] [blame] | 48 | size_t size); |
Stephen Boyd | 3f4da32 | 2011-08-30 01:03:23 -0700 | [diff] [blame] | 49 | int (*verify_blob)(struct pil_desc *pil, u32 phy_addr, size_t size); |
Stephen Boyd | 36974ec | 2012-03-22 01:30:59 -0700 | [diff] [blame] | 50 | int (*proxy_vote)(struct pil_desc *pil); |
Stephen Boyd | 3f4da32 | 2011-08-30 01:03:23 -0700 | [diff] [blame] | 51 | int (*auth_and_reset)(struct pil_desc *pil); |
Stephen Boyd | 36974ec | 2012-03-22 01:30:59 -0700 | [diff] [blame] | 52 | void (*proxy_unvote)(struct pil_desc *pil); |
Stephen Boyd | 3f4da32 | 2011-08-30 01:03:23 -0700 | [diff] [blame] | 53 | int (*shutdown)(struct pil_desc *pil); |
Stephen Boyd | 5bd999a | 2011-08-02 18:50:57 -0700 | [diff] [blame] | 54 | }; |
| 55 | |
Stephen Boyd | 6d67d25 | 2011-09-27 11:50:05 -0700 | [diff] [blame] | 56 | struct pil_device; |
| 57 | |
Stephen Boyd | 866f9a2 | 2012-07-10 18:56:53 -0700 | [diff] [blame^] | 58 | #ifdef CONFIG_MSM_PIL |
Stephen Boyd | 6d67d25 | 2011-09-27 11:50:05 -0700 | [diff] [blame] | 59 | extern struct pil_device *msm_pil_register(struct pil_desc *desc); |
| 60 | extern void msm_pil_unregister(struct pil_device *pil); |
Stephen Boyd | 866f9a2 | 2012-07-10 18:56:53 -0700 | [diff] [blame^] | 61 | #else |
| 62 | static inline struct pil_device *msm_pil_register(struct pil_desc *desc) |
| 63 | { |
| 64 | return NULL; |
| 65 | } |
| 66 | static inline void msm_pil_unregister(struct pil_device *pil) { } |
| 67 | #endif |
Bryan Huntsman | 3f2bc4d | 2011-08-16 17:27:22 -0700 | [diff] [blame] | 68 | |
| 69 | #endif |