libratbag/src/driver-hidpp20.c

/*
 * M705 button 6 toggler.
 *
 * Copyright 2013 Benjamin Tissoires <benjamin.tissoires@gmail.com>
 * Copyright 2013 Red Hat, Inc
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice (including the next
 * paragraph) shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 */

/*
 * Based on the HID++ 1.0 documentation provided by Nestor Lopez Casado at:
 *   https://drive.google.com/folderview?id=0BxbRzx7vEV7eWmgwazJ3NUFfQ28&usp=sharing
 */

/*
 * for this driver to work, you need a kernel >= v3.19 or one which contains
 * 925f0f3ed24f98b40c28627e74ff3e7f9d1e28bc ("HID: logitech-dj: allow transfer
 * of HID++ reports from/to the correct dj device")
 */

#include "config.h"

#include <linux/types.h>
#include <errno.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>

#include "hidpp20.h"

#include "libratbag-private.h"
#include "libratbag-hidraw.h"

#define HIDPP_CAP_RESOLUTION_2200			(1 << 0)
#define HIDPP_CAP_SWITCHABLE_RESOLUTION_2201		(1 << 1)
#define HIDPP_CAP_BUTTON_KEY_1b04			(1 << 2)
#define HIDPP_CAP_BATTERY_LEVEL_1000			(1 << 3)

struct hidpp20drv_data {
	unsigned proto_major;
	unsigned proto_minor;
	unsigned long capabilities;
};

static void
hidpp20drv_read_button(struct ratbag_button *button)
{
}

static int
hidpp20drv_write_button(struct ratbag_button *button)
{
	return -1;
}

static int
hidpp20drv_has_capability(const struct ratbag_device *device, enum ratbag_capability cap)
{
	return 0;
}

static int
hidpp20drv_current_profile(struct ratbag_device *device)
{
	return 0;
}

static int
hidpp20drv_set_current_profile(struct ratbag_device *device, unsigned int index)
{
	return -1;
}

static int
hidpp20drv_read_resolution_dpi(struct ratbag_device *device)
{
	struct ratbag *ratbag = device->ratbag;
	struct hidpp20drv_data *drv_data = ratbag_get_drv_data(device);
	int rc, dpi;

	if (drv_data->capabilities & HIDPP_CAP_RESOLUTION_2200) {
		uint16_t resolution;
		uint8_t flags;

		rc = hidpp20_mousepointer_get_mousepointer_info(device, &resolution, &flags);
		if (rc) {
			log_error(ratbag,
				  "Error while requesting resolution: %s (%d)\n",
				  strerror(-rc), rc);
			return 0;
		}

		return resolution;
	}

	if (drv_data->capabilities & HIDPP_CAP_SWITCHABLE_RESOLUTION_2201) {
		struct hidpp20_sensor *sensors;

		dpi = 0;
		rc = hidpp20_adjustable_dpi_get_sensors(device, &sensors);
		if (rc < 0) {
			log_error(ratbag,
				  "Error while requesting resolution: %s (%d)\n",
				  strerror(-rc), rc);
		} else if (rc == 0) {
			log_error(ratbag, "Error, no compatible sensors found.\n");
		} else {
			log_info(ratbag,
				 "device is at %d dpi (variable between %d and %d).\n",
				 sensors[0].dpi,
				 sensors[0].dpi_min,
				 sensors[0].dpi_max);
			dpi = sensors[0].dpi;
		}
		free(sensors);
		return dpi;
	}

	return 0;
}

static void
hidpp20drv_read_profile(struct ratbag_profile *profile, unsigned int index)
{
	int dpi;

	dpi = hidpp20drv_read_resolution_dpi(profile->device);
	if (dpi > 0)
		profile->current_dpi = dpi;
}

static int
hidpp20drv_write_profile(struct ratbag_profile *profile)
{
	return -1;
}

static int
hidpp20drv_init_feature(struct ratbag_device *device, uint16_t feature)
{
	struct hidpp20drv_data *drv_data = ratbag_get_drv_data(device);
	struct ratbag *ratbag = device->ratbag;
	int rc;

	switch (feature) {
	case HIDPP_PAGE_ROOT:
	case HIDPP_PAGE_FEATURE_SET:
		/* these features are mandatory and already handled */
		break;
	case HIDPP_PAGE_MOUSE_POINTER_BASIC: {
		drv_data->capabilities |= HIDPP_CAP_RESOLUTION_2200;
		break;
	}
	case HIDPP_PAGE_ADJUSTABLE_DPI: {
		log_info(ratbag, "device has adjustable dpi\n");
		drv_data->capabilities |= HIDPP_CAP_SWITCHABLE_RESOLUTION_2201;
		break;
	}
	case HIDPP_PAGE_SPECIAL_KEYS_BUTTONS: {
		struct hidpp20_control_id *controls;

		log_info(ratbag, "device has programmable keys/buttons\n");
		rc = hidpp20_special_key_mouse_get_controls(device, &controls);
		if (rc < 0)
			return rc;

		free(controls);
		drv_data->capabilities |= HIDPP_CAP_BUTTON_KEY_1b04;
		break;
	}
	case HIDPP_PAGE_BATTERY_LEVEL_STATUS: {
		uint16_t level, next_level;
		enum hidpp20_battery_status status;

		rc = hidpp20_batterylevel_get_battery_level(device, &level, &next_level);
		if (rc < 0)
			return rc;
		status = rc;

		log_info(ratbag, "device battery level is %d%% (next %d%%), status %d \n",
			 level, next_level, status);

		drv_data->capabilities |= HIDPP_CAP_BATTERY_LEVEL_1000;
		break;
	}
	default:
		log_debug(device->ratbag, "unknown feature 0x%04x\n", feature);
	}
	return 0;
}

