Thomas Gleixner | d2912cb | 2019-06-04 10:11:33 +0200 | [diff] [blame^] | 1 | /* SPDX-License-Identifier: GPL-2.0-only */ |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 2 | /* |
| 3 | * omap_device headers |
| 4 | * |
| 5 | * Copyright (C) 2009 Nokia Corporation |
| 6 | * Paul Walmsley |
| 7 | * |
| 8 | * Developed in collaboration with (alphabetical order): Benoit |
| 9 | * Cousson, Kevin Hilman, Tony Lindgren, Rajendra Nayak, Vikram |
| 10 | * Pandita, Sakari Poussa, Anand Sawant, Santosh Shilimkar, Richard |
| 11 | * Woodruff |
| 12 | * |
Paul Walmsley | c1d1cd5 | 2013-01-26 00:48:53 -0700 | [diff] [blame] | 13 | * This type of functionality should be implemented as a proper |
| 14 | * omap_bus/omap_device in Linux. |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 15 | * |
| 16 | * omap_device differs from omap_hwmod in that it includes external |
| 17 | * (e.g., board- and system-level) integration details. omap_hwmod |
| 18 | * stores hardware data that is invariant for a given OMAP chip. |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 19 | */ |
| 20 | #ifndef __ARCH_ARM_PLAT_OMAP_INCLUDE_MACH_OMAP_DEVICE_H |
| 21 | #define __ARCH_ARM_PLAT_OMAP_INCLUDE_MACH_OMAP_DEVICE_H |
| 22 | |
| 23 | #include <linux/kernel.h> |
| 24 | #include <linux/platform_device.h> |
| 25 | |
Tony Lindgren | 2a296c8 | 2012-10-02 17:41:35 -0700 | [diff] [blame] | 26 | #include "omap_hwmod.h" |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 27 | |
Kevin Hilman | 3ec2dec | 2012-02-15 11:47:45 -0800 | [diff] [blame] | 28 | extern struct dev_pm_domain omap_device_pm_domain; |
Nishanth Menon | f5c33b0 | 2013-12-03 19:39:13 -0600 | [diff] [blame] | 29 | extern struct dev_pm_domain omap_device_fail_pm_domain; |
Kevin Hilman | 0d5e825 | 2010-08-23 08:10:55 -0700 | [diff] [blame] | 30 | |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 31 | /* omap_device._state values */ |
| 32 | #define OMAP_DEVICE_STATE_UNKNOWN 0 |
| 33 | #define OMAP_DEVICE_STATE_ENABLED 1 |
| 34 | #define OMAP_DEVICE_STATE_IDLE 2 |
| 35 | #define OMAP_DEVICE_STATE_SHUTDOWN 3 |
| 36 | |
Kevin Hilman | c03f007 | 2011-07-12 22:48:19 +0200 | [diff] [blame] | 37 | /* omap_device.flags values */ |
Paul Walmsley | c1d1cd5 | 2013-01-26 00:48:53 -0700 | [diff] [blame] | 38 | #define OMAP_DEVICE_SUSPENDED BIT(0) |
Kevin Hilman | c03f007 | 2011-07-12 22:48:19 +0200 | [diff] [blame] | 39 | |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 40 | /** |
| 41 | * struct omap_device - omap_device wrapper for platform_devices |
| 42 | * @pdev: platform_device |
| 43 | * @hwmods: (one .. many per omap_device) |
| 44 | * @hwmods_cnt: ARRAY_SIZE() of @hwmods |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 45 | * @_state: one of OMAP_DEVICE_STATE_* (see above) |
| 46 | * @flags: device flags |
Kevin Hilman | e753345 | 2012-07-10 11:13:16 -0700 | [diff] [blame] | 47 | * @_driver_status: one of BUS_NOTIFY_*_DRIVER from <linux/device.h> |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 48 | * |
| 49 | * Integrates omap_hwmod data into Linux platform_device. |
| 50 | * |
| 51 | * Field names beginning with underscores are for the internal use of |
| 52 | * the omap_device code. |
| 53 | * |
| 54 | */ |
| 55 | struct omap_device { |
Kevin Hilman | d66b3fe | 2011-07-21 13:58:51 -0700 | [diff] [blame] | 56 | struct platform_device *pdev; |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 57 | struct omap_hwmod **hwmods; |
Kevin Hilman | e753345 | 2012-07-10 11:13:16 -0700 | [diff] [blame] | 58 | unsigned long _driver_status; |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 59 | u8 hwmods_cnt; |
| 60 | u8 _state; |
Kevin Hilman | c03f007 | 2011-07-12 22:48:19 +0200 | [diff] [blame] | 61 | u8 flags; |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 62 | }; |
| 63 | |
| 64 | /* Device driver interface (call via platform_data fn ptrs) */ |
| 65 | |
| 66 | int omap_device_enable(struct platform_device *pdev); |
| 67 | int omap_device_idle(struct platform_device *pdev); |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 68 | |
| 69 | /* Core code interface */ |
| 70 | |
Kevin Hilman | 3528c58 | 2011-07-21 13:48:45 -0700 | [diff] [blame] | 71 | struct platform_device *omap_device_build(const char *pdev_name, int pdev_id, |
Paul Walmsley | c1d1cd5 | 2013-01-26 00:48:53 -0700 | [diff] [blame] | 72 | struct omap_hwmod *oh, void *pdata, |
| 73 | int pdata_len); |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 74 | |
Ohad Ben-Cohen | 993e4fb | 2012-02-20 09:43:29 -0800 | [diff] [blame] | 75 | struct omap_device *omap_device_alloc(struct platform_device *pdev, |
Paul Walmsley | c1d1cd5 | 2013-01-26 00:48:53 -0700 | [diff] [blame] | 76 | struct omap_hwmod **ohs, int oh_cnt); |
Ohad Ben-Cohen | 993e4fb | 2012-02-20 09:43:29 -0800 | [diff] [blame] | 77 | void omap_device_delete(struct omap_device *od); |
| 78 | int omap_device_register(struct platform_device *pdev); |
| 79 | |
Nishanth Menon | 1f8a7d5 | 2011-07-27 15:02:32 -0500 | [diff] [blame] | 80 | struct device *omap_device_get_by_hwmod_name(const char *oh_name); |
Paul Walmsley | db2a60b | 2010-07-26 16:34:33 -0600 | [diff] [blame] | 81 | |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 82 | /* OMAP PM interface */ |
Tomi Valkeinen | fc01387 | 2011-06-09 16:56:23 +0300 | [diff] [blame] | 83 | int omap_device_get_context_loss_count(struct platform_device *pdev); |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 84 | |
| 85 | /* Other */ |
| 86 | |
Omar Ramirez Luna | 8bb9fde | 2012-09-23 17:28:18 -0600 | [diff] [blame] | 87 | int omap_device_assert_hardreset(struct platform_device *pdev, |
| 88 | const char *name); |
| 89 | int omap_device_deassert_hardreset(struct platform_device *pdev, |
| 90 | const char *name); |
Paul Walmsley | b04b65a | 2009-09-03 20:14:05 +0300 | [diff] [blame] | 91 | |
Kevin Hilman | a470c42 | 2009-12-08 16:34:17 -0700 | [diff] [blame] | 92 | /* Get omap_device pointer from platform_device pointer */ |
Kevin Hilman | d66b3fe | 2011-07-21 13:58:51 -0700 | [diff] [blame] | 93 | static inline struct omap_device *to_omap_device(struct platform_device *pdev) |
| 94 | { |
| 95 | return pdev ? pdev->archdata.od : NULL; |
| 96 | } |
Kevin Hilman | a470c42 | 2009-12-08 16:34:17 -0700 | [diff] [blame] | 97 | #endif |