Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit ecbfe7aa authored by Stefan Achatz's avatar Stefan Achatz Committed by Jiri Kosina
Browse files

HID: roccat: deprecated some Pyra attributes 



Introduced attribute "control" and made profile_settings and profile_buttons
readable, which makes profile[1-5]_settings and profile[1-5]_buttons obsolete.

Signed-off-by: default avatarStefan Achatz <erazor_de@users.sourceforge.net>
Signed-off-by: default avatarJiri Kosina <jkosina@suse.cz>
parent f1da71e1

Documentation/ABI/obsolete/sysfs-driver-hid-roccat-pyra

+26 −1
Original line number Diff line number Diff line
@@ -37,6 +37,31 @@ Description: When read, this file returns the raw integer version number of the 
		Please use binary attribute "info" which provides this information.

Users:		http://roccat.sourceforge.net



What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_buttons

Date:		August 2010

Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>

Description:	The mouse can store 5 profiles which can be switched by the

		press of a button. A profile is split in settings and buttons.

		profile_buttons holds information about button layout.

		When read, these files return the respective profile buttons.

		The returned data is 19 bytes in size.

		This file is readonly.

		Write control to select profile and read profile_buttons instead.

Users:		http://roccat.sourceforge.net



What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_settings

Date:		August 2010

Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>

Description:	The mouse can store 5 profiles which can be switched by the

		press of a button. A profile is split in settings and buttons.

		profile_settings holds information like resolution, sensitivity

		and light effects.

		When read, these files return the respective profile settings.

		The returned data is 13 bytes in size.

		This file is readonly.

		Write control to select profile and read profile_settings instead.

Users:		http://roccat.sourceforge.net



What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/startup_profile

Date:		August 2010

Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>

Documentation/ABI/testing/sysfs-driver-hid-roccat-pyra

+12 −25
Original line number Diff line number Diff line 
What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/info

Date:		November 2012

Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>

Description:	When read, this file returns general data like firmware version.

		When written, the device can be reset.

		The data is 6 bytes long.

Users:		http://roccat.sourceforge.net



What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_settings

Date:		August 2010

Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>
@@ -10,19 +18,8 @@ Description: The mouse can store 5 profiles which can be switched by the 
		The mouse will reject invalid data.

		Which profile to write is determined by the profile number

		contained in the data.

		This file is writeonly.

Users:		http://roccat.sourceforge.net



What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_settings

Date:		August 2010

Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>

Description:	The mouse can store 5 profiles which can be switched by the

		press of a button. A profile is split in settings and buttons.

		profile_settings holds information like resolution, sensitivity

		and light effects.

		When read, these files return the respective profile settings.

		The returned data is 13 bytes in size.

		This file is readonly.

		Before reading this file, control has to be written to select

		which profile to read.

Users:		http://roccat.sourceforge.net



What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile_buttons
@@ -36,18 +33,8 @@ Description: The mouse can store 5 profiles which can be switched by the 
		The mouse will reject invalid data.

		Which profile to write is determined by the profile number

		contained in the data.

		This file is writeonly.

Users:		http://roccat.sourceforge.net



What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/profile[1-5]_buttons

Date:		August 2010

Contact:	Stefan Achatz <erazor_de@users.sourceforge.net>

Description:	The mouse can store 5 profiles which can be switched by the

		press of a button. A profile is split in settings and buttons.

		profile_buttons holds information about button layout.

		When read, these files return the respective profile buttons.

		The returned data is 19 bytes in size.

		This file is readonly.

		Before reading this file, control has to be written to select

		which profile to read.

Users:		http://roccat.sourceforge.net



What:		/sys/bus/usb/devices/<busnum>-<devnum>:<config num>.<interface num>/<hid-bus>:<vendor-id>:<product-id>.<num>/pyra/roccatpyra<minor>/settings

drivers/hid/hid-roccat-pyra.c

+6 −4
Original line number Diff line number Diff line
@@ -177,9 +177,10 @@ PYRA_SYSFS_R(thingy, THINGY) 
	.write = pyra_sysfs_write_ ## thingy \

}



PYRA_SYSFS_W(control, CONTROL)

PYRA_SYSFS_RW(info, INFO)

PYRA_SYSFS_W(profile_settings, PROFILE_SETTINGS)

PYRA_SYSFS_W(profile_buttons, PROFILE_BUTTONS)

PYRA_SYSFS_RW(profile_settings, PROFILE_SETTINGS)

PYRA_SYSFS_RW(profile_buttons, PROFILE_BUTTONS)

PYRA_SYSFS_R(settings, SETTINGS)



static ssize_t pyra_sysfs_read_profilex_settings(struct file *fp,
@@ -312,9 +313,10 @@ static struct device_attribute pyra_attributes[] = { 
};



static struct bin_attribute pyra_bin_attributes[] = {

	PYRA_BIN_ATTRIBUTE_W(control, CONTROL),

	PYRA_BIN_ATTRIBUTE_RW(info, INFO),

	PYRA_BIN_ATTRIBUTE_W(profile_settings, PROFILE_SETTINGS),

	PYRA_BIN_ATTRIBUTE_W(profile_buttons, PROFILE_BUTTONS),

	PYRA_BIN_ATTRIBUTE_RW(profile_settings, PROFILE_SETTINGS),

	PYRA_BIN_ATTRIBUTE_RW(profile_buttons, PROFILE_BUTTONS),

	PYRA_BIN_ATTRIBUTE_RW(settings, SETTINGS),

	{

		.attr = { .name = "profile1_settings", .mode = 0440 },

drivers/hid/hid-roccat-pyra.h

+2 −0
Original line number Diff line number Diff line
@@ -15,6 +15,7 @@ 
#include <linux/types.h>



enum {

	PYRA_SIZE_CONTROL = 0x03,

	PYRA_SIZE_INFO = 0x06,

	PYRA_SIZE_PROFILE_SETTINGS = 0x0d,

	PYRA_SIZE_PROFILE_BUTTONS = 0x13,
@@ -57,6 +58,7 @@ struct pyra_info { 
} __attribute__ ((__packed__));



enum pyra_commands {

	PYRA_COMMAND_CONTROL = 0x4,

	PYRA_COMMAND_SETTINGS = 0x5,

	PYRA_COMMAND_PROFILE_SETTINGS = 0x6,

	PYRA_COMMAND_PROFILE_BUTTONS = 0x7,