/* 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 */