1/* 2 * omap_device headers 3 * 4 * Copyright (C) 2009 Nokia Corporation 5 * Paul Walmsley 6 * 7 * Developed in collaboration with (alphabetical order): Benoit 8 * Cousson, Kevin Hilman, Tony Lindgren, Rajendra Nayak, Vikram 9 * Pandita, Sakari Poussa, Anand Sawant, Santosh Shilimkar, Richard 10 * Woodruff 11 * 12 * This program is free software; you can redistribute it and/or modify 13 * it under the terms of the GNU General Public License version 2 as 14 * published by the Free Software Foundation. 15 * 16 * Eventually this type of functionality should either be 17 * a) implemented via arch-specific pointers in platform_device 18 * or 19 * b) implemented as a proper omap_bus/omap_device in Linux, no more 20 * platform_device 21 * 22 * omap_device differs from omap_hwmod in that it includes external 23 * (e.g., board- and system-level) integration details. omap_hwmod 24 * stores hardware data that is invariant for a given OMAP chip. 25 * 26 * To do: 27 * - GPIO integration 28 * - regulator integration 29 * 30 */ 31#ifndef __ARCH_ARM_PLAT_OMAP_INCLUDE_MACH_OMAP_DEVICE_H 32#define __ARCH_ARM_PLAT_OMAP_INCLUDE_MACH_OMAP_DEVICE_H 33 34#include <linux/kernel.h> 35#include <linux/platform_device.h> 36 37#include <plat/omap_hwmod.h> 38 39/* omap_device._state values */ 40#define OMAP_DEVICE_STATE_UNKNOWN 0 41#define OMAP_DEVICE_STATE_ENABLED 1 42#define OMAP_DEVICE_STATE_IDLE 2 43#define OMAP_DEVICE_STATE_SHUTDOWN 3 44 45/** 46 * struct omap_device - omap_device wrapper for platform_devices 47 * @pdev: platform_device 48 * @hwmods: (one .. many per omap_device) 49 * @hwmods_cnt: ARRAY_SIZE() of @hwmods 50 * @pm_lats: ptr to an omap_device_pm_latency table 51 * @pm_lats_cnt: ARRAY_SIZE() of what is passed to @pm_lats 52 * @pm_lat_level: array index of the last odpl entry executed - -1 if never 53 * @dev_wakeup_lat: dev wakeup latency in nanoseconds 54 * @_dev_wakeup_lat_limit: dev wakeup latency limit in nsec - set by OMAP PM 55 * @_state: one of OMAP_DEVICE_STATE_* (see above) 56 * @flags: device flags 57 * 58 * Integrates omap_hwmod data into Linux platform_device. 59 * 60 * Field names beginning with underscores are for the internal use of 61 * the omap_device code. 62 * 63 */ 64struct omap_device { 65 u32 magic; 66 struct platform_device pdev; 67 struct omap_hwmod **hwmods; 68 struct omap_device_pm_latency *pm_lats; 69 u32 dev_wakeup_lat; 70 u32 _dev_wakeup_lat_limit; 71 u8 pm_lats_cnt; 72 s8 pm_lat_level; 73 u8 hwmods_cnt; 74 u8 _state; 75}; 76 77/* Device driver interface (call via platform_data fn ptrs) */ 78 79int omap_device_enable(struct platform_device *pdev); 80int omap_device_idle(struct platform_device *pdev); 81int omap_device_shutdown(struct platform_device *pdev); 82 83/* Core code interface */ 84 85bool omap_device_is_valid(struct omap_device *od); 86int omap_device_count_resources(struct omap_device *od); 87int omap_device_fill_resources(struct omap_device *od, struct resource *res); 88 89struct omap_device *omap_device_build(const char *pdev_name, int pdev_id, 90 struct omap_hwmod *oh, void *pdata, 91 int pdata_len, 92 struct omap_device_pm_latency *pm_lats, 93 int pm_lats_cnt, int is_early_device); 94 95struct omap_device *omap_device_build_ss(const char *pdev_name, int pdev_id, 96 struct omap_hwmod **oh, int oh_cnt, 97 void *pdata, int pdata_len, 98 struct omap_device_pm_latency *pm_lats, 99 int pm_lats_cnt, int is_early_device); 100 101int omap_device_register(struct omap_device *od); 102int omap_early_device_register(struct omap_device *od); 103 104void __iomem *omap_device_get_rt_va(struct omap_device *od); 105 106/* OMAP PM interface */ 107int omap_device_align_pm_lat(struct platform_device *pdev, 108 u32 new_wakeup_lat_limit); 109struct powerdomain *omap_device_get_pwrdm(struct omap_device *od); 110 111/* Other */ 112 113int omap_device_idle_hwmods(struct omap_device *od); 114int omap_device_enable_hwmods(struct omap_device *od); 115 116int omap_device_disable_clocks(struct omap_device *od); 117int omap_device_enable_clocks(struct omap_device *od); 118 119 120struct omap_device_pm_latency { 121 u32 deactivate_lat; 122 u32 deactivate_lat_worst; 123 int (*deactivate_func)(struct omap_device *od); 124 u32 activate_lat; 125 u32 activate_lat_worst; 126 int (*activate_func)(struct omap_device *od); 127 u32 flags; 128}; 129 130#define OMAP_DEVICE_LATENCY_AUTO_ADJUST BIT(1) 131 132/* Get omap_device pointer from platform_device pointer */ 133#define to_omap_device(x) container_of((x), struct omap_device, pdev) 134 135#endif 136