aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/misc/mei/hw-me.c
diff options
context:
space:
mode:
Diffstat (limited to 'drivers/misc/mei/hw-me.c')
-rw-r--r--drivers/misc/mei/hw-me.c48
1 files changed, 24 insertions, 24 deletions
diff --git a/drivers/misc/mei/hw-me.c b/drivers/misc/mei/hw-me.c
index 77166ea30a4d..9dd7aa70bd85 100644
--- a/drivers/misc/mei/hw-me.c
+++ b/drivers/misc/mei/hw-me.c
@@ -28,10 +28,10 @@
28/** 28/**
29 * mei_me_reg_read - Reads 32bit data from the mei device 29 * mei_me_reg_read - Reads 32bit data from the mei device
30 * 30 *
31 * @dev: the device structure 31 * @hw: the me hardware structure
32 * @offset: offset from which to read the data 32 * @offset: offset from which to read the data
33 * 33 *
34 * returns register value (u32) 34 * Return: register value (u32)
35 */ 35 */
36static inline u32 mei_me_reg_read(const struct mei_me_hw *hw, 36static inline u32 mei_me_reg_read(const struct mei_me_hw *hw,
37 unsigned long offset) 37 unsigned long offset)
@@ -43,7 +43,7 @@ static inline u32 mei_me_reg_read(const struct mei_me_hw *hw,
43/** 43/**
44 * mei_me_reg_write - Writes 32bit data to the mei device 44 * mei_me_reg_write - Writes 32bit data to the mei device
45 * 45 *
46 * @dev: the device structure 46 * @hw: the me hardware structure
47 * @offset: offset from which to write the data 47 * @offset: offset from which to write the data
48 * @value: register value to write (u32) 48 * @value: register value to write (u32)
49 */ 49 */
@@ -59,7 +59,7 @@ static inline void mei_me_reg_write(const struct mei_me_hw *hw,
59 * 59 *
60 * @dev: the device structure 60 * @dev: the device structure
61 * 61 *
62 * returns ME_CB_RW register value (u32) 62 * Return: ME_CB_RW register value (u32)
63 */ 63 */
64static u32 mei_me_mecbrw_read(const struct mei_device *dev) 64static u32 mei_me_mecbrw_read(const struct mei_device *dev)
65{ 65{
@@ -68,9 +68,9 @@ static u32 mei_me_mecbrw_read(const struct mei_device *dev)
68/** 68/**
69 * mei_me_mecsr_read - Reads 32bit data from the ME CSR 69 * mei_me_mecsr_read - Reads 32bit data from the ME CSR
70 * 70 *
71 * @dev: the device structure 71 * @hw: the me hardware structure
72 * 72 *
73 * returns ME_CSR_HA register value (u32) 73 * Return: ME_CSR_HA register value (u32)
74 */ 74 */
75static inline u32 mei_me_mecsr_read(const struct mei_me_hw *hw) 75static inline u32 mei_me_mecsr_read(const struct mei_me_hw *hw)
76{ 76{
@@ -80,9 +80,9 @@ static inline u32 mei_me_mecsr_read(const struct mei_me_hw *hw)
80/** 80/**
81 * mei_hcsr_read - Reads 32bit data from the host CSR 81 * mei_hcsr_read - Reads 32bit data from the host CSR
82 * 82 *
83 * @dev: the device structure 83 * @hw: the me hardware structure
84 * 84 *
85 * returns H_CSR register value (u32) 85 * Return: H_CSR register value (u32)
86 */ 86 */
87static inline u32 mei_hcsr_read(const struct mei_me_hw *hw) 87static inline u32 mei_hcsr_read(const struct mei_me_hw *hw)
88{ 88{
@@ -93,7 +93,7 @@ static inline u32 mei_hcsr_read(const struct mei_me_hw *hw)
93 * mei_hcsr_set - writes H_CSR register to the mei device, 93 * mei_hcsr_set - writes H_CSR register to the mei device,
94 * and ignores the H_IS bit for it is write-one-to-zero. 94 * and ignores the H_IS bit for it is write-one-to-zero.
95 * 95 *
96 * @dev: the device structure 96 * @hw: the me hardware structure
97 */ 97 */
98static inline void mei_hcsr_set(struct mei_me_hw *hw, u32 hcsr) 98static inline void mei_hcsr_set(struct mei_me_hw *hw, u32 hcsr)
99{ 99{
@@ -274,8 +274,8 @@ static void mei_me_host_set_ready(struct mei_device *dev)
274/** 274/**
275 * mei_me_host_is_ready - check whether the host has turned ready 275 * mei_me_host_is_ready - check whether the host has turned ready
276 * 276 *
277 * @dev - mei device 277 * @dev: mei device
278 * returns bool 278 * Return: bool
279 */ 279 */
280static bool mei_me_host_is_ready(struct mei_device *dev) 280static bool mei_me_host_is_ready(struct mei_device *dev)
281{ 281{
@@ -288,8 +288,8 @@ static bool mei_me_host_is_ready(struct mei_device *dev)
288/** 288/**
289 * mei_me_hw_is_ready - check whether the me(hw) has turned ready 289 * mei_me_hw_is_ready - check whether the me(hw) has turned ready
290 * 290 *
291 * @dev - mei device 291 * @dev: mei device
292 * returns bool 292 * Return: bool
293 */ 293 */
294static bool mei_me_hw_is_ready(struct mei_device *dev) 294static bool mei_me_hw_is_ready(struct mei_device *dev)
295{ 295{
@@ -333,7 +333,7 @@ static int mei_me_hw_start(struct mei_device *dev)
333 * 333 *
334 * @dev: the device structure 334 * @dev: the device structure
335 * 335 *
336 * returns number of filled slots 336 * Return: number of filled slots
337 */ 337 */
338static unsigned char mei_hbuf_filled_slots(struct mei_device *dev) 338static unsigned char mei_hbuf_filled_slots(struct mei_device *dev)
339{ 339{
@@ -353,7 +353,7 @@ static unsigned char mei_hbuf_filled_slots(struct mei_device *dev)
353 * 353 *
354 * @dev: the device structure 354 * @dev: the device structure
355 * 355 *
356 * returns true if empty, false - otherwise. 356 * Return: true if empty, false - otherwise.
357 */ 357 */
358static bool mei_me_hbuf_is_empty(struct mei_device *dev) 358static bool mei_me_hbuf_is_empty(struct mei_device *dev)
359{ 359{
@@ -365,7 +365,7 @@ static bool mei_me_hbuf_is_empty(struct mei_device *dev)
365 * 365 *
366 * @dev: the device structure 366 * @dev: the device structure
367 * 367 *
368 * returns -EOVERFLOW if overflow, otherwise empty slots count 368 * Return: -EOVERFLOW if overflow, otherwise empty slots count
369 */ 369 */
370static int mei_me_hbuf_empty_slots(struct mei_device *dev) 370static int mei_me_hbuf_empty_slots(struct mei_device *dev)
371{ 371{
@@ -394,7 +394,7 @@ static size_t mei_me_hbuf_max_len(const struct mei_device *dev)
394 * @header: mei HECI header of message 394 * @header: mei HECI header of message
395 * @buf: message payload will be written 395 * @buf: message payload will be written
396 * 396 *
397 * This function returns -EIO if write has failed 397 * Return: -EIO if write has failed
398 */ 398 */
399static int mei_me_write_message(struct mei_device *dev, 399static int mei_me_write_message(struct mei_device *dev,
400 struct mei_msg_hdr *header, 400 struct mei_msg_hdr *header,
@@ -444,7 +444,7 @@ static int mei_me_write_message(struct mei_device *dev,
444 * 444 *
445 * @dev: the device structure 445 * @dev: the device structure
446 * 446 *
447 * returns -EOVERFLOW if overflow, otherwise filled slots count 447 * Return: -EOVERFLOW if overflow, otherwise filled slots count
448 */ 448 */
449static int mei_me_count_full_read_slots(struct mei_device *dev) 449static int mei_me_count_full_read_slots(struct mei_device *dev)
450{ 450{
@@ -529,7 +529,7 @@ static void mei_me_pg_exit(struct mei_device *dev)
529 * 529 *
530 * @dev: the device structure 530 * @dev: the device structure
531 * 531 *
532 * returns 0 on success an error code otherwise 532 * Return: 0 on success an error code otherwise
533 */ 533 */
534int mei_me_pg_set_sync(struct mei_device *dev) 534int mei_me_pg_set_sync(struct mei_device *dev)
535{ 535{
@@ -566,7 +566,7 @@ int mei_me_pg_set_sync(struct mei_device *dev)
566 * 566 *
567 * @dev: the device structure 567 * @dev: the device structure
568 * 568 *
569 * returns 0 on success an error code otherwise 569 * Return: 0 on success an error code otherwise
570 */ 570 */
571int mei_me_pg_unset_sync(struct mei_device *dev) 571int mei_me_pg_unset_sync(struct mei_device *dev)
572{ 572{
@@ -603,7 +603,7 @@ reply:
603 * 603 *
604 * @dev: the device structure 604 * @dev: the device structure
605 * 605 *
606 * returns: true is pg supported, false otherwise 606 * Return: true is pg supported, false otherwise
607 */ 607 */
608static bool mei_me_pg_is_enabled(struct mei_device *dev) 608static bool mei_me_pg_is_enabled(struct mei_device *dev)
609{ 609{
@@ -635,7 +635,7 @@ notsupported:
635 * @irq: The irq number 635 * @irq: The irq number
636 * @dev_id: pointer to the device structure 636 * @dev_id: pointer to the device structure
637 * 637 *
638 * returns irqreturn_t 638 * Return: irqreturn_t
639 */ 639 */
640 640
641irqreturn_t mei_me_irq_quick_handler(int irq, void *dev_id) 641irqreturn_t mei_me_irq_quick_handler(int irq, void *dev_id)
@@ -660,7 +660,7 @@ irqreturn_t mei_me_irq_quick_handler(int irq, void *dev_id)
660 * @irq: The irq number 660 * @irq: The irq number
661 * @dev_id: pointer to the device structure 661 * @dev_id: pointer to the device structure
662 * 662 *
663 * returns irqreturn_t 663 * Return: irqreturn_t
664 * 664 *
665 */ 665 */
666irqreturn_t mei_me_irq_thread_handler(int irq, void *dev_id) 666irqreturn_t mei_me_irq_thread_handler(int irq, void *dev_id)
@@ -841,7 +841,7 @@ const struct mei_cfg mei_me_lpt_cfg = {
841 * @pdev: The pci device structure 841 * @pdev: The pci device structure
842 * @cfg: per device generation config 842 * @cfg: per device generation config
843 * 843 *
844 * returns The mei_device_device pointer on success, NULL on failure. 844 * Return: The mei_device_device pointer on success, NULL on failure.
845 */ 845 */
846struct mei_device *mei_me_dev_init(struct pci_dev *pdev, 846struct mei_device *mei_me_dev_init(struct pci_dev *pdev,
847 const struct mei_cfg *cfg) 847 const struct mei_cfg *cfg)