Re: [PATCH 2/5] Documentation/ABI: Add file describing the sysfs entries for toshiba_acpi

From: Azael Avalos
Date: Thu Feb 12 2015 - 00:43:02 EST

Hi Darren,

2015-02-11 22:38 GMT-07:00 Darren Hart <dvhart@xxxxxxxxxxxxx>:
> On Tue, Feb 10, 2015 at 11:43:57PM -0700, Azael Avalos wrote:
>> This patch adds a new file describing the sysfs entries for the
>> toshiba_acpi driver.
>>
>
> +linux-api list

Just CC me, because I'm not subscribed to that list, in case something
needs to be changed.

>
> I've queued this for 3.20 through platform-drivers-x86. Any objections?

Not at all, and given that this patch is managed on another list,
let's see if there are any problems with this file.

Cheers
Azael

>
>
>> Signed-off-by: Azael Avalos <coproscefalo@xxxxxxxxx>
>> ---
>> .../ABI/testing/sysfs-driver-toshiba_acpi | 114 +++++++++++++++++++++
>> 1 file changed, 114 insertions(+)
>> create mode 100644 Documentation/ABI/testing/sysfs-driver-toshiba_acpi
>>
>> diff --git a/Documentation/ABI/testing/sysfs-driver-toshiba_acpi b/Documentation/ABI/testing/sysfs-driver-toshiba_acpi
>> new file mode 100644
>> index 0000000..ca9c71a
>> --- /dev/null
>> +++ b/Documentation/ABI/testing/sysfs-driver-toshiba_acpi
>> @@ -0,0 +1,114 @@
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_mode
>> +Date: June 8, 2014
>> +KernelVersion: 3.15
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file controls the keyboard backlight operation mode, valid
>> + values are:
>> + * 0x1 -> FN-Z
>> + * 0x2 -> AUTO (also called TIMER)
>> + * 0x8 -> ON
>> + * 0x10 -> OFF
>> + Note that the kernel 3.16 onwards this file accepts all listed
>> + parameters, kernel 3.15 only accepts the first two (FN-Z and
>> + AUTO).
>> +Users: KToshiba
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_backlight_timeout
>> +Date: June 8, 2014
>> +KernelVersion: 3.15
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file controls the timeout of the keyboard backlight
>> + whenever the operation mode is set to AUTO (or TIMER),
>> + valid values range from 0-60.
>> + Note that the kernel 3.15 only had support for the first
>> + keyboard type, the kernel 3.16 added support for the second
>> + type and the range accepted for type 2 is 1-60.
>> + See the entry named "kbd_type"
>> +Users: KToshiba
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/position
>> +Date: June 8, 2014
>> +KernelVersion: 3.15
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file shows the absolute position of the built-in
>> + accelereometer.
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/touchpad
>> +Date: June 8, 2014
>> +KernelVersion: 3.15
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This files controls the status of the touchpad and pointing
>> + stick (if available), valid values are:
>> + * 0 -> OFF
>> + * 1 -> ON
>> +Users: KToshiba
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/available_kbd_modes
>> +Date: August 3, 2014
>> +KernelVersion: 3.16
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file shows the supported keyboard backlight modes
>> + the system supports, which can be:
>> + * 0x1 -> FN-Z
>> + * 0x2 -> AUTO (also called TIMER)
>> + * 0x8 -> ON
>> + * 0x10 -> OFF
>> + Note that not all keyboard types support the listed modes.
>> + See the entry named "available_kbd_modes"
>> +Users: KToshiba
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_type
>> +Date: August 3, 2014
>> +KernelVersion: 3.16
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file shows the current keyboard backlight type,
>> + which can be:
>> + * 1 -> Type 1, supporting modes FN-Z and AUTO
>> + * 2 -> Type 2, supporting modes TIMER, ON and OFF
>> +Users: KToshiba
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/version
>> +Date: February, 2015
>> +KernelVersion: 3.20
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file shows the current version of the driver
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/fan
>> +Date: February, 2015
>> +KernelVersion: 3.20
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file controls the state of the internal fan, valid
>> + values are:
>> + * 0 -> OFF
>> + * 1 -> ON
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/kbd_function_keys
>> +Date: February, 2015
>> +KernelVersion: 3.20
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file controls the Special Functions (hotkeys) operation
>> + mode, valid values are:
>> + * 0 -> Normal Operation
>> + * 1 -> Special Functions
>> + In the "Normal Operation" mode, the F{1-12} keys are as usual
>> + and the hotkeys are accessed via FN-F{1-12}.
>> + In the "Special Functions" mode, the F{1-12} keys trigger the
>> + hotkey and the F{1-12} keys are accessed via FN-F{1-12}.
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/panel_power_on
>> +Date: February, 2015
>> +KernelVersion: 3.20
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file controls whether the laptop should turn ON whenever
>> + the LID is opened, valid values are:
>> + * 0 -> Disabled
>> + * 1 -> Enabled
>> +
>> +What: /sys/devices/LNXSYSTM:00/LNXSYBUS:00/TOS{1900,620{0,7,8}}:00/usb_three
>> +Date: February, 2015
>> +KernelVersion: 3.20
>> +Contact: Azael Avalos <coproscefalo@xxxxxxxxx>
>> +Description: This file controls whether the USB 3 functionality, valid
>> + values are:
>> + * 0 -> Disabled (Acts as a regular USB 2)
>> + * 1 -> Enabled (Full USB 3 functionality)
>> --
>> 2.2.2
>>
>>
>
> --
> Darren Hart
> Intel Open Source Technology Center



--
-- El mundo apesta y vosotros apestais tambien --
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/