7cf3ac8a9c
Fix kernel-doc warnings in mei_phy.h to avoid build warnings and to improve and documentation: mei_phy.h:15: warning: missing initial short description on line: * struct nfc_mei_phy mei_phy.h:19: warning: bad line: Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Reviewed-by: Krzysztof Kozlowski <krzk@kernel.org> Link: https://patch.msgid.link/20251116070959.85055-1-rdunlap@infradead.org Signed-off-by: Jakub Kicinski <kuba@kernel.org>
54 lines
1.3 KiB
C
54 lines
1.3 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
#ifndef __LOCAL_MEI_PHY_H_
|
|
#define __LOCAL_MEI_PHY_H_
|
|
|
|
#include <linux/mei_cl_bus.h>
|
|
#include <net/nfc/hci.h>
|
|
#include <linux/uuid.h>
|
|
|
|
#define MEI_NFC_UUID UUID_LE(0x0bb17a78, 0x2a8e, 0x4c50, \
|
|
0x94, 0xd4, 0x50, 0x26, 0x67, 0x23, 0x77, 0x5c)
|
|
#define MEI_NFC_HEADER_SIZE 10
|
|
#define MEI_NFC_MAX_HCI_PAYLOAD 300
|
|
|
|
/**
|
|
* struct nfc_mei_phy - NFC description of the MEI PHY and interface functions
|
|
*
|
|
* @cldev: mei client device
|
|
* @hdev: nfc hci device
|
|
*
|
|
* @send_wq: send completion wait queue
|
|
* @fw_ivn: NFC Interface Version Number
|
|
* @vendor_id: NFC manufacturer ID
|
|
* @radio_type: NFC radio type
|
|
* @reserved: reserved for alignment
|
|
* @req_id: message counter
|
|
* @recv_req_id: reception message counter
|
|
* @powered: the device is in powered state
|
|
* @hard_fault: < 0 if hardware error occurred
|
|
* and prevents normal operation.
|
|
*/
|
|
struct nfc_mei_phy {
|
|
struct mei_cl_device *cldev;
|
|
struct nfc_hci_dev *hdev;
|
|
|
|
wait_queue_head_t send_wq;
|
|
u8 fw_ivn;
|
|
u8 vendor_id;
|
|
u8 radio_type;
|
|
u8 reserved;
|
|
|
|
u16 req_id;
|
|
u16 recv_req_id;
|
|
|
|
int powered;
|
|
int hard_fault;
|
|
};
|
|
|
|
extern const struct nfc_phy_ops mei_phy_ops;
|
|
|
|
struct nfc_mei_phy *nfc_mei_phy_alloc(struct mei_cl_device *device);
|
|
void nfc_mei_phy_free(struct nfc_mei_phy *phy);
|
|
|
|
#endif /* __LOCAL_MEI_PHY_H_ */
|