static int
hidpp20drv_20_probe(struct ratbag_device *device, const struct ratbag_id id)
{
	struct hidpp20_feature *feature_list;
	int rc, i;

	rc = hidpp20_feature_set_get(device, &feature_list);
	if (rc < 0)
		return rc;

	if (rc > 0) {
		log_debug(device->ratbag, "'%s' has %d features\n", ratbag_device_get_name(device), rc);
		for (i = 0; i < rc; i++) {
			log_debug(device->ratbag, "Init feature %s (0x%04x) \n",
				  hidpp20_feature_get_name(feature_list[i].feature),
				  feature_list[i].feature);
			hidpp20drv_init_feature(device, feature_list[i].feature);
		}
	}

	free(feature_list);

	return 0;

}

static int
hidpp20drv_probe(struct ratbag_device *device, const struct ratbag_id id)
{
	int rc;
	struct hidpp20drv_data *drv_data;

	rc = ratbag_open_hidraw(device);
	if (rc) {
		log_error(device->ratbag,
			  "Can't open corresponding hidraw node: '%s' (%d)\n",
			  strerror(-rc),
			  rc);
		return -ENODEV;
	}

	drv_data = zalloc(sizeof(*drv_data));
	if (!drv_data)
		return -ENODEV;

	drv_data->proto_major = 1;
	drv_data->proto_minor = 0;

	rc = hidpp20_root_get_protocol_version(device, &drv_data->proto_major, &drv_data->proto_minor);
	if (rc) {
		/* communication error, best to ignore the device */
		rc = -EINVAL;
		goto err;
	}

	log_debug(device->ratbag, "'%s' is using protocol v%d.%d\n", ratbag_device_get_name(device), drv_data->proto_major, drv_data->proto_minor);

	ratbag_set_drv_data(device, drv_data);

	if (drv_data->proto_major >= 2) {
		rc = hidpp20drv_20_probe(device, id);
		if (rc)
			goto err;
	}

	device->num_profiles = 1;
	device->num_buttons = 8;

	return rc;
err:
	free(drv_data);
	ratbag_set_drv_data(device, NULL);
	return rc;
}

static void
hidpp20drv_remove(struct ratbag_device *device)
{
	free(ratbag_get_drv_data(device));
}

#define USB_VENDOR_ID_LOGITECH			0x046d

static const struct ratbag_id hidpp20drv_table[] = {
	/* M705 */
	{.id = { .bustype = BUS_USB,
		 .vendor = USB_VENDOR_ID_LOGITECH,
		 .product = 0x101b,
		 .version = VERSION_ANY },
	 .data = 1,
	},

	/* MX Master over unifying */
	{.id = { .bustype = BUS_USB,
		 .vendor = USB_VENDOR_ID_LOGITECH,
		 .product = 0x4041,
		 .version = VERSION_ANY },
	},

	/* MX Master over bluetooth */
	{.id = { .bustype = BUS_BLUETOOTH,
		 .vendor = USB_VENDOR_ID_LOGITECH,
		 .product = 0xb012,
		 .version = VERSION_ANY },
	},

	/* T650 over unifying */
	{.id = { .bustype = BUS_USB,
		 .vendor = USB_VENDOR_ID_LOGITECH,
		 .product = 0x4101,
		 .version = VERSION_ANY },
	},

	{ },
};

struct ratbag_driver hidpp20_driver = {
	.name = "Logitech HID++2.0",
	.table_ids = hidpp20drv_table,
	.probe = hidpp20drv_probe,
	.remove = hidpp20drv_remove,
	.read_profile = hidpp20drv_read_profile,
	.write_profile = hidpp20drv_write_profile,
	.get_active_profile = hidpp20drv_current_profile,
	.set_active_profile = hidpp20drv_set_current_profile,
	.has_capability = hidpp20drv_has_capability,
	.read_button = hidpp20drv_read_button,
	.write_button = hidpp20drv_write_button,
};