78 lines
2.0 KiB
C
78 lines
2.0 KiB
C
|
/* SPDX-License-Identifier: GPL-2.0+ */
|
||
|
|
/*
|
||
|
|
* Common/core components for the Surface System Aggregator Module (SSAM) HID
|
||
|
|
* transport driver. Provides support for integrated HID devices on Microsoft
|
||
|
|
* Surface models.
|
||
|
|
*
|
||
|
|
* Copyright (C) 2019-2021 Maximilian Luz <luzmaximilian@gmail.com>
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef SURFACE_HID_CORE_H
|
||
|
|
#define SURFACE_HID_CORE_H
|
||
|
|
|
||
|
|
#include <linux/hid.h>
|
||
|
|
#include <linux/pm.h>
|
||
|
|
#include <linux/types.h>
|
||
|
|
|
||
|
|
#include <linux/surface_aggregator/controller.h>
|
||
|
|
#include <linux/surface_aggregator/device.h>
|
||
|
|
|
||
|
|
enum surface_hid_descriptor_entry {
|
||
|
|
SURFACE_HID_DESC_HID = 0,
|
||
|
|
SURFACE_HID_DESC_REPORT = 1,
|
||
|
|
SURFACE_HID_DESC_ATTRS = 2,
|
||
|
|
};
|
||
|
|
|
||
|
|
struct surface_hid_descriptor {
|
||
|
|
__u8 desc_len; /* = 9 */
|
||
|
|
__u8 desc_type; /* = HID_DT_HID */
|
||
|
|
__le16 hid_version;
|
||
|
|
__u8 country_code;
|
||
|
|
__u8 num_descriptors; /* = 1 */
|
||
|
|
|
||
|
|
__u8 report_desc_type; /* = HID_DT_REPORT */
|
||
|
|
__le16 report_desc_len;
|
||
|
|
} __packed;
|
||
|
|
|
||
|
|
static_assert(sizeof(struct surface_hid_descriptor) == 9);
|
||
|
|
|
||
|
|
struct surface_hid_attributes {
|
||
|
|
__le32 length;
|
||
|
|
__le16 vendor;
|
||
|
|
__le16 product;
|
||
|
|
__le16 version;
|
||
|
|
__u8 _unknown[22];
|
||
|
|
} __packed;
|
||
|
|
|
||
|
|
static_assert(sizeof(struct surface_hid_attributes) == 32);
|
||
|
|
|
||
|
|
struct surface_hid_device;
|
||
|
|
|
||
|
|
struct surface_hid_device_ops {
|
||
|
|
int (*get_descriptor)(struct surface_hid_device *shid, u8 entry, u8 *buf, size_t len);
|
||
|
|
int (*output_report)(struct surface_hid_device *shid, u8 rprt_id, u8 *buf, size_t len);
|
||
|
|
int (*get_feature_report)(struct surface_hid_device *shid, u8 rprt_id, u8 *buf, size_t len);
|
||
|
|
int (*set_feature_report)(struct surface_hid_device *shid, u8 rprt_id, u8 *buf, size_t len);
|
||
|
|
};
|
||
|
|
|
||
|
|
struct surface_hid_device {
|
||
|
|
struct device *dev;
|
||
|
|
struct ssam_controller *ctrl;
|
||
|
|
struct ssam_device_uid uid;
|
||
|
|
|
||
|
|
struct surface_hid_descriptor hid_desc;
|
||
|
|
struct surface_hid_attributes attrs;
|
||
|
|
|
||
|
|
struct ssam_event_notifier notif;
|
||
|
|
struct hid_device *hid;
|
||
|
|
|
||
|
|
struct surface_hid_device_ops ops;
|
||
|
|
};
|
||
|
|
|
||
|
|
int surface_hid_device_add(struct surface_hid_device *shid);
|
||
|
|
void surface_hid_device_destroy(struct surface_hid_device *shid);
|
||
|
|
|
||
|
|
extern const struct dev_pm_ops surface_hid_pm_ops;
|
||
|
|
|
||
|
|
#endif /* SURFACE_HID_CORE_H */
|