2 * Part of Intel(R) Manageability Engine Interface Linux driver
4 * Copyright (c) 2003 - 2008 Intel Corp.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions, and the following disclaimer,
12 * without modification.
13 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
14 * substantially similar to the "NO WARRANTY" disclaimer below
15 * ("Disclaimer") and any redistribution must be conditioned upon
16 * including a substantially similar Disclaimer requirement for further
17 * binary redistribution.
18 * 3. Neither the names of the above-listed copyright holders nor the names
19 * of any contributors may be used to endorse or promote products derived
20 * from this software without specific prior written permission.
22 * Alternatively, this software may be distributed under the terms of the
23 * GNU General Public License ("GPL") version 2 as published by the Free
24 * Software Foundation.
27 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
28 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
29 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
30 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
31 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
32 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
33 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
34 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
35 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
36 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
37 * POSSIBILITY OF SUCH DAMAGES.
42 #include <linux/module.h>
43 #include <linux/moduleparam.h>
44 #include <linux/kernel.h>
45 #include <linux/slab.h>
47 #include <linux/errno.h>
48 #include <linux/types.h>
49 #include <linux/fcntl.h>
50 #include <linux/aio.h>
51 #include <linux/pci.h>
52 #include <linux/reboot.h>
53 #include <linux/poll.h>
54 #include <linux/init.h>
55 #include <linux/kdev_t.h>
56 #include <linux/ioctl.h>
57 #include <linux/cdev.h>
58 #include <linux/device.h>
59 #include <linux/unistd.h>
60 #include <linux/kthread.h>
63 #include "heci_interface.h"
64 #include "heci_version.h"
67 #define HECI_READ_TIMEOUT 45
69 #define HECI_DRIVER_NAME "heci"
74 static char heci_driver_name[] = HECI_DRIVER_NAME;
75 static char heci_driver_string[] = "Intel(R) Management Engine Interface";
76 static char heci_driver_version[] = HECI_DRIVER_VERSION;
77 static char heci_copyright[] = "Copyright (c) 2003 - 2008 Intel Corporation.";
85 MODULE_PARM_DESC(heci_debug, "Debug enabled or not");
86 module_param(heci_debug, int, 0644);
89 #define HECI_DEV_NAME "heci"
91 /* heci char device for registration */
92 static struct cdev heci_cdev;
94 /* major number for device */
95 static int heci_major;
96 /* The device pointer */
97 static struct pci_dev *heci_device;
99 static struct class *heci_class;
102 /* heci_pci_tbl - PCI Device ID Table */
103 static struct pci_device_id heci_pci_tbl[] = {
104 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_82946GZ)},
105 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_82G35)},
106 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_82Q965)},
107 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_82G965)},
108 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_82GM965)},
109 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_82GME965)},
110 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_82Q35)},
111 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_82G33)},
112 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_82Q33)},
113 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_82X38)},
114 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_3200)},
115 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_6)},
116 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_7)},
117 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_8)},
118 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_9)},
119 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9_10)},
120 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9M_1)},
121 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9M_2)},
122 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9M_3)},
123 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH9M_4)},
124 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH10_1)},
125 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH10_2)},
126 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH10_3)},
127 {PCI_DEVICE(PCI_VENDOR_ID_INTEL, HECI_DEV_ID_ICH10_4)},
128 /* required last entry */
132 MODULE_DEVICE_TABLE(pci, heci_pci_tbl);
135 * Local Function Prototypes
137 static int __init heci_init_module(void);
138 static void __exit heci_exit_module(void);
139 static int __devinit heci_probe(struct pci_dev *pdev,
140 const struct pci_device_id *ent);
141 static void __devexit heci_remove(struct pci_dev *pdev);
142 static int heci_open(struct inode *inode, struct file *file);
143 static int heci_release(struct inode *inode, struct file *file);
144 static ssize_t heci_read(struct file *file, char __user *ubuf,
145 size_t length, loff_t *offset);
146 static int heci_ioctl(struct inode *inode, struct file *file,
147 unsigned int cmd, unsigned long data);
148 static ssize_t heci_write(struct file *file, const char __user *ubuf,
149 size_t length, loff_t *offset);
150 static unsigned int heci_poll(struct file *file, poll_table *wait);
151 static struct heci_cb_private *find_read_list_entry(
152 struct iamt_heci_device *dev,
153 struct heci_file_private *file_ext);
155 static int heci_suspend(struct pci_dev *pdev, pm_message_t state);
156 static int heci_resume(struct pci_dev *pdev);
157 static __u16 g_sus_wd_timeout;
159 #define heci_suspend NULL
160 #define heci_resume NULL
163 * PCI driver structure
165 static struct pci_driver heci_driver = {
166 .name = heci_driver_name,
167 .id_table = heci_pci_tbl,
169 .remove = __devexit_p(heci_remove),
170 .shutdown = __devexit_p(heci_remove),
171 .suspend = heci_suspend,
172 .resume = heci_resume
176 * file operations structure will be use heci char device.
178 static const struct file_operations heci_fops = {
179 .owner = THIS_MODULE,
183 .release = heci_release,
189 * heci_registration_cdev - set up the cdev structure for heci device.
191 * @dev: char device struct
192 * @hminor: minor number for registration char device
193 * @fops: file operations structure
195 * returns 0 on success, <0 on failure.
197 static int heci_registration_cdev(struct cdev *dev, int hminor,
198 const struct file_operations *fops)
200 int ret, devno = MKDEV(heci_major, hminor);
202 cdev_init(dev, fops);
203 dev->owner = THIS_MODULE;
204 ret = cdev_add(dev, devno, 1);
205 /* Fail gracefully if need be */
207 printk(KERN_ERR "heci: Error %d registering heci device %d\n",
213 /* Display the version of heci driver. */
214 static ssize_t version_show(struct class *dev, char *buf)
216 return sprintf(buf, "%s %s.\n",
217 heci_driver_string, heci_driver_version);
220 static CLASS_ATTR(version, S_IRUGO, version_show, NULL);
223 * heci_register_cdev - registers heci char device
225 * returns 0 on success, <0 on failure.
227 static int heci_register_cdev(void)
232 /* registration of char devices */
233 ret = alloc_chrdev_region(&dev, HECI_MINORS_BASE, HECI_MINORS_COUNT,
236 printk(KERN_ERR "heci: Error allocating char device region.\n");
240 heci_major = MAJOR(dev);
242 ret = heci_registration_cdev(&heci_cdev, HECI_MINOR_NUMBER,
245 unregister_chrdev_region(MKDEV(heci_major, HECI_MINORS_BASE),
252 * heci_unregister_cdev - unregisters heci char device
254 static void heci_unregister_cdev(void)
256 cdev_del(&heci_cdev);
257 unregister_chrdev_region(MKDEV(heci_major, HECI_MINORS_BASE),
261 #ifndef HECI_DEVICE_CREATE
262 #define HECI_DEVICE_CREATE device_create
265 * heci_sysfs_device_create - adds device entry to sysfs
267 * returns 0 on success, <0 on failure.
269 static int heci_sysfs_device_create(void)
275 class = class_create(THIS_MODULE, HECI_DRIVER_NAME);
277 err = PTR_ERR(class);
278 printk(KERN_ERR "heci: Error creating heci class.\n");
282 err = class_create_file(class, &class_attr_version);
284 class_destroy(class);
285 printk(KERN_ERR "heci: Error creating heci class file.\n");
289 tmphdev = HECI_DEVICE_CREATE(class, NULL, heci_cdev.dev, NULL,
291 if (IS_ERR(tmphdev)) {
292 err = PTR_ERR(tmphdev);
293 class_remove_file(class, &class_attr_version);
294 class_destroy(class);
304 * heci_sysfs_device_remove - unregisters the device entry on sysfs
306 static void heci_sysfs_device_remove(void)
308 if ((heci_class == NULL) || (IS_ERR(heci_class)))
311 device_destroy(heci_class, heci_cdev.dev);
312 class_remove_file(heci_class, &class_attr_version);
313 class_destroy(heci_class);
317 * heci_init_module - Driver Registration Routine
319 * heci_init_module is the first routine called when the driver is
320 * loaded. All it does is register with the PCI subsystem.
322 * returns 0 on success, <0 on failure.
324 static int __init heci_init_module(void)
328 printk(KERN_INFO "heci: %s - version %s\n", heci_driver_string,
329 heci_driver_version);
330 printk(KERN_INFO "heci: %s\n", heci_copyright);
332 /* init pci module */
333 ret = pci_register_driver(&heci_driver);
335 printk(KERN_ERR "heci: Error registering driver.\n");
339 ret = heci_register_cdev();
343 ret = heci_sysfs_device_create();
345 goto unregister_cdev;
350 heci_unregister_cdev();
352 pci_unregister_driver(&heci_driver);
357 module_init(heci_init_module);
361 * heci_exit_module - Driver Exit Cleanup Routine
363 * heci_exit_module is called just before the driver is removed
366 static void __exit heci_exit_module(void)
368 pci_unregister_driver(&heci_driver);
369 heci_sysfs_device_remove();
370 heci_unregister_cdev();
373 module_exit(heci_exit_module);
377 * heci_probe - Device Initialization Routine
379 * @pdev: PCI device information struct
380 * @ent: entry in kcs_pci_tbl
382 * returns 0 on success, <0 on failure.
384 static int __devinit heci_probe(struct pci_dev *pdev,
385 const struct pci_device_id *ent)
387 struct iamt_heci_device *dev = NULL;
395 err = pci_enable_device(pdev);
397 printk(KERN_ERR "heci: Failed to enable pci device.\n");
400 /* set PCI host mastering */
401 pci_set_master(pdev);
402 /* pci request regions for heci driver */
403 err = pci_request_regions(pdev, heci_driver_name);
405 printk(KERN_ERR "heci: Failed to get pci regions.\n");
408 /* allocates and initializes the heci dev structure */
409 dev = init_heci_device(pdev);
412 goto release_regions;
414 /* mapping IO device memory */
415 for (i = 0; i <= 5; i++) {
416 if (pci_resource_len(pdev, i) == 0)
418 if (pci_resource_flags(pdev, i) & IORESOURCE_IO) {
419 printk(KERN_ERR "heci: heci has IO ports.\n");
421 } else if (pci_resource_flags(pdev, i) & IORESOURCE_MEM) {
424 "heci: Too many mem addresses.\n");
427 dev->mem_base = pci_resource_start(pdev, i);
428 dev->mem_length = pci_resource_len(pdev, i);
431 if (!dev->mem_base) {
432 printk(KERN_ERR "heci: No address to use.\n");
436 dev->mem_addr = ioremap_nocache(dev->mem_base,
438 if (!dev->mem_addr) {
439 printk(KERN_ERR "heci: Remap IO device memory failure.\n");
443 /* request and enable interrupt */
444 err = request_irq(pdev->irq, heci_isr_interrupt, IRQF_SHARED,
445 heci_driver_name, dev);
447 printk(KERN_ERR "heci: Request_irq failure. irq = %d \n",
452 if (heci_hw_init(dev)) {
453 printk(KERN_ERR "heci: Init hw failure.\n");
457 init_timer(&dev->wd_timer);
459 heci_initialize_clients(dev);
460 if (dev->heci_state != HECI_ENABLED) {
465 spin_lock_bh(&dev->device_lock);
467 pci_set_drvdata(pdev, dev);
468 spin_unlock_bh(&dev->device_lock);
471 mod_timer(&dev->wd_timer, jiffies);
474 g_sus_wd_timeout = 0;
476 printk(KERN_INFO "heci driver initialization successful.\n");
480 /* disable interrupts */
481 dev->host_hw_state = read_heci_register(dev, H_CSR);
482 heci_csr_disable_interrupts(dev);
484 del_timer_sync(&dev->wd_timer);
486 flush_scheduled_work();
489 free_irq(pdev->irq, dev);
492 iounmap(dev->mem_addr);
496 pci_release_regions(pdev);
498 pci_disable_device(pdev);
500 printk(KERN_ERR "heci driver initialization failed.\n");
505 * heci_remove - Device Removal Routine
507 * @pdev: PCI device information struct
509 * heci_remove is called by the PCI subsystem to alert the driver
510 * that it should release a PCI device.
512 static void __devexit heci_remove(struct pci_dev *pdev)
514 struct iamt_heci_device *dev = pci_get_drvdata(pdev);
516 if (heci_device != pdev)
522 spin_lock_bh(&dev->device_lock);
523 if (heci_device != pdev) {
524 spin_unlock_bh(&dev->device_lock);
528 if (dev->reinit_tsk != NULL) {
529 kthread_stop(dev->reinit_tsk);
530 dev->reinit_tsk = NULL;
533 del_timer_sync(&dev->wd_timer);
534 if (dev->wd_file_ext.state == HECI_FILE_CONNECTED
535 && dev->wd_timeout) {
537 dev->wd_due_counter = 0;
538 memcpy(dev->wd_data, heci_stop_wd_params, HECI_WD_PARAMS_SIZE);
540 if (dev->host_buffer_is_empty &&
541 flow_ctrl_creds(dev, &dev->wd_file_ext)) {
542 dev->host_buffer_is_empty = 0;
544 if (!heci_send_wd(dev))
545 DBG("send stop WD failed\n");
547 flow_ctrl_reduce(dev, &dev->wd_file_ext);
554 spin_unlock_bh(&dev->device_lock);
556 wait_event_interruptible_timeout(dev->wait_stop_wd,
557 (dev->wd_stoped), 10 * HZ);
558 spin_lock_bh(&dev->device_lock);
560 DBG("stop wd failed to complete.\n");
562 DBG("stop wd complete.\n");
567 spin_unlock_bh(&dev->device_lock);
569 if (dev->iamthif_file_ext.state == HECI_FILE_CONNECTED) {
570 dev->iamthif_file_ext.state = HECI_FILE_DISCONNECTING;
571 heci_disconnect_host_client(dev,
572 &dev->iamthif_file_ext);
574 if (dev->wd_file_ext.state == HECI_FILE_CONNECTED) {
575 dev->wd_file_ext.state = HECI_FILE_DISCONNECTING;
576 heci_disconnect_host_client(dev,
580 spin_lock_bh(&dev->device_lock);
582 /* remove entry if already in list */
583 DBG("list del iamthif and wd file list.\n");
584 heci_remove_client_from_file_list(dev, dev->wd_file_ext.
586 heci_remove_client_from_file_list(dev,
587 dev->iamthif_file_ext.host_client_id);
589 dev->iamthif_current_cb = NULL;
590 dev->iamthif_file_ext.file = NULL;
591 dev->num_heci_me_clients = 0;
593 spin_unlock_bh(&dev->device_lock);
595 flush_scheduled_work();
597 /* disable interrupts */
598 heci_csr_disable_interrupts(dev);
600 free_irq(pdev->irq, dev);
601 pci_set_drvdata(pdev, NULL);
604 iounmap(dev->mem_addr);
608 pci_release_regions(pdev);
609 pci_disable_device(pdev);
613 * heci_clear_list - remove all callbacks associated with file
616 * @file: file information struct
617 * @heci_cb_list: callbacks list
619 * heci_clear_list is called to clear resources associated with file
620 * when application calls close function or Ctrl-C was pressed
622 * returns 1 if callback removed from the list, 0 otherwise
624 static int heci_clear_list(struct iamt_heci_device *dev,
625 struct file *file, struct list_head *heci_cb_list)
627 struct heci_cb_private *priv_cb_pos = NULL;
628 struct heci_cb_private *priv_cb_next = NULL;
629 struct file *file_temp;
632 /* list all list member */
633 list_for_each_entry_safe(priv_cb_pos, priv_cb_next,
634 heci_cb_list, cb_list) {
635 file_temp = (struct file *)priv_cb_pos->file_object;
636 /* check if list member associated with a file */
637 if (file_temp == file) {
638 /* remove member from the list */
639 list_del(&priv_cb_pos->cb_list);
640 /* check if cb equal to current iamthif cb */
641 if (dev->iamthif_current_cb == priv_cb_pos) {
642 dev->iamthif_current_cb = NULL;
643 /* send flow control to iamthif client */
644 heci_send_flow_control(dev,
645 &dev->iamthif_file_ext);
647 /* free all allocated buffers */
648 heci_free_cb_private(priv_cb_pos);
656 * heci_clear_lists - remove all callbacks associated with file
658 * @dev: device information struct
659 * @file: file information struct
661 * heci_clear_lists is called to clear resources associated with file
662 * when application calls close function or Ctrl-C was pressed
664 * returns 1 if callback removed from the list, 0 otherwise
666 static int heci_clear_lists(struct iamt_heci_device *dev, struct file *file)
670 /* remove callbacks associated with a file */
671 heci_clear_list(dev, file, &dev->pthi_cmd_list.heci_cb.cb_list);
672 if (heci_clear_list(dev, file,
673 &dev->pthi_read_complete_list.heci_cb.cb_list))
676 heci_clear_list(dev, file, &dev->ctrl_rd_list.heci_cb.cb_list);
678 if (heci_clear_list(dev, file, &dev->ctrl_wr_list.heci_cb.cb_list))
681 if (heci_clear_list(dev, file,
682 &dev->write_waiting_list.heci_cb.cb_list))
685 if (heci_clear_list(dev, file, &dev->write_list.heci_cb.cb_list))
688 /* check if iamthif_current_cb not NULL */
689 if (dev->iamthif_current_cb && (!rets)) {
690 /* check file and iamthif current cb association */
691 if (dev->iamthif_current_cb->file_object == file) {
693 heci_free_cb_private(dev->iamthif_current_cb);
694 dev->iamthif_current_cb = NULL;
702 * heci_open - the open function
704 * @inode: pointer to inode structure
705 * @file: pointer to file structure
707 * returns 0 on success, <0 on error
709 static int heci_open(struct inode *inode, struct file *file)
711 struct heci_file_private *file_ext;
712 int if_num = iminor(inode);
713 struct iamt_heci_device *dev;
718 dev = pci_get_drvdata(heci_device);
719 if ((if_num != HECI_MINOR_NUMBER) || (!dev))
722 file_ext = heci_alloc_file_private(file);
723 if (file_ext == NULL)
726 spin_lock_bh(&dev->device_lock);
727 if (dev->heci_state != HECI_ENABLED) {
728 spin_unlock_bh(&dev->device_lock);
732 if (dev->open_handle_count >= HECI_MAX_OPEN_HANDLE_COUNT) {
733 spin_unlock_bh(&dev->device_lock);
737 dev->open_handle_count++;
738 list_add_tail(&file_ext->link, &dev->file_list);
739 while ((dev->heci_host_clients[dev->current_host_client_id / 8]
740 & (1 << (dev->current_host_client_id % 8))) != 0) {
742 dev->current_host_client_id++; /* allow overflow */
743 DBG("current_host_client_id = %d\n",
744 dev->current_host_client_id);
745 DBG("dev->open_handle_count = %lu\n",
746 dev->open_handle_count);
748 DBG("current_host_client_id = %d\n", dev->current_host_client_id);
749 file_ext->host_client_id = dev->current_host_client_id;
750 dev->heci_host_clients[file_ext->host_client_id / 8] |=
751 (1 << (file_ext->host_client_id % 8));
752 spin_unlock_bh(&dev->device_lock);
753 spin_lock(&file_ext->file_lock);
754 spin_lock_bh(&dev->device_lock);
755 file_ext->state = HECI_FILE_INITIALIZING;
756 spin_unlock_bh(&dev->device_lock);
757 file_ext->sm_state = 0;
759 file->private_data = file_ext;
760 spin_unlock(&file_ext->file_lock);
766 * heci_release - the release function
768 * @inode: pointer to inode structure
769 * @file: pointer to file structure
771 * returns 0 on success, <0 on error
773 static int heci_release(struct inode *inode, struct file *file)
776 int if_num = iminor(inode);
777 struct heci_file_private *file_ext = file->private_data;
778 struct heci_cb_private *priv_cb = NULL;
779 struct iamt_heci_device *dev;
784 dev = pci_get_drvdata(heci_device);
785 if ((if_num != HECI_MINOR_NUMBER) || (!dev) || (!file_ext))
788 if (file_ext != &dev->iamthif_file_ext) {
789 spin_lock(&file_ext->file_lock);
790 spin_lock_bh(&dev->device_lock);
791 if (file_ext->state == HECI_FILE_CONNECTED) {
792 file_ext->state = HECI_FILE_DISCONNECTING;
793 spin_unlock_bh(&dev->device_lock);
794 spin_unlock(&file_ext->file_lock);
795 DBG("disconnecting client host client = %d, "
797 file_ext->host_client_id,
798 file_ext->me_client_id);
799 rets = heci_disconnect_host_client(dev, file_ext);
800 spin_lock(&file_ext->file_lock);
801 spin_lock_bh(&dev->device_lock);
803 heci_flush_queues(dev, file_ext);
804 DBG("remove client host client = %d, ME client = %d\n",
805 file_ext->host_client_id,
806 file_ext->me_client_id);
808 if (dev->open_handle_count > 0) {
809 dev->heci_host_clients[file_ext->host_client_id / 8] &=
810 ~(1 << (file_ext->host_client_id % 8));
811 dev->open_handle_count--;
813 heci_remove_client_from_file_list(dev,
814 file_ext->host_client_id);
817 if (file_ext->read_cb != NULL) {
818 priv_cb = find_read_list_entry(dev, file_ext);
819 /* Remove entry from read list */
821 list_del(&priv_cb->cb_list);
823 priv_cb = file_ext->read_cb;
824 file_ext->read_cb = NULL;
827 spin_unlock_bh(&dev->device_lock);
828 file->private_data = NULL;
829 spin_unlock(&file_ext->file_lock);
832 heci_free_cb_private(priv_cb);
836 spin_lock_bh(&dev->device_lock);
838 if (dev->open_handle_count > 0)
839 dev->open_handle_count--;
841 if (dev->iamthif_file_object == file
842 && dev->iamthif_state != HECI_IAMTHIF_IDLE) {
843 DBG("pthi canceled iamthif state %d\n",
845 dev->iamthif_canceled = 1;
846 if (dev->iamthif_state == HECI_IAMTHIF_READ_COMPLETE) {
847 DBG("run next pthi iamthif cb\n");
848 run_next_iamthif_cmd(dev);
852 if (heci_clear_lists(dev, file))
853 dev->iamthif_state = HECI_IAMTHIF_IDLE;
855 spin_unlock_bh(&dev->device_lock);
860 static struct heci_cb_private *find_read_list_entry(
861 struct iamt_heci_device *dev,
862 struct heci_file_private *file_ext)
864 struct heci_cb_private *priv_cb_pos = NULL;
865 struct heci_cb_private *priv_cb_next = NULL;
866 struct heci_file_private *file_ext_list_temp;
868 if (dev->read_list.status == 0
869 && !list_empty(&dev->read_list.heci_cb.cb_list)) {
870 DBG("remove read_list CB \n");
871 list_for_each_entry_safe(priv_cb_pos,
873 &dev->read_list.heci_cb.cb_list, cb_list) {
875 file_ext_list_temp = (struct heci_file_private *)
876 priv_cb_pos->file_private;
878 if ((file_ext_list_temp != NULL) &&
879 heci_fe_same_id(file_ext, file_ext_list_temp))
888 * heci_read - the read client message function.
890 * @file: pointer to file structure
891 * @ubuf: pointer to user buffer
892 * @length: buffer length
893 * @offset: data offset in buffer
895 * returns >=0 data length on success , <0 on error
897 static ssize_t heci_read(struct file *file, char __user *ubuf,
898 size_t length, loff_t *offset)
901 int rets = 0, err = 0;
902 int if_num = iminor(file->f_dentry->d_inode);
903 struct heci_file_private *file_ext = file->private_data;
904 struct heci_cb_private *priv_cb_pos = NULL;
905 struct heci_cb_private *priv_cb = NULL;
906 struct iamt_heci_device *dev;
911 dev = pci_get_drvdata(heci_device);
912 if ((if_num != HECI_MINOR_NUMBER) || (!dev) || (!file_ext))
915 spin_lock_bh(&dev->device_lock);
916 if (dev->heci_state != HECI_ENABLED) {
917 spin_unlock_bh(&dev->device_lock);
920 spin_unlock_bh(&dev->device_lock);
922 spin_lock(&file_ext->file_lock);
923 if ((file_ext->sm_state & HECI_WD_STATE_INDEPENDENCE_MSG_SENT) == 0) {
924 spin_unlock(&file_ext->file_lock);
925 /* Do not allow to read watchdog client */
926 for (i = 0; i < dev->num_heci_me_clients; i++) {
927 if (memcmp(&heci_wd_guid,
928 &dev->me_clients[i].props.protocol_name,
929 sizeof(struct guid)) == 0) {
930 if (file_ext->me_client_id ==
931 dev->me_clients[i].client_id)
936 file_ext->sm_state &= ~HECI_WD_STATE_INDEPENDENCE_MSG_SENT;
937 spin_unlock(&file_ext->file_lock);
940 if (file_ext == &dev->iamthif_file_ext) {
941 rets = pthi_read(dev, if_num, file, ubuf, length, offset);
945 if (file_ext->read_cb && file_ext->read_cb->information > *offset) {
946 priv_cb = file_ext->read_cb;
948 } else if (file_ext->read_cb && file_ext->read_cb->information > 0 &&
949 file_ext->read_cb->information <= *offset) {
950 priv_cb = file_ext->read_cb;
953 } else if ((!file_ext->read_cb || file_ext->read_cb->information == 0)
955 /*Offset needs to be cleaned for contingous reads*/
961 err = heci_start_read(dev, if_num, file_ext);
962 spin_lock_bh(&file_ext->read_io_lock);
963 if (err != 0 && err != -EBUSY) {
964 DBG("heci start read failure with status = %d\n", err);
965 spin_unlock_bh(&file_ext->read_io_lock);
969 if (HECI_READ_COMPLETE != file_ext->reading_state
970 && !waitqueue_active(&file_ext->rx_wait)) {
971 if (file->f_flags & O_NONBLOCK) {
973 spin_unlock_bh(&file_ext->read_io_lock);
976 spin_unlock_bh(&file_ext->read_io_lock);
978 if (wait_event_interruptible(file_ext->rx_wait,
979 (HECI_READ_COMPLETE == file_ext->reading_state
980 || HECI_FILE_INITIALIZING == file_ext->state
981 || HECI_FILE_DISCONNECTED == file_ext->state
982 || HECI_FILE_DISCONNECTING == file_ext->state))) {
983 if (signal_pending(current)) {
990 spin_lock_bh(&dev->device_lock);
991 if (HECI_FILE_INITIALIZING == file_ext->state ||
992 HECI_FILE_DISCONNECTED == file_ext->state ||
993 HECI_FILE_DISCONNECTING == file_ext->state) {
994 spin_unlock_bh(&dev->device_lock);
998 spin_unlock_bh(&dev->device_lock);
999 spin_lock_bh(&file_ext->read_io_lock);
1002 priv_cb = file_ext->read_cb;
1005 spin_unlock_bh(&file_ext->read_io_lock);
1008 if (file_ext->reading_state != HECI_READ_COMPLETE) {
1009 spin_unlock_bh(&file_ext->read_io_lock);
1012 spin_unlock_bh(&file_ext->read_io_lock);
1013 /* now copy the data to user space */
1015 DBG("priv_cb->response_buffer size - %d\n",
1016 priv_cb->response_buffer.size);
1017 DBG("priv_cb->information - %lu\n",
1018 priv_cb->information);
1019 if (length == 0 || ubuf == NULL ||
1020 *offset > priv_cb->information) {
1025 /* length is being turncated to PAGE_SIZE, however, */
1026 /* information size may be longer */
1027 length = (length < (priv_cb->information - *offset) ?
1028 length : (priv_cb->information - *offset));
1030 if (copy_to_user(ubuf,
1031 priv_cb->response_buffer.data + *offset,
1039 if ((unsigned long)*offset < priv_cb->information)
1043 spin_lock_bh(&dev->device_lock);
1044 priv_cb_pos = find_read_list_entry(dev, file_ext);
1045 /* Remove entry from read list */
1046 if (priv_cb_pos != NULL)
1047 list_del(&priv_cb_pos->cb_list);
1048 spin_unlock_bh(&dev->device_lock);
1049 heci_free_cb_private(priv_cb);
1050 spin_lock_bh(&file_ext->read_io_lock);
1051 file_ext->reading_state = HECI_IDLE;
1052 file_ext->read_cb = NULL;
1053 file_ext->read_pending = 0;
1054 spin_unlock_bh(&file_ext->read_io_lock);
1055 out: DBG("end heci read rets= %d\n", rets);
1060 * heci_write - the write function.
1062 * @file: pointer to file structure
1063 * @ubuf: pointer to user buffer
1064 * @length: buffer length
1065 * @offset: data offset in buffer
1067 * returns >=0 data length on success , <0 on error
1069 static ssize_t heci_write(struct file *file, const char __user *ubuf,
1070 size_t length, loff_t *offset)
1074 int if_num = iminor(file->f_dentry->d_inode);
1075 struct heci_file_private *file_ext = file->private_data;
1076 struct heci_cb_private *priv_write_cb = NULL;
1077 struct heci_msg_hdr heci_hdr;
1078 struct iamt_heci_device *dev;
1079 unsigned long currtime = get_seconds();
1084 dev = pci_get_drvdata(heci_device);
1086 if ((if_num != HECI_MINOR_NUMBER) || (!dev) || (!file_ext))
1089 spin_lock_bh(&dev->device_lock);
1091 if (dev->heci_state != HECI_ENABLED) {
1092 spin_unlock_bh(&dev->device_lock);
1095 if (file_ext == &dev->iamthif_file_ext) {
1096 priv_write_cb = find_pthi_read_list_entry(dev, file);
1097 if ((priv_write_cb != NULL) &&
1098 (((currtime - priv_write_cb->read_time) >=
1099 IAMTHIF_READ_TIMER) ||
1100 (file_ext->reading_state == HECI_READ_COMPLETE))) {
1102 list_del(&priv_write_cb->cb_list);
1103 heci_free_cb_private(priv_write_cb);
1104 priv_write_cb = NULL;
1108 /* free entry used in read */
1109 if (file_ext->reading_state == HECI_READ_COMPLETE) {
1111 priv_write_cb = find_read_list_entry(dev, file_ext);
1112 if (priv_write_cb != NULL) {
1113 list_del(&priv_write_cb->cb_list);
1114 heci_free_cb_private(priv_write_cb);
1115 priv_write_cb = NULL;
1116 spin_lock_bh(&file_ext->read_io_lock);
1117 file_ext->reading_state = HECI_IDLE;
1118 file_ext->read_cb = NULL;
1119 file_ext->read_pending = 0;
1120 spin_unlock_bh(&file_ext->read_io_lock);
1122 } else if (file_ext->reading_state == HECI_IDLE &&
1123 file_ext->read_pending == 0)
1126 spin_unlock_bh(&dev->device_lock);
1128 priv_write_cb = kzalloc(sizeof(struct heci_cb_private), GFP_KERNEL);
1132 priv_write_cb->file_object = file;
1133 priv_write_cb->file_private = file_ext;
1134 priv_write_cb->request_buffer.data = kmalloc(length, GFP_KERNEL);
1135 if (!priv_write_cb->request_buffer.data) {
1136 kfree(priv_write_cb);
1139 DBG("length =%d\n", (int) length);
1141 if (copy_from_user(priv_write_cb->request_buffer.data,
1147 spin_lock(&file_ext->file_lock);
1148 file_ext->sm_state = 0;
1149 if ((length == 4) &&
1150 ((memcmp(heci_wd_state_independence_msg[0],
1151 priv_write_cb->request_buffer.data, 4) == 0) ||
1152 (memcmp(heci_wd_state_independence_msg[1],
1153 priv_write_cb->request_buffer.data, 4) == 0) ||
1154 (memcmp(heci_wd_state_independence_msg[2],
1155 priv_write_cb->request_buffer.data, 4) == 0)))
1156 file_ext->sm_state |= HECI_WD_STATE_INDEPENDENCE_MSG_SENT;
1157 spin_unlock(&file_ext->file_lock);
1159 INIT_LIST_HEAD(&priv_write_cb->cb_list);
1160 if (file_ext == &dev->iamthif_file_ext) {
1161 priv_write_cb->response_buffer.data =
1162 kmalloc(IAMTHIF_MTU, GFP_KERNEL);
1163 if (!priv_write_cb->response_buffer.data) {
1167 spin_lock_bh(&dev->device_lock);
1168 if (dev->heci_state != HECI_ENABLED) {
1169 spin_unlock_bh(&dev->device_lock);
1173 for (i = 0; i < dev->num_heci_me_clients; i++) {
1174 if (dev->me_clients[i].client_id ==
1175 dev->iamthif_file_ext.me_client_id)
1179 BUG_ON(dev->me_clients[i].client_id != file_ext->me_client_id);
1180 if ((i == dev->num_heci_me_clients) ||
1181 (dev->me_clients[i].client_id !=
1182 dev->iamthif_file_ext.me_client_id)) {
1184 spin_unlock_bh(&dev->device_lock);
1187 } else if ((length > dev->me_clients[i].props.max_msg_length)
1189 spin_unlock_bh(&dev->device_lock);
1195 priv_write_cb->response_buffer.size = IAMTHIF_MTU;
1196 priv_write_cb->major_file_operations = HECI_IOCTL;
1197 priv_write_cb->information = 0;
1198 priv_write_cb->request_buffer.size = length;
1199 if (dev->iamthif_file_ext.state != HECI_FILE_CONNECTED) {
1200 spin_unlock_bh(&dev->device_lock);
1205 if (!list_empty(&dev->pthi_cmd_list.heci_cb.cb_list)
1206 || dev->iamthif_state != HECI_IAMTHIF_IDLE) {
1207 DBG("pthi_state = %d\n", (int) dev->iamthif_state);
1208 DBG("add PTHI cb to pthi cmd waiting list\n");
1209 list_add_tail(&priv_write_cb->cb_list,
1210 &dev->pthi_cmd_list.heci_cb.cb_list);
1213 DBG("call pthi write\n");
1214 rets = pthi_write(dev, priv_write_cb);
1217 DBG("pthi write failed with status = %d\n",
1219 spin_unlock_bh(&dev->device_lock);
1224 spin_unlock_bh(&dev->device_lock);
1228 priv_write_cb->major_file_operations = HECI_WRITE;
1229 /* make sure information is zero before we start */
1231 priv_write_cb->information = 0;
1232 priv_write_cb->request_buffer.size = length;
1234 spin_lock(&file_ext->write_io_lock);
1235 spin_lock_bh(&dev->device_lock);
1236 DBG("host client = %d, ME client = %d\n",
1237 file_ext->host_client_id, file_ext->me_client_id);
1238 if (file_ext->state != HECI_FILE_CONNECTED) {
1240 DBG("host client = %d, is not connected to ME client = %d",
1241 file_ext->host_client_id,
1242 file_ext->me_client_id);
1243 spin_unlock_bh(&dev->device_lock);
1246 for (i = 0; i < dev->num_heci_me_clients; i++) {
1247 if (dev->me_clients[i].client_id ==
1248 file_ext->me_client_id)
1251 BUG_ON(dev->me_clients[i].client_id != file_ext->me_client_id);
1252 if (i == dev->num_heci_me_clients) {
1254 spin_unlock_bh(&dev->device_lock);
1257 if (length > dev->me_clients[i].props.max_msg_length || length <= 0) {
1259 spin_unlock_bh(&dev->device_lock);
1262 priv_write_cb->file_private = file_ext;
1264 if (flow_ctrl_creds(dev, file_ext) &&
1265 dev->host_buffer_is_empty) {
1266 spin_unlock_bh(&dev->device_lock);
1267 dev->host_buffer_is_empty = 0;
1268 if (length > ((((dev->host_hw_state & H_CBD) >> 24) *
1269 sizeof(__u32)) - sizeof(struct heci_msg_hdr))) {
1272 (((dev->host_hw_state & H_CBD) >> 24) *
1274 sizeof(struct heci_msg_hdr);
1275 heci_hdr.msg_complete = 0;
1277 heci_hdr.length = length;
1278 heci_hdr.msg_complete = 1;
1280 heci_hdr.host_addr = file_ext->host_client_id;
1281 heci_hdr.me_addr = file_ext->me_client_id;
1282 heci_hdr.reserved = 0;
1283 DBG("call heci_write_message header=%08x.\n",
1284 *((__u32 *) &heci_hdr));
1285 spin_unlock(&file_ext->write_io_lock);
1286 /* protect heci low level write */
1287 spin_lock_bh(&dev->device_lock);
1288 if (!heci_write_message(dev, &heci_hdr,
1289 (unsigned char *) (priv_write_cb->request_buffer.data),
1292 spin_unlock_bh(&dev->device_lock);
1293 heci_free_cb_private(priv_write_cb);
1295 priv_write_cb->information = 0;
1298 file_ext->writing_state = HECI_WRITING;
1299 priv_write_cb->information = heci_hdr.length;
1300 if (heci_hdr.msg_complete) {
1301 flow_ctrl_reduce(dev, file_ext);
1302 list_add_tail(&priv_write_cb->cb_list,
1303 &dev->write_waiting_list.heci_cb.cb_list);
1305 list_add_tail(&priv_write_cb->cb_list,
1306 &dev->write_list.heci_cb.cb_list);
1308 spin_unlock_bh(&dev->device_lock);
1312 spin_unlock_bh(&dev->device_lock);
1313 priv_write_cb->information = 0;
1314 file_ext->writing_state = HECI_WRITING;
1315 spin_unlock(&file_ext->write_io_lock);
1316 list_add_tail(&priv_write_cb->cb_list,
1317 &dev->write_list.heci_cb.cb_list);
1322 spin_unlock(&file_ext->write_io_lock);
1324 heci_free_cb_private(priv_write_cb);
1330 * heci_ioctl - the IOCTL function
1332 * @inode: pointer to inode structure
1333 * @file: pointer to file structure
1334 * @cmd: ioctl command
1335 * @data: pointer to heci message structure
1337 * returns 0 on success , <0 on error
1339 static int heci_ioctl(struct inode *inode, struct file *file,
1340 unsigned int cmd, unsigned long data)
1343 int if_num = iminor(inode);
1344 struct heci_file_private *file_ext = file->private_data;
1346 struct heci_message_data __user *u_msg;
1347 struct heci_message_data k_msg; /* all in kernel on the stack */
1348 struct iamt_heci_device *dev;
1350 if (!capable(CAP_SYS_ADMIN))
1356 dev = pci_get_drvdata(heci_device);
1357 if ((if_num != HECI_MINOR_NUMBER) || (!dev) || (!file_ext))
1360 spin_lock_bh(&dev->device_lock);
1361 if (dev->heci_state != HECI_ENABLED) {
1362 spin_unlock_bh(&dev->device_lock);
1365 spin_unlock_bh(&dev->device_lock);
1367 /* first copy from user all data needed */
1368 u_msg = (struct heci_message_data __user *)data;
1369 if (copy_from_user(&k_msg, u_msg, sizeof(k_msg))) {
1370 DBG("first copy from user all data needed filled\n");
1373 DBG("user message size is %d\n", k_msg.size);
1376 case IOCTL_HECI_GET_VERSION:
1377 DBG(": IOCTL_HECI_GET_VERSION\n");
1378 rets = heci_ioctl_get_version(dev, if_num, u_msg, k_msg,
1382 case IOCTL_HECI_CONNECT_CLIENT:
1383 DBG(": IOCTL_HECI_CONNECT_CLIENT.\n");
1384 rets = heci_ioctl_connect_client(dev, if_num, u_msg, k_msg,
1389 DBG(": IOCTL_HECI_WD.\n");
1390 rets = heci_ioctl_wd(dev, if_num, k_msg, file_ext);
1393 case IOCTL_HECI_BYPASS_WD:
1394 DBG(": IOCTL_HECI_BYPASS_WD.\n");
1395 rets = heci_ioctl_bypass_wd(dev, if_num, k_msg, file_ext);
1406 * heci_poll - the poll function
1408 * @file: pointer to file structure
1409 * @wait: pointer to poll_table structure
1413 static unsigned int heci_poll(struct file *file, poll_table *wait)
1415 int if_num = iminor(file->f_dentry->d_inode);
1416 unsigned int mask = 0;
1417 struct heci_file_private *file_ext = file->private_data;
1418 struct iamt_heci_device *dev;
1423 dev = pci_get_drvdata(heci_device);
1425 if ((if_num != HECI_MINOR_NUMBER) || (!dev) || (!file_ext))
1428 spin_lock_bh(&dev->device_lock);
1429 if (dev->heci_state != HECI_ENABLED) {
1430 spin_unlock_bh(&dev->device_lock);
1433 spin_unlock_bh(&dev->device_lock);
1435 if (file_ext == &dev->iamthif_file_ext) {
1436 poll_wait(file, &dev->iamthif_file_ext.wait, wait);
1437 spin_lock(&dev->iamthif_file_ext.file_lock);
1438 if (dev->iamthif_state == HECI_IAMTHIF_READ_COMPLETE
1439 && dev->iamthif_file_object == file) {
1440 mask |= (POLLIN | POLLRDNORM);
1441 spin_lock_bh(&dev->device_lock);
1442 DBG("run next pthi cb\n");
1443 run_next_iamthif_cmd(dev);
1444 spin_unlock_bh(&dev->device_lock);
1446 spin_unlock(&dev->iamthif_file_ext.file_lock);
1449 poll_wait(file, &file_ext->tx_wait, wait);
1450 spin_lock(&file_ext->write_io_lock);
1451 if (HECI_WRITE_COMPLETE == file_ext->writing_state)
1452 mask |= (POLLIN | POLLRDNORM);
1454 spin_unlock(&file_ext->write_io_lock);
1461 static int heci_suspend(struct pci_dev *pdev, pm_message_t state)
1463 struct iamt_heci_device *dev = pci_get_drvdata(pdev);
1466 spin_lock_bh(&dev->device_lock);
1467 if (dev->reinit_tsk != NULL) {
1468 kthread_stop(dev->reinit_tsk);
1469 dev->reinit_tsk = NULL;
1471 spin_unlock_bh(&dev->device_lock);
1473 /* Stop watchdog if exists */
1474 del_timer_sync(&dev->wd_timer);
1475 if (dev->wd_file_ext.state == HECI_FILE_CONNECTED
1476 && dev->wd_timeout) {
1477 spin_lock_bh(&dev->device_lock);
1478 g_sus_wd_timeout = dev->wd_timeout;
1479 dev->wd_timeout = 0;
1480 dev->wd_due_counter = 0;
1481 memcpy(dev->wd_data, heci_stop_wd_params,
1482 HECI_WD_PARAMS_SIZE);
1484 if (dev->host_buffer_is_empty &&
1485 flow_ctrl_creds(dev, &dev->wd_file_ext)) {
1486 dev->host_buffer_is_empty = 0;
1487 if (!heci_send_wd(dev))
1488 DBG("send stop WD failed\n");
1490 flow_ctrl_reduce(dev, &dev->wd_file_ext);
1492 dev->wd_pending = 0;
1494 dev->wd_pending = 1;
1496 spin_unlock_bh(&dev->device_lock);
1499 err = wait_event_interruptible_timeout(dev->wait_stop_wd,
1502 if (!dev->wd_stoped)
1503 DBG("stop wd failed to complete.\n");
1505 DBG("stop wd complete %d.\n", err);
1509 /* Set new heci state */
1510 spin_lock_bh(&dev->device_lock);
1511 if (dev->heci_state == HECI_ENABLED ||
1512 dev->heci_state == HECI_RECOVERING_FROM_RESET) {
1513 dev->heci_state = HECI_POWER_DOWN;
1516 spin_unlock_bh(&dev->device_lock);
1518 pci_save_state(pdev);
1520 pci_disable_device(pdev);
1521 free_irq(pdev->irq, dev);
1523 pci_set_power_state(pdev, PCI_D3hot);
1528 static int heci_resume(struct pci_dev *pdev)
1530 struct iamt_heci_device *dev;
1533 pci_set_power_state(pdev, PCI_D0);
1534 pci_restore_state(pdev);
1536 dev = pci_get_drvdata(pdev);
1540 /* request and enable interrupt */
1541 err = request_irq(pdev->irq, heci_isr_interrupt, IRQF_SHARED,
1542 heci_driver_name, dev);
1544 printk(KERN_ERR "heci: Request_irq failure. irq = %d \n",
1549 spin_lock_bh(&dev->device_lock);
1550 dev->heci_state = HECI_POWER_UP;
1552 spin_unlock_bh(&dev->device_lock);
1554 /* Start watchdog if stopped in suspend */
1555 if (g_sus_wd_timeout != 0) {
1556 dev->wd_timeout = g_sus_wd_timeout;
1558 memcpy(dev->wd_data, heci_start_wd_params,
1559 HECI_WD_PARAMS_SIZE);
1560 memcpy(dev->wd_data + HECI_WD_PARAMS_SIZE,
1561 &dev->wd_timeout, sizeof(__u16));
1562 dev->wd_due_counter = 1;
1564 if (dev->wd_timeout)
1565 mod_timer(&dev->wd_timer, jiffies);
1567 g_sus_wd_timeout = 0;
1573 MODULE_AUTHOR("Intel Corporation");
1574 MODULE_DESCRIPTION("Intel(R) Management Engine Interface");
1575 MODULE_LICENSE("Dual BSD/GPL");
1576 MODULE_VERSION(HECI_DRIVER_VERSION);