xref: /OK3568_Linux_fs/kernel/drivers/hid/intel-ish-hid/ishtp/init.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-only
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * Initialization protocol for ISHTP driver
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  * Copyright (c) 2003-2016, Intel Corporation.
6*4882a593Smuzhiyun  */
7*4882a593Smuzhiyun 
8*4882a593Smuzhiyun #include <linux/export.h>
9*4882a593Smuzhiyun #include <linux/slab.h>
10*4882a593Smuzhiyun #include <linux/sched.h>
11*4882a593Smuzhiyun #include "ishtp-dev.h"
12*4882a593Smuzhiyun #include "hbm.h"
13*4882a593Smuzhiyun #include "client.h"
14*4882a593Smuzhiyun 
15*4882a593Smuzhiyun /**
16*4882a593Smuzhiyun  * ishtp_dev_state_str() -Convert to string format
17*4882a593Smuzhiyun  * @state: state to convert
18*4882a593Smuzhiyun  *
19*4882a593Smuzhiyun  * Convert state to string for prints
20*4882a593Smuzhiyun  *
21*4882a593Smuzhiyun  * Return: character pointer to converted string
22*4882a593Smuzhiyun  */
ishtp_dev_state_str(int state)23*4882a593Smuzhiyun const char *ishtp_dev_state_str(int state)
24*4882a593Smuzhiyun {
25*4882a593Smuzhiyun 	switch (state) {
26*4882a593Smuzhiyun 	case ISHTP_DEV_INITIALIZING:
27*4882a593Smuzhiyun 		return	"INITIALIZING";
28*4882a593Smuzhiyun 	case ISHTP_DEV_INIT_CLIENTS:
29*4882a593Smuzhiyun 		return	"INIT_CLIENTS";
30*4882a593Smuzhiyun 	case ISHTP_DEV_ENABLED:
31*4882a593Smuzhiyun 		return	"ENABLED";
32*4882a593Smuzhiyun 	case ISHTP_DEV_RESETTING:
33*4882a593Smuzhiyun 		return	"RESETTING";
34*4882a593Smuzhiyun 	case ISHTP_DEV_DISABLED:
35*4882a593Smuzhiyun 		return	"DISABLED";
36*4882a593Smuzhiyun 	case ISHTP_DEV_POWER_DOWN:
37*4882a593Smuzhiyun 		return	"POWER_DOWN";
38*4882a593Smuzhiyun 	case ISHTP_DEV_POWER_UP:
39*4882a593Smuzhiyun 		return	"POWER_UP";
40*4882a593Smuzhiyun 	default:
41*4882a593Smuzhiyun 		return "unknown";
42*4882a593Smuzhiyun 	}
43*4882a593Smuzhiyun }
44*4882a593Smuzhiyun 
45*4882a593Smuzhiyun /**
46*4882a593Smuzhiyun  * ishtp_device_init() - ishtp device init
47*4882a593Smuzhiyun  * @dev: ISHTP device instance
48*4882a593Smuzhiyun  *
49*4882a593Smuzhiyun  * After ISHTP device is alloacted, this function is used to initialize
50*4882a593Smuzhiyun  * each field which includes spin lock, work struct and lists
51*4882a593Smuzhiyun  */
ishtp_device_init(struct ishtp_device * dev)52*4882a593Smuzhiyun void ishtp_device_init(struct ishtp_device *dev)
53*4882a593Smuzhiyun {
54*4882a593Smuzhiyun 	dev->dev_state = ISHTP_DEV_INITIALIZING;
55*4882a593Smuzhiyun 	INIT_LIST_HEAD(&dev->cl_list);
56*4882a593Smuzhiyun 	INIT_LIST_HEAD(&dev->device_list);
57*4882a593Smuzhiyun 	dev->rd_msg_fifo_head = 0;
58*4882a593Smuzhiyun 	dev->rd_msg_fifo_tail = 0;
59*4882a593Smuzhiyun 	spin_lock_init(&dev->rd_msg_spinlock);
60*4882a593Smuzhiyun 
61*4882a593Smuzhiyun 	init_waitqueue_head(&dev->wait_hbm_recvd_msg);
62*4882a593Smuzhiyun 	spin_lock_init(&dev->read_list_spinlock);
63*4882a593Smuzhiyun 	spin_lock_init(&dev->device_lock);
64*4882a593Smuzhiyun 	spin_lock_init(&dev->device_list_lock);
65*4882a593Smuzhiyun 	spin_lock_init(&dev->cl_list_lock);
66*4882a593Smuzhiyun 	spin_lock_init(&dev->fw_clients_lock);
67*4882a593Smuzhiyun 	INIT_WORK(&dev->bh_hbm_work, bh_hbm_work_fn);
68*4882a593Smuzhiyun 
69*4882a593Smuzhiyun 	bitmap_zero(dev->host_clients_map, ISHTP_CLIENTS_MAX);
70*4882a593Smuzhiyun 	dev->open_handle_count = 0;
71*4882a593Smuzhiyun 
72*4882a593Smuzhiyun 	/*
73*4882a593Smuzhiyun 	 * Reserving client ID 0 for ISHTP Bus Message communications
74*4882a593Smuzhiyun 	 */
75*4882a593Smuzhiyun 	bitmap_set(dev->host_clients_map, 0, 1);
76*4882a593Smuzhiyun 
77*4882a593Smuzhiyun 	INIT_LIST_HEAD(&dev->read_list.list);
78*4882a593Smuzhiyun 
79*4882a593Smuzhiyun }
80*4882a593Smuzhiyun EXPORT_SYMBOL(ishtp_device_init);
81*4882a593Smuzhiyun 
82*4882a593Smuzhiyun /**
83*4882a593Smuzhiyun  * ishtp_start() - Start ISH processing
84*4882a593Smuzhiyun  * @dev: ISHTP device instance
85*4882a593Smuzhiyun  *
86*4882a593Smuzhiyun  * Start ISHTP processing by sending query subscriber message
87*4882a593Smuzhiyun  *
88*4882a593Smuzhiyun  * Return: 0 on success else -ENODEV
89*4882a593Smuzhiyun  */
ishtp_start(struct ishtp_device * dev)90*4882a593Smuzhiyun int ishtp_start(struct ishtp_device *dev)
91*4882a593Smuzhiyun {
92*4882a593Smuzhiyun 	if (ishtp_hbm_start_wait(dev)) {
93*4882a593Smuzhiyun 		dev_err(dev->devc, "HBM haven't started");
94*4882a593Smuzhiyun 		goto err;
95*4882a593Smuzhiyun 	}
96*4882a593Smuzhiyun 
97*4882a593Smuzhiyun 	/* suspend & resume notification - send QUERY_SUBSCRIBERS msg */
98*4882a593Smuzhiyun 	ishtp_query_subscribers(dev);
99*4882a593Smuzhiyun 
100*4882a593Smuzhiyun 	return 0;
101*4882a593Smuzhiyun err:
102*4882a593Smuzhiyun 	dev_err(dev->devc, "link layer initialization failed.\n");
103*4882a593Smuzhiyun 	dev->dev_state = ISHTP_DEV_DISABLED;
104*4882a593Smuzhiyun 	return -ENODEV;
105*4882a593Smuzhiyun }
106*4882a593Smuzhiyun EXPORT_SYMBOL(ishtp_start);
107