90 lines · plain
1.. SPDX-License-Identifier: GPL-2.0-or-later2 3Kernel driver oxp-sensors4=========================5 6Authors:7 - Derek John Clark <derekjohn.clark@gmail.com>8 - Joaquín Ignacio Aramendía <samsagax@gmail.com>9 10Description:11------------12 13Handheld devices from OneNetbook, AOKZOE, AYANEO, And OrangePi provide fan14readings and fan control through their embedded controllers.15 16Currently supports OneXPlayer devices, AOKZOE, AYANEO, and OrangePi17handheld devices. AYANEO devices preceding the AIR and OneXPlayer devices18preceding the Mini A07 are not supportable as the EC model is different19and do not have manual control capabilities.20 21Some OneXPlayer and AOKZOE models have a toggle for changing the behaviour22of the "Turbo/Silent" button of the device. It will change the key event23that it triggers with a flip of the `tt_toggle` attribute. See below for24boards that support this function.25 26Supported devices27-----------------28 29Currently the driver supports the following handhelds:30 31 - AOKZOE A132 - AOKZOE A1 PRO33 - AYANEO 234 - AYANEO 2S35 - AYANEO AIR36 - AYANEO AIR 1S37 - AYANEO AIR Plus (Mendocino)38 - AYANEO AIR Pro39 - AYANEO Flip DS40 - AYANEO Flip KB41 - AYANEO Geek42 - AYANEO Geek 1S43 - AYANEO KUN44 - OneXPlayer 245 - OneXPlayer 2 Pro46 - OneXPlayer AMD47 - OneXPlayer mini AMD48 - OneXPlayer mini AMD PRO49 - OneXPlayer OneXFly50 - OneXPlayer X1 A51 - OneXPlayer X1 i52 - OneXPlayer X1 mini53 - OrangePi NEO-0154 55"Turbo/Silent" button behaviour toggle is only supported on:56 - AOK ZOE A157 - AOK ZOE A1 PRO58 - OneXPlayer 259 - OneXPlayer 2 Pro60 - OneXPlayer mini AMD (only with updated alpha BIOS)61 - OneXPlayer mini AMD PRO62 - OneXPlayer OneXFly63 - OneXPlayer X1 A64 - OneXPlayer X1 i65 - OneXPlayer X1 mini66 67Sysfs entries68-------------69 70The following attributes are supported:71 72fan1_input73 Read Only. Reads current fan RPM.74 75pwm1_enable76 Read Write. Enable manual fan control. Write "1" to set to manual, write "0"77 to let the EC control de fan speed. Read this attribute to see current status.78 79pwm180 Read Write. Read this attribute to see current duty cycle in the range [0-255].81 When pwm1_enable is set to "1" (manual) write any value in the range [0-255]82 to set fan speed.83 84tt_toggle85 Read Write. Read this attribute to check the status of the turbo/silent86 button behaviour function. Write "1" to activate the switch and "0" to87 deactivate it. The specific keycodes and behaviour is specific to the device88 both with this function on and off. This attribute is attached to the platform89 driver and not to the hwmon driver (/sys/devices/platform/oxp-platform/tt_toggle)90