Add the iei-wt61p803-puzzle driver sysfs interface documentation to allow monitoring and control of the microcontroller from user space. Signed-off-by: Luka Kovacic <luka.kovacic@xxxxxxxxxx> Signed-off-by: Pavo Banicevic <pavo.banicevic@xxxxxxxxxx> Cc: Luka Perkov <luka.perkov@xxxxxxxxxx> Cc: Robert Marko <robert.marko@xxxxxxxxxx> --- .../testing/sysfs-driver-iei-wt61p803-puzzle | 61 +++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-driver-iei-wt61p803-puzzle diff --git a/Documentation/ABI/testing/sysfs-driver-iei-wt61p803-puzzle b/Documentation/ABI/testing/sysfs-driver-iei-wt61p803-puzzle new file mode 100644 index 000000000000..ab4415587f67 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-driver-iei-wt61p803-puzzle @@ -0,0 +1,61 @@ +What: /sys/bus/serial/devices/.../mac_address_* +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RW) Internal factory assigned MAC address values + +What: /sys/bus/serial/devices/.../serial_number +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RW) Internal factory assigned serial number + +What: /sys/bus/serial/devices/.../version +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RO) Internal MCU firmware version + +What: /sys/bus/serial/devices/.../protocol_version +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RO) Internal MCU communication protocol version + +What: /sys/bus/serial/devices/.../power_loss_recovery +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RW) Host platform power loss recovery settings + Value mapping: 0 - Always-On, 1 - Always-Off, 2 - Always-AC, 3 - Always-WA + +What: /sys/bus/serial/devices/.../bootloader_mode +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RO) Internal MCU bootloader mode status + Value mapping: + 0 - normal mode + 1 - bootloader mode + +What: /sys/bus/serial/devices/.../power_status +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RO) Power status indicates the host platform power on method. + Value mapping (bitwise list): + 0x80 - Null + 0x40 - Firmware flag + 0x20 - Power loss detection flag (powered off) + 0x10 - Power loss detection flag (AC mode) + 0x08 - Button power on + 0x04 - Wake-on-LAN power on + 0x02 - RTC alarm power on + 0x01 - AC recover power on + +What: /sys/bus/serial/devices/.../build_info +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RO) Internal MCU firmware build date + Format: yyyy/mm/dd hh:mm + +What: /sys/bus/serial/devices/.../ac_recovery_status +Date: September 2020 +Contact: Luka Kovacic <luka.kovacic@xxxxxxxxxx> +Description: (RO) Host platform AC recovery status value + Value mapping: + 0 - board has not been recovered from power down + 1 - board has been recovered from power down -- 2.31.1
