xref: /openbmc/linux/drivers/misc/mei/hw-me.h (revision 293d5b43)
1 /*
2  *
3  * Intel Management Engine Interface (Intel MEI) Linux driver
4  * Copyright (c) 2003-2012, Intel Corporation.
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms and conditions of the GNU General Public License,
8  * version 2, as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope it will be useful, but WITHOUT
11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
13  * more details.
14  *
15  */
16 
17 
18 
19 #ifndef _MEI_INTERFACE_H_
20 #define _MEI_INTERFACE_H_
21 
22 #include <linux/irqreturn.h>
23 #include <linux/pci.h>
24 #include <linux/mei.h>
25 
26 #include "mei_dev.h"
27 #include "client.h"
28 
29 /*
30  * mei_cfg - mei device configuration
31  *
32  * @fw_status: FW status
33  * @quirk_probe: device exclusion quirk
34  */
35 struct mei_cfg {
36 	const struct mei_fw_status fw_status;
37 	bool (*quirk_probe)(struct pci_dev *pdev);
38 };
39 
40 
41 #define MEI_PCI_DEVICE(dev, cfg) \
42 	.vendor = PCI_VENDOR_ID_INTEL, .device = (dev), \
43 	.subvendor = PCI_ANY_ID, .subdevice = PCI_ANY_ID, \
44 	.driver_data = (kernel_ulong_t)&(cfg)
45 
46 
47 #define MEI_ME_RPM_TIMEOUT    500 /* ms */
48 
49 /**
50  * struct mei_me_hw - me hw specific data
51  *
52  * @cfg: per device generation config and ops
53  * @mem_addr: io memory address
54  * @intr_source: interrupt source
55  * @pg_state: power gating state
56  * @d0i3_supported: di03 support
57  */
58 struct mei_me_hw {
59 	const struct mei_cfg *cfg;
60 	void __iomem *mem_addr;
61 	u32 intr_source;
62 	enum mei_pg_state pg_state;
63 	bool d0i3_supported;
64 };
65 
66 #define to_me_hw(dev) (struct mei_me_hw *)((dev)->hw)
67 
68 extern const struct mei_cfg mei_me_legacy_cfg;
69 extern const struct mei_cfg mei_me_ich_cfg;
70 extern const struct mei_cfg mei_me_pch_cfg;
71 extern const struct mei_cfg mei_me_pch_cpt_pbg_cfg;
72 extern const struct mei_cfg mei_me_pch8_cfg;
73 extern const struct mei_cfg mei_me_pch8_sps_cfg;
74 
75 struct mei_device *mei_me_dev_init(struct pci_dev *pdev,
76 				   const struct mei_cfg *cfg);
77 
78 int mei_me_pg_enter_sync(struct mei_device *dev);
79 int mei_me_pg_exit_sync(struct mei_device *dev);
80 
81 irqreturn_t mei_me_irq_quick_handler(int irq, void *dev_id);
82 irqreturn_t mei_me_irq_thread_handler(int irq, void *dev_id);
83 
84 #endif /* _MEI_INTERFACE_H_ */
